知識庫 / Web Services RSS 訂閱

我們將這個類命名為 CountryClient：

public class CountryClient extends WebServiceGatewaySupport {

    public GetCountryResponse getCountry(String country) {
        GetCountryRequest request = new GetCountryRequest();
        request.setName(country);

        GetCountryResponse response = (GetCountryResponse) getWebServiceTemplate()
          .marshalSendAndReceive(request);
        return response;
    }
}

在這裏，我們定義了一個名為 getCountry 的單方法，對應於該 Web 服務所暴露的操作。在方法中，我們創建了一個 GetCountryRequest 實例並調用 Web 服務以獲取 GetCountryResponse。換句話説，這裏就是我們執行 SOAP 交換的地方。

正如我們所見，Spring 使用其 WebServiceTemplate 使調用變得非常簡單。我們使用模板的方法 marshalSendAndReceive 執行 SOAP 交換。

XML 轉換在這裏通過一個嵌入的 Marshaller 處理。

現在讓我們來看一下 Marshaller 來自哪個配置。

3.3. <em >CountryClientConfig</em >>

我們需要配置我們的 Spring WS 客户端只需要兩個 Bean。

首先，一個 <em >Jaxb2Marshaller</em >> 用於將消息轉換為 XML 和反向轉換，其次是我們的 <em >CountryClient</em >>，它會將 <em >marshaller</em >> Bean 注入其中：

@Configuration
public class CountryClientConfig {

    @Bean
    public Jaxb2Marshaller marshaller() {
        Jaxb2Marshaller marshaller = new Jaxb2Marshaller();
        marshaller.setContextPath("com.baeldung.springsoap.client.gen");
        return marshaller;
    }
    @Bean
    public CountryClient countryClient(Jaxb2Marshaller marshaller) {
        CountryClient client = new CountryClient();
        client.setDefaultUri("http://localhost:8080/ws");
        client.setMarshaller(marshaller);
        client.setUnmarshaller(marshaller);
        return client;
    }
}

在此，我們需要確保 marshaller’s 的上下文路徑與插件配置中指定的 generatePackage 保持一致，並且位於我們的 pom.xml 中。

請注意客户端的默認 URI。它設置為 WSDL 中指定的 soap:address 位置。

4. 客户端測試

接下來，我們將編寫一個 JUnit 測試，以驗證我們的客户端是否按預期運行：

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(classes = CountryClientConfig.class, loader = AnnotationConfigContextLoader.class)
public class ClientLiveTest {

    @Autowired
    CountryClient client;

    @Test
    public void givenCountryService_whenCountryPoland_thenCapitalIsWarsaw() {
        GetCountryResponse response = client.getCountry("Poland");
        assertEquals("Warsaw", response.getCountry().getCapital());
    }

    @Test
    public void givenCountryService_whenCountrySpain_thenCurrencyEUR() {
        GetCountryResponse response = client.getCountry("Spain");
        assertEquals(Currency.EUR, response.getCountry().getCurrency());
    }
}

如我們所見，我們已將 CountryClient Bean 及其配置 CountryClientConfig 集成。然後，我們使用其中的 getCountry 方法來調用前面所述的遠程服務。

此外，我們還可以使用生成的Pojo數據模型，即 Country 和 Currency，提取所需的驗證信息。

5. 結論

在本教程中，我們學習瞭如何使用 Spring WS 調用 SOAP Web 服務。

我們只是探索了 Spring 在 SOAP Web 服務領域提供的部分內容；還有很多值得探索的地方。 更多內容請參考。