278장. 옵션
REST OpenApi 구성 요소는 아래에 나열된 10 가지 옵션을 지원합니다.
이름 | 설명 | 기본 | 유형 |
---|---|---|---|
basePath (producer) | API basePath(예: /v2). 설정이 설정되지 않은 경우 OpenApi 사양에 있는 값을 덮어씁니다. | 문자열 | |
componentName (producer) | 요청을 수행할 Camel 구성 요소의 이름입니다. 구성 요소는 Camel 레지스트리에 있어야 하며 RestProducerFactory 서비스 공급자 인터페이스를 구현해야 합니다. 설정되지 않은 경우 CLASSPATH 가 RestProducerFactory SPI를 구현하는 단일 구성 요소를 검색합니다. 엔드포인트 구성에서 재정의할 수 있습니다. | 문자열 | |
소비 (producer) | 이 구성 요소를 사용할 수 있는 페이로드 유형은 무엇입니까. RFC7231에 따라 application/json 또는 application/json, application/xml, q=0.5와 같은 하나의 유형일 수 있습니다. 이는 Accept HTTP 헤더의 값과 동일합니다. 설정된 경우 OpenApi 사양에 있는 모든 값을 덮어씁니다. 끝점 구성에서 재정의할 수 있습니다 | 문자열 | |
호스트 (producer) | 스키마 호스트 이름 및 포트: HTTP 요청을 https://hostname:port 형식으로 보냅니다. 엔드포인트, 구성 요소 또는 Camel 컨텍스트의 해당 REST 구성에서 구성할 수 있습니다. 이 구성 요소에 REST 구성이 먼저 참조되는 이름(예: petstore)을 지정하면 다음에 rest-openapi, 전역 구성이 마지막으로 표시됩니다. 설정된 경우 OpenApi 사양에 있는 모든 값을 덮어씁니다. 엔드포인트 구성에서 재정의할 수 있습니다. | 문자열 | |
생성 (producer) | 이 구성 요소를 생성하는 페이로드 유형은 무엇입니까. 예를 들면 RFC7231에 따른 application/json입니다. 이는 Content-Type HTTP 헤더의 값과 동일합니다. 설정된 경우 OpenApi 사양에 있는 모든 값을 덮어씁니다. 엔드포인트 구성에서 재정의할 수 있습니다. | 문자열 | |
specificationUri (producer) | OpenApi 사양 파일의 경로입니다. 스키마, 호스트 기본 경로는 이 사양에서 가져오지만 구성 요소 또는 엔드포인트 수준의 속성으로 재정의할 수 있습니다. 구성 요소가 없으면 openapi.json 리소스를 로드하려고 합니다. 이 구성 요소의 구성 요소 및 끝점에 정의된 호스트에는 스키마, 호스트 이름 및 선택적으로 URI 구문의 포트(예: https://api.example.com:8080)가 포함되어야 합니다. 엔드포인트 구성에서 재정의할 수 있습니다. | openapi.json | URI |
sslContextParameters (보안) | 구성 요소에서 사용하는 TLS 매개변수를 사용자 지정합니다. Camel 컨텍스트에 설정된 TLS 매개변수가 기본값을 설정하지 않는 경우 | SSLContextParameters | |
useGlobalSslContextParameters (security) | 글로벌 SSL 컨텍스트 매개 변수를 사용합니다. | false | boolean |
basicPropertyBinding (advanced) | 구성 요소에서 기본 속성 바인딩(Camel 2.x)을 사용해야 하는지 아니면 추가 기능과 함께 최신 속성 바인딩을 사용할지 여부 | false | boolean |
lazyStartProducer (producer) | 생산자가 지연을 시작해야 하는지 여부(첫 번째 메시지에서). lazy를 시작하면 이를 사용하여 생산자가 시작 중에 실패할 수 있고 경로가 시작되지 않는 상황에서 CamelContext 및 경로가 시작되도록 허용할 수 있습니다. 이 시작이 지연되도록 지연하면 Camel의 라우팅 오류 처리기를 통해 라우팅 메시지 중에 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 생산자를 생성하고 시작하는 데 약간의 시간이 걸릴 수 있으며 처리의 전체 처리 시간을 연장할 수 있습니다. | false | boolean |
REST OpenApi 끝점은 URI 구문을 사용하여 구성됩니다.
rest-openapi:specificationUri#operationId
다음 경로 및 쿼리 매개변수를 사용합니다.
278.1. 경로 매개변수 (2 매개변수):
이름 | 설명 | 기본 | 유형 |
---|---|---|---|
specificationUri | OpenApi 사양 파일의 경로입니다. 스키마, 호스트 기본 경로는 이 사양에서 가져오지만 구성 요소 또는 엔드포인트 수준의 속성으로 재정의할 수 있습니다. 구성 요소가 없으면 classpath에서 openapi.json 리소스를 로드하려고 합니다. 이 구성 요소의 구성 요소 및 끝점에 정의된 호스트에는 스키마, 호스트 이름 및 선택적으로 URI 구문의 포트(예: http://api.example.com:8080)가 포함되어야 합니다. 구성 요소 구성을 덮어씁니다. OpenApi 사양은 file: classpath: http: https: 접두사를 추가하여 다른 소스에서 로드할 수 있습니다. https에 대한 지원은 JDK 설치된 UrlHandler를 사용하는 것으로 제한되므로 https에 대한 TLS/SSL 인증서를 설정하는 것이 번거로울 수 있습니다(예: 여러 javax.net.ssl JVM 시스템 속성 설정). 이 작업을 수행하는 방법은 UrlHandler에 대한 JDK 설명서를 참조하십시오. | openapi.json | URI |
operationId | OpenApi 사양에서 작업의 필수 ID입니다. | 문자열 |