WebServiceTemplate 是 Spring-WS 中用於客戶端 Web 服務訪問的核心類。它包含傳送 Source 物件的方法，以及將響應訊息作為 Source 或 Result 接收的方法。此外，它還可以在透過傳輸傳送物件之前將其編組為 XML，並將任何響應 XML 解組回物件。

<beans>

    <bean id="messageFactory" class="org.springframework.ws.soap.saaj.SaajSoapMessageFactory"/>

    <bean id="webServiceTemplate" class="org.springframework.ws.client.core.WebServiceTemplate">
        <constructor-arg ref="messageFactory"/>
        <property name="defaultUri" value="http://example.com/WebService"/>
    </bean>

</beans>

<bean id="webServiceTemplate" class="org.springframework.ws.client.core.WebServiceTemplate">
    <constructor-arg ref="messageFactory"/>
    <property name="messageSender">
        <bean class="org.springframework.ws.transport.http.HttpComponentsMessageSender">
            <property name="credentials">
                <bean class="org.apache.http.auth.UsernamePasswordCredentials">
                    <constructor-arg value="john:secret"/>
                </bean>
            </property>
        </bean>
    </property>
    <property name="defaultUri" value="http://example.com/WebService"/>
</bean>

<beans>

    <bean id="messageFactory" class="org.springframework.ws.soap.saaj.SaajSoapMessageFactory"/>

    <bean id="connectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory">
        <property name="brokerURL" value="vm://?broker.persistent=false"/>
    </bean>

    <bean id="webServiceTemplate" class="org.springframework.ws.client.core.WebServiceTemplate">
        <constructor-arg ref="messageFactory"/>
        <property name="messageSender">
            <bean class="org.springframework.ws.transport.jms.JmsMessageSender">
                <property name="connectionFactory" ref="connectionFactory"/>
            </bean>
        </property>
        <property name="defaultUri" value="jms:RequestQueue?deliveryMode=NON_PERSISTENT"/>
    </bean>

</beans>

<beans>

    <bean id="messageFactory" class="org.springframework.ws.soap.saaj.SaajSoapMessageFactory"/>

    <bean id="webServiceTemplate" class="org.springframework.ws.client.core.WebServiceTemplate">
        <constructor-arg ref="messageFactory"/>
        <property name="messageSender">
            <bean class="org.springframework.ws.transport.mail.MailMessageSender">
                <property name="from" value="Spring-WS SOAP Client &lt;[email protected]&gt;"/>
                <property name="transportUri" value="smtp://client:[email protected]"/>
                <property name="storeUri" value="imap://client:[email protected]/INBOX"/>
            </bean>
        </property>
        <property name="defaultUri" value="mailto:[email protected]?subject=SOAP%20Test"/>
    </bean>

</beans>

<beans>

    <bean id="messageFactory" class="org.springframework.ws.soap.saaj.SaajSoapMessageFactory"/>

    <bean id="connection" class="org.springframework.ws.transport.xmpp.support.XmppConnectionFactoryBean">
        <property name="host" value="jabber.org"/>
        <property name="username" value="username"/>
        <property name="password" value="password"/>
    </bean>

    <bean id="webServiceTemplate" class="org.springframework.ws.client.core.WebServiceTemplate">
        <constructor-arg ref="messageFactory"/>
        <property name="messageSender">
            <bean class="org.springframework.ws.transport.xmpp.XmppMessageSender">
                <property name="connection" ref="connection"/>
            </bean>
        </property>
        <property name="defaultUri" value="xmpp:[email protected]"/>
    </bean>

</beans>

WebServiceTemplate 包含許多方便的方法來發送和接收 Web 服務訊息。有些方法接受並返回 Source，有些方法返回 Result。此外，還有將物件編組和解組為 XML 的方法。這是一個將簡單 XML 訊息傳送到 Web 服務的示例。

import java.io.StringReader;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;

import org.springframework.ws.WebServiceMessageFactory;
import org.springframework.ws.client.core.WebServiceTemplate;
import org.springframework.ws.transport.WebServiceMessageSender;

public class WebServiceClient {

    private static final String MESSAGE =
        "<message xmlns=\"http://tempuri.org\">Hello Web Service World</message>";

    private final WebServiceTemplate webServiceTemplate = new WebServiceTemplate();

