Apache Jena SPARQL 查询完全教程：入门与实战案例

很多开发者在使用 Apache Jena 时会碰到以下痛点：

• 不清楚如何在项目中快速添加 Jena 依赖。
• 面对 RDF 数据模型和 SPARQL 语法时感到“雾里看花”。
• 查询结果只能得到 ResultSet却不知道怎么把它转成可读的 JSON/CSV。怎么说呢，
• 对 OPTIONALFILTERASKCONSTRUCT 等高级用法缺乏实战示例。
• 模型序列化/反序列化的代码总是写错，导致数据丢失。

下面的章节针对这些常见痛点。提供一步步的方法，并配以完整可运行的代码示例。

1. 准备工作：让依赖不再是障碍

Maven 项目添加 Jena 依赖

org.apache.jena
apache-jena-libs
pom
5.2.0

如果只想手动挑选模块：

org.apache.jena
jena-core
5.2.0


org.apache.jena
jena-arq
5.2.0

2. 创建内存模型并加载 RDF 数据

下面的示例展示了如何用 Turtle 格式在内存中创建一个 Model并加入两个人物实例。

import org.apache.jena.rdf.model.*;
import java.io.StringReader;
Model model = ModelFactory.createDefaultModel;String ttl = ""
+ "@prefix vcard:  .
"
+ "@prefix foaf:  .
"
+ "
"
+ "
"
+ " a foaf:Person;"
+ " foaf:name \"John Doe\";"
+ " vcard:hasEmail  .
"
+ "
"
+ "
"
+ " a foaf:Person;"
+ " foaf:name \"Jane Smith\" .";// Jane 没有 Email
model.read。null,"TURTLE");

3. SPARQL “Hello World”——从 SELECT 到 ResultSetFormatter

3.1 基础 SELECT 查询语法回顾

PREFIX foaf: 
SELECT?person，name
WHERE {
person a foaf:Person;foaf:name，name .
}
ORDER BY?name
LIMIT 10

3.2 在 Jena 中执行查询并快速打印

import org.apache.jena.query.*;String queryStr = ""
+ "PREFIX foaf: 
"
+ "SELECT?person，name WHERE {
"
+ "?person a foaf:Person;"
+ " foaf:name?name .
"
+ "}";Query query = QueryFactory.create;try ) {
ResultSet rs = qexec.execSelect;怎么说呢，System.out.println;ResultSetFormatter.out;}

输出示例：

--- 使用 ResultSetFormatter 打印 ---
---------------------------------------------
| person | name |
=============================================
| http://example.org/person/john | John Doe |
| http://example.org/person/jane | Jane Smith |
---------------------------------------------

3.3 手动遍历 ResultSet

try ) {
ResultSet rs = qexec.execSelect;System.out.println;while ) {
QuerySolution sol = rs.nextSolution;Resource person = sol.getResource;Literal name = sol.getLiteral;System.out.println
+ ",Name: " + name.getString);}
}

4. 常见高级查询模式

4.1 FILTER 示例：筛选年龄大于指定值的人

// 假设已经在模型中加入 ex:age 三元组
String filterQry = ""
+ "PREFIX foaf: 
"
+ "PREFIX ex: 
"
+ "SELECT?name，age WHERE {
"
+ "?person a foaf:Person;"
+ " foaf:name?name，"
+ " ex:age?age .
"
+ " FILTER
"
+ "}";try ) {
ResultSet rs = qe.execSelect;ResultSetFormatter.out;}

4.2 OPTIONAL 示例：即使没有 Email 也能返回姓名

String optionalQry = ""
+ "PREFIX foaf: 
"
+ "PREFIX vcard:
"
+ "SELECT?name，email WHERE {
"
+ "?person a foaf:Person;"
+ " foaf:name?老实说，name .
"
+ " OPTIONAL {?person vcard:hasEmail?email }
"
+ "}";try ) {
ResultSet rs = qe.execSelect;System.out.println;while ) {
QuerySolution sol = rs.nextSolution;String name = sol.getLiteral.getString;String email = sol.contains?sol.get.toString : "N/A";
System.out.println;}
}

4.3 ASK 示例：布尔型查询

String askQry = ""
+"PREFIX foaf:
"
+"ASK {?老实说，person foaf:name \"Jane Smith\" . }";try ) {
boolean exists = qe.execAsk;System.out.println;}

4.4 CONSTRUCT 示例：生成新图谱

String constructQry = ""
+"PREFIX foaf:
"
+"CONSTRUCT {
"
+"?person a foaf:Person;"
+" foa f:name?name .
"
+"}
"
+"WHERE {?person a foaf:Person;foa f:name，name . }";try ) {
Model newModel = qe.execConstruct;怎么说呢，System.out.println;newModel.write;}

5. 序列化与反序列化

5.1 将模型保存为 Turtle 文件

import org.apache.jena.rdf.model.*;其实，import org.apache.jena.riot.RDFDataMgr;import org.apache.jena.riot.Lang;import java.io.FileOutputStream;try ) {
RDFDataMgr.write;System.out.println;}
catch { e.printStackTrace;}

5.2 从文件读取模型

Model loaded = ModelFactory.createDefaultModel;RDFDataMgr.read;System.out.println);loaded.write;

6️⃣ 完整示例代码 
import org.apache.jena.rdf.model.*;import org.apache.jena.query.*;import org.apache.jena.rdf.model.RDFNode;import org.apache.jena.rdf.model.Literal;import org.apache.jena.rdf.model.Resource;import org.apache.jena.rdf.model.ModelFactory;import org.apache.jena.query.QuerySolution;public class JenaSparqlDemo {
/** 创建包含姓名、年龄、邮箱的演示模型 */
private static Model buildDemoModel {
Model m = ModelFactory.createDefaultModel;String ttl =
"@prefix vcard:. \\
" +
"@prefix foaf:. \\
" +
"@prefix ex:. \\
" +
"\t a foaf:Person;\\
" +
"\tfoaf:name \"John Doe\";老实说，\\
" +
"\tex的观点是，age 35;\\\ n"+
"\tvcard:hasEmail <mailto:>& .\\\ n"+
"& lt http ://example.org/person/jane> \\t a FOAF : Person \\t FOAF : name \"Jane Smith\" \\t EX : age?，?"，
 m.read。null,"TURTLE");按理说，return m;}


public static void main throws Exception{
// Step‑1：准备模型
Model demo=buildDemoModel;
 // Step‑2：SELECT+FILTER 示例
String filterQ=
\"PREFIX ex:\\ n\"+
\"PREFIX foof:\\ n\"+
\"SELECT?na me，ag eWHERE{?pe r sona FOAF : Person;\
FOAF : nam e?na me，不过，\
EX : ag e?话说回来，ag e.FILTER}\";try){
Resu ltSe t r s=qex.ex ecSelect;ResultS etF ormatter.o ut;}
// Step‑３：OPTIONAL 手动迭代
String optQ=
\"PREFIX FOAF:\\ n\
PREFIX V CARD:\\ n\
SE LE CT?na me，em ailWHE RE{?不过，pe rsonA FO AF:P erson;\
FO AF:nam e?，na me.O PTIO N{?per sonV CARD:h asE mail?不过，ema il}}\";