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 |