下列對映內容只適用於使用 IBM® SOAP 執行時期環境的 Web 服務。
內容 | 說明 |
---|---|
編碼樣式 | 透過 SOAP 通訊協定的排序規則。文字 XML (http://xml.apache.org/xml-soap/literalxml) 係以 XML 綱目實例為基礎。SOAP 編碼 (http://schemas.xmlsoap.org/soap/encoding/) 的基礎則為本身是從各類型系統的程式語言、資料庫及半結構化資料等方面的共用特性中歸納出來的簡式類型系統。」 編碼會定義應用程式所定義的資料值如何與通訊協定格式相互轉換。如果需要 SOAP 編碼的詳細資訊,請造訪 www.w3.org/TR/SOAP。 |
XML 類型名稱空間 | 作為 XML 文件的字首,以便唯一識別組織及避免元素名稱衝突。 |
XML 類型名稱 | 作為定義於 XSD 的複式類型或簡式類型名稱。 |
Bean 類別 | Java 類別完整名稱會封裝資料的集成和資料運作的方法。 |
Serializer 類別(只適用於 SOAP) | 在執行時期,將 Bean 類別實例轉換為根據編碼樣式的 XML 類型實例。類別的完整名稱會實作 org.apache.soap.util.xml.Serializer 介面。 |
Deserializer 類別(只適用於 SOAP) | 在執行時期,將給定編碼樣式的 XML 類型實例轉換為 Bean 類別實例。類別的完整名稱會實作 org.apache.soap.util.xml.Deserializer 介面。 |
Marshaller 方法(只適用於 HTTP) | 在執行時期,將 Bean 類別實例轉換為透過 HTTP 傳輸的字串。 |
Unmarshaller 方法(只適用於 HTTP) | 在執行時期,將透過 HTTP 收到的字串實例轉換為 Bean 類別實例。 |
對映可指定 XML Qname、Java 類別名稱、編碼樣式, 以及序列化常式和解除序列化常式(用來在 XML Qname 的類別實例與編碼實例之間轉換)之間的關聯。有兩個對映方向稱為「Java 至 XML」和「XML 到 Java」。
SOAP 2.3 版執行時期環境會保留一份這類對映項目的表格,稱為 SOAPMappingRegistry。
在類型對映登錄中,單一 Java 類型至多可以對映至一個 XSD 類型, 單一 XSD 類型則至多可以對映至一個 Java 類型。依預設,支援大部分標準 Java 類型,以及 Java Bean。
從 Java 到 WSDL XSD (2001) 之對映的表格,顯示從 Java 資料類型到 SOAP 和「文字 XML」編碼樣式之 WSDL 組件類型的預設對映,如同由 WSDL SOAP 連結所定義。該表格同時顯示序列化和非序列化配置到 SOAP 執行時期環境,以便執行 Java 和 XML 的轉換。Java 類型和編碼樣式的組合並沒有列在這個預設為自訂對映的表格中。
Java 類型 | 編碼樣式 | XML 類型名稱空間 附註 1 | XML 類型名稱 | 序列化常式 | 解除序列化常式 | 對映樣式 | 註解 |
---|---|---|---|---|---|---|---|
boolean,java.lang.Boolean | SOAP | xsd | Boolean | - | - | Bean | |
byte,java.lang.Byte | SOAP | xsd | byte | - | - | Bean | |
short,java.lang.Short | SOAP | xsd | short | - | - | Bean | |
int,java.lang.Integer | SOAP | xsd | int | - | - | Bean | |
long,java.lang.Long | SOAP | xsd | long | - | - | Bean | |
float,java.lang.Float | SOAP | xsd | float | - | - | Bean | |
double,java.lang.Double | SOAP | xsd | double | - | - | Bean | |
java.lang.String | SOAP | xsd | string | - | - | Bean | |
java.math.BigDecimal | SOAP | xsd | decimal | - | - | Bean | |
java.util.GregorianCalendar | SOAP | xsd | date | - | - | Bean | |
java.util.Date | SOAP | xsd | dateTime | - | - | Bean | |
java.util.Vector | SOAP | xml-soap 附註 2 附註 20 | Vector | - | - | Bean | |
java.util.Map | SOAP | xml-soap 附註 2 附註 20 | Map | - | - | Bean | |
java.util.Hashtable | SOAP | xml-soap 附註 2 附註 20 | Map | - | - | Bean | |
byte[] | SOAP | soap-enc 附註 3 | base64 | - | - | Bean | |
T[] (類型的陣列,T) | SOAP | soap-enc 附註 3 | Array 附註 4 | - | - | Bean | 提供的 T 既非位元組,亦非 org.w3c.dom.Element。 |
org.w3c.dom.Element | 文字 XML | 附註 5 | 附註 6 | N/A | N/A | 元素 | |
Java Bean | SOAP | 附註 5 | 附註 7 | BeanSerializer | BeanSerializer | Bean | 完整序列化/取消序列化類別名稱是 org.apache.soap。 encoding.soapenc。 BeanSerializer。 |
從 WSDL XSD 到 Java(SOAP 連結)的對映表格說明從 WSDL 組件類型到 SOAP 和文字 XML 編碼樣式之 Java 資料類型的預設對映,如同由 WSDL SOAP 連結所定義。 該表格同時顯示序列化和非序列化配置到 SOAP 執行時期環境,以便執行 Java 和 XML 的轉換。WSDL 組件類型和編碼樣式的組合並沒有列在這個預設為自訂對映的表格中。
XML 類型名稱空間 附註 1 | XML 類型名稱 | 編碼樣式 | Java 類別 | Serializer 類別 | Deserializer 類別 | 對映樣式 | 註解 |
---|---|---|---|---|---|---|---|
xsd | Boolean | SOAP | boolean, java.lang.Boolean 附註 22 | - | - | Bean | |
xsd | byte | SOAP | byte, java.lang.Byte 附註 22 | - | - | Bean | |
xsd | short | SOAP | short, java.lang.Short 附註 22 | - | - | Bean | |
xsd | int | SOAP | int, java.lang.Integer 附註 22 | - | - | Bean | |
xsd | long | SOAP | long, java.lang.Long 附註 22 | - | - | Bean | |
xsd | float | SOAP | float, java.lang.Float 附註 22 | - | - | Bean | |
xsd | double | SOAP | double, java.lang.Double 附註 22 | - | - | Bean | |
xsd | string | SOAP | string | - | - | Bean | |
xsd | decimal | SOAP | java.math.BigDecimal | - | - | Bean | |
xsd | date | SOAP | java.util.GregorianCalendar | - | - | Bean | |
xsd | dateTime 附註 10 | SOAP | java.util.Date | - | - | Bean | |
xml-soap 附註 2 | Vector | SOAP | java.util.Vector | - | - | Bean | |
xml-soap 附註 2 | Map | SOAP | java.util.Map 附註 21 | - | - | Bean | |
soap-enc 附註 3 | base64 | SOAP | byte[] | - | - | Bean | |
soap-enc 附註 3 | Array | SOAP | T[] 附註 4 | - | - | Bean | T 是從 wsdl:arrayType 進行的對映 附註 4 |
some-namespace 附註 12 | some-complex-type(在 XSD 2001 中) 附註 12 | SOAP | 附註 14 | BeanSerializer | BeanSerializer | Bean | 完整序列化/取消序列化類別名稱是 com.ibm.etools. webservice.runtime.XSDAnyTypeSerializer BeanSerializer。 |
some-namespace 附註 12 | some-complex-type(在 XSD 2001 中) 附註 12 | 文字 XML | 附註 14 | N/A | N/A | Bean | 轉換是在產生 Proxy 或是 Skeleton 中處理,而非在 SOAP 執行時期環境中透過 SOAP 的序列化或非序列化來處理。 |
some-namespace 附註 12 | some-complex-type(在 XSD 2001 中) 附註 12 | 文字 XML | org.w3c.dom.Element 附註 15 | N/A | N/A | 元素 | |
some-namespace 附註 13 | some-type 附註 13 | 文字 XML | org.w3c.dom.Element 附註 16 | N/A | N/A | 元素 | |
xsd | anyType 附註 11 | 文字 XML | org.w3c.dom.Element | N/A | N/A | 元素 | |
xsd | base64Binary | SOAP | byte[] | - | - | Bean | |
xsd | hexbinary | SOAP | byte[] | - | - | Bean | |
xml soap | 元素 | 文字 XML | org.w3c.dom.Element | - | - | 元素 |
從 WSDL XSD 到 Java(HTTP 連結)的對映表格,說明從 WSDL 組件類型到 HTTP GET 和 POST 連結的 Java 資料類型。WSDL 組件類型和編碼樣式的組合並沒有列在這個預設為自訂對映的表格中。
XML 類型名稱空間 附註 1 | XML 類型名稱 | MIME 類型 | Java 類別 | 對映樣式 |
---|---|---|---|---|
xsd | Boolean | text/plain text/xml mimeXml | Boolean | Bean |
xsd | byte | text/plain text/xml mimeXml | byte | Bean |
xsd | short | text/plain text/xml mimeXml | short | Bean |
xsd | int | text/plain text/xml mimeXml | int | Bean |
xsd | long | text/plain text/xml mimeXml | long | Bean |
xsd | float | text/plain text/xml mimeXml | float | Bean |
xsd | double | text/plain text/xml mimeXml | double | Bean |
xsd | string | text/plain text/xml mimeXml | string | Bean |
xsd | decimal | text/plain text/xml mimeXml | java.math.BigDecimal | Bean |
xsd | date | text/plain text/xml mimeXml | java.util.GregorianCalendar | Bean |
xsd | dateTime 附註 10 | mimeXml text/plain text/xml | java.util.Date | Bean |
some-namespace 附註 12 | some-complex-type(在 XSD 2001 中) 附註 12 | mimeXml | 附註 14 | Bean |
some-namespace 附註 12 | some-complex-type(在 XSD 2001 中) 附註 12 | mimeXml | org.w3c.dom.Element 附註 17 | 元素 |
some-namespace 附註 12 | some-complex-type(在 XSD 2001 中) 附註 12 | text/xml | org.w3c.dom.Element 附註 18 | 元素 |
some-namespace 附註 13 | some-type 附註 13 | mimeXml text/xml | org.w3c.dom.Element 附註 19 | 元素 |
xsd | anyType 附註 11 | mimeXml text/xml | org.w3c.dom.Element | 元素 |