随笔-0  评论-3  文章-28  trackbacks-0
一、 简介
Castor XML是一种XML数据绑定框架。
XML的另外两种主要API:DOM和SAX(Document Object Model和Simple API for XML),主要是从结构的角度去处理XML文件,而Castor XML是以对象的模式去处理XML文档中的数据

大多数情况下,转换框架通过ClassDescriptor和FieldDescriptor来描述转换时所需要的信息。

二、 转换框架
转换框架中最主要的两个类是:org.exolab.castor.xml.Marshaller和org.exolab.castor.xml.Unmarshaller

marshal: Marshaller.marshal(obj,writer);
unmarshal: Unmarshaller.unmarshal(Person.class,reader);

上面的这种转换方式,只适合于按照默认方式进行转化,如果要使用映射文件,需要采用以下方式。
marshal:
Mapping mapping = new Mapping();
mapping.loadMapping(“mapping.xml”);
Marshaller marshaller = new Marshaller(writer);
marshaller.setMapping(mapping);
marshaller.marshal(obj);
Marshaller的5个marshal方法中,只有marshal(Object obj)这个方法不是静态的,其他的四个都是静态的marshal(obj,writer), marshal(obj,handler), marshal(obj,node)

unmarshal:
Mapping mapping = new Mapping();
mapping .loadMapping(“mapping.xml”);
Unmarshaller unm = new Unmarshaller(“Person.class”);//使用Person.class作为构造Unmarshaller的参数
unm.setMapping(mapping);
Person person = (Person)unm.unmarshal(reader);
Unmarshaller中,object可以从reader中转换而来,也可以从source、node转换而来,静态方法均是两个参数,非静态方法都是一个来源作为参数。

三、 使用存在的Class和对象
Castor几乎可以将任何对象和XML进行转换。当指定class的描述文件不存在时,转换框架使用默认的reflection机制来获得对象的信息。

转化对象存在的主要约束是:
这些class必须有一个public而且default的构造函数;必须有adequate get/set方法。

四、 类描述符(ClassDescriptor)
org.exolab.castor.xml.XMLClassDescriptor
类描述符提供转换时所需的必要信息。ClassDescriptor不仅可以用于Castor XML,还可以用于Castor JDO

类描述符包括一组字段描述符(FieldDescriptor)

类描述符通常情况下有四种创建方式,两种在编译时(效率较高),两种在运行时(较为方便)
编译时描述符:
1. 让需要被describe的类实现org.exolab.castor.xml.XMLClassDescriptor接口
2. 使用Source Code Generator创建合适的descriptor
运行时描述符:
3. 默认,使用Castor的introspect机制
4. 提供mapping文件,或者默认和配置文件并用

使用”default introspection”机制必须为每一个要转换的field配备对应的get/set方法;
如果没有get/set方法,但是是public的field,也可以以direct field access的方式被转换;
但是如果一个类中为有的成员定义了get/set方法,即使其他成员是public的,也不会被转换;
自动内省机制是自动触发的。可以通过castor.properties文件控制自动转换的特性,比如改变名称转换、基本型别是转换为attribute还是element等。

Mapping文件也可以用来描述要被转换的类。mapping的装载发生在marshal和unmarshal之前(org.exolab.castor.mapping.Mapping)

posted on 2007-09-14 10:18 阅读(1237) 评论(0)  编辑  收藏 所属分类: 框架相关

只有注册用户登录后才能发表评论。


网站导航: