77장. CXF


77.1. CXF 구성 요소

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>
Copy to Clipboard Toggle word wrap
참고

CXF 종속 항목에 대해 알아보려면ECDHEICH -JARS 텍스트 파일을 참조하십시오.

참고

스트리밍 모드에서 CXF를 사용하는 경우(DataFormat 옵션 참조) 스트림 캐싱에 대한 정보도 읽습니다.

77.2. EAP 배포의 Camel

이 구성 요소는 Red Hat JBoss EAP(JBoss Enterprise Application Platform) 컨테이너에서 간소화된 배포 모델을 제공하는 EAP 기반 Camel(Wildfly Camel) 프레임워크에서 지원합니다.

CXF 구성 요소는 Apache CXF도 사용하는 JBoss EAP 웹 서비스와 통합됩니다. 자세한 내용은ECDHE -WS 를 참조하십시오.

참고

현재 EAP 하위 시스템의 Camel은 CXF 또는 Restlet 소비자를 지원하지 않습니다. 그러나 CamelProxy 를 사용하여 CXF 소비자 동작을 모방할 수 있습니다.

77.3. URI 형식

cxf:bean:cxfEndpoint[?options]
Copy to Clipboard Toggle word wrap

여기서 cxfEndpoint 는 SpringBean 레지스트리에서Bean을 참조하는Bean ID를 나타냅니다. 이 URI 형식을 사용하면 대부분의 끝점 세부 정보가 DestinationRule 정의에 지정됩니다.

cxf://someAddress[?options]
Copy to Clipboard Toggle word wrap

여기서 someAddress 는 CXF 끝점의 주소를 지정합니다. 이 URI 형식을 사용하면 대부분의 끝점 세부 정보가 옵션을 사용하여 지정됩니다.

위의 두 스타일에 대해 다음과 같이 옵션을 URI에 추가할 수 있습니다.

cxf:bean:cxfEndpoint?wsdlURL=wsdl/hello_world.wsdl&dataFormat=PAYLOAD
Copy to Clipboard Toggle word wrap

77.4. 옵션

Expand

이름

필수 항목

설명

wsdlURL

없음

WSDL의 위치입니다. WSDL은 기본적으로 끝점 주소에서 가져옵니다. 예를 들면 다음과 같습니다.

file://local/wsdl/hello.wsdl 또는 wsdl/hello.wsdl

serviceClass

제공됨

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를 설정합니다. 예를 들면 다음과 같습니다.

defaultOperationNamespace=http://apache.org/hello_world_soap_http

synchronous

없음

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

serviceNameportNameQNames 이므로, 제공한 경우 위의 예제와 같이 {namespace} 로 접두사를 붙여야 합니다.

77.5. 데이터 형식에 대한 설명

Expand

DataFormat

설명

POJO

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 에 정의되어 있습니다.

77.6. Apache AriesECDHE를 사용하여 CXF 끝점 구성.

Camel 2.8 이후 CXF 엔드포인트에 Aries의 종속성 주입을 사용할 수 있습니다. 스키마는 Spring 스키마와 매우 유사하므로 전환은 상당히 투명합니다.

예를 들면 다음과 같습니다.

 <blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xmlns:cm="http://aries.apache.org/blueprint/xmlns/blueprint-cm/v1.0.0"
            xmlns:camel-cxf="http://camel.apache.org/schema/blueprint/cxf"
 	   xmlns:cxfcore="http://cxf.apache.org/blueprint/core"
            xsi:schemaLocation="http://www.osgi.org/xmlns/blueprint/v1.0.0 https://www.osgi.org/xmlns/blueprint/v1.0.0/blueprint.xsd">

       <camel-cxf:cxfEndpoint id="routerEndpoint"
                      address="http://localhost:9001/router"
                      serviceClass="org.apache.servicemix.examples.cxf.HelloWorld">
         <camel-cxf:properties>
             <entry key="dataFormat" value="MESSAGE"/>
         </camel-cxf:properties>
      </camel-cxf:cxfEndpoint>

      <camel-cxf:cxfEndpoint id="serviceEndpoint"
			address="http://localhost:9000/SoapContext/SoapPort"
                     serviceClass="org.apache.servicemix.examples.cxf.HelloWorld">
    </camel-cxf:cxfEndpoint>

    <camelContext xmlns="http://camel.apache.org/schema/blueprint">
        <route>
            <from uri="routerEndpoint"/>
            <to uri="log:request"/>
        </route>
    </camelContext>

