如何配置 Spring SOAP Web 服务客户端的 HTTP 标头

在 Spring SOAP Web 服务客户端中添加 HTTP 标头

该解决方案演示了一种使用 Spring Framework 和 JAX-WS 将 HTTP 标头注入到从 WSDL 文件生成的 SOAP 客户端的模块化方法。

import javax.xml.ws.BindingProvider;
import javax.xml.ws.handler.MessageContext;
import org.springframework.stereotype.Component;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
@Component
public class SOAPClient {
    private final SOAPService soapService = new SOAPService();
    public SOAPPort getSOAPPort() {
        SOAPPort port = soapService.getSOAPPort();
        Map<String, List<String>> headers = new HashMap<>();
        headers.put("AUTH_HEADER", List.of("AUTH_HEADER_VALUE"));
        BindingProvider bindingProvider = (BindingProvider) port;
        bindingProvider.getRequestContext().put(MessageContext.HTTP_REQUEST_HEADERS, headers);
        return port;
    }
}

使用自定义拦截器添加标头

此方法使用 Spring Web 服务和自定义拦截器来动态管理 HTTP 标头。

import org.springframework.ws.client.core.WebServiceMessageCallback;
import org.springframework.ws.client.core.WebServiceTemplate;
import org.springframework.ws.soap.client.core.SoapActionCallback;
import org.springframework.ws.transport.context.TransportContext;
import org.springframework.ws.transport.http.HttpUrlConnection;
import org.springframework.stereotype.Component;
@Component
public class SOAPClientWithInterceptor {
    private final WebServiceTemplate webServiceTemplate;
    public SOAPClientWithInterceptor(WebServiceTemplate webServiceTemplate) {
        this.webServiceTemplate = webServiceTemplate;
    }
    public Object callWebService(String uri, Object requestPayload) {
        WebServiceMessageCallback callback = message -> {
            TransportContext context = TransportContextHolder.getTransportContext();
            HttpUrlConnection connection = (HttpUrlConnection) context.getConnection();
            connection.addRequestHeader("AUTH_HEADER", "AUTH_HEADER_VALUE");
        };
        return webServiceTemplate.marshalSendAndReceive(uri, requestPayload, callback);
    }
}

第一个解决方案的单元测试

JUnit 测试用例验证 HTTP 标头是否已正确添加到 SOAP 客户端中。

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;
import org.junit.jupiter.api.Test;
import javax.xml.ws.BindingProvider;
import java.util.Map;
public class SOAPClientTest {
    @Test
    public void testHeaderInjection() {
        SOAPService mockService = mock(SOAPService.class);
        SOAPPort mockPort = mock(SOAPPort.class);
        when(mockService.getSOAPPort()).thenReturn(mockPort);
        SOAPClient client = new SOAPClient(mockService);
        SOAPPort port = client.getSOAPPort();
        BindingProvider provider = (BindingProvider) port;
        Map<String, List<String>> headers = (Map<String, List<String>>) provider.getRequestContext().get(MessageContext.HTTP_REQUEST_HEADERS);
        assertEquals("AUTH_HEADER_VALUE", headers.get("AUTH_HEADER").get(0));
    }
}

有关 SOAP 客户端中 HTTP 标头的常见问题

1. 如何在 Spring SOAP 客户端中添加自定义 HTTP 标头？
2. 您可以使用 BindingProvider 界面来设置 MessageContext.HTTP_REQUEST_HEADERS 与您的自定义标头进行映射。
3. 我可以动态更新每个请求的标头吗？
4. 是的，使用 WebServiceTemplate 与定制 WebServiceMessageCallback，您可以根据请求上下文动态修改标头。
5. 如果我的令牌在会话期间过期怎么办？
6. 在客户端中实现重试机制，以在重试请求之前检测 401 响应并刷新令牌。
7. 是否有硬编码标头的替代方案？
8. 是的，您可以使用属性文件或环境变量动态配置标头并将其注入 SOAP 客户端。
9. 标头的安全最佳实践是什么？
10. 始终使用 HTTPS 加密传输中的标头，在服务器端验证标头内容，并避免暴露日志中的敏感信息。

关于集成 SOAP 标头的最终想法

适当添加 HTTP 标头 SOAP 客户端可确保与 Web 服务的无缝通信，尤其是在需要身份验证的情况下。使用 Spring Web Services 或 JAX-WS BindingProvider 等工具，您可以动态处理安全 API 调用的标头。 💡

通过掌握这些技术，开发人员可以有效地解决 403 错误等常见问题。无论是处理静态标头还是实现基于令牌的高级安全性，这些方法都可以实现强大的集成，这使得它们对于现代 Web 服务至关重要。 🚀