我非常高興地宣布， EclipseLink JAXB（MOXy）現在是GlassFish 3.1.2中的JAXB（ JSR-222 ）提供程序。 我要感謝EclipseLink和GlassFish提交者為實現這一目標付出的??辛勤工作。

在本文中，我將介紹如何利用MOXy創建JAX-WS服務。 在以后的文章中，我將更詳細地介紹更多擴展。

可以從以下鏈接下載GlassFish：

• http://glassfish.java.net/public/downloadsindex.html

網絡服務（JAX-WS）

對于這篇文章，我們將實現一個簡單的服務，該服務通過ID查找客戶。 由于這只是“ Hello World”類型的示例，因此該服務將始終返回名稱為“ Jane Doe”的客戶。

package blog.jaxws.service;import javax.jws.*;
import blog.jaxws.model.Customer;@WebService
public class FindCustomer {@WebMethodpublic Customer findCustomer(int id) {Customer customer = new Customer();customer.setId(id);customer.setFirstName("Jane");customer.setLastName("Doe");return customer;}}

WEB-INF / sun-jaxws.xml

有多種方法可以將MOXy指定為JAXB提供程序。 我的偏好是使用位于WEB-INF目錄中的sun-jaxws.xml文件。

<?xml version="1.0" encoding="UTF-8"?>
<endpointsxmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime"version="2.0"><endpointname='FindCustomer'implementation='blog.jaxws.service.FindCustomer'url-pattern='/FindCustomerService'databinding='eclipselink.jaxb'/>
</endpoints>

模型

當MOXy被指定為JAXB提供程序時，我們可以利用其所有映射擴展。 在此示例中，我們將使用@XmlPath進行基于XPath的映射 。

package blog.jaxws.model;import javax.xml.bind.annotation.*;
import org.eclipse.persistence.oxm.annotations.XmlPath;@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(propOrder={"firstName", "lastName"})
public class Customer {@XmlAttributeprivate int id;@XmlPath("personal-info/first-name/text()")private String firstName;@XmlPath("personal-info/last-name/text()")private String lastName;public int getId() {return id;}public void setId(int id) {this.id = id;}public String getFirstName() {return firstName;}public void setFirstName(String firstName) {this.firstName = firstName;}public String getLastName() {return lastName;}public void setLastName(String lastName) {this.lastName = lastName;}}

WSDL

以下是為此服務生成的WSDL：

<?xml version="1.0" encoding="UTF-8"?>
<!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is Metro/2.2-b13 (branches/2.2-6964; 2012-01-09T18:04:18+0000) JAXWS-RI/2.2.6-promoted-b20 JAXWS/2.2 svn-revision#unknown. -->
<!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is Metro/2.2-b13 (branches/2.2-6964; 2012-01-09T18:04:18+0000) JAXWS-RI/2.2.6-promoted-b20 JAXWS/2.2 svn-revision#unknown. -->
<definitions xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://service.jaxws.blog/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://service.jaxws.blog/" name="FindCustomerService"><types><xsd:schema><xsd:import namespace="http://service.jaxws.blog/" schemaLocation="http://www.example.com:8080/Blog-JAXWS2/FindCustomerService?xsd=1"/></xsd:schema></types><message name="findCustomer"><part name="parameters" element="tns:findCustomer"/></message><message name="findCustomerResponse"><part name="parameters" element="tns:findCustomerResponse"/></message><portType name="FindCustomer"><operation name="findCustomer"><input wsam:Action="http://service.jaxws.blog/FindCustomer/findCustomerRequest" message="tns:findCustomer"/><output wsam:Action="http://service.jaxws.blog/FindCustomer/findCustomerResponse" message="tns:findCustomerResponse"/></operation></portType><binding name="FindCustomerPortBinding" type="tns:FindCustomer"><soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/><operation name="findCustomer"><soap:operation soapAction=""/><input><soap:body use="literal"/></input><output><soap:body use="literal"/></output></operation></binding><service name="FindCustomerService"><port name="FindCustomerPort" binding="tns:FindCustomerPortBinding"><soap:address location="http://www.example.com:8080/Blog-JAXWS/FindCustomerService"/></port></service>
</definitions>

XML模式

下面是為該模型生成的WSDL引用的XML模式。 請注意，它如何包含@XmlPath批注中指定的“個人信息”元素。

<?xml version="1.0" encoding="UTF-8"?>
<!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is Metro/2.2-b13 (branches/2.2-6964; 2012-01-09T18:04:18+0000) JAXWS-RI/2.2.6-promoted-b20 JAXWS/2.2 svn-revision#unknown. -->
<xsd:schema xmlns:ns0="http://service.jaxws.blog/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"targetNamespace="http://service.jaxws.blog/"><xsd:complexType name="findCustomerResponse"><xsd:sequence><xsd:element name="return" type="ns0:customer" minOccurs="0" /></xsd:sequence></xsd:complexType><xsd:complexType name="findCustomer"><xsd:sequence><xsd:element name="arg0" type="xsd:int" /></xsd:sequence></xsd:complexType><xsd:complexType name="customer"><xsd:sequence><xsd:element name="personal-info" minOccurs="0"><xsd:complexType><xsd:sequence><xsd:element name="first-name" type="xsd:string"minOccurs="0" /><xsd:element name="last-name" type="xsd:string"minOccurs="0" /></xsd:sequence></xsd:complexType></xsd:element></xsd:sequence><xsd:attribute name="id" type="xsd:int" use="required" /></xsd:complexType><xsd:element name="findCustomerResponse" type="ns0:findCustomerResponse" /><xsd:element name="findCustomer" type="ns0:findCustomer" />
</xsd:schema>

服務請求

以下是對我們服務的要求：

<?xml version="1.0" encoding="UTF-8"?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"><S:Header/><S:Body><ns2:findCustomer xmlns:ns2="http://service.jaxws.blog/"><arg0>123</arg0></ns2:findCustomer></S:Body>
</S:Envelope>

服務回應

響應利用了我們在Customer類上使用的@XmlPath批注，將firstName和lastName屬性映射到XML。

<?xml version="1.0" encoding="UTF-8"?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"><S:Body><ns0:findCustomerResponse xmlns:ns0="http://service.jaxws.blog/"><return id="123"><personal-info><first-name>Jane</first-name><last-name>Doe</last-name></personal-info></return></ns0:findCustomerResponse></S:Body>
</S:Envelope>

進一步閱讀

如果您喜歡這篇文章，那么您可能會對以下內容感興趣：

• EclipseLink MOXy是WebLogic Server 12c中的JAXB提供程序
• 基于XPath的映射-地理編碼示例
• 將對象映射到多個XML模式–天氣示例
• JAX-RS服務中的MOXy的XML元數據
• JPA實體到XML –雙向關系

參考： GlassFish 3.1.2在我們的JCG合作伙伴 Blaise Doughan的Java XML＆JSON Binding博客中充滿了MOXy（EclipseLink JAXB） 。