</blueprint>
Copy to Clipboard Toggle word wrap

현재 끝점 요소는 첫 번째로 지원되는 CXF 네임스페이스handler입니다.

또한Bean 참조를 Spring과 동일하게 사용할 수 있습니다.

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xmlns:cm="http://aries.apache.org/blueprint/xmlns/blueprint-cm/v1.0.0"
           xmlns:jaxws="http://cxf.apache.org/blueprint/jaxws"
           xmlns:cxf="http://cxf.apache.org/blueprint/core"
           xmlns:camel="http://camel.apache.org/schema/blueprint"
           xmlns:camelcxf="http://camel.apache.org/schema/blueprint/cxf"
           xsi:schemaLocation="
             http://www.osgi.org/xmlns/blueprint/v1.0.0 https://www.osgi.org/xmlns/blueprint/v1.0.0/blueprint.xsd
             http://cxf.apache.org/blueprint/jaxws http://cxf.apache.org/schemas/blueprint/jaxws.xsd
             http://cxf.apache.org/blueprint/core http://cxf.apache.org/schemas/blueprint/core.xsd
             ">

    <camelcxf:cxfEndpoint id="reportIncident"
                     address="/camel-example-cxf-blueprint/webservices/incident"
                     wsdlURL="META-INF/wsdl/report_incident.wsdl"
                     serviceClass="org.apache.camel.example.reportincident.ReportIncidentEndpoint">
    </camelcxf:cxfEndpoint>

    <bean id="reportIncidentRoutes" class="org.apache.camel.example.reportincident.ReportIncidentRoutes" />

    <camelContext xmlns="http://camel.apache.org/schema/blueprint">
        <routeBuilder ref="reportIncidentRoutes"/>
    </camelContext>

</blueprint>
Copy to Clipboard Toggle word wrap

77.7. MESSAGE 모드에서 CXF의 LoggingOutInterceptor를 활성화하는 방법

CXF의 LoggingOutInterceptor 는 로깅 시스템(Java.util.logging )으로 전달되는 아웃바운드 메시지를 출력합니다. LoggingOutInterceptorPRE_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>
Copy to Clipboard Toggle word wrap

77.8. relayHeaders 옵션 설명

ECDHEWS WSDL 우선 개발자 의 관점에서 대역 내 및 대역 외 헤더가 있습니다.

대역 내 헤더는ECDHE 헤더와 같은 끝점에 대한 WSDL 바인딩 계약의 일부로 명시적으로 정의된 헤더입니다.

대역 외 헤더는 줄바운드를 통해 직렬화되지만 WSDL 바인딩 계약의 일부가 아닌 헤더입니다.

헤더 중계/필터링은 양방향입니다.

경로에 CXF 엔드포인트가 있고 개발자에게ECDHE 헤더와 같은 유선 헤더가 있어야 하는 경우 다른ECDHEWS 엔드포인트에서 말으로 사용할 경로를 따라 중계한 다음, relayHeaders 를 기본값인 true 로 설정합니다.

77.9. ECDHE 모드에서만 사용 가능

relayHeaders=true 설정은 헤더를 릴레이하려는 의도를 나타냅니다. 지정된 헤더가 중계되었는지 여부에 대한 실제 결정은 MessageHeadersRelay 인터페이스를 구현하는 플러그 가능한 인스턴스에 위임됩니다. MessageHeadersRelay 의 공식 구현은 헤더를 중계해야 하는지 여부를 결정하기 위해 참조됩니다. 자체적으로 잘 알려진ECDHE 네임스페이스에 바인딩하는 SoapMessageHeadersRelay 구현이 이미 있습니다. 현재 대역 외 헤더만 필터링되고 대역 내 헤더는 relayHeaders=true 인 경우 항상 중계됩니다. 해당 네임스페이스가 런타임에 알 수 없는 헤더가 있는 경우 대체 DefaultMessageHeadersRelay 가 사용됩니다. 이로 인해 모든 헤더가 중계될 수 있습니다.

relayHeaders=false 설정은 모든 헤더(in-band 및 out-of-band)가 삭제됨을 주장합니다.

