Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

3.5. 클라이언트 및 엔드포인트 구성 할당

클라이언트 및 끝점 구성은 다음과 같은 방식으로 할당할 수 있습니다.

  • 주석을 통한 명시적 할당, 엔드포인트의 경우 또는 클라이언트의 API 프로그래밍 사용.
  • 기본 설명자에서 구성 자동 할당.
  • 컨테이너에서 구성 자동 할당.

3.5.1. 명시적 구성 할당
링크 복사

명시적 구성 할당은 엔드포인트 또는 클라이언트를 지정된 구성에 따라 설정해야 하는 개발자를 위한 것입니다. 구성은 애플리케이션 배포에 포함되거나 webservices 하위 시스템에 포함된 설명자에서 제공됩니다.

3.5.1.1. 구성 배포 설명자
링크 복사

Jakarta XML Web Services 클라이언트와 엔드포인트 구현을 포함할 수 있는 Jakarta EE 아카이브에는 사전 정의된 클라이언트 및 엔드포인트 구성 선언도 포함될 수 있습니다. 제공된 아카이브에 대한 모든 엔드포인트 또는 클라이언트 구성 정의는 단일 배포 설명자 파일에 제공되어야 합니다. 이 설명자는 EAP_HOME/docs/schema/jbossws-jaxws-config_4_0.xsd 에서 확인할 수 있는 스키마 구현이어야 합니다. 많은 엔드포인트 또는 클라이언트 구성을 배포 설명자 파일에 정의할 수 있습니다. 각 구성에는 애플리케이션이 배포되는 서버 내에 고유한 이름이 있어야 합니다. 구성 이름은 애플리케이션 외부의 엔드포인트 또는 클라이언트 구현에서 참조할 수 없습니다.

예제: 두 엔드 포인트 설정이 있는 설명자

<?xml version="1.0" encoding="UTF-8"?>
<jaxws-config xmlns="urn:jboss:jbossws-jaxws-config:4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:javaee="http://java.sun.com/xml/ns/javaee"
  xsi:schemaLocation="urn:jboss:jbossws-jaxws-config:4.0 schema/jbossws-jaxws-config_4_0.xsd">
  <endpoint-config>
    <config-name>org.jboss.test.ws.jaxws.jbws3282.Endpoint4Impl</config-name>
    <pre-handler-chains>
      <javaee:handler-chain>
        <javaee:handler>
          <javaee:handler-name>Log Handler</javaee:handler-name>
          <javaee:handler-class>org.jboss.test.ws.jaxws.jbws3282.LogHandler</javaee:handler-class>
        </javaee:handler>
      </javaee:handler-chain>
    </pre-handler-chains>
    <post-handler-chains>
      <javaee:handler-chain>
        <javaee:handler>
          <javaee:handler-name>Routing Handler</javaee:handler-name>
          <javaee:handler-class>org.jboss.test.ws.jaxws.jbws3282.RoutingHandler</javaee:handler-class>
        </javaee:handler>
      </javaee:handler-chain>
    </post-handler-chains>
  </endpoint-config>
  <endpoint-config>
    <config-name>EP6-config</config-name>
    <post-handler-chains>
      <javaee:handler-chain>
        <javaee:handler>
          <javaee:handler-name>Authorization Handler</javaee:handler-name>
          <javaee:handler-class>org.jboss.test.ws.jaxws.jbws3282.AuthorizationHandler</javaee:handler-class>
        </javaee:handler>
      </javaee:handler-chain>
    </post-handler-chains>
  </endpoint-config>
</jaxws-config>

마찬가지로 위에서 언급한 스키마를 구현하는 설명자에 클라이언트 구성을 지정할 수 있습니다. 

<?xml version="1.0" encoding="UTF-8"?>
<jaxws-config xmlns="urn:jboss:jbossws-jaxws-config:4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:javaee="http://java.sun.com/xml/ns/javaee"
  xsi:schemaLocation="urn:jboss:jbossws-jaxws-config:4.0 schema/jbossws-jaxws-config_4_0.xsd">
  <client-config>
    <config-name>Custom Client Config</config-name>
    <pre-handler-chains>
      <javaee:handler-chain>
        <javaee:handler>
          <javaee:handler-name>Routing Handler</javaee:handler-name>
          <javaee:handler-class>org.jboss.test.ws.jaxws.clientConfig.RoutingHandler</javaee:handler-class>
        </javaee:handler>
        <javaee:handler>
          <javaee:handler-name>Custom Handler</javaee:handler-name>
          <javaee:handler-class>org.jboss.test.ws.jaxws.clientConfig.CustomHandler</javaee:handler-class>
        </javaee:handler>
      </javaee:handler-chain>
    </pre-handler-chains>
  </client-config>
  <client-config>
    <config-name>Another Client Config</config-name>
    <post-handler-chains>
      <javaee:handler-chain>
        <javaee:handler>
          <javaee:handler-name>Routing Handler</javaee:handler-name>
          <javaee:handler-class>org.jboss.test.ws.jaxws.clientConfig.RoutingHandler</javaee:handler-class>
        </javaee:handler>
      </javaee:handler-chain>
    </post-handler-chains>
  </client-config>
