Aegis 默认的 Xfire 绑定方式，将 XML 映射为 POJO
Aegis 是一个默认的 Xfire 绑定方式，它将 XML 映射为 POJO, 支持代码先行的开发.你开发服 务类与 POJO,它为你生成 XML schema/wsdl
XML 和 注解映射概览
默认情况下，你的 POJO 类被是基于他们的名字与命名空间被序列化。如果你有一个类在 "org.codehaus.xfire"包里，名字叫"Employee"，它会被使用命名空间"http://xfire.codehaus.org" 和本地名字 "Employee"进行序列化。
举例:
public class Employee {
private String name;
private String title;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
}
在 XML 里它被转换成:
<Employee xmlns="http://xfire.codehaus.org">
<name>Santa Claus</name>
<title>Chief Present Officer (CPO)</title>
</Employee>
在 XML Schema 里变的更为复杂:
<xsd:complexType name="Employee">
<xsd:sequence>
<xsd:element name="name" type="xsd:string" minOccurs="0" maxOccurs="1/>
<xsd:element name="title" type="xsd:string" minOccurs="0" maxOccurs="1/>
</xsd:sequence>
</xsd:complexType>
支持的类型
-
基本类型: int, double, float, long, byte[], short, String, BigDecimal Arrays Collections
-
日期: java.util.Date, java.util.Calendar, java.sql.Timestamp, java.sql.Date, java.sql.Time
-
XML: org.w3c.dom.Docmument, org.jdom.Element, XMLStreamReader, Source
-
以上类型的聚合类
如果 Java bean 里定义了构造函数，一定不能忘记定义一个默认的构造函数（无参）。（Aegis 需要一个无参的构造器来初始化客户端 java 类）
使用 XML 控制映射
使用 Aegis 很容易控制从 bean 到 xml 的转换。 .aegis.xml 映射配置文件必须存在于和你的 bean 或者服务类相同的包中，且命名为与 bean 或服务类相同名字。
以上例子应当命名为"/org/codehaus/xfire/Employee.aegis.xml", 格式如下:
<mappings>
<mapping uri="" name="">
<method name="methodName">
<return-type mappedName="" componentType=""/>
<parameter index="" mappedName=""/>
</method>
<property name="" mappedName="" style="attribute|element" componentType=""/>
</mapping>
</mappings>
当你创建 ClassName.aegis.xml 来控制映射的时候, 你只会用到一个 mapping 元素, 并且你 不需要在 mapping 元素上使用任何的属性. 使用一到多个 property 元素指定属性的映射. 使 用 name=指明要映射的属性名（Pojo 中名字）. <method> 用于配置服务类中的方法 <property> 用于配置 javabean 中的属性 用于配置 服务类中的方法, 中的属性.
上边的例子显示出了许多可能使用的元素， 上边的例子显示出了许多可能使用的元素，大部分都是可选的
控制命名
假设上边的例子需要元素首字母大写，并且使用"urn:north-pole:operations"命名空间. 配置文件 就修改成：
<mappings xmlns:np="urn:north-pole:operations">
<mapping name="np:Employee">
<property name="name" mappedName="Name"/>
<property name="title" mappedName="Title"/>
</mapping>
</mappings>
命名空间被定义在了 mappings 元素里。 之后这个前缀被用于为 name/title 指定 QNames 元素， 使映射变成以下:
<np:Employee xmlns:np="urn:north-pole:operations">
<np:Name>Santa Claus</np:Name>
<np:Title>Chief Present Officer (CPO)</np:Title>
</np:Employee>
忽略属性
如果要使某个属性不被序列化，可以加 ignore 来实现。:
<mappings>
<mapping>
<property name="propertyName" ignore="true"/>
</mapping>
</mappings>
控制 minOccurs 和 nillable
默认的 Aegis 的假设任意的 java 对象可以为空，那么相关的 schema 元素应当设为为 minOccurs=’0’ 且 nillable=’true’. 配置文件中也有属性对此进行控制。
<mappings>
<mapping>
<property name='everpresentProperty' minOccurs='1' nillable='false'/>
</mapping>
<mappings>
使用 Aegis 基本类型
为了使用在"org.codehaus.xfire.aegis.type.basic"包里 Aegis 提供的多种类型，接下来的例子使 wsdl 使用"xsd:date"而不是默认的"xsd:dateTime"
<mappings xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<mapping>
<property name="birthDate" type="org.codehaus.xfire.aegis.type.basic.DateType" typeName="xsd:date" />
</mapping>
</mappings>
在 java 代码里设置默认的 minOccurs 和 nillable 参数
如果你有大部分或者所有的属性都有一个非 0 的 minOccurs 或者非 false 的 nillable, 你可以在 java 代码里更改 Aegis 默认设置
示例：它从服务工厂得到了 binding provider，改变了配置参数
AnnotationServiceFactory serviceFactory = new AnnotationServiceFactory(); // We 'happen to know' what types are used. AegisBindingProvider binder = (AegisBindingProvider)serviceFactory.getBindingProvider() ; DefaultTypeMappingRegistry tmr = (DefaultTypeMappingRegistry)binder.getTypeMappingRegistry (); // here we disuade XFire from its rather annoying tendency to assume that, just because // anything in Java can be null, that we want to advertise all that nullity all over. Configuration configuration = tmr.getConfiguration(); configuration.setDefaultMinOccurs(1); configuration.setDefaultNillable(false);
nillable="true"：该元素的值可以为空，但是该元素不能省略，也就是说，
只能：该元素的值可以为空，但是该元素不能省略，也就是说，只能： <minzero xsi:nil="true"><minzero> 而不能直接将 minzero 这个元素去掉 应该就是表示这个元素为空） （注意：xsi:nil="true"或者 xsi:nil="1"应该就是表示这个元素为空）
注意： 或者 应该就是表示这个元素为空 minOccurs="0"：该元素可以直接被省略掉，但是不能让该元素 的值为空，也就是说，
不能： ：该元素可以直接被省略掉，但是不能让该元素的值为空，也就是说，不能： <minzeroxsi:nil="true"><minzero>