17.2. 소비자 끝점 구성
17.2.1. 개요
Cryostat-WS 소비자 끝점은 jaxws:client 요소를 사용하여 구성됩니다. 요소의 속성은 소비자를 생성하는 데 필요한 기본 정보를 제공합니다.
WS-RM과 같은 다른 기능을 소비자에 추가하려면 jaxws:client 요소에 하위 기능을 추가합니다. 하위 요소는 끝점의 로깅 동작을 구성하고 다른 속성을 끝점 구현에 삽입하는 데도 사용됩니다.
17.2.2. 기본 구성 속성
표 17.4. “Cryostat-WS 소비자를 구성하는 데 사용되는 속성” 에 설명된 속성은 Cryostat-WS 소비자를 구성하는 데 필요한 기본 정보를 제공합니다. 구성할 특정 속성에 대한 값만 제공해야 합니다. 대부분의 속성에는 합리적인 기본값이 있거나 끝점 계약에서 제공하는 정보를 사용합니다.
| 속성 | 설명 |
|---|---|
| 소비자가 요청할 끝점의 HTTP 주소를 지정합니다. 이 값은 계약에 설정된 값을 재정의합니다. | |
| 소비자가 사용하는 메시지 바인딩의 ID를 지정합니다. 유효한 바인딩 ID 목록은 23장. Apache CXF 바인딩 ID 에 제공됩니다. | |
| 엔드포인트를 관리하는 버스를 구성하는 Spring 8080의 ID를 지정합니다. | |
|
소비자가 요청하는 서비스에 대한 | |
|
소비자가 요청하는 서비스에 대한 | |
| 간단한 사용자 이름/암호 인증에 사용되는 사용자 이름을 지정합니다. | |
| 간단한 사용자 이름/암호 인증에 사용되는 암호를 지정합니다. | |
| 서비스 엔드포인트 인터페이스(SEI)의 이름을 지정합니다. | |
| 끝점의 WSDL 계약 위치를 지정합니다. WSDL 계약의 위치는 클라이언트가 배포된 폴더를 기준으로 합니다. | |
|
소비자가 요청하는 서비스에 대한 | |
|
8080이 추상 8080인지 여부를 지정합니다. 추상 빈은 구체적인 8080 정의에 대해 상위 역할을 하며 인스턴스화되지 않습니다. 기본값은 | |
| 끝점이 인스턴스화되기 전에 인스턴스화되는 경우 종속되는 빈 목록을 지정합니다. | |
|
사용자가
기본값은
이 값을
|
표 17.4. “Cryostat-WS 소비자를 구성하는 데 사용되는 속성” 에 나열된 속성 외에도 여러 xmlns:shortName속성을 사용하여 속성에 사용되는 네임스페이스를 선언해야 할 수 있습니다.
endpointName 및 serviceName
17.2.3. 기능 추가
기능을 소비자에 추가하거나 고급 구성을 수행하려면 구성에 하위 요소를 추가해야 합니다.
자식 요소는 다음을 수행할 수 있도록 합니다.
표 17.5. “소비자 끝점 구성을 위한 요소” Cryostat-WS 소비자를 구성하는 데 사용할 수 있는 하위 요소에 대해 설명합니다.
| element | 설명 |
|---|---|
|
엔드포인트에서 사용하는 메시지 바인딩을 구성하는 polkit을 지정합니다. 메시지 바인딩은 | |
|
끝점에서 사용하는 데이터 바인딩을 구현하는 클래스를 지정합니다. 포함된 8080 정의를 사용하여 이를 지정합니다. CryostatB 데이터 바인딩을 구현하는 클래스는 | |
| Apache CXF의 고급 기능을 구성하는 빈 목록을 지정합니다. Quarkus 참조 목록 또는 포함된 빈 목록을 제공할 수 있습니다. | |
| 메시지 처리를 위한 Cryostat-WS Handler 구현 목록을 지정합니다. Cryostat-WS Handler 구현의 자세한 내용은 43장. 처리기 작성 에서 참조하십시오. | |
| 인바운드 응답을 처리하는 인터셉터 목록을 지정합니다. 자세한 내용은 VII 부. Apache CXF Interceptors 개발 에서 참조하십시오. | |
| 인바운드 오류 메시지를 처리하는 인터셉터 목록을 지정합니다. 자세한 내용은 VII 부. Apache CXF Interceptors 개발 에서 참조하십시오. | |
| 아웃바운드 요청을 처리하는 인터셉터 목록을 지정합니다. 자세한 내용은 VII 부. Apache CXF Interceptors 개발 에서 참조하십시오. | |
| 아웃바운드 오류 메시지를 처리하는 인터셉터 목록을 지정합니다. 자세한 내용은 VII 부. Apache CXF Interceptors 개발 에서 참조하십시오. | |
| 끝점에 전달되는 속성의 맵을 지정합니다. | |
|
클라이언트가 사용할 org.apache.cxf.endpoint.ConduitSelector 구현을 지정합니다. ConduitSelector 구현에서는 아웃바운드 요청을 처리하는 데 사용되는 | |
[a]
Cryostat 바인딩은 soap:soapBinding 8080을 사용하여 구성됩니다.
| |
17.2.4. 예
예 17.5. “간단한 소비자 구성” 간단한 소비자 구성을 표시합니다.
예 17.5. 간단한 소비자 구성
<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. Cryostat-WS 소비자에서 스키마 유효성 검사를 활성화
Cryostat-WS 소비자에서 스키마 검증을 활성화하려면 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절. “스키마 유효성 검사 유형 값” 를 참조하십시오.