</jaxws-config>

3.5.1.2. 애플리케이션 서버 설정
링크 복사

JBoss EAP를 사용하면 webservices 하위 시스템에서 JBossWS 클라이언트 및 서버 사전 정의된 구성을 선언할 수 있습니다. 따라서 지정된 구성에 할당된 각 엔드포인트 또는 클라이언트의 체인에 서버 전체 핸들러를 추가할 수 있습니다.

표준 설정

동일한 JBoss EAP 인스턴스와 엔드포인트에서 실행되는 클라이언트에는 기본적으로 표준 구성이 할당됩니다. 구성이 다른 경우가 아니면 기본값이 사용됩니다. 이를 통해 관리자는 클라이언트 및 엔드포인트 구성에 대한 기본 핸들러 체인을 조정할 수 있습니다. 웹 서비스 하위 시스템에서 사용되는 기본 클라이언트 및 엔드포인트 구성의 이름은 Standard-Client-Config 및 Standard-Endpoint-Config 입니다.

핸들러 클래스 로드

서버 전체 핸들러를 설정할 때 각 ws 배포 클래스 로더를 통해 핸들러 클래스를 사용할 수 있어야 합니다. 따라서 사전 정의된 구성을 사용하는 배포에 적절한 모듈 종속성을 지정해야 할 수 있습니다. 배포에 적절한 모듈 종속성을 지정하는 한 가지 방법은 org.jboss.ws.spi 등의 배포에 대한 종속성으로 이미 설정된 모듈 중 하나에 핸들러 클래스를 포함하는 모듈에 종속성을 추가하는 것입니다.

설정 예

예제: 기본 하위 시스템 구성

<subsystem xmlns="urn:jboss:domain:webservices:2.0">
    <!-- ... -->
    <endpoint-config name="Standard-Endpoint-Config"/>
    <endpoint-config name="Recording-Endpoint-Config">
        <pre-handler-chain name="recording-handlers" protocol-bindings="##SOAP11_HTTP ##SOAP11_HTTP_MTOM ##SOAP12_HTTP ##SOAP12_HTTP_MTOM">
            <handler name="RecordingHandler" class="org.jboss.ws.common.invocation.RecordingServerHandler"/>
        </pre-handler-chain>
    </endpoint-config>
    <client-config name="Standard-Client-Config"/>
</subsystem>

배포별 ws-security 끝점 설정에 대한 구성 파일: 

<jaxws-config xmlns="urn:jboss:jbossws-jaxws-config:4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:javaee="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="urn:jboss:jbossws-jaxws-config:4.0 schema/jbossws-jaxws-config_4_0.xsd">
  <endpoint-config>
    <config-name>Custom WS-Security Endpoint</config-name>
    <property>
      <property-name>ws-security.signature.properties</property-name>
      <property-value>bob.properties</property-value>
    </property>
    <property>
      <property-name>ws-security.encryption.properties</property-name>
      <property-value>bob.properties</property-value>
    </property>
    <property>
      <property-name>ws-security.signature.username</property-name>
      <property-value>bob</property-value>
    </property>
    <property>
      <property-name>ws-security.encryption.username</property-name>
      <property-value>alice</property-value>
    </property>
    <property>
      <property-name>ws-security.callback-handler</property-name>
      <property-value>org.jboss.test.ws.jaxws.samples.wsse.policy.basic.KeystorePasswordCallback</property-value>
    </property>
  </endpoint-config>
</jaxws-config>

에서 SOAP 메시지 스키마 유효성 검사를 기본값으로 수정한 JBoss EAP 기본 구성: 

<subsystem xmlns="urn:jboss:domain:webservices:2.0">
    <!-- ... -->
    <endpoint-config name="Standard-Endpoint-Config">
        <property name="schema-validation-enabled" value="true"/>
    </endpoint-config>
    <!-- ... -->
    <client-config name="Standard-Client-Config">
        <property name="schema-validation-enabled" value="true"/>
    </client-config>
