79.2. 옵션
CXF-RS 구성 요소는 아래에 나열된 세 가지 옵션을 지원합니다.
이름 | 설명 | 기본 | 유형 |
---|---|---|---|
useGlobalSslContext Parameters (보안) | 글로벌 SSL 컨텍스트 매개 변수를 사용합니다. | false | boolean |
headerFilterStrategy (filter) | 사용자 정의 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지로의 헤더를 필터링합니다. | HeaderFilterStrategy | |
resolveProperty Placeholders (advanced) | 구성 요소 시작 시 속성 자리 표시자를 자체적으로 확인해야 하는지 여부입니다. String 유형의 속성만 속성 자리 표시자를 사용할 수 있습니다. | true | boolean |
CXF-RS 끝점은 URI 구문을 사용하여 구성됩니다.
cxfrs:beanId:address
다음 경로 및 쿼리 매개변수를 사용합니다.
79.2.1. 경로 매개변수 (2 매개변수):
이름 | 설명 | 기본 | 유형 |
---|---|---|---|
beanId | 구성된 기존 CxfRsEndpoint를 조회하려면 다음을 수행합니다. Buildah:를 접두사로 사용해야 합니다. | 문자열 | |
address | 서비스는 주소를 게시합니다. | 문자열 |
79.2.2. 쿼리 매개변수 (30 매개변수):
이름 | 설명 | 기본 | 유형 |
---|---|---|---|
기능 (일반) | 기능 목록을 CxfRs 끝점으로 설정합니다. | list | |
loggingFeatureEnabled (common) | 이 옵션을 사용하면 인바운드 및 아웃바운드 REST 메시지를 로그에 쓰는 CXF 로깅 기능을 사용할 수 있습니다. | false | boolean |
loggingSizeLimit (common) | 총 바이트 수를 제한하기 위해 로깅 기능이 활성화된 경우 로거는 출력됩니다. | int | |
modelRef (공용) | 이 옵션은 주석 없이 리소스 클래스에 유용한 모델 파일을 지정하는 데 사용됩니다. 이 옵션을 사용하는 경우 문서 전용 엔드포인트를 에뮬레이션하기 위해 서비스 클래스를 생략할 수 있습니다. | 문자열 | |
공급자 (공용) | 사용자 지정 Cryostat-RS 공급자 목록을 CxfRs 엔드포인트로 설정합니다. registy에서 쉼표로 구분된 공급자 목록을 사용하여 문자열을 지정할 수 있습니다. | 문자열 | |
리소스 클래스 (공용) | REST 서비스로 내보낼 리소스 클래스입니다. 여러 클래스를 쉼표로 구분할 수 있습니다. | list | |
schemaLocations (공용) | 들어오는 XML 또는 CryostatB 기반 JSON의 유효성을 검사하는 데 사용할 수 있는 스키마의 위치를 설정합니다. | list | |
skipFaultLogging (common) | 이 옵션은 PhaseInterceptor Cryostat가 캡처한 Fault를 로깅하는지 여부를 제어합니다. | false | boolean |
bindingStyle (consumer) | Camel에 요청 및 응답을 매핑/에서 매핑하는 방법을 설정합니다. 두 가지 값을 사용할 수 있습니다: SimpleConsumer: 이 바인딩 스타일은 요청 매개 변수, multiparts 등을 처리하고 IN 헤더, IN 첨부 파일 및 메시지 본문에 매핑됩니다. org.apache.cxf.message.MessageContentsList의 하위 수준 처리를 제거하는 것을 목표로 합니다. 또한 응답 매핑에 더 많은 유연성과 단순성을 추가합니다. 소비자만 사용할 수 있습니다. 기본값: 기본 형식입니다. 소비자의 경우 MessageContentsList를 경로로 전달하므로 경로에서 낮은 수준의 처리가 필요합니다. 이는 CXF 스택에서 IN 메시지 본문으로 들어오는 org.apache.cxf.message.MessageContentsList를 간단히 덤프하는 기존 바인딩 스타일입니다. 그런 다음 사용자는 Cryostat-RS 메서드 서명에 의해 정의된 계약에 따라 이를 처리합니다. custom: 바인딩 옵션을 통해 사용자 지정 바인딩을 지정할 수 있습니다. | 기본 | BindingStyle |
bridgeErrorHandler (consumer) | Camel 라우팅 오류 처리기에 소비자를 브리징할 수 있습니다. 즉, 소비자가 들어오는 메시지를 선택하려고 하는 동안 발생한 모든 예외가 이제 메시지로 처리되고 라우팅 오류 처리기에서 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 기록되고 무시됩니다. | false | boolean |
publishedEndpointUrl (consumer) | 이 옵션은 리소스 주소 URL과 _wadl으로 액세스할 수 있는 WADL에서 게시된 endpointUrl을 재정의할 수 있습니다. | 문자열 | |
exceptionHandler (consumer) | 사용자가 사용자 지정 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션이 사용되지 않습니다. 기본적으로 소비자는 WARN 또는 ERROR 수준에서 기록되고 무시됩니다. | ExceptionHandler | |
exchangePattern (consumer) | 소비자가 교환을 생성할 때 교환 패턴을 설정합니다. | ExchangePattern | |
serviceBeans (consumer) | REST 서비스로 내보낼 서비스 빈입니다. 여러 빈은 쉼표로 구분할 수 있습니다. | list | |
cookieHandler (producer) | HTTP 세션을 유지 관리하도록 쿠키 처리기 구성 | CookieHandler | |
HostnameVerifier (producer) | 사용할 호스트 이름 확인기입니다. # 표기법을 사용하여 레지스트리의 HostnameVerifier를 참조합니다. | HostnameVerifier | |
sslContextParameters (producer) | Camel SSL 설정 참조. # 표기법을 사용하여 SSL 컨텍스트를 참조합니다. | SSLContextParameters | |
throwExceptionOnFailure (producer) | 이 옵션은 CxfRsProducer에 반환 코드를 검사하도록 지시하고 반환 코드가 207보다 큰 경우 예외를 생성합니다. | true | boolean |
httpClientAPI (producer) | true인 경우 CxfRsProducer은 CryostatClientAPI를 사용하여 서비스를 호출합니다. false인 경우 CxfRsProducer에서 ProxyClientAPI를 사용하여 서비스를 호출합니다. | true | boolean |
ignoreDeleteMethodMessage Body (producer) | 이 옵션은 HTTP API를 사용할 때 CxfRsProducer에 DELETE 메서드의 메시지 본문을 무시하도록 지시하는 데 사용됩니다. | false | boolean |
maxClientCacheSize (producer) | 이 옵션을 사용하면 최대 캐시 크기를 구성할 수 있습니다. 이 구현에서는 CxfProvider 및 CxfRsProvider에서 CXF 클라이언트 또는 ClientFactoryBean을 캐시합니다. | 10 | int |
바인딩 (고급) | 사용자 지정 CxfBinding을 사용하여 Camel Message와 CXF Message 간의 바인딩을 제어합니다. | CxfRsBinding | |
버스 (고급) | 사용자 지정 구성된 CXF 버스를 사용하려면 다음을 수행합니다. | 버스 | |
연속 시간 (advanced) | 이 옵션은 CXF 서버가 Cryostat 또는 Servlet 전송을 사용할 때 기본적으로 CxfConsumer에서 사용할 수 있는 CXF 연속 타임아웃을 설정하는 데 사용됩니다. | 30000 | long |
cxfRsEndpointConfigurer (advanced) | 이 옵션은 프로그래밍 방식으로 CXF 엔드포인트를 구성하도록 지원하는 org.apache.camel.component.cxf.jaxrs.CxfRsEndpointConfigurer의 구현을 적용할 수 있습니다. 사용자는 CxfEndpointConfigurer의 configureServer/Client 메서드를 구현하여 CXF 서버 및 클라이언트를 구성할 수 있습니다. | CxfRsEndpoint Configurer | |
defaultBus (고급) | CXF 끝점이 자체적으로 버스를 생성할 때 기본 버스를 설정합니다. | false | boolean |
headerFilterStrategy (advanced) | 사용자 정의 HeaderFilterStrategy를 사용하여 Camel 메시지로의 헤더를 필터링하려면 다음을 수행합니다. | HeaderFilterStrategy | |
performInvocation (advanced) | 옵션이 true인 경우 Camel은 리소스 클래스 인스턴스를 호출하고 추가 처리를 위해 응답 오브젝트를 교환에 배치합니다. | false | boolean |
propagateContexts (advanced) | 옵션이 true인 경우, CryostatRS UriInfo, CryostatHeaders, Request 및 SecurityContext 컨텍스트를 형식화된 Camel 교환 속성으로 사용자 지정 CXFRS 프로세서에 사용할 수 있습니다. 이러한 컨텍스트는 Cryostat-RS API를 사용하여 현재 요청을 분석하는 데 사용할 수 있습니다. | false | boolean |
동기 (고급) | 동기 처리를 엄격하게 사용해야 하는지 또는 Camel이 비동기 처리를 사용할 수 있는지 여부를 설정합니다(지원되는 경우). | false | boolean |