JAXB 2.0处理特殊的data type

最新推荐文章于 2020-09-08 10:01:06 发布
最新推荐文章于 2020-09-08 10:01:06 发布
阅读量3.4k 收藏 1
点赞数
分类专栏： web service 文章标签： jaxb schema webservice service class string
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/totogogo/article/details/1926167
版权
 
http://docs.sun.com/app/docs/doc/820-1072/ahigx?l=zh_TW&a=view 对一些特殊的 data type 在 java 和 web service xml 之间的绑定和映射进行了详细的讲解 。下面只是对其中一些部分进行翻译。
 
对那些基本类型（如 int, long, double, string ），不需要添加任何的 annotation 就可以进行把 java data type 映射到 web service schema data type ，即使你是用自定义的 class 来包装基本类型 （象下面例子中的 user class ）
 
举个例子：
User class
public class User {
    public Long id ;
    public String name ;
    public int age ;
}
 
@WebService
public class HelloWS {
    @WebMethod
    public String getHello(String name){
       return "hello " + name;
    }
    @WebMethod
    public User getUser( long id){
       return null ;
    }  
}
 
上面的代码生成的 wsdl 中与 datatype 相关的代码为：
<xs:complexType name='getUserResponse'>
         <xs:sequence>
                   <xs:element minOccurs='0' name='return' type='tns:user'/>
         </xs:sequence>
</xs:complexType>
<xs:complexType name='user'>
         <xs:sequence>
                   <xs:element minOccurs='0' name='id' type='xs:long'/>
                   <xs:element minOccurs='0' name='name' type='xs:string'/>
                  <xs:element name='age' type='xs:int'/>
         </xs:sequence>
</xs:complexType>
<xs:complexType name='getHelloResponse'>
         <xs:sequence>
                   <xs:element minOccurs='0' name='return' type='xs:string'/>
         </xs:sequence>
</xs:complexType>
 
从上面可以看到基本类型的相互转换很容易。
 
但总是有一些特殊的 data type ，如
1．  BigDecimal Type
2．  java.net.URI Type
3．  Duration
4．  Binary Types
5．  XMLGregorianCalendar Type
6．  UUID Type
7．  Typed Variables
8．  Collections Types
9．  Array Types
10 ． Enum type
 
这些 datatype ， JAX-WS 2.0 对它映射转换成 web service schema data type 有时必须要借助 JAXB 的 annotation ！！ （因此， classpath 要加入 jaxb-api.jar ）
 
下面只介绍 binary type, collections type, array type and enum type 如何映射，其他的请参看文章开头给的 link 。
 
Binary Type
对于该类型， JAXB 2.0 提供了 annotation @XmlMimeType 来定义。
先举一个Mapping java.awt.Image without @XmlMimeType 的例子： 
//-- Java code fragment
public class Claim {
    public java.awt.Image photo;
}
 
//-- Schema fragment
<xs:complexType name="claim">
    <xs:sequence>
        <xs:element name="photo" type="xs:base64Binary" minOccurs="0"/>
    </xs:sequence>
</xs:complexType>
 
再举一个Mapping java.awt.Image with @XmlMimeType 的例子： 
//-- Java code fragment
public class Claim {
    @XmlMimeType("image/gif")
    public java.awt.Image photo;
}
 
//-- Schema fragment
<xs:complexType name="claim">
    <xs:sequence>
        <xs:element name="photo" ns1:expectedContentTypes="image/gif"
                    type="xs:base64Binary" minOccurs="0"
                    xmlns:ns1="http://www.w3.org/2005/05/xmlmime"/>
    </xs:sequence>
</xs:complexType>
 
Collection Type
Collection type 包含有 array, list 以及泛型的 list （如 List<Integer> ）等。有下列 3 种方法来把 collection type 映射到 web service schema data type
 
方法 1 ：缺省处理 collection type
如果对于 collection type （例如 List<Integer> ）不使用任何的 annotation ，那么缺省映射到 web service schema 为一个“ minOccurs=0 ， maxOccurs=unbounded ， nillable=true ”的 datatype 。
 
Nillable 表示可以为 null 。
 
请注意：对于 collection type ， web service schema 用 minOccurs=0 ， maxOccurs=unbounded 来表示！！如果 collection type 没有指定泛型，那么缺省为 String
 
对 collection type 缺省使用没有什么不妥，但由于 nillable=true ，所以 .NET 根据 web service schema 生成的 datatype 为 Nullable<int>[ ] 。
 
例子： 
//-- Java code fragment
@XmlRootElement(name="po")
public PurchaseOrder {
    public List<Integer> items;
}
 
//-- Schema fragment
<xs:element name="po" type="purchaseOrder">
<xs:complexType name="purchaseOrder">
    <xs:sequence>
        <xs:element name="items" type="xs:int" nillable="true"
                    minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