    public void setDefaultUri(String defaultUri) {
        webServiceTemplate.setDefaultUri(defaultUri);
    }

    // send to the configured default URI
    public void simpleSendAndReceive() {
        StreamSource source = new StreamSource(new StringReader(MESSAGE));
        StreamResult result = new StreamResult(System.out);
        webServiceTemplate.sendSourceAndReceiveToResult(source, result);
    }

    // send to an explicit URI
    public void customSendAndReceive() {
        StreamSource source = new StreamSource(new StringReader(MESSAGE));
        StreamResult result = new StreamResult(System.out);
        webServiceTemplate.sendSourceAndReceiveToResult("https://:8080/AnotherWebService",
            source, result);
    }

}

<beans xmlns="http://www.springframework.org/schema/beans">

    <bean id="webServiceClient" class="WebServiceClient">
        <property name="defaultUri" value="https://:8080/WebService"/>
    </bean>

</beans>

上述示例使用 WebServiceTemplate 將 hello world 訊息傳送到位於 https://:8080/WebService 的 Web 服務（對於 simpleSendAndReceive() 方法），並將結果寫入控制檯。WebServiceTemplate 注入了預設 URI，因為 Java 程式碼中沒有顯式提供 URI，所以使用了預設 URI。

請注意，WebServiceTemplate 類一旦配置（假設其所有依賴項也是執行緒安全的，Spring-WS 附帶的所有依賴項都是如此），就是執行緒安全的，因此如果需要，多個物件可以使用相同的共享 WebServiceTemplate 例項。WebServiceTemplate 公開了一個零引數建構函式和 messageFactory/messageSender bean 屬性，可用於構造例項（使用 Spring 容器或純 Java 程式碼）。或者，考慮從 Spring-WS 的 WebServiceGatewaySupport 方便基類派生，該基類公開了方便的 bean 屬性以實現輕鬆配置。（您不必擴充套件此基類...它僅作為便利類提供。）

為了方便傳送普通 Java 物件，WebServiceTemplate 有許多 send(..) 方法，它們以 Object 作為訊息資料內容的引數。WebServiceTemplate 類中的 marshalSendAndReceive(..) 方法將請求物件轉換為 XML 的工作委託給 Marshaller，並將響應 XML 轉換為物件的工作委託給 Unmarshaller。（有關編組器和解組器的更多資訊，請參閱 Spring 文件。）透過使用編組器，您的應用程式程式碼可以專注於正在傳送或接收的業務物件，而不必擔心它如何表示為 XML 的細節。為了使用編組功能，您必須使用 WebServiceTemplate 類的 marshaller/unmarshaller 屬性設定編組器和解組器。

為了適應 SOAP 頭部和其他訊息設定，WebServiceMessageCallback 介面允許您在訊息建立之後但在傳送之前訪問訊息。以下示例演示如何設定透過編組物件建立的訊息上的 SOAP Action 頭部。

public void marshalWithSoapActionHeader(MyObject o) {

    webServiceTemplate.marshalSendAndReceive(o, new WebServiceMessageCallback() {

        public void doWithMessage(WebServiceMessage message) {
            ((SoapMessage)message).setSoapAction("http://tempuri.org/Action");
        }
    });
}

webServiceTemplate.marshalSendAndReceive(o, new ActionCallback("http://samples/RequestOrder"));

WebServiceMessageExtractor 介面是一個低階回撥介面，允許您完全控制從接收到的 WebServiceMessage 中提取 Object 的過程。WebServiceTemplate 將在提供給它的 WebServiceMessageExtractor 上呼叫 extractData(..) 方法，同時與服務資源的底層連線仍然開啟。以下示例說明了 WebServiceMessageExtractor 的實際應用

public void marshalWithSoapActionHeader(final Source s) {
    final Transformer transformer = transformerFactory.newTransformer();
    webServiceTemplate.sendAndReceive(new WebServiceMessageCallback() {
        public void doWithMessage(WebServiceMessage message) {
            transformer.transform(s, message.getPayloadResult());
        },
        new WebServiceMessageExtractor() {
            public Object extractData(WebServiceMessage message) throws IOException
                // do your own transforms with message.getPayloadResult()
                //     or message.getPayloadSource()
            }
        });
}