</subsystem>

3.5.1.3. EndpointConfig 주석
링크 복사

지정된 애플리케이션에서 구성을 사용할 수 있으면 org.jboss.ws.api.annotation.EndpointConfig 주석을 사용하여 Jakarta XML Web Services 엔드포인트 구현에 엔드포인트 구성을 할당합니다. webservices 하위 시스템에서 정의된 구성을 할당하는 경우 구성 이름만 지정해야 합니다. 애플리케이션에 정의된 구성을 할당하는 경우 배포 설명자 및 구성 이름에 대한 상대 경로를 지정해야 합니다.

예제: EndpointConfig 주석

@EndpointConfig(configFile = "WEB-INF/my-endpoint-config.xml", configName = "Custom WS-Security Endpoint")
public class ServiceImpl implements ServiceIface {
   public String sayHello() {
      return "Secure Hello World!";
   }
}

3.5.1.4. 자카르타 XML 웹 서비스 기능
링크 복사

org.jboss.ws.api.configuration.ClientConfigFeature 를 사용하여 JBossWS에서 제공하는 자카르타 XML 웹 서비스 기능 확장 기능인 구성을 설정할 수도 있습니다. 

import org.jboss.ws.api.configuration.ClientConfigFeature;

Service service = Service.create(wsdlURL, serviceName);

Endpoint port = service.getPort(Endpoint.class, new ClientConfigFeature("META-INF/my-client-config.xml", "Custom Client Config"));
port.echo("Kermit");

ClientConfigFeature 생성자로 true 를 전달하여 지정된 구성에서 속성을 설정할 수도 있습니다. 

Endpoint port = service.getPort(Endpoint.class, new ClientConfigFeature("META-INF/my-client-config.xml", "Custom Client Config"), true);

JBossWS는 현재 스레드 컨텍스트 클래스 로더를 사용하여 리소스로 해결된 후 지정된 구성 파일을 구문 분석합니다. EAP_HOME/docs/schema/jbossws-jaxws-config_4_0.xsd 스키마는 설명자 콘텐츠를 정의하고 jbossws-spi 아티팩트에 포함됩니다.

구성 파일의 null 로 전달하면 사용 가능한 경우 현재 컨테이너 구성에서 구성을 읽습니다. 

Endpoint port = service.getPort(Endpoint.class, new ClientConfigFeature(null, "Container Custom Client Config"));

3.5.1.5. API를 통한 명시적 설정
링크 복사

또는 JBossWS API에는 클라이언트를 구축할 때 구성을 할당하는 데 사용할 수 있는 기능 클래스가 함께 제공됩니다.

핸들러

Jakarta XML Web Services 핸들러는 다음과 같이 클라이언트 구성에서 읽습니다. 

import org.jboss.ws.api.configuration.ClientConfigUtil;
import org.jboss.ws.api.configuration.ClientConfigurer;

Service service = Service.create(wsdlURL, serviceName);
Endpoint port = service.getPort(Endpoint.class);
BindingProvider bp = (BindingProvider)port;

ClientConfigurer configurer = ClientConfigUtil.resolveClientConfigurer();
configurer.setConfigHandlers(bp, "META-INF/my-client-config.xml", "Custom Client Config");
port.echo("Kermit");

ClientConfigUtil 유틸리티 클래스를 사용하여 핸들러를 설정할 수도 있습니다. 

ClientConfigUtil.setConfigHandlers(bp, "META-INF/my-client-config.xml", "Custom Client Config");

기본 ClientConfigurer 구현은 현재 스레드 컨텍스트 클래스 로더를 사용하여 리소스로 해결된 후 지정된 구성 파일을 구문 분석합니다. EAP_HOME/docs/schema/jbossws-jaxws-config_4_0.xsd 스키마는 설명자 콘텐츠를 정의하고 jbossws-spi 아티팩트에 포함됩니다.

구성 파일의 null 로 전달하면 사용 가능한 경우 현재 컨테이너 구성에서 구성을 읽습니다. 

ClientConfigurer configurer = ClientConfigUtil.resolveClientConfigurer();
configurer.setConfigHandlers(bp, null, "Container Custom Client Config");
속성

마찬가지로 속성은 클라이언트 구성에서 다음과 같이 읽습니다. 

import org.jboss.ws.api.configuration.ClientConfigUtil;
import org.jboss.ws.api.configuration.ClientConfigurer;

