301.2. 옵션
서블릿 구성 요소는 아래에 나열된 9 가지 옵션을 지원합니다.
| 이름 | 설명 | 기본 | 유형 |
|---|---|---|---|
| servletName (consumer) | 사용할 서블릿의 기본 이름입니다. 기본 이름은 CamelServlet입니다. | CamelServlet | 문자열 |
| httpRegistry (consumer) | 사용자 정의 org.apache.camel.component.servlet.HttpRegistry를 사용합니다. | HttpRegistry | |
| attachmentMultipart 바인딩 (consumer) | Camel 교환의 첨부 파일로 multipart/form-data를 자동으로 바인딩할지 여부입니다. attachmentMultipartBinding=true 및 disableStreamCache=false 옵션은 함께 작동할 수 없습니다. AttachmentMultipartBinding을 사용하려면 disableStreamCache를 제거합니다. 이 설정은 Servlet's를 사용할 때 이를 활성화하기 위해 서블릿 특정 구성이 필요할 수 있으므로 기본적으로 꺼집니다. | false | boolean |
| fileNameExtWhitelist (consumer) | 업로드된 파일을 수락하기 위해 허용되는 파일 이름 확장의 허용 목록. 여러 확장 프로그램은 txt,xml과 같이 쉼표로 구분할 수 있습니다. | 문자열 | |
| httpBinding (advanced) | 사용자 지정 CryostatBinding을 사용하여 Camel 메시지와 CryostatClient 간의 매핑을 제어하려면 다음을 수행합니다. | HttpBinding | |
| httpConfiguration (고급) | 공유 CryostatConfiguration을 기본 구성으로 사용하려면 다음을 수행합니다. | HttpConfiguration | |
| allowJavaSerialized Object (advanced) | 요청에서 context-type=application/x-java-serialized-object를 사용할 때 java serialization을 허용할지 여부입니다. 이는 기본적으로 꺼져 있습니다. 이를 활성화하면 Java에서 요청에서 Java로 들어오는 데이터를 역직렬화하고 잠재적인 보안 위험이 될 수 있습니다. | false | boolean |
| headerFilterStrategy (filter) | 사용자 정의 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지로의 헤더를 필터링합니다. | HeaderFilterStrategy | |
| resolveProperty Placeholders (advanced) | 구성 요소 시작 시 속성 자리 표시자를 자체적으로 확인해야 하는지 여부입니다. String 유형의 속성만 속성 자리 표시자를 사용할 수 있습니다. | true | boolean |
Servlet 끝점은 URI 구문을 사용하여 구성됩니다.
servlet:contextPath
다음 경로 및 쿼리 매개변수를 사용합니다.
301.2.1. 경로 매개변수(1 매개변수):
| 이름 | 설명 | 기본 | 유형 |
|---|---|---|---|
| contextPath | 사용할 context-path | 문자열 |
301.2.2. 쿼리 매개변수(22 매개변수):
| 이름 | 설명 | 기본 | 유형 |
|---|---|---|---|
| disableStreamCache (common) | 서블릿의 원시 입력 스트림이 캐시되었는지 여부를 결정합니다(Camel은 파일, 스트림 캐싱으로 스트림을 메모리/오플로우에서 파일로 읽습니다) 캐시로 읽습니다. 기본적으로 Camel은 서블릿 입력 스트림을 캐시하여 Camel이 스트림에서 모든 데이터를 검색할 수 있도록 여러 번 읽습니다. 그러나 예를 들어 파일 또는 기타 영구 저장소로 직접 스트리밍하는 등 원시 스트림에 액세스해야 하는 경우 이 옵션을 true로 설정할 수 있습니다. DefaultHttpBinding은 요청 입력 스트림을 스트림 캐시에 복사하여 스트림을 여러 번 읽기를 지원하기 위해 이 옵션이 false인 경우 메시지 본문에 넣습니다. Servlet을 사용하여 끝점을 브리지/proxy하는 경우 메시지 페이로드를 여러 번 읽을 필요가 없는 경우 이 옵션을 사용하여 성능을 향상시키는 것이 좋습니다. http/http4 생산자는 기본적으로 응답 본문 스트림을 캐시합니다. 이 옵션을 true로 설정하면 생산자가 응답 본문 스트림을 캐시하지 않지만 응답 스트림을 메시지 본문으로 사용합니다. | false | boolean |
| headerFilterStrategy (common) | 사용자 정의 HeaderFilterStrategy를 사용하여 Camel 메시지로의 헤더를 필터링하려면 다음을 수행합니다. | HeaderFilterStrategy | |
| httpBinding (common) | 사용자 지정 CryostatBinding을 사용하여 Camel 메시지와 CryostatClient 간의 매핑을 제어하려면 다음을 수행합니다. | HttpBinding | |
| async (consumer) | async 모드에서 작동하도록 소비자 구성 | false | boolean |
| bridgeErrorHandler (consumer) | Camel 라우팅 오류 처리기에 소비자를 브리징할 수 있습니다. 즉, 소비자가 들어오는 메시지를 선택하려고 하는 동안 발생한 모든 예외가 이제 메시지로 처리되고 라우팅 오류 처리기에서 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 기록되고 무시됩니다. | false | boolean |
| 청크 (consumer) | 이 옵션이 false인 경우 Servlet은 HTTP 스트리밍을 비활성화하고 응답에서 content-length 헤더를 설정합니다. | true | boolean |
| httpMethodRestrict (consumer) | GET/POST/PUT 등과 같이 CryostatMethod가 일치하는 경우에만 사용을 허용하는 데 사용됩니다. 여러 메서드를 쉼표로 구분할 수 있습니다. | 문자열 | |
| matchOnUriPrefix (consumer) | 정확히 일치하는 항목이 없는 경우 소비자가 URI 접두사와 일치하여 대상 소비자를 찾아야 하는지 여부입니다. | false | boolean |
| responseBufferSize (consumer) | javax.servlet.Servlet.ServletResponse에서 사용자 지정 버퍼 크기를 사용합니다. | 정수 | |
| servletName (consumer) | 사용할 서블릿의 이름 | CamelServlet | 문자열 |
| transferException (consumer) | 소비자 측에서 활성화 및 교환에 실패한 경우, 발생한 Exception이 응답에서 애플리케이션/x-java-serialized-object 콘텐츠 유형으로 직렬화된 경우. 프로듀서 측에서 예외는 역직렬화되고 is가 아니라 is로 throw됩니다. 발생한 예외를 직렬화해야 합니다. 이는 기본적으로 꺼져 있습니다. 이를 활성화하면 Java에서 요청에서 Java로 들어오는 데이터를 역직렬화하고 잠재적인 보안 위험이 될 수 있습니다. | false | boolean |
| attachmentMultipartBinding (consumer) | Camel 교환의 첨부 파일로 multipart/form-data를 자동으로 바인딩할지 여부입니다. attachmentMultipartBinding=true 및 disableStreamCache=false 옵션은 함께 작동할 수 없습니다. AttachmentMultipartBinding을 사용하려면 disableStreamCache를 제거합니다. 이 설정은 Servlet's를 사용할 때 이를 활성화하기 위해 서블릿 특정 구성이 필요할 수 있으므로 기본적으로 꺼집니다. | false | boolean |
| eagerCheckContentAvailable (consumer) | content-length 헤더가 0이거나 존재하지 않는 경우 HTTP 요청에 콘텐츠가 있는지 여부를 신속하게 확인할지 여부입니다. HTTP 클라이언트가 스트리밍된 데이터를 보내지 않는 경우 이 설정을 설정할 수 있습니다. | false | boolean |
| exceptionHandler (consumer) | 사용자가 사용자 지정 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션이 사용되지 않습니다. 기본적으로 소비자는 WARN 또는 ERROR 수준에서 기록되고 무시됩니다. | ExceptionHandler | |
| exchangePattern (consumer) | 소비자가 교환을 생성할 때 교환 패턴을 설정합니다. | ExchangePattern | |
| fileNameExtWhitelist (consumer) | 업로드된 파일을 수락하기 위해 허용되는 파일 이름 확장의 허용 목록. 여러 확장 프로그램은 txt,xml과 같이 쉼표로 구분할 수 있습니다. | 문자열 | |
| optionsEnabled (consumer) | 이 서블릿 소비자에 HTTP OPTIONS를 활성화할지 여부를 지정합니다. 기본적으로 OPTIONS는 꺼져 있습니다. | false | boolean |
| traceEnabled (consumer) | 이 서블릿 소비자에 대해 HTTP TRACE를 활성화할지 여부를 지정합니다. 기본적으로 TRACE는 꺼져 있습니다. | false | boolean |
| mapHttpMessageBody (advanced) | 이 옵션이 true이면 교환의 IN exchange Body가 HTTP 본문에 매핑됩니다. 이 값을 false로 설정하면 HTTP 매핑이 발생하지 않습니다. | true | boolean |
| mapHttpMessageFormUrl EncodedBody (advanced) | 이 옵션이 true인 경우 교환 양식 인코딩 본문이 HTTP에 매핑됩니다. 이를 false로 설정하면 HTTP 양식 Encoded 본문 매핑이 발생하지 않습니다. | true | boolean |
| mapHttpMessageHeaders (advanced) | 이 옵션이 true이면 교환 헤더의 IN exchange 헤더가 HTTP 헤더에 매핑됩니다. 이를 false로 설정하면 HTTP 헤더 매핑이 발생하지 않습니다. | true | boolean |
| 동기 (고급) | 동기 처리를 엄격하게 사용해야 하는지 또는 Camel이 비동기 처리를 사용할 수 있는지 여부를 설정합니다(지원되는 경우). | false | boolean |