</xs:complexType>
 
//-- .NET auto generated code from schema
partial class purchaseOrder {
    private System.Nullable<int>[] itemsField;
    public System.Nullable<int>[] items
    {
        get { return this.itemsField; }
        set { this.itemsField = value; }   
    }
}
 
方法 2 ：通过 @XmlElement annotation 定义成非 nillable 的 data type
//-- Java code fragment
@XmlRootElement(name="po")
public PurchaseOrder {
    @XmlElement(nillable=false)
    public List<Integer> items;
}
 
//-- Schema fragment
<xs:element name="po" type="purchaseOrder">
<xs:complexType name="purchaseOrder">
    <xs:sequence>
        <xs:element name="items" type="xs:int"
                    minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
</xs:complexType>
...
 
// .NET auto generated code from schema
partial class purchaseOrder {
    private int[] itemsField;
    public int[] items
    {
        get { return this.itemsField; }
        set { this.itemsField = value; }   
    }
}
 
方法 3 ：通过 @XmlList annotation 定义成 web service schema 的 list data type 
//-- Java code fragment
@XmlRootElement(name="po")
public PurchaseOrder {
@XmlList 
public List<Integer> items;
}
 
//-- Schema fragment
<xs:element name="po" type="purchaseOrder">
<xs:complexType name="purchaseOrder">
    <xs:element name="items" minOccurs="0">
        <xs:simpleType>
            <xs:list itemType="xs:int"/>
        </xs:simpleType>
    </xs:element>
</xs:complexType>
 
 
那么对于数组，只需要缺省处理就可以啦。
例子：
@WebService
public class HelloWS {
    @WebMethod
    public int [] getMonths(){
       return null ;
    }
}
 
上面的代码生成的 web service schema 的相关代码是：
<xs:complexType name='getMonthsResponse'>
         <xs:sequence>
                   <xs:element maxOccurs='unbounded' minOccurs='0' name='return' type='xs:int'/>
         </xs:sequence>
</xs:complexType>
 
可见 maxOccurs 属性同样可以用来表示数组！
 
************ 一个需要很留意的问题 *************
如果你希望要用上面的方法 3 来设置你的 collection type （例如 List<Integer> ），那么就一定不能够把 collection type 作为 web service method 的返回值，而应该用一个 class 来包装该 collection type 。
 
举个例子：
@WebService
public class HelloWS {
    public ArrayList<String> getWords(){
       return null ;
    }
}
 
上面的代码生成的 web service schema 的相关代码是：
<xs:complexType name='getWordsResponse'>
         <xs:sequence>
                   <xs:element maxOccurs='unbounded' minOccurs='0' name='return' type='xs:string'/>
         </xs:sequence>
</xs:complexType>
 
但你却无法生成使用方法 3 得到的代码：
<xs:complexType name='getWordsResponse'>
         <xs:sequence>
                   <xs:element minOccurs='0' name='return' type='tns:words'/>
         </xs:sequence>
</xs:complexType>
<xs:complexType name='words'>
         <xs:sequence>
                   <xs:element minOccurs='0' name='words'>
                            <xs:simpleType>
                                     <xs:list itemType='xs:string'/>
                            </xs:simpleType>
                   </xs:element>
         </xs:sequence>
</xs:complexType>
 
解决办法就是定义一个 class 来包装该 collection type 变量：
@WebService
public class HelloWS {
    public Words getWords(){
       return null ;
    }
}
 
Words.java
public class Words {
    @XmlList
    public ArrayList<String> words;
}
 
 
Enum Type
例子：
Country.java
public enum Country {
    CHINA , ENGLAND , BRASIL
}
 
User.java
public class User {
    public Country country ;
}
 
那么生成的 web service schema 相关代码为：
<xs:complexType name='user'>
         <xs:sequence>
                   <xs:element minOccurs='0' name='country' type='tns:country'/>
         </xs:sequence>
</xs:complexType>
<xs:simpleType name='country'>
         <xs:restriction base='xs:string'>
                   <xs:enumeration value='CHINA'/>
                   <xs:enumeration value='ENGLAND'/>
                   <xs:enumeration value='BRASIL'/>
         </xs:restriction>