Service service = Service.create(wsdlURL, serviceName);
Endpoint port = service.getPort(Endpoint.class);

ClientConfigUtil.setConfigProperties(port, "META-INF/my-client-config.xml", "Custom Client Config");
port.echo("Kermit");

ClientConfigUtil 유틸리티 클래스를 사용하여 속성을 설정할 수도 있습니다. 

ClientConfigurer configurer = ClientConfigUtil.resolveClientConfigurer();
configurer.setConfigProperties(port, "META-INF/my-client-config.xml", "Custom Client Config");

기본 ClientConfigurer 구현은 현재 스레드 컨텍스트 클래스 로더를 사용하여 리소스로 해결된 후 지정된 구성 파일을 구문 분석합니다. EAP_HOME/docs/schema/jbossws-jaxws-config_4_0.xsd 스키마는 설명자 콘텐츠를 정의하고 jbossws-spi 아티팩트에 포함됩니다.

구성 파일의 null 로 전달하면 사용 가능한 경우 현재 컨테이너 구성에서 구성을 읽습니다. 

ClientConfigurer configurer = ClientConfigUtil.resolveClientConfigurer();
configurer.setConfigProperties(port, null, "Container Custom Client Config");

3.5.2. 기본 설명자에서 자동 설정
링크 복사

애플리케이션 개발자는 클라이언트 및 엔드포인트 구현에 사용해야 하는 구성을 인식하지 못하는 경우가 있습니다. 그렇지 않으면 컴파일 시간 종속성이므로 JBossWS API를 명시적으로 사용하지 않을 수 있습니다. 이러한 시나리오에 대처하기 위해 JBossWS를 사용하면 기본 클라이언트, jaxws-client-config.xml, 엔드포인트, jaxws-endpoint-config.xml, 애플리케이션 내 설명자를 루트 디렉토리에 포함시킬 수 있습니다. 구성 파일 이름이 지정되지 않을 때마다 구성을 가져오기 위해 구문 분석됩니다. 

<config-file>WEB-INF/jaxws-endpoint-config.xml</config-file>

구성 이름을 지정하지 않으면 JBossWS에서 다음과 같은 구성을 자동으로 찾습니다.

  • Jakarta XML Web Services 엔드포인트의 경우 엔드포인트 구현 클래스의 정규화된 이름(FQN)입니다.
  • Jakarta XML Web Services 클라이언트의 경우 서비스 엔드포인트 인터페이스의 FQN입니다.

Dispatch 클라이언트에 대해 자동 구성 이름이 선택되지 않습니다.

예를 들어 사전 정의된 구성이 명시적으로 설정되지 않은 엔드포인트 구현 클래스 org.foo.bar.EndpointImpl 는 애플리케이션 배포 루트의 jaxws-endpoint-config .xml 설명자 내에서 JBossWS가 org.foo. bar.EndpointImpl 을 찾도록 합니다. 마찬가지로 클라이언트 쪽에서는 org.foo.bar.Endpoint 인터페이스를 구현하는 클라이언트 프록시에서 jaxws-client-config .xml 설명자의 org.foo.bar. Endpoint 구성에서 읽습니다.

3.5.3. 컨테이너에서 자동 구성 할당
링크 복사

JBossWS는 명시적 구성이 제공되지 않고 기본 설명자를 사용할 수 없거나 관련 구성이 포함되지 않을 때마다 컨테이너에서 사전 정의된 구성을 가져오는 것으로 대체합니다. 배포된 애플리케이션과 독립적으로 컨테이너를 관리할 수 있으므로 이 동작은 Jakarta XML Web Services 클라이언트 및 엔드포인트 설정에 대한 추가 제어를 제공합니다.

JBossWS는 명시적으로 명명된 구성의 웹 서비스 하위 시스템에 액세스합니다. 사용되는 기본 구성 이름은 다음과 같습니다.

  • Jakarta XML Web Services 엔드포인트의 경우 엔드포인트 구현 클래스의 정규화된 이름입니다.
  • Jakarta XML Web Services 클라이언트의 경우 서비스 엔드포인트 인터페이스의 정규화된 이름입니다.

디스패치 클라이언트는 자동으로 구성되지 않습니다. 위와 같이 계산된 이름을 사용하여 구성이 발견되지 않은 경우 각각 클라이언트 및 엔드포인트에 Standard-Client -Config 및 Standard-Endpoint-Config 구성이 사용됩니다.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat맨 위로 이동