xml的解析技术包括了很多,其中dom4j,jdom,SAX等技术估计已经在大部分的人心中成为了耳熟能详的东西,但是如果

 

是关于xml与对象直接的转换技术,那么下面几种技术是不错的选择。

 

A.commons-digester

 

Digester本来仅仅是Jakarta Struts中的一个工具,用于处理struts-config.xml配置文件。显然,将XML文件转换成相应的Java对象是一项很通用的功能,这个工具理应具有更广泛的用途,所以很快它就在Jakarta Commons项目(用于提供可重用的Java组件库)中有了一席之地。 

  如今Digester随着Struts的发展以及其的公用性而被提到commons中独自立项,是apache的一个组件 apache commons-digester.jar,通过它可以很方便的从xml文件生成java对象.你不用再象以前通过jdom或者Xerces去读取一个document对象.(jdom和Xerces仍然有它们的用武之地及强大之处,在其它应用里你也少不了它们)

 

Digester简单原理

 

Digester由"事件"驱动,通过调用预定义的规则操作对象栈,将XML文件转换为Java对象。工作原理如下:

  Digester底层采用SAX解析XML文件,所以很自然的,对象转换由"事件"驱动,即在识别出特定XML元素时(实际被细分为begin、body、end、finish四个时点),将执行特定的动作,比如创建特定的Java对象,或调用特定对象的方法等。此处的XML元素根据匹配模式(matching pattern)识别,而相关操作由规则(rule)定义。在转换过程中,Digester维持了一个对象栈,可以看作对象转换的工作台,用来存放转换中生成的、或是为转换临时创建的Java对象。对输入XML文件作了一趟完整的扫描后,对象栈的栈顶元素即为目标对象。由于Digester屏蔽了SAX解析的细节,使用者仅需关注转换操作本身,大大简化了转换操作。

 

理论知识介绍完成,列举一个实例。

common-digester所依赖的jar包:
common-Digester 
common-BeanUtils
common-Collections
common-Logging 
1.首先编写xml文件,文件内容如下:
 
<?xml version="1.0"?>
<academy name="JAcademy">
 <student name="JavaBoy" division="A">
  <course>
   <id>C1</id>
   <name>JSP</name>
  </course>
  <course>
   <id>C2</id>
   <name>Servlets</name>
  </course>
 </student>
 
 <student name="JavaGirl" division="B">
  <course>
   <id>C3</id>
   <name>EJB</name>
  </course>
 </student> <teacher name="JavaGuru">
  <certification>SCJP</certification>
  <certification>SCWCD</certification>
 </teacher>
 
 <teacher name="JavaMaster">
  <certification>OCP</certification>
  <certification>SCJP</certification>
  <certification>SCEA</certification>
 </teacher>
</academy>   
 
2.根据xml文件,编写Digester解析的规则文件。
 
<?xml version="1.0"?>
<digester-rules>
 <pattern value="academy">
  <object-create-rule classname="com.huawei.example.Academy" />
  <set-properties-rule />
  <pattern value="student">
   <object-create-rule classname="com.huawei.example.Student" />
   <set-properties-rule />   <pattern value="course">
    <object-create-rule classname="com.huawei.example.Course" />
    <bean-property-setter-rule pattern="id" />
    <bean-property-setter-rule pattern="name" />
    <set-next-rule methodname="addCourse" />
   </pattern>
   <set-next-rule methodname="addStudent" />
  </pattern>  <pattern value="teacher">
   <object-create-rule classname="com.huawei.example.Teacher" />
   <set-properties-rule />
   <call-method-rule pattern="certification"
    methodname="addCertification" paramcount="1" />
   <call-param-rule pattern="certification" paramnumber="0" />
   <set-next-rule methodname="addTeacher" />
  </pattern>
 </pattern>
</digester-rules>

规则文件相关说明:

 

  1.ObjectCreateRule 当begin()方法被调用时, 此rule创建相应Java对象, 并将其push到Digester的对象栈上。当end()方法被调用时, 栈顶对象将被pop, Digester内所有对该对象的引用都将失效。

  2.FactoryCreateRule 创建Java对象的另一种选择。当待创建的Java对象没有无参构造函数,或需要在创建时需要进行额外的设置时,需要用此rule。

  B:属性设置

  3.SetPropertiesRule 当begin()方法被调用时, Digester使用标准的Java反射API,将栈顶对象的属性设置为XML元素的同名属性值。

  4.SetPropertyRule 当begin()方法被调用时, Digester调用栈顶对象某指定属性的设置方法,设置其值。

  C:父子关系管理

  5.SetNextRule 当end()方法被调用时, Digester将栈顶元素设置进次栈顶元素中(调用相应的设置方法)。

  6.SetTopRule 当end()方法被调用时, Digester将次栈顶元素设置进栈顶元素中(调用相应的设置方法)。

  D:任意方法调用

  7.CallMethodRule 当end()方法被调用时, Digester将调用栈顶元素指定名称的方法。除了方法名外,此rule还需要配置参数数目,参数类型。参数值一般通过CallParamRule得到。

  8.CallParamRule 此rule内嵌于CallParamRule中,按顺序(相对于0)定义了CallParamRule中参数值的来源,可选的来源包括当前XML元素的属性或内容。

  E:其它

  9.NodeCreateRule 将XML文件树的一部分转换为DOM节点,并push到Digester的对象栈上。

 

3.编写主体的测试类

 

