Wrapper vs Bare （Non-wrapper)

最新推荐文章于 2022-03-05 12:44:35 发布

原创最新推荐文章于 2022-03-05 12:44:35 发布 · 457 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#wrapper #soap #binding #interface #service #string

Java Web Service 专栏收录该内容

5 篇文章

订阅专栏

本文探讨了JAX-WS中的Wrapper和Bare两种代码组织方式。这两种方式影响SOAP消息如何映射到Java方法，Wrapper通过根元素名称查找方法，而Bare则依据参数类型进行匹配。

Wrapper和Bare不是WSDL定义的某种标准，而是JAX-WS和JAX-RPC定义的两种代码组织方式。只有document/literal才有Wrapper和Bare的形式，RPC不存在这种分别。

document/literal/wrapper

document/literal/bare

RPC/literal - 这种方式是WS-I BP支持的，但是在实际使用中已经不推荐了。

同样一个WSDL定义文件可以同时生成Wrapper和Bare方式的两套代码。它们的差别只在代码的格式上。参见JAX-WS 2.0 specification 2.3.1.3 Example 或如下代码。对于Wrapper方式，JAX-WS通过SOAP消息中root element的名字来查找方法（它们的名字必须是一致的），而Bare方式则是通过方法参数的类型来匹配的。通过Bare方式匹配的方法的参数必须和SOAP消息里的XML binding的数据类型是一致的。所以Wrapper方式不支持在SEI (Service Endpoint Interface) 中有Overloaded的方法（同名不同参数），而Bare方式同样不支持SEI中有同参数不同名的方法。

<types>

<xsd:element name="setLastTradePrice">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="tickerSymbol" type="xsd:string"/>

<xsd:element name="lastTradePrice" type="xsd:float"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="setLastTradePriceResponse">

<xsd:complexType>

<xsd:sequence/>

</xsd:complexType>

</xsd:element>

</types>

<part name="setLastTradePrice" element="tns:setLastTradePrice"/>

</message>

<part name="setLastTradePriceResponse" element="tns:setLastTradePriceResponse"/>

</message>

<portType name="StockQuoteUpdater">

<operation name="setLastTradePrice">

<input message="tns:setLastTradePrice"/>

<output message="tns:setLastTradePriceResponse"/>

</operation>

</portType>

// non-wrapper style mapping
SetLastTradePriceResponse setLastTradePrice(
SetLastTradePrice setLastTradePrice);

// wrapper style mapping
void setLastTradePrice(String tickerSymbol, float lastTradePrice);

http://myarch.com/wrappernon-wrapper-web-service-styles-things-you-need-to-know