고유한 MessageHeadersRelay 구현을 재정의하거나 릴레이 목록에 추가 항목을 추가할 수 있습니다. 사전 로드된 릴레이 인스턴스를 재정의하려면 MessageHeadersRelay 구현 서비스가 재정의하려는 네임스페이스와 동일한 네임스페이스를 필터링하는지 확인하십시오. 또한 재정의 릴레이는 재정의하려는 네임스페이스를 모두 서비스해야 하거나, 경로 시작 시 런타임 예외가 발생하므로 인스턴스 매핑을 릴레이하는 네임스페이스에 모호성이 발생합니다.

<cxf:cxfEndpoint ...>
   <cxf:properties>
     <entry key="org.apache.camel.cxf.message.headers.relays">
       <list>
         <ref bean="customHeadersRelay"/>
       </list>
     </entry>
   </cxf:properties>
 </cxf:cxfEndpoint>
 <bean id="customHeadersRelay" class="org.apache.camel.component.cxf.soap.headers.CustomHeadersRelay"/>
Copy to Clipboard Toggle word wrap

여기에서 헤더를 중계/삭제할 수 있는 방법을 보여주는 테스트를 살펴보십시오.

링크:https://svn.apache.org/repos/asf/camel/branches/camel-1.x/components/camel-cxf/src/test/java/org/apache/camel/component/cxf/soap/headers/CxfMessageHeadersRelayTest.java[https://svn.apache.org/repos/asf/camel/branches/camel-1.x/components/camel-cxf/src/test/java/org/apache/camel/component/cxf/soap/headers/CxfMessageHeadersRelayTest.java ]

77.10. 릴리스 2.0 이후의 변경 사항

  • ECDHEPAYLOAD 모드가 지원됩니다. 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>
    Copy to Clipboard Toggle word wrap

    그런 다음 끝점에서 CxfHeaderFilterStrategy 를 참조할 수 있습니다.

    <route>
        <from uri="cxf:bean:routerNoRelayEndpoint?headerFilterStrategy=#dropAllMessageHeadersStrategy"/>
        <to uri="cxf:bean:serviceNoRelayEndpoint?headerFilterStrategy=#dropAllMessageHeadersStrategy"/>
    </route>
    Copy to Clipboard Toggle word wrap
  • 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>
    Copy to Clipboard Toggle word wrap
  • relayHeaders 외에도 CxfHeaderFilterStrategy 에서 구성할 수 있는 새 속성이 있습니다.
Expand

이름

설명

type

필수 여부

기본값

relayHeaders

모든 메시지 헤더는 메시지 헤더 필터에서 처리

boolean

없음

true (1.6.1 동작)

relayAllMessageHeaders

모든 메시지 헤더가 전파됩니다(Message Header Filters로 처리하지 않음)

boolean

없음

False (1.6.1 동작)

allowFilterNamespaceClash

활성화 네임스페이스에서 중복된 필터 처리. 값이 true 인 경우 마지막 값이 우선합니다. 값이 false 인 경우 예외가 발생합니다.

boolean

없음

False (1.6.1 동작)

77.11. Spring을 사용하여 CXF 끝점 구성

아래 표시된 Spring 구성 파일을 사용하여 CXF 끝점을 구성할 수 있으며, 끝점을 camelContext 태그에 포함할 수도 있습니다. 서비스 끝점을 호출할 때 operationNameoperationNamespace 헤더를 설정하여 호출 중인 작업을 명시적으로 상태 지정할 수 있습니다.

참고 Camel 2.x에서는 http://camel.apache.org/schema/cxf 을 CXF 엔드포인트의 대상 네임스페이스로 사용하도록 변경합니다.

<beans xmlns="http://www.springframework.org/schema/beans"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:cxf="http://camel.apache.org/schema/cxf"
        xsi:schemaLocation="
        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
        http://camel.apache.org/schema/cxf http://camel.apache.org/schema/cxf/camel-cxf.xsd
        http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd     ">
 ...
Copy to Clipboard Toggle word wrap
참고

Apache Camel 2.x에서 http://activemq.apache.org/camel/schema/cxfEndpoint 네임스페이스가 http://camel.apache.org/schema/cxf 로 변경되었습니다.

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> 또는 &lt; ref& gt;의 목록입니다.

