这一章描述了WSDL 1.1到Java的映射。这个映射用于为客户端产生Web service接口以及从WSDL 1.1描述产生endpoint。

　　下面的部分描述了从每一个WSDL 1.1结构到等价的Java结构的默认映射。在WSDL 1.1里， 抽象的port type定义与协议的绑定之间还没有完全分开。绑定影响WSDL元素（用在抽象port type定义里）与Java方法参数之间的映射。

　　一个应用可以定制映射，使用嵌入式的绑定声明或者外部的绑定文件。

　　为了能让注释在运行时用于分发和集结，此规范要求产生的Java类和接口必须使用Web service的注释。这些注释必须如实地反应WSDL文档中的信息，如给出映射过程的输入、嵌入到文档里的以及通过外部绑定文件的定制。

　　2.1 定义

　　一个WSDL文档有一个根元素wsdl:definitions。一个wsdl:definitions元素和它相关的targetNamespace属性被映射到一个Java包。JAXB定义了一个从命名空间URI到Java包名的标准映射。默认地，这个算法用来将wsdl:definitions元素的targetNamespace属性映射到一个Java包名。比如

　　<wsdl:definitions name=”HelloWorld” 　　targetNamespace=”http://server.ws.demo/” 　　 　　 　　 　　 　　>

　　此服务类对应的包名为：demo.ws.server， 项目结构如下：

　　应用可以使用jaxws:package绑定声明来定制这个映射。

　　2.1.1 扩展

　　WSDL 1.1允许扩展元素和属性来增加到它的结构里。JAX-WS指定了SOAP和MIME绑定里定义的扩展元素和属性的Java映射。JAX-WS没有为其它任何扩展元素或属性指定映射，也没有提供一个标准的扩展框架，尽管这个支持可以通过一个标准的方法来增加。JAX-WS的后续版本可能会为标准扩展增加其它的支持，当可以获得这些标准扩展的时候。

　　注意，这样的支持可能限制了互用性以及应用的方便性。

　　2.2 PortType（端口类型）

　　WSDL port type是一个抽象操作定义的集合。一个wsdl:portType元素被映射到一个包中的Java接口，这里的包来自wsdl:definitions元素（详见2.1）。一个从wsdl:portType映射的Java接口被叫做一个Service Endpoint Interface（服务端点接口）或SEI。比如：下面是一段WSDL描述，

　　<wsdl:portType name=”HelloWorld”>

　　<wsdl:operation name=”sayHi”>

                     <wsdl:input message=”tns:sayHi” name=”sayHi” />

                     <wsdl:output message=”tns:sayHiResponse”

name=”sayHiResponse” />

          </wsdl:operation>

  </wsdl:portType>

　　对应接口中的方法为：

　　接口实现中的方法是：

　　应用可以定制这个映射，通过使用jaxws:class绑定声明。

　　一个SEI包含了从wsdl:portType的子元素wsdl:operation中映射的Java方法。详细参见后面的wsdl:operation映射。WSDL 1.1不支持port type继承，所以每一个产生的SEI将包含相应port type里的所有操作方法。

　　2.3 操作

　　每一个wsdl:portType里的wsdl:operation被映射到相应Java service endpoint接口中的一个Java方法。

　　应用通过使用jaxws:method可以定制这个映射。

　　WS-I Basic Profile R2304要求，wsdl:portType里的操作的name属性拥有唯一的值，因此WS-I 的映射将不会使用重载（overload）方法产生Java接口。然而，为了向后兼容，JAX-WS支持操作重载，即假设重载在映射的Java SEI（service endpoint interface）声明中不会产生冲突。

　　notification和solicit-response操作的映射超出了本节的范围，不再陈述。