</xs:simpleType>
 
 
totogogo
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
消息编码
zhongjie的专栏
04-30 2408
　　消息编码　　随着时间的流逝，也许我们会条件反射式地认为XML（SOAP）是一个结构文本。毕竟，文本是人可读的，每个计算机系统也可以处理文本。基于文本的XML的普遍共性与我们的与其它系统交互的想法产生了共鸣。可以容易的解释的基于文本的XML本质上会体积变大。可以理解使用XML会带来性能损失。就像要花费点精力把信装到信封里一样，它需要一些处理时间与XML交互。某些情况下，基于文本的XML数据大
jaxb2.0英文文档
05-03
**Java Architecture for XML Binding (JAXB) 2.0** 是一个Java标准，它提供了一种将XML数据与Java对象之间进行自动转换的机制。这个技术是Java平台企业版（Java EE）的一部分，也是Java标准版（Java SE）的一个可选...
WebService多种方式调用包含base64Binary的接口
天外来客的博客
09-08 3239
转自:Web Service单元测试工具实例介绍之SoapUI
sqlserver varbinary to base64
lisai的专栏
02-09 4239
select top 1 cast('' as xml).value( 'xs:base64Binary(sql:column("二进制字段"))', 'varchar(max)' ) 二进制字段 from tablename
Jaxb annotation初步使用
hongtaq的专栏
11-21 975
Jaxb annotation初步使用 　一.Jaxb处理java对象和xml之间转换常用的annotation有： @XmlType@XmlElement@XmlRootElement@XmlAttribute@XmlAccessorType@XmlAccessorOrder@XmlTransient@XmlJavaTypeAdapter 　二.常用annota
XSD 数据类型
TONGGETONGGE的专栏
11-23 8774
字符串数据类型（String Data Type） 字符串数据类型可包含字符、换行、回车以及制表符。 下面是一个关于某个 scheme 中字符串声明的例子： xs:element name="customer" type="xs:string"/> 文档中的元素看上去应该类似这样： John Smith 或者类似这样： John Smith 注释：如果您使用字符串数据类
xsd表示byte[]的类型
weixin_30414155的博客
03-09 168
byte[]对应xs:base64Binary http://stackoverflow.com/questions/5912526/representing-byte-array-as-an-xsd-schema 转载于:https://www.cnblogs.com/liqipeng/p/6526890.html
JAVA_API1.6文档（中文）
04-12
java.awt.datatransfer 提供在应用程序之间和在应用程序内部传输数据的接口和类。 java.awt.dnd Drag 和 Drop 是一种直接操作动作，在许多图形用户界面系统中都会遇到它，它提供了一种机制，能够在两个与 GUI 中...
[Java参考文档].JDK_API 1.6
09-21
java.awt.datatransfer 提供在应用程序之间和在应用程序内部传输数据的接口和类。 java.awt.dnd Drag 和 Drop 是一种直接操作动作，在许多图形用户界面系统中都会遇到它，它提供了一种机制，能够在两个与 GUI 中显示...
java api最新7.0
10-26
java.awt.datatransfer 提供在应用程序之间和在应用程序内部传输数据的接口和类。 java.awt.dnd Drag 和 Drop 是一种直接操作动作，在许多图形用户界面系统中都会遇到它，它提供了一种机制，能够在两个与 GUI 中显示...
JDK_1_6 API
03-04
java.awt.datatransfer 提供在应用程序之间和在应用程序内部传输数据的接口和类。 java.awt.dnd Drag 和 Drop 是一种直接操作动作，在许多图形用户界面系统中都会遇到它，它提供了一种机制，能够在两个与 GUI 中...
Ms SqlServer Base64字符串解码函数
搁浅的博客
09-08 1386
一、SqlServer 代码 USE[数据库名称] GO /******Object:UserDefinedFunction[dbo].[Base64StrDecode]ScriptDate:2020/4/716:57:00******/ SETANSI_NULLSON GO SETQUOTED_IDENTIFIERON GO CREATEFUNCTION[dbo].[Base64StrDecode](@Base64Strvarchar(max)) RETURNs...
Base64编码的几种实现方式
Dima3773的博客
07-09 4159
一、JDK1.6实现 import javax.xml.bind.DatatypeConverter; import org.junit.Test; public class Jdk6Base64Test { /** * JDK1.6实现Base64编码解码 */ @Test public void testBase64ByJDK6() th...
XSD中内置的数据类型（总结）
红角'blog,一步一步!
09-19 5398
1.字符串数据类型（String Data Type） 字符串数据类型请注意，所有以下的数据类型均衍生于字符串数据类型（除了字符串数据类本身）！名称                   描述 ENTITIES   ENTITY   ID：在XML中提交ID属性的字符串(only used with schema attributes) IDREF：在XML中提交IDREF属性的字符串(
XML Schema 中 Order 指示器 choice all sequence和 Occurrence 指示器 minOccurs maxOccurs 的用法解释
舒海文的博客
10-11 3085
XML Schema 中 Order 指示器 choice all sequence和 Occurrence 指示器 minOccurs maxOccurs 的用法解释 Order 指示器 all <all> 指示器规定子元素可以按照任意顺序出现 myXsd.xsd文件 <?xml version="1.0" encoding="UTF-8"?> <xsd:sch...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值