術(shù)語(yǔ)約定
文章中會(huì)反復(fù)出現(xiàn)[值類型]、[包裝類型]、[普通引用類型]、[元素節(jié)點(diǎn)]和[元素取值]的表述
1> [值類型]指的是java和.NET中的基本數(shù)據(jù)類型,如:int;
2> [包裝類型]指的是java中的包裝類和.NET中的Nullable<T>類型,如:Integer、int?;
3> [普通引用類型]指的是除包裝類型外的其它引用類型;
4> [元素節(jié)點(diǎn)]指的是xml文檔中的一個(gè)標(biāo)簽節(jié)點(diǎn),我們可以說[元素節(jié)點(diǎn)]是必輸還是非必輸,如:<Name>lubiao</Name>;
5> [元素取值]指的是xml標(biāo)簽節(jié)點(diǎn)的內(nèi)容,我們可以說[元素取值]是空還是非空,如:<Name>lubiao</Name>表示元素取值不為空,<Name xsi:nil="true"/>表示元素取值為空;
1、首先來看minOccurs和Nillable的定義
minOccurs:表示XML文檔中某個(gè)[元素節(jié)點(diǎn)] 是否可以不出現(xiàn),默認(rèn)值為1,表示必須出現(xiàn)
nillable:表示XML文檔中某個(gè)[元素取值] 是否可以為空(形如:<name xsi:nil="true" />),默認(rèn)值為false,表示不能為空
那么,minOccurs和nillable的組合形式就會(huì)有4種,如下:
例一,值類型:
- <element name="id1" type="int" minOccurs="0" nillable="true"/>
- <element name="id2" type="int" minOccurs="0" nillable="false"/>
- <element name="id3" type="int" minOccurs="1" nillable="true"/>
- <element name="id4" type="int" minOccurs="1" nillable="false"/>
例二,引用類型:
- <element name="name1" type="string" minOccurs="0" nillable="true"/>
- <element name="name2" type="string" minOccurs="0" nillable="false"/>
- <element name="name3" type="string" minOccurs="1" nillable="true"/>
- <element name="name4" type="string" minOccurs="1" nillable="false"/>
2、Java和.NET自動(dòng)生成WSDL的規(guī)則
在實(shí)際開發(fā)時(shí)我們通常的做法是先編寫Server端代碼,然后利用工具自動(dòng)生成wsdl描述,最后再利用工具讀取wsdl進(jìn)而生成客戶端程序。那么用工具生成wsdl和用工具反向生成代理程序的規(guī)則是什么呢?下來對(duì)此進(jìn)行實(shí)例分析:
2.1 先看.NET生成wsdl的規(guī)則
實(shí)驗(yàn)時(shí)所用的開發(fā)工具為VS 2010,用vs開發(fā)WebService的資料,百度搜索一大推,這里不贅述。
2.1.1、定義數(shù)據(jù)實(shí)體:Person.cs
- public class Person
- {
- public int Id { get; set; } //值類型
- public string Name { get; set; }//普通引用類型
- public int? PhoneNbr { get; set; }//包裝類型
- }
2.1.2、定義服務(wù)類:WebService.cs
- /// <summary>
- ///WebService 的摘要說明
- /// </summary>
- [WebService(Namespace = "http://tempuri.org/")]
- [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
- public class WebService : System.Web.Services.WebService {
-
- public WebService () {
- //如果使用設(shè)計(jì)的組件,請(qǐng)取消注釋以下行
- //InitializeComponent();
- }
-
- [WebMethod]
- public string HelloWorld(int id,int? phoneNbr,string name,Person person) {
- return "Hello World";
- }
-
- }
helloWorld方法有4個(gè)參數(shù),前三個(gè)參數(shù)和Person類的三個(gè)屬性是一樣的,加入這三個(gè)參數(shù)的目的是進(jìn)行對(duì)比測(cè)試。
2.1.3、查看生成的wsdl
- <?xml version="1.0" encoding="utf-8"?>
- <wsdl:definitions xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:tns="http://tempuri.org/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:s="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" targetNamespace="http://tempuri.org/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
- <wsdl:types>
- <s:schema elementFormDefault="qualified" targetNamespace="http://tempuri.org/">
- <s:element name="HelloWorld">
- <s:complexType>
- <s:sequence>
- <s:element minOccurs="1" maxOccurs="1" name="id" type="s:int" />
- <!--nillable默認(rèn)為false,minOccurs等于1:即id元素為必輸,且值不能為空-->
- <s:element minOccurs="1" maxOccurs="1" name="phoneNbr" nillable="true" type="s:int" />
- <!--nillable等于true,minOccurs等于1:即phoneNbr元素為必輸,但值可以為空-->
- <s:element minOccurs="0" maxOccurs="1" name="name" type="s:string" />
- <!--nillable默認(rèn)為false,minOccurs等于0:即name元素為非必輸,但值不能為空-->
- <s:element minOccurs="0" maxOccurs="1" name="person" type="tns:Person" />
- <!--nillable默認(rèn)為false,minOccurs等于0:即person元素為非必輸,但值不能為空-->
- </s:sequence>
- </s:complexType>
- </s:element>
- <s:complexType name="Person">
- <s:sequence>
- <s:element minOccurs="1" maxOccurs="1" name="Id" type="s:int" />
- <!--nillable默認(rèn)為false,minOccurs默認(rèn)為1:即id元素為必輸,且值不能為空-->
- <s:element minOccurs="0" maxOccurs="1" name="Name" type="s:string" />
- <!--nillable默認(rèn)為false,minOccurs等于0:即Name元素為非必輸,但值不能為空-->
- <s:element minOccurs="1" maxOccurs="1" name="PhoneNbr" nillable="true" type="s:int" />
- <!--nillable默認(rèn)為false,minOccurs等于1:即PhoneNbr元素為必輸,但值可以為空-->
- </s:sequence>
- </s:complexType>
- <s:element name="HelloWorldResponse">
- <s:complexType>
- <s:sequence>
- <s:element minOccurs="0" maxOccurs="1" name="HelloWorldResult" type="s:string" />
- </s:sequence>
- </s:complexType>
- </s:element>
- </s:schema>
- </wsdl:types>
- </wsdl:definitions>
2.1.4、得出結(jié)論
* id參數(shù)和Person.Id屬性都為值類型:[元素節(jié)點(diǎn)] 都必輸,[元素取值] 都不能為空
* phoneNbr參數(shù)和Person.PhoneNbr屬性都是包裝類型:[元素節(jié)點(diǎn)] 都必輸,但[元素取值] 都可以為空;
* name參數(shù)和Person.Name屬性都是普通引用類型:[元素節(jié)點(diǎn)] 都可以不輸,但[元素取值] 都不能為空;
* person參數(shù)是普通引用類型:[元素節(jié)點(diǎn)] 可以不輸,但[元素取值] 不能為空。
2.2 再看Java的規(guī)則
首先,先熟悉在eclipse中快速開發(fā)webservice程序的步驟,參考鏈接:http://www.blogjava.net/parable-myth/archive/2010/08/03/327802.html,此次實(shí)驗(yàn)采用的就是這種快速開發(fā)方式(注:不同的框架和工具會(huì)可能會(huì)有不同的生成規(guī)則),所用ecllipse版本為:
Version: Juno Service Release 1
Build id: 20121004-1855
2.2.1、定義數(shù)據(jù)實(shí)體:Person.java
- package com.lubiao.axis;
-
- public class Person implements java.io.Serializable {
- private int id;//編號(hào),值類型
- private java.lang.String name;//姓名,普通引用類型
- private Integer phoneNbr;//電話,包裝類型
-
- public int getId() {return id;}
- public void setId(int id) {this.id = id;}
-
- public java.lang.String getName() {return name;}
- public void setName(java.lang.String name) {this.name = name;}
-
- public Integer getPhoneNbr() {return phoneNbr;}
- public void setPhoneNbr(Integer phoneNbr) {this.phoneNbr = phoneNbr;}
- }
2.2.2、定義服務(wù)類:WebServiceTest.java
- package com.lubiao.axis;
-
- public class WebServiceTest{
- public String helloWorld(int id,Integer phoneNbr,String name,Person person){
- return "Hello World";
- }
- }
helloWorld方法有4個(gè)參數(shù),前三個(gè)參數(shù)和Person類的三個(gè)屬性是一樣的,加入這三個(gè)參數(shù)的目的是進(jìn)行對(duì)比測(cè)試。
2.2.3、查看生成的Wsdl
- <?xml version="1.0" encoding="UTF-8"?>
- <wsdl:definitions targetNamespace="http://axis.lubiao.com" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://axis.lubiao.com" xmlns:intf="http://axis.lubiao.com" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
- <!--WSDL created by Apache Axis version: 1.4 Built on Apr 22, 2006 (06:55:48 PDT)-->
- <wsdl:types>
- <schema elementFormDefault="qualified" targetNamespace="http://axis.lubiao.com" xmlns="http://www.w3.org/2001/XMLSchema">
- <element name="helloWorld">
- <complexType>
- <sequence>
- <element name="id" type="xsd:int"/>
- <!--nillable默認(rèn)為false,minOccurs默認(rèn)為1:即id元素為必輸,且值不能為空-->
- <element name="phoneNbr" type="xsd:int"/>
- <!--nillable默認(rèn)為false,minOccurs默認(rèn)為1:即phoneNbr元素為必輸,且值不能為空-->
- <element name="name" type="xsd:string"/>
- <!--nillable默認(rèn)為false,minOccurs默認(rèn)為1:即name元素為必輸,且值不能為空-->
- <element name="person" type="impl:Person"/>
- <!--nillable默認(rèn)為false,minOccurs默認(rèn)為1:即person元素為必輸,且值不能為空-->
- </sequence>
- </complexType>
- </element>
- <complexType name="Person">
- <sequence>
- <element name="id" type="xsd:int"/>
- <!--nillable默認(rèn)為false,minOccurs默認(rèn)為1:即id元素為必輸,且值不能為空-->
- <element name="name" nillable="true" type="xsd:string"/>
- <!--nillable默認(rèn)為true,minOccurs默認(rèn)為1:即name元素為必輸,但值可以為空-->
- <element name="phoneNbr" nillable="true" type="xsd:int"/>
- <!--nillable默認(rèn)為true,minOccurs默認(rèn)為1:即phoneNbr元素為必輸,但值可以為空-->
- </sequence>
- </complexType>
- <element name="helloWorldResponse">
- <complexType>
- <sequence>
- <element name="helloWorldReturn" type="xsd:string"/>
- </sequence>
- </complexType>
- </element>
- </schema>
- </wsdl:types>
- <!-- 其它元素省略 -->
- </wsdl:definitions>
2.2.4、得出結(jié)論
* id參數(shù)和Person.id屬性都是值類型:[元素節(jié)點(diǎn)] 都必輸,[元素取值] 都不能為空;
* phoneNbr參數(shù)和Person.phoneNbr屬性都是包裝類型:[元素節(jié)點(diǎn)] 都必輸,但前者[元素取值]不能為空,后者[元素取值]可以為空;
* name參數(shù)和Person.name屬性都是普通的引用類型:[元素節(jié)點(diǎn)] 都必輸,但前者[元素取值]不能為空,后者[元素取值]可以為空;
* person參數(shù)屬于普通引用類型:[元素節(jié)點(diǎn)]必輸,且[元素取值]不能為空;
*總結(jié):此框架生成wsdl時(shí)認(rèn)為:
1、作為方法參數(shù)時(shí),不管是值類型、包裝類型還是普通引用類型,[元素節(jié)點(diǎn)]都為必輸項(xiàng),且[元素取值]都不能為空;
2、作為對(duì)象屬性時(shí),不管是值類型、包裝類型還是普通引用類型,[元素節(jié)點(diǎn)]都為必輸項(xiàng),其中值類型的[元素取值]不能為空,但包裝類型和普通引用類型的[元素取值]可以為空。
2.3、Java和.NET的異同
其一,對(duì)于值類型:
Java和.NET都認(rèn)為值類型不論是作為 [方法參數(shù)時(shí)] 還是 [對(duì)象屬性時(shí)] ,[元素節(jié)點(diǎn)]都為必輸項(xiàng),且[元素取值]都不能為空。
(都合理:這符合值類型的特點(diǎn),總有一個(gè)值)
其二,對(duì)于包裝類型:
作為方法參數(shù)時(shí):java和.NET都認(rèn)為[元素節(jié)點(diǎn)]是必輸?shù)?,但java認(rèn)為[元素取值]不能為空,而.NET認(rèn)為[元素取值]可以為空;
(.NET合理,Java不合理。java既要求必輸又要求值不能為空,那空對(duì)象怎么傳入?可以通過生成客戶端代理進(jìn)行驗(yàn)證(這里不再演示),對(duì)于phoneNbr參數(shù)客戶端代碼變成了int類型,而服務(wù)端可是Integer類型)
作為對(duì)象屬性時(shí):java和.NET都認(rèn)為[元素是節(jié)點(diǎn)]必輸?shù)模鳾元素取值]是可以為空的;
(都合理。java和.net都要求節(jié)點(diǎn)必須出現(xiàn),然后以nillable=true標(biāo)識(shí)可以傳入空值)
其三,對(duì)于普通引用類型:
作為方法參數(shù)時(shí):java和.NET都認(rèn)為[元素取值]是不能為空的,但Java同時(shí)認(rèn)為[元素節(jié)點(diǎn)]是必輸?shù)?,?NET認(rèn)為[元素節(jié)點(diǎn)]是非必輸?shù)模?br> (.NET合理,Java不合理。java既要求節(jié)點(diǎn)必輸還要求值不能為空,那空對(duì)象怎么傳入?)
作為對(duì)象屬性時(shí):java認(rèn)為[元素節(jié)點(diǎn)]是必輸?shù)?、[元素取值]是可空的;.NET認(rèn)為[元素節(jié)點(diǎn)]是非必輸?shù)?、[元素取值]是不可空的。
(都合理。java始終要求必輸,但以nillable=true標(biāo)識(shí)可以傳入空對(duì)象;.NET始終要求元素取值不能為空,但以minOccurs=0來標(biāo)識(shí)可以傳入空對(duì)象)
總結(jié):
作為參數(shù)時(shí),java出現(xiàn)了很多不合理的情況,可能是因?yàn)檫x的這個(gè)框架有bug,這里不再關(guān)心,主要看作為對(duì)象屬性時(shí)的情況。文章最開始的時(shí)候說到minOccurs和nillable會(huì)有4種組合方式,在上面的實(shí)驗(yàn)中java用到了兩種,而.NET用到了3種,分別為:
Java:[ minOccurs=1,nillable=false ] 和 [ minOccurs=1,nillable=true ],前者對(duì)應(yīng)值類型,后者對(duì)應(yīng)引用類型(包裝類型和普通引用類型),java壓根沒用minOccrs=0
.NET:[ minOccurs=1,nillable=false ]、[ minOccurs=1,nillable=true ] 和[ minOccurs=0,nillable=false],前者對(duì)應(yīng)值類型,再者對(duì)應(yīng)包裝類型,最后對(duì)應(yīng)普通引用類型。
3、Java和.NET由WSDL自動(dòng)生成代碼的規(guī)則
接著上面的實(shí)驗(yàn)結(jié)果,先來做最簡(jiǎn)單的測(cè)試:1、用java的client對(duì)接java的service生成代碼;2、用.NET的client對(duì)接.NET的Service生成代碼,然后分別觀察Client端自動(dòng)生成的Person類和Server段的Person是否完全一致。這里不再演示,只說結(jié)論,結(jié)論是:生成的Person分別和各自Server端的完全相同。
那如果用[ java對(duì)接.NET ] 或者[ 用.NET對(duì)接java ],會(huì)是什么結(jié)果呢?等一等,這么問好像有問題,哪有什么誰對(duì)接誰,大家對(duì)接的都是wsdl,哪里知道wsdl后面是什么平臺(tái)?。∴?,那就把minOccurs和nillable的四種組合都列出來,看java和.NET的生成規(guī)則分別是什么樣的,繼續(xù)。
3.1 先看.NET的規(guī)則
3.1.1 定義WSDL,限于篇幅只列出類型定義部分
- <?xml version="1.0" encoding="UTF-8"?>
- <schema xmlns="<a target="_blank" ></element>
- </schema>
id對(duì)應(yīng)的是值類型,name對(duì)應(yīng)的是引用類型
3.1.2 生成數(shù)據(jù)類
分析:
id1:可空類型、特性:IsNullable=true、生成了對(duì)應(yīng)的id1Specified
id2:值類型、特性:IsNullable=false、生成了對(duì)應(yīng)的id2Specified
id3:可空類型、特性:IsNullable=true
id4:值類型、特性:IsNullable=false
name1:引用類型、特性:IsNullable=true
name2:引用類型、特性:IsNullable=false
name3:引用類型、特性:IsNullable=true
name4:引用類型、特性:IsNullable=false
3.1.3 查看SOAP報(bào)文
將可為null的屬性都置位null,然后查看SOAP報(bào)文是什么樣子的
C#代碼1:
- Person p=new Person();
- p.id1 = null;
- p.id2 = 123;
- p.id3 = null;
- p.id4 = 456;
- p.name1 = null;
- p.name2 = null;
- p.name3 = null;
- p.name4 = null;
C#代碼2:
- Person p=new Person();
- p.id1 = null;
- p.id1Specified = true;
- request.id2 = 123;
- p.id1Specified = true;
- p.id3 = null;
- p.id4 = 456;
- p.name1 = null;
- p.name2 = null;
- p.name3 = null;
- p.name4 = null;
SOAP報(bào)文1:對(duì)應(yīng)C#代碼1,只貼出Person部分:
- <Person>
- <id3 xsi:nil="true" />
- <id4>456</id4>
- <name1 xsi:nil="true" />
- <name3 xsi:nil="true" />
- </Person>
SOAP報(bào)文2:對(duì)應(yīng)C#代碼2,只貼出Person部分:
- <Person>
- <id1 xsi:nil="true" />
- <id2>123</id2>
- <id3 xsi:nil="true" />
- <id4>456</id4>
- <name1 xsi:nil="true" />
- <name3 xsi:nil="true" />
- </Person>
3.1.4 得出結(jié)論
其一:對(duì)于值類型和包裝類型
minOccurs="0" 組合nillable="true"時(shí):
會(huì)生成包裝類型(id1),同時(shí)會(huì)生成對(duì)應(yīng)的id1Specified屬性,為什么會(huì)生成帶Specified的屬性呢?這是因?yàn)閙inOccurs="0"的緣故,minOccurs=0意味著元素節(jié)點(diǎn)可以不出現(xiàn),那到底是出現(xiàn)呢?還是不出現(xiàn)呢?工具自己沒了主意,所以生成了一個(gè)xxxSpecified屬性,該屬性默認(rèn)值為false,只有給它指定true的時(shí)候[元素節(jié)點(diǎn)]才會(huì)出現(xiàn)到soap報(bào)文中。
minOccurs="0"組合nillable="false"時(shí):
會(huì)生成值類型(id2),同時(shí)會(huì)生成對(duì)應(yīng)的id2Specified屬性(原因同上)
minOccurs="1" 組合nillable="true"時(shí):
會(huì)生成包裝(id3),不會(huì)生成Specified屬性(因?yàn)樵毓?jié)點(diǎn)必輸)。
minOccurs=“1”組合nillable=“false”時(shí):
會(huì)生成值類型(id4),不會(huì)生成Specified屬性(因?yàn)樵毓?jié)點(diǎn)必輸)。
其二:對(duì)于普通引用類型
name1、name3:
只要nillable=true不管minOccurs等于什么,[null對(duì)象]序列化的時(shí)候都以[元素取值]為空方式來體現(xiàn)這是一個(gè)空對(duì)象。
name2、name4:
只要nillable=false不管minOccurs等于什么,[null對(duì)象]序列化時(shí)都以[元素節(jié)點(diǎn)]不出現(xiàn)的方式來體現(xiàn)這是一個(gè)空對(duì)象。(上面實(shí)驗(yàn)時(shí),Server端對(duì)soap報(bào)文進(jìn)行了schema驗(yàn)證,所以name4傳null會(huì)報(bào)錯(cuò)的)
總結(jié):
* .NET在wsdl_2_C# 和C#_2_wsdl時(shí)的思路其實(shí)是一致的,1、生成值類型還是包裝類型先看nillable屬性、然后再看minOccurs屬性來控制是否生成xxxSpecified屬性;2、而生成普通引用類型時(shí)只關(guān)心nillable屬性,nillable=true就采用nil=true的方式發(fā)送null對(duì)象,nillabe=false則采用[元素節(jié)點(diǎn)]不出現(xiàn)的方式發(fā)送null對(duì)象,壓根就不關(guān)心minOccurs是神馬。
* 前面說到name4=null時(shí),Server端會(huì)報(bào)錯(cuò),所以 對(duì)于引用類型:minOccurs=1和nillable=false的組合是沒有意義的,這種組合無法讓空對(duì)象傳輸過來
3.2 再看Java的規(guī)則
3.2.1 定義WSDL,限于篇幅只列出類型定義部分
- <span style="color:#000000;"><?xml version="1.0" encoding="UTF-8"?>
- <schema xmlns="<a target="_blank" ></element>
- </schema>
- </span>
和.net相比,此處多了一個(gè)類型PersonRequest,之所以改成這樣是因?yàn)椋喝绻凑課et那種方式,生成的java代碼中不會(huì)有Person類,因?yàn)楣ぞ哒J(rèn)為id1,id2....是GetPerson的參數(shù)。
3.1.2 生成數(shù)據(jù)類
- <span style="color:#000000;">/**
- * Person.java
- *
- * This file was auto-generated from WSDL
- * by the Apache Axis 1.4 Apr 22, 2006 (06:55:48 PDT) WSDL2Java emitter.
- */
-
- package core.bank.csii.com.system;
-
- public class Person implements java.io.Serializable {
- private java.lang.Long id1;
-
- private java.lang.Long id2;
-
- private java.lang.Long id3;
-
- private long id4;
-
- private java.lang.String name1;
-
- private java.lang.String name2;
-
- private java.lang.String name3;
-
- private java.lang.String name4;
-
- public Person() {
- }
-
- public Person(
- java.lang.Long id1,
- java.lang.Long id2,
- java.lang.Long id3,
- long id4,
- java.lang.String name1,
- java.lang.String name2,
- java.lang.String name3,
- java.lang.String name4) {
- this.id1 = id1;
- this.id2 = id2;
- this.id3 = id3;
- this.id4 = id4;
- this.name1 = name1;
- this.name2 = name2;
- this.name3 = name3;
- this.name4 = name4;
- }
-
-
- /**
- * Gets the id1 value for this Person.
- *
- * @return id1
- */
- public java.lang.Long getId1() {
- return id1;
- }
-
-
- /**
- * Sets the id1 value for this Person.
- *
- * @param id1
- */
- public void setId1(java.lang.Long id1) {
- this.id1 = id1;
- }
-
-
- /**
- * Gets the id2 value for this Person.
- *
- * @return id2
- */
- public java.lang.Long getId2() {
- return id2;
- }
-
-
- /**
- * Sets the id2 value for this Person.
- *
- * @param id2
- */
- public void setId2(java.lang.Long id2) {
- this.id2 = id2;
- }
-
-
- /**
- * Gets the id3 value for this Person.
- *
- * @return id3
- */
- public java.lang.Long getId3() {
- return id3;
- }
-
-
- /**
- * Sets the id3 value for this Person.
- *
- * @param id3
- */
- public void setId3(java.lang.Long id3) {
- this.id3 = id3;
- }
-
-
- /**
- * Gets the id4 value for this Person.
- *
- * @return id4
- */
- public long getId4() {
- return id4;
- }
-
-
- /**
- * Sets the id4 value for this Person.
- *
- * @param id4
- */
- public void setId4(long id4) {
- this.id4 = id4;
- }
-
-
- /**
- * Gets the name1 value for this Person.
- *
- * @return name1
- */
- public java.lang.String getName1() {
- return name1;
- }
-
-
- /**
- * Sets the name1 value for this Person.
- *
- * @param name1
- */
- public void setName1(java.lang.String name1) {
- this.name1 = name1;
- }
-
-
- /**
- * Gets the name2 value for this Person.
- *
- * @return name2
- */
- public java.lang.String getName2() {
- return name2;
- }
-
-
- /**
- * Sets the name2 value for this Person.
- *
- * @param name2
- */
- public void setName2(java.lang.String name2) {
- this.name2 = name2;
- }
-
-
- /**
- * Gets the name3 value for this Person.
- *
- * @return name3
- */
- public java.lang.String getName3() {
- return name3;
- }
-
-
- /**
- * Sets the name3 value for this Person.
- *
- * @param name3
- */
- public void setName3(java.lang.String name3) {
- this.name3 = name3;
- }
-
-
- /**
- * Gets the name4 value for this Person.
- *
- * @return name4
- */
- public java.lang.String getName4() {
- return name4;
- }
-
-
- /**
- * Sets the name4 value for this Person.
- *
- * @param name4
- */
- public void setName4(java.lang.String name4) {
- this.name4 = name4;
- }
-
- private java.lang.Object __equalsCalc = null;
- public synchronized boolean equals(java.lang.Object obj) {
- if (!(obj instanceof Person)) return false;
- Person other = (Person) obj;
- if (obj == null) return false;
- if (this == obj) return true;
- if (__equalsCalc != null) {
- return (__equalsCalc == obj);
- }
- __equalsCalc = obj;
- boolean _equals;
- _equals = true &&
- ((this.id1==null && other.getId1()==null) ||
- (this.id1!=null &&
- this.id1.equals(other.getId1()))) &&
- ((this.id2==null && other.getId2()==null) ||
- (this.id2!=null &&
- this.id2.equals(other.getId2()))) &&
- ((this.id3==null && other.getId3()==null) ||
- (this.id3!=null &&
- this.id3.equals(other.getId3()))) &&
- this.id4 == other.getId4() &&
- ((this.name1==null && other.getName1()==null) ||
- (this.name1!=null &&
- this.name1.equals(other.getName1()))) &&
- ((this.name2==null && other.getName2()==null) ||
- (this.name2!=null &&
- this.name2.equals(other.getName2()))) &&
- ((this.name3==null && other.getName3()==null) ||
- (this.name3!=null &&
- this.name3.equals(other.getName3()))) &&
- ((this.name4==null && other.getName4()==null) ||
- (this.name4!=null &&
- this.name4.equals(other.getName4())));
- __equalsCalc = null;
- return _equals;
- }
-
- private boolean __hashCodeCalc = false;
- public synchronized int hashCode() {
- if (__hashCodeCalc) {
- return 0;
- }
- __hashCodeCalc = true;
- int _hashCode = 1;
- if (getId1() != null) {
- _hashCode += getId1().hashCode();
- }
- if (getId2() != null) {
- _hashCode += getId2().hashCode();
- }
- if (getId3() != null) {
- _hashCode += getId3().hashCode();
- }
- _hashCode += new Long(getId4()).hashCode();
- if (getName1() != null) {
- _hashCode += getName1().hashCode();
- }
- if (getName2() != null) {
- _hashCode += getName2().hashCode();
- }
- if (getName3() != null) {
- _hashCode += getName3().hashCode();
- }
- if (getName4() != null) {
- _hashCode += getName4().hashCode();
- }
- __hashCodeCalc = false;
- return _hashCode;
- }
-
- // Type metadata
- private static org.apache.axis.description.TypeDesc typeDesc =
- new org.apache.axis.description.TypeDesc(Person.class, true);
-
- static {
- typeDesc.setXmlType(new javax.xml.namespace.QName("http://com.csii.bank.core/system", "Person"));
- org.apache.axis.description.ElementDesc elemField = new org.apache.axis.description.ElementDesc();
- elemField.setFieldName("id1");
- elemField.setXmlName(new javax.xml.namespace.QName("http://com.csii.bank.core/system", "id1"));
- elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "long"));
- elemField.setMinOccurs(0);
- elemField.setNillable(true);
- typeDesc.addFieldDesc(elemField);
- elemField = new org.apache.axis.description.ElementDesc();
- elemField.setFieldName("id2");
- elemField.setXmlName(new javax.xml.namespace.QName("http://com.csii.bank.core/system", "id2"));
- elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "long"));
- elemField.setMinOccurs(0);
- elemField.setNillable(false);
- typeDesc.addFieldDesc(elemField);
- elemField = new org.apache.axis.description.ElementDesc();
- elemField.setFieldName("id3");
- elemField.setXmlName(new javax.xml.namespace.QName("http://com.csii.bank.core/system", "id3"));
- elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "long"));
- elemField.setNillable(true);
- typeDesc.addFieldDesc(elemField);
- elemField = new org.apache.axis.description.ElementDesc();
- elemField.setFieldName("id4");
- elemField.setXmlName(new javax.xml.namespace.QName("http://com.csii.bank.core/system", "id4"));
- elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "long"));
- elemField.setNillable(false);
- typeDesc.addFieldDesc(elemField);
- elemField = new org.apache.axis.description.ElementDesc();
- elemField.setFieldName("name1");
- elemField.setXmlName(new javax.xml.namespace.QName("http://com.csii.bank.core/system", "name1"));
- elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "string"));
- elemField.setMinOccurs(0);
- elemField.setNillable(true);
- typeDesc.addFieldDesc(elemField);
- elemField = new org.apache.axis.description.ElementDesc();
- elemField.setFieldName("name2");
- elemField.setXmlName(new javax.xml.namespace.QName("http://com.csii.bank.core/system", "name2"));
- elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "string"));
- elemField.setMinOccurs(0);
- elemField.setNillable(false);
- typeDesc.addFieldDesc(elemField);
- elemField = new org.apache.axis.description.ElementDesc();
- elemField.setFieldName("name3");
- elemField.setXmlName(new javax.xml.namespace.QName("http://com.csii.bank.core/system", "name3"));
- elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "string"));
- elemField.setNillable(true);
- typeDesc.addFieldDesc(elemField);
- elemField = new org.apache.axis.description.ElementDesc();
- elemField.setFieldName("name4");
- elemField.setXmlName(new javax.xml.namespace.QName("http://com.csii.bank.core/system", "name4"));
- elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "string"));
- elemField.setNillable(false);
- typeDesc.addFieldDesc(elemField);
- }
-
- /**
- * Return type metadata object
- */
- public static org.apache.axis.description.TypeDesc getTypeDesc() {
- return typeDesc;
- }
-
- /**
- * Get Custom Serializer
- */
- public static org.apache.axis.encoding.Serializer getSerializer(
- java.lang.String mechType,
- java.lang.Class _javaType,
- javax.xml.namespace.QName _xmlType) {
- return
- new org.apache.axis.encoding.ser.BeanSerializer(
- _javaType, _xmlType, typeDesc);
- }
-
- /**
- * Get Custom Deserializer
- */
- public static org.apache.axis.encoding.Deserializer getDeserializer(
- java.lang.String mechType,
- java.lang.Class _javaType,
- javax.xml.namespace.QName _xmlType) {
- return
- new org.apache.axis.encoding.ser.BeanDeserializer(
- _javaType, _xmlType, typeDesc);
- }
-
- }</span>
java生成的Person類沒有Specified屬性,看來它只支持一種形式,下面進(jìn)行驗(yàn)證
3.2.3查看SOAP報(bào)文
java代碼:
- Person p=new Person();
- p.setId1(null);
- p.setId2(null);
- p.setId3(null);
- p.setId4(0);
- p.setName1(null);
- p.setName2(null);
- p.setName3(null);
- p.setName4("123");//.NET實(shí)驗(yàn)時(shí),name4傳的是null;但如果此處賦null,報(bào)文還未發(fā)出去,客戶端框架就報(bào)錯(cuò):提示不能為null了。
Soap報(bào)文:
- <?xml version="1.0" encoding="UTF-8"?>
- <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
- <soapenv:Body>
- <GetSystemStatus xmlns="http://com.csii.bank.core/system">
- <person>
- <id3 xsi:nil="true"/>
- <id4>0</id4>
- <name3 xsi:nil="true"/>
- <name4>123</name4>
- </person>
- </GetSystemStatus>
- </soapenv:Body>
- </soapenv:Envelope>
3.2.4 得出結(jié)論:
其一:對(duì)于值類型和包裝:
1、除 [ minOccurs=1,nillable=false ] 這一組合除外,生成的都是包裝類型。
2、當(dāng)對(duì)象屬性為null時(shí),java根據(jù)minOccurs構(gòu)造soap報(bào)文,如果minOccurs=0則[元素節(jié)點(diǎn)]不出現(xiàn)代表null,如果minOccurs=1用nil=true表示null。
其二:對(duì)于普通引用類型:
生成的肯定是引用類型(這是廢話),當(dāng)對(duì)象屬性為null是,構(gòu)造soap報(bào)文的規(guī)則和上面的2一樣
4、深入淺出,最后的總結(jié)
不管是由代碼生成wsdl,還是由wsdl生成代碼,此實(shí)驗(yàn)中java都比.NET要簡(jiǎn)潔,個(gè)人比較喜歡java的方式,.NET顯得有點(diǎn)兒?jiǎn)拢ㄋ寻b類型和普通引用類型做了區(qū)分),下面進(jìn)行最后的總結(jié)。
先來總結(jié)由代碼生成wsdl
java用到了兩種組合:
[minOccurs=1、nillable=false]:只有值類型用這一組合
[minOccurs=1、nillable=true]:包裝類型和普通引用類型用這一組合
注:其實(shí)Java用[minOccurs=0 和nillable=false]代表包裝類型和普通引用類型也完全可以,如果是我的話我會(huì)用這一組合代替上面的組合,這樣可以節(jié)省網(wǎng)絡(luò)流量
而.NET有3種組合:
[ minOccurs=1、nillable=false]:只有值類型用這一組合
[ minOccurs=1、nillable=true ] :包裝類型用這一組合
[ minOccurs=0、nillable=false]:普通引用類型用這一組合
現(xiàn)在如果要我們自己寫一個(gè)生成wsdl的框架,那應(yīng)該有如下的原則:
1> 值類型只能用[minOccurs=1、nillable=false],而包裝類型和普通引用類型不能用這一組合(否則空對(duì)象無法表示)
2> 包裝類型可以用[minOccurs=1、nillable=true]和[ minOccurs=0、nillable=false]
3> 普通引用類型可以用[minOccurs=1、nillable=true]和[ minOccurs=0、nillable=false]
4> 對(duì)于包裝類型和普通引用類型不建議用[minOccurs=0、nillable=true],這一組合意義不夠明確,究竟是空?qǐng)?bào)文節(jié)點(diǎn)表示null呢?還是nill=true表示null呢?當(dāng)然如果真這么用肯定也沒問題,只要序列化工具支持就行。
再來看由wsdl生成代碼
我是很難理解微軟為什么要把[包裝類型]和[普通引用類型]區(qū)別對(duì)待,在C#_2_WSDL的時(shí)候這么區(qū)別開到還沒什么,但是當(dāng)WSDL_2_C#的時(shí)候就帶來很大的麻煩。
1、首先來看<element name="long" type="dateTime" minOccurs="0" nillable="false"/>,對(duì)這一組合微軟生成的是值類型而不是包裝類型,它認(rèn)為只有nillable=true才代表包裝類型,可包裝類型和普通引用類型本質(zhì)上有太大的區(qū)別嗎?大家都是引用類型,[minOccurs=1、nillable=true]和[ minOccurs=0、nillable=false]應(yīng)該都可以被解析為包裝類型才合適。你微軟如果認(rèn)為nillable=true和包裝類型(微軟的可空類型)聯(lián)系那么緊密,那這樣的節(jié)點(diǎn)<element name="name3" type="string" minOccurs="1" nillable="true"/>最好還是別支持了,但現(xiàn)在普通應(yīng)用類型你既支持minOccurs=0又支持nillable=true,那包裝類型和普通引用類型分開的必要性究竟是神馬?。。。。?!
2、再來看xxxSpecified,前面說到,微軟認(rèn)為對(duì)于像type=int這樣的節(jié)點(diǎn),如果element定義中出現(xiàn)了minOccurs=0,則要生成一個(gè)xxxSpecified屬性。這么搞使用起來簡(jiǎn)直太麻煩了——讓程序員指定xxxSepcified為true或false來控制元素節(jié)點(diǎn)要不要顯示,這種麻煩還是由于“區(qū)別對(duì)待”帶來的。微軟只通過nillable判斷是否是包裝類型,對(duì)于minOccurs=0的情況它不得不生成一個(gè)xxxSpecified。而如果不區(qū)別對(duì)待的話就簡(jiǎn)單多了,只要minOccurs=0和nillable=true隨便哪個(gè)出現(xiàn)或同時(shí)出現(xiàn),直接生成包裝類型。
最后來總結(jié)序列化
序列化的時(shí)候,java和.NET在處理上也不盡相同:
1、java優(yōu)先考慮minOccurs,如果minOccurs=0,那不管nillable等于神馬,程序中的null以[元素節(jié)點(diǎn)]不出現(xiàn)的方式來體現(xiàn);如果minOccurs=1,則程序中的null以[元素取值]為空的方式來體現(xiàn);這樣的規(guī)則同時(shí)適用于值類型、包裝類型和普通引用類型。
2、而.NET則優(yōu)先考慮nillable,如果nillable=true,那不管minOccurs等于神馬,程序中的null以[元素取值]為空的方式來體現(xiàn);如果nillable=false,則程序中的null以[元素節(jié)點(diǎn)]不出現(xiàn)的方式來體現(xiàn);這樣的規(guī)則同時(shí)適用于值類型、包裝類型和普通引用類型。(注:Specified=true的前提下)