Spring SOAP 웹 서비스 클라이언트의 HTTP 헤더를 구성하는 방법

Spring SOAP 웹 서비스 클라이언트에 HTTP 헤더 추가

이 솔루션은 Spring Framework 및 JAX-WS를 사용하여 WSDL 파일에서 생성된 SOAP 클라이언트에 HTTP 헤더를 삽입하는 모듈식 접근 방식을 보여줍니다.

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;
    }
}

사용자 정의 인터셉터를 사용하여 헤더 추가

이 접근 방식은 HTTP 헤더를 동적으로 관리하기 위해 Spring 웹 서비스와 사용자 정의 인터셉터를 사용합니다.

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);
    }
}

첫 번째 솔루션에 대한 단위 테스트

HTTP 헤더가 SOAP 클라이언트에 올바르게 추가되었는지 확인하는 JUnit 테스트 케이스입니다.

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 클라이언트에서는 특히 인증이 필요한 시나리오에서 웹 서비스와의 원활한 통신을 보장합니다. Spring 웹 서비스 또는 JAX-WS BindingProvider와 같은 도구를 사용하면 보안 API 호출을 위한 헤더를 동적으로 처리할 수 있습니다. 💡

이러한 기술을 익히면 개발자는 403 오류와 같은 일반적인 문제를 효과적으로 해결할 수 있습니다. 정적 헤더를 처리하든 고급 토큰 기반 보안을 구현하든 이러한 방법은 강력한 통합을 강화하여 최신 웹 서비스에 필수적입니다. 🚀