Jena API使用详解（关注将本体持久化到MySQL后的操作及解决中文乱码等问题）

关于Jena的简介在很多博客中都能看到，例如对Jena的简单理解和一个例子，使用Jena将本体存入MySQL，Jena进阶等。在入门的时候，看这些文章总是很疑惑，对于存入数据库后的操作一无所知。因此，在做毕设之余，把使用到的一些方法记录下来，供将来查阅。

将本体持久化到数据库

首先，还是不能免俗，说说如何将本体持久化到数据库的方法。总体的操作流程是将本体从owl文件中读出，建立一个数据库的连接，将Model存入数据库。这个过程的操作比较简单，见如下代码。

private final static String driver = "com.mysql.jdbc.Driver";
	private final static String url = "jdbc:mysql://localhost/dbname";
	private final static String db = "MySQL";
	private final static String user = "your user name";
	private final static String pwd = "your password";

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		try {
			IDBConnection con = getConnection(url, user, pwd, db);

			Class.forName(driver);

			String path = "your owl file path";
			createModel(con, "model name", path);

			con.close();
		} catch (SQLException e) {
			e.printStackTrace();
		} catch (ClassNotFoundException e) {
			e.printStackTrace();
		}
	}

	/**
	 * get db connection
	 * 
	 * @param dbUrl
	 * @param dbUser
	 * @param dbPwd
	 * @param dbName
	 * @return
	 */
	public static DBConnection getConnection(String dbUrl, String dbUser,
			String dbPwd, String dbName) {
		return new DBConnection(dbUrl, dbUser, dbPwd, dbName);
	}

	/**
	 * read owl file, create the ontModel, and store in db
	 * 
	 * @param conn
	 * @param name
	 * @param filePath
	 * @return
	 */
	public static OntModel createModel(IDBConnection conn, String name,
			String filePath) {
		ModelMaker maker = ModelFactory.createModelRDBMaker(conn);
		Model model = maker.createModel(name);

		try {
			File file = new File(filePath);
			FileInputStream fis = new FileInputStream(file);
			InputStreamReader isr = new InputStreamReader(fis, "UTF-8");
			model.read(isr, null);

			isr.close();
			fis.close();

			model.commit();
		} catch (FileNotFoundException e) {
			e.printStackTrace();
		} catch (UnsupportedEncodingException e) {
			e.printStackTrace();
		} catch (IOException e) {
			e.printStackTrace();
		}

		OntModelSpec spec = new OntModelSpec(OntModelSpec.OWL_MEM);
		return ModelFactory.createOntologyModel(spec, model);
	}

执行了上面的代码，会发现在MySQL数据库中可以看见七张表。

每张表存放的内容可以简单了解一下。主要关注的表是jena_g1t1_stmt，其存放了本体的数据，本体以三元组的形式存放在此表中。

表名	存储
jena_g1t1_stmt	本体数据
jena_g1t0_reif	经过处理的本体数据
jena_sys_stmt	系统元数据
jena_graph	每一个用户图的名字和唯一标志符
jena_long_lit	陈述表中不便于直接存储的长字符常量
jena_long_uri	陈述表中不便于直接存储的长URI
jena_prefix	URI的前缀

此时，完成了将本体的持久化，接下来想要对本体进行一些操作该怎么办？

将本体从数据库中读取成OntModel

对本体进一步的操作，需要完成的第一步工作是将本体以OntModel的形式从数据库中读出来。这一步的操作见下述代码。

	private final static String driver = "com.mysql.jdbc.Driver";
	private final static String url = "jdbc:mysql://localhost/dbname";
	private final static String db = "MySQL";
	private final static String user = "your user name";
	private final static String pwd = "your password";

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		try {
			IDBConnection con = getConnection(url, user, pwd, db);

			Class.forName(driver);

			OntModel model = getModelFromDB(con,"test");
			printModel(model);

			con.close();
		} catch (SQLException e) {
			e.printStackTrace();
		} catch (ClassNotFoundException e) {
			e.printStackTrace();
		}
	}

	/**
	 * get db connection
	 * 
	 * @param dbUrl
	 * @param dbUser
	 * @param dbPwd
	 * @param dbName
	 * @return
	 */
	public static DBConnection getConnection(String dbUrl, String dbUser,
			String dbPwd, String dbName) {
		return new DBConnection(dbUrl, dbUser, dbPwd, dbName);
	}

	/**
	 * get OntModel from db
	 * 
	 * @param con
	 * @param name
	 * @return
	 */
	public static OntModel getModelFromDB(IDBConnection con, String name) {
		ModelMaker maker = ModelFactory.createModelRDBMaker(con);
		Model model = maker.getModel(name);
		OntModel newmodel = ModelFactory.createOntologyModel(
				getModelSpec(maker), model);
		return newmodel;
	}

	/**
	 * get model spec
	 * 
	 * @param maker
	 * @return
	 */
	public static OntModelSpec getModelSpec(ModelMaker maker) {
		OntModelSpec spec = new OntModelSpec(OntModelSpec.OWL_MEM);
		spec.setImportModelMaker(maker);
		return spec;
	}

	/**
	 * print model
	 * 
	 * @param model
	 */
	public static void printModel(OntModel model) {
		for (Iterator<OntClass> i = model.listClasses(); i.hasNext();) {
			OntClass oc = i.next();
			System.out.println(oc.getLocalName());
		}
	}

