4.2. AHC-WS 옵션

AHC-WS 구성 요소는 AHC 구성 요소를 기반으로 하므로 AHC 구성 요소의 다양한 구성 옵션을 사용할 수 있습니다.

AHC Websocket 구성 요소는 아래에 나열된 8 가지 옵션을 지원합니다.

이름설명Default유형

클라이언트 (고급)

사용자 지정 AsyncHttpClient 사용

 

AsyncHttpClient

바인딩 (고급)

AHC와 Camel 간에 바인딩하는 방법을 제어할 수 있는 사용자 지정 AhcBinding을 사용하려면 다음을 수행합니다.

 

AhcBinding

clientConfig (고급)

사용자 지정 com.ning.http.client.AsyncHttpClientConfig 인스턴스를 사용하도록 AsyncHttpClient를 구성하려면 다음을 수행합니다.

 

AsyncHttpClientConfig

sslContextParameters (security)

레지스트리의 org.apache.camel.util.jsse.SSLContextParameters에 대한 참조입니다. 이 옵션을 구성하면 끝점 또는 구성 요소 수준에서 clientConfig 옵션을 통해 제공되는 모든 SSL/TLS 구성 옵션이 재정의됩니다.

 

SSLContextParameters

allowJavaSerialized Object (advanced)

요청이 context-type=application/x-java-serialized-object를 사용할 때 java 직렬화를 허용할지 여부입니다. 이는 기본적으로 해제되어 있습니다. 이 값을 사용하도록 설정하면 Java에서 요청에서 Java로 들어오는 데이터를 역직렬화하고 잠재적인 보안 위험이 될 수 있습니다.

false

boolean

UseGlobalSslContext 매개변수 (보안)

글로벌 SSL 컨텍스트 매개 변수 사용을 활성화합니다.

false

boolean

headerFilterStrategy (filter)

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지로 헤더를 필터링합니다.

 

HeaderFilterStrategy

resolvePropertyECDHEholders (advanced)

구성 요소가 시작할 때 속성 자리 표시자를 확인해야 하는지 여부입니다. String 유형의 속성만 속성 자리 표시자를 사용할 수 있습니다.Only properties which are of String type can use property placeholders.

true

boolean

AHC Websocket 엔드포인트는 URI 구문을 사용하여 구성됩니다.

ahc-ws:httpUri

다음 경로 및 쿼리 매개변수를 사용합니다.

4.2.1. 경로 매개변수 (1 매개변수):

이름설명Default유형

httpUri

필수: http://hostname:port/path와 같이 사용할 URI입니다.

 

URI

4.2.2. 쿼리 매개변수(18 매개변수):

이름설명Default유형

bridgeEndpoint (common)

옵션이 true인 경우 Exchange.HTTP_URI 헤더가 무시되고 요청에 끝점의 URI를 사용합니다. AhcProducer에서 모든 오류 응답을 다시 보낼 수 있도록 throwExceptionOnFailure를 false로 설정할 수도 있습니다.

false

boolean

bufferSize (common)

Camel과 AHC 클라이언트 간에 데이터를 전송할 때 사용되는 초기 메모리 버퍼 크기입니다.

4096

int

headerFilterStrategy (common)

사용자 정의 HeaderFilterStrategy를 사용하여 Camel 메시지로 헤더를 필터링합니다.

 

HeaderFilterStrategy

throwExceptionOnFailure (common)

원격 서버에서 응답이 실패한 경우 AhcOperationFailedException을 비활성화하는 옵션입니다. 이를 통해 HTTP 상태 코드에 관계없이 모든 응답을 가져올 수 있습니다.

true

boolean

transferException (common)

소비자 측에서 활성화 및 Exchange에 실패한 처리가 실패하고, 원인으로 인해 예외가 응답에서 application/x-java-serialized-object 콘텐츠 유형으로 다시 직렬화되었습니다(예:ECDHEty 또는 Servlet Camel 구성 요소 사용). 생산자 측에서 예외는 역직렬화되고 AhcOperationFailedException 대신 그대로 throw됩니다. 원인된 예외가 직렬화되어야 합니다. 이는 기본적으로 해제되어 있습니다. 이 값을 사용하도록 설정하면 Java에서 요청에서 Java로 들어오는 데이터를 역직렬화하고 잠재적인 보안 위험이 될 수 있습니다.

false

boolean

bridgeErrorHandler (consumer)

소비자가 수신되는 메시지를 선택하려고 하는 동안 예외가 발생했음을 나타내는 Camel 라우팅 오류 처리기에 소비자를 브리징할 수 있습니다. 즉, 소비자가 수신되는 메시지를 선택하려고 하는 동안 예외가 발생되거나 이제 메시지로 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.Exception handler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

false

boolean

sendMessageOnError (consumer)

웹 소켓 리스너에 오류가 수신될 경우 메시지를 보낼지 여부입니다.

false

boolean

예외 처리기 (consumer)

소비자가 사용자 지정 예외 처리기를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션이 사용되지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer)

소비자가 교환을 생성할 때 교환 패턴을 설정합니다.

 

ExchangePattern

connectionECDHE (producer)

연결 닫기 헤더를 HTTP 요청에 추가해야 하는지 정의합니다. 이 매개변수는 기본적으로 false입니다.

false

boolean

cookieHandler (producer)

HTTP 세션을 유지하도록 쿠키 처리기 구성

 

CookieHandler

UseStreaming (producer)

스트리밍을 활성화하여 여러 텍스트 조각으로 데이터를 보낼 수 있습니다.

false

boolean

바인딩 (고급)

AHC와 Camel 간에 바인딩하는 방법을 제어할 수 있는 사용자 지정 AhcBinding을 사용하려면 다음을 수행합니다.

 

AhcBinding

clientConfig (고급)

사용자 지정 com.ning.http.client.AsyncHttpClientConfig 인스턴스를 사용하도록 AsyncHttpClient를 구성하려면 다음을 수행합니다.

 

AsyncHttpClientConfig

clientConfigOptions (고급)

맵의 키/값을 사용하여 AsyncHttpClientConfig를 구성하려면 다음을 수행합니다.

 

map

동기 (고급)

동기 처리를 엄격하게 사용해야 하는지 또는 Camel이 비동기 처리(지원되는 경우)를 사용할 수 있는지 여부를 설정합니다.

false

boolean

clientConfigRealmOptions (security)

맵의 키/값을 사용하여 AsyncHttpClientConfigECDHE를 구성하려면 다음을 수행합니다.

 

map

sslContextParameters (security)

레지스트리의 org.apache.camel.util.jsse.SSLContextParameters에 대한 참조입니다. 이 참조는 구성 요소 수준에서 구성된 모든 SSLContextParameter를 재정의합니다. JSSE 구성의 사용을 참조하십시오. 이 옵션을 구성하면 끝점 또는 구성 요소 수준에서 clientConfig 옵션을 통해 제공되는 모든 SSL/TLS 구성 옵션이 재정의됩니다.

 

SSLContextParameters