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