cxf:inFaultInterceptors

이 끝점에 대한 들어오는 오류 인터셉터입니다. < bean> 또는 &lt; ref& gt;의 목록입니다.

cxf:outInterceptors

이 끝점에 대한 발신 인터셉터입니다. < bean> 또는 &lt; ref& gt;의 목록입니다.

cxf:outFaultInterceptors

이 끝점의 발신 오류 인터셉터입니다. < bean> 또는 &lt; 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 또는 &lt; ref> s의 목록

cxf:schemaLocations

사용할 끝점의 스키마 위치입니다. < schemaLocation> s목록

cxf:serviceFactory

이 끝점이 사용할 서비스 팩토리입니다. 이는 Spring < bean class="MyServiceECDHEy"/ > 구문을 사용하여 제공할 수 있습니다.

인터셉터, 속성 및 처리기를 제공하는 방법을 보여주는 고급 예제는 http://cwiki.apache.org/CXF20DOC/jax-ws-configuration.html에서 확인할 수 있습니다.

참고

다음과 같이 CXF:properties를 사용하여 Spring 구성 파일에서 CXF 엔드 포인트의 dataFormatsetDefaultBus 속성을 설정할 수 있습니다.

<cxf:cxfEndpoint id="testEndpoint" address="http://localhost:9000/router"
     serviceClass="org.apache.camel.component.cxf.HelloService"
     endpointName="s:PortName"
     serviceName="s:ServiceName"
     xmlns:s="http://www.example.com/test">
     <cxf:properties>
       <entry key="dataFormat" value="MESSAGE"/>
       <entry key="setDefaultBus" value="true"/>
     </cxf:properties>
   </cxf:cxfEndpoint>
Copy to Clipboard Toggle word wrap

CXF의 기본 로거는 java.util.logging 입니다. log4j 로 변경하려면 다음과 같이 진행합니다. 클래스 경로에 META-INF/cxf/org.apache.cxf.logger 라는 파일을 생성합니다. 이 파일에는 주석 없이 한 줄에 org.apache.cxf.common.logging.Log4jLogger 의 정규화된 이름이 포함되어야 합니다.

77.13. How to let camel-cxf response message with xml start document

PHP와 같은 일부ECDHE 클라이언트를 사용하는 경우 CXF가 XML 시작 문서 < ?xml version="1.0" encoding="utf-8"?>을 추가하지 않기 때문에 이러한 종류의 오류가 발생할 수 있습니다.

Error:sendSms: SoapFault exception: [Client] looks like we got no XML document in [...]
Copy to Clipboard Toggle word wrap

이 문제를 해결하려면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);
    }

}
Copy to Clipboard Toggle word wrap

이와 같은 고객 인터셉터를 추가하고 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>
Copy to Clipboard Toggle word wrap

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);
Copy to Clipboard Toggle word wrap

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

}
Copy to Clipboard Toggle word wrap

camel-cxf 끝점 생산자는 cxf 클라이언트 API 를 기반으로 합니다. 먼저 message 헤더에 작업 이름을 지정하고 메서드 매개변수를 목록에 추가하고 이 매개변수 목록으로 메시지를 초기화해야 합니다. 응답 메시지의 본문은 messageContentsList 이며 해당 목록에서 결과를 가져올 수 있습니다.

메시지 헤더에 작업 이름을 지정하지 않으면 CxfProducerCxfEndpoint 에서 defaultOperationName 을 사용하려고 합니다. CxfEndpointdefaultOperationName 이 설정되지 않은 경우 작업 목록에서 첫 번째 작업 이름을 선택합니다.

메시지 본문에서 개체 배열을 가져오려면 다음과 같이 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));
Copy to Clipboard Toggle word wrap

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);
                }
            });
        }
    };
}
Copy to Clipboard Toggle word wrap

77.17. DestinationRule 모드에서ECDHE 헤더를 가져오고 설정하는 방법

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입니다. 이 경로는 다음과 같습니다.

<route>
    <from uri="cxf:bean:routerRelayEndpointWithInsertion"/>
    <process ref="InsertRequestOutHeaderProcessor" />
    <to uri="cxf:bean:serviceRelayEndpointWithInsertion"/>
    <process ref="InsertResponseOutHeaderProcessor" />
