282.2. 옵션
Restlet 구성 요소는 아래에 나열된 23개의 옵션을 지원합니다.
| 이름 | 설명 | 기본 | 유형 |
|---|---|---|---|
| controllerDaemon (consumer) | 컨트롤러 스레드가 데몬인지 여부를 나타냅니다(JVM 종료를 차단하지 않음). | 부울 | |
| controllerSleepTimeMs (consumer) | 컨트롤러 스레드가 각 컨트롤 간에 유휴 상태가 되는 시간입니다. | 정수 | |
| headerFilterStrategy (filter) | 사용자 정의 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지로의 헤더를 필터링합니다. | HeaderFilterStrategy | |
| inboundBufferSize (consumer) | 메시지를 읽을 때 버퍼의 크기입니다. | 정수 | |
| maxConnectionsPerHost (공용) | 호스트당 최대 동시 연결 수(IP 주소)입니다. | 정수 | |
| maxThreads (consumer) | 요청을 서비스할 최대 스레드 수입니다. | 정수 | |
| lowThreads (consumer) | 커넥터가 오버로드된 것으로 간주될 시기를 결정하는 작업자 스레드 수입니다. | 정수 | |
| maxTotalConnections (공용) | 총 최대 동시 연결 수입니다. | 정수 | |
| minThreads (consumer) | 서비스 요청을 기다리는 최소 스레드. | 정수 | |
| outboundBufferSize (consumer) | 메시지를 작성할 때 버퍼의 크기입니다. | 정수 | |
| 연결 유지(consumer) | 호출 후 연결을 활성 상태로 유지해야 하는지 여부를 나타냅니다. | 부울 | |
| pipeliningConnections (consumer) | pipelining 연결이 지원되는지 여부를 나타냅니다. | 부울 | |
| threadMaxIdleTimeMs (consumer) | 유휴 스레드가 수집되기 전에 작업을 기다리는 시간입니다. | 정수 | |
| useForwardedForHeader (consumer) | 일반적인 프록시 및 캐시에서 지원하는 X-Forwarded-For 헤더를 조회하고 이를 사용하여 Request.getClientAddresses() 메서드 결과를 채웁니다. 이 정보는 로컬 네트워크 내의 중간 구성 요소에만 안전합니다. 다른 주소는 페이크 헤더를 설정하여 쉽게 변경할 수 있으며 심각한 보안 검사를 신뢰해서는 안 됩니다. | 부울 | |
| reuseAddress (consumer) | SO_REUSEADDR 소켓 옵션을 활성화/비활성화합니다. 자세한 내용은 java.io.ServerSocket#reuseAddress 속성을 참조하십시오. | 부울 | |
| maxQueued (consumer) | 서비스에 사용할 수 있는 작업자 스레드가 없는 경우 큐에 지정할 수 있는 최대 호출 수입니다. 값이 '0'이면 큐가 사용되지 않으며 작업자 스레드를 즉시 사용할 수 없는 경우 호출이 거부됩니다. 값이 '-1'이면 바인딩되지 않은 큐가 사용되며 호출은 거부되지 않습니다. | 정수 | |
| disableStreamCache (consumer) | Restlet의 원시 입력 스트림이 캐시되었는지 여부를 결정합니다(Camel은 파일, 스트림 캐싱으로 스트림을 메모리/오플로우의 스트림으로 읽습니다.) 기본적으로 Camel은 Restlet 입력 스트림을 캐시하여 Camel이 스트림에서 모든 데이터를 검색할 수 있도록 여러 번 읽기를 지원합니다. 그러나 예를 들어 파일 또는 기타 영구 저장소로 직접 스트리밍하는 등 원시 스트림에 액세스해야 하는 경우 이 옵션을 true로 설정할 수 있습니다. DefaultRestletBinding은 요청 입력 스트림을 스트림 캐시에 복사하고 이 옵션이 false인 경우 스트림을 여러 번 읽을 수 있도록 메시지 본문에 배치합니다. | false | boolean |
| 포트 (Consumer) | restlet 소비자 경로의 포트 번호를 구성하려면 다음을 수행합니다. 이를 통해 이러한 소비자에 대해 동일한 포트를 재사용하도록 이 포트를 한 번 구성할 수 있습니다. | int | |
| 동기 (producer) | 생산자에 동기 Restlet 클라이언트를 사용할지 여부입니다. 이 옵션을 true로 설정하면 Restlet synchronous Client가 더 잘 작동하는 것처럼 보이므로 성능이 더 빨라질 수 있습니다. | 부울 | |
| enabledConverters (advanced) | 전체 클래스 이름 또는 간단한 클래스 이름으로 사용할 수 있는 변환기 목록입니다. 모든 변환기가 자동으로 등록되거나 비어 있거나 null인 경우 활성화됩니다. | list | |
| useGlobalSslContext Parameters (보안) | 글로벌 SSL 컨텍스트 매개 변수를 사용합니다. | false | boolean |
| sslContextParameters (보안) | SSLContextParameters를 사용하여 보안을 구성하려면 다음을 수행합니다. | SSLContextParameters | |
| resolveProperty Placeholders (advanced) | 구성 요소 시작 시 속성 자리 표시자를 자체적으로 확인해야 하는지 여부입니다. String 유형의 속성만 속성 자리 표시자를 사용할 수 있습니다. | true | boolean |
Restlet 끝점은 URI 구문을 사용하여 구성됩니다.
restlet:protocol:host:port/uriPattern
다음 경로 및 쿼리 매개변수를 사용합니다.
282.2.1. 경로 매개변수 (4 매개변수):
| 이름 | 설명 | 기본 | 유형 |
|---|---|---|---|
| 프로토콜 | 필수 프로토콜(HTTP 또는 https)입니다. | 문자열 | |
| host | restlet 서비스의 호스트 이름 | 문자열 | |
| port | 필요한 restlet 서비스의 포트 번호 | 80 | int |
| uriPattern | /customer/id와 같은 리소스 패턴 | 문자열 |
282.2.2. 쿼리 매개변수 (18 매개변수):
| 이름 | 설명 | 기본 | 유형 |
|---|---|---|---|
| restletMethod (일반) | 생산자 끝점에서 사용할 요청 메서드를 지정합니다. 소비자 끝점에서 끝점이 restletMethod 요청만 사용하도록 지정합니다. | GET | 방법 |
| bridgeErrorHandler (consumer) | Camel 라우팅 오류 처리기에 소비자를 브리징할 수 있습니다. 즉, 소비자가 들어오는 메시지를 선택하려고 하는 동안 발생한 모든 예외가 이제 메시지로 처리되고 라우팅 오류 처리기에서 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 기록되고 무시됩니다. | false | boolean |
| restletMethods (consumer) | restlet 소비자 엔드포인트에서 서비스할 쉼표(예: restletMethods=post,put)로 구분된 하나 이상의 메서드를 지정합니다. restletMethod 및 restletMethods 옵션이 모두 지정되면 restletMethod 설정이 무시됩니다. 가능한 방법은 ALL,CONNECT,DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,TRACE입니다. | 문자열 | |
| disableStreamCache (consumer) | Restlet의 원시 입력 스트림이 캐시되었는지 여부를 결정합니다(Camel은 파일, 스트림 캐싱으로 스트림을 메모리/오플로우의 스트림으로 읽습니다.) 기본적으로 Camel은 Restlet 입력 스트림을 캐시하여 Camel이 스트림에서 모든 데이터를 검색할 수 있도록 여러 번 읽기를 지원합니다. 그러나 예를 들어 파일 또는 기타 영구 저장소로 직접 스트리밍하는 등 원시 스트림에 액세스해야 하는 경우 이 옵션을 true로 설정할 수 있습니다. DefaultRestletBinding은 요청 입력 스트림을 스트림 캐시에 복사하고 이 옵션이 false인 경우 스트림을 여러 번 읽을 수 있도록 메시지 본문에 배치합니다. | false | boolean |
| exceptionHandler (consumer) | 사용자가 사용자 지정 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션이 사용되지 않습니다. 기본적으로 소비자는 WARN 또는 ERROR 수준에서 기록되고 무시됩니다. | ExceptionHandler | |
| exchangePattern (consumer) | 소비자가 교환을 생성할 때 교환 패턴을 설정합니다. | ExchangePattern | |
| restletUriPatterns (consumer) | 더 이상 사용되지 않는 경우 # 표기법을 사용하여 Camel Registry의 목록을 참조하여 restlet 소비자 엔드포인트에서 서비스할 하나 이상의 URI 템플릿을 지정합니다. URI 패턴이 끝점 URI에 정의된 경우 엔드포인트 및 restletUriPatterns 옵션에 정의된 URI 패턴이 모두 적용됩니다. | list | |
| ConnectTimeout (producer) | 연결이 시간 초과되면 클라이언트가 연결을 포기합니다. 무제한 대기의 경우 0입니다. | 30000 | int |
| cookieHandler (producer) | HTTP 세션을 유지 관리하도록 쿠키 처리기 구성 | CookieHandler | |
| socketTimeout (producer) | 클라이언트 소켓은 무제한 대기의 경우 0인 시간 초과를 수신합니다. | 30000 | int |
| throwExceptionOnFailure (producer) | 생산자 실패 시 예외를 throw할지 여부입니다. 이 옵션이 false이면 http 상태 코드가 오류 값이 있는지 확인할 수 있는 메시지 헤더로 설정됩니다. | true | boolean |
| autoCloseStream (producer) | restlet 생산자를 사용하여 REST 서비스를 호출하는 응답으로 스트림 표시를 자동으로 닫을지 여부입니다. 응답이 스트리밍이고 옵션 스트림 대표가 활성화되면 스트리밍 응답에서 InputStream을 자동으로 종료하여 Camel Exchange가 라우팅되고 있을 때 입력 스트림이 종료되도록 할 수 있습니다. 그러나 Camel 경로 외부에서 스트림을 읽어야 하는 경우 스트림을 자동으로 종료하지 않아야 할 수 있습니다. | false | boolean |
| 스트림 표현 (producer) | restlet 생산자를 사용하여 REST 서비스를 호출하는 응답으로 스트림 표현을 지원할지 여부입니다. 응답이 스트리밍인 경우 이 옵션을 사용하여 java.io.InputStream을 Camel Message 본문에서 메시지 본문으로 사용할 수 있습니다. 이 옵션을 사용하는 경우 Camel Exchange가 라우팅되는 경우 입력 스트림이 종료되도록 Auto CloseStream 옵션을 활성화할 수도 있습니다. 그러나 Camel 경로 외부에서 스트림을 읽어야 하는 경우 스트림을 자동으로 종료하지 않아야 할 수 있습니다. | false | boolean |
| headerFilterStrategy (advanced) | 사용자 정의 HeaderFilterStrategy를 사용하여 Camel 메시지로의 헤더를 필터링하려면 다음을 수행합니다. | HeaderFilterStrategy | |
| restletBinding (advanced) | 사용자 지정 RestletBinding을 사용하여 Restlet과 Camel 메시지 간에 바인딩하려면 다음을 수행합니다. | RestletBinding | |
| 동기 (고급) | 동기 처리를 엄격하게 사용해야 하는지 또는 Camel이 비동기 처리를 사용할 수 있는지 여부를 설정합니다(지원되는 경우). | false | boolean |
| restletRealm (보안) | restlet의 보안 영역을 맵으로 구성하려면 다음을 수행합니다. | map | |
| sslContextParameters (보안) | SSLContextParameters를 사용하여 보안을 구성하려면 다음을 수행합니다. | SSLContextParameters |
