17.2. 소비자 엔드 포인트 구성
17.2.1. 개요
JAX-WS 소비자 엔드포인트는 jaxws:client 요소를 사용하여 구성됩니다. 요소의 특성은 소비자를 생성하는 데 필요한 기본 정보를 제공합니다.
WS-RM과 같은 다른 기능을 사용자에게 jaxws:client 요소에 자식을 추가합니다. 하위 요소는 또한 끝점의 로깅 동작을 구성하고 엔드포인트의 구현에 다른 속성을 삽입하는 데 사용됩니다.
17.2.2. 기본 설정 속성
표 17.4. “JAX-WS Consumer를 구성하는 데 사용되는 속성” 에 설명된 속성은 JAX-WS 소비자를 구성하는 데 필요한 기본 정보를 제공합니다. 구성하려는 특정 속성에 대한 값만 제공해야 합니다. 대부분의 속성은 합리적인 기본값이 있거나, 끝점의 계약에서 제공하는 정보에 의존합니다.
| 속성 | 설명 |
|---|---|
| 소비자가 요청할 끝점의 HTTP 주소를 지정합니다. 이 값은 계약에 설정된 값을 재정의합니다. | |
| 소비자가 사용하는 메시지 바인딩의 ID를 지정합니다. 유효한 바인딩 ID 목록은 23장. Apache CXF 바인딩 ID 에서 제공됩니다. | |
| 엔드포인트를 관리하는 버스를 구성하는 Spring 빈의 ID를 지정합니다. | |
|
소비자가 요청하는 서비스에 대한 | |
|
소비자가 요청하는 서비스에 대한 | |
| 간단한 사용자 이름/암호 인증에 사용되는 사용자 이름을 지정합니다. | |
| 간단한 사용자 이름/암호 인증에 사용되는 암호를 지정합니다. | |
| 서비스 엔드포인트 인터페이스(SEI)의 이름을 지정합니다. | |
| 끝점의 WSDL 계약의 위치를 지정합니다. WSDL 계약의 위치는 클라이언트가 배포된 폴더를 기준으로 합니다. | |
|
소비자가 요청하는 서비스에 대한 | |
|
빈이 추상 빈인지 여부를 지정합니다. 추상화 빈은 구체적인 빈 정의를 위해 부모 역할을 하며 인스턴스화되지 않습니다. 기본값은 | |
| 끝점이 인스턴스화되기 전에 종속되는 빈 목록을 지정합니다. | |
|
기본값은
이 값을
|
표 17.4. “JAX-WS Consumer를 구성하는 데 사용되는 속성” 에 나열된 속성 외에도 여러 xmlns:shortName특성을 사용하여 속성에 사용되는 네임스페이스를 선언해야 할 수 있습니다.
endpointName 및 serviceName
17.2.3. 기능 추가
사용자에게 기능을 추가하거나 고급 구성을 수행하려면 구성에 하위 요소를 추가해야 합니다.
자식 요소를 사용하면 다음을 수행할 수 있습니다.
표 17.5. “Consumer Endpoint 구성을 위한 요소” JAX-WS 소비자를 구성하는 데 사용할 수 있는 자식 요소에 대해 설명합니다.
| 요소 | 설명 |
|---|---|
|
끝점에서 사용하는 메시지 바인딩을 구성하는 빈을 지정합니다. 메시지 바인딩은 | |
|
끝점에서 사용하는 데이터 바인딩을 구현하는 클래스를 지정합니다.Specifies the class implementing the data binding used by the endpoint. 포함된 빈 정의를 사용하여 이 값을 지정합니다. JAXB 데이터 바인딩을 구현하는 클래스는 | |
| Apache CXF의 고급 기능을 구성하는 빈 목록을 지정합니다. 빈 참조 목록 또는 포함된 빈 목록을 제공할 수 있습니다. | |
| 메시지 처리를 위한 JAX-WS Handler 구현 목록을 지정합니다. JAX-WS Handler 구현 방법에 대한 자세한 내용은 43장. 핸들러 작성 을 참조하십시오. | |
| 인바운드 응답을 처리하는 인터셉터 목록을 지정합니다. 자세한 내용은 VII 부. Apache CXF 인터셉터 개발 에서 참조하십시오. | |
| 인바운드 오류 메시지를 처리하는 인터셉터 목록을 지정합니다. 자세한 내용은 VII 부. Apache CXF 인터셉터 개발 에서 참조하십시오. | |
| 아웃바운드 요청을 처리하는 인터셉터 목록을 지정합니다. 자세한 내용은 VII 부. Apache CXF 인터셉터 개발 에서 참조하십시오. | |
| 아웃바운드 오류 메시지를 처리하는 인터셉터 목록을 지정합니다. 자세한 내용은 VII 부. Apache CXF 인터셉터 개발 에서 참조하십시오. | |
| 끝점으로 전달되는 속성의 맵을 지정합니다. | |
|
클라이언트가 사용할 org.apache.cxf.endpoint.ConduitSelector 구현을 지정합니다. ConduitSelector 구현은 아웃바운드 요청을 처리하는 데 사용되는 | |
[a]
SOAP 바인딩은 soap:soapBinding 빈을 사용하여 구성됩니다.
| |
17.2.4. 예제
예 17.4. “간단한 소비자 구성” 간단한 소비자 구성을 보여줍니다.
예 17.4. 간단한 소비자 구성
<beans ...
xmlns:jaxws="http://cxf.apache.org/jaxws"
...
schemaLocation="...
http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd
...">
<jaxws:client id="bookClient"
serviceClass="org.apache.cxf.demo.BookClientImpl"
address="http://localhost:8080/books"/>
...
</beans>17.2.5. JAX-WS 소비자에 대한 스키마 유효성 검사 활성화
JAX-WS 소비자에서 스키마 유효성 검사를 활성화하려면 jaxws:client 요소(예:)의 jaxws:properties 하위 요소에서 schema-validation-enabled 속성을 설정합니다.
<jaxws:client name="{http://apache.org/hello_world_soap_http}SoapPort"
createdFromAPI="true">
<jaxws:properties>
<entry key="schema-validation-enabled" value="BOTH" />
</jaxws:properties>
</jaxws:client>
schema-validation-enabled 속성의 허용되는 값 목록은 24.3.4.7절. “스키마 유효성 검사 유형 값” 을 참조하십시오.