</route>
Copy to Clipboard Toggle word wrap

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 헤더를 삽입합니다). InsertResponseOutHeaderProcessorInsertRequestOutHeaderProcessor 모두에서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);

    }

}
Copy to Clipboard Toggle word wrap

77.18. PAYLOAD 모드에서ECDHE 헤더를 가져오고 설정하는 방법

PAYLOAD 모드에서ECDHE 메시지(CxfPayload 오브젝트)에 액세스하는 방법을 이미 표시했습니다( PAYLOAD 데이터 형식의 camel-cxf 끝점에 대한 메시지 처리 방법참조).

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());
Copy to Clipboard Toggle word wrap

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 헤더에서 해당 헤더를 제거합니다.

77.19. ECDHE 헤더는 MESSAGE 모드에서 사용할 수 없습니다.

ECDHE 처리를 건너뛰면 MESSAGE 모드에서는ECDHE 헤더를 사용할 수 없습니다.

77.20. How to throw aECDHE likeult from Apache 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);
Copy to Clipboard Toggle word wrap

그런 다음 원하는 대로 던집니다.

from(routerEndpointURI).setFaultBody(constant(SOAP_FAULT));
Copy to Clipboard Toggle word wrap

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

});
Copy to Clipboard Toggle word wrap

ECDHE 데이터 형식에도 마찬가지입니다. 아웃 본문에서ECDHE Fault를 설정하고 다음과 같이 Message.setFault(true) 를 호출하여 오류가 있음을 나타낼 수 있습니다.

from("direct:start").onException(SoapFault.class).maximumRedeliveries(0).handled(true)
    .process(new Processor() {
        public void process(Exchange exchange) throws Exception {
            SoapFault fault = exchange
                .getProperty(Exchange.EXCEPTION_CAUGHT, SoapFault.class);
            exchange.getOut().setFault(true);
            exchange.getOut().setBody(fault);
        }

    }).end().to(serviceURI);
Copy to Clipboard Toggle word wrap

77.21. CXF 끝점의 요청 및 응답 컨텍스트를 전파하는 방법

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());
Copy to Clipboard Toggle word wrap

77.22. 첨부 파일 지원

ECDHE 모드: Attachment 및 MTOM을 사용하는Webhook이 모두 지원됩니다( MTOM 활성화를 위한 페이로드 모드 예 참조). 그러나 Attachment를 사용하는ECDHE은 테스트되지 않았습니다. 첨부 파일은 marshalled 및 unmarshalled에 있기 때문에 일반적으로 사용자는 첨부 파일을 직접 처리 할 필요가 없습니다. 첨부 파일은 2.1 이후 Camel 메시지의 첨부 파일로 전파됩니다. 따라서 Camel Message API를 통해 첨부 파일을 복구할 수 있습니다.

DataHandler Message.getAttachment(String id)
Copy to Clipboard Toggle word wrap

.

페이로드 모드: 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>
Copy to Clipboard Toggle word wrap

페이로드 모드에서 CXF 엔드포인트에 보낼 첨부 파일이 있는 Camel 메시지를 생성할 수 있습니다.