进行此步操作时，会遇到一个推理机的设置问题。这个问题稍后进行一个详细的解释。

执行了将本体从数据库读出的操作，可以打印出本体中的所有类，直观看到本体的类。获得了OntModel，可以进行其他很多的操作，如读取本体中所有的类、属性及实例，读取本体类与类的关系，给本体增加实例等等操作。

读取本体的所有类及类的属性

	/**
	 * get all classes and properties
	 * 
	 * @param model
	 */
	public static void getClasses(OntModel model) {
		for (ExtendedIterator<OntClass> ei = model.listClasses(); ei.hasNext();) {
			OntClass oc = ei.next();
			System.out.println(oc.getLocalName());
			for (ExtendedIterator<OntProperty> eip = oc
					.listDeclaredProperties(); eip.hasNext();) {
				OntProperty op = eip.next();
				System.out.println(op.getLocalName());
			}
		}
	}

读取一个类的所有实例

	/**
	 * get a individual
	 * 
	 * @param model
	 * @param prefix
	 */
	public static void getIndivProperties(OntModel model, String prefix) {
		OntClass w = model.getOntClass(prefix + "Writing");
		for (ExtendedIterator<?> i = w.listInstances(); i.hasNext();) {
			Individual individual = (Individual) i.next();
			System.out.println(individual.getLocalName());
			for (StmtIterator ei = individual.listProperties(); ei.hasNext();) {
				StatementImpl iop = (StatementImpl) ei.next();
				System.out.println(iop.getSubject().getLocalName() + "--"
						+ iop.getPredicate().getLocalName() + "--"
						+ iop.getObject());
			}
		}
	}

获取两个类的关系

获取两个类的关系时，使用了sparql语言查询。Jena API本身不提供直接的方法以获取两个类的关系。

	/**
	 * Get relation (ObjectPropery) between two classes
	 * 
	 * @param classname1
	 * @param classname2
	 * @return relationValue
	 */
	public static String getRelation(OntModel model, String classname1,
			String classname2) {
		// Get prefixes
		String defaultPrefix = model.getNsPrefixURI("");
		String rdfsPrefix = model.getNsPrefixURI("rdfs");
		String owlPrefix = model.getNsPrefixURI("owl");

		// Create a new query
		String queryString = "PREFIX default: <" + defaultPrefix + ">\n"
				+ "PREFIX rdfs: <" + rdfsPrefix + ">\n" + "PREFIX owl: <"
				+ owlPrefix + ">\n" + "SELECT ?relation\n"
				+ "WHERE { ?relation rdfs:domain default:" + classname1
				+ ".?relation rdfs:range default:" + classname2 + "}";

		// Create the query
		Query query = QueryFactory.create(queryString);
		// Execute the query and obtain results
		QueryExecution qe = QueryExecutionFactory.create(query, model);
		ResultSet results = qe.execSelect();

		// Get property value
		String relationValue;
		if (results.hasNext()) {
			QuerySolution result = results.nextSolution();
			relationValue = result.get("relation").toString()
					.substring(defaultPrefix.length());
		} else {
			relationValue = null;
		}

		// Important - free up resources used running the query
		qe.close();
		return relationValue;
	}

创建一个实例

	/**
	 * create a individual
	 * 
	 * @param model
	 * @param prefix
	 */
	public static void createIndiv(OntModel model, String prefix) {
		OntClass oc = model.getOntClass("classname");
		Individual individual = oc.createIndividual("individualname");
		OntProperty op = model.getOntProperty(prefix + "propertyname");
		individual.addProperty(op, "propertyvalue");
	}

诸如此类的代码片段还有很多，在实际使用的时候，详细的内容可以查阅Jena的API文档，找到所需要的方法。不过在使用Jena API的时候，需要考虑效率问题。

OntClass oc = model.getOntClass("classname");

这行代码的效率出奇的差，如果能有其他方法根据类名获取一个类的方法，希望告知。

接下来说两个遇到的问题。

中文乱码问题

一是在使用Jena API将本体持久化到数据库时出现的中文乱码的问题。

注意OWL文件的编码和在从文件读取时设置”UTF8“。

还有最重要的一点是在写数据库的URL时应该写成：

jdbc:mysql://localhost/dbname?useUnicode=true&characterEncoding=utf8

推理机设置问题

二是在查询类的属性时，需要使用Jena的推理机，否则使用listDeclaredProperties方法直接打印只能找到一个类的独有属性，而无法找到属于多个类的公有属性。

	/**
	 * get model spec
	 * 
	 * @param maker
	 * @return
	 */
	public static OntModelSpec getModelSpec(ModelMaker maker) {
		OntModelSpec spec = new OntModelSpec(
				OntModelSpec.OWL_MEM_MICRO_RULE_INF);
		spec.setImportModelMaker(maker);
		return spec;
	}

但是这样做还是会遇到新的问题，可参见这里。

设置成OWL_MEM_MICRO_RULE_INF可以获取到一个类的所有属性，但在获取类的时候除了我们定义的类，还会得到系统的一些类。这个问题暂时不知道如何解决。