41.2.3. 实施供应商对象

提供者界面相对容易实施。它只具有一种方法，调用（） 必须被实施。另外，它有三个简单的要求：

实施 Provider 接口的复杂性是在处理请求消息并构建正确的响应的逻辑中。

与基于较高级别的 SEI 服务实施不同，提供商实施将请求作为原始 XML 数据接收，并且必须作为原始 XML 数据发送响应。这要求开发人员对正在实施的服务所使用的消息有一定了解。这些详细信息通常可在描述服务的 WSDL 文档中找到。

WS-I 基本 配置集提供有关服务使用的信息的指南，包括：

要将 JAX-WS 识别为服务实施，提供程序实施必须被 @WebServiceProvider 注释进行解码。

表 41.2 “@WebServiceProvider Properties” 描述可以为 @WebServiceProvider 注释设置的属性。

所有这些属性都是可选的，默认情况下为空。如果您为空，Apache CXF 将使用实施类中的信息创建值。

Provider 接口只有一个方法 calls （），必须实施它。调用（） 方法接收打包为实施的 Provider 接口类型的对象类型的传入请求，并将响应消息返回成同一类型的对象。例如，实施 Provider<SOAPMessage> 接口接收请求作为 SOAPMessage 对象，并将响应作为 SOAPMessage 对象返回。

提供程序实施所用的消息传递模式决定了请求和响应消息中包含的特定信息的绑定量。使用消息模式的实现会接收所有绑定器和标头，以及请求。它们还必须将所有绑定程序和标头添加到响应消息。使用有效负载模式的实现仅接收请求的正文。使用有效负载模式返回的 XML 文档被放入请求消息的正文中。

例 41.11 “provider<SOAPMessage> 实现” 显示一个供应商实施，用于消息模式的 SOAPMessage 对象。

import javax.xml.ws.Provider;
import javax.xml.ws.Service;
import javax.xml.ws.ServiceMode;
import javax.xml.ws.WebServiceProvider;

@WebServiceProvider(portName="stockQuoteReporterPort"
                    serviceName="stockQuoteReporter")
@ServiceMode(value="Service.Mode.MESSAGE")
public class  stockQuoteReporterProvider implements Provider<SOAPMessage>
{
public stockQuoteReporterProvider()
  {
  }

public SOAPMessage invoke(SOAPMessage request)
  {
  SOAPBody requestBody = request.getSOAPBody();
  if(requestBody.getElementName.getLocalName.equals("getStockPrice"))
    {
    MessageFactory mf = MessageFactory.newInstance();
      SOAPFactory sf = SOAPFactory.newInstance();

    SOAPMessage response = mf.createMessage();
      SOAPBody respBody = response.getSOAPBody();
      Name bodyName = sf.createName("getStockPriceResponse");
      respBody.addBodyElement(bodyName);
      SOAPElement respContent = respBody.addChildElement("price");
      respContent.setValue("123.00");
      response.saveChanges();
    return response;
    }
    ...
  }
}

例 41.11 “provider<SOAPMessage> 实现” 中的代码执行以下操作：

指定以下类实施实施实施服务（其 wsdl:service 元素名为 stockQuoteReporter ）的 Provider 对象，其 wsdl:port 元素名为 stockQuoteReporterPort。

指定此提供程序实施使用消息模式。

提供所需的默认公共构造器。

提供 调用（）方法的 实现，它采用 SOAPMessage 对象并返回 SOAPMessage 对象。

从传入 SOAP 消息的正文中提取请求消息。

检查请求消息的根元素，以确定如何处理请求。

创建构建响应所需的工厂。

为响应构建 SOAP 消息。

将响应返回为 SOAPMessage 对象。

例 41.12 “provider<DOMSource> 实施” 显示在有效负载模式中使用 DOMSource 对象进行提供程序实施的示例。

import javax.xml.ws.Provider;
import javax.xml.ws.Service;
import javax.xml.ws.ServiceMode;
import javax.xml.ws.WebServiceProvider;

@WebServiceProvider(portName="stockQuoteReporterPort" serviceName="stockQuoteReporter")
@ServiceMode(value="Service.Mode.PAYLOAD")
public class  stockQuoteReporterProvider implements Provider<DOMSource>
public stockQuoteReporterProvider()
  {
  }

public DOMSource invoke(DOMSource request)
  {
    DOMSource response = new DOMSource();
    ...
    return response;
  }
}

例 41.12 “provider<DOMSource> 实施” 中的代码执行以下操作：

指定该类实施了实施服务（其 wsdl:service 元素名为 stockQuoteReporter ）的 Provider 对象，其 wsdl:port 元素名为 stockQuoteReporterPort。

指定此提供程序实施使用有效负载模式。

提供所需的默认公共构造器。

提供 调用（） 方法的实施，该方法采用 DOMSource 对象并返回 DOMSource 对象。