Spring Web Services 2.0 引入了對建立 Web 服務客戶端整合測試的支援。在此上下文中，客戶端是使用 WebServiceTemplate 訪問 Web 服務的類。

整合測試支援位於 org.springframework.ws.test.client 包中。該包中的核心類是 MockWebServiceServer。其基本思想是 Web 服務模板連線到這個模擬伺服器，向其傳送請求訊息，然後模擬伺服器根據註冊的期望進行驗證。如果滿足期望，模擬伺服器然後準備一個響應訊息，並將其傳送回模板。

MockWebServiceServer 的典型用法是

例如，考慮這個 Web 服務客戶端類

import org.springframework.ws.client.core.support.WebServiceGatewaySupport;

public class CustomerClient extends WebServiceGatewaySupport {                           

  public int getCustomerCount() {
    CustomerCountRequest request = new CustomerCountRequest();                           
    request.setCustomerName("John Doe");

    CustomerCountResponse response =
      (CustomerCountResponse) getWebServiceTemplate().marshalSendAndReceive(request);    
      
    return response.getCustomerCount();
  }

}

CustomerClient 的典型測試如下所示

import javax.xml.transform.Source;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import org.springframework.xml.transform.StringSource;

import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;

import static org.junit.Assert.assertEquals;

import org.springframework.ws.test.client.MockWebServiceServer;                          
import static org.springframework.ws.test.client.RequestMatchers.*;                      
import static org.springframework.ws.test.client.ResponseCreators.*;                     

@RunWith(SpringJUnit4ClassRunner.class)                                                  
@ContextConfiguration("integration-test.xml")                                            
public class CustomerClientIntegrationTest {

  @Autowired
  private CustomerClient client;                                                         

  private MockWebServiceServer mockServer;                                               

  @Before
  public void createServer() throws Exception {
    mockServer = MockWebServiceServer.createServer(client);
  }

  @Test
  public void customerClient() throws Exception {
    Source requestPayload = new StringSource(
      "<customerCountRequest xmlns='http://springframework.org/spring-ws'>" +
        "<customerName>John Doe</customerName>" +
      "</customerCountRequest>");
    Source responsePayload = new StringSource(
      "<customerCountResponse xmlns='http://springframework.org/spring-ws'>" +
        "<customerCount>10</customerCount>" +
      "</customerCountResponse>");

    mockServer.expect(payload(requestPayload)).andRespond(withPayload(responsePayload)); 

    int result = client.getCustomerCount();                                              
    assertEquals(10, result);                                                            

    mockServer.verify();                                                                 
  }

}

為了驗證請求訊息是否符合某些期望，MockWebServiceServer 使用 RequestMatcher 策略介面。此介面定義的契約非常簡單

public interface RequestMatcher {

  void match(URI uri,
             WebServiceMessage request)
    throws IOException,
           AssertionError;

}

您可以編寫自己的此介面實現，在訊息不符合您的期望時丟擲 AssertionError，但您當然不必這樣做。RequestMatchers 類為您提供了標準 RequestMatcher 實現，供您在測試中使用。您通常會靜態匯入此類。

RequestMatchers 類提供以下請求匹配器

您可以透過鏈式呼叫 andExpect() 來設定多個請求期望，如下所示

mockServer.expect(connectionTo("http://example.com")).
 andExpect(payload(expectedRequestPayload)).
 andExpect(validPayload(schemaResource)).
 andRespond(...);

有關 RequestMatchers 提供的請求匹配器的更多資訊，請參閱類級別 Javadoc。

當請求訊息經過驗證並滿足定義的期望時，MockWebServiceServer 將為 WebServiceTemplate 建立一個響應訊息以供使用。伺服器為此目的使用 ResponseCreator 策略介面

public interface ResponseCreator {

  WebServiceMessage createResponse(URI uri,
                                   WebServiceMessage request,
                                   WebServiceMessageFactory messageFactory)
    throws IOException;

}

您同樣可以編寫自己的此介面實現，使用訊息工廠建立響應訊息，但您當然不必這樣做，因為 ResponseCreators 類為您提供了標準 ResponseCreator 實現，供您在測試中使用。您通常會靜態匯入此類。

ResponseCreators 類提供以下響應

有關 RequestMatchers 提供的請求匹配器的更多資訊，請參閱類級別 Javadoc。