Web 服务编程技巧与窍门: 在 JAX-RPC 中使用 SOAP Headers

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions targetNamespace="http://soapheader.ibm.com" ...>
  <wsdl:types>
    <schema ...>
      <element name="getLastSellPrice"> 
         <complexType> 
           <sequence>
            <element name="ticker" nillable="true" type="xsd:string" />
           </sequence>
         </complexType>
      </element>
      <element name="getLastSellPriceResponse">
         <complexType>
           <sequence>
             <element name="getLastSellPriceReturn" type="xsd:float" />
           </sequence>
         </complexType>
      </element>
      <element name="quote_timestamp" type="xsd:dateTime" />
  </schema>
  </wsdl:types>
  <wsdl:message name="getLastSellPriceRequest">
    <wsdl:part name="parameters" 
               element="intf:getLastSellPrice"/>
   
         <wsdl:part name="request_header" 
               element="intf:quote_timestamp"/>
  </wsdl:message>
  <wsdl:message name="getLastSellPriceResponse">
    <wsdl:part name="parameters"  
               element="intf:getLastSellPriceResponse"/>
  </wsdl:message>
  <wsdl:portType name="StockService">
    <wsdl:operation name="getLastSellPrice">
      <wsdl:input name="getLastSellPriceRequest" 
                  message="intf:getLastSellPriceRequest"/>
      <wsdl:output name="getLastSellPriceResponse" 
                   message="intf:getLastSellPriceResponse"/>
    </wsdl:operation>
  </wsdl:portType>
  <wsdl:binding name="StockServiceSoapBinding" 
                type="intf:StockService">
    <wsdlsoap:binding style="document"
                    transport="http://schemas.xmlsoap.org/soap/http"/>
    <wsdl:operation name="getLastSellPrice">
      <wsdlsoap:operation soapAction=""/>
      <wsdl:input name="getLastSellPriceRequest">
        
        <wsdlsoap:header message="intf:getLastSellPriceRequest"
                         part="request_header" use="literal"/>
        <wsdlsoap:body use="literal" parts="parameters"/>
      </wsdl:input>
      <wsdl:output name="getLastSellPriceResponse">
        <wsdlsoap:body use="literal"/>
      </wsdl:output>
    </wsdl:operation>
  </wsdl:binding>
  <wsdl:service name="StockServiceService">
    ...
  </wsdl:service>
</wsdl:definitions>
      

public class SOAPHeaderHandler extends javax.xml.rpc.handler.GenericHandler {
   ...
   public boolean handleRequest(MessageContext arg) {
 if (arg instanceof SOAPMessageContext) {
  SOAPMessageContext context = (SOAPMessageContext)arg;
  try {
   SOAPHeader header = 
           context.getMessage().getSOAPPart().getEnvelope().getHeader();
   Iterator headers = 
                        header.extractHeaderElements
                        ("http://schemas.xmlsoap.org/soap/actor/next");
   while (headers.hasNext()) {
    SOAPHeaderElement he = 
                                 (SOAPHeaderElement)headers.next();
    // process the retrieved header element here
   } 
  } catch (SOAPException x) {
   // insert error handling here
  }
 }
 return true;
   }
}

public interface StockService_SEI extends java.rmi.Remote {
  public float getLastSellPrice(
                 String ticker, 
                 java.util.Calendar request_Header) 
       throws java.rmi.RemoteException;
}

public class StockService implements 
                      StockService_SEI, javax.xml.rpc.server.ServiceLifecycle
{
   ServletEndpointContext ctx;
   public float getLastSellPrice(String ticker, java.util.Calendar request_Header) {
 float f = 0.0f;
 if (ctx != null) {
  ServletContext servletContext = ctx.getServletContext();
            SOAPMessageContext mc = 
                   (SOAPMessageContext)ctx.getMessageContext();
  // process SOAP header as shown in the message handler
 }
 // further processing...
 return f;
   }
 
   public void init(Object arg0) throws ServiceException {
 if (javax.xml.rpc.server.ServletEndpointContext.class.isInstance(arg0))
  ctx = (ServletEndpointContext) arg0;
   }