277장. 옵션

REST OpenApi 구성 요소는 아래에 나열된 10 가지 옵션을 지원합니다.

이름설명Default유형

basePath (producer)

API basePath(예: /v2) OpenApi 사양에 있는 값을 재정의하는 경우 기본값은 설정되지 않습니다.

 

문자열

componentName (producer)

요청을 수행할 Camel 구성 요소의 이름입니다. 구성 요소는 Camel 레지스트리에 있어야 하며 RestProducerECDHEy 서비스 공급자 인터페이스를 구현해야 합니다. 설정되어 있지 않은 경우 CLASSPATH가 RestProducerECDHEy SPI를 구현하는 단일 구성 요소를 검색합니다. 끝점 구성에서 재정의할 수 있습니다.

 

문자열

소비 (producer)

사용할 수 있는 페이로드 유형은 무엇입니까. RFC7231에 따라 application/json 또는 application/xml; q=0.5와 같은 하나의 유형일 수 있습니다. 이는 Accept HTTP 헤더 값과 동일합니다. 설정된 경우 OpenApi 사양에 있는 값을 덮어씁니다. 끝점 구성에서 재정의할 수 있습니다.

 

문자열

호스트 (producer)

HTTP 요청을 https://hostname:port 형식으로 보내는 스키마 호스트 이름 및 포트 엔드포인트, 구성 요소 또는 Camel 컨텍스트의 해당 REST 구성에서 구성할 수 있습니다. REST 구성이 먼저 참조되고 rest-openapi next, 글로벌 구성이 마지막으로 이 구성 요소에 이름(예: petstore)을 지정하면 됩니다. 설정된 경우 OpenApi 사양인 RestConfiguration에 있는 값을 덮어씁니다. 끝점 구성에서 재정의할 수 있습니다.

 

문자열

생성 (producer)

이 구성 요소가 생성하는 페이로드 유형은 무엇입니까. 예를 들어 RFC7231에 따른 애플리케이션/json입니다. 이는 Content-Type HTTP 헤더의 값과 동일합니다. 설정된 경우 OpenApi 사양에 있는 값을 덮어씁니다. 끝점 구성에서 재정의할 수 있습니다.

 

문자열

specUri (producer)

OpenApi 사양 파일의 경로입니다. 스키마인 호스트 기본 경로는 이 사양에서 가져오지만 구성 요소 또는 끝점 수준의 속성으로 재정의할 수 있습니다. 지정하지 않으면 구성 요소가 openapi.json 리소스를 로드하려고 합니다. 이 Component의 구성 요소 및 끝점에 정의된 호스트에는 URI 구문에 있는 스키마, 호스트 이름 및 선택적 포트(예: https://api.example.com:8080)가 포함되어야 합니다. 끝점 구성에서 재정의할 수 있습니다.

openapi.json

URI

sslContextParameters (security)

구성 요소에서 사용하는 TLS 매개변수를 사용자 정의합니다. 설정되지 않은 경우, 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 매개변수):

이름설명Default유형

specificationUri

OpenApi 사양 파일의 경로입니다. 스키마인 호스트 기본 경로는 이 사양에서 가져오지만 구성 요소 또는 끝점 수준의 속성으로 재정의할 수 있습니다. 지정하지 않으면 classpath에서 openapi.json 리소스를 로드하려고 합니다. 이 Component의 구성 요소 및 끝점에 정의된 호스트에는 URI 구문에 있는 스키마, 호스트 이름 및 선택적 포트(예: http://api.example.com:8080)가 포함되어야 합니다. 구성 요소 구성을 덮어씁니다. OpenApi 사양은 file: classpath: http: https: 접두사로 다른 소스에서 로드할 수 있습니다. https에 대한 지원은 JDK가 설치된 UrlHandler를 사용하는 것으로 제한되며, 따라서 https에 대한 TLS/SSL 인증서(예: 여러 javax.net.ssl JVM 시스템 속성 설정)를 설정하는 것이 번거로워질 수 있습니다. How to do that consult the JDK documentation for UrlHandler.

openapi.json

URI

operationId

OpenApi 사양에서 작업의 필수 ID입니다.

 

문자열