Exchange exchange = context.createProducerTemplate().send("direct:testEndpoint", new Processor() {

    public void process(Exchange exchange) throws Exception {
        exchange.setPattern(ExchangePattern.InOut);
        List&lt;Source> elements = new ArrayList&lt;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 Clipboard Toggle word wrap

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&lt;Source> elements = new ArrayList&lt;Source>();
        elements.add(new DOMSource(DOMUtils.readXml(new StringReader(MtomTestHelper.RESP_MESSAGE)).getDocumentElement()));
        CxfPayload&lt;SoapHeader> sbody = new CxfPayload&lt;SoapHeader>(new ArrayList&lt;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 Clipboard Toggle word wrap

메시지 모드: 첨부 파일은 메시지를 전혀 처리하지 않으므로 지원되지 않습니다.

CXF_MESSAGE 모드: MTOM이 지원되며 위에서 언급한 Camel Message API에서 첨부 파일을 검색할 수 있습니다.

참고

멀티 파트(즉, MTOM) 메시지를 수신할 때 기본ECDHE Message to String 변환기는 본문에서 전체 멀티 파트 페이로드를 제공합니다. String 으로ECDHE XML만 필요한 경우 message.getSOAPPart() 를 사용하여 메시지 본문을 설정할 수 있으며 Camel 변환은 나머지 작업을 수행할 수 있습니다.

77.23. 스택 추적 정보를 전파하는 방법

CXF 끝점을 구성하여 Java 예외가 서버 측에서 발생하는 경우 예외에 대한 스택 추적이 오류 메시지로 마샬되고 클라이언트에 반환되도록 할 수 있습니다. 이 페레를 활성화하려면 dataFormatPAYLOAD 로 설정하고 다음과 같이 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>
Copy to Clipboard Toggle word wrap

보안상의 이유로 스택 추적에는 원인된 예외가 포함되지 않습니다(즉, 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>
Copy to Clipboard Toggle word wrap
주의

테스트 및 진단 목적으로 exceptionMessageCauseEnabled 플래그만 활성화합니다. 서버에서 예외의 원래 원인을 숨기면 적대적인 사용자가 서버를 검색하기가 더 어려워지는 것이 일반적인 관행입니다.

77.24. PAYLOAD 모드에서 지원 스트리밍

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 속성을 설정하면 해당 끝점의 이 값이 재정의됩니다.

77.25. 일반 CXF Dispatch 모드 사용

2.8.0에서 camel-cxf 구성 요소는 임의의 구조의 메시지를 전송할 수 있는 일반 CXF 디스패치 모드를 지원합니다(즉, 특정 XML 스키마에 바인딩되지 않음). 이 모드를 사용하려면 CXF 끝점의 wsdlURL 및 serviceClass 속성을 지정하는 것을 생략하면 됩니다.

<cxf:cxfEndpoint id="testEndpoint" address="http://localhost:9000/SoapContext/SoapAnyPort">
  <cxf:properties>
    <entry key="dataFormat" value="PAYLOAD"/>
  </cxf:properties>
</cxf:cxfEndpoint>
Copy to Clipboard Toggle word wrap

기본 CXF 디스패치 클라이언트는 특정ECDHEAction 헤더를 보내지 않습니다. 따라서 대상 서비스에 특정ECDHEAction 값이 필요한 경우 keyECDHEAction (case-insensitive)을 사용하여 Camel 헤더에 제공됩니다.

77.1. WildFly의 CXF 소비자

WildFly의 camel-cxf 소비자 구성은 독립 실행형 Camel의 구성과 다릅니다. 생산자 엔드 포인트가 정상적으로 작동합니다.

WildFly에서 camel-cxf 소비자는 컨테이너에서 제공하는 기본HTTP 서버를 활용합니다. 서버는 undertow 하위 시스템 구성 내에 정의됩니다. 다음은 standalone.xml의 기본 구성의 요약입니다.

<subsystem xmlns="urn:jboss:domain:undertow:4.0">
    <buffer-cache name="default" />
    <server name="default-server">
        <http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true" />
        <https-listener name="https" socket-binding="https" security-realm="ApplicationRealm" enable-http2="true" />
        <host name="default-host" alias="localhost">
            <location name="/" handler="welcome-content" />
            <filter-ref name="server-header" />
            <filter-ref name="x-powered-by-header" />
            <http-invoker security-realm="ApplicationRealm" />
        </host>
    </server>
</subsystem>
Copy to Clipboard Toggle word wrap

이 예에서는 http 및 https socket-binding으로 지정된 인터페이스 / 포트에서 수신 대기하도록 구성됩니다. 기본적으로 이 포트는 http용 8080이고 https의 경우 8443입니다.

예를 들어 다른 호스트 또는 포트 조합을 사용하여 끝점 소비자를 구성하면 서버 로그 파일 내에 경고가 표시됩니다. 예를 들어 다음 호스트 및 포트 구성은 무시됩니다.

<cxf:rsServer id="cxfRsConsumer"
              address="http://somehost:1234/path/to/resource"
              serviceClass="org.example.ServiceClass" />
Copy to Clipboard Toggle word wrap
<cxf:cxfEndpoint id="cxfWsConsumer"
                 address="http://somehost:1234/path/to/resource"
                 serviceClass="org.example.ServiceClass" />
Copy to Clipboard Toggle word wrap
[org.wildfly.extension.camel] (pool-2-thread-1) Ignoring configured host: http://somehost:1234/path/to/resource
Copy to Clipboard Toggle word wrap

그러나 소비자는 기본 호스트 & 포트 localhost:8080 또는 localhost:8443에서 계속 사용할 수 있습니다.

참고

camel-cxf 소비자를 사용하는 애플리케이션은 WAR로 패키징 해야 합니다. 이전의 WildFly-Camel 릴리스에서는 JAR과 같은 다른 유형의 아카이브가 허용되었지만 더 이상 지원되지 않습니다.

77.1.1. 대체 포트 구성

대체 포트를 수락하려면 WildFly 하위 시스템 구성을 통해 구성해야 합니다. 이는 서버 문서에 설명되어 있습니다.

https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/7.1/html/configuration_guide/configuring_the_web_server_undertow

77.1.2. SSL 구성

SSL을 구성하려면 WildFly SSL 구성 가이드를 참조하십시오.

https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/7.1/html-single/how_to_configure_server_security/#configure_one_way_and_two_way_ssl_tls_for_application

77.1.3. Elytron으로 보안 구성

WildFly-Camel은 Elytron 보안 프레임워크를 사용하여 camel-cxf 소비자 끝점의 보안을 지원합니다.

77.1.3.1. 보안 도메인 구성

Elytron을 사용하여 WildFly-Camel 애플리케이션을 보호하려면 WAR 배포의 1: -INF/jboss-web.xml 내에서 애플리케이션 보안 도메인을 참조해야 합니다.

<jboss-web>
  <security-domain>my-application-security-domain</security-domain>
</jboss-web>
Copy to Clipboard Toggle word wrap

& lt;security-domain > 구성은 DestinationRule 하위 시스템에서 정의한 < application-security-domain >의 이름을 참조합니다. 예를 들어, DestinationRule 하위 시스템 < application-security-domain >은 WildFly 서버 standalone.xml 구성 파일에 다음과 같이 구성됩니다.

<subsystem xmlns="urn:jboss:domain:undertow:6.0">
    ...
    <application-security-domains>
        <application-security-domain name="my-application-security-domain" http-authentication-factory="application-http-authentication"/>
    </application-security-domains>
</subsystem>
Copy to Clipboard Toggle word wrap

& lt;http-authentication-factory > application-http-authentication 은 Elytron 하위 시스템 내에 정의됩니다. application-http-authentication 은 기본적으로 standalone.xmlstandalone-full.xml 서버 구성 파일에서 사용할 수 있습니다. 예를 들면 다음과 같습니다.

<subsystem xmlns="urn:wildfly:elytron:1.2">
    ...
    <http>
        ...
        <http-authentication-factory name="application-http-authentication" http-server-mechanism-factory="global" security-domain="ApplicationDomain">
            <mechanism-configuration>
                <mechanism mechanism-name="BASIC">
                    <mechanism-realm realm-name="Application Realm" />
                </mechanism>
                <mechanism mechanism-name="FORM" />
            </mechanism-configuration>
        </http-authentication-factory>
        <provider-http-server-mechanism-factory name="global" />
    </http>
    ...
</subsystem>
Copy to Clipboard Toggle word wrap

application -http-authentication 이라는 <http-authentication-factory >에는 ApplicationDomain 이라는 Elytron 보안 도메인에 대한 참조가 있습니다.

Elytron 하위 시스템을 구성하는 방법에 대한 자세한 내용은 Elytron 문서 를 참조하십시오.

77.1.3.2. 보안 제약 조건, 인증 방법 및 보안 역할 구성

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>
Copy to Clipboard Toggle word wrap

서블릿 사양으로 정의된 &lt ;url-pattern >은 웹 애플리케이션의 컨텍스트 경로를 기준으로 합니다. 애플리케이션이 my-app.war 로 패키지된 경우 WildFly는 컨텍스트 경로 /my-app 에서 액세스할 수 있도록 하고 < url-patternpattern > /webservices/*/my-app 의 상대 경로에 적용됩니다.

예를 들어 http://my-server/my-app/webservices/my-endpoint 에 대한 요청은 /webservices/* 패턴과 일치하지만 http://my-server/webservices/my-endpoint 는 일치하지 않습니다.

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>
Copy to Clipboard Toggle word wrap
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat