cxf: 구성 요소는 CXF에서 호스팅되는ECDHE-WS 서비스에 연결하기 위한 Apache CXF 와의 통합을 제공합니다.
Maven 사용자는 이 구성 요소에 대해 다음 종속성을 pom.xml 에 추가해야 합니다.
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-cxf</artifactId>
<version>x.x.x</version>
<!-- use the same version as your Camel core version -->
</dependency>
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-cxf</artifactId>
<version>x.x.x</version>
<!-- use the same version as your Camel core version -->
</dependency>
Copy to ClipboardCopied!Toggle word wrapToggle overflow
SEI(Service Endpoint Interface) 클래스의 이름입니다. 이 클래스에는 have, but does not require,0:0181 주석이 있을 수 있습니다. 2.0부터는 이 옵션은ECDHE 모드에서만 필요합니다. wsdlURL 옵션이 제공되면 PAYLOAD 및 MESSAGE 모드에 serviceClass가 필요하지 않습니다. serviceClass 없이 wsdlURL 옵션을 사용하면 serviceName 및 portName( Spring 구성의 endpointName) 옵션이 제공됩니다.
2.0이므로 \# 표기법을 사용하여 레지스트리에서 serviceClass 개체 인스턴스를 참조할 수 있습니다.
참조된 오브젝트는 Spring AOP Proxy의 Object.getClass().getName() 메서드를 사용하므로 프록시(Spring AOP Proxy is OK)일 수 없습니다.
2.8 이후 PAYLOAD 및 MESSAGE 모드에 대한 wsdlURL 및 serviceClass 옵션을 둘 다 생략할 수 있습니다. 생략하면 임의의 XML 요소를 PAYLOAD 모드에서 CxfPayload의 본문에 배치하여 CXF Dispatch Mode를 원활하게 수행할 수 있습니다.
예: org.apache.camel.Hello
serviceName
WSDL에 둘 이상의 serviceName 이 있는 경우에만
이 서비스가 구현 중인 서비스 이름은 wsdl:service@name 에 매핑됩니다. 예를 들면 다음과 같습니다.
{http://org.apache.camel}ServiceName
endpointName
serviceName 아래에 두 개 이상의 portName 이 있고 camel 2.2 이후 camel-cxf 소비자에 필요한 경우에만
이 서비스가 구현 중인 포트 이름은 wsdl:port@name 에 매핑됩니다. 예를 들면 다음과 같습니다.
{http://org.apache.camel}PortName
dataFormat
없음
다음 중 CXF 엔드포인트에서 지원하는 메시지 데이터 형식은 무엇입니까. 가능한 값은:ECDHE ( 기본값 ), PAYLOAD,MESSAGE 입니다.
relayHeaders
없음
CXF 엔드포인트가 경로를 따라 헤더를 릴레이하는지를 정의합니다. “relayHeaders 옵션 설명”을 참조하십시오. 현재 dataFormat=POJO기본값인 경우에만 사용할 수 있습니다.true예:true,false
래핑
없음
다음 중 CXF 끝점 프로듀서에서 호출하는 작업은 무엇입니까. 가능한 값은 true,false(기본값)입니다.
wrappedStyle
없음
2.5.0부터 매개 변수의 표시 방법을 설명하는 WSDL 스타일입니다. If the value is false, CXF chooses the document-literal unwrapped style, If the value is true, CXF chooses the document-literal wrapped style
setDefaultBus
없음
deprecated: 이 끝점에 기본 CXF 버스를 사용할지 여부를 지정합니다. 가능한 값은 true,false(기본값)입니다. 이 옵션은 더 이상 사용되지 않습니다. Camel 2.16 이후의 defaultBus 를 사용합니다.
defaultBus
없음
deprecated: 이 끝점에 기본 CXF 버스를 사용할지 여부를 지정합니다. 가능한 값은 true,false(기본값)입니다. 이 옵션은 더 이상 사용되지 않습니다. Camel 2.16 이후의 defaultBus 를 사용합니다.
bus
없음
\# 표기법을 사용하여 registryquery- procedure의 버스 오브젝트를 참조합니다(예: bus=\#busName ). 참조된 오브젝트는 org.apache.cxf.Bus 의 인스턴스여야 합니다.
기본적으로 는 CXF BusECDHE에 의해 생성된 기본 버스를 사용합니다.
cxfBinding
없음
\# 표기법을 사용하여 registryhour- procedure에서 CXF 바인딩 오브젝트를 참조합니다(예: cxfBinding=\#bindingName ). 참조된 오브젝트는 org.apache.camel.component.cxf.CxfBinding 의 인스턴스여야 합니다.
headerFilterStrategy
없음
\# 표기법을 사용하여 registryfu-fufor(예: headerFilterStrategy=\#strategyName )의 헤더 필터 전략 오브젝트를 참조합니다. 참조된 오브젝트는 org.apache.camel.spi.HeaderFilterStrategy 의 인스턴스여야 합니다.
loggingFeatureEnabled
없음
2.3의 새로운 기능인 이 옵션을 사용하면 인바운드 및 아웃바운드ECDHE 메시지를 기록하는 CXF Logging 기능을 사용할 수 있습니다. 가능한 값은 true,false(기본값)입니다.
defaultOperationName
없음
2.4의 새로운 기능인 이 옵션은 원격 서비스를 호출하는 CxfProducer 에서 사용하는 기본 operationName 을 설정합니다. 예를 들면 다음과 같습니다.
defaultOperationName=greetMe
defaultOperationNamespace
없음
2.4의 새로운 기능인 이 옵션은 원격 서비스를 호출하는 CxfProducer에서 사용하는 기본 operationNamespace를 설정합니다. 예를 들면 다음과 같습니다.
2.5의 새로운 기능인 이 옵션을 사용하면 CXF 엔드포인트가 동기화 또는 비동기 API를 사용하여 기본 작업을 수행할 수 있습니다. 기본값은 false 입니다. 즉 camel-cxf 끝점에서 기본적으로 async API를 사용하려고 합니다.
publishedEndpointUrl
없음
2.5의 새로운 기능인 이 옵션은 서비스 주소 URL과 ?wsdl 을 사용하여 액세스하는 게시된 WSDL에 표시되는 끝점 URL을 덮어씁니다. 예를 들면 다음과 같습니다.
publshedEndpointUrl=http://example.com/service
properties.propName
없음
Camel 2.8: 엔드포인트 URI에 사용자 지정 CXF 속성을 설정할 수 있습니다. 예를 들어, MTOM을 사용하도록 properties.mtom-enabled=true 를 설정합니다. CXF가 호출을 시작할 때 스레드를 전환하지 않도록 하려면 properties.org.apache.cxf.interceptor.OneWayProcessorInterceptor.USE_ORIGINAL_THREAD=true 를 설정할 수 있습니다.
allowStreaming
없음
2.8.2의 새로운 기능 이 옵션은 PAYLOAD 모드에서 실행할 때 CXF 구성 요소가 (아래 참조)로 수신되는 메시지를 구문 분석하는지 또는 경우에 따라 스트리밍을 허용하는 javax.xml.transform.Source 개체로 페이로드를 유지합니다.
skipFaultLogging
없음
2.11의 새로운 기능 이 옵션은 단계Interceptorchain이 catch하는 Fult 로깅을 건너뛰는지 여부를 제어합니다.
cxfEndpointConfigurer
없음
Camel 2.11 의 새로운 기능. 이 옵션은 프로그래밍 방식으로 CXF 끝점을 구성하도록 지원하는 org.apache.camel.component.cxffEndpointConfigurer 구현을 적용할 수 있습니다. Camel 2.15.0 부터 사용자는 CxfEndpointConfigurer 의 configure{Server/Client} 방법을 구현하여 CXF 서버 및 클라이언트를 구성할 수 있습니다.
사용자 이름
없음
Camel 2.12.3 의 새로운 기능 이 옵션은 CXF 클라이언트의 사용자 이름의 기본 인증 정보를 설정하는 데 사용됩니다.
암호
없음
Camel 2.12.3 의 새로운 기능 이 옵션은 CXF 클라이언트의 암호의 기본 인증 정보를 설정하는 데 사용됩니다.
continuationTimeout
없음
Camel 2.14.0 의 새로운 기능 이 옵션은 CXF 서버가ECDHEty 또는 Servlet 전송을 사용하는 경우 기본적으로 CxfConsumer에서 사용할 수 있는 CXF 연속 타임아웃을 설정하는 데 사용됩니다. ( Camel 2.14.0 이전에 CxfConsumer는 연속 시간 초과를 0으로 설정했습니다. 이는 지속적인 일시 중지 작업이 시간 초과되지 않음을 의미합니다.)
기본값: 30000 예: Continuation=80000
serviceName 및 portName 은 QNames 이므로, 제공한 경우 위의 예제와 같이 {namespace} 로 접두사를 붙여야 합니다.
DestinationRules(이전 Java 오브젝트 설명)는 대상 서버에서 호출되는 메서드에 대한 Java 매개변수입니다. Protocol 및 LogicalECDHE-WS 핸들러가 모두 지원됩니다.
PAYLOAD
PAYLOAD 는 CXF 끝점의 메시지 구성이 적용된 후 메시지 페이로드( soap:body의 콘텐츠)입니다. ProtocolECDHE-WS 핸들러만 지원됩니다. 논리ECDHE-WS 처리기는 지원되지 않습니다.
MESSAGE
MESSAGE 는 전송 계층에서 수신되는 원시 메시지입니다. Stream을 만거나 변경하는 것으로 간주하지는 않지만, 이러한 종류의 DataFormat을 사용하는 경우 일부 CXF 인터셉터는 제거되므로 camel-cxf 소비자 및ECDHE-WS 처리기는 지원되지 않습니다.
CXF_MESSAGE
Camel 2.8.2 의 새로운 기능인CXF_MESSAGE 를 사용하면 전송 계층에서 원시ECDHE 메시지로 메시지를 변환하여 CXF 인터셉터의 모든 기능을 호출할 수 있습니다.
교환 속성 CamelCXFDataFormat 을 검색하여 교환의 데이터 형식 모드를 결정할 수 있습니다. 교환 키 상수는 org.apache.camel.component.cxf.CxfConstants.DATA_FORMAT_PROPERTY 에 정의되어 있습니다.
CXF의 LoggingOutInterceptor 는 로깅 시스템(Java.util.logging )으로 전달되는 아웃바운드 메시지를 출력합니다.LoggingOutInterceptor 는 PRE_STREAM 단계 (하지만 PRE_STREAM 단계는 MESSAGE 모드에서 제거)에 있으므로 WRITE 단계에서 실행하도록 LoggingOutInterceptor 를 구성해야 합니다. 다음은 예제입니다.
<bean id="loggingOutInterceptor" class="org.apache.cxf.interceptor.LoggingOutInterceptor">
<!-- it really should have been user-prestream but CXF does have such phase! -->
<constructor-arg value="target/write"/>
</bean>
<cxf:cxfEndpoint id="serviceEndpoint" address="http://localhost:9002/helloworld"
serviceClass="org.apache.camel.component.cxf.HelloService">
<cxf:outInterceptors>
<ref bean="loggingOutInterceptor"/>
</cxf:outInterceptors>
<cxf:properties>
<entry key="dataFormat" value="MESSAGE"/>
</cxf:properties>
</cxf:cxfEndpoint>
<bean id="loggingOutInterceptor" class="org.apache.cxf.interceptor.LoggingOutInterceptor">
<!-- it really should have been user-prestream but CXF does have such phase! -->
<constructor-arg value="target/write"/>
</bean>
<cxf:cxfEndpoint id="serviceEndpoint" address="http://localhost:9002/helloworld"
serviceClass="org.apache.camel.component.cxf.HelloService">
<cxf:outInterceptors>
<ref bean="loggingOutInterceptor"/>
</cxf:outInterceptors>
<cxf:properties>
<entry key="dataFormat" value="MESSAGE"/>
</cxf:properties>
</cxf:cxfEndpoint>
Copy to ClipboardCopied!Toggle word wrapToggle overflow
relayHeaders=true 설정은 헤더를 릴레이하려는 의도를 나타냅니다. 지정된 헤더가 중계되었는지 여부에 대한 실제 결정은 MessageHeadersRelay 인터페이스를 구현하는 플러그 가능한 인스턴스에 위임됩니다. MessageHeadersRelay 의 공식 구현은 헤더를 중계해야 하는지 여부를 결정하기 위해 참조됩니다. 자체적으로 잘 알려진ECDHE 네임스페이스에 바인딩하는 SoapMessageHeadersRelay 구현이 이미 있습니다. 현재 대역 외 헤더만 필터링되고 대역 내 헤더는 relayHeaders=true 인 경우 항상 중계됩니다. 해당 네임스페이스가 런타임에 알 수 없는 헤더가 있는 경우 대체 DefaultMessageHeadersRelay 가 사용됩니다. 이로 인해 모든 헤더가 중계될 수 있습니다.
relayHeaders=false 설정은 모든 헤더(in-band 및 out-of-band)가 삭제됨을 주장합니다.
고유한 MessageHeadersRelay 구현을 재정의하거나 릴레이 목록에 추가 항목을 추가할 수 있습니다. 사전 로드된 릴레이 인스턴스를 재정의하려면 MessageHeadersRelay 구현 서비스가 재정의하려는 네임스페이스와 동일한 네임스페이스를 필터링하는지 확인하십시오. 또한 재정의 릴레이는 재정의하려는 네임스페이스를 모두 서비스해야 하거나, 경로 시작 시 런타임 예외가 발생하므로 인스턴스 매핑을 릴레이하는 네임스페이스에 모호성이 발생합니다.
ECDHE 및 PAYLOAD 모드가 지원됩니다. IRQ 모드에서 대역 외 메시지 헤더만 필터링에 사용할 수 있습니다. 대역 내 헤더가 처리되어 CXF의 헤더 목록에서 제거되었기 때문입니다. 대역 내 헤더가ECDHE 모드의 MessageContentList 에 통합되어 있습니다. camel-cxf 구성 요소는 대역 내 헤더의 필터링이 필요한 경우 MessageContentList 에서 대역 내 헤더를 제거하려고 하는 경우 PAYLOAD 모드를 사용하거나 (pretty Simple) CXF 인터셉터/JAXWS Handler를 CXF 엔드포인트에 연결하십시오.
Message Header Relay 메커니즘이 CxfHeaderFilterStrategy 로 병합되었습니다. relayHeaders 옵션, 해당 의미 체계 및 기본값은 동일하게 유지되지만 CxfHeaderFilterStrategy 의 속성입니다. 다음은 구성 예제입니다.
<bean id="dropAllMessageHeadersStrategy" class="org.apache.camel.component.cxf.common.header.CxfHeaderFilterStrategy">
<!-- Set relayHeaders to false to drop all SOAP headers -->
<property name="relayHeaders" value="false"/>
</bean>
<bean id="dropAllMessageHeadersStrategy" class="org.apache.camel.component.cxf.common.header.CxfHeaderFilterStrategy">
<!-- Set relayHeaders to false to drop all SOAP headers -->
<property name="relayHeaders" value="false"/>
</bean>
Copy to ClipboardCopied!Toggle word wrapToggle overflow
Copy to ClipboardCopied!Toggle word wrapToggle overflow
MessageHeadersRelay 인터페이스가 약간 변경되었으며 이름이 MessageHeaderFilter 로 변경되었습니다. 이는 CxfHeaderFilterStrategy 의 속성입니다. 다음은 사용자 정의 메시지 헤더 필터 구성의 예입니다.
<bean id="customMessageFilterStrategy" class="org.apache.camel.component.cxf.common.header.CxfHeaderFilterStrategy">
<property name="messageHeaderFilters">
<list>
<!-- SoapMessageHeaderFilter is the built in filter. It can be removed by omitting it. -->
<bean class="org.apache.camel.component.cxf.common.header.SoapMessageHeaderFilter"/>
<!-- Add custom filter here -->
<bean class="org.apache.camel.component.cxf.soap.headers.CustomHeaderFilter"/>
</list>
</property>
</bean>
<bean id="customMessageFilterStrategy" class="org.apache.camel.component.cxf.common.header.CxfHeaderFilterStrategy">
<property name="messageHeaderFilters">
<list>
<!-- SoapMessageHeaderFilter is the built in filter. It can be removed by omitting it. -->
<bean class="org.apache.camel.component.cxf.common.header.SoapMessageHeaderFilter"/>
<!-- Add custom filter here -->
<bean class="org.apache.camel.component.cxf.soap.headers.CustomHeaderFilter"/>
</list>
</property>
</bean>
Copy to ClipboardCopied!Toggle word wrapToggle overflow
relayHeaders 외에도 CxfHeaderFilterStrategy 에서 구성할 수 있는 새 속성이 있습니다.
Expand
이름
설명
type
필수 여부
기본값
relayHeaders
모든 메시지 헤더는 메시지 헤더 필터에서 처리
boolean
없음
true (1.6.1 동작)
relayAllMessageHeaders
모든 메시지 헤더가 전파됩니다(Message Header Filters로 처리하지 않음)
boolean
없음
False (1.6.1 동작)
allowFilterNamespaceClash
활성화 네임스페이스에서 중복된 필터 처리. 값이 true 인 경우 마지막 값이 우선합니다. 값이 false 인 경우 예외가 발생합니다.
아래 표시된 Spring 구성 파일을 사용하여 CXF 끝점을 구성할 수 있으며, 끝점을 camelContext 태그에 포함할 수도 있습니다. 서비스 끝점을 호출할 때 operationName 및 operationNamespace 헤더를 설정하여 호출 중인 작업을 명시적으로 상태 지정할 수 있습니다.
rootECDHEs 요소에 지정된ECDHE-WS schemaLocation 특성을 포함해야 합니다. 이를 통해 CXF는 파일의 유효성을 검증할 수 있으며 필수 항목입니다. 또한 결합된 {namespace}localName 구문이 이 태그의 속성 값에 대해 지원되지 않기 때문에 < cxf:cxfEndpoint/ > tag-]의 끝에 네임스페이스 선언이 필요합니다.
cxf:cxfEndpoint 요소는 다음과 같은 여러 추가 속성을 지원합니다.
Expand
이름
현재의
PortName
이 서비스가 구현 중인 끝점 이름, wsdl:port@name 에 매핑됩니다. ns:PORT_NAME 형식에서 여기서 ns 는 이 범위에서 유효한 네임스페이스 접두사입니다.
serviceName
이 서비스가 구현 중인 서비스 이름은 wsdl:service@name 에 매핑됩니다. ns:SERVICE_NAME 형식에서 ns 는 이 범위에서 유효한 네임스페이스 접두사입니다.
wsdlURL
WSDL의 위치입니다. classpath, 파일 시스템에 있거나 원격으로 호스팅할 수 있습니다.
bindingId
사용할 서비스 모델의 bindingId 입니다.
address
서비스는 주소를 게시합니다.
bus
DestinationRule-WS 엔드포인트에서 사용되는 버스 이름입니다.
serviceClass
SEI(Service Endpoint Interface) 클래스의 클래스 이름(Service Endpoint Interface) 클래스는 annotations181이 될 수도 있고 없을 수도 있습니다.
또한 여러 자식 요소를 지원합니다.
Expand
이름
현재의
cxf:inInterceptors
이 끝점에 대한 들어오는 인터셉터입니다. < bean> 또는 < ref& gt;의 목록입니다.
cxf:inFaultInterceptors
이 끝점에 대한 들어오는 오류 인터셉터입니다. < bean> 또는 < ref& gt;의 목록입니다.
cxf:outInterceptors
이 끝점에 대한 발신 인터셉터입니다. < bean> 또는 < ref& gt;의 목록입니다.
cxf:outFaultInterceptors
이 끝점의 발신 오류 인터셉터입니다. < bean> 또는 < ref& gt;의 목록입니다.
CXF:properties
DestinationRule-WS 엔드포인트에 제공하는 속성 맵입니다.
CXF:handlers
ECDHE-WS 엔드포인트에 제공할ECDHE-WS 핸들러 목록입니다.
cxf:dataBinding
끝점에서 사용할 DataBinding 을 지정할 수 있습니다. 이는 Spring < bean class="MyDataBinding"/ > 구문을 사용하여 제공할 수 있습니다.
CXF:binding
이 끝점에 사용할 BindingECDHEy 를 지정할 수 있습니다. 이 값은 Spring < bean class="MyBindingECDHEy"/ > 구문을 사용하여 제공할 수 있습니다.
CXF: 기능
이 끝점의 인터셉터를 보유하는 기능입니다. < bean> s 또는 < ref> s의 목록
cxf:schemaLocations
사용할 끝점의 스키마 위치입니다. < schemaLocation> s목록
cxf:serviceFactory
이 끝점이 사용할 서비스 팩토리입니다. 이는 Spring < bean class="MyServiceECDHEy"/ > 구문을 사용하여 제공할 수 있습니다.
CXF의 기본 로거는 java.util.logging 입니다. log4j 로 변경하려면 다음과 같이 진행합니다. 클래스 경로에 META-INF/cxf/org.apache.cxf.logger 라는 파일을 생성합니다. 이 파일에는 주석 없이 한 줄에 org.apache.cxf.common.logging.Log4jLogger 의 정규화된 이름이 포함되어야 합니다.
PHP와 같은 일부ECDHE 클라이언트를 사용하는 경우 CXF가 XML 시작 문서 < ?xml version="1.0" encoding="utf-8"?>을 추가하지 않기 때문에 이러한 종류의 오류가 발생할 수 있습니다.
Error:sendSms: SoapFault exception: [Client] looks like we got no XML document in [...]
Error:sendSms: SoapFault exception: [Client] looks like we got no XML document in [...]
Copy to ClipboardCopied!Toggle word wrapToggle overflow
이 문제를 해결하려면usrxOutInterceptor에 XML 시작 문서를 작성하도록 지시하기만 하면 됩니다.
public class WriteXmlDeclarationInterceptor extends AbstractPhaseInterceptor<SoapMessage> {
public WriteXmlDeclarationInterceptor() {
super(Phase.PRE_STREAM);
addBefore(StaxOutInterceptor.class.getName());
}
public void handleMessage(SoapMessage message) throws Fault {
message.put("org.apache.cxf.stax.force-start-document", Boolean.TRUE);
}
}
public class WriteXmlDeclarationInterceptor extends AbstractPhaseInterceptor<SoapMessage> {
public WriteXmlDeclarationInterceptor() {
super(Phase.PRE_STREAM);
addBefore(StaxOutInterceptor.class.getName());
}
public void handleMessage(SoapMessage message) throws Fault {
message.put("org.apache.cxf.stax.force-start-document", Boolean.TRUE);
}
}
Copy to ClipboardCopied!Toggle word wrapToggle overflow
이와 같은 고객 인터셉터를 추가하고 camel-cxf endpont로 구성할 수 있습니다.
<cxf:cxfEndpoint id="routerEndpoint" address="http://localhost:${CXFTestSupport.port2}/CXFGreeterRouterTest/CamelContext/RouterPort"
serviceClass="org.apache.hello_world_soap_http.GreeterImpl"
skipFaultLogging="true">
<cxf:outInterceptors>
<!-- This interceptor forces the CXF server send the XML start document to client -->
<bean class="org.apache.camel.component.cxf.WriteXmlDeclarationInterceptor"/>
</cxf:outInterceptors>
<cxf:properties>
<!-- Set the publishedEndpointUrl which could override the service address from generated WSDL as you want -->
<entry key="publishedEndpointUrl" value="http://www.simple.com/services/test" />
</cxf:properties>
</cxf:cxfEndpoint>
<cxf:cxfEndpoint id="routerEndpoint" address="http://localhost:${CXFTestSupport.port2}/CXFGreeterRouterTest/CamelContext/RouterPort"
serviceClass="org.apache.hello_world_soap_http.GreeterImpl"
skipFaultLogging="true">
<cxf:outInterceptors>
<!-- This interceptor forces the CXF server send the XML start document to client -->
<bean class="org.apache.camel.component.cxf.WriteXmlDeclarationInterceptor"/>
</cxf:outInterceptors>
<cxf:properties>
<!-- Set the publishedEndpointUrl which could override the service address from generated WSDL as you want -->
<entry key="publishedEndpointUrl" value="http://www.simple.com/services/test" />
</cxf:properties>
</cxf:cxfEndpoint>
Copy to ClipboardCopied!Toggle word wrapToggle overflow
Camel 2.4 를 사용하는 경우 다음과 같이 메시지 헤더를 추가할 수도 있습니다.
// set up the response context which force start document
Map<String, Object> map = new HashMap<String, Object>();
map.put("org.apache.cxf.stax.force-start-document", Boolean.TRUE);
exchange.getOut().setHeader(Client.RESPONSE_CONTEXT, map);
// set up the response context which force start document
Map<String, Object> map = new HashMap<String, Object>();
map.put("org.apache.cxf.stax.force-start-document", Boolean.TRUE);
exchange.getOut().setHeader(Client.RESPONSE_CONTEXT, map);
Copy to ClipboardCopied!Toggle word wrapToggle overflow
camel-cxf 끝점 소비자ECDHE 데이터 형식은 cxf 호출자 를 기반으로 하므로 메시지 헤더에는 CxfConstants.OPERATION_NAME 이라는 속성이 있고 메시지 본문은 SEI 메서드 매개변수 목록입니다.
public class PersonProcessor implements Processor {
private static final transient Logger LOG = LoggerFactory.getLogger(PersonProcessor.class);
@SuppressWarnings("unchecked")
public void process(Exchange exchange) throws Exception {
LOG.info("processing exchange in camel");
BindingOperationInfo boi = (BindingOperationInfo)exchange.getProperty(BindingOperationInfo.class.toString());
if (boi != null) {
LOG.info("boi.isUnwrapped" + boi.isUnwrapped());
}
// Get the parameters list which element is the holder.
MessageContentsList msgList = (MessageContentsList)exchange.getIn().getBody();
Holder<String> personId = (Holder<String>)msgList.get(0);
Holder<String> ssn = (Holder<String>)msgList.get(1);
Holder<String> name = (Holder<String>)msgList.get(2);
if (personId.value == null || personId.value.length() == 0) {
LOG.info("person id 123, so throwing exception");
// Try to throw out the soap fault message
org.apache.camel.wsdl_first.types.UnknownPersonFault personFault =
new org.apache.camel.wsdl_first.types.UnknownPersonFault();
personFault.setPersonId("");
org.apache.camel.wsdl_first.UnknownPersonFault fault =
new org.apache.camel.wsdl_first.UnknownPersonFault("Get the null value of person name", personFault);
// Since camel has its own exception handler framework, we can't throw the exception to trigger it
// We just set the fault message in the exchange for camel-cxf component handling and return
exchange.getOut().setFault(true);
exchange.getOut().setBody(fault);
return;
}
name.value = "Bonjour";
ssn.value = "123";
LOG.info("setting Bonjour as the response");
// Set the response message, first element is the return value of the operation,
// the others are the holders of method parameters
exchange.getOut().setBody(new Object[] {null, personId, ssn, name});
}
}
public class PersonProcessor implements Processor {
private static final transient Logger LOG = LoggerFactory.getLogger(PersonProcessor.class);
@SuppressWarnings("unchecked")
public void process(Exchange exchange) throws Exception {
LOG.info("processing exchange in camel");
BindingOperationInfo boi = (BindingOperationInfo)exchange.getProperty(BindingOperationInfo.class.toString());
if (boi != null) {
LOG.info("boi.isUnwrapped" + boi.isUnwrapped());
}
// Get the parameters list which element is the holder.
MessageContentsList msgList = (MessageContentsList)exchange.getIn().getBody();
Holder<String> personId = (Holder<String>)msgList.get(0);
Holder<String> ssn = (Holder<String>)msgList.get(1);
Holder<String> name = (Holder<String>)msgList.get(2);
if (personId.value == null || personId.value.length() == 0) {
LOG.info("person id 123, so throwing exception");
// Try to throw out the soap fault message
org.apache.camel.wsdl_first.types.UnknownPersonFault personFault =
new org.apache.camel.wsdl_first.types.UnknownPersonFault();
personFault.setPersonId("");
org.apache.camel.wsdl_first.UnknownPersonFault fault =
new org.apache.camel.wsdl_first.UnknownPersonFault("Get the null value of person name", personFault);
// Since camel has its own exception handler framework, we can't throw the exception to trigger it
// We just set the fault message in the exchange for camel-cxf component handling and return
exchange.getOut().setFault(true);
exchange.getOut().setBody(fault);
return;
}
name.value = "Bonjour";
ssn.value = "123";
LOG.info("setting Bonjour as the response");
// Set the response message, first element is the return value of the operation,
// the others are the holders of method parameters
exchange.getOut().setBody(new Object[] {null, personId, ssn, name});
}
}
Copy to ClipboardCopied!Toggle word wrapToggle overflow
camel-cxf 끝점 생산자는 cxf 클라이언트 API 를 기반으로 합니다. 먼저 message 헤더에 작업 이름을 지정하고 메서드 매개변수를 목록에 추가하고 이 매개변수 목록으로 메시지를 초기화해야 합니다. 응답 메시지의 본문은 messageContentsList 이며 해당 목록에서 결과를 가져올 수 있습니다.
메시지 헤더에 작업 이름을 지정하지 않으면 CxfProducer 는 CxfEndpoint 에서 defaultOperationName 을 사용하려고 합니다. CxfEndpoint 에 defaultOperationName 이 설정되지 않은 경우 작업 목록에서 첫 번째 작업 이름을 선택합니다.
메시지 본문에서 개체 배열을 가져오려면 다음과 같이 message.getbody(Object[].class) 를 사용하여 본문을 가져올 수 있습니다.
Exchange senderExchange = new DefaultExchange(context, ExchangePattern.InOut);
final List<String> params = new ArrayList<String>();
// Prepare the request message for the camel-cxf procedure
params.add(TEST_MESSAGE);
senderExchange.getIn().setBody(params);
senderExchange.getIn().setHeader(CxfConstants.OPERATION_NAME, ECHO_OPERATION);
Exchange exchange = template.send("direct:EndpointA", senderExchange);
org.apache.camel.Message out = exchange.getOut();
// The response message's body is an MessageContentsList which first element is the return value of the operation,
// If there are some holder parameters, the holder parameter is filled in the reset of List.
// The result is extract from the MessageContentsList with the String class type
MessageContentsList result = (MessageContentsList)out.getBody();
LOG.info("Received output text: " + result.get(0));
Map<String, Object> responseContext = CastUtils.cast((Map<?, ?>)out.getHeader(Client.RESPONSE_CONTEXT));
assertNotNull(responseContext);
assertEquals("The response context", "UTF-8", responseContext.get(org.apache.cxf.message.Message.ENCODING));
assertEquals("Reply body on Camel is wrong", "echo " + TEST_MESSAGE, result.get(0));
Exchange senderExchange = new DefaultExchange(context, ExchangePattern.InOut);
final List<String> params = new ArrayList<String>();
// Prepare the request message for the camel-cxf procedure
params.add(TEST_MESSAGE);
senderExchange.getIn().setBody(params);
senderExchange.getIn().setHeader(CxfConstants.OPERATION_NAME, ECHO_OPERATION);
Exchange exchange = template.send("direct:EndpointA", senderExchange);
org.apache.camel.Message out = exchange.getOut();
// The response message's body is an MessageContentsList which first element is the return value of the operation,
// If there are some holder parameters, the holder parameter is filled in the reset of List.
// The result is extract from the MessageContentsList with the String class type
MessageContentsList result = (MessageContentsList)out.getBody();
LOG.info("Received output text: " + result.get(0));
Map<String, Object> responseContext = CastUtils.cast((Map<?, ?>)out.getHeader(Client.RESPONSE_CONTEXT));
assertNotNull(responseContext);
assertEquals("The response context", "UTF-8", responseContext.get(org.apache.cxf.message.Message.ENCODING));
assertEquals("Reply body on Camel is wrong", "echo " + TEST_MESSAGE, result.get(0));
Copy to ClipboardCopied!Toggle word wrapToggle overflow
Apache Camel 2.0에서: CxfMessage.getBody() 는 org.apache.camel.component.cxf.CxfPayload 오브젝트를 반환하며, 이 오브젝트에는ECDHE 메시지 헤더 및ECDHE 요소에 대한 getECDHE이 있습니다. 이러한 변경으로 인해 Apache Camel 메시지에서 기본 CXF 메시지를 분리할 수 있습니다.
protected RouteBuilder createRouteBuilder() {
return new RouteBuilder() {
public void configure() {
from(SIMPLE_ENDPOINT_URI + "&dataFormat=PAYLOAD").to("log:info").process(new Processor() {
@SuppressWarnings("unchecked")
public void process(final Exchange exchange) throws Exception {
CxfPayload<SoapHeader> requestPayload = exchange.getIn().getBody(CxfPayload.class);
List<Source> inElements = requestPayload.getBodySources();
List<Source> outElements = new ArrayList<Source>();
// You can use a customer toStringConverter to turn a CxfPayLoad message into String as you want
String request = exchange.getIn().getBody(String.class);
XmlConverter converter = new XmlConverter();
String documentString = ECHO_RESPONSE;
Element in = new XmlConverter().toDOMElement(inElements.get(0));
// Just check the element namespace
if (!in.getNamespaceURI().equals(ELEMENT_NAMESPACE)) {
throw new IllegalArgumentException("Wrong element namespace");
}
if (in.getLocalName().equals("echoBoolean")) {
documentString = ECHO_BOOLEAN_RESPONSE;
checkRequest("ECHO_BOOLEAN_REQUEST", request);
} else {
documentString = ECHO_RESPONSE;
checkRequest("ECHO_REQUEST", request);
}
Document outDocument = converter.toDOMDocument(documentString);
outElements.add(new DOMSource(outDocument.getDocumentElement()));
// set the payload header with null
CxfPayload<SoapHeader> responsePayload = new CxfPayload<SoapHeader>(null, outElements, null);
exchange.getOut().setBody(responsePayload);
}
});
}
};
}
protected RouteBuilder createRouteBuilder() {
return new RouteBuilder() {
public void configure() {
from(SIMPLE_ENDPOINT_URI + "&dataFormat=PAYLOAD").to("log:info").process(new Processor() {
@SuppressWarnings("unchecked")
public void process(final Exchange exchange) throws Exception {
CxfPayload<SoapHeader> requestPayload = exchange.getIn().getBody(CxfPayload.class);
List<Source> inElements = requestPayload.getBodySources();
List<Source> outElements = new ArrayList<Source>();
// You can use a customer toStringConverter to turn a CxfPayLoad message into String as you want
String request = exchange.getIn().getBody(String.class);
XmlConverter converter = new XmlConverter();
String documentString = ECHO_RESPONSE;
Element in = new XmlConverter().toDOMElement(inElements.get(0));
// Just check the element namespace
if (!in.getNamespaceURI().equals(ELEMENT_NAMESPACE)) {
throw new IllegalArgumentException("Wrong element namespace");
}
if (in.getLocalName().equals("echoBoolean")) {
documentString = ECHO_BOOLEAN_RESPONSE;
checkRequest("ECHO_BOOLEAN_REQUEST", request);
} else {
documentString = ECHO_RESPONSE;
checkRequest("ECHO_REQUEST", request);
}
Document outDocument = converter.toDOMDocument(documentString);
outElements.add(new DOMSource(outDocument.getDocumentElement()));
// set the payload header with null
CxfPayload<SoapHeader> responsePayload = new CxfPayload<SoapHeader>(null, outElements, null);
exchange.getOut().setBody(responsePayload);
}
});
}
};
}
Copy to ClipboardCopied!Toggle word wrapToggle overflow
means that the data format is a list of Java objects when the CXF endpoint produces or consumes Camel transactions. Apache Camel이 이 모드에서 메시지 본문을 DestinationRules로 노출하지만 CXF 구성 요소는 여전히 읽기 및 쓰기Header 헤더에 대한 액세스를 제공합니다. 그러나 CXF 인터셉터는 헤더 목록이 처리된 후 헤더 목록에서 in-bandECDHE 헤더를 제거하기 때문에,ECDHE 모드에서는 대역 외ECDHE 헤더만 사용할 수 있습니다.
다음 예제에서는ECDHE 헤더를 가져오고 설정하는 방법을 보여줍니다. 하나의 CXF 끝점에서 다른 끝점으로 전달하는 경로가 있다고 가정합니다. 즉,Webhook 클라이언트 Apache Camel CXF 서비스입니다. 두 개의 프로세서를 첨부하여 요청이 CXF 서비스에 나가기 전에 (1)에 DestinationRule 헤더를 가져오고, (2) 응답이ECDHE Client로 다시 오기 전에 받을 수 있습니다. 이 예에서 프로세서 (1) 및(2)는 InsertRequestOutHeaderProcessor 및 InsertResponseOutHeaderProcessor입니다. 이 경로는 다음과 같습니다.
Copy to ClipboardCopied!Toggle word wrapToggle overflow
2.xECDHE 헤더에서 Apache Camel Message 헤더로 전파됩니다. Apache Camel 메시지 헤더 이름은 org.apache.cxf.headers.Header.list 이며, CXF에 정의된 상수입니다(org.apache.cxf.headers.Header.HEADER_LIST). 헤더 값은 CXF SoapHeader 오브젝트의 List <>입니다(또는g.apache.cxf.binding.soap.Soap). 다음 스니펫은 InsertResponseOutHeaderProcessor 입니다(응답 메시지에 새ECDHE 헤더를 삽입합니다). InsertResponseOutHeaderProcessor 및 InsertRequestOutHeaderProcessor 모두에서ECDHE 헤더에 액세스하는 방법은 실제로 동일합니다. 두 프로세서의 유일한 차이점은 삽입됨 header의 방향을 설정하는 것입니다.
public static class InsertResponseOutHeaderProcessor implements Processor {
@SuppressWarnings("unchecked")
public void process(Exchange exchange) throws Exception {
// If exchange is routed from camel-cxf endpoint, this is the header
List<SoapHeader> soapHeaders = CastUtils.cast((List<?>)exchange.getIn().getHeader(Header.HEADER_LIST));
if (soapHeaders == null) {
// we just create a new soap headers in case the header is null
soapHeaders = new ArrayList<SoapHeader>();
}
// Insert a new header
String xml = "<?xml version=\"1.0\" encoding=\"utf-8\"?><outofbandHeader "
+ "xmlns=\"http://cxf.apache.org/outofband/Header\" hdrAttribute=\"testHdrAttribute\" "
+ "xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\" soap:mustUnderstand=\"1\">"
+ "<name>New_testOobHeader</name><value>New_testOobHeaderValue</value></outofbandHeader>";
SoapHeader newHeader = new SoapHeader(soapHeaders.get(0).getName(),
DOMUtils.readXml(new StringReader(xml)).getDocumentElement());
// make sure direction is OUT since it is a response message.
newHeader.setDirection(Direction.DIRECTION_OUT);
//newHeader.setMustUnderstand(false);
soapHeaders.add(newHeader);
}
}
public static class InsertResponseOutHeaderProcessor implements Processor {
@SuppressWarnings("unchecked")
public void process(Exchange exchange) throws Exception {
// If exchange is routed from camel-cxf endpoint, this is the header
List<SoapHeader> soapHeaders = CastUtils.cast((List<?>)exchange.getIn().getHeader(Header.HEADER_LIST));
if (soapHeaders == null) {
// we just create a new soap headers in case the header is null
soapHeaders = new ArrayList<SoapHeader>();
}
// Insert a new header
String xml = "<?xml version=\"1.0\" encoding=\"utf-8\"?><outofbandHeader "
+ "xmlns=\"http://cxf.apache.org/outofband/Header\" hdrAttribute=\"testHdrAttribute\" "
+ "xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\" soap:mustUnderstand=\"1\">"
+ "<name>New_testOobHeader</name><value>New_testOobHeaderValue</value></outofbandHeader>";
SoapHeader newHeader = new SoapHeader(soapHeaders.get(0).getName(),
DOMUtils.readXml(new StringReader(xml)).getDocumentElement());
// make sure direction is OUT since it is a response message.
newHeader.setDirection(Direction.DIRECTION_OUT);
//newHeader.setMustUnderstand(false);
soapHeaders.add(newHeader);
}
}
Copy to ClipboardCopied!Toggle word wrapToggle overflow
CxfPayload 오브젝트를 가져오면 List ofECDHE (SOAP 헤더)를 반환하는 CxfPayload.getHeaders() 메서드를 호출할 수 있습니다.
from(getRouterEndpointURI()).process(new Processor() {
@SuppressWarnings("unchecked")
public void process(Exchange exchange) throws Exception {
CxfPayload<SoapHeader> payload = exchange.getIn().getBody(CxfPayload.class);
List<Source> elements = payload.getBodySources();
assertNotNull("Elements here", elements);
assertEquals("Get the wrong elements size", 1, elements.size());
Element el = new XmlConverter().toDOMElement(elements.get(0));
elements.set(0, new DOMSource(el));
assertEquals("Get the wrong namespace URI", "http://camel.apache.org/pizza/types",
el.getNamespaceURI());
List<SoapHeader> headers = payload.getHeaders();
assertNotNull("Headers here", headers);
assertEquals("Get the wrong headers size", headers.size(), 1);
assertEquals("Get the wrong namespace URI",
((Element)(headers.get(0).getObject())).getNamespaceURI(),
"http://camel.apache.org/pizza/types");
}
})
.to(getServiceEndpointURI());
from(getRouterEndpointURI()).process(new Processor() {
@SuppressWarnings("unchecked")
public void process(Exchange exchange) throws Exception {
CxfPayload<SoapHeader> payload = exchange.getIn().getBody(CxfPayload.class);
List<Source> elements = payload.getBodySources();
assertNotNull("Elements here", elements);
assertEquals("Get the wrong elements size", 1, elements.size());
Element el = new XmlConverter().toDOMElement(elements.get(0));
elements.set(0, new DOMSource(el));
assertEquals("Get the wrong namespace URI", "http://camel.apache.org/pizza/types",
el.getNamespaceURI());
List<SoapHeader> headers = payload.getHeaders();
assertNotNull("Headers here", headers);
assertEquals("Get the wrong headers size", headers.size(), 1);
assertEquals("Get the wrong namespace URI",
((Element)(headers.get(0).getObject())).getNamespaceURI(),
"http://camel.apache.org/pizza/types");
}
})
.to(getServiceEndpointURI());
Copy to ClipboardCopied!Toggle word wrapToggle overflow
Camel 2.16.0부터 “DestinationRule 모드에서ECDHE 헤더를 가져오고 설정하는 방법” 에 설명된 것과 동일한 접근 방식을 사용하여ECDHE 헤더를 설정하거나 가져올 수 있습니다. org.apache.cxf.headers.Header.list 헤더를 사용하여ECDHE 헤더 목록을 가져와서 설정할 수 있습니다. 즉, 하나의 Camel CXF 끝점에서 다른 (SOAP 클라이언트 Camel CXF 서비스)로 전달하는 경로가 있는 경우ECDHE 클라이언트가 전송한ECDSA 헤더도 CXF 서비스로 전달됩니다. 헤더를 전달하지 않으려면 org.apache.cxf.headers.Header.list Camel 헤더에서 해당 헤더를 제거합니다.
CXF 끝점을 사용하여ECDHE 요청을 사용하는 경우 camel 컨텍스트에서ECDHE Fult를 throw 해야 할 수 있습니다. 기본적으로 throwFault DSL을 사용하여 이러한 작업을 수행할 수 있습니다. 이 작업을 수행하는 것은PAYLOAD, MESSAGE 데이터 형식입니다. 다음과 같이 비누 오류를 정의할 수 있습니다.
SOAP_FAULT = new SoapFault(EXCEPTION_MESSAGE, SoapFault.FAULT_CODE_CLIENT);
Element detail = SOAP_FAULT.getOrCreateDetail();
Document doc = detail.getOwnerDocument();
Text tn = doc.createTextNode(DETAIL_TEXT);
detail.appendChild(tn);
SOAP_FAULT = new SoapFault(EXCEPTION_MESSAGE, SoapFault.FAULT_CODE_CLIENT);
Element detail = SOAP_FAULT.getOrCreateDetail();
Document doc = detail.getOwnerDocument();
Text tn = doc.createTextNode(DETAIL_TEXT);
detail.appendChild(tn);
Copy to ClipboardCopied!Toggle word wrapToggle overflow
Copy to ClipboardCopied!Toggle word wrapToggle overflow
CXF 끝점이 MESSAGE 데이터 형식으로 작동하는 경우 메시지 본문에ECDHE Fault 메시지를 설정하고 메시지 헤더에 응답 코드를 설정할 수 있습니다.
from(routerEndpointURI).process(new Processor() {
public void process(Exchange exchange) throws Exception {
Message out = exchange.getOut();
// Set the message body with the
out.setBody(this.getClass().getResourceAsStream("SoapFaultMessage.xml"));
// Set the response code here
out.setHeader(org.apache.cxf.message.Message.RESPONSE_CODE, new Integer(500));
}
});
from(routerEndpointURI).process(new Processor() {
public void process(Exchange exchange) throws Exception {
Message out = exchange.getOut();
// Set the message body with the
out.setBody(this.getClass().getResourceAsStream("SoapFaultMessage.xml"));
// Set the response code here
out.setHeader(org.apache.cxf.message.Message.RESPONSE_CODE, new Integer(500));
}
});
Copy to ClipboardCopied!Toggle word wrapToggle overflow
ECDHE 데이터 형식에도 마찬가지입니다. 아웃 본문에서ECDHE Fault를 설정하고 다음과 같이 Message.setFault(true) 를 호출하여 오류가 있음을 나타낼 수 있습니다.
CXF 클라이언트 API 는 요청 및 응답 컨텍스트로 작업을 호출하는 방법을 제공합니다. CXF 끝점 생산자를 사용하여 외부 웹 서비스를 호출하는 경우 요청 컨텍스트를 설정하고 다음 코드로 응답 컨텍스트를 가져올 수 있습니다.
CxfExchange exchange = (CxfExchange)template.send(getJaxwsEndpointUri(), new Processor() {
public void process(final Exchange exchange) {
final List<String> params = new ArrayList<String>();
params.add(TEST_MESSAGE);
// Set the request context to the inMessage
Map<String, Object> requestContext = new HashMap<String, Object>();
requestContext.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, JAXWS_SERVER_ADDRESS);
exchange.getIn().setBody(params);
exchange.getIn().setHeader(Client.REQUEST_CONTEXT , requestContext);
exchange.getIn().setHeader(CxfConstants.OPERATION_NAME, GREET_ME_OPERATION);
}
});
org.apache.camel.Message out = exchange.getOut();
// The output is an object array, the first element of the array is the return value
Object\[\] output = out.getBody(Object\[\].class);
LOG.info("Received output text: " + output\[0\]);
// Get the response context form outMessage
Map<String, Object> responseContext = CastUtils.cast((Map)out.getHeader(Client.RESPONSE_CONTEXT));
assertNotNull(responseContext);
assertEquals("Get the wrong wsdl opertion name", "{http://apache.org/hello_world_soap_http}greetMe",
responseContext.get("javax.xml.ws.wsdl.operation").toString());
CxfExchange exchange = (CxfExchange)template.send(getJaxwsEndpointUri(), new Processor() {
public void process(final Exchange exchange) {
final List<String> params = new ArrayList<String>();
params.add(TEST_MESSAGE);
// Set the request context to the inMessage
Map<String, Object> requestContext = new HashMap<String, Object>();
requestContext.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, JAXWS_SERVER_ADDRESS);
exchange.getIn().setBody(params);
exchange.getIn().setHeader(Client.REQUEST_CONTEXT , requestContext);
exchange.getIn().setHeader(CxfConstants.OPERATION_NAME, GREET_ME_OPERATION);
}
});
org.apache.camel.Message out = exchange.getOut();
// The output is an object array, the first element of the array is the return value
Object\[\] output = out.getBody(Object\[\].class);
LOG.info("Received output text: " + output\[0\]);
// Get the response context form outMessage
Map<String, Object> responseContext = CastUtils.cast((Map)out.getHeader(Client.RESPONSE_CONTEXT));
assertNotNull(responseContext);
assertEquals("Get the wrong wsdl opertion name", "{http://apache.org/hello_world_soap_http}greetMe",
responseContext.get("javax.xml.ws.wsdl.operation").toString());
Copy to ClipboardCopied!Toggle word wrapToggle overflow
ECDHE 모드: Attachment 및 MTOM을 사용하는Webhook이 모두 지원됩니다( MTOM 활성화를 위한 페이로드 모드 예 참조). 그러나 Attachment를 사용하는ECDHE은 테스트되지 않았습니다. 첨부 파일은 marshalled 및 unmarshalled에 있기 때문에 일반적으로 사용자는 첨부 파일을 직접 처리 할 필요가 없습니다. 첨부 파일은 2.1 이후 Camel 메시지의 첨부 파일로 전파됩니다. 따라서 Camel Message API를 통해 첨부 파일을 복구할 수 있습니다.
DataHandler Message.getAttachment(String id)
DataHandler Message.getAttachment(String id)
Copy to ClipboardCopied!Toggle word wrapToggle overflow
.
페이로드 모드: 2.1 이후 MTOM이 지원됩니다. 첨부 파일은 위에서 언급한 Camel Message API에서 검색할 수 있습니다. Attachment를 사용하는ECDHE 처리는 이 모드에서ECDHE 처리가 없기 때문에 지원되지 않습니다.
MTOM을 활성화하려면 CXF 엔드포인트 속성 "mtom_enabled"를 true 로 설정합니다. (단, Spring으로만 할 수 있습니다.)
<cxf:cxfEndpoint id="routerEndpoint" address="http://localhost:${CXFTestSupport.port1}/CxfMtomRouterPayloadModeTest/jaxws-mtom/hello"
wsdlURL="mtom.wsdl"
serviceName="ns:HelloService"
endpointName="ns:HelloPort"
xmlns:ns="http://apache.org/camel/cxf/mtom_feature">
<cxf:properties>
<!-- enable mtom by setting this property to true -->
<entry key="mtom-enabled" value="true"/>
<!-- set the camel-cxf endpoint data fromat to PAYLOAD mode -->
<entry key="dataFormat" value="PAYLOAD"/>
</cxf:properties>
<cxf:cxfEndpoint id="routerEndpoint" address="http://localhost:${CXFTestSupport.port1}/CxfMtomRouterPayloadModeTest/jaxws-mtom/hello"
wsdlURL="mtom.wsdl"
serviceName="ns:HelloService"
endpointName="ns:HelloPort"
xmlns:ns="http://apache.org/camel/cxf/mtom_feature">
<cxf:properties>
<!-- enable mtom by setting this property to true -->
<entry key="mtom-enabled" value="true"/>
<!-- set the camel-cxf endpoint data fromat to PAYLOAD mode -->
<entry key="dataFormat" value="PAYLOAD"/>
</cxf:properties>
Copy to ClipboardCopied!Toggle word wrapToggle overflow
페이로드 모드에서 CXF 엔드포인트에 보낼 첨부 파일이 있는 Camel 메시지를 생성할 수 있습니다.
Exchange exchange = context.createProducerTemplate().send("direct:testEndpoint", new Processor() {
public void process(Exchange exchange) throws Exception {
exchange.setPattern(ExchangePattern.InOut);
List<Source> elements = new ArrayList<Source>();
elements.add(new DOMSource(DOMUtils.readXml(new StringReader(MtomTestHelper.REQ_MESSAGE)).getDocumentElement()));
CxfPayload<SoapHeader> body = new CxfPayload<SoapHeader>(new ArrayList<SoapHeader>(),
elements, null);
exchange.getIn().setBody(body);
exchange.getIn().addAttachment(MtomTestHelper.REQ_PHOTO_CID,
new DataHandler(new ByteArrayDataSource(MtomTestHelper.REQ_PHOTO_DATA, "application/octet-stream")));
exchange.getIn().addAttachment(MtomTestHelper.REQ_IMAGE_CID,
new DataHandler(new ByteArrayDataSource(MtomTestHelper.requestJpeg, "image/jpeg")));
}
});
// process response
CxfPayload<SoapHeader> out = exchange.getOut().getBody(CxfPayload.class);
Assert.assertEquals(1, out.getBody().size());
Map<String, String> ns = new HashMap<String, String>();
ns.put("ns", MtomTestHelper.SERVICE_TYPES_NS);
ns.put("xop", MtomTestHelper.XOP_NS);
XPathUtils xu = new XPathUtils(ns);
Element oute = new XmlConverter().toDOMElement(out.getBody().get(0));
Element ele = (Element)xu.getValue("//ns:DetailResponse/ns:photo/xop:Include", oute,
XPathConstants.NODE);
String photoId = ele.getAttribute("href").substring(4); // skip "cid:"
ele = (Element)xu.getValue("//ns:DetailResponse/ns:image/xop:Include", oute,
XPathConstants.NODE);
String imageId = ele.getAttribute("href").substring(4); // skip "cid:"
DataHandler dr = exchange.getOut().getAttachment(photoId);
Assert.assertEquals("application/octet-stream", dr.getContentType());
MtomTestHelper.assertEquals(MtomTestHelper.RESP_PHOTO_DATA, IOUtils.readBytesFromStream(dr.getInputStream()));
dr = exchange.getOut().getAttachment(imageId);
Assert.assertEquals("image/jpeg", dr.getContentType());
BufferedImage image = ImageIO.read(dr.getInputStream());
Assert.assertEquals(560, image.getWidth());
Assert.assertEquals(300, image.getHeight());
Exchange exchange = context.createProducerTemplate().send("direct:testEndpoint", new Processor() {
public void process(Exchange exchange) throws Exception {
exchange.setPattern(ExchangePattern.InOut);
List<Source> elements = new ArrayList<Source>();
elements.add(new DOMSource(DOMUtils.readXml(new StringReader(MtomTestHelper.REQ_MESSAGE)).getDocumentElement()));
CxfPayload<SoapHeader> body = new CxfPayload<SoapHeader>(new ArrayList<SoapHeader>(),
elements, null);
exchange.getIn().setBody(body);
exchange.getIn().addAttachment(MtomTestHelper.REQ_PHOTO_CID,
new DataHandler(new ByteArrayDataSource(MtomTestHelper.REQ_PHOTO_DATA, "application/octet-stream")));
exchange.getIn().addAttachment(MtomTestHelper.REQ_IMAGE_CID,
new DataHandler(new ByteArrayDataSource(MtomTestHelper.requestJpeg, "image/jpeg")));
}
});
// process response
CxfPayload<SoapHeader> out = exchange.getOut().getBody(CxfPayload.class);
Assert.assertEquals(1, out.getBody().size());
Map<String, String> ns = new HashMap<String, String>();
ns.put("ns", MtomTestHelper.SERVICE_TYPES_NS);
ns.put("xop", MtomTestHelper.XOP_NS);
XPathUtils xu = new XPathUtils(ns);
Element oute = new XmlConverter().toDOMElement(out.getBody().get(0));
Element ele = (Element)xu.getValue("//ns:DetailResponse/ns:photo/xop:Include", oute,
XPathConstants.NODE);
String photoId = ele.getAttribute("href").substring(4); // skip "cid:"
ele = (Element)xu.getValue("//ns:DetailResponse/ns:image/xop:Include", oute,
XPathConstants.NODE);
String imageId = ele.getAttribute("href").substring(4); // skip "cid:"
DataHandler dr = exchange.getOut().getAttachment(photoId);
Assert.assertEquals("application/octet-stream", dr.getContentType());
MtomTestHelper.assertEquals(MtomTestHelper.RESP_PHOTO_DATA, IOUtils.readBytesFromStream(dr.getInputStream()));
dr = exchange.getOut().getAttachment(imageId);
Assert.assertEquals("image/jpeg", dr.getContentType());
BufferedImage image = ImageIO.read(dr.getInputStream());
Assert.assertEquals(560, image.getWidth());
Assert.assertEquals(300, image.getHeight());
Copy to ClipboardCopied!Toggle word wrapToggle overflow
Payload 모드에서 CXF 끝점에서 수신된 Camel 메시지를 사용할 수도 있습니다.
public static class MyProcessor implements Processor {
@SuppressWarnings("unchecked")
public void process(Exchange exchange) throws Exception {
CxfPayload<SoapHeader> in = exchange.getIn().getBody(CxfPayload.class);
// verify request
assertEquals(1, in.getBody().size());
Map<String, String> ns = new HashMap<String, String>();
ns.put("ns", MtomTestHelper.SERVICE_TYPES_NS);
ns.put("xop", MtomTestHelper.XOP_NS);
XPathUtils xu = new XPathUtils(ns);
Element body = new XmlConverter().toDOMElement(in.getBody().get(0));
Element ele = (Element)xu.getValue("//ns:Detail/ns:photo/xop:Include", body,
XPathConstants.NODE);
String photoId = ele.getAttribute("href").substring(4); // skip "cid:"
assertEquals(MtomTestHelper.REQ_PHOTO_CID, photoId);
ele = (Element)xu.getValue("//ns:Detail/ns:image/xop:Include", body,
XPathConstants.NODE);
String imageId = ele.getAttribute("href").substring(4); // skip "cid:"
assertEquals(MtomTestHelper.REQ_IMAGE_CID, imageId);
DataHandler dr = exchange.getIn().getAttachment(photoId);
assertEquals("application/octet-stream", dr.getContentType());
MtomTestHelper.assertEquals(MtomTestHelper.REQ_PHOTO_DATA, IOUtils.readBytesFromStream(dr.getInputStream()));
dr = exchange.getIn().getAttachment(imageId);
assertEquals("image/jpeg", dr.getContentType());
MtomTestHelper.assertEquals(MtomTestHelper.requestJpeg, IOUtils.readBytesFromStream(dr.getInputStream()));
// create response
List<Source> elements = new ArrayList<Source>();
elements.add(new DOMSource(DOMUtils.readXml(new StringReader(MtomTestHelper.RESP_MESSAGE)).getDocumentElement()));
CxfPayload<SoapHeader> sbody = new CxfPayload<SoapHeader>(new ArrayList<SoapHeader>(),
elements, null);
exchange.getOut().setBody(sbody);
exchange.getOut().addAttachment(MtomTestHelper.RESP_PHOTO_CID,
new DataHandler(new ByteArrayDataSource(MtomTestHelper.RESP_PHOTO_DATA, "application/octet-stream")));
exchange.getOut().addAttachment(MtomTestHelper.RESP_IMAGE_CID,
new DataHandler(new ByteArrayDataSource(MtomTestHelper.responseJpeg, "image/jpeg")));
}
}
public static class MyProcessor implements Processor {
@SuppressWarnings("unchecked")
public void process(Exchange exchange) throws Exception {
CxfPayload<SoapHeader> in = exchange.getIn().getBody(CxfPayload.class);
// verify request
assertEquals(1, in.getBody().size());
Map<String, String> ns = new HashMap<String, String>();
ns.put("ns", MtomTestHelper.SERVICE_TYPES_NS);
ns.put("xop", MtomTestHelper.XOP_NS);
XPathUtils xu = new XPathUtils(ns);
Element body = new XmlConverter().toDOMElement(in.getBody().get(0));
Element ele = (Element)xu.getValue("//ns:Detail/ns:photo/xop:Include", body,
XPathConstants.NODE);
String photoId = ele.getAttribute("href").substring(4); // skip "cid:"
assertEquals(MtomTestHelper.REQ_PHOTO_CID, photoId);
ele = (Element)xu.getValue("//ns:Detail/ns:image/xop:Include", body,
XPathConstants.NODE);
String imageId = ele.getAttribute("href").substring(4); // skip "cid:"
assertEquals(MtomTestHelper.REQ_IMAGE_CID, imageId);
DataHandler dr = exchange.getIn().getAttachment(photoId);
assertEquals("application/octet-stream", dr.getContentType());
MtomTestHelper.assertEquals(MtomTestHelper.REQ_PHOTO_DATA, IOUtils.readBytesFromStream(dr.getInputStream()));
dr = exchange.getIn().getAttachment(imageId);
assertEquals("image/jpeg", dr.getContentType());
MtomTestHelper.assertEquals(MtomTestHelper.requestJpeg, IOUtils.readBytesFromStream(dr.getInputStream()));
// create response
List<Source> elements = new ArrayList<Source>();
elements.add(new DOMSource(DOMUtils.readXml(new StringReader(MtomTestHelper.RESP_MESSAGE)).getDocumentElement()));
CxfPayload<SoapHeader> sbody = new CxfPayload<SoapHeader>(new ArrayList<SoapHeader>(),
elements, null);
exchange.getOut().setBody(sbody);
exchange.getOut().addAttachment(MtomTestHelper.RESP_PHOTO_CID,
new DataHandler(new ByteArrayDataSource(MtomTestHelper.RESP_PHOTO_DATA, "application/octet-stream")));
exchange.getOut().addAttachment(MtomTestHelper.RESP_IMAGE_CID,
new DataHandler(new ByteArrayDataSource(MtomTestHelper.responseJpeg, "image/jpeg")));
}
}
Copy to ClipboardCopied!Toggle word wrapToggle overflow
메시지 모드: 첨부 파일은 메시지를 전혀 처리하지 않으므로 지원되지 않습니다.
CXF_MESSAGE 모드: MTOM이 지원되며 위에서 언급한 Camel Message API에서 첨부 파일을 검색할 수 있습니다.
참고
멀티 파트(즉, MTOM) 메시지를 수신할 때 기본ECDHE Message to String 변환기는 본문에서 전체 멀티 파트 페이로드를 제공합니다. String 으로ECDHE XML만 필요한 경우 message.getSOAPPart() 를 사용하여 메시지 본문을 설정할 수 있으며 Camel 변환은 나머지 작업을 수행할 수 있습니다.
CXF 끝점을 구성하여 Java 예외가 서버 측에서 발생하는 경우 예외에 대한 스택 추적이 오류 메시지로 마샬되고 클라이언트에 반환되도록 할 수 있습니다. 이 페레를 활성화하려면 dataFormat 을 PAYLOAD 로 설정하고 다음과 같이 cxfEndpoint 요소에서 faultStackTraceEnabled 속성을 true 로 설정합니다.
<cxf:cxfEndpoint id="router" address="http://localhost:9002/TestMessage"
wsdlURL="ship.wsdl"
endpointName="s:TestSoapEndpoint"
serviceName="s:TestService"
xmlns:s="http://test">
<cxf:properties>
<!-- enable sending the stack trace back to client; the default value is false-->
<entry key="faultStackTraceEnabled" value="true" /> <entry key="dataFormat" value="PAYLOAD" />
</cxf:properties>
</cxf:cxfEndpoint>
<cxf:cxfEndpoint id="router" address="http://localhost:9002/TestMessage"
wsdlURL="ship.wsdl"
endpointName="s:TestSoapEndpoint"
serviceName="s:TestService"
xmlns:s="http://test">
<cxf:properties>
<!-- enable sending the stack trace back to client; the default value is false-->
<entry key="faultStackTraceEnabled" value="true" /> <entry key="dataFormat" value="PAYLOAD" />
</cxf:properties>
</cxf:cxfEndpoint>
Copy to ClipboardCopied!Toggle word wrapToggle overflow
보안상의 이유로 스택 추적에는 원인된 예외가 포함되지 않습니다(즉, Caused를 따르는 스택 추적의 일부). 스택 추적에 원인 예외가 포함된 경우 다음과 같이 cxfEndpoint 요소에서 exceptionMessageCauseEnabled 속성을 true 로 설정합니다.
<cxf:cxfEndpoint id="router" address="http://localhost:9002/TestMessage"
wsdlURL="ship.wsdl"
endpointName="s:TestSoapEndpoint"
serviceName="s:TestService"
xmlns:s="http://test">
<cxf:properties>
<!-- enable to show the cause exception message and the default value is false -->
<entry key="exceptionMessageCauseEnabled" value="true" />
<!-- enable to send the stack trace back to client, the default value is false-->
<entry key="faultStackTraceEnabled" value="true" />
<entry key="dataFormat" value="PAYLOAD" />
</cxf:properties>
</cxf:cxfEndpoint>
<cxf:cxfEndpoint id="router" address="http://localhost:9002/TestMessage"
wsdlURL="ship.wsdl"
endpointName="s:TestSoapEndpoint"
serviceName="s:TestService"
xmlns:s="http://test">
<cxf:properties>
<!-- enable to show the cause exception message and the default value is false -->
<entry key="exceptionMessageCauseEnabled" value="true" />
<!-- enable to send the stack trace back to client, the default value is false-->
<entry key="faultStackTraceEnabled" value="true" />
<entry key="dataFormat" value="PAYLOAD" />
</cxf:properties>
</cxf:cxfEndpoint>
Copy to ClipboardCopied!Toggle word wrapToggle overflow
주의
테스트 및 진단 목적으로 exceptionMessageCauseEnabled 플래그만 활성화합니다. 서버에서 예외의 원래 원인을 숨기면 적대적인 사용자가 서버를 검색하기가 더 어려워지는 것이 일반적인 관행입니다.
2.8.2에서 camel-cxf 구성 요소는 PAYLOAD 모드를 사용할 때 들어오는 메시지 스트리밍을 지원합니다. 이전에는 들어오는 메시지가 완전히 DestinationRule 구문 분석되었습니다. 대규모 메시지의 경우 시간이 오래 걸리며 상당한 양의 메모리를 사용합니다. 2.8.2부터 들어오는 메시지는 라우팅되는 동안 javax.xml.transform.Source로 남아 있을 수 있으며 페이로드를 수정하지 않으면 대상 목적지로 직접 스트리밍할 수 있습니다. 일반적인 "간단 프록시" 사용 사례(예:("cxf:…").to("cxf:…")의 경우 이는 매우 중요한 성능과 메모리 요구 사항을 크게 줄일 수 있습니다.
그러나 스트리밍이 적합하지 않거나 바람직하지 않을 수 있는 경우가 있습니다. 스트리밍 특성으로 인해 나중에 처리 체인에서 잘못 들어오는 XML이 캡처되지 않을 수 있습니다. 또한 특정 동작으로 인해 message가 임의로 구문 분석되어야 할 수도 있습니다(예: WS-Security 또는 메시지 추적과 같이) 스트리밍의 이점이 제한됩니다. 이 시점에서 스트리밍을 제어하는 두 가지 방법이 있습니다.
끝점 속성: "allowStreaming=false"를 끝점 속성으로 추가하여 스트리밍을 온/오프 상태로 설정할 수 있습니다.
구성 요소 속성: CxfComponent 오브젝트에는 해당 구성 요소에서 생성된 끝점에 대한 기본값을 설정할 수 있는 allowStreaming 속성도 있습니다.
글로벌 시스템 속성: org.apache.camel.component.cxf.streaming 의 시스템 속성을 false 로 추가하여 해제할 수 있습니다. 전역 기본값을 설정하지만 위의 endpoint 속성을 설정하면 해당 끝점의 이 값이 재정의됩니다.
2.8.0에서 camel-cxf 구성 요소는 임의의 구조의 메시지를 전송할 수 있는 일반 CXF 디스패치 모드를 지원합니다(즉, 특정 XML 스키마에 바인딩되지 않음). 이 모드를 사용하려면 CXF 끝점의 wsdlURL 및 serviceClass 속성을 지정하는 것을 생략하면 됩니다.
Copy to ClipboardCopied!Toggle word wrapToggle overflow
& lt;security-domain > 구성은 DestinationRule 하위 시스템에서 정의한 < application-security-domain >의 이름을 참조합니다. 예를 들어, DestinationRule 하위 시스템 < application-security-domain >은 WildFly 서버 standalone.xml 구성 파일에 다음과 같이 구성됩니다.
Copy to ClipboardCopied!Toggle word wrapToggle overflow
& lt;http-authentication-factory > application-http-authentication 은 Elytron 하위 시스템 내에 정의됩니다. application-http-authentication 은 기본적으로 standalone.xml 및 standalone-full.xml 서버 구성 파일에서 사용할 수 있습니다. 예를 들면 다음과 같습니다.
camel-cxf 소비자 끝점에 대한 보안 제약 조건, 인증 방법 및 보안 역할은 WAR 배포 (1- INF/web.xml ) 내에서 구성할 수 있습니다. 예를 들어 BASIC 인증을 구성하려면 다음을 수행합니다.
<web-app>
<security-constraint>
<web-resource-collection>
<web-resource-name>secure</web-resource-name>
<url-pattern>/webservices/*</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>my-role</role-name>
</auth-constraint>
</security-constraint>
<security-role>
<description>The role that is required to log in to /webservices/*</description>
<role-name>my-role</role-name>
</security-role>
<login-config>
<auth-method>BASIC</auth-method>
<realm-name>my-realm</realm-name>
</login-config>
</web-app>
<web-app>
<security-constraint>
<web-resource-collection>
<web-resource-name>secure</web-resource-name>
<url-pattern>/webservices/*</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>my-role</role-name>
</auth-constraint>
</security-constraint>
<security-role>
<description>The role that is required to log in to /webservices/*</description>
<role-name>my-role</role-name>
</security-role>
<login-config>
<auth-method>BASIC</auth-method>
<realm-name>my-realm</realm-name>
</login-config>
</web-app>
Copy to ClipboardCopied!Toggle word wrapToggle overflow
서블릿 사양으로 정의된 < ;url-pattern >은 웹 애플리케이션의 컨텍스트 경로를 기준으로 합니다. 애플리케이션이 my-app.war 로 패키지된 경우 WildFly는 컨텍스트 경로 /my-app 에서 액세스할 수 있도록 하고 < url-patternpattern > /webservices/* 는 /my-app 의 상대 경로에 적용됩니다.
WildFly-Camel은 호스트 웹 애플리케이션 컨텍스트 경로 외부에 있는 기본 경로가 있는 camel-cxf 끝점 소비자를 생성할 수 있기 때문에 중요합니다. 예를 들어 my-app.war 내에서 http://my-server/webservices/my-endpoint 에 대한 camel-cxf 소비자를 생성할 수 있습니다.
이러한 컨텍스트 끝점에 대한 보안 제약 조건을 정의하기 위해 WildFly-Camel은 세 개의 슬래시 /// 가 있는 패턴 접두사가 서버 호스트 이름에 절대로 해석되는 사용자 지정 비표준 < url-pattern > 규칙을 지원합니다. 예를 들어 my-app.war 내에서 http://my-server/webservices/my-endpoint 를 보호하려면 web.xml 에 다음 구성을 추가합니다.
<web-app>
<security-constraint>
<web-resource-collection>
<web-resource-name>secure</web-resource-name>
<url-pattern>///webservices/*</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>my-role</role-name>
</auth-constraint>
</security-constraint>
<security-role>
<description>The role that is required to log in to /webservices/*</description>
<role-name>my-role</role-name>
</security-role>
<login-config>
<auth-method>BASIC</auth-method>
<realm-name>my-realm</realm-name>
</login-config>
</web-app>
<web-app>
<security-constraint>
<web-resource-collection>
<web-resource-name>secure</web-resource-name>
<url-pattern>///webservices/*</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>my-role</role-name>
</auth-constraint>
</security-constraint>
<security-role>
<description>The role that is required to log in to /webservices/*</description>
<role-name>my-role</role-name>
</security-role>
<login-config>
<auth-method>BASIC</auth-method>
<realm-name>my-realm</realm-name>
</login-config>
</web-app>
Copy to ClipboardCopied!Toggle word wrapToggle overflow