public static void main(String[] args) throws IOException, SAXException,
   IllegalAccessException, InvocationTargetException,
   NoSuchMethodException {
  Digester digester = DigesterLoader.createDigester(TestDigester.class
    .getClassLoader().getResource("academyRules.xml"));  Academy academy = (Academy) digester.parse(TestDigester.class
    .getClassLoader().getResourceAsStream("academy.xml"));  Vector<Student> vStud = academy.getStudents();
  Vector<Teacher> vTeach = academy.getTeachers();  for (int i = 0; i < vStud.size(); i++) {
    Student student =vStud.get(i);
    
    System.out.println("name : "+student.getName());
    
    System.out.println("cources name :"+student.getCourses().get(0).getName());
  }  for (int i = 0; i < vTeach.size(); i++) {
            Teacher teacher =vTeach.get(i);
            System.out.println("Certifications : "+teacher.getCertifications());
  } }
 
运行其结果如下:
cources name :JSP
name : JavaGirl
cources name :EJB
Certifications : [SCJP, SCWCD]
Certifications : [OCP, SCJP, SCEA]

 

这里只是对common-disgester进行了简单的介绍,如果想详细了解可以查看http://commons.apache.org/digester/ 

 

 

B. JAXB

 

关于jaxb这种技术,相信大家应该非常熟悉,学习过webservice的朋友应该有所了解。

 

 jaxb是一项数据绑定技术,它将xml文件映射成一个个的java类,程序员通过操作这些类就可以对xml文件中的元素进行读取等操作,同样程序员也可以改变这些类的属性,最后映射到xml文件中,这样做可以把程序员的主要精力放在业务逻辑上,并且也更符合面向对象的思想,而无需像使用DOM4J等技术一样需要处理一个个的xml节点。

 

 

编写一个简单的实例

 

1.xml还是采用前面的,我们首先通过命令将xml文件生成xsd文件。

 

java -jar trang.jar academy.xml academy.xsd

 

 

2.下载jaxb相关的jar包,下载的详细地址如下:

 

http://jaxb.java.net/

 

3.如果命令将xsd文件生成对应的java实体类

 

 xjc -p com.huawei.wuhen.academy academy.xsd -d src

命令这样所需的java类就生成了,以下为命令的详细说明:

xjc  [–p java文件所在的包] [-xmlschema] [–d 保存java文件的目录]

-xmlschema  xsd文件路径。
-d  指定了保存java文件的目录
-p  指定了生成的java文件所在的包

 

4.编写测试的相关类

 

private JAXBContext jaxb;
 // 这里要生成java实体类所对应的package名称
 private final String PACKAGE_NAME = "com.huawei.wuhen.academy"; public Test() throws JAXBException {
  jaxb = JAXBContext.newInstance(PACKAGE_NAME);
 } // 将xml转换成对象
 public Academy umarshall(String inputtFileName) throws JAXBException,
   FileNotFoundException {
  if (null == inputtFileName || inputtFileName.isEmpty()) {
   return null;
  }
  Unmarshaller unmarshaller = jaxb.createUnmarshaller();
  return (Academy) unmarshaller.unmarshal(new FileInputStream(
    inputtFileName));
 } // 将对象转换成xml
 public void marshall(Academy academy, String outputFileName)
   throws JAXBException, FileNotFoundException {
  Marshaller marshaller = jaxb.createMarshaller();
  marshaller.marshal(academy, new FileOutputStream(outputFileName));
 } public static void main(String[] args) throws JAXBException,
   FileNotFoundException {  Test test = new Test();
  Academy academy = test.umarshall("D:\\academy.xml");
  System.out.println("name : " + academy.getStudent().get(0).getName());
  test.marshall(academy, "F:\\academy.xml");
 }

C.castor

 

castor可以用一个mapping.xml文件来描述转换后的Java对象的xml基本形态,类似于xStream的annotation,这点还是非常不错的。下面我们就来看看Castor是怎么样完成Java对象到XML之间的相互转换吧。

 

1.通过ant命令生成相关的java类,ant脚本如下:

<project name="castor" default="castor" basedir=".">    
    <target name="init"> 
        <property name="src.dir" value="src/" />        
        <property name="lib.dir" value="${basedir}/lib/" />        
        <property name="caster.file" value="academy.xsd" /> 
        <property name="caster.package" value="com.huawei.wuhen.academy1" />
        <property name="castor.dest" value="${src.dir}" /> 
        <delete dir="${castor.dest}" /> 
    </target> 
    <target name="castor" depends="init"> 
        <java classname="org.exolab.castor.builder.SourceGeneratorMain"> 
            <arg value="-i" /> 
            <arg value="${caster.file}" /> 
            <arg value="-dest" /> 
            <arg value="${castor.dest}" /> 
            <arg value="-package" /> 
            <arg value="${caster.package}" />    
            <arg value="-f" />            
            <arg value="true" />            
            <arg value="verbose" /> 
            <arg value="true" /> 
            <classpath> 
                <fileset dir="${lib.dir}"> 
                    <include name="**/*.jar" /> 
                </fileset> 
            </classpath> 
        </java> 
    </target>    
</project>

相关jar下载地址如下:

 

http://www.castor.org/download.html 。

 

 

2.编写相关的测试类

// 将java对象转化成xml对象
 public void marshall(Academy academy, String outputFileName)
   throws IOException, MarshalException, ValidationException {  Writer writer = new FileWriter(new File(outputFileName));
  Marshaller.marshal(academy, writer);
 } 
 
//将xml对象转化成java实体对象
 public Academy unmarshall(Class<Academy> academy, String inputFileName)
   throws MarshalException, ValidationException, FileNotFoundException {
  if (null == inputFileName || inputFileName.isEmpty()) {
   return null;
  }
  Academy academy2 = (Academy) Unmarshaller.unmarshal(academy,
    new FileReader(new File(inputFileName)));  return academy2;
 }

 

 在这里我介绍了三种java与xml相互转换的技术,每种技术都具有自己的优点和缺点,我们可以根据项目的情况,合适的

 

选择相关技术,从而完成xml与java对象的转换。