当前位置:首页 > 开发 > Web前端 > 前端 > 正文

Aegis 默认的 Xfire 绑定方式,将 XML 映射为 POJO

发表于: 2012-08-27   作者:MagicMa_007   来源:转载   浏览:
摘要:       Aegis 是一个默认的 Xfire 绑定方式,它将 XML 映射为 POJO, 支持代码先行的开发.你开发服 务类与 POJO,它为你生成 XML schema/wsdl 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>

Aegis 默认的 Xfire 绑定方式,将 XML 映射为 POJO

  • 0

    开心

    开心

  • 0

    板砖

    板砖

  • 0

    感动

    感动

  • 0

    有用

    有用

  • 0

    疑问

    疑问

  • 0

    难过

    难过

  • 0

    无聊

    无聊

  • 0

    震惊

    震惊

推荐文章
编辑推荐
版权所有 IT知识库 CopyRight © 2009-2015 IT知识库 IT610.com , All Rights Reserved. 京ICP备09083238号