Camel Spring Boot 참조 3.14

Red Hat Integration 2022.q4

Camel Spring Boot 참조

Red Hat Integration Documentation Team Integration Support Team http://access.redhat.com/support

초록

이 가이드에서는 Camel Spring Boot 구성 요소의 설정에 대해 설명합니다.

머리말

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지를 참조하십시오.

1장. AWS CloudWatch

프로듀서만 지원됩니다.

AWS2 Cloudwatch 구성 요소를 사용하면 메시지를 Amazon 10.0.0.1 지표로 전송할 수 있습니다. Amazon API의 구현은 AWS SDK 에서 제공합니다.

사전 요구 사항

유효한 Amazon Web Services 개발자 계정이 있어야 하며 AmazonECDHE를 사용하기 위해 가입해야 합니다. 자세한 내용은 Amazon#177 에서 확인할 수 있습니다.

1.1. URI 형식

aws2-cw://namespace[?options]

메트릭이 아직 존재하지 않는 경우 생성됩니다. 다음 형식으로 URI에 쿼리 옵션을 추가할 수 있습니다. ?options=value&option2=value&…​

1.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

1.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

1.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

1.3. 구성 요소 옵션

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

이름설명Default유형

amazonCwClient (producer)

Autowired AmazonCloudWatch를 클라이언트로 사용합니다.

 

CloudWatchClient

구성 (producer)

구성 요소 구성 요소입니다.

 

Cw2Configuration

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

이름 (producer)

메트릭 이름입니다.

 

문자열

overrideEndpoint (producer)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

proxyHost (producer)

CW 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (producer)

CW 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

proxyProtocol (producer)

CW 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

region (producer)

CW 클라이언트가 작동해야 하는 지역. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

타임 스탬프 (producer)

지표 타임스탬프입니다.

 

Instant

trustAllCertificates (producer)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

단위 (producer)

지표 단위입니다.

 

문자열

uriEndpointOverride (producer)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (producer)

S3 클라이언트가 기본 인증 정보 공급자를 통해 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

(producer)

지표 값입니다.

 

double

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

1.4. 끝점 옵션

AWS 10.0.0.1 끝점은 URI 구문을 사용하여 구성됩니다.

aws2-cw:namespace

다음과 같은 경로 및 쿼리 매개변수 사용:

1.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

네임스페이스 (producer)

필수 메트릭 네임스페이스입니다.

 

문자열

1.4.2. 쿼리 매개변수 (16 매개변수)

이름설명Default유형

amazonCwClient (producer)

Autowired AmazonCloudWatch를 클라이언트로 사용합니다.

 

CloudWatchClient

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

이름 (producer)

메트릭 이름입니다.

 

문자열

overrideEndpoint (producer)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

proxyHost (producer)

CW 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (producer)

CW 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

proxyProtocol (producer)

CW 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

region (producer)

CW 클라이언트가 작동해야 하는 지역. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

타임 스탬프 (producer)

지표 타임스탬프입니다.

 

Instant

trustAllCertificates (producer)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

단위 (producer)

지표 단위입니다.

 

문자열

uriEndpointOverride (producer)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (producer)

S3 클라이언트가 기본 인증 정보 공급자를 통해 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

(producer)

지표 값입니다.

 

double

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

필수 CW 구성 요소 옵션

레지스트리 또는 accessKey 및 secretKey에 amazonCwClient를 제공하여 Amazon의 gRPC 에 액세스해야 합니다.

1.5. 사용법

1.5.1. 정적 자격 증명 대 기본 인증 정보 공급자

useDefaultCredentialsProvider 옵션을 지정하고 true로 설정하여 명시적 정적 인증 정보 사용을 방지할 수 있습니다.

  • Java 시스템 속성 - aws.accessKeyId 및 aws.secretKey
  • 환경 변수 - AWS_ACCESS_KEY_ID 및 AWS_SECRET_ACCESS_KEY.
  • AWS STS의 웹 ID 토큰.
  • 공유 인증 정보 및 구성 파일입니다.
  • Amazon ECS 컨테이너 인증 정보 - 환경 변수 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI가 설정된 경우 Amazon ECS에서 로드됩니다.
  • Amazon EC2 인스턴스 프로필 자격 증명.

이에 대한 자세한 내용은 AWS 인증 정보 문서를 참조하십시오.

1.5.2. CW 프로듀서에서 평가한 메시지 헤더

header유형설명

CamelAwsCwMetricName

문자열

Amazon CW 메트릭 이름입니다.

CamelAwsCwMetricValue

double

Amazon CW 지표 값.

CamelAwsCwMetricUnit

문자열

Amazon CW 지표 단위입니다.

CamelAwsCwMetricNamespace

문자열

Amazon CW 지표 네임스페이스입니다.

CamelAwsCwMetricTimestamp

날짜

Amazon CW 메트릭 타임 스탬프입니다.

CamelAwsCwMetricDimensionName

문자열

Amazon CW 지표의 차원 이름입니다.

CamelAwsCwMetricDimensionValue

문자열

Amazon CW 지표 차원 값입니다.

CamelAwsCwMetricDimensions

Map<String, String>

차원 이름 및 차원 값의 맵입니다.

1.5.3. 고급 10.0.0.1Client 구성

10.0.0.1 Client 인스턴스 구성을 더 많이 제어해야 하는 경우 자체 인스턴스를 생성하고 URI에서 해당 인스턴스를 참조할 수 있습니다.

from("direct:start")
.to("aws2-cw://namespace?amazonCwClient=#client");

#client 는 레지스트리의 10.0.0.1Client 를 나타냅니다.

1.6. 종속 항목

Maven 사용자는 pom.xml에 다음과 같은 종속성을 추가해야 합니다.

pom.xml

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-aws2-cw</artifactId>
    <version>${camel-version}</version>
</dependency>

여기서 {camel-version}은 실제 Camel 버전으로 교체해야 합니다.

1.7. 예

1.7.1. 생산자 예

from("direct:start")
  .to("aws2-cw://http://camel.apache.org/aws-cw");

다음과 같은 메시지를 보냅니다.

exchange.getIn().setHeader(Cw2Constants.METRIC_NAME, "ExchangesCompleted");
exchange.getIn().setHeader(Cw2Constants.METRIC_VALUE, "2.0");
exchange.getIn().setHeader(Cw2Constants.METRIC_UNIT, "Count");

1.8. Spring Boot Auto-Configuration

Spring Boot에서 aws2-cw를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-aws2-cw-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.aws2-cw.access-key

Amazon AWS 액세스 키.

 

문자열

camel.component.aws2-cw.amazon-cw-client

AmazonCloudWatch를 클라이언트로 사용하려면 다음을 수행합니다. 옵션은 software.amazon.awssdk.services.cloudwatch.CloudWatchClient 유형입니다.

 

CloudWatchClient

camel.component.aws2-cw.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.aws2-cw.configuration

구성 요소 구성 요소입니다. 옵션은 org.apache.camel.component.aws2.cw.Cw2Configuration 유형입니다.

 

Cw2Configuration

camel.component.aws2-cw.enabled

aws2-cw 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.aws2-cw.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.aws2-cw.name

메트릭 이름입니다.

 

문자열

camel.component.aws2-cw.override-endpoint

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

부울

camel.component.aws2-cw.proxy-host

CW 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

camel.component.aws2-cw.proxy-port

CW 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

camel.component.aws2-cw.proxy-protocol

CW 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

 

프로토콜

camel.component.aws2-cw.region

CW 클라이언트가 작동해야 하는 지역. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

camel.component.aws2-cw.secret-key

Amazon AWS 시크릿 키.

 

문자열

camel.component.aws2-cw.timestamp

지표 타임스탬프입니다. 옵션은 java.time.Instant 유형입니다.

 

Instant

camel.component.aws2-cw.trust-all-certificates

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

부울

camel.component.aws2-cw.unit

지표 단위입니다.

 

문자열

camel.component.aws2-cw.uri-endpoint-override

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

camel.component.aws2-cw.use-default-credentials-provider

S3 클라이언트가 기본 인증 정보 공급자를 통해 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

부울

camel.component.aws2-cw.value

지표 값입니다.

 

double

2장. AWS DynamoDB

프로듀서만 지원됩니다.

AWS2ECDHE 구성 요소는 서비스에서 데이터 저장 및 검색을 지원합니다.

사전 요구 사항

유효한 Amazon Web Services 개발자 계정이 있어야 하며 AmazonECDHE를 사용하기 위해 가입해야 합니다. 자세한 내용은 AmazonECDHE에서 확인할 수 있습니다.

2.1. URI 형식

aws2-ddb://domainName[?options]

다음 형식으로 URI에 쿼리 옵션을 추가할 수 있습니다. ?options=value&option2=value&…​

2.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

2.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

2.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

2.3. 구성 요소 옵션

AWSECDHE 구성 요소는 아래에 나열된 22 옵션을 지원합니다.

이름설명Default유형

amazonDDBClient (producer)

Autowired AmazonDynamoDB를 클라이언트로 사용합니다.

 

DynamoDbClient

구성 (producer)

구성 요소 구성 요소입니다.

 

Ddb2Configuration

ConsistentRead (producer)

데이터를 읽을 때 강력한 일관성을 적용할지 여부를 결정합니다.

false

boolean

enabledInitialDescribeTable (producer)

DDB 엔드 포인트의 초기 Describe 테이블 작업을 수행해야 하는지 여부를 설정합니다.

true

boolean

keyAttributeName (producer)

테이블을 만들 때 속성 이름입니다.

 

문자열

keyAttributeType (producer)

테이블을 만들 때 속성 유형입니다.

 

문자열

keyScalarType (producer)

키 스칼라 유형, S (String), N (Number) 및 B (Bytes) 일 수 있습니다.

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

작업 (producer)

수행할 작업.

CloudEvent 값:

  • BatchGetItems
  • deleteItem
  • DeleteTable
  • DescribeTable
  • GetItem
  • PutItem
  • 쿼리
  • 검사
  • UpdateItem
  • UpdateTable

PutItem

Ddb2Operations

overrideEndpoint (producer)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

proxyHost (producer)

DDB 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (producer)

client가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

정수

proxyProtocol (producer)

DDB 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

readCapacity (producer)

표에 있는 리소스를 예약하기 위한 프로비저닝된 처리량입니다.

 

long

region (producer)

DDB 클라이언트가 작동해야 하는 지역입니다.

 

문자열

trustAllCertificates (producer)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

uriEndpointOverride (producer)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (producer)

S3 클라이언트가 기본 인증 정보 공급자를 통해 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

writeCapacity (producer)

테이블에 리소스 작성을 위해 예약된 프로비저닝된 처리량입니다.

 

long

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

2.4. 끝점 옵션

AWSECDHE 끝점은 URI 구문을 사용하여 구성됩니다.

aws2-ddb:tableName

다음과 같은 경로 및 쿼리 매개변수 사용:

2.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

테이블 이름 (producer)

필요한 현재 작업 중인 테이블의 이름입니다.

 

문자열

2.4.2. 쿼리 매개변수(20 매개변수)

이름설명Default유형

amazonDDBClient (producer)

Autowired AmazonDynamoDB를 클라이언트로 사용합니다.

 

DynamoDbClient

ConsistentRead (producer)

데이터를 읽을 때 강력한 일관성을 적용할지 여부를 결정합니다.

false

boolean

enabledInitialDescribeTable (producer)

DDB 엔드 포인트의 초기 Describe 테이블 작업을 수행해야 하는지 여부를 설정합니다.

true

boolean

keyAttributeName (producer)

테이블을 만들 때 속성 이름입니다.

 

문자열

keyAttributeType (producer)

테이블을 만들 때 속성 유형입니다.

 

문자열

keyScalarType (producer)

키 스칼라 유형, S (String), N (Number) 및 B (Bytes) 일 수 있습니다.

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

작업 (producer)

수행할 작업.

CloudEvent 값:

  • BatchGetItems
  • deleteItem
  • DeleteTable
  • DescribeTable
  • GetItem
  • PutItem
  • 쿼리
  • 검사
  • UpdateItem
  • UpdateTable

PutItem

Ddb2Operations

overrideEndpoint (producer)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

proxyHost (producer)

DDB 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (producer)

client가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

정수

proxyProtocol (producer)

DDB 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

readCapacity (producer)

표에 있는 리소스를 예약하기 위한 프로비저닝된 처리량입니다.

 

long

region (producer)

DDB 클라이언트가 작동해야 하는 지역입니다.

 

문자열

trustAllCertificates (producer)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

uriEndpointOverride (producer)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (producer)

S3 클라이언트가 기본 인증 정보 공급자를 통해 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

writeCapacity (producer)

테이블에 리소스 작성을 위해 예약된 프로비저닝된 처리량입니다.

 

long

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

필수 DDB 구성 요소 옵션

Amazon의ECDHE에 액세스하려면 레지스트리 또는 accessKey 및 secretKey에 amazonDDBClient를 제공해야 합니다.

2.5. 사용법

2.5.1. 정적 자격 증명 대 기본 인증 정보 공급자

useDefaultCredentialsProvider 옵션을 지정하고 true로 설정하여 명시적 정적 인증 정보 사용을 방지할 수 있습니다.

  • Java 시스템 속성 - aws.accessKeyId 및 aws.secretKey
  • 환경 변수 - AWS_ACCESS_KEY_ID 및 AWS_SECRET_ACCESS_KEY.
  • AWS STS의 웹 ID 토큰.
  • 공유 인증 정보 및 구성 파일입니다.
  • Amazon ECS 컨테이너 인증 정보 - 환경 변수 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI가 설정된 경우 Amazon ECS에서 로드됩니다.
  • Amazon EC2 인스턴스 프로필 자격 증명.

이에 대한 자세한 내용은 AWS 인증 정보 문서를 참조하십시오.

2.5.2. DDB 프로듀서에서 평가한 메시지 헤더

header유형설명

CamelAwsDdbBatchItems

Map<String, KeysAndAttributes>

기본 키로 가져올 테이블 이름 및 해당 항목의 맵입니다.

CamelAwsDdbTableName

문자열

이 작업에 대한 테이블 이름입니다.

CamelAwsDdbKey

테이블의 각 항목을 고유하게 식별하는 기본 키입니다.

CamelAwsDdbReturnValues

문자열

수정하기 전이나 후에 속성 이름-값 쌍을 가져오려면 이 매개변수를 사용합니다(없음, ALL_ECDHE, UPDATED_ECDHE, ALL_NEW, UPDATED_NEW).

CamelAwsDdbUpdateCondition

Map<String, ExpectedAttributeValue>

조건부 수정을 위한 특성을 지정합니다.

CamelAwsDdbAttributeNames

collection<String>

특성 이름을 지정하지 않으면 모든 속성이 반환됩니다.

CamelAwsDdbConsistentRead

부울

true로 설정하면 일관된 읽기가 수행되고 결국 일관성이 사용됩니다.

CamelAwsDdbIndexName

문자열

설정된 경우 쿼리 작업의 Secondary Index로 사용됩니다.

CamelAwsDdbItem

Map<String, AttributeValue>

항목에 대한 속성 맵이며 해당 항목을 정의하는 기본 키 값을 포함해야 합니다.

CamelAwsDdbExactCount

부울

true로 설정하면 일치하는 항목 및 해당 속성 목록이 아니라 쿼리 매개변수와 일치하는 총 항목 수를 반환합니다.

CamelAwsDdbKeyConditions

map<String, Condition>

이 헤더는 쿼리에 대한 선택 기준을 지정하고 두 개의 이전 헤더 CamelAwsDdbHashKeyValueCamelAwsDdbScanRangeKeyCondition을 병합합니다.

CamelAwsDdbStartKey

이전 쿼리를 계속할 항목의 기본 키입니다.

CamelAwsDdbHashKeyValue

AttributeValue

복합 기본 키의 해시 구성 요소 값입니다.

CamelAwsDdbLimit

정수

반환할 최대 항목 수입니다.

CamelAwsDdbScanRangeKeyCondition

상태

쿼리에 사용할 특성 값 및 비교 연산자의 컨테이너입니다.

CamelAwsDdbScanIndexForward

부울

인덱스의 정방향 또는 뒤로 트래버스를 지정합니다.

CamelAwsDdbScanFilter

map<String, Condition>

검사 결과를 평가하고 원하는 값만 반환합니다.

CamelAwsDdbUpdateValues

Map<String, AttributeValueUpdate>

속성 name을 업데이트에 대한 새 값 및 작업에 매핑합니다.

2.5.3. BatchGetItems 작업 중 설정된 메시지 헤더

header유형설명

CamelAwsDdbBatchResponse

Map<String,BatchResponse>

테이블 이름 및 테이블의 각 항목 속성입니다.

CamelAwsDdbUnprocessedKeys

Map<String,KeysAndAttributes>

현재 응답으로 처리되지 않은 테이블 맵과 각각의 키가 포함되어 있습니다.

2.5.4. DeleteItem 작업 중 설정된 메시지 헤더

header유형설명

CamelAwsDdbAttributes

Map<String, AttributeValue>

작업에서 반환된 특성 목록입니다.

2.5.5. DeleteTable 작업 중 설정된 메시지 헤더

header유형설명

CamelAwsDdbProvisionedThroughput

  

ProvisionedThroughputDescription

 

이 테이블에 대한 ProvisionedThrough issues 속성의 값

CamelAwsDdbCreationDate

날짜

이 테이블의 journalctl 생성.

CamelAwsDdbTableItemCount

long

이 테이블의 항목 수입니다.

CamelAwsDdbKeySchema

KeySchema

이 테이블의 기본 키를 식별하는 KeySchema입니다. Camel 2.16.0에서 이 헤더의 유형은 KeySchema가 아닌 List<KeySchema>입니다.

CamelAwsDdbTableName

문자열

테이블 이름입니다.

CamelAwsDdbTableSize

long

테이블 크기(바이트)입니다.

CamelAwsDdbTableStatus

문자열

표 상태: CREATING, UPDATING, DELETING,ECDHE

2.5.6. DescribeTable 작업 중에 메시지 헤더 설정

header유형설명

CamelAwsDdbProvisionedThroughput

\{{ProvisionedThroughputDescription}}

이 테이블에 대한 ProvisionedThrough issues 속성의 값

CamelAwsDdbCreationDate

날짜

이 테이블의 journalctl 생성.

CamelAwsDdbTableItemCount

long

이 테이블의 항목 수입니다.

CamelAwsDdbKeySchema

\{{KeySchema}}

이 테이블의 기본 키를 식별하는 KeySchema입니다.

CamelAwsDdbTableName

문자열

테이블 이름입니다.

CamelAwsDdbTableSize

long

테이블 크기(바이트)입니다.

CamelAwsDdbTableStatus

문자열

표 상태: CREATING, UPDATING, DELETING,ECDHE

CamelAwsDdbReadCapacity

long

이 테이블의 ReadCapacityUnits 속성입니다.

CamelAwsDdbWriteCapacity

long

이 테이블의 WriteCapacityUnits 속성입니다.

2.5.7. GetItem 작업 중 메시지 헤더 설정

header유형설명

CamelAwsDdbAttributes

Map<String, AttributeValue>

작업에서 반환된 특성 목록입니다.

2.5.8. PutItem 작업 중 메시지 헤더 설정

header유형설명

CamelAwsDdbAttributes

Map<String, AttributeValue>

작업에서 반환된 특성 목록입니다.

2.5.9. 쿼리 작업 중 설정된 메시지 헤더

header유형설명

CamelAwsDdbItems

List<java.util.Map<String,AttributeValue>>

작업에서 반환된 특성 목록입니다.

CamelAwsDdbLastEvaluatedKey

이전 결과 집합을 포함하여 쿼리 작업이 중지된 항목의 기본 키입니다.

CamelAwsDdbConsumedCapacity

double

작업 중에 사용된 테이블의 프로비저닝된 처리량의 용량 단위 수입니다.

CamelAwsDdbCount

정수

응답의 항목 수입니다.

2.5.10. 검사 작업 중 설정된 메시지 헤더

header유형설명

CamelAwsDdbItems

List<java.util.Map<String,AttributeValue>>

작업에서 반환된 특성 목록입니다.

CamelAwsDdbLastEvaluatedKey

이전 결과 집합을 포함하여 쿼리 작업이 중지된 항목의 기본 키입니다.

CamelAwsDdbConsumedCapacity

double

작업 중에 사용된 테이블의 프로비저닝된 처리량의 용량 단위 수입니다.

CamelAwsDdbCount

정수

응답의 항목 수입니다.

CamelAwsDdbScannedCount

정수

필터를 적용하기 전에 전체 검사의 항목 수입니다.

2.5.11. UpdateItem 작업 중 메시지 헤더 설정

header유형설명

CamelAwsDdbAttributes

Map<String, AttributeValue>

작업에서 반환된 특성 목록입니다.

2.5.12. 고급 AmazonDynamoDB 구성

AmazonDynamoDB 인스턴스 구성을 더 많이 제어해야 하는 경우 자체 인스턴스를 생성하고 URI에서 이를 참조할 수 있습니다.

from("direct:start")
.to("aws2-ddb://domainName?amazonDDBClient=#client");

#client 는 레지스트리의 DynamoDbClient 를 나타냅니다.

2.6. 지원되는 생산자 작업

  • BatchGetItems
  • deleteItem
  • DeleteTable
  • DescribeTable
  • GetItem
  • PutItem
  • 쿼리
  • 검사
  • UpdateItem
  • UpdateTable

2.7. 예

2.7.1. 생산자 예

  • PutItem: 이 작업은 10.0.0.1에 항목을 생성합니다.
from("direct:start")
  .setHeader(Ddb2Constants.OPERATION, Ddb2Operations.PutItem)
  .setHeader(Ddb2Constants.CONSISTENT_READ, "true")
  .setHeader(Ddb2Constants.RETURN_VALUES, "ALL_OLD")
  .setHeader(Ddb2Constants.ITEM, attributeMap)
  .setHeader(Ddb2Constants.ATTRIBUTE_NAMES, attributeMap.keySet());
  .to("aws2-ddb://" + tableName + "?keyAttributeName=" + attributeName + "&keyAttributeType=" + KeyType.HASH
  + "&keyScalarType=" + ScalarAttributeType.S
  + "&readCapacity=1&writeCapacity=1");

Maven 사용자는 pom.xml에 다음과 같은 종속성을 추가해야 합니다.

pom.xml

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-aws2-ddb</artifactId>
    <version>${camel-version}</version>
</dependency>

3.14.2 를 실제 Camel 버전으로 교체해야 합니다.

2.8. Spring Boot Auto-Configuration

Spring Boot와 함께 aws2-ddb를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-aws2-ddb-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

구성 요소는 아래에 나열된 40개의 옵션을 지원합니다.

이름설명Default유형

camel.component.aws2-ddb.access-key

Amazon AWS 액세스 키.

 

문자열

camel.component.aws2-ddb.amazon-d-d-b-client

AmazonDynamoDB를 클라이언트로 사용하려면 다음을 수행합니다. 옵션은 software.amazon.awssdk.services.dynamodb.DynamoDbClient 유형입니다.

 

DynamoDbClient

camel.component.aws2-ddb.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.aws2-ddb.configuration

구성 요소 구성 요소입니다. 옵션은 org.apache.camel.component.aws2.ddb.Ddb2Configuration 유형입니다.

 

Ddb2Configuration

camel.component.aws2-ddb.consistent-read

데이터를 읽을 때 강력한 일관성을 적용할지 여부를 결정합니다.

false

부울

camel.component.aws2-ddb.enabled

aws2-ddb 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.aws2-ddb.enabled-initial-describe-table

DDB 엔드 포인트의 초기 Describe 테이블 작업을 수행해야 하는지 여부를 설정합니다.

true

부울

camel.component.aws2-ddb.key-attribute-name

테이블을 만들 때 속성 이름입니다.

 

문자열

camel.component.aws2-ddb.key-attribute-type

테이블을 만들 때 속성 유형입니다.

 

문자열

camel.component.aws2-ddb.key-scalar-type

키 스칼라 유형, S (String), N (Number) 및 B (Bytes) 일 수 있습니다.

 

문자열

camel.component.aws2-ddb.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.aws2-ddb.operation

수행할 작업.

 

Ddb2Operations

camel.component.aws2-ddb.override-endpoint

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

부울

camel.component.aws2-ddb.proxy-host

DDB 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

camel.component.aws2-ddb.proxy-port

client가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

정수

camel.component.aws2-ddb.proxy-protocol

DDB 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

 

프로토콜

camel.component.aws2-ddb.read-capacity

표에 있는 리소스를 예약하기 위한 프로비저닝된 처리량입니다.

 

long

camel.component.aws2-ddb.region

DDB 클라이언트가 작동해야 하는 지역입니다.

 

문자열

camel.component.aws2-ddb.secret-key

Amazon AWS 시크릿 키.

 

문자열

camel.component.aws2-ddb.trust-all-certificates

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

부울

camel.component.aws2-ddb.uri-endpoint-override

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

camel.component.aws2-ddb.use-default-credentials-provider

S3 클라이언트가 기본 인증 정보 공급자를 통해 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

부울

camel.component.aws2-ddb.write-capacity

테이블에 리소스 작성을 위해 예약된 프로비저닝된 처리량입니다.

 

long

camel.component.aws2-ddbstream.access-key

Amazon AWS 액세스 키.

 

문자열

camel.component.aws2-ddbstream.amazon-dynamo-db-streams-client

이 엔드포인트에 대한 모든 요청에 사용할 AmazonECDHE 클라이언트입니다. 옵션은 software.amazon.awssdk.services.dynamodb.streams.DynamoDbStreamsClient 유형입니다.

 

DynamoDbStreamsClient

camel.component.aws2-ddbstream.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.aws2-ddbstream.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.aws2-ddbstream.configuration

구성 요소 구성 요소입니다. 옵션은 org.apache.camel.component.aws2.ddbstream.Ddb2StreamConfiguration 유형입니다.

 

Ddb2StreamConfiguration

camel.component.aws2-ddbstream.enabled

aws2-ddbstream 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.aws2-ddbstream.max-results-per-request

각 폴링에서 가져올 최대 레코드 수입니다.

 

정수

camel.component.aws2-ddbstream.override-endpoint

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

부울

camel.component.aws2-ddbstream.proxy-host

DDBStreams 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

camel.component.aws2-ddbstream.proxy-port

DDBStreams 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

camel.component.aws2-ddbstream.proxy-protocol

DDBStreams 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

 

프로토콜

camel.component.aws2-ddbstream.region

DDBStreams 클라이언트가 작동해야 하는 영역입니다.

 

문자열

camel.component.aws2-ddbstream.secret-key

Amazon AWS 시크릿 키.

 

문자열

camel.component.aws2-ddbstream.stream-iterator-type

레코드 가져오기를 시작하기 위해 10.0.0.1 스트림의 위치를 정의합니다. FROM_START를 사용하면 스트림이 실시간으로 포착되기 전에 상당한 지연이 발생할 수 있습니다.

 

Ddb2StreamConfiguration$StreamIteratorType

camel.component.aws2-ddbstream.trust-all-certificates

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

부울

camel.component.aws2-ddbstream.uri-endpoint-override

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

camel.component.aws2-ddbstream.use-default-credentials-provider

사용자가 기본 인증 정보 공급자를 통해 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

부울

3장. AWSECDHE

생산자 및 소비자 모두 지원

AWS2ECDHE 구성 요소는 AmazonECDHE(Batch 지원) 서비스에서 메시지 수신 및 전송을 지원합니다.

사전 요구 사항

유효한 Amazon Web Services 개발자 계정이 있어야 하며 AmazonECDHE를 사용하기 위해 가입해야 합니다. 자세한 내용은 AWSECDHE에서 확인할 수 있습니다.

3.1. URI 형식

aws2-kinesis://stream-name[?options]

스트림을 사용하기 전에 만들어야 합니다. 다음 형식으로 URI에 쿼리 옵션을 추가할 수 있습니다. ?options=value&option2=value&…​

3.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

3.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

3.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

3.3. 구성 요소 옵션

AWSECDHE 구성 요소는 아래에 나열된 22 옵션을 지원합니다.

이름설명Default유형

amazonKinesisClient (common)

이 엔드포인트에 대한 모든 요청에 사용할 자동 유선 AmazonECDHE 클라이언트입니다.

 

KinesisClient

cborEnabled (common)

이 옵션은 실행 중에 CBOR_ENABLED 속성을 설정합니다.

true

boolean

구성 (공용)

구성 요소 구성입니다.

 

Kinesis2Configuration

overrideEndpoint (common)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

proxyHost (common)

client를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (공용)

client를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

proxyProtocol (공용)

클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의하려면 다음을 수행합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

리전 (공용)

클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

trustAllCertificates (common)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

uriEndpointOverride (common)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (common)

사용자가 기본 인증 정보 공급자를 통해 자격 증명을 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

ScanSettingType (consumer)

레코드 가져오기를 시작하기 위해 10.0.0.1 스트림의 위치를 정의합니다.

CloudEvent 값:

  • AT_SEQUENCE_NUMBER
  • AFTER_SEQUENCE_NUMBER
  • TRIM_HORIZON
  • LATEST
  • AT_TIMESTAMP
  • null

TRIM_HORIZON

ShardIteratorType

maxResultsPerRequest (consumer)

각 폴링에서 가져올 최대 레코드 수입니다.

1

int

resumeStrategy (consumer)

AWSECDHE에 대한 재개 전략을 정의합니다. 기본 전략은 제공된 경우 sequenceNumber를 읽습니다.

KinesisUserConfigurationResumeStrategy

KinesisResumeStrategy

sequenceNumber (consumer)

폴링을 시작하는 시퀀스 번호입니다. hieradataType이 AFTER_SEQUENCE_NUMBER 또는 AT_SEQUENCE_NUMBER로 설정된 경우 필수 항목입니다.

 

문자열

shardvdd d (consumer)

shard가 종료된 경우 해당 동작을 정의합니다. 가능한 값은 ignore, silent 및 fail입니다. 무시 메시지가 기록되고 소비자는 로깅이 없는 경우 처음부터 다시 시작되고 소비자가 처음부터 시작됩니다. 오류가 발생한 경우 ReachedanchordStateException이 발생합니다.

CloudEvent 값:

  • Ignore
  • fail
  • silent

Ignore

Kinesis2ShardClosedStrategyEnum

shardId (consumer)

레코드를 가져올 10.0.0.1 스트림의 shardId를 정의합니다.

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

3.4. 끝점 옵션

AWSECDHE 끝점은 URI 구문을 사용하여 구성됩니다.

aws2-kinesis:streamName

다음과 같은 경로 및 쿼리 매개변수 사용:

3.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

streamName (common)

스트림 이름입니다.Is the name of the stream.

 

문자열

3.4.2. 쿼리 매개변수(38 매개변수)

이름설명Default유형

amazonKinesisClient (common)

이 엔드포인트에 대한 모든 요청에 사용할 자동 유선 AmazonECDHE 클라이언트입니다.

 

KinesisClient

cborEnabled (common)

이 옵션은 실행 중에 CBOR_ENABLED 속성을 설정합니다.

true

boolean

overrideEndpoint (common)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

proxyHost (common)

client를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (공용)

client를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

proxyProtocol (공용)

클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의하려면 다음을 수행합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

리전 (공용)

클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

trustAllCertificates (common)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

uriEndpointOverride (common)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (common)

사용자가 기본 인증 정보 공급자를 통해 자격 증명을 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

ScanSettingType (consumer)

레코드 가져오기를 시작하기 위해 10.0.0.1 스트림의 위치를 정의합니다.

CloudEvent 값:

  • AT_SEQUENCE_NUMBER
  • AFTER_SEQUENCE_NUMBER
  • TRIM_HORIZON
  • LATEST
  • AT_TIMESTAMP
  • null

TRIM_HORIZON

ShardIteratorType

maxResultsPerRequest (consumer)

각 폴링에서 가져올 최대 레코드 수입니다.

1

int

resumeStrategy (consumer)

AWSECDHE에 대한 재개 전략을 정의합니다. 기본 전략은 제공된 경우 sequenceNumber를 읽습니다.

KinesisUserConfigurationResumeStrategy

KinesisResumeStrategy

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

sequenceNumber (consumer)

폴링을 시작하는 시퀀스 번호입니다. hieradataType이 AFTER_SEQUENCE_NUMBER 또는 AT_SEQUENCE_NUMBER로 설정된 경우 필수 항목입니다.

 

문자열

shardvdd d (consumer)

shard가 종료된 경우 해당 동작을 정의합니다. 가능한 값은 ignore, silent 및 fail입니다. 무시 메시지가 기록되고 소비자는 로깅이 없는 경우 처음부터 다시 시작되고 소비자가 처음부터 시작됩니다. 오류가 발생한 경우 ReachedanchordStateException이 발생합니다.

CloudEvent 값:

  • Ignore
  • fail
  • silent

Ignore

Kinesis2ShardClosedStrategyEnum

shardId (consumer)

레코드를 가져올 10.0.0.1 스트림의 shardId를 정의합니다.

 

문자열

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

필수 CloudEvent 구성 요소 옵션

레지스트리에 gRPCClient를 프록시 및 관련 인증 정보가 구성되어 있어야 합니다.

3.5. 일괄 소비자

이 구성 요소는 Batch Consumer를 구현합니다.

이를 통해 이 일괄 처리 내에 존재하는 메시지 수를 알 수 있으며 예를 들어 Aggregator가 이 메시지 수를 집계하도록 할 수 있습니다.

3.6. 사용법

3.6.1. 정적 자격 증명 대 기본 인증 정보 공급자

useDefaultCredentialsProvider 옵션을 지정하고 true로 설정하여 명시적 정적 인증 정보 사용을 방지할 수 있습니다.

  • Java 시스템 속성 - aws.accessKeyId 및 aws.secretKey
  • 환경 변수 - AWS_ACCESS_KEY_ID 및 AWS_SECRET_ACCESS_KEY.
  • AWS STS의 웹 ID 토큰.
  • 공유 인증 정보 및 구성 파일입니다.
  • Amazon ECS 컨테이너 인증 정보 - 환경 변수 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI가 설정된 경우 Amazon ECS에서 로드됩니다.
  • Amazon EC2 인스턴스 프로필 자격 증명.

이에 대한 자세한 내용은 AWS 인증 정보 문서를 참조하십시오.

3.6.2. 10.0.0.1 소비자에 의해 설정된 메시지 헤더

header유형설명

CamelAwsKinesisSequenceNumber

문자열

레코드의 시퀀스 번호입니다. 이는 API에서 정의되지 않았기 때문에 String으로 표시됩니다. 숫자 유형으로 사용해야 하는 경우 다음을 사용합니다.

CamelAwsKinesisApproximateArrivalTimestamp

문자열

AWS가 레코드의 도착 시간으로 할당된 시간입니다.

CamelAwsKinesisPartitionKey

문자열

데이터 레코드가 할당된 스트림의 shard를 식별합니다.

3.6.3. AmazonKinesis 구성

그런 다음 amazonKinesisClient URI 옵션에서ECDHEClient를 참조해야합니다.

from("aws2-kinesis://mykinesisstream?amazonKinesisClient=#kinesisClient")
  .to("log:out?showAll=true");

3.6.4. AWS 인증 정보 제공

새 ClientConfiguration 인스턴스를 생성할 때 기본값인 DefaultAWSCredentialsProvider ECDHE를 사용하여 인증 정보를 가져오는 것이 좋지만 createClient(…​)를 호출할 때 다른 AWSCredentialsProvider sProvider를 지정할 수 있습니다.

3.6.5. CloudEvent 생산자가 에 쓰는 데 사용하는 메시지 헤더입니다. 생산자는 메시지 본문이 byte[] 라고 예상합니다.

header유형설명

CamelAwsKinesisPartitionKey

문자열

이 레코드를 저장하기 위해 PartitionKey에 전달할 PartitionKey입니다.

CamelAwsKinesisSequenceNumber

문자열

이 레코드의 시퀀스 번호를 나타내는 선택적 매개 변수입니다.

3.6.6. 레코드의 성공적인 스토리지에 대한 CloudEvent 프로듀서가 설정한 메시지 헤더

header유형설명

CamelAwsKinesisSequenceNumber

문자열

응답구문에 정의된 레코드의 시퀀스 번호

CamelAwsKinesisShardId

문자열

레코드가 저장된 shard ID

3.7. 종속 항목

Maven 사용자는 pom.xml에 다음과 같은 종속성을 추가해야 합니다.

pom.xml

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-aws2-kinesis</artifactId>
    <version>${camel-version}</version>
</dependency>

3.14.2 를 실제 Camel 버전으로 교체해야 합니다.

3.8. Spring Boot Auto-Configuration

Spring Boot와 함께 aws2-kinesis를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-aws2-kinesis-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- use your Camel Spring Boot version -->
</dependency>

구성 요소는 아래에 나열된 40개의 옵션을 지원합니다.

이름설명Default유형

camel.component.aws2-kinesis-firehose.access-key

Amazon AWS 액세스 키.

 

문자열

camel.component.aws2-kinesis-firehose.amazon-kinesis-firehose-client

이 엔드포인트에 대한 모든 요청에 사용할 AmazonECDHE Fire referred 클라이언트입니다. 옵션은 software.amazon.awssdk.services.fireECDHE.Fire unitsClient 유형입니다.

 

FirehoseClient

camel.component.aws2-kinesis-firehose.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.aws2-kinesis-firehose.cbor-enabled

이 옵션은 실행 중에 CBOR_ENABLED 속성을 설정합니다.

true

부울

camel.component.aws2-kinesis-firehose.configuration

구성 요소 구성입니다. 옵션은 org.apache.camel.component.aws2.fire pieces.KinesisFirekickstart2Configuration 유형입니다.

 

KinesisFirehose2Configuration

camel.component.aws2-kinesis-firehose.enabled

aws2-kinesis-fireature 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.aws2-kinesis-firehose.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.aws2-kinesis-firehose.operation

사용자가 레코드만 전송하지 않으려는 경우 수행할 작업입니다.

 

KinesisFirehose2Operations

camel.component.aws2-kinesis-firehose.override-endpoint

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

부울

camel.component.aws2-kinesis-firehose.proxy-host

클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

camel.component.aws2-kinesis-firehose.proxy-port

클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

camel.component.aws2-kinesis-firehose.proxy-protocol

클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의하려면 다음을 수행합니다.

 

프로토콜

camel.component.aws2-kinesis-firehose.region

클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

camel.component.aws2-kinesis-firehose.secret-key

Amazon AWS 시크릿 키.

 

문자열

camel.component.aws2-kinesis-firehose.trust-all-certificates

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

부울

camel.component.aws2-kinesis-firehose.uri-endpoint-override

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

camel.component.aws2-kinesis-firehose.use-default-credentials-provider

기본 인증 정보 공급자를 통해 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상해야 하는지 여부를 설정합니다.

false

부울

camel.component.aws2-kinesis.access-key

Amazon AWS 액세스 키.

 

문자열

camel.component.aws2-kinesis.amazon-kinesis-client

이 엔드포인트에 대한 모든 요청에 사용할 AmazonECDHE 클라이언트입니다. 옵션은 software.amazon.awssdk.services.kinesis.KinesisClient 유형입니다.

 

KinesisClient

camel.component.aws2-kinesis.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.aws2-kinesis.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.aws2-kinesis.cbor-enabled

이 옵션은 실행 중에 CBOR_ENABLED 속성을 설정합니다.

true

부울

camel.component.aws2-kinesis.configuration

구성 요소 구성입니다. 옵션은 org.apache.camel.component.aws2.kinesis.Kinesis2Configuration 유형입니다.

 

Kinesis2Configuration

camel.component.aws2-kinesis.enabled

aws2-kinesis 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.aws2-kinesis.iterator-type

레코드 가져오기를 시작하기 위해 10.0.0.1 스트림의 위치를 정의합니다.

 

ShardIteratorType

camel.component.aws2-kinesis.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.aws2-kinesis.max-results-per-request

각 폴링에서 가져올 최대 레코드 수입니다.

1

정수

camel.component.aws2-kinesis.override-endpoint

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

부울

camel.component.aws2-kinesis.proxy-host

client를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

camel.component.aws2-kinesis.proxy-port

client를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

camel.component.aws2-kinesis.proxy-protocol

클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의하려면 다음을 수행합니다.

 

프로토콜

camel.component.aws2-kinesis.region

클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

camel.component.aws2-kinesis.resume-strategy

AWSECDHE에 대한 재개 전략을 정의합니다. 기본 전략은 제공된 경우 sequenceNumber를 읽습니다. 옵션은 org.apache.camel.component.aws2.kinesis.consumer.KinesisResumeStrategy 유형입니다.

 

KinesisResumeStrategy

camel.component.aws2-kinesis.secret-key

Amazon AWS 시크릿 키.

 

문자열

camel.component.aws2-kinesis.sequence-number

폴링을 시작하는 시퀀스 번호입니다. hieradataType이 AFTER_SEQUENCE_NUMBER 또는 AT_SEQUENCE_NUMBER로 설정된 경우 필수 항목입니다.

 

문자열

camel.component.aws2-kinesis.shard-closed

shard가 종료된 경우 해당 동작을 정의합니다. 가능한 값은 ignore, silent 및 fail입니다. 무시 메시지가 기록되고 소비자는 로깅이 없는 경우 처음부터 다시 시작되고 소비자가 처음부터 시작됩니다. 오류가 발생한 경우 ReachedanchordStateException이 발생합니다.

 

Kinesis2ShardClosedStrategyEnum

camel.component.aws2-kinesis.shard-id

레코드를 가져올 10.0.0.1 스트림의 shardId를 정의합니다.

 

문자열

camel.component.aws2-kinesis.trust-all-certificates

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

부울

camel.component.aws2-kinesis.uri-endpoint-override

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

camel.component.aws2-kinesis.use-default-credentials-provider

사용자가 기본 인증 정보 공급자를 통해 자격 증명을 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

부울

4장. AWS 2 Lambda

프로듀서만 지원됩니다.

AWS2 Lambda 구성 요소는 AWS Lambda 함수 생성, 가져오기, 나열, 삭제 및 호출을 지원합니다.

사전 요구 사항

유효한 Amazon Web Services 개발자 계정이 있어야 하며 Amazon Lambda를 사용하기 위해 가입해야 합니다. 자세한 내용은 AWS Lambda 에서 확인할 수 있습니다.

Lambda 함수를 생성할 때 적어도 AWSLambdaBasicExecuteRole 정책이 연결된 IAM 역할을 지정해야 합니다.

4.1. URI 형식

aws2-lambda://functionName[?options]

다음 형식으로 URI에 쿼리 옵션을 추가할 수 있습니다. options=value&option2=value&value&…​

4.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

4.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

4.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

4.3. 구성 요소 옵션

AWS Lambda 구성 요소는 아래에 나열된 16가지 옵션을 지원합니다.

이름설명Default유형

구성 (producer)

구성 요소 구성입니다.

 

Lambda2Configuration

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

작업 (producer)

수행할 작업입니다. listFunctions, getFunction, createFunction, deleteFunction 또는 invokeFunction일 수 있습니다.

CloudEvent 값:

  • listFunctions
  • getFunction
  • createAlias
  • deleteAlias
  • getAlias
  • listAliases
  • createFunction
  • deleteFunction
  • invokeFunction
  • updateFunction
  • createEventSourceMapping
  • deleteEventSourceMapping
  • listEventSourceMapping
  • listTags
  • tagResource
  • untagResource
  • publishVersion
  • listVersions

invokeFunction

Lambda2 작업

overrideEndpoint (producer)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

pojoRequest (producer)

gRPC 요청을 본문으로 사용하려면 해당 요청을 본문으로 사용합니다.

false

boolean

region (producer)

Lambda 클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

trustAllCertificates (producer)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

uriEndpointOverride (producer)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (producer)

Lambda 클라이언트가 기본 인증 정보 공급자를 통해 자격 증명을 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

awsLambdaClient (advanced)

Autowired 기존에 구성된 AwsLambdaClient를 클라이언트로 사용합니다.

 

LambdaClient

proxyHost (proxy)

Lambda 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (proxy)

Lambda 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

proxyProtocol (proxy)

Lambda 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

4.4. 끝점 옵션

AWS Lambda 끝점은 URI 구문을 사용하여 구성됩니다.

aws2-lambda:function

다음과 같은 경로 및 쿼리 매개변수 사용:

4.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

기능 (producer)

Lambda 함수의 필수 이름입니다.

 

문자열

4.4.2. 쿼리 매개변수 (14 매개변수)

이름설명Default유형

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

작업 (producer)

수행할 작업입니다. listFunctions, getFunction, createFunction, deleteFunction 또는 invokeFunction일 수 있습니다.

CloudEvent 값:

  • listFunctions
  • getFunction
  • createAlias
  • deleteAlias
  • getAlias
  • listAliases
  • createFunction
  • deleteFunction
  • invokeFunction
  • updateFunction
  • createEventSourceMapping
  • deleteEventSourceMapping
  • listEventSourceMapping
  • listTags
  • tagResource
  • untagResource
  • publishVersion
  • listVersions

invokeFunction

Lambda2 작업

overrideEndpoint (producer)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

pojoRequest (producer)

gRPC 요청을 본문으로 사용하려면 해당 요청을 본문으로 사용합니다.

false

boolean

region (producer)

Lambda 클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

trustAllCertificates (producer)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

uriEndpointOverride (producer)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (producer)

Lambda 클라이언트가 기본 인증 정보 공급자를 통해 자격 증명을 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

awsLambdaClient (advanced)

Autowired 기존에 구성된 AwsLambdaClient를 클라이언트로 사용합니다.

 

LambdaClient

proxyHost (proxy)

Lambda 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (proxy)

Lambda 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

proxyProtocol (proxy)

Lambda 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

필수 Lambda 구성 요소 옵션

Amazon Lambda 서비스에 액세스하려면 레지스트리 또는 accessKey 및 secretKey에 awsLambdaClient를 제공해야 합니다.

4.5. 사용법

4.5.1. 정적 자격 증명 대 기본 인증 정보 공급자

useDefaultCredentialsProvider 옵션을 지정하고 true로 설정하여 명시적 정적 인증 정보 사용을 방지할 수 있습니다.

  • Java 시스템 속성 - aws.accessKeyId 및 aws.secretKey
  • 환경 변수 - AWS_ACCESS_KEY_ID 및 AWS_SECRET_ACCESS_KEY.
  • AWS STS의 웹 ID 토큰.
  • 공유 인증 정보 및 구성 파일입니다.
  • Amazon ECS 컨테이너 인증 정보 - 환경 변수 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI가 설정된 경우 Amazon ECS에서 로드됩니다.
  • Amazon EC2 인스턴스 프로필 자격 증명.

이에 대한 자세한 내용은 AWS 인증 정보 문서를 참조하십시오.

4.5.2. Lambda 생산자가 평가한 메시지 헤더

작업header유형설명필수 항목

All

CamelAwsLambdaOperation

문자열

수행하려는 작업입니다. 쿼리 매개변수로 전달된 작업 덮어쓰기

제공됨

createFunction

CamelAwsLambdaS3Bucket

문자열

Amazon S3 버킷 이름: 배포 패키지가 포함된 .zip 파일이 저장됩니다. 이 버킷은 Lambda 함수를 생성하는 AWS 리전에 있어야 합니다.

없음

createFunction

CamelAwsLambdaS3Key

문자열

업로드하려는 Amazon S3 오브젝트(배포 패키지) 키 이름입니다.

없음

createFunction

CamelAwsLambdaS3ObjectVersion

문자열

업로드하려는 Amazon S3 오브젝트(배포 패키지) 버전입니다.

없음

createFunction

CamelAwsLambdaZipFile

문자열

zip 파일의 로컬 경로입니다(배포 패키지). zip 파일의 내용은 메시지 본문에도 배치할 수 있습니다.

없음

createFunction

CamelAwsLambdaRole

문자열

Lambda가 함수를 실행하여 다른 AWS(Amazon Web Services) 리소스에 액세스할 때 사용하는 IAM 역할의 ARM(Amazon Resource Name)입니다.

제공됨

createFunction

CamelAwsLambdaRuntime

문자열

업로드 중인 Lambda 함수의 런타임 환경(nodejs, nodejs4.3, nodejs6.10, java8, python2.7, python3.6, dotnetcore1.0, >-<js4.3-edge)

제공됨

createFunction

CamelAwsLambdaHandler

문자열

코드 내의 함수는 Lambda가 실행을 시작하기 위해 호출하는 함수입니다. Node.js의 경우 함수의 module-name.export 값입니다. Java의 경우 package.class-name::handler 또는 package.class-name일 수 있습니다.

제공됨

createFunction

CamelAwsLambdaDescription

문자열

사용자 제공 설명입니다.

없음

createFunction

CamelAwsLambdaTargetArn

문자열

Amazon SQS 대기열 또는 AmazonECDHE 주제의 대상 ARN(Amazon Resource Name)이 포함된 상위 오브젝트입니다.

없음

createFunction

CamelAwsLambdaMemorySize

정수

메모리 크기(MB)가 함수에 맞게 구성되었습니다. 64MB의 수여야 합니다.

없음

createFunction

CamelAwsLambdaKMSKeyArn

문자열

함수의 환경 변수를 암호화하는 데 사용되는 KMS 키의 Amazon 리소스 이름(ARN)입니다. 제공되지 않는 경우 AWS Lambda는 기본 서비스 키를 사용합니다.

없음

createFunction

CamelAwsLambdaPublish

부울

이 부울 매개변수를 사용하면 AWS Lambda를 요청하여 Lambda 함수를 생성하고 버전을 원자 작업으로 게시할 수 있습니다.

없음

createFunction

CamelAwsLambdaTimeout

정수

Lambda가 함수를 종료해야 하는 함수 실행 시간입니다. 기본값은 3초입니다.

없음

createFunction

CamelAwsLambdaTracingConfig

문자열

함수의 추적 설정(Active 또는 PassThrough).

없음

createFunction

CamelAwsLambdaEnvironmentVariables

Map<String, String>

사용자 환경의 구성 설정을 나타내는 키-값 쌍입니다.

없음

createFunction

CamelAwsLambdaEnvironmentTags

Map<String, String>

새 함수에 할당된 태그(키-값 쌍) 목록입니다.

없음

createFunction

CamelAwsLambdaSecurityGroupIds

list<String>

Lambda 함수가 VPC의 리소스에 액세스하면 VPC에서 하나 이상의 보안 그룹 ID 목록이 표시됩니다.

없음

createFunction

CamelAwsLambdaSubnetIds

list<String>

Lambda 함수가 VPC의 리소스에 액세스하는 경우 VPC에서 하나 이상의 서브넷 ID 목록에 액세스합니다.

없음

createAlias

CamelAwsLambdaFunctionVersion

문자열

별칭에 설정할 함수 버전입니다.

제공됨

createAlias

CamelAwsLambdaAliasFunctionName

문자열

별칭에 설정할 함수 이름입니다.

제공됨

createAlias

CamelAwsLambdaAliasFunctionDescription

문자열

별칭에 설정할 함수 설명

없음

deleteAlias

CamelAwsLambdaAliasFunctionName

문자열

별칭의 함수 이름입니다.

제공됨

getAlias

CamelAwsLambdaAliasFunctionName

문자열

별칭의 함수 이름입니다.

제공됨

listAliases

CamelAwsLambdaFunctionVersion

문자열

별칭에 설정할 함수 버전입니다.

없음

4.6. 실행 가능한 작업 목록

  • listFunctions
  • getFunction
  • createFunction
  • deleteFunction
  • invokeFunction
  • updateFunction
  • createEventSourceMapping
  • deleteEventSourceMapping
  • listEventSourceMapping
  • listTags
  • tagResource
  • untagResource
  • publishVersion
  • listVersions
  • createAlias
  • deleteAlias
  • getAlias
  • listAliases

4.7. 예

4.7.1. 생산자 예

구성 요소의 작동 방식을 완전히 이해하기 위해 이러한 통합 테스트를 살펴볼 수 있습니다.

4.7.2. 생산자 예

  • CreateFunction: 이 작업은 AWS Lambda에서 기능을 생성합니다.
  from("direct:createFunction").to("aws2-lambda://GetHelloWithName?operation=createFunction").to("mock:result");

자주하는 질문

template.send("direct:createFunction", ExchangePattern.InOut, new Processor() {
    @Override
    public void process(Exchange exchange) throws Exception {
        exchange.getIn().setHeader(Lambda2Constants.RUNTIME, "nodejs6.10");
        exchange.getIn().setHeader(Lambda2Constants.HANDLER, "GetHelloWithName.handler");
        exchange.getIn().setHeader(Lambda2Constants.DESCRIPTION, "Hello with node.js on Lambda");
        exchange.getIn().setHeader(Lambda2Constants.ROLE,
            "arn:aws:iam::643534317684:role/lambda-execution-role");
        ClassLoader classLoader = getClass().getClassLoader();
        File file = new File(
             classLoader
                 .getResource("org/apache/camel/component/aws2/lambda/function/node/GetHelloWithName.zip")
                 .getFile());
        FileInputStream inputStream = new FileInputStream(file);
        exchange.getIn().setBody(inputStream);
    }
});

4.8. 본문으로 사용

경우에 따라 여러 옵션으로 인해 AWS 요청을 빌드하는 것이 복잡할 수 있습니다. 이를 본문으로 사용할 수 있는 가능성을 소개합니다. AWS Lambda에는 Get Function 요청 예제로 제출할 수 있는 여러 작업이 있습니다. 다음과 같은 작업을 수행할 수 있습니다.

from("direct:getFunction")
     .setBody(GetFunctionRequest.builder().functionName("test").build())
     .to("aws2-lambda://GetHelloWithName?awsLambdaClient=#awsLambdaClient&operation=getFunction&pojoRequest=true")

이렇게 하면 이 작업과 관련된 헤더 및 옵션을 전달할 필요 없이 요청을 직접 전달합니다.

4.9. 종속 항목

Maven 사용자는 pom.xml에 다음과 같은 종속성을 추가해야 합니다.

pom.xml

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-aws2-lambda</artifactId>
    <version>${camel-version}</version>
</dependency>

3.14.2 를 실제 Camel 버전으로 교체해야 합니다.

4.10. Spring Boot Auto-Configuration

Spring Boot와 함께 aws2-lambda를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-aws2-lambda-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.aws2-lambda.access-key

Amazon AWS 액세스 키.

 

문자열

camel.component.aws2-lambda.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.aws2-lambda.aws-lambda-client

기존에 구성된 AwsLambdaClient를 클라이언트로 사용하려면 다음을 수행하십시오. 옵션은 software.amazon.awssdk.services.lambda.LambdaClient 유형입니다.

 

LambdaClient

camel.component.aws2-lambda.configuration

구성 요소 구성입니다. 옵션은 org.apache.camel.component.aws2.lambda.Lambda2Configuration 유형입니다.

 

Lambda2Configuration

camel.component.aws2-lambda.enabled

aws2-lambda 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.aws2-lambda.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.aws2-lambda.operation

수행할 작업입니다. listFunctions, getFunction, createFunction, deleteFunction 또는 invokeFunction일 수 있습니다.

 

Lambda2 작업

camel.component.aws2-lambda.override-endpoint

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

부울

camel.component.aws2-lambda.pojo-request

gRPC 요청을 본문으로 사용하려면 해당 요청을 본문으로 사용합니다.

false

부울

camel.component.aws2-lambda.proxy-host

Lambda 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

camel.component.aws2-lambda.proxy-port

Lambda 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

camel.component.aws2-lambda.proxy-protocol

Lambda 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

 

프로토콜

camel.component.aws2-lambda.region

Lambda 클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

camel.component.aws2-lambda.secret-key

Amazon AWS 시크릿 키.

 

문자열

camel.component.aws2-lambda.trust-all-certificates

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

부울

camel.component.aws2-lambda.uri-endpoint-override

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

camel.component.aws2-lambda.use-default-credentials-provider

Lambda 클라이언트가 기본 인증 정보 공급자를 통해 자격 증명을 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

부울

5장. AWS S3 Storage Service

생산자 및 소비자 모두 지원

AWS2 S3 구성 요소는 Amazon의 S3 서비스에서 오브젝트를 저장 및 검색하는 기능을 지원합니다.

사전 요구 사항

유효한 Amazon Web Services 개발자 계정이 있어야 Amazon S3를 사용할 수 있습니다. 자세한 내용은 https://aws.amazon.com/s3 [Amazon S3]에서 확인할 수 있습니다.

5.1. URI 형식

aws2-s3://bucketNameOrArn[?options]

버킷이 아직 존재하지 않는 경우 생성됩니다. 다음 형식의 URI에 쿼리 옵션을 추가할 수 있습니다.

options=value&option2=value&…​

5.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

5.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

5.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

5.3. 구성 요소 옵션

AWS S3 Storage Service 구성 요소는 아래에 나열된 50가지 옵션을 지원합니다.

이름설명Default유형

amazonS3Client (common)

레지스트리 의 com.amazonaws.services.s3.AmazonS3에 대한 자동 연결 참조입니다.

 

S3Client

amazonS3Presigner (common)

자동 연결 요청 S3 사전 서명자, 주로 createDownloadLink 작업에 사용됩니다.

 

S3Presigner

autoCreateBucket (common)

S3 버킷 bucketName의 자동 생성 설정. moveAfterRead 옵션이 활성화된 경우에도 적용되며, 아직 존재하지 않는 경우 destinationBucket이 생성됩니다.

false

boolean

구성 (공용)

구성 요소 구성 요소입니다.

 

AWS2S3Configuration

overrideEndpoint (common)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

pojoRequest (common)

gRPC 요청을 본문으로 사용하려면 해당 요청을 본문으로 사용합니다.

false

boolean

정책 (공용)

com.amazonaws.services.s3.AmazonS3#setBucketPolicy() 메서드에서 설정할 이 큐의 정책입니다.

 

문자열

proxyHost (common)

SQS 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (공용)

클라이언트 정의 내에서 사용할 프록시 포트를 지정합니다.

 

정수

proxyProtocol (공용)

S3 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

리전 (공용)

S3 클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

trustAllCertificates (common)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

uriEndpointOverride (common)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (common)

S3 클라이언트가 기본 인증 정보 공급자를 통해 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

customerAlgorithm (Common (advanced))

CustomerKey가 활성화된 경우 사용할 고객 알고리즘을 정의합니다.

 

문자열

customerKeyId (Common (advanced))

CustomerKey가 활성화된 경우 사용할 Customer 키의 ID를 정의합니다.

 

문자열

customerKeyECDHE5 (일반적으로 (고급)

CustomerKey가 활성화된 경우 사용할 고객 키의 MD5를 정의합니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

deleteAfterRead (consumer)

S3가 검색된 후 오브젝트를 삭제합니다. 삭제는 교환이 커밋된 경우에만 수행됩니다. 롤백이 발생하면 오브젝트가 삭제되지 않습니다. 이 옵션이 false이면 폴링에서 동일한 오브젝트를 반복적으로 검색합니다. 따라서 경로에서 Idempotent Consumer EIP를 사용하여 중복을 필터링해야 합니다. AWS2S3Constants#BUCKET_NAME 및 AWS2S3Constants#KEY 헤더 또는 AWS2S3Constants#KEY 헤더를 사용하여 필터링할 수 있습니다.

true

boolean

구분자 (consumer)

com.amazonaws.services.s3.model.ListObjectsRequest에서 사용되는 구분 기호는 관심 있는 개체만 사용합니다.

 

문자열

destinationBucket (consumer)

moveAfterRead가 true로 설정된 경우 오브젝트를 이동해야 하는 대상 버킷을 정의합니다.

 

문자열

destinationBucketPrefix (consumer)

오브젝트를 이동해야 할 때 사용할 대상 버킷 접두사를 정의하고 moveAfterRead가 true로 설정됩니다.

 

문자열

destinationBucketSuffix (consumer)

오브젝트를 이동해야 할 때 사용할 대상 버킷 접미사를 정의하고 moveAfterRead가 true로 설정됩니다.

 

문자열

doneFileName (consumer)

Camel은 제공된 경우, 완료된 파일이 존재하는 경우에만 파일을 사용합니다.

 

문자열

파일 이름 (consumer)

지정된 파일 이름으로 버킷에서 오브젝트를 가져오려면 다음을 수행합니다.

 

문자열

ignoreBody (consumer)

If it is true, the S3 Object body will be ignored completely, if it is set to false the S3 Object will be put in the body. 이 값을 true로 설정하면 includeBody 옵션으로 정의된 모든 동작이 재정의됩니다.

false

boolean

includeBody (consumer)

true인 경우 S3Object 교환이 소비되어 본문에 배치되고 닫힙니다. false인 경우 S3Object 스트림은 본문에 raw를 배치하고 헤더는 S3 오브젝트 메타데이터로 설정됩니다. 이 옵션은 autocloseBody 옵션과 강하게 관련이 있습니다. S3Object 스트림이 소비되기 때문에 includeBody를 true로 설정하는 경우 includeBody false의 경우 S3Object 스트림을 닫는 호출자까지 됩니다. 그러나 includeBody가 false인 경우 autocloseBody를 true로 설정하면 교환 완료 시 S3Object 스트림을 자동으로 닫도록 예약됩니다.

true

boolean

IncludeFolders (consumer)

true인 경우 폴더/디렉터리가 사용됩니다. false인 경우 해당 값은 무시되고 Exchange가 생성되지 않습니다.

true

boolean

moveAfterRead (consumer)

오브젝트를 검색된 후 S3 버킷에서 다른 버킷으로 이동합니다. 작업을 수행하려면 destinationBucket 옵션을 설정해야 합니다. 복사 버킷 작업은 교환이 커밋된 경우에만 수행됩니다. 롤백이 발생하면 오브젝트가 이동되지 않습니다.

false

boolean

접두사 (consumer)

com.amazonaws.services.s3.model.ListObjectsRequest에 사용되는 접두사는 관심 있는 개체만 사용합니다.

 

문자열

autocloseBody (consumer (advanced))

이 옵션이 true이고 includeBody가 false이면 교환 완료 시 S3Object.close() 메서드가 호출됩니다. 이 옵션은 includeBody 옵션과 강력하게 관련이 있습니다. includeBody를 false로 설정하고 autocloseBody를 false로 설정하는 경우 호출자는 S3Object 스트림을 닫을 수 있습니다. autocloseBody를 true로 설정하면 S3Object 스트림이 자동으로 종료됩니다.

true

boolean

batchMessageNumber (producer)

스트리밍 업로드 모드에서 배치를 구성하는 메시지 수입니다.

10

int

batchSize (producer)

스트리밍 업로드 모드의 배치 크기(바이트 단위)입니다.

1000000

int

deleteAfterWrite (producer)

S3 파일이 업로드된 후 파일 오브젝트를 삭제합니다.

false

boolean

keyName (producer)

엔드포인트 매개 변수를 통해 버킷에 있는 요소의 키 이름을 설정합니다.

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

MultiPartUpload (producer)

true인 경우 camel은 여러 파트 형식으로 파일을 업로드하고 부분 크기는 partSize 옵션으로 결정합니다.

false

boolean

namingStrategy (producer)

스트리밍 업로드 모드에서 사용할 이름 지정 전략입니다.

CloudEvent 값:

  • Progressive
  • random

Progressive

AWSS3NamingStrategyEnum

작업 (producer)

사용자가 업로드만 하지 않으려는 경우 수행할 작업.

CloudEvent 값:

  • copyObject
  • listObjects
  • deleteObject
  • deleteBucket
  • listBuckets
  • getObject
  • getObjectRange
  • createDownloadLink
 

AWS2S3Operations

partSize (producer)

다중 파트 업로드에 사용되는 partSize를 설정합니다. 기본값은 25M입니다.

26214400

long

restartingPolicy (producer)

스트리밍 업로드 모드에서 사용할 재시작 정책입니다.

CloudEvent 값:

  • 덮어쓰기
  • lastPart

덮어쓰기

AWSS3RestartingPolicyEnum

StorageClass ( producer)

com.amazonaws.services.s3.model.PutObjectRequest 요청에 설정할 스토리지 클래스입니다.

 

문자열

streamingUploadMode (producer)

스트림 모드가 true이면 버킷에 대한 업로드는 스트리밍에서 수행됩니다.

false

boolean

streamingUploadTimeout (producer)

streaming upload 모드가 true이지만 이 옵션은 업로드를 완료하기 위해 시간 초과를 설정합니다.

 

long

awsKMSKeyId (producer (advanced))

KMS가 활성화된 경우 사용할 KMS 키의 ID를 정의합니다.

 

문자열

useAwsKMS (producer (advanced))

KMS를 사용해야 하는지 여부를 정의합니다.

false

boolean

UseCustomerKey (제조업체)

고객 키를 사용해야 하는지 여부를 정의합니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

5.4. 끝점 옵션

AWS S3 Storage Service 엔드포인트는 URI 구문을 사용하여 구성됩니다.

aws2-s3://bucketNameOrArn

다음과 같은 경로 및 쿼리 매개변수 사용:

5.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

bucketNameOrArn (common)

필수 버킷 이름 또는 ARN.

 

문자열

5.4.2. 쿼리 매개변수 (68 매개변수)

이름설명Default유형

amazonS3Client (common)

레지스트리 의 com.amazonaws.services.s3.AmazonS3에 대한 자동 연결 참조입니다.

 

S3Client

amazonS3Presigner (common)

자동 연결 요청 S3 사전 서명자, 주로 createDownloadLink 작업에 사용됩니다.

 

S3Presigner

autoCreateBucket (common)

S3 버킷 bucketName의 자동 생성 설정. moveAfterRead 옵션이 활성화된 경우에도 적용되며, 아직 존재하지 않는 경우 destinationBucket이 생성됩니다.

false

boolean

overrideEndpoint (common)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

pojoRequest (common)

gRPC 요청을 본문으로 사용하려면 해당 요청을 본문으로 사용합니다.

false

boolean

정책 (공용)

com.amazonaws.services.s3.AmazonS3#setBucketPolicy() 메서드에서 설정할 이 큐의 정책입니다.

 

문자열

proxyHost (common)

SQS 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (공용)

클라이언트 정의 내에서 사용할 프록시 포트를 지정합니다.

 

정수

proxyProtocol (공용)

S3 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

리전 (공용)

S3 클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

trustAllCertificates (common)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

uriEndpointOverride (common)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (common)

S3 클라이언트가 기본 인증 정보 공급자를 통해 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

customerAlgorithm (Common (advanced))

CustomerKey가 활성화된 경우 사용할 고객 알고리즘을 정의합니다.

 

문자열

customerKeyId (Common (advanced))

CustomerKey가 활성화된 경우 사용할 Customer 키의 ID를 정의합니다.

 

문자열

customerKeyECDHE5 (일반적으로 (고급)

CustomerKey가 활성화된 경우 사용할 고객 키의 MD5를 정의합니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

deleteAfterRead (consumer)

S3가 검색된 후 오브젝트를 삭제합니다. 삭제는 교환이 커밋된 경우에만 수행됩니다. 롤백이 발생하면 오브젝트가 삭제되지 않습니다. 이 옵션이 false이면 폴링에서 동일한 오브젝트를 반복적으로 검색합니다. 따라서 경로에서 Idempotent Consumer EIP를 사용하여 중복을 필터링해야 합니다. AWS2S3Constants#BUCKET_NAME 및 AWS2S3Constants#KEY 헤더 또는 AWS2S3Constants#KEY 헤더를 사용하여 필터링할 수 있습니다.

true

boolean

구분자 (consumer)

com.amazonaws.services.s3.model.ListObjectsRequest에서 사용되는 구분 기호는 관심 있는 개체만 사용합니다.

 

문자열

destinationBucket (consumer)

moveAfterRead가 true로 설정된 경우 오브젝트를 이동해야 하는 대상 버킷을 정의합니다.

 

문자열

destinationBucketPrefix (consumer)

오브젝트를 이동해야 할 때 사용할 대상 버킷 접두사를 정의하고 moveAfterRead가 true로 설정됩니다.

 

문자열

destinationBucketSuffix (consumer)

오브젝트를 이동해야 할 때 사용할 대상 버킷 접미사를 정의하고 moveAfterRead가 true로 설정됩니다.

 

문자열

doneFileName (consumer)

Camel은 제공된 경우, 완료된 파일이 존재하는 경우에만 파일을 사용합니다.

 

문자열

파일 이름 (consumer)

지정된 파일 이름으로 버킷에서 오브젝트를 가져오려면 다음을 수행합니다.

 

문자열

ignoreBody (consumer)

If it is true, the S3 Object body will be ignored completely, if it is set to false the S3 Object will be put in the body. 이 값을 true로 설정하면 includeBody 옵션으로 정의된 모든 동작이 재정의됩니다.

false

boolean

includeBody (consumer)

true인 경우 S3Object 교환이 소비되어 본문에 배치되고 닫힙니다. false인 경우 S3Object 스트림은 본문에 raw를 배치하고 헤더는 S3 오브젝트 메타데이터로 설정됩니다. 이 옵션은 autocloseBody 옵션과 강하게 관련이 있습니다. S3Object 스트림이 소비되기 때문에 includeBody를 true로 설정하는 경우 includeBody false의 경우 S3Object 스트림을 닫는 호출자까지 됩니다. 그러나 includeBody가 false인 경우 autocloseBody를 true로 설정하면 교환 완료 시 S3Object 스트림을 자동으로 닫도록 예약됩니다.

true

boolean

IncludeFolders (consumer)

true인 경우 폴더/디렉터리가 사용됩니다. false인 경우 해당 값은 무시되고 Exchange가 생성되지 않습니다.

true

boolean

maxConnections (consumer)

S3 클라이언트 구성에서 maxConnections 매개변수를 설정합니다.

60

int

maxMessagesPerPoll (consumer)

각 폴링 시 폴링 제한으로 최대 메시지 수를 가져옵니다. 각 폴링 시 폴링 제한으로 최대 메시지 수를 가져옵니다. 기본값은 10입니다. 0 또는 음수를 사용하여 무제한으로 설정합니다.

10

int

moveAfterRead (consumer)

오브젝트를 검색된 후 S3 버킷에서 다른 버킷으로 이동합니다. 작업을 수행하려면 destinationBucket 옵션을 설정해야 합니다. 복사 버킷 작업은 교환이 커밋된 경우에만 수행됩니다. 롤백이 발생하면 오브젝트가 이동되지 않습니다.

false

boolean

접두사 (consumer)

com.amazonaws.services.s3.model.ListObjectsRequest에 사용되는 접두사는 관심 있는 개체만 사용합니다.

 

문자열

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

autocloseBody (consumer (advanced))

이 옵션이 true이고 includeBody가 false이면 교환 완료 시 S3Object.close() 메서드가 호출됩니다. 이 옵션은 includeBody 옵션과 강력하게 관련이 있습니다. includeBody를 false로 설정하고 autocloseBody를 false로 설정하는 경우 호출자는 S3Object 스트림을 닫을 수 있습니다. autocloseBody를 true로 설정하면 S3Object 스트림이 자동으로 종료됩니다.

true

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

batchMessageNumber (producer)

스트리밍 업로드 모드에서 배치를 구성하는 메시지 수입니다.

10

int

batchSize (producer)

스트리밍 업로드 모드의 배치 크기(바이트 단위)입니다.

1000000

int

deleteAfterWrite (producer)

S3 파일이 업로드된 후 파일 오브젝트를 삭제합니다.

false

boolean

keyName (producer)

엔드포인트 매개 변수를 통해 버킷에 있는 요소의 키 이름을 설정합니다.

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

MultiPartUpload (producer)

true인 경우 camel은 여러 파트 형식으로 파일을 업로드하고 부분 크기는 partSize 옵션으로 결정합니다.

false

boolean

namingStrategy (producer)

스트리밍 업로드 모드에서 사용할 이름 지정 전략입니다.

CloudEvent 값:

  • Progressive
  • random

Progressive

AWSS3NamingStrategyEnum

작업 (producer)

사용자가 업로드만 하지 않으려는 경우 수행할 작업.

CloudEvent 값:

  • copyObject
  • listObjects
  • deleteObject
  • deleteBucket
  • listBuckets
  • getObject
  • getObjectRange
  • createDownloadLink
 

AWS2S3Operations

partSize (producer)

다중 파트 업로드에 사용되는 partSize를 설정합니다. 기본값은 25M입니다.

26214400

long

restartingPolicy (producer)

스트리밍 업로드 모드에서 사용할 재시작 정책입니다.

CloudEvent 값:

  • 덮어쓰기
  • lastPart

덮어쓰기

AWSS3RestartingPolicyEnum

StorageClass ( producer)

com.amazonaws.services.s3.model.PutObjectRequest 요청에 설정할 스토리지 클래스입니다.

 

문자열

streamingUploadMode (producer)

스트림 모드가 true이면 버킷에 대한 업로드는 스트리밍에서 수행됩니다.

false

boolean

streamingUploadTimeout (producer)

streaming upload 모드가 true이지만 이 옵션은 업로드를 완료하기 위해 시간 초과를 설정합니다.

 

long

awsKMSKeyId (producer (advanced))

KMS가 활성화된 경우 사용할 KMS 키의 ID를 정의합니다.

 

문자열

useAwsKMS (producer (advanced))

KMS를 사용해야 하는지 여부를 정의합니다.

false

boolean

UseCustomerKey (제조업체)

고객 키를 사용해야 하는지 여부를 정의합니다.

false

boolean

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

필수 S3 구성 요소 옵션

Amazon의 S3에 액세스하려면 레지스트리 또는 accessKey 및 secretKey에 amazon S3Client를 제공해야 합니다.

5.5. 일괄 소비자

이 구성 요소는 Batch Consumer를 구현합니다.

이를 통해 이 일괄 처리 내에 존재하는 메시지 수를 알 수 있으며 예를 들어 Aggregator가 이 메시지 수를 집계하도록 할 수 있습니다.

5.6. 사용법

예를 들어 버킷 helloBucket 에서 hello.txt 파일을 읽으려면 다음 스니펫을 사용합니다.

from("aws2-s3://helloBucket?accessKey=yourAccessKey&secretKey=yourSecretKey&prefix=hello.txt")
  .to("file:/var/downloaded");

5.6.1. S3 프로듀서에서 평가한 메시지 헤더

header유형설명

CamelAwsS3BucketName

문자열

이 오브젝트가 저장되거나 현재 작업에 사용될 버킷 이름

CamelAwsS3BucketDestinationName

문자열

현재 작업에 사용할 버킷 대상 이름

CamelAwsS3ContentLength

long

이 오브젝트의 콘텐츠 길이입니다.

CamelAwsS3ContentType

문자열

이 오브젝트의 콘텐츠 유형입니다.

CamelAwsS3ContentControl

문자열

이 개체의 콘텐츠 컨트롤입니다.

CamelAwsS3ContentDisposition

문자열

이 개체의 콘텐츠 배열입니다.

CamelAwsS3ContentEncoding

문자열

이 개체의 콘텐츠 인코딩입니다.

CamelAwsS3ContentMD5

문자열

이 오브젝트의 md5 체크섬입니다.

CamelAwsS3DestinationKey

문자열

현재 작업에 사용할 대상 키입니다.

CamelAwsS3Key

문자열

이 개체가 저장되거나 현재 작업에 사용될 키

CamelAwsS3LastModified

java.util.Date

이 오브젝트의 마지막으로 수정된 타임스탬프입니다.

CamelAwsS3Operation

문자열

수행할 작업입니다. 허용된 값은 copyObject, deleteObject, listBuckets, deleteBucket, listObjects입니다.

CamelAwsS3StorageClass

문자열

이 오브젝트의 스토리지 클래스입니다.

CamelAwsS3CannedAcl

문자열

canned acl that will be applied to the object. see software.amazon.awssdk.services.s3.model.ObjectCannedACL for allowed values.

CamelAwsS3Acl

software.amazon.awssdk.services.s3.model.BucketCannedACL

잘 구성된 Amazon S3 액세스 제어 목록 오브젝트. 자세한 내용은 software.amazon.awssdk.services.s3.model.BucketCannedACL 을 참조하십시오.

CamelAwsS3ServerSideEncryption

문자열

AWS 관리 키를 사용하여 오브젝트를 암호화할 때 서버 측 암호화 알고리즘을 설정합니다. 예를 들어 AES256을 사용합니다.

CamelAwsS3VersionId

문자열

현재 작업에서 저장 또는 반환할 오브젝트의 버전 Id

CamelAwsS3Metadata

Map<String, String>

S3에서 오브젝트와 함께 저장할 메타데이터 맵입니다. 메타데이터에 대한 자세한 내용

5.6.2. S3 생산자가 설정한 메시지 헤더

header유형설명

CamelAwsS3ETag

문자열

새로 업로드된 오브젝트의 ETag 값입니다.

CamelAwsS3VersionId

문자열

새로 업로드된 오브젝트의 선택적 버전 ID입니다.

5.6.3. S3 소비자가 설정한 메시지 헤더

header유형설명

CamelAwsS3Key

문자열

이 오브젝트가 저장되는 키입니다.

CamelAwsS3BucketName

문자열

이 오브젝트가 포함된 버킷의 이름입니다.

CamelAwsS3ETag

문자열

RFC 1864에 따른 관련 오브젝트의 16진수 인코딩 128비트 MD5 다이제스트입니다. 이 데이터는 무결성 검사로 사용되어 호출자가 수신한 데이터가 Amazon S3에서 보낸 데이터와 동일한지 확인합니다.

CamelAwsS3LastModified

날짜

Amazon S3가 마지막으로 관련 오브젝트에 대한 수정 사항을 기록한 날짜와 시간을 나타내는 Last-Modified 헤더 값입니다.

CamelAwsS3VersionId

문자열

사용 가능한 경우 관련 Amazon S3 오브젝트의 버전 ID입니다. 버전 ID는 오브젝트가 오브젝트가 활성화된 Amazon S3 버킷에 업로드된 경우에만 오브젝트에 할당됩니다.

CamelAwsS3ContentType

문자열

Content-Type HTTP 헤더는 연결된 오브젝트에 저장된 콘텐츠 유형을 나타냅니다. 이 헤더의 값은 표준 MIME 유형입니다.

CamelAwsS3ContentMD5

문자열

RFC 1864에 따라 연결된 오브젝트의 base64 인코딩 128비트 MD5 다이제스트(내용 - 헤더 포함)입니다. 이 데이터는 메시지 무결성 검사로 사용되어 Amazon S3에서 수신한 데이터가 호출자가 전송한 데이터와 동일한지 확인합니다.

CamelAwsS3ContentLength

long

연결된 오브젝트의 크기를 바이트 단위로 나타내는 Content-Length HTTP 헤더입니다.

CamelAwsS3ContentEncoding

문자열

선택적 Content-Encoding HTTP 헤더는 개체에 적용된 콘텐츠 인코딩과 Content-Type 필드에서 참조하는 미디어 유형을 가져오기 위해 어떤 디코딩 메커니즘을 적용해야 하는지 지정합니다.

CamelAwsS3ContentDisposition

문자열

오브젝트를 저장할 권장 파일 이름과 같은 프레젠테이션 정보를 지정하는 선택적 Content-Disposition HTTP 헤더입니다.

CamelAwsS3ContentControl

문자열

사용자가 HTTP 요청/다시 체인에 따라 캐싱 동작을 지정할 수 있는 선택적 Cache-Control HTTP 헤더입니다.

CamelAwsS3ServerSideEncryption

문자열

AWS 관리 키를 사용하여 오브젝트를 암호화할 때 서버 측 암호화 알고리즘입니다.

CamelAwsS3Metadata

Map<String, String>

오브젝트와 S3에 저장된 메타데이터 맵입니다. 메타데이터에 대한 자세한 내용

5.6.4. S3 Producer 작업

Camel-AWS2-S3 구성 요소는 프로듀서 측에서 다음 작업을 제공합니다.

  • copyObject
  • deleteObject
  • listBuckets
  • deleteBucket
  • listObjects
  • GetObject(S3Object 인스턴스 반환)
  • getObjectRange(S3Object 인스턴스 반환)
  • createDownloadLink

작업을 명시적으로 지정하지 않으면 생산자가 수행합니다. - 단일 파일 업로드 - multiPartUpload 옵션이 활성화된 경우 다중 파트 업로드.

5.6.5. 고급 AmazonS3 구성

Camel 애플리케이션이 방화벽 뒤에서 실행 중이거나 S3Client 인스턴스 구성을 더 많이 제어해야 하는 경우 자체 인스턴스를 생성하고 Camel aws2-s3 구성 요소 구성에서 이를 참조할 수 있습니다.

from("aws2-s3://MyBucket?amazonS3Client=#client&delay=5000&maxMessagesPerPoll=5")
.to("mock:result");

5.6.6. S3 구성 요소와 함께 KMS 사용

AWS KMS를 사용하여 AWS 인프라를 사용하여 데이터를 암호화/암호화하려면 다음 예제와 같이 2.21.x에 도입된 옵션을 사용할 수 있습니다.

from("file:tmp/test?fileName=test.txt")
     .setHeader(S3Constants.KEY, constant("testFile"))
     .to("aws2-s3://mybucket?amazonS3Client=#client&useAwsKMS=true&awsKMSKeyId=3f0637ad-296a-3dfe-a796-e60654fb128c");

이렇게 하면 S3에 요청하여 KMS 키 3f0637ad-296a-3dfe-a796-e60654fb128c를 사용하여 test.txt 파일을 암호화합니다. 이 파일을 다운로드하도록 요청하면 암호 해독이 다운로드되기 전에 직접 수행됩니다.

5.6.7. 정적 자격 증명 대 기본 인증 정보 공급자

useDefaultCredentialsProvider 옵션을 지정하고 true로 설정하여 명시적 정적 인증 정보 사용을 방지할 수 있습니다.

  • Java 시스템 속성 - aws.accessKeyId 및 aws.secretKey
  • 환경 변수 - AWS_ACCESS_KEY_ID 및 AWS_SECRET_ACCESS_KEY.
  • AWS STS의 웹 ID 토큰.
  • 공유 인증 정보 및 구성 파일입니다.
  • Amazon ECS 컨테이너 인증 정보 - 환경 변수 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI가 설정된 경우 Amazon ECS에서 로드됩니다.
  • Amazon EC2 인스턴스 프로필 자격 증명.

이에 대한 자세한 내용은 AWS 인증 정보 문서를 참조하십시오.

5.6.8. S3 Producer 작업 예

  • 단일 업로드: 이 작업은 본문 내용을 기반으로 파일을 S3에 업로드합니다.
  from("direct:start").process(new Processor() {

      @Override
      public void process(Exchange exchange) throws Exception {
          exchange.getIn().setHeader(S3Constants.KEY, "camel.txt");
          exchange.getIn().setBody("Camel rocks!");
      }
  })
  .to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client")
  .to("mock:result");

이 작업은 mycamelbucket 버킷에 "Camel Pauls!" 컨텐츠와 함께 file camel.txt를 업로드합니다.

  • Multipart Upload: 이 작업은 본문 내용을 기반으로 S3에 다중 파트 업로드를 수행합니다.
  from("direct:start").process(new Processor() {

      @Override
      public void process(Exchange exchange) throws Exception {
          exchange.getIn().setHeader(AWS2S3Constants.KEY, "empty.txt");
          exchange.getIn().setBody(new File("src/empty.txt"));
      }
  })
  .to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&multiPartUpload=true&autoCreateBucket=true&partSize=1048576")
  .to("mock:result");

이 작업은 mycamelbucket 버킷의 파일ECDHE/empty.txt 내용을 기반으로 empty.txt 파일의 다중 파트 업로드를 수행합니다.

  • CopyObject: 이 작업은 하나의 버킷에서 다른 버킷으로 오브젝트를 복사합니다.
  from("direct:start").process(new Processor() {

      @Override
      public void process(Exchange exchange) throws Exception {
          exchange.getIn().setHeader(S3Constants.BUCKET_DESTINATION_NAME, "camelDestinationBucket");
          exchange.getIn().setHeader(S3Constants.KEY, "camelKey");
          exchange.getIn().setHeader(S3Constants.DESTINATION_KEY, "camelDestinationKey");
      }
  })
  .to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=copyObject")
  .to("mock:result");

이 작업은 헤더 camelDestinationKey에 표시된 이름으로 오브젝트를 버킷 mycamelbucket에서 camelDestinationBucket에 복사합니다.

  • DeleteObject: 이 작업은 버킷에서 오브젝트를 삭제합니다.
  from("direct:start").process(new Processor() {

      @Override
      public void process(Exchange exchange) throws Exception {
          exchange.getIn().setHeader(S3Constants.KEY, "camelKey");
      }
  })
  .to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=deleteObject")
  .to("mock:result");

이 작업은 버킷 mycamelbucket에서 오브젝트 camelKey를 삭제합니다.

  • ListBuckets: 이 작업은 이 리전에서 이 계정의 버킷을 나열합니다.
  from("direct:start")
  .to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=listBuckets")
  .to("mock:result");

이 작업은 이 계정의 버킷을 나열합니다.

  • DeleteBucket: 이 작업은 URI 매개변수 또는 헤더로 지정된 버킷을 삭제합니다.
  from("direct:start")
  .to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=deleteBucket")
  .to("mock:result");

이 작업은 버킷 mycamelbucket을 삭제합니다.

  • ListObjects: 이 작업 목록 오브젝트를 특정 버킷의
  from("direct:start")
  .to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=listObjects")
  .to("mock:result");

이 작업은 mycamelbucket 버킷에 오브젝트가 나열됩니다.

  • GetObject: 이 작업은 특정 버킷에 단일 개체를 가져옵니다.
  from("direct:start").process(new Processor() {

      @Override
      public void process(Exchange exchange) throws Exception {
          exchange.getIn().setHeader(S3Constants.KEY, "camelKey");
      }
  })
  .to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=getObject")
  .to("mock:result");

이 작업은 mycamelbucket 버킷의 camelKey 오브젝트와 관련된 S3Object 인스턴스를 반환합니다.

  • GetObjectRange: 이 작업은 특정 버킷에 단일 개체 범위를 가져옵니다.
  from("direct:start").process(new Processor() {

      @Override
      public void process(Exchange exchange) throws Exception {
          exchange.getIn().setHeader(S3Constants.KEY, "camelKey");
          exchange.getIn().setHeader(S3Constants.RANGE_START, "0");
          exchange.getIn().setHeader(S3Constants.RANGE_END, "9");
      }
  })
  .to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=getObjectRange")
  .to("mock:result");

이 작업은 mycamelbucket 버킷의 camelKey 오브젝트와 관련된 S3Object 인스턴스를 반환하고 0에서 9까지의 바이트를 포함합니다.

  • CreateDownloadLink: 이 작업은 S3 Presigner를 통해 다운로드 링크를 반환합니다.
  from("direct:start").process(new Processor() {

      @Override
      public void process(Exchange exchange) throws Exception {
          exchange.getIn().setHeader(S3Constants.KEY, "camelKey");
      }
  })
  .to("aws2-s3://mycamelbucket?accessKey=xxx&secretKey=yyy&region=region&operation=createDownloadLink")
  .to("mock:result");

이 작업은 버킷 mycamelbucket 및 region 리전에 camel-key 파일에 대한 다운로드 링크 URL을 반환합니다.

5.7. 스트리밍 업로드 모드

스트림 모드를 사용하면 멀티 파트 업로드를 활용하여 미리 데이터 차원을 인식하지 않고도 S3에 데이터를 업로드할 수 있습니다. batchSize가 완료되었거나 batchMessageNumber에 도달한 경우 업로드가 완료됩니다. 이름 지정 전략에는 다음 두 가지가 있습니다.

  • Progressive

    프로그레시브 전략을 사용하면 각 파일에 keyName 옵션과 프로그레시브 카운터로 구성된 이름과 결국 파일 확장(있는 경우)이 있습니다.

  • random.

    임의의 전략을 사용하면 keyName 후에 UUID가 추가되고 결국 파일 확장자가 추가됩니다.

예를 들면 다음과 같습니다.

from(kafka("topic1").brokers("localhost:9092"))
        .log("Kafka Message is: ${body}")
        .to(aws2S3("camel-bucket").streamingUploadMode(true).batchMessageNumber(25).namingStrategy(AWS2S3EndpointBuilderFactory.AWSS3NamingStrategyEnum.progressive).keyName("{{kafkaTopic1}}/{{kafkaTopic1}}.txt"));

from(kafka("topic2").brokers("localhost:9092"))
         .log("Kafka Message is: ${body}")
         .to(aws2S3("camel-bucket").streamingUploadMode(true).batchMessageNumber(25).namingStrategy(AWS2S3EndpointBuilderFactory.AWSS3NamingStrategyEnum.progressive).keyName("{{kafkaTopic2}}/{{kafkaTopic2}}.txt"));

배치의 기본 크기는 1Mb이지만 요구 사항에 따라 조정할 수 있습니다.

생산자 경로를 중지하면 생산자가 버퍼링된 나머지 메시지를 플러시하고 업로드를 완료합니다.

스트리밍 업로드에서는 생산자가 남아 있는 시점에서 생산자를 다시 시작할 수 있습니다. 이 기능은 프로그레시브 이름 지정 전략을 사용하는 경우에만 중요합니다.

restartingPolicy를 lastPart로 설정하면 생산자가 남아 있는 마지막 부분 번호에서 파일 및 콘텐츠 업로드를 다시 시작합니다.

예제

  1. 프로그레시브 이름 지정 전략과 키 이름이 camel.txt로 경로를 시작합니다. batchMessageNumber는 20이고 restartPolicy는 lastPart - Send 70 메시지와 동일합니다.
  2. 경로 중지
  3. S3 버킷에 4개의 파일이 표시됩니다. * camel.txt

    • camel-1.txt
    • camel-2.txt
    • camel-3.txt

      처음 3개의 메시지는 20개, 마지막 메시지는 10개입니다.

  4. 경로를 다시 시작합니다.
  5. 25 개의 메시지를 보냅니다.
  6. 경로를 중지합니다.
  7. 이제 버킷에 두 개의 다른 파일인 camel-5.txt 및 camel-6.txt가 있고 20개의 메시지가 있는 첫 번째 파일과 5개의 메시지가 있습니다.
  8. 진행 중

이는 임의의 이름 지정 전략을 사용할 때 필요하지 않습니다.

반대로 override restartPolicy를 지정할 수 있습니다. 이 경우 버킷에서 (해당 특정 keyName) 이전에 작성한 모든 항목을 덮어쓸 수 있습니다.

참고

스트리밍 업로드 모드에서 고려해야 할 유일한 keyName 옵션은 끝점 옵션입니다. 헤더를 사용하면 NPE가 throw되며 설계에 의해 수행됩니다. 헤더를 설정하면 각 교환에서 파일 이름을 잠재적으로 변경할 수 있으며 이는 스트리밍 업로드 프로듀서의 목표에 해당합니다. keyName은 고정되고 정적이어야 합니다. 선택한 이름 지정 전략이 나머지 작업을 수행합니다.

또 다른 가능성은 batchMessageNumber 및 batchSize 옵션을 사용하여 streamingUploadTimeout을 지정하는 것입니다. 이 옵션을 사용하면 특정 시간이 경과한 후 파일 업로드를 완료할 수 있습니다. 이러한 방식으로 업로드 완료는 시간 초과, 메시지 수 및 배치 크기의 세 가지 계층에 전달됩니다.

예를 들면 다음과 같습니다.

from(kafka("topic1").brokers("localhost:9092"))
        .log("Kafka Message is: ${body}")
        .to(aws2S3("camel-bucket").streamingUploadMode(true).batchMessageNumber(25).streamingUploadTimeout(10000).namingStrategy(AWS2S3EndpointBuilderFactory.AWSS3NamingStrategyEnum.progressive).keyName("{{kafkaTopic1}}/{{kafkaTopic1}}.txt"));

이 경우 업로드는 10초 후에 완료됩니다.

5.8. 버킷 자동 생성

autoCreateBucket 옵션을 사용하면 존재하지 않는 경우 S3 버킷의 자동 생성을 방지할 수 있습니다. 이 옵션의 기본값은 true 입니다. false로 설정하면 AWS에서 존재하지 않는 버킷의 작업이 실패하면 오류가 반환됩니다.

5.9. 버킷과 다른 버킷 간 항목 이동

일부 사용자는 버킷에서 항목을 사용하고 이 구성 요소의 copyObject 기능을 사용하지 않고 다른 콘텐츠를 이동하는 것을 선호합니다. 이 경우 소비자의 들어오는 교환에서 bucketName 헤더를 제거해야 합니다. 그렇지 않으면 파일이 항상 동일한 원래 버킷에서 덮어씁니다.

5.10. MoveAfterRead 소비자 옵션

deleteAfterRead 외에 다른 옵션이 추가되었습니다. moveAfterRead. 이 옵션을 활성화하면 소비된 오브젝트는 삭제만 하는 대신 대상 destinationBucket으로 이동합니다. 이를 위해서는 destinationBucket 옵션을 지정해야 합니다. 예를 들면 다음과 같습니다.

  from("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&moveAfterRead=true&destinationBucket=myothercamelbucket")
  .to("mock:result");

이 경우 소비된 오브젝트는 myothercamelbucket 버킷으로 이동하여 원래 버킷에서 삭제됩니다(삭제AfterRead가 기본값으로 설정되었기 때문에).

또한 파일을 다른 버킷으로 이동하는 동안 키 접두사/suffix를 사용할 수 있습니다. 옵션은 destinationBucketPrefix 및 destinationBucketSuffix입니다.

위의 예를 들면 다음과 같은 작업을 수행할 수 있습니다.

  from("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&moveAfterRead=true&destinationBucket=myothercamelbucket&destinationBucketPrefix=RAW(pre-)&destinationBucketSuffix=RAW(-suff)")
  .to("mock:result");

이 경우 소비된 오브젝트는 myothercamelbucket 버킷으로 이동하여 원래 버킷에서 삭제됩니다(삭제AfterRead가 기본값으로 설정되었기 때문에).

따라서 파일 이름이 test인 경우 myothercamelbucket에 pre-test-suff라는 파일이 표시되어야 합니다.

5.11. 고객 키를 암호화로 사용

또한 고객 키 지원 ( KMS 사용 대안)도 도입했습니다. 다음 코드에서는 예제를 보여줍니다.

String key = UUID.randomUUID().toString();
byte[] secretKey = generateSecretKey();
String b64Key = Base64.getEncoder().encodeToString(secretKey);
String b64KeyMd5 = Md5Utils.md5AsBase64(secretKey);

String awsEndpoint = "aws2-s3://mycamel?autoCreateBucket=false&useCustomerKey=true&customerKeyId=RAW(" + b64Key + ")&customerKeyMD5=RAW(" + b64KeyMd5 + ")&customerAlgorithm=" + AES256.name();

from("direct:putObject")
    .setHeader(AWS2S3Constants.KEY, constant("test.txt"))
    .setBody(constant("Test"))
    .to(awsEndpoint);

5.12. 본문으로 사용

경우에 따라 여러 옵션으로 인해 AWS 요청을 빌드하는 것이 복잡할 수 있습니다. 이를 본문으로 사용할 수 있는 가능성을 소개합니다. AWS S3에는 브로커 요청 목록 요청의 예로 다음과 같은 작업을 제출할 수 있는 여러 작업이 있습니다.

from("direct:aws2-s3")
     .setBody(ListObjectsRequest.builder().bucket(bucketName).build())
     .to("aws2-s3://test?amazonS3Client=#amazonS3Client&operation=listObjects&pojoRequest=true")

이렇게 하면 이 작업과 관련된 헤더 및 옵션을 전달할 필요 없이 요청을 직접 전달합니다.

5.13. S3 클라이언트를 생성하고 레지스트리에 구성 요소 추가

S3 클라이언트를 설정할 수도 있는 AWS2S3Configuration을 사용하여 일부 고급 구성을 수행하는 경우가 있습니다. 다음 예와 같이 구성 요소 구성에서 S3 클라이언트를 생성하고 설정할 수 있습니다.

String awsBucketAccessKey = "your_access_key";
String awsBucketSecretKey = "your_secret_key";

S3Client s3Client = S3Client.builder().credentialsProvider(StaticCredentialsProvider.create(AwsBasicCredentials.create(awsBucketAccessKey, awsBucketSecretKey)))
                .region(Region.US_EAST_1).build();

AWS2S3Configuration configuration = new AWS2S3Configuration();
configuration.setAmazonS3Client(s3Client);
configuration.setAutoDiscoverClient(true);
configuration.setBucketName("s3bucket2020");
configuration.setRegion("us-east-1");

이제 (위에서 생성된 구성 오브젝트를 사용하여) 경로를 초기화하기 전에 S3 구성 요소를 구성하고 구성 메서드의 레지스트리에 추가할 수 있습니다.

AWS2S3Component s3Component = new AWS2S3Component(getContext());
s3Component.setConfiguration(configuration);
s3Component.setLazyStartProducer(true);
camelContext.addComponent("aws2-s3", s3Component);

이제 camel 경로에 구현된 모든 작업에 구성 요소가 사용됩니다.

5.14. 종속 항목

Maven 사용자는 pom.xml 에 다음과 같은 종속성을 추가해야 합니다.

pom.xml

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-aws2-s3</artifactId>
    <version>${camel-version}</version>
</dependency>

3.14.2 를 실제 Camel 버전으로 교체해야 합니다.

5.15. Spring Boot Auto-Configuration

Spring Boot에서 aws2-s3를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-aws2-s3-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

이 구성 요소는 아래에 나열된 51 옵션을 지원합니다.

이름설명Default유형

camel.component.aws2-s3.access-key

Amazon AWS 액세스 키.

 

문자열

camel.component.aws2-s3.amazon-s3-client

레지스트리의 com.amazonaws.services.s3.AmazonS3에 대한 참조입니다. 옵션은 software.amazon.awssdk.services.s3.S3Client 유형입니다.

 

S3Client

camel.component.aws2-s3.amazon-s3-presigner

요청에 대한 S3 Presigner는 createDownloadLink 작업에 주로 사용됩니다. 옵션은 software.amazon.awssdk.services.s3.presigner.S3Presigner 유형입니다.

 

S3Presigner

camel.component.aws2-s3.auto-create-bucket

S3 버킷 bucketName의 자동 생성 설정. moveAfterRead 옵션이 활성화된 경우에도 적용되며, 아직 존재하지 않는 경우 destinationBucket이 생성됩니다.

false

부울

camel.component.aws2-s3.autoclose-body

이 옵션이 true이고 includeBody가 false이면 교환 완료 시 S3Object.close() 메서드가 호출됩니다. 이 옵션은 includeBody 옵션과 강력하게 관련이 있습니다. includeBody를 false로 설정하고 autocloseBody를 false로 설정하는 경우 호출자는 S3Object 스트림을 닫을 수 있습니다. autocloseBody를 true로 설정하면 S3Object 스트림이 자동으로 종료됩니다.

true

부울

camel.component.aws2-s3.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.aws2-s3.aws-k-m-s-key-id

KMS가 활성화된 경우 사용할 KMS 키의 ID를 정의합니다.

 

문자열

camel.component.aws2-s3.batch-message-number

스트리밍 업로드 모드에서 배치를 구성하는 메시지 수입니다.

10

정수

camel.component.aws2-s3.batch-size

스트리밍 업로드 모드의 배치 크기(바이트 단위)입니다.

1000000

정수

camel.component.aws2-s3.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.aws2-s3.configuration

구성 요소 구성 요소입니다. 옵션은 org.apache.camel.component.aws2.s3.AWS2S3Configuration 유형입니다.

 

AWS2S3Configuration

camel.component.aws2-s3.customer-algorithm

CustomerKey가 활성화된 경우 사용할 고객 알고리즘을 정의합니다.

 

문자열

camel.component.aws2-s3.customer-key-id

CustomerKey가 활성화된 경우 사용할 Customer 키의 ID를 정의합니다.

 

문자열

camel.component.aws2-s3.customer-key-m-d5

CustomerKey가 활성화된 경우 사용할 고객 키의 MD5를 정의합니다.

 

문자열

camel.component.aws2-s3.delete-after-read

S3가 검색된 후 오브젝트를 삭제합니다. 삭제는 교환이 커밋된 경우에만 수행됩니다. 롤백이 발생하면 오브젝트가 삭제되지 않습니다. 이 옵션이 false이면 폴링에서 동일한 오브젝트를 반복적으로 검색합니다. 따라서 경로에서 Idempotent Consumer EIP를 사용하여 중복을 필터링해야 합니다. AWS2S3Constants#BUClKET_NAME 및 AWS2S3Constants#KEY 헤더 또는 AWS2S3Constants#KEY 헤더를 사용하여 필터링할 수 있습니다.

true

부울

camel.component.aws2-s3.delete-after-write

S3 파일이 업로드된 후 파일 오브젝트를 삭제합니다.

false

부울

camel.component.aws2-s3.delimiter

com.amazonaws.services.s3.model.ListObjectsRequest에서 사용되는 구분 기호는 관심 있는 개체만 사용합니다.

 

문자열

camel.component.aws2-s3.destination-bucket

moveAfterRead가 true로 설정된 경우 오브젝트를 이동해야 하는 대상 버킷을 정의합니다.

 

문자열

camel.component.aws2-s3.destination-bucket-prefix

오브젝트를 이동해야 할 때 사용할 대상 버킷 접두사를 정의하고 moveAfterRead가 true로 설정됩니다.

 

문자열

camel.component.aws2-s3.destination-bucket-suffix

오브젝트를 이동해야 할 때 사용할 대상 버킷 접미사를 정의하고 moveAfterRead가 true로 설정됩니다.

 

문자열

camel.component.aws2-s3.done-file-name

Camel은 제공된 경우, 완료된 파일이 존재하는 경우에만 파일을 사용합니다.

 

문자열

camel.component.aws2-s3.enabled

aws2-s3 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.aws2-s3.file-name

지정된 파일 이름으로 버킷에서 오브젝트를 가져오려면 다음을 수행합니다.

 

문자열

camel.component.aws2-s3.ignore-body

If it is true, the S3 Object body will be ignored completely, if it is set to false the S3 Object will be put in the body. 이 값을 true로 설정하면 includeBody 옵션으로 정의된 모든 동작이 재정의됩니다.

false

부울

camel.component.aws2-s3.include-body

true인 경우 S3Object 교환이 소비되어 본문에 배치되고 닫힙니다. false인 경우 S3Object 스트림은 본문에 raw를 배치하고 헤더는 S3 오브젝트 메타데이터로 설정됩니다. 이 옵션은 autocloseBody 옵션과 강하게 관련이 있습니다. S3Object 스트림이 소비되기 때문에 includeBody를 true로 설정하는 경우 includeBody false의 경우 S3Object 스트림을 닫는 호출자까지 됩니다. 그러나 includeBody가 false인 경우 autocloseBody를 true로 설정하면 교환 완료 시 S3Object 스트림을 자동으로 닫도록 예약됩니다.

true

부울

camel.component.aws2-s3.include-folders

true인 경우 폴더/디렉터리가 사용됩니다. false인 경우 해당 값은 무시되고 Exchange가 생성되지 않습니다.

true

부울

camel.component.aws2-s3.key-name

엔드포인트 매개 변수를 통해 버킷에 있는 요소의 키 이름을 설정합니다.

 

문자열

camel.component.aws2-s3.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.aws2-s3.move-after-read

오브젝트를 검색된 후 S3 버킷에서 다른 버킷으로 이동합니다. 작업을 수행하려면 destinationBucket 옵션을 설정해야 합니다. 복사 버킷 작업은 교환이 커밋된 경우에만 수행됩니다. 롤백이 발생하면 오브젝트가 이동되지 않습니다.

false

부울

camel.component.aws2-s3.multi-part-upload

true인 경우 camel은 여러 파트 형식으로 파일을 업로드하고 부분 크기는 partSize 옵션으로 결정합니다.

false

부울

camel.component.aws2-s3.naming-strategy

스트리밍 업로드 모드에서 사용할 이름 지정 전략입니다.

 

AWSS3NamingStrategyEnum

camel.component.aws2-s3.operation

사용자가 업로드만 하지 않으려는 경우 수행할 작업.

 

AWS2S3Operations

camel.component.aws2-s3.override-endpoint

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

부울

camel.component.aws2-s3.part-size

다중 파트 업로드에 사용되는 partSize를 설정합니다. 기본값은 25M입니다.

26214400

long

camel.component.aws2-s3.pojo-request

gRPC 요청을 본문으로 사용하려면 해당 요청을 본문으로 사용합니다.

false

부울

camel.component.aws2-s3.policy

com.amazonaws.services.s3.AmazonS3#setBucketPolicy() 메서드에서 설정할 이 큐의 정책입니다.

 

문자열

camel.component.aws2-s3.prefix

com.amazonaws.services.s3.model.ListObjectsRequest에 사용되는 접두사는 관심 있는 개체만 사용합니다.

 

문자열

camel.component.aws2-s3.proxy-host

SQS 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

camel.component.aws2-s3.proxy-port

클라이언트 정의 내에서 사용할 프록시 포트를 지정합니다.

 

정수

camel.component.aws2-s3.proxy-protocol

S3 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

 

프로토콜

camel.component.aws2-s3.region

S3 클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

camel.component.aws2-s3.restarting-policy

스트리밍 업로드 모드에서 사용할 재시작 정책입니다.

 

AWSS3RestartingPolicyEnum

camel.component.aws2-s3.secret-key

Amazon AWS 시크릿 키.

 

문자열

camel.component.aws2-s3.storage-class

com.amazonaws.services.s3.model.PutObjectRequest 요청에 설정할 스토리지 클래스입니다.

 

문자열

camel.component.aws2-s3.streaming-upload-mode

스트림 모드가 true이면 버킷에 대한 업로드는 스트리밍에서 수행됩니다.

false

부울

camel.component.aws2-s3.streaming-upload-timeout

streaming upload 모드가 true이지만 이 옵션은 업로드를 완료하기 위해 시간 초과를 설정합니다.

 

long

camel.component.aws2-s3.trust-all-certificates

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

부울

camel.component.aws2-s3.uri-endpoint-override

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

camel.component.aws2-s3.use-aws-k-m-s

KMS를 사용해야 하는지 여부를 정의합니다.

false

부울

camel.component.aws2-s3.use-customer-key

고객 키를 사용해야 하는지 여부를 정의합니다.

false

부울

camel.component.aws2-s3.use-default-credentials-provider

S3 클라이언트가 기본 인증 정보 공급자를 통해 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

부울

6장. AWS SNS(Simple Notification System)

프로듀서만 지원됩니다.

AWS2 CloudEvent 구성 요소를 사용하면 Amazon Simple Notification Topic으로 메시지를 보낼 수 있습니다. Amazon API의 구현은 AWS SDK 에서 제공합니다.

사전 요구 사항

유효한 Amazon Web Services 개발자 계정이 있어야 하며 AmazonECDHE를 사용하기 위해 가입해야 합니다. 자세한 내용은 Amazon#177 에서 확인할 수 있습니다.

6.1. URI 형식

aws2-sns://topicNameOrArn[?options]

주제가 아직 존재하지 않는 경우 생성됩니다. 다음 형식으로 URI에 쿼리 옵션을 추가할 수 있습니다. ?options=value&option2=value&…​

6.2. URI 옵션

6.2.1. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

6.2.1.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

6.2.1.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

6.3. 구성 요소 옵션

AWS SNS(Simple Notification System) 구성 요소는 아래에 나열된 24가지 옵션을 지원합니다.

이름설명Default유형

amazonSNSClient (producer)

Autowired AmazonSNS를 클라이언트로 사용합니다.

 

SnsClient

autoCreateTopic (producer)

주제의 자동 생성 설정.

false

boolean

구성 (producer)

구성 요소 구성입니다.

 

Sns2Configuration

kmsMasterKeyId (producer)

Amazon 10.0.0.1 또는 사용자 정의 CMK용 AWS 관리 고객 마스터 키(CMK)의 ID입니다.

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

messageDeduplicationIdStrategy (producer)

이는 FIFO 주제일 뿐입니다. 메시지에서 messageDeduplicationId를 설정하는 전략입니다. 다음 옵션 중 하나일 수 있습니다. useExchangeId, useContentBasedDeduplication. useContentBasedDeduplication 옵션의 경우 messageDeduplicationId가 메시지에 설정되지 않습니다.

CloudEvent 값:

  • useExchangeId
  • useContentBasedDeduplication

useExchangeId

문자열

messageGroupIdStrategy (producer)

이는 FIFO 주제일 뿐입니다. 메시지에서 messageGroupId를 설정하는 전략입니다. 다음 옵션 중 하나일 수 있습니다. useConstant, useExchangeId, usePropertyValue. usePropertyValue 옵션의 경우 property CamelAwsMessageGroupId 값이 사용됩니다.

CloudEvent 값:

  • useConstant
  • useExchangeId
  • usePropertyValue
 

문자열

MessageStructure (producer)

json과 같이 사용할 메시지 구조입니다.

 

문자열

overrideEndpoint (producer)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

정책 (producer)

이 항목에 대한 정책입니다. classpath에서 기본적으로 로드되지만 classpath:, file: 또는 http: 접두사를 추가하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

proxyHost (producer)

CloudEvent 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (producer)

CloudEvent 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

proxyProtocol (producer)

CloudEvent 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의하려면 다음을 수행합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

queueUrl (producer)

등록할 queueUrl입니다.

 

문자열

region (producer)

client가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

serverSideEncryptionEnabled (producer)

서버 사이드 암호화가 활성화되어 있는지에 대해 정의합니다.

false

boolean

제목 (producer)

메시지 헤더 'CamelAwsSnsSubject'가 없는 경우 사용되는 제목입니다.

 

문자열

SubscriptionSNStoSQS (producer)

ScanSetting Topic과 SQS 간의 서브스크립션을 수행해야 하는지 여부를 정의합니다.

false

boolean

trustAllCertificates (producer)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

uriEndpointOverride (producer)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (producer)

CloudEvent 클라이언트가 AWS 인프라 인스턴스에서 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

6.4. 끝점 옵션

AWS SNS(Simple Notification System) 끝점은 URI 구문을 사용하여 구성됩니다.

aws2-sns:topicNameOrArn

다음과 같은 경로 및 쿼리 매개변수 사용:

6.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

topicNameOrArn (producer)

필수 항목 이름 또는 ARN입니다.

 

문자열

6.4.2. 쿼리 매개변수(23 매개변수)

이름설명Default유형

amazonSNSClient (producer)

Autowired AmazonSNS를 클라이언트로 사용합니다.

 

SnsClient

autoCreateTopic (producer)

주제의 자동 생성 설정.

false

boolean

headerFilterStrategy (producer)

사용자 정의 HeaderFilterStrategy를 사용하여 Camel에 헤더를 매핑합니다.

 

HeaderFilterStrategy

kmsMasterKeyId (producer)

Amazon 10.0.0.1 또는 사용자 정의 CMK용 AWS 관리 고객 마스터 키(CMK)의 ID입니다.

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

messageDeduplicationIdStrategy (producer)

이는 FIFO 주제일 뿐입니다. 메시지에서 messageDeduplicationId를 설정하는 전략입니다. 다음 옵션 중 하나일 수 있습니다. useExchangeId, useContentBasedDeduplication. useContentBasedDeduplication 옵션의 경우 messageDeduplicationId가 메시지에 설정되지 않습니다.

CloudEvent 값:

  • useExchangeId
  • useContentBasedDeduplication

useExchangeId

문자열

messageGroupIdStrategy (producer)

이는 FIFO 주제일 뿐입니다. 메시지에서 messageGroupId를 설정하는 전략입니다. 다음 옵션 중 하나일 수 있습니다. useConstant, useExchangeId, usePropertyValue. usePropertyValue 옵션의 경우 property CamelAwsMessageGroupId 값이 사용됩니다.

CloudEvent 값:

  • useConstant
  • useExchangeId
  • usePropertyValue
 

문자열

MessageStructure (producer)

json과 같이 사용할 메시지 구조입니다.

 

문자열

overrideEndpoint (producer)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

정책 (producer)

이 항목에 대한 정책입니다. classpath에서 기본적으로 로드되지만 classpath:, file: 또는 http: 접두사를 추가하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

proxyHost (producer)

CloudEvent 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (producer)

CloudEvent 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

proxyProtocol (producer)

CloudEvent 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의하려면 다음을 수행합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

queueUrl (producer)

등록할 queueUrl입니다.

 

문자열

region (producer)

client가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

serverSideEncryptionEnabled (producer)

서버 사이드 암호화가 활성화되어 있는지에 대해 정의합니다.

false

boolean

제목 (producer)

메시지 헤더 'CamelAwsSnsSubject'가 없는 경우 사용되는 제목입니다.

 

문자열

SubscriptionSNStoSQS (producer)

ScanSetting Topic과 SQS 간의 서브스크립션을 수행해야 하는지 여부를 정의합니다.

false

boolean

trustAllCertificates (producer)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

uriEndpointOverride (producer)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (producer)

CloudEvent 클라이언트가 AWS 인프라 인스턴스에서 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

필수 CloudEvent 구성 요소 옵션

레지스트리 또는 accessKey 및 secretKey에 amazonSNSClient를 제공하여 Amazon의 CloudEvent 에 액세스해야 합니다.

6.5. 사용법

6.5.1. 정적 자격 증명 대 기본 인증 정보 공급자

useDefaultCredentialsProvider 옵션을 지정하고 true로 설정하여 명시적 정적 인증 정보 사용을 방지할 수 있습니다.

  • Java 시스템 속성 - aws.accessKeyId 및 aws.secretKey
  • 환경 변수 - AWS_ACCESS_KEY_ID 및 AWS_SECRET_ACCESS_KEY.
  • AWS STS의 웹 ID 토큰.
  • 공유 인증 정보 및 구성 파일입니다.
  • Amazon ECS 컨테이너 인증 정보 - 환경 변수 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI가 설정된 경우 Amazon ECS에서 로드됩니다.
  • Amazon EC2 인스턴스 프로필 자격 증명.

이에 대한 자세한 내용은 AWS 인증 정보 문서를 참조하십시오.

6.5.2. CloudEvent 프로듀서에 의해 평가되는 메시지 헤더

header유형설명

CamelAwsSnsSubject

문자열

Amazon CloudEvent 메시지 주체입니다. 설정하지 않으면 SnsConfiguration 의 제목이 사용됩니다.

6.5.3. CloudEvent 프로듀서에 의해 설정된 메시지 헤더

header유형설명

CamelAwsSnsMessageId

문자열

AmazonECDHE 메시지 ID입니다.

6.5.4. 고급 AmazonSNS 구성

SnsClient 인스턴스 구성을 더 많이 제어해야 하는 경우 자체 인스턴스를 생성하고 URI에서 이를 참조할 수 있습니다.

from("direct:start")
.to("aws2-sns://MyTopic?amazonSNSClient=#client");

#client 는 레지스트리의 AmazonSNS 를 나타냅니다.

6.5.5. AWS CloudEvent Topic과 AWS SQS Queue 간 서브스크립션 생성

다음과 같은 방법으로 SQS Queue에 대한 SQS 대기열 서브스크립션을 생성할 수 있습니다.

from("direct:start")
.to("aws2-sns://test-camel-sns1?amazonSNSClient=#amazonSNSClient&subscribeSNStoSQS=true&queueUrl=https://sqs.eu-central-1.amazonaws.com/780410022472/test-camel");

#amazonSNSClient 는 레지스트리의 SnsClient 를 나타냅니다. subscribeSNStoSQS 를 true로 지정하고 기존 SQS 대기열의 queueUrl 을 지정하면 SQS 대기열을 CloudEvent Topic에 등록할 수 있습니다.

이 시점에서 SQS Queue를 통해 CloudEvent Topic에서 들어오는 메시지를 사용할 수 있습니다.

from("aws2-sqs://test-camel?amazonSQSClient=#amazonSQSClient&delay=50&maxMessagesPerPoll=5")
    .to(...);

6.6. 주제 자동 생성

autoCreateTopic 옵션을 사용하면 존재하지 않는 경우 CloudEvent Topic의 자동 생성을 방지할 수 있습니다. 이 옵션의 기본값은 true 입니다. false로 설정하면 AWS에서 존재하지 않는 주제의 작업이 실패하면 오류가 반환됩니다.

6.7. SNS FIFO

CloudEvent FIFO가 지원됩니다. SQS 대기열을 생성하는 동안 CloudEvent 주제를 구독할 수 있는 중요한 포인트가 있습니다. 따라서 SQS Queue에 메시지를 보낼 수 있는 CloudEvent Topic이 필요합니다.

예제

Order.fifo 라는 CloudEvent FIFO 주제와 QueueSub.fifo 라는 SQS 대기열을 생성했다고 가정합니다.

QueueSub.fifo 의 액세스 정책에서 다음과 같이 제출해야 합니다.

{
  "Version": "2008-10-17",
  "Id": "__default_policy_ID",
  "Statement": [
    {
      "Sid": "__owner_statement",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::780560123482:root"
      },
      "Action": "SQS:*",
      "Resource": "arn:aws:sqs:eu-west-1:780560123482:QueueSub.fifo"
    },
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "arn:aws:sqs:eu-west-1:780560123482:QueueSub.fifo",
      "Condition": {
        "ArnLike": {
          "aws:SourceArn": "arn:aws:sns:eu-west-1:780410022472:Order.fifo"
        }
      }
    }
  ]
}

이는 서브스크립션을 올바르게 작동하기 위한 중요한 단계입니다.

6.7.1. CloudEvent Fifo Topic Message group Id Strategy and message Deduplication Id Strategy

FIFO 항목에 메시지를 보낼 때 항상 메시지 그룹 Id 전략을 설정해야 합니다.

메시지 중복 제거가 message deduplication id 전략을 설정할 필요가 없는 경우, 해당 주제에서 콘텐츠 기반 메시지 중복 제거가 활성화된 경우 이를 설정해야 합니다.

6.8. 예

6.8.1. 생산자 예

주제로 전송

from("direct:start")
  .to("aws2-sns://camel-topic?subject=The+subject+message&autoCreateTopic=true");

6.9. 종속 항목

Maven 사용자는 pom.xml에 다음과 같은 종속성을 추가해야 합니다.

pom.xml

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-aws2-sns</artifactId>
    <version>${camel-version}</version>
</dependency>

3.14.2 를 실제 Camel 버전으로 교체해야 합니다.

6.10. Spring Boot Auto-Configuration

Spring Boot와 함께 aws2-sns를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-aws2-sns-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.aws2-sns.access-key

Amazon AWS 액세스 키.

 

문자열

camel.component.aws2-sns.amazon-s-n-s-client

AmazonSNS를 클라이언트로 사용하려면 다음을 수행합니다. 옵션은 software.amazon.awssdk.services.sns.SnsClient 유형입니다.

 

SnsClient

camel.component.aws2-sns.auto-create-topic

주제의 자동 생성 설정.

false

부울

camel.component.aws2-sns.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.aws2-sns.configuration

구성 요소 구성입니다. 옵션은 org.apache.camel.component.aws2.sns.Sns2Configuration 유형입니다.

 

Sns2Configuration

camel.component.aws2-sns.enabled

aws2-sns 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.aws2-sns.kms-master-key-id

Amazon 10.0.0.1 또는 사용자 정의 CMK용 AWS 관리 고객 마스터 키(CMK)의 ID입니다.

 

문자열

camel.component.aws2-sns.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.aws2-sns.message-deduplication-id-strategy

이는 FIFO 주제일 뿐입니다. 메시지에서 messageDeduplicationId를 설정하는 전략입니다. 다음 옵션 중 하나일 수 있습니다. useExchangeId, useContentBasedDeduplication. useContentBasedDeduplication 옵션의 경우 messageDeduplicationId가 메시지에 설정되지 않습니다.

useExchangeId

문자열

camel.component.aws2-sns.message-group-id-strategy

이는 FIFO 주제일 뿐입니다. 메시지에서 messageGroupId를 설정하는 전략입니다. 다음 옵션 중 하나일 수 있습니다. useConstant, useExchangeId, usePropertyValue. usePropertyValue 옵션의 경우 property CamelAwsMessageGroupId 값이 사용됩니다.

 

문자열

camel.component.aws2-sns.message-structure

json과 같이 사용할 메시지 구조입니다.

 

문자열

camel.component.aws2-sns.override-endpoint

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

부울

camel.component.aws2-sns.policy

이 항목에 대한 정책입니다. classpath에서 기본적으로 로드되지만 classpath:, file: 또는 http: 접두사를 추가하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

camel.component.aws2-sns.proxy-host

CloudEvent 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

camel.component.aws2-sns.proxy-port

CloudEvent 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

camel.component.aws2-sns.proxy-protocol

CloudEvent 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의하려면 다음을 수행합니다.

 

프로토콜

camel.component.aws2-sns.queue-url

등록할 queueUrl입니다.

 

문자열

camel.component.aws2-sns.region

client가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

camel.component.aws2-sns.secret-key

Amazon AWS 시크릿 키.

 

문자열

camel.component.aws2-sns.server-side-encryption-enabled

서버 사이드 암호화가 활성화되어 있는지에 대해 정의합니다.

false

부울

camel.component.aws2-sns.subject

메시지 헤더 'CamelAwsSnsSubject'가 없는 경우 사용되는 제목입니다.

 

문자열

camel.component.aws2-sns.subscribe-s-n-sto-s-q-s

ScanSetting Topic과 SQS 간의 서브스크립션을 수행해야 하는지 여부를 정의합니다.

false

부울

camel.component.aws2-sns.trust-all-certificates

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

부울

camel.component.aws2-sns.uri-endpoint-override

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

camel.component.aws2-sns.use-default-credentials-provider

CloudEvent 클라이언트가 AWS 인프라 인스턴스에서 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

부울

7장. AWS Simple Queue Service (SQS)

생산자 및 소비자 모두 지원

AWS2 SQS 구성 요소는 Amazon의 SQS 서비스로 메시지 전송 및 수신을 지원합니다.

사전 요구 사항

유효한 Amazon Web Services 개발자 계정이 있어야 Amazon SQS를 사용할 수 있습니다. 자세한 내용은 Amazon SQS 에서 확인할 수 있습니다.

7.1. URI 형식

aws2-sqs://queueNameOrArn[?options]

대기열이 아직 존재하지 않는 경우 생성됩니다. 다음 형식의 URI에 쿼리 옵션을 추가할 수 있습니다.

?options=value&option2=value&…​

7.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

7.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

7.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

7.3. 구성 요소 옵션

AWS SQS(Simple Queue Service) 구성 요소는 아래에 나열된 43 옵션을 지원합니다.

이름설명Default유형

amazonAWSHost (common)

Amazon AWS 클라우드의 호스트 이름입니다.

amazonaws.com

문자열

amazonSQSClient (common)

Autowired AmazonSQS를 클라이언트로 사용합니다.

 

SqsClient

autoCreateQueue (common)

대기열의 자동 생성 설정.

false

boolean

구성 (공용)

AWS SQS 기본 구성입니다.

 

Sqs2Configuration

overrideEndpoint (common)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

프로토콜 (common)

SQS와 통신하는 데 사용되는 기본 프로토콜입니다.

https

문자열

proxyProtocol (공용)

SQS 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

queueOwnerAWSAccountId (공용)

다른 계정 소유자와 큐를 연결해야 하는 경우 큐 소유자 aws 계정 ID를 지정합니다.

 

문자열

리전 (공용)

SQS 클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

trustAllCertificates (common)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

uriEndpointOverride (common)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (common)

SQS 클라이언트가 AWS 인프라 인스턴스에서 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

attributeNames (consumer)

사용할 때 수신할 속성 이름 목록입니다. 여러 이름은 쉼표로 구분할 수 있습니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

concurrentConsumers (consumer)

여러 스레드를 사용하여 sqs 대기열을 폴링하여 처리량을 늘릴 수 있습니다.

1

int

defaultVisibilityTimeout (consumer)

기본 가시성 제한 시간(초)입니다.

 

정수

deleteAfterRead (consumer)

메시지를 읽은 후 SQS에서 삭제합니다.

true

boolean

deleteIfFiltered (consumer)

교환에 키가 Sqs2Constants#SQS_DELETE_FILTERED(CamelAwsSqsDeleteFiltered)가 설정된 경우 DeleteMessage를 SQS 큐에 보낼지 여부입니다.

true

boolean

extendMessageVisibility (consumer)

그런 다음 예약된 백그라운드 작업이 SQS에서 메시지 가시성을 계속 확장합니다. 메시지를 처리하는 데 시간이 오래 걸리는 경우 이 작업이 필요합니다. true defaultVisibilityTimeout으로 설정하면 됩니다.

false

boolean

kmsDataKeyReusePeriodSeconds (consumer)

Amazon SQS가 데이터 키를 재사용하여 AWS KMS를 다시 호출하기 전에 메시지를 암호화하거나 해독할 수 있는 시간(초)입니다. 60초(1분)에서 86,400초(24시간) 사이의 초를 나타내는 정수입니다. 기본값은 300(5분)입니다.

 

정수

kmsMasterKeyId (consumer)

Amazon SQS 또는 사용자 정의 CMK의 AWS 관리 고객 마스터 키(CMK)의 ID입니다.

 

문자열

messageAttributeNames (consumer)

사용할 때 수신할 메시지 특성 이름 목록입니다. 여러 이름은 쉼표로 구분할 수 있습니다.

 

문자열

serverSideEncryptionEnabled (consumer)

큐에 서버 사이드 암호화가 활성화되어 있는지 여부를 정의합니다.

false

boolean

visibilityTimeout (consumer)

ReceiveMessage 요청에 의해 검색된 후 수신된 메시지가 com.amazonaws.services.sqs.model.SetQueueAttributesRequest에서 설정되는 기간(초)입니다. 이는 defaultVisibilityTimeout과 다른 경우에만 이해할 수 있습니다. 큐 가시성 시간 제한 속성을 영구적으로 변경합니다.

 

정수

waitTimeSeconds (consumer)

ReceiveMessage 작업 호출에서 응답에 포함할 메시지가 큐에 있을 때까지 대기하는 시간(초)입니다.

 

정수

batchSeparator (producer)

문자열 전달 시 일괄 처리 메시지 작업을 보낼 때 구분자를 설정합니다.

,

문자열

delaySeconds (producer)

메시지 전송 시간(초)을 지연합니다.

 

정수

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

messageDeduplicationIdStrategy (producer)

FIFO 대기열에서만 사용할 수 있습니다. 메시지에서 messageDeduplicationId를 설정하는 전략입니다. 다음 옵션 중 하나일 수 있습니다. useExchangeId, useContentBasedDeduplication. useContentBasedDeduplication 옵션의 경우 messageDeduplicationId가 메시지에 설정되지 않습니다.

CloudEvent 값:

  • useExchangeId
  • useContentBasedDeduplication

useExchangeId

문자열

messageGroupIdStrategy (producer)

FIFO 대기열에서만 사용할 수 있습니다. 메시지에서 messageGroupId를 설정하는 전략입니다. 다음 옵션 중 하나일 수 있습니다. useConstant, useExchangeId, usePropertyValue. usePropertyValue 옵션의 경우 property CamelAwsMessageGroupId 값이 사용됩니다.

CloudEvent 값:

  • useConstant
  • useExchangeId
  • usePropertyValue
 

문자열

작업 (producer)

사용자가 메시지만 전송하지 않으려는 경우 수행할 작업입니다.

CloudEvent 값:

  • sendBatchMessage
  • deleteMessage
  • listQueues
  • purgeQueue
  • deleteQueue
 

Sqs2Operations

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

delayQueue (advanced)

delaySeconds 옵션을 대기열 또는 단일 메시지에 적용하려는 경우 정의합니다.

false

boolean

queueUrl (advanced)

queueUrl을 명시적으로 정의하려면 다음을 수행합니다. queueUrl에 영향을 줄 수 있는 다른 모든 매개변수는 무시됩니다. 이 매개변수는 테스트를 위해 SQS의 mock 구현에 연결하기 위해 사용됩니다.

 

문자열

proxyHost (proxy)

SQS 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (proxy)

SQS 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

maximumMessageSize (queue)

이 큐에 포함할 수 있는 SQS 메시지의 maximumMessageSize(바이트)입니다.

 

정수

messageRetentionPeriod (queue)

메시지가 이 큐에 대해 SQS에 의해 유지되는 messageRetentionPeriod(초)입니다.

 

정수

정책 (queue)

이 큐의 정책입니다. 클래스 경로에서 기본적으로 로드할 수 있지만 classpath:, file: 또는 http:를 사용하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

receiveMessageWaitTimeSeconds (queue)

요청에 WaitTimeSeconds를 지정하지 않으면 큐 특성 ReceiveMessageWaitTimeSeconds를 사용하여 대기 시간을 결정합니다.

 

정수

redrivePolicy (queue)

DeadLetter 큐에 메시지를 보내는 정책을 지정합니다. 자세한 내용은 Amazon docs에서 참조하십시오.

 

문자열

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

7.4. 끝점 옵션

AWS SQS(Simple Queue Service) 끝점은 URI 구문을 사용하여 구성됩니다.

aws2-sqs:queueNameOrArn

다음과 같은 경로 및 쿼리 매개변수 사용:

7.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

queueNameOrArn (common)

필요한 대기열 이름 또는 ARN.

 

문자열

7.4.2. 쿼리 매개변수(61 매개변수)

이름설명Default유형

amazonAWSHost (common)

Amazon AWS 클라우드의 호스트 이름입니다.

amazonaws.com

문자열

amazonSQSClient (common)

Autowired AmazonSQS를 클라이언트로 사용합니다.

 

SqsClient

autoCreateQueue (common)

대기열의 자동 생성 설정.

false

boolean

headerFilterStrategy (common)

사용자 정의 HeaderFilterStrategy를 사용하여 Camel에 헤더를 매핑합니다.

 

HeaderFilterStrategy

overrideEndpoint (common)

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

boolean

프로토콜 (common)

SQS와 통신하는 데 사용되는 기본 프로토콜입니다.

https

문자열

proxyProtocol (공용)

SQS 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

CloudEvent 값:

  • HTTP
  • HTTPS

HTTPS

프로토콜

queueOwnerAWSAccountId (공용)

다른 계정 소유자와 큐를 연결해야 하는 경우 큐 소유자 aws 계정 ID를 지정합니다.

 

문자열

리전 (공용)

SQS 클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

trustAllCertificates (common)

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

boolean

uriEndpointOverride (common)

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

useDefaultCredentialsProvider (common)

SQS 클라이언트가 AWS 인프라 인스턴스에서 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

boolean

attributeNames (consumer)

사용할 때 수신할 속성 이름 목록입니다. 여러 이름은 쉼표로 구분할 수 있습니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

concurrentConsumers (consumer)

여러 스레드를 사용하여 sqs 대기열을 폴링하여 처리량을 늘릴 수 있습니다.

1

int

defaultVisibilityTimeout (consumer)

기본 가시성 제한 시간(초)입니다.

 

정수

deleteAfterRead (consumer)

메시지를 읽은 후 SQS에서 삭제합니다.

true

boolean

deleteIfFiltered (consumer)

교환에 키가 Sqs2Constants#SQS_DELETE_FILTERED(CamelAwsSqsDeleteFiltered)가 설정된 경우 DeleteMessage를 SQS 큐에 보낼지 여부입니다.

true

boolean

extendMessageVisibility (consumer)

그런 다음 예약된 백그라운드 작업이 SQS에서 메시지 가시성을 계속 확장합니다. 메시지를 처리하는 데 시간이 오래 걸리는 경우 이 작업이 필요합니다. true defaultVisibilityTimeout으로 설정하면 됩니다. 자세한 내용은 Amazon docs에서 참조하십시오.

false

boolean

kmsDataKeyReusePeriodSeconds (consumer)

Amazon SQS가 데이터 키를 재사용하여 AWS KMS를 다시 호출하기 전에 메시지를 암호화하거나 해독할 수 있는 시간(초)입니다. 60초(1분)에서 86,400초(24시간) 사이의 초를 나타내는 정수입니다. 기본값은 300(5분)입니다.

 

정수

kmsMasterKeyId (consumer)

Amazon SQS 또는 사용자 정의 CMK의 AWS 관리 고객 마스터 키(CMK)의 ID입니다.

 

문자열

maxMessagesPerPoll (consumer)

각 폴링 시 폴링 제한으로 최대 메시지 수를 가져옵니다. 기본값은 무제한이지만 0 또는 음수를 사용하여 무제한으로 비활성화합니다.

 

int

messageAttributeNames (consumer)

사용할 때 수신할 메시지 특성 이름 목록입니다. 여러 이름은 쉼표로 구분할 수 있습니다.

 

문자열

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

serverSideEncryptionEnabled (consumer)

큐에 서버 사이드 암호화가 활성화되어 있는지 여부를 정의합니다.

false

boolean

visibilityTimeout (consumer)

ReceiveMessage 요청에 의해 검색된 후 수신된 메시지가 com.amazonaws.services.sqs.model.SetQueueAttributesRequest에서 설정되는 기간(초)입니다. 이는 defaultVisibilityTimeout과 다른 경우에만 이해할 수 있습니다. 큐 가시성 시간 제한 속성을 영구적으로 변경합니다.

 

정수

waitTimeSeconds (consumer)

ReceiveMessage 작업 호출에서 응답에 포함할 메시지가 큐에 있을 때까지 대기하는 시간(초)입니다.

 

정수

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

batchSeparator (producer)

문자열 전달 시 일괄 처리 메시지 작업을 보낼 때 구분자를 설정합니다.

,

문자열

delaySeconds (producer)

메시지 전송 시간(초)을 지연합니다.

 

정수

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

messageDeduplicationIdStrategy (producer)

FIFO 대기열에서만 사용할 수 있습니다. 메시지에서 messageDeduplicationId를 설정하는 전략입니다. 다음 옵션 중 하나일 수 있습니다. useExchangeId, useContentBasedDeduplication. useContentBasedDeduplication 옵션의 경우 messageDeduplicationId가 메시지에 설정되지 않습니다.

CloudEvent 값:

  • useExchangeId
  • useContentBasedDeduplication

useExchangeId

문자열

messageGroupIdStrategy (producer)

FIFO 대기열에서만 사용할 수 있습니다. 메시지에서 messageGroupId를 설정하는 전략입니다. 다음 옵션 중 하나일 수 있습니다. useConstant, useExchangeId, usePropertyValue. usePropertyValue 옵션의 경우 property CamelAwsMessageGroupId 값이 사용됩니다.

CloudEvent 값:

  • useConstant
  • useExchangeId
  • usePropertyValue
 

문자열

작업 (producer)

사용자가 메시지만 전송하지 않으려는 경우 수행할 작업입니다.

CloudEvent 값:

  • sendBatchMessage
  • deleteMessage
  • listQueues
  • purgeQueue
  • deleteQueue
 

Sqs2Operations

delayQueue (advanced)

delaySeconds 옵션을 대기열 또는 단일 메시지에 적용하려는 경우 정의합니다.

false

boolean

queueUrl (advanced)

queueUrl을 명시적으로 정의하려면 다음을 수행합니다. queueUrl에 영향을 줄 수 있는 다른 모든 매개변수는 무시됩니다. 이 매개변수는 테스트를 위해 SQS의 mock 구현에 연결하기 위해 사용됩니다.

 

문자열

proxyHost (proxy)

SQS 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

proxyPort (proxy)

SQS 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

maximumMessageSize (queue)

이 큐에 포함할 수 있는 SQS 메시지의 maximumMessageSize(바이트)입니다.

 

정수

messageRetentionPeriod (queue)

메시지가 이 큐에 대해 SQS에 의해 유지되는 messageRetentionPeriod(초)입니다.

 

정수

정책 (queue)

이 큐의 정책입니다. 클래스 경로에서 기본적으로 로드할 수 있지만 classpath:, file: 또는 http:를 사용하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

receiveMessageWaitTimeSeconds (queue)

요청에 WaitTimeSeconds를 지정하지 않으면 큐 특성 ReceiveMessageWaitTimeSeconds를 사용하여 대기 시간을 결정합니다.

 

정수

redrivePolicy (queue)

DeadLetter 큐에 메시지를 보내는 정책을 지정합니다. 자세한 내용은 Amazon docs에서 참조하십시오.

 

문자열

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

AccessKey ( 보안)

Amazon AWS 액세스 키.

 

문자열

secretKey (보안)

Amazon AWS 시크릿 키.

 

문자열

7.5. 일괄 소비자

이 구성 요소는 Batch Consumer를 구현합니다.

이를 통해 이 일괄 처리 내에 존재하는 메시지 수를 알 수 있으며 예를 들어 Aggregator가 이 메시지 수를 집계하도록 할 수 있습니다.

7.6. 사용법

7.6.1. 정적 자격 증명 대 기본 인증 정보 공급자

useDefaultCredentialsProvider 옵션을 지정하고 true로 설정하여 명시적 정적 인증 정보 사용을 방지할 수 있습니다.

  • Java 시스템 속성 - aws.accessKeyIdaws.secretKey
  • 환경 변수 - AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEY.
  • AWS STS의 웹 ID 토큰.
  • 공유 인증 정보 및 구성 파일입니다.
  • Amazon ECS 컨테이너 인증 정보 - 환경 변수 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI 가 설정된 경우 Amazon ECS에서 로드됩니다.
  • Amazon EC2 인스턴스 프로필 자격 증명.

이에 대한 자세한 내용은 AWS 인증 정보 문서를 참조하십시오.

7.6.2. SQS 프로듀서에서 설정한 메시지 헤더

header유형설명

CamelAwsSqsMD5OfBody

문자열

Amazon SQS 메시지의 MD5 체크섬입니다.

CamelAwsSqsMessageId

문자열

Amazon SQS 메시지 ID입니다.

CamelAwsSqsDelaySeconds

정수

다른 사람이 Amazon SQS 메시지를 볼 수 있는 지연 시간.

7.6.3. SQS 소비자가 설정한 메시지 헤더

header유형설명

CamelAwsSqsMD5OfBody

문자열

Amazon SQS 메시지의 MD5 체크섬입니다.

CamelAwsSqsMessageId

문자열

Amazon SQS 메시지 ID입니다.

CamelAwsSqsReceiptHandle

문자열

Amazon SQS 메시지 수신 처리

CamelAwsSqsMessageAttributes

Map<String, String>

Amazon SQS 메시지 특성.

7.6.4. 고급 AmazonSQS 구성

Camel 애플리케이션이 방화벽 뒤에서 실행 중이거나 SqsClient 인스턴스 구성을 더 많이 제어해야 하는 경우 자체 인스턴스를 생성할 수 있습니다.

from("aws2-sqs://MyQueue?amazonSQSClient=#client&delay=5000&maxMessagesPerPoll=5")
.to("mock:result");

7.6.5. SQS 대기열 생성 또는 업데이트

SQS 구성 요소에서 끝점이 시작되면 큐의 존재 여부에 대한 정보를 가져오는 검사가 실행됩니다. SQSConfiguration 옵션을 사용하여 QueueAttributeName 매핑을 통해 생성을 사용자 지정할 수 있습니다.

from("aws2-sqs://MyQueue?amazonSQSClient=#client&delay=5000&maxMessagesPerPoll=5")
.to("mock:result");

이 예에서는 AWS에서 MyQueue 큐가 아직 생성되지 않고 autoCreateQueue 옵션이 true로 설정된 경우 SQS 구성에서 기본 매개변수를 사용하여 생성됩니다. AWS에 이미 작동 중인 경우 SQS 구성 옵션이 사용되어 기존 AWS 구성을 덮어씁니다.

7.6.6. DelayQueue VS Delay for Single Message

option delayQueue 가 true로 설정되면 SQS Queue는 delay로 DelaySeconds 옵션을 사용하여 DelayQueue 가 됩니다. DelayQueue 에 대한 자세한 내용은 AWS SQS 설명서를 참조하십시오. 고려해야 할 중요한 정보 중 하나는 다음과 같습니다.

  • 표준 대기열의 경우 대기열별 지연 설정은 retroactive-changing the setting doesn't affect the delay of messages already in the queue.
  • FIFO 대기열의 경우 큐별 지연 설정은 retroactive-changes 설정을 변경하면 큐에 이미 있는 메시지 지연에 영향을 미칩니다.

공식 문서에 명시된 대로 단일 메시지에 지연을 지정하려면 모든 메시지에 고정된 지연을 추가해야 하는 경우 이 옵션을 true로 설정할 수 있는 동안 delayQueue 옵션을 무시할 수 있습니다.

7.6.7. 서버 사이드 암호화

큐에 대한 Server Side Encryption 속성 세트가 있습니다. 관련 옵션은 serverSideEncryptionEnabled,keyMasterKeyIdkmsDataKeyReusePeriod 입니다. SSE는 기본적으로 비활성화되어 있습니다. 옵션을 명시적으로 true로 설정하고 관련 매개변수를 큐 속성으로 설정해야 합니다.

7.7. JMS 스타일 Selectors

SQS는 선택기를 허용하지 않지만 Camel 필터 EIP를 사용하고 적절한 visibilityTimeout 을 설정하여 효과적으로 이를 수행할 수 있습니다. 메시지를 디스패치하면 DeleteMessage 를 수신하지 않는 한 메시지를 다른 소비자에게 디스패치하기 전에 표시 시간 초과까지 기다립니다. 기본적으로 Camel은 경로가 실패로 끝나지 않는 한 항상 경로 끝에 DeleteMessage 를 보냅니다. 경로를 성공적으로 완료한 경우에도 적절한 필터링을 수행하고 DeleteMessage 를 보내지 않으려면 필터를 사용합니다.

from("aws2-sqs://MyQueue?amazonSQSClient=#client&defaultVisibilityTimeout=5000&deleteIfFiltered=false&deleteAfterRead=false")
.filter("${header.login} == true")
  .setProperty(Sqs2Constants.SQS_DELETE_FILTERED, constant(true))
  .to("mock:filter");

위의 코드에서 교환에 적절한 헤더가 없으면 필터를 통해 생성하지 않으며 SQS 대기열에서도 삭제되지 않습니다. 5000초가 지나면 다른 사용자가 메시지를 볼 수 있게 됩니다.

필터링되는 경우 Camel에 대해 Sqs2Constants.SQS_DELETE_FILTERED 속성을 true 로 설정해야 합니다.

7.8. 사용 가능한 Producer 작업

  • 단일 메시지(기본값)
  • sendBatchMessage
  • deleteMessage
  • listQueues

7.9. 메시지 보내기

You can set a SendMessageBatchRequest or an Iterable

from("direct:start")
  .setBody(constant("Camel rocks!"))
  .to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)&region=eu-west-1");

7.10. 배치 메시지 보내기

You can set a SendMessageBatchRequest or an Iterable

from("direct:start")
  .setHeader(SqsConstants.SQS_OPERATION, constant("sendBatchMessage"))
  .process(new Processor() {
      @Override
      public void process(Exchange exchange) throws Exception {
          Collection c = new ArrayList();
          c.add("team1");
          c.add("team2");
          c.add("team3");
          c.add("team4");
          exchange.getIn().setBody(c);
      }
  })
  .to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)&region=eu-west-1");

그 결과, SendMessageBatchResponse 인스턴스가 포함된 교환을 받을 수 있습니다. 시험에서 어떤 메시지가 성공했는지와 그렇지 않은지 확인할 수 있습니다. 배치의 각 메시지에 설정된 id는 Random UUID가 됩니다.

7.11. 단일 메시지 삭제

deleteMessage 작업을 사용하여 단일 메시지를 삭제합니다. 삭제하려는 메시지에 대해 수신 처리 헤더를 설정해야 합니다.

from("direct:start")
  .setHeader(SqsConstants.SQS_OPERATION, constant("deleteMessage"))
  .setHeader(SqsConstants.RECEIPT_HANDLE, constant("123456"))
  .to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)&region=eu-west-1");

그 결과 메시지가 삭제되었는지 확인하는 데 사용할 수 있는 DeleteMessageResponse 인스턴스가 포함된 교환이 수신됩니다.

7.12. 대기열 나열

listQueues 작업을 사용하여 대기열을 나열합니다.

from("direct:start")
  .setHeader(SqsConstants.SQS_OPERATION, constant("listQueues"))
  .to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)&region=eu-west-1");

그 결과 ListQueuesResponse 인스턴스가 포함된 교환을 받으므로 실제 큐를 확인할 수 있습니다.

7.13. 제거 대기열

purgeQueue 작업을 사용하여 대기열을 제거합니다.

from("direct:start")
  .setHeader(SqsConstants.SQS_OPERATION, constant("purgeQueue"))
  .to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)&region=eu-west-1");

결과적으로 PurgeQueueResponse 인스턴스가 포함된 교환을 받습니다.

7.14. 대기열 자동 생성

autoCreateQueue 사용자는 존재하지 않는 경우 SQS 대기열의 자동 생성을 방지할 수 있습니다. 이 옵션의 기본값은 true 입니다. false로 설정하면 AWS에서 존재하지 않는 대기열의 작업이 실패하면 오류가 반환됩니다.

7.15. 보내기 메시지 및 메시지 중복 제거 전략

SendBatchMessage Operation을 사용하는 경우 두 종류의 Message Deduplication Strategy: - useExchangeId - useContentBasedDeduplication을 설정할 수 있습니다.

첫 번째는 Exchange ID를 매개 변수로 사용할 ExchangeIdMessageDeduplicationIdStrategy 를 사용합니다. 다른 하나는 NullMessageDeduplicationIdStrategy 를 사용하여 본문을 중복 제거 요소로 사용합니다.

일괄 처리 메시지 작업을 보내는 경우 useContentBasedDeduplication 및 Queue를 사용해야 합니다.In case of send batch message operation, you'll need to use the useContentBasedDeduplication and on the Queue you're pointing you'll need to enable the content based deduplication option.

7.16. 종속 항목

Maven 사용자는 pom.xml에 다음과 같은 종속성을 추가해야 합니다.

pom.xml

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-aws2-sqs</artifactId>
    <version>${camel-version}</version>
</dependency>

3.14.2 를 실제 Camel 버전으로 교체해야 합니다.

7.17. Spring Boot Auto-Configuration

Spring Boot에서 aws2-sqs를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-aws2-sqs-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

이 구성 요소는 아래에 나열된 44 옵션을 지원합니다.

이름설명Default유형

camel.component.aws2-sqs.access-key

Amazon AWS 액세스 키.

 

문자열

camel.component.aws2-sqs.amazon-a-w-s-host

Amazon AWS 클라우드의 호스트 이름입니다.

amazonaws.com

문자열

camel.component.aws2-sqs.amazon-s-q-s-client

AmazonSQS를 클라이언트로 사용하려면 다음을 수행합니다. 옵션은 software.amazon.awssdk.services.sqs.SqsClient 유형입니다.

 

SqsClient

camel.component.aws2-sqs.attribute-names

사용할 때 수신할 속성 이름 목록입니다. 여러 이름은 쉼표로 구분할 수 있습니다.

 

문자열

camel.component.aws2-sqs.auto-create-queue

대기열의 자동 생성 설정.

false

부울

camel.component.aws2-sqs.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.aws2-sqs.batch-separator

문자열 전달 시 일괄 처리 메시지 작업을 보낼 때 구분자를 설정합니다.

,

문자열

camel.component.aws2-sqs.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.aws2-sqs.concurrent-consumers

여러 스레드를 사용하여 sqs 대기열을 폴링하여 처리량을 늘릴 수 있습니다.

1

정수

camel.component.aws2-sqs.configuration

AWS SQS 기본 구성입니다. 옵션은 org.apache.camel.component.aws2.sqs.Sqs2Configuration 유형입니다.

 

Sqs2Configuration

camel.component.aws2-sqs.default-visibility-timeout

기본 가시성 제한 시간(초)입니다.

 

정수

camel.component.aws2-sqs.delay-queue

delaySeconds 옵션을 대기열 또는 단일 메시지에 적용하려는 경우 정의합니다.

false

부울

camel.component.aws2-sqs.delay-seconds

메시지 전송 시간(초)을 지연합니다.

 

정수

camel.component.aws2-sqs.delete-after-read

메시지를 읽은 후 SQS에서 삭제합니다.

true

부울

camel.component.aws2-sqs.delete-if-filtered

교환에 키가 Sqs2Constants#SQS_DELETE_FILTERED(CamelAwsSqsDeleteFiltered)가 설정된 경우 DeleteMessage를 SQS 큐에 보낼지 여부입니다.

true

부울

camel.component.aws2-sqs.enabled

aws2-sqs 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.aws2-sqs.extend-message-visibility

그런 다음 예약된 백그라운드 작업이 SQS에서 메시지 가시성을 계속 확장합니다. 메시지를 처리하는 데 시간이 오래 걸리는 경우 이 작업이 필요합니다. true defaultVisibilityTimeout으로 설정하면 됩니다. 자세한 내용은 Amazon docs에서 참조하십시오.

false

부울

camel.component.aws2-sqs.kms-data-key-reuse-period-seconds

Amazon SQS가 데이터 키를 재사용하여 AWS KMS를 다시 호출하기 전에 메시지를 암호화하거나 해독할 수 있는 시간(초)입니다. 60초(1분)에서 86,400초(24시간) 사이의 초를 나타내는 정수입니다. 기본값은 300(5분)입니다.

 

정수

camel.component.aws2-sqs.kms-master-key-id

Amazon SQS 또는 사용자 정의 CMK의 AWS 관리 고객 마스터 키(CMK)의 ID입니다.

 

문자열

camel.component.aws2-sqs.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.aws2-sqs.maximum-message-size

이 큐에 포함할 수 있는 SQS 메시지의 maximumMessageSize(바이트)입니다.

 

정수

camel.component.aws2-sqs.message-attribute-names

사용할 때 수신할 메시지 특성 이름 목록입니다. 여러 이름은 쉼표로 구분할 수 있습니다.

 

문자열

camel.component.aws2-sqs.message-deduplication-id-strategy

FIFO 대기열에서만 사용할 수 있습니다. 메시지에서 messageDeduplicationId를 설정하는 전략입니다. 다음 옵션 중 하나일 수 있습니다. useExchangeId, useContentBasedDeduplication. useContentBasedDeduplication 옵션의 경우 messageDeduplicationId가 메시지에 설정되지 않습니다.

useExchangeId

문자열

camel.component.aws2-sqs.message-group-id-strategy

FIFO 대기열에서만 사용할 수 있습니다. 메시지에서 messageGroupId를 설정하는 전략입니다. 다음 옵션 중 하나일 수 있습니다. useConstant, useExchangeId, usePropertyValue. usePropertyValue 옵션의 경우 property CamelAwsMessageGroupId 값이 사용됩니다.

 

문자열

camel.component.aws2-sqs.message-retention-period

메시지가 이 큐에 대해 SQS에 의해 유지되는 messageRetentionPeriod(초)입니다.

 

정수

camel.component.aws2-sqs.operation

사용자가 메시지만 전송하지 않으려는 경우 수행할 작업입니다.

 

Sqs2Operations

camel.component.aws2-sqs.override-endpoint

끝점을 덮어쓸 필요성을 설정합니다. 이 옵션은 uriEndpointOverride 옵션과 함께 사용해야 합니다.

false

부울

camel.component.aws2-sqs.policy

이 큐의 정책입니다. 클래스 경로에서 기본적으로 로드할 수 있지만 classpath:, file: 또는 http:를 사용하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

camel.component.aws2-sqs.protocol

SQS와 통신하는 데 사용되는 기본 프로토콜입니다.

https

문자열

camel.component.aws2-sqs.proxy-host

SQS 클라이언트를 인스턴스화할 때 프록시 호스트를 정의하려면 다음을 수행합니다.

 

문자열

camel.component.aws2-sqs.proxy-port

SQS 클라이언트를 인스턴스화할 때 프록시 포트를 정의하려면 다음을 수행합니다.

 

정수

camel.component.aws2-sqs.proxy-protocol

SQS 클라이언트를 인스턴스화할 때 프록시 프로토콜을 정의합니다.

 

프로토콜

camel.component.aws2-sqs.queue-owner-a-w-s-account-id

다른 계정 소유자와 큐를 연결해야 하는 경우 큐 소유자 aws 계정 ID를 지정합니다.

 

문자열

camel.component.aws2-sqs.queue-url

queueUrl을 명시적으로 정의하려면 다음을 수행합니다. queueUrl에 영향을 줄 수 있는 다른 모든 매개변수는 무시됩니다. 이 매개변수는 테스트를 위해 SQS의 mock 구현에 연결하기 위해 사용됩니다.

 

문자열

camel.component.aws2-sqs.receive-message-wait-time-seconds

요청에 WaitTimeSeconds를 지정하지 않으면 큐 특성 ReceiveMessageWaitTimeSeconds를 사용하여 대기 시간을 결정합니다.

 

정수

camel.component.aws2-sqs.redrive-policy

DeadLetter 큐에 메시지를 보내는 정책을 지정합니다. 자세한 내용은 Amazon docs에서 참조하십시오.

 

문자열

camel.component.aws2-sqs.region

SQS 클라이언트가 작동해야 하는 리전입니다. 이 매개변수를 사용하는 경우 구성은 지역의 소문자 이름(예: ap-east-1)을 예상합니다. Region. EU_WEST_1.id() 이름을 사용해야 합니다.

 

문자열

camel.component.aws2-sqs.secret-key

Amazon AWS 시크릿 키.

 

문자열

camel.component.aws2-sqs.server-side-encryption-enabled

큐에 서버 사이드 암호화가 활성화되어 있는지 여부를 정의합니다.

false

부울

camel.component.aws2-sqs.trust-all-certificates

끝점을 재정의하는 경우 모든 인증서를 신뢰하려면 다음을 수행합니다.

false

부울

camel.component.aws2-sqs.uri-endpoint-override

덮어쓰기된 uri 엔드 포인트를 설정합니다. 이 옵션은 overrideEndpoint 옵션과 함께 사용해야 합니다.

 

문자열

camel.component.aws2-sqs.use-default-credentials-provider

SQS 클라이언트가 AWS 인프라 인스턴스에서 인증 정보를 로드해야 하는지 아니면 정적 인증 정보가 전달될 것으로 예상되는지 여부를 설정합니다.

false

부울

camel.component.aws2-sqs.visibility-timeout

ReceiveMessage 요청에 의해 검색된 후 수신된 메시지가 com.amazonaws.services.sqs.model.SetQueueAttributesRequest에서 설정되는 기간(초)입니다. 이는 defaultVisibilityTimeout과 다른 경우에만 이해할 수 있습니다. 큐 가시성 시간 제한 속성을 영구적으로 변경합니다.

 

정수

camel.component.aws2-sqs.wait-time-seconds

ReceiveMessage 작업 호출에서 응답에 포함할 메시지가 큐에 있을 때까지 대기하는 시간(초)입니다.

 

정수

8장. Azure Storage Blob Service

생산자 및 소비자 모두 지원

Azure Storage Blob 구성 요소는 Azure API v12를 사용하여 Azure Storage Blob 서비스에서 Blob을 저장하고 검색하는 데 사용됩니다. 그러나 v12 이상의 버전의 경우 이 구성 요소가 변경 중단 정도에 따라 이러한 변경 사항을 채택할 수 있는지 확인합니다.

사전 요구 사항

유효한 Windows Azure Storage 계정이 있어야 합니다. 자세한 내용은 Azure 문서 포털에서 확인할 수 있습니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-azure-storage-blob</artifactId>
    <version>{CamelSBVersion}</version>
  <!-- use the same version as your Camel core version -->
</dependency>

8.1. URI 형식

azure-storage-blob://accountName[/containerName][?options]

consumer의 경우 accountName,containerName 이 필요합니다. 생산자의 경우, 예를 들어, 작업이 컨테이너 수준에 있는 경우(예: createContainer,accountNamecontainerName ) 필요한 작업에 따라 달라지지만 Blob 수준에서 작업이 요청되는 경우(예: getBlob,accountName,containerNameblobName )가 필요합니다.

Blob이 아직 존재하지 않는 경우 생성됩니다. 다음 형식의 URI에 쿼리 옵션을 추가할 수 있습니다.

?options=value&option2=value&…

8.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

8.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

8.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

8.3. 구성 요소 옵션

Azure Storage Blob Service 구성 요소는 아래에 나열된 31 옵션을 지원합니다.

이름설명Default유형

BlobName (common)

컨테이너에서 특정 Blob을 사용하려면 Blob 이름입니다. 그러나 생산자에서는 Blob 수준의 작업에만 필요합니다.

 

문자열

BlobOffset (common)

업로드 또는 다운로드 작업에 대한 Blob 오프셋을 설정합니다. 기본값은 0입니다.

0

long

BlobType (common)

각 Blob 유형에 대한 적절한 설정을 시작하기 위해 Blob 유형입니다.

CloudEvent 값:

  • Blockblob
  • appendblob
  • pageblob

Blockblob

BlobType

CloseStreamAfterRead (common)

스트림을 읽은 후 종료하거나 열린 상태로 유지하며 기본값은 true입니다.

true

boolean

구성 (공용)

구성 요소 구성 요소입니다.

 

BlobConfiguration

자격 증명 (공용)

StorageSharedKeyCredential를 삽입하여 azure 클라이언트를 만들 수 있습니다. 이에는 중요한 인증 정보가 들어 있습니다.

 

StorageSharedKeyCredential

dataCount (공용)

범위에 포함할 바이트 수입니다. 0을 지정하면 보다 크거나 같아야 합니다.

 

long

fileDir (공용)

다운로드한 Blob이 저장되는 파일 디렉터리이며, 생산자와 소비자 모두에 사용할 수 있습니다.

 

문자열

maxResultsPerPage (common)

모든 BlobPrefix 요소를 포함하여 반환할 Blob의 최대 수를 지정합니다. 요청이 maxResultsPerPage를 지정하지 않거나 5,000보다 큰 값을 지정하는 경우 서버는 최대 5,000개의 항목을 반환합니다.

 

정수

maxRetryRequests (common)

응답 본문에서 데이터를 읽는 동안 수행할 최대 추가 HTTP 가져오기 요청 수를 지정합니다.

0

int

접두사 (공용)

결과를 필터링하여 이름이 지정된 접두사로 시작하는 Blob만 반환합니다. 모든 Blob을 반환하려면 null일 수 있습니다.

 

문자열

regex (common)

결과를 필터링하여 이름이 지정된 정규식과 일치하는 Blob만 반환합니다. 접두사와 regex가 모두 설정된 경우 모두 반환하는 null일 수 있으며 regex는 우선 순위를 사용하고 접두사는 무시됩니다.

 

문자열

ServiceClient (공용)

Client 를 스토리지 계정으로 자동 연결합니다. 이 클라이언트는 특정 스토리지 계정에 대한 상태를 유지하지 않지만 대신 서비스의 리소스에 적절한 요청을 보내는 편리한 방법입니다. Blob 및 컨테이너에 대한 URL을 구성하는 데도 사용할 수 있습니다. 이 클라이언트에는 서비스 계정에 대한 작업이 포함되어 있습니다. 컨테이너의 작업은 BlobServiceClient#getBlobContainerClient(String)를 통해 BlobContainerClient에서 사용할 수 있으며 Blob의 작업은 BlobContainerClient#getBlobClient(String)를 통해 BlobClient에서 사용할 수 있습니다.Operations on a container are available on BlobContainerClient through BlobServiceClient#getBlobContainerClient(String), and operations on a BlobClient are available on BlobClient through BlobContainerClient#getBlobClient(String).

 

BlobServiceClient

시간 초과 (공용)

RuntimeException이 발생할 수 있는 선택적 시간 초과 값입니다.

 

기간

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

BlobSequenceNumber (producer)

요청을 추적하는 데 사용할 수 있는 사용자 제어 값입니다. 순서 숫자의 값은 0에서 263~1 사이여야 합니다. 기본값은 0입니다.

0

long

blockListType (producer)

반환할 블록 유형을 지정합니다.

CloudEvent 값:

  • committed
  • uncommitted
  • all

COMMITTED

BlockListType

ChangeFeedContext (producer)

getChangeFeed 생산자 작업을 사용할 때 서비스 호출 중에 10.0.0.1 파이프라인을 통해 전달되는 추가 컨텍스트가 제공됩니다.

 

context

changeFeedEndTime (producer)

getChangeFeed 생산자 작업을 사용할 때 결과를 필터링하여 종료 시간 전 약으로 이벤트를 반환합니다. 참고: 다음 시간에 속하는 몇 개의 이벤트도 반환할 수 있습니다. 이 시간에 속하는 몇 가지 이벤트가 누락될 수 있습니다. 한 시간 동안의 모든 이벤트를 반환하려면 종료 시간을 1시간으로 반올림합니다.

 

OffsetDateTime

ChangeFeedStartTime (producer)

getChangeFeed 생산자 작업을 사용할 때 결과를 필터링하여 시작 시간 후 약으로 이벤트를 반환합니다. 참고: 이전 시간에 속한 몇 개의 이벤트도 반환할 수 있습니다. 이 시간에 속하는 몇 가지 이벤트가 누락될 수 있습니다. 한 시간 동안의 모든 이벤트를 반환하려면 시작 시간을 1시간으로 반올림합니다.

 

OffsetDateTime

CloseStreamAfterWrite (producer)

쓰기 후 스트림을 닫거나 열린 상태로 유지하며 기본값은 true입니다.

true

boolean

commitBlockListLater (producer)

가 true로 설정되면 준비된 블록이 직접 커밋되지 않습니다.

true

boolean

createAppendBlob (producer)

가 true로 설정되면 추가 블록을 커밋할 때 추가 블록이 생성됩니다.

true

boolean

createPageBlob (producer)

가 true로 설정되면 페이지 Blob을 업로드할 때 페이지가 생성됩니다.

true

boolean

DownloadLinkExpiration (producer)

URL 다운로드 링크의 기본 만료(millis)를 재정의합니다.

 

long

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

작업 (producer)

생산자에서 이 구성 요소와 함께 사용할 수 있는 Blob 작업입니다.

CloudEvent 값:

  • listBlobContainers
  • createBlobContainer
  • deleteBlobContainer
  • listBlobs
  • getBlob
  • deleteBlob
  • downloadBlobToFile
  • downloadLink
  • uploadBlockBlob
  • stageBlockBlobList
  • commitBlobBlockList
  • getBlobBlockList
  • createAppendBlob
  • commitAppendBlob
  • createPageBlob
  • uploadPageBlob
  • resizePageBlob
  • clearPageBlob
  • getPageBlobRanges

listBlobContainers

BlobOperationsDefinition

pageBlobSize (producer)

최대 8TB 페이지 Blob의 최대 크기를 지정합니다. 페이지 Blob 크기는 512바이트 경계에 맞게 조정되어야 합니다.

512

long

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

AccessKey ( 보안)

Azure Blob 서비스의 인증에 사용할 연결된 azure 계정 이름에 대한 액세스 키입니다.

 

문자열

sourceBlobAccessKey (보안)

소스 Blob 액세스 키: copyblob 작업의 경우, 슬프게도 소스 Blob에 대한 accessKey가 있어야 헤더로 accessKey를 복사해야 하며, 키로 설정할 수 있도록 안전하지 않습니다.

 

문자열

8.4. 끝점 옵션

Azure Storage Blob 서비스 끝점은 URI 구문을 사용하여 구성됩니다.

azure-storage-blob:accountName/containerName

다음과 같은 경로 및 쿼리 매개변수 사용:

8.4.1. 경로 매개변수(2 매개변수)

이름설명Default유형

AccountName ( common)

Azure Blob 서비스를 사용한 인증에 사용할 Azure 계정 이름입니다.

 

문자열

컨테이너 이름 (공용)

Blob 컨테이너 이름입니다.

 

문자열

8.4.2. 쿼리 매개변수(48 매개변수)

이름설명Default유형

BlobName (common)

컨테이너에서 특정 Blob을 사용하려면 Blob 이름입니다. 그러나 생산자에서는 Blob 수준의 작업에만 필요합니다.

 

문자열

BlobOffset (common)

업로드 또는 다운로드 작업에 대한 Blob 오프셋을 설정합니다. 기본값은 0입니다.

0

long

BlobServiceClient (common)

스토리지 계정으로 클라이언트입니다. 이 클라이언트는 특정 스토리지 계정에 대한 상태를 유지하지 않지만 대신 서비스의 리소스에 적절한 요청을 보내는 편리한 방법입니다. Blob 및 컨테이너에 대한 URL을 구성하는 데도 사용할 수 있습니다. 이 클라이언트에는 서비스 계정에 대한 작업이 포함되어 있습니다. 컨테이너의 작업은 getBlobContainerClient(String)를 통해 BlobContainerClient에서 사용할 수 있으며 Blob의 작업은 getBlobContainerClient(String).getBlobClient(String)를 통해 BlobClient에서 사용할 수 있습니다.Operations on a container are available on BlobContainerClient through getBlobContainerClient(String), and operations on a blobClient are available on BlobClient through getBlobContainerClient(String).getBlobClient(String).getBlobClient(String).

 

BlobServiceClient

BlobType (common)

각 Blob 유형에 대한 적절한 설정을 시작하기 위해 Blob 유형입니다.

CloudEvent 값:

  • Blockblob
  • appendblob
  • pageblob

Blockblob

BlobType

CloseStreamAfterRead (common)

스트림을 읽은 후 종료하거나 열린 상태로 유지하며 기본값은 true입니다.

true

boolean

자격 증명 (공용)

StorageSharedKeyCredential를 삽입하여 azure 클라이언트를 만들 수 있습니다. 이에는 중요한 인증 정보가 들어 있습니다.

 

StorageSharedKeyCredential

dataCount (공용)

범위에 포함할 바이트 수입니다. 0을 지정하면 보다 크거나 같아야 합니다.

 

long

fileDir (공용)

다운로드한 Blob이 저장되는 파일 디렉터리이며, 생산자와 소비자 모두에 사용할 수 있습니다.

 

문자열

maxResultsPerPage (common)

모든 BlobPrefix 요소를 포함하여 반환할 Blob의 최대 수를 지정합니다. 요청이 maxResultsPerPage를 지정하지 않거나 5,000보다 큰 값을 지정하는 경우 서버는 최대 5,000개의 항목을 반환합니다.

 

정수

maxRetryRequests (common)

응답 본문에서 데이터를 읽는 동안 수행할 최대 추가 HTTP 가져오기 요청 수를 지정합니다.

0

int

접두사 (공용)

결과를 필터링하여 이름이 지정된 접두사로 시작하는 Blob만 반환합니다. 모든 Blob을 반환하려면 null일 수 있습니다.

 

문자열

regex (common)

결과를 필터링하여 이름이 지정된 정규식과 일치하는 Blob만 반환합니다. 접두사와 regex가 모두 설정된 경우 모두 반환하는 null일 수 있으며 regex는 우선 순위를 사용하고 접두사는 무시됩니다.

 

문자열

ServiceClient (공용)

Client 를 스토리지 계정으로 자동 연결합니다. 이 클라이언트는 특정 스토리지 계정에 대한 상태를 유지하지 않지만 대신 서비스의 리소스에 적절한 요청을 보내는 편리한 방법입니다. Blob 및 컨테이너에 대한 URL을 구성하는 데도 사용할 수 있습니다. 이 클라이언트에는 서비스 계정에 대한 작업이 포함되어 있습니다. 컨테이너의 작업은 BlobServiceClient#getBlobContainerClient(String)를 통해 BlobContainerClient에서 사용할 수 있으며 Blob의 작업은 BlobContainerClient#getBlobClient(String)를 통해 BlobClient에서 사용할 수 있습니다.Operations on a container are available on BlobContainerClient through BlobServiceClient#getBlobContainerClient(String), and operations on a BlobClient are available on BlobClient through BlobContainerClient#getBlobClient(String).

 

BlobServiceClient

시간 초과 (공용)

RuntimeException이 발생할 수 있는 선택적 시간 초과 값입니다.

 

기간

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

BlobSequenceNumber (producer)

요청을 추적하는 데 사용할 수 있는 사용자 제어 값입니다. 순서 숫자의 값은 0에서 263~1 사이여야 합니다. 기본값은 0입니다.

0

long

blockListType (producer)

반환할 블록 유형을 지정합니다.

CloudEvent 값:

  • committed
  • uncommitted
  • all

COMMITTED

BlockListType

ChangeFeedContext (producer)

getChangeFeed 생산자 작업을 사용할 때 서비스 호출 중에 10.0.0.1 파이프라인을 통해 전달되는 추가 컨텍스트가 제공됩니다.

 

context

changeFeedEndTime (producer)

getChangeFeed 생산자 작업을 사용할 때 결과를 필터링하여 종료 시간 전 약으로 이벤트를 반환합니다. 참고: 다음 시간에 속하는 몇 개의 이벤트도 반환할 수 있습니다. 이 시간에 속하는 몇 가지 이벤트가 누락될 수 있습니다. 한 시간 동안의 모든 이벤트를 반환하려면 종료 시간을 1시간으로 반올림합니다.

 

OffsetDateTime

ChangeFeedStartTime (producer)

getChangeFeed 생산자 작업을 사용할 때 결과를 필터링하여 시작 시간 후 약으로 이벤트를 반환합니다. 참고: 이전 시간에 속한 몇 개의 이벤트도 반환할 수 있습니다. 이 시간에 속하는 몇 가지 이벤트가 누락될 수 있습니다. 한 시간 동안의 모든 이벤트를 반환하려면 시작 시간을 1시간으로 반올림합니다.

 

OffsetDateTime

CloseStreamAfterWrite (producer)

쓰기 후 스트림을 닫거나 열린 상태로 유지하며 기본값은 true입니다.

true

boolean

commitBlockListLater (producer)

가 true로 설정되면 준비된 블록이 직접 커밋되지 않습니다.

true

boolean

createAppendBlob (producer)

가 true로 설정되면 추가 블록을 커밋할 때 추가 블록이 생성됩니다.

true

boolean

createPageBlob (producer)

가 true로 설정되면 페이지 Blob을 업로드할 때 페이지가 생성됩니다.

true

boolean

DownloadLinkExpiration (producer)

URL 다운로드 링크의 기본 만료(millis)를 재정의합니다.

 

long

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

작업 (producer)

생산자에서 이 구성 요소와 함께 사용할 수 있는 Blob 작업입니다.

CloudEvent 값:

  • listBlobContainers
  • createBlobContainer
  • deleteBlobContainer
  • listBlobs
  • getBlob
  • deleteBlob
  • downloadBlobToFile
  • downloadLink
  • uploadBlockBlob
  • stageBlockBlobList
  • commitBlobBlockList
  • getBlobBlockList
  • createAppendBlob
  • commitAppendBlob
  • createPageBlob
  • uploadPageBlob
  • resizePageBlob
  • clearPageBlob
  • getPageBlobRanges

listBlobContainers

BlobOperationsDefinition

pageBlobSize (producer)

최대 8TB 페이지 Blob의 최대 크기를 지정합니다. 페이지 Blob 크기는 512바이트 경계에 맞게 조정되어야 합니다.

512

long

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

AccessKey ( 보안)

Azure Blob 서비스의 인증에 사용할 연결된 azure 계정 이름에 대한 액세스 키입니다.

 

문자열

sourceBlobAccessKey (보안)

소스 Blob 액세스 키: copyblob 작업의 경우, 슬프게도 소스 Blob에 대한 accessKey가 있어야 헤더로 accessKey를 복사해야 하며, 키로 설정할 수 있도록 안전하지 않습니다.

 

문자열

필수 정보 옵션

이 구성 요소를 사용하려면 필요한 Azure 인증 정보를 제공하기 위해 세 가지 옵션이 있습니다.

  • Azure 계정에 accountNameaccessKey 를 제공하는 것이 가장 간단한 방법입니다. Azure Portal을 통해 accessKey를 생성할 수 있습니다.
  • 인증 정보 옵션에 제공할 수 있는 StorageSharedKeyCredential 인스턴스를 제공합니다.
  • BlobServiceClient 에 제공할 수 있는 BlobServiceClient 인스턴스를 제공합니다. 참고: BlockBlobClient와 같이 특정 클라이언트를 생성할 필요는 없으며 BlobServiceClient는 하위 수준의 클라이언트를 검색하는 데 사용할 수 있는 상위 수준을 나타냅니다.

8.5. 사용법

예를 들어 camelazure 스토리지 계정의 container1 에 있는 블록 Blob hello.txt 에서 Blob 콘텐츠를 다운로드하려면 다음 스니펫을 사용합니다.

from("azure-storage-blob://camelazure/container1?blobName=hello.txt&accessKey=yourAccessKey").
to("file://blobdirectory");

8.5.1. 구성 요소 프로듀서에서 평가한 메시지 헤더

header변수 이름유형작업설명

CamelAzureStorageBlobTimeout

BlobConstants.TIMEOUT

기간

All

{@link RuntimeException}을 초과하는 선택적 타임아웃 값입니다.

CamelAzureStorageBlobMetadata

BlobConstants.METADATA

Map<String,String>

컨테이너 및 Blob과 관련된 작업

컨테이너 또는 Blob과 연결할 메타데이터입니다.

CamelAzureStorageBlobPublicAccessType

BlobConstants.PUBLIC_ACCESS_TYPE

PublicAccessType

createContainer

이 컨테이너의 데이터를 공개적으로 사용할 수 있는 방법을 지정합니다. 공용 액세스 권한 없음에 대해 null 을 전달합니다.

CamelAzureStorageBlobRequestCondition

BlobConstants.BLOB_REQUEST_CONDITION

BlobRequestConditions

컨테이너 및 Blob과 관련된 작업

여기에는 다양한 요청의 성공적인 작업이 있는 조건에 대한 성공적인 작업을 제한하는 값이 포함됩니다. 이러한 조건은 전적으로 선택 사항입니다.

CamelAzureStorageBlobListDetails

BlobConstants.BLOB_LIST_DETAILS

BlobListDetails

listBlobs

특정 Blob 나열에 대한 세부 정보

CamelAzureStorageBlobPrefix

BlobConstants.PREFIX

문자열

listBlobs,getBlob

결과를 필터링하여 이름이 지정된 접두사로 시작하는 Blob만 반환합니다. 모든 Blob을 반환하려면 null일 수 있습니다.

CamelAzureStorageBlobMaxResultsPerPage

BlobConstants.MAX_RESULTS_PER_PAGE

정수

listBlobs

모든 BlobPrefix 요소를 포함하여 반환할 Blob의 최대 수를 지정합니다. 요청이 maxResultsPerPage를 지정하지 않거나 5,000보다 큰 값을 지정하는 경우 서버는 최대 5,000개의 항목을 반환합니다.

CamelAzureStorageBlobListBlobOptions

BlobConstants.LIST_BLOB_OPTIONS

ListBlobsOptions

listBlobs

{@link BlobContainerClient} 개체에서 listBlobsFlatSegment에 대한 호출 동작을 구성하는 데 사용할 수 있는 옵션을 정의합니다.

CamelAzureStorageBlobHttpHeaders

BlobConstants.BLOB_HTTP_HEADERS

BlobHttpHeaders

uploadBlockBlob, commitBlobBlockList, createAppendBlob, createPageBlob

작업 집합에 대한 추가 매개변수입니다.

CamelAzureStorageBlobAccessTier

BlobConstants.ACCESS_TIER

AccessTier

uploadBlockBlob, commitBlobBlockList

AccessTier에 대한 값을 정의합니다.

CamelAzureStorageBlobContentMD5

BlobConstants.CONTENT_MD5

byte[]

업로드 Blob과 관련된 대부분의 작업

블록 콘텐츠의 MD5 해시입니다. 이 해시는 전송 중에 블록의 무결성을 확인하는 데 사용됩니다. 이 헤더를 지정하면 스토리지 서비스에서 이 헤더 값과 도달한 콘텐츠의 해시를 비교합니다. 이 MD5 해시는 Blob으로 저장되지 않습니다. 두 해시가 일치하지 않으면 작업이 실패합니다.

CamelAzureStorageBlobPageBlobRange

BlobConstants.PAGE_BLOB_RANGE

PageRange

페이지 Blob과 관련된 작업

{@link PageRange} 오브젝트입니다. 페이지가 512바이트 경계로 정렬되어야 하는 경우 시작 오프셋은 512의 모듈러스여야 하며 종료 오프셋은 512 - 1의 모듈러스여야 합니다. 유효한 바이트 범위의 예는 0-511, 512-1023 등입니다.

CamelAzureStorageBlobCommitBlobBlockListLater

BlobConstants.COMMIT_BLOCK_LIST_LATER

boolean

stageBlockBlobList

true 로 설정되면 staged 블록이 직접 커밋되지 않습니다.

CamelAzureStorageBlobCreateAppendBlob

BlobConstants.CREATE_APPEND_BLOB

boolean

commitAppendBlob

true 로 설정되면 추가 블록을 커밋할 때 추가 블록이 생성됩니다.

CamelAzureStorageBlobCreatePageBlob

BlobConstants.CREATE_PAGE_BLOB

boolean

uploadPageBlob

true 로 설정되면 페이지 Blob을 업로드할 때 페이지가 생성됩니다.

CamelAzureStorageBlobBlockListType

BlobConstants.BLOCK_LIST_TYPE

BlockListType

getBlobBlockList

반환할 블록 유형을 지정합니다.

CamelAzureStorageBlobPageBlobSize

BlobConstants.PAGE_BLOB_SIZE

long

createPageBlob, resizePageBlob

최대 8TB 페이지 Blob의 최대 크기를 지정합니다. 페이지 Blob 크기는 512바이트 경계에 맞게 조정되어야 합니다.

CamelAzureStorageBlobSequenceNumber

BlobConstants.BLOB_SEQUENCE_NUMBER

long

createPageBlob

요청을 추적하는 데 사용할 수 있는 사용자 제어 값입니다. 시퀀스 번호의 값은 0에서 2^63 - 1. 기본값은 0입니다.

CamelAzureStorageBlobDeleteSnapshotsOptionType

BlobConstants.DELETE_SNAPSHOT_OPTION_TYPE

DeleteSnapshotsOptionType

deleteBlob

이 Blob에서 스냅샷을 삭제하는 동작을 지정합니다. \{@code Include}는 기본 Blob 및 모든 스냅샷을 삭제합니다. \{@code Only}는 스냅샷만 삭제합니다. 스냅샷이 삭제되는 경우 null을 전달해야 합니다.

CamelAzureStorageBlobListBlobContainersOptions

BlobConstants.LIST_BLOB_CONTAINERS_OPTIONS

ListBlobContainersOptions

listBlobContainers

서비스에서 반환해야 하는 데이터를 지정하는 {@link ListBlobContainersOptions}입니다.

CamelAzureStorageBlobParallelTransferOptions

BlobConstants.PARALLEL_TRANSFER_OPTIONS

ParallelTransferOptions

downloadBlobToFile

파일 다운로드에 사용할 {@link ParallelTransferOptions}. 병렬 전송 매개변수 수가 무시됩니다.

CamelAzureStorageBlobFileDir

BlobConstants.FILE_DIR

문자열

downloadBlobToFile

다운로드한 Blob이 저장되는 파일 디렉터리입니다.

CamelAzureStorageBlobDownloadLinkExpiration

BlobConstants.DOWNLOAD_LINK_EXPIRATION

long

downloadLink

URL 다운로드 링크의 기본 만료(millis)를 재정의합니다.

CamelAzureStorageBlobBlobName

BlobConstants.BLOB_NAME

문자열

Blob 관련 작업

교환 헤더에서 Blob 이름을 재정의/설정합니다.

CamelAzureStorageBlobContainerName

BlobConstants.BLOB_CONTAINER_NAME

문자열

컨테이너 및 Blob과 관련된 작업

교환 헤더에서 컨테이너 이름을 재정의/설정합니다.

CamelAzureStorageBlobOperation

BlobConstants.BLOB_OPERATION

BlobOperationsDefinition

All

실행할 생산자 작업을 지정합니다. 생산자 작업과 관련된 이 페이지의 문서를 참조하십시오.

CamelAzureStorageBlobRegex

BlobConstants.REGEX

문자열

listBlobs,getBlob

결과를 필터링하여 이름이 지정된 정규식과 일치하는 Blob만 반환합니다. 모두 반환하려면 null일 수 있습니다. 접두사와 regex가 모두 설정된 경우 regex는 우선 순위를 사용하고 접두사는 무시됩니다.

CamelAzureStorageBlobChangeFeedStartTime

BlobConstants.CHANGE_FEED_START_TIME

OffsetDateTime

getChangeFeed

시작 시간 후에 대략 이벤트를 반환하도록 결과를 필터링합니다. 참고: 이전 시간에 속한 몇 개의 이벤트도 반환할 수 있습니다. 이 시간에 속하는 몇 가지 이벤트가 누락될 수 있습니다. 한 시간 동안의 모든 이벤트를 반환하려면 시작 시간을 1시간으로 반올림합니다.

CamelAzureStorageBlobChangeFeedEndTime

BlobConstants.CHANGE_FEED_END_TIME

OffsetDateTime

getChangeFeed

결과를 필터링하여 종료 시간 이전에 약 이벤트를 반환합니다. 참고: 다음 시간에 속하는 몇 개의 이벤트도 반환할 수 있습니다. 이 시간에 속하는 몇 가지 이벤트가 누락될 수 있습니다. 한 시간 동안의 모든 이벤트를 반환하려면 종료 시간을 1시간으로 반올림합니다.

CamelAzureStorageBlobChangeFeedContext

BlobConstants.CHANGE_FEED_CONTEXT

context

getChangeFeed

이를 통해 서비스 호출 중에 10.0.0.1 파이프라인을 통과하는 추가 컨텍스트가 제공됩니다.

CamelAzureStorageBlobSourceBlobAccountName

BlobConstants.SOURCE_BLOB_ACCOUNT_NAME

문자열

copyBlob

복사 Blob 작업에서 소스 계정 이름으로 사용할 소스 Blob 계정 이름입니다.

CamelAzureStorageBlobSourceBlobContainerName

BlobConstants.SOURCE_BLOB_CONTAINER_NAME

문자열

copyBlob

복사 Blob 작업에서 소스 컨테이너 이름으로 사용할 소스 Blob 컨테이너 이름입니다.

8.5.2. 구성 요소 프로듀서 또는 소비자가 설정한 메시지 헤더

header변수 이름유형설명

CamelAzureStorageBlobAccessTier

BlobConstants.ACCESS_TIER

AccessTier

Blob의 액세스 계층입니다.

CamelAzureStorageBlobAccessTierChangeTime

BlobConstants.ACCESS_TIER_CHANGE_TIME

OffsetDateTime

Chrony: Blob의 액세스 계층이 마지막으로 변경된 경우입니다.

CamelAzureStorageBlobArchiveStatus

BlobConstants.ARCHIVE_STATUS

ArchiveStatus

Blob의 아카이브 상태.

CamelAzureStorageBlobCreationTime

BlobConstants.CREATION_TIME

OffsetDateTime

Blob의 생성 시간입니다.

CamelAzureStorageBlobSequenceNumber

BlobConstants.BLOB_SEQUENCE_NUMBER

long

페이지 Blob의 현재 시퀀스 번호입니다.

CamelAzureStorageBlobBlobSize

BlobConstants.BLOB_SIZE

long

Blob의 크기입니다.

CamelAzureStorageBlobBlobType

BlobConstants.BLOB_TYPE

BlobType

Blob의 유형입니다.

CamelAzureStorageBlobCacheControl

BlobConstants.CACHE_CONTROL

문자열

Blob에 지정된 캐시 컨트롤입니다.

CamelAzureStorageBlobCommittedBlockCount

BlobConstants.COMMITTED_BLOCK_COUNT

정수

추가 Blob에 커밋된 블록 수

CamelAzureStorageBlobContentDisposition

BlobConstants.CONTENT_DISPOSITION

문자열

Blob에 지정된 콘텐츠 배치입니다.

CamelAzureStorageBlobContentEncoding

BlobConstants.CONTENT_ENCODING

문자열

Blob에 지정된 콘텐츠 인코딩입니다.

CamelAzureStorageBlobContentLanguage

BlobConstants.CONTENT_LANGUAGE

문자열

Blob에 지정된 콘텐츠 언어입니다.

CamelAzureStorageBlobContentMd5

BlobConstants.CONTENT_MD5

byte[]

Blob에 지정된 콘텐츠 MD5입니다.

CamelAzureStorageBlobContentType

BlobConstants.CONTENT_TYPE

문자열

Blob에 지정된 콘텐츠 유형입니다.

CamelAzureStorageBlobCopyCompletionTime

BlobConstants.COPY_COMPILATION_TIME

OffsetDateTime

Blob의 마지막 복사 작업이 완료된 date입니다.

CamelAzureStorageBlobCopyDestinationSnapshot

BlobConstants.COPY_DESTINATION_SNAPSHOT

문자열

Blob에 대한 마지막 증분 복사 스냅샷의 스냅샷 식별자입니다.

CamelAzureStorageBlobCopyId

BlobConstants.COPY_ID

문자열

Blob에서 수행되는 마지막 복사 작업의 식별자입니다.

CamelAzureStorageBlobCopyProgress

BlobConstants.COPY_PROGRESS

문자열

Blob에서 수행된 마지막 복사 작업의 진행률입니다.

CamelAzureStorageBlobCopySource

BlobConstants.COPY_SOURCE

문자열

Blob에서 수행된 마지막 복사 작업의 소스입니다.

CamelAzureStorageBlobCopyStatus

BlobConstants.COPY_STATUS

CopyStatusType

Blob에서 수행되는 마지막 복사 작업의 상태.

CamelAzureStorageBlobCopyStatusDescription

BlobConstants.COPY_STATUS_DESCRIPTION

문자열

Blob의 마지막 복사 작업에 대한 설명입니다.

CamelAzureStorageBlobETag

BlobConstants.E_TAG

문자열

Blob의 E 태그

CamelAzureStorageBlobIsAccessTierInferred

BlobConstants.IS_ACCESS_TIER_INFRRRED

boolean

Blob의 액세스 계층이 Blob의 속성에서 유추되었는지를 나타내는 플래그입니다.

CamelAzureStorageBlobIsIncrementalCopy

BlobConstants.IS_INCREMENTAL_COPY

boolean

Blob이 증분적으로 복사되었는지 여부를 나타내는 플래그입니다.

CamelAzureStorageBlobIsServerEncrypted

BlobConstants.IS_SERVER_ENCRYPTED

boolean

서버에서 Blob의 콘텐츠가 암호화되었는지 여부를 나타내는 플래그입니다.

CamelAzureStorageBlobLastModified

BlobConstants.LAST_MODIFIED

OffsetDateTime

<!- Blob이 마지막으로 수정된 경우입니다.

CamelAzureStorageBlobLeaseDuration

BlobConstants.LEASE_DURATION

LeaseDurationType

Blob에 대한 임대 유형입니다.

CamelAzureStorageBlobLeaseState

BlobConstants.LEASE_STATE

LeaseStateType

리스가 Blob에 대한 상태입니다.

CamelAzureStorageBlobLeaseStatus

BlobConstants.LEASE_STATUS

LeaseStatusType

Blob에 리스 상태.

CamelAzureStorageBlobMetadata

BlobConstants.METADATA

Map<String, String>

Blob과 관련된 추가 메타데이터입니다.

CamelAzureStorageBlobAppendOffset

BlobConstants.APPEND_OFFSET

문자열

블록이 블록 Blob에 커밋된 오프셋입니다.

CamelAzureStorageBlobFileName

BlobConstants.FILE_NAME

문자열

작업 downloadBlobToFile 에서 다운로드한 파일 이름

CamelAzureStorageBlobDownloadLink

BlobConstants.DOWNLOAD_LINK

문자열

downloadLink 작업을 통해 생성된 다운로드 링크입니다.

CamelAzureStorageBlobRawHttpHeaders

BlobConstants.RAW_HTTP_HEADERS

HttpHeaders

사용자가 사용할 수 있는 구문이 아닌 httpHeaders를 반환합니다.

8.5.3. 고급 Azure Storage Blob 구성

Camel 애플리케이션이 방화벽 뒤에서 실행 중이거나 BlobServiceClient 인스턴스 구성을 더 많이 제어해야 하는 경우 자체 인스턴스를 생성할 수 있습니다.

StorageSharedKeyCredential credential = new StorageSharedKeyCredential("yourAccountName", "yourAccessKey");
String uri = String.format("https://%s.blob.core.windows.net", "yourAccountName");

BlobServiceClient client = new BlobServiceClientBuilder()
                          .endpoint(uri)
                          .credential(credential)
                          .buildClient();
// This is camel context
context.getRegistry().bind("client", client);

그런 다음 Camel azure-storage-blob 구성 요소 구성에서 이 인스턴스를 참조합니다.

from("azure-storage-blob://cameldev/container1?blobName=myblob&serviceClient=#client")
.to("mock:result");

8.5.4. 레지스트리에서 BlobServiceClient 클라이언트 자동 검색

구성 요소는 BlobServiceClient console이 레지스트리에 있는지 감지할 수 있습니다. 해당 유형의 유일한 인스턴스인 경우 이 인스턴스가 클라이언트로 사용되며 위의 예제와 같이 uri 매개변수로 정의할 필요가 없습니다. 이 기능은 끝점을 더 스마트하게 구성하는 데 매우 유용할 수 있습니다.

8.5.5. Azure Storage Blob Producer 작업

Camel Azure Storage Blob 구성 요소는 생산자 측에서 다양한 작업을 제공합니다.

서비스 수준에서의 작업

이러한 작업의 경우 accountName필요합니다.

작업설명

listBlobContainers

Blob의 콘텐츠를 가져옵니다. 이 작업의 출력을 Blob 범위로 제한할 수 있습니다.

getChangeFeed

Blobs 및 스토리지 계정의 Blob 메타데이터에 발생하는 모든 변경 사항의 트랜잭션 로그를 반환합니다. 변경 피드는 이러한 변경에 대한 순서, 보장, 지속성, 변경 불가능, 읽기 전용 로그를 제공합니다.

컨테이너 수준에서의 작업

이러한 작업의 경우 accountNamecontainerName필요합니다.

작업설명

createBlobContainer

스토리지 계정 내에 새 컨테이너를 생성합니다. 동일한 이름의 컨테이너가 이미 있는 경우 생산자는 이를 무시합니다.

deleteBlobContainer

스토리지 계정에서 지정된 컨테이너를 삭제합니다. 컨테이너가 없으면 작업이 실패합니다.

listBlobs

이 컨테이너의 Blob 목록을 반환하고 폴더 구조가 평면화됩니다.

Blob 수준의 작업

이러한 작업의 경우 accountName,containerNameblobName필요합니다.

작업Blob 유형설명

getBlob

Common

Blob의 콘텐츠를 가져옵니다. 이 작업의 출력을 Blob 범위로 제한할 수 있습니다.

deleteBlob

Common

Blob을 삭제합니다.

downloadBlobToFile

Common

전체 Blob을 경로로 지정된 파일로 다운로드합니다. 파일이 생성되고 파일이 이미 존재하는 경우 {@link FileAlreadyExistsException}가 발생합니다.

downloadLink

Common

SAS(공유 액세스 서명)를 사용하여 지정된 Blob에 대한 다운로드 링크를 생성합니다. 기본적으로는 허용된 액세스 권한의 1시간으로만 제한됩니다. 그러나 헤더를 통해 기본 만료 기간을 재정의할 수 있습니다.

uploadBlockBlob

BlockBlob

새 블록 Blob을 만들거나 기존 블록 Blob의 내용을 업데이트합니다. 기존 블록 Blob을 업데이트하면 Blob의 기존 메타데이터가 덮어씁니다. PutBlob에서는 부분적인 업데이트가 지원되지 않습니다. 기존 Blob의 내용은 새 콘텐츠로 덮어씁니다.

stageBlockBlobList

BlockBlob

지정된 블록을 commitBlobBlockList 호출에 의해 나중에 커밋하기 위해 블록 Blob의 "staging 영역"에 업로드합니다. 그러나 CamelAzureStorageBlobCommitBlobBlockListLater 또는 config commitBlockListLater 가 false로 설정된 경우 블록을 준비한 직후 블록을 커밋합니다.

commitBlobBlockList

BlockBlob

Blob을 구성할 블록 ID 목록을 지정하여 Blob을 씁니다.Writes a blob by specifying the list of block IDs that are to make up the blob. Blob의 일부로 작성되려면 이전 stageBlockBlobList 작업에서 블록이 서버에 성공적으로 기록되어야 합니다. 변경된 블록만 업로드한 다음 새 블록과 기존 블록을 함께 커밋하여 commitBlobBlockList 를 호출하여 Blob을 업데이트할 수 있습니다. 블록 목록에 지정되지 않은 모든 블록이 영구적으로 삭제되었습니다.

getBlobBlockList

BlockBlob

지정된 블록 목록 필터를 사용하여 블록 Blob의 일부로 업로드된 블록 목록을 반환합니다.

createAppendBlob

AppendBlob

0 길이 추가 Blob을 만듭니다. commitAppendBlo'b 작업을 호출하여 데이터를 추가 Blob에 추가합니다.

commitAppendBlob

AppendBlob

새 데이터 블록을 기존 추가 Blob의 끝에 커밋합니다. header CamelAzureStorageBlobCreateAppendBlob 또는 config createAppendBlob 가 true로 설정된 경우 커밋하기 전에 createAppendBlob 작업을 내부 호출을 통해 appendBlob를 생성합니다.

createPageBlob

PageBlob

지정된 길이의 페이지 Blob을 만듭니다. uploadPageBlob 작업을 호출하여 데이터 데이터를 페이지 Blob에 업로드합니다.

uploadPageBlob

PageBlob

페이지 Blob에 하나 이상의 페이지를 씁니다.Writes one or more pages to the page blob. 쓰기 크기는 512의 여러 개여야 합니다. header CamelAzureStorageBlobCreatePageBlob 또는 config createPageBlob 가 true로 설정된 경우 업로드하기 전에 먼저 createPageBlob 작업을 내부 호출을 통해 appendBlob를 생성하려고 합니다.

resizePageBlob

PageBlob

페이지 Blob의 크기를 지정된 크기(512개 이상이어야 함)로 조정합니다.

clearPageBlob

PageBlob

페이지 Blob에서 지정된 페이지를 해제합니다. 범위의 크기는 512의 여러 개여야 합니다.

getPageBlobRanges

PageBlob

페이지 Blob 또는 페이지 Blob의 스냅샷에 대한 유효한 페이지 범위 목록을 반환합니다.

copyBlob

common

다른 계정에서도 한 컨테이너에서 다른 컨테이너로 Blob을 복사합니다.

이러한 작업을 camel 애플리케이션에 사용하는 방법을 알아보려면 이 페이지의 예제 섹션을 참조하십시오.

8.5.6. 소비자 예

파일 구성 요소를 사용하여 Blob을 파일로 사용하려면 다음과 같이 수행할 수 있습니다.

from("azure-storage-blob://camelazure/container1?blobName=hello.txt&accountName=yourAccountName&accessKey=yourAccessKey").
to("file://blobdirectory");

그러나 파일 구성 요소를 사용하지 않고 직접 파일에 쓸 수도 있습니다. Blob을 저장하려면 fileDir 폴더 경로를 지정해야 합니다.

from("azure-storage-blob://camelazure/container1?blobName=hello.txt&accountName=yourAccountName&accessKey=yourAccessKey&fileDir=/var/to/awesome/dir").
to("mock:results");

또한 이 구성 요소는 일괄 소비자를 지원하므로 컨테이너 이름만 지정하여 여러 Blob을 사용할 수 있으므로 사용자는 컨테이너의 Blob 수에 따라 여러 트랜잭션을 반환합니다.

예제

from("azure-storage-blob://camelazure/container1?accountName=yourAccountName&accessKey=yourAccessKey&fileDir=/var/to/awesome/dir").
to("mock:results");

8.5.7. 생산자 작업 예

  • listBlobContainers
from("direct:start")
  .process(exchange -> {
    // set the header you want the producer to evaluate, refer to the previous
    // section to learn about the headers that can be set
    // e.g:
    exchange.getIn().setHeader(BlobConstants.LIST_BLOB_CONTAINERS_OPTIONS, new ListBlobContainersOptions().setMaxResultsPerPage(10));
  })
  .to("azure-storage-blob://camelazure?operation=listBlobContainers&client&serviceClient=#client")
  .to("mock:result");
  • createBlobContainer
from("direct:start")
  .process(exchange -> {
    // set the header you want the producer to evaluate, refer to the previous
    // section to learn about the headers that can be set
    // e.g:
    exchange.getIn().setHeader(BlobConstants.BLOB_CONTAINER_NAME, "newContainerName");
  })
  .to("azure-storage-blob://camelazure/container1?operation=createBlobContainer&serviceClient=#client")
  .to("mock:result");
  • deleteBlobContainer:
from("direct:start")
  .process(exchange -> {
    // set the header you want the producer to evaluate, refer to the previous
    // section to learn about the headers that can be set
    // e.g:
    exchange.getIn().setHeader(BlobConstants.BLOB_CONTAINER_NAME, "overridenName");
  })
  .to("azure-storage-blob://camelazure/container1?operation=deleteBlobContainer&serviceClient=#client")
  .to("mock:result");
  • listBlobs:
from("direct:start")
  .process(exchange -> {
    // set the header you want the producer to evaluate, refer to the previous
    // section to learn about the headers that can be set
    // e.g:
    exchange.getIn().setHeader(BlobConstants.BLOB_CONTAINER_NAME, "overridenName");
  })
  .to("azure-storage-blob://camelazure/container1?operation=listBlobs&serviceClient=#client")
  .to("mock:result");
  • getBlob:

교환 본문에서 outputStream 을 설정하고 데이터를 쓸 수 있습니다. 예:

from("direct:start")
  .process(exchange -> {
    // set the header you want the producer to evaluate, refer to the previous
    // section to learn about the headers that can be set
    // e.g:
    exchange.getIn().setHeader(BlobConstants.BLOB_CONTAINER_NAME, "overridenName");

    // set our body
    exchange.getIn().setBody(outputStream);
  })
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=getBlob&serviceClient=#client")
  .to("mock:result");

본문을 설정하지 않으면 이 작업은 추가 다운스트림을 진행할 수 있는 InputStream 인스턴스를 제공합니다.

from("direct:start")
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=getBlob&serviceClient=#client")
  .process(exchange -> {
      InputStream inputStream = exchange.getMessage().getBody(InputStream.class);
      // We use Apache common IO for simplicity, but you are free to do whatever dealing
      // with inputStream
      System.out.println(IOUtils.toString(inputStream, StandardCharsets.UTF_8.name()));
  })
  .to("mock:result");
  • deleteBlob:
from("direct:start")
  .process(exchange -> {
    // set the header you want the producer to evaluate, refer to the previous
    // section to learn about the headers that can be set
    // e.g:
    exchange.getIn().setHeader(BlobConstants.BLOB_NAME, "overridenName");
  })
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=deleteBlob&serviceClient=#client")
  .to("mock:result");
  • downloadBlobToFile:
from("direct:start")
  .process(exchange -> {
    // set the header you want the producer to evaluate, refer to the previous
    // section to learn about the headers that can be set
    // e.g:
    exchange.getIn().setHeader(BlobConstants.BLOB_NAME, "overridenName");
  })
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=downloadBlobToFile&fileDir=/var/mydir&serviceClient=#client")
  .to("mock:result");
  • downloadLink
from("direct:start")
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=downloadLink&serviceClient=#client")
  .process(exchange -> {
      String link = exchange.getMessage().getHeader(BlobConstants.DOWNLOAD_LINK, String.class);
      System.out.println("My link " + link);
  })
  .to("mock:result");
  • uploadBlockBlob
from("direct:start")
  .process(exchange -> {
    // set the header you want the producer to evaluate, refer to the previous
    // section to learn about the headers that can be set
    // e.g:
    exchange.getIn().setHeader(BlobConstants.BLOB_NAME, "overridenName");
    exchange.getIn().setBody("Block Blob");
  })
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=uploadBlockBlob&serviceClient=#client")
  .to("mock:result");
  • stageBlockBlobList
from("direct:start")
  .process(exchange -> {
      final List<BlobBlock> blocks = new LinkedList<>();
      blocks.add(BlobBlock.createBlobBlock(new ByteArrayInputStream("Hello".getBytes())));
      blocks.add(BlobBlock.createBlobBlock(new ByteArrayInputStream("From".getBytes())));
      blocks.add(BlobBlock.createBlobBlock(new ByteArrayInputStream("Camel".getBytes())));

      exchange.getIn().setBody(blocks);
  })
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=stageBlockBlobList&serviceClient=#client")
  .to("mock:result");
  • commitBlockBlobList
from("direct:start")
  .process(exchange -> {
      // We assume here you have the knowledge of these blocks you want to commit
      final List<Block> blocksIds = new LinkedList<>();
      blocksIds.add(new Block().setName("id-1"));
      blocksIds.add(new Block().setName("id-2"));
      blocksIds.add(new Block().setName("id-3"));

      exchange.getIn().setBody(blocksIds);
  })
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=commitBlockBlobList&serviceClient=#client")
  .to("mock:result");
  • getBlobBlockList
from("direct:start")
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=getBlobBlockList&serviceClient=#client")
  .log("${body}")
  .to("mock:result");
  • createAppendBlob
from("direct:start")
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=createAppendBlob&serviceClient=#client")
  .to("mock:result");
  • commitAppendBlob
from("direct:start")
  .process(exchange -> {
    final String data = "Hello world from my awesome tests!";
    final InputStream dataStream = new ByteArrayInputStream(data.getBytes(StandardCharsets.UTF_8));

    exchange.getIn().setBody(dataStream);

    // of course you can set whatever headers you like, refer to the headers section to learn more
  })
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=commitAppendBlob&serviceClient=#client")
  .to("mock:result");
  • createPageBlob
from("direct:start")
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=createPageBlob&serviceClient=#client")
  .to("mock:result");
  • uploadPageBlob
from("direct:start")
  .process(exchange -> {
    byte[] dataBytes = new byte[512]; // we set range for the page from 0-511
    new Random().nextBytes(dataBytes);
    final InputStream dataStream = new ByteArrayInputStream(dataBytes);
    final PageRange pageRange = new PageRange().setStart(0).setEnd(511);

    exchange.getIn().setHeader(BlobConstants.PAGE_BLOB_RANGE, pageRange);
    exchange.getIn().setBody(dataStream);
  })
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=uploadPageBlob&serviceClient=#client")
  .to("mock:result");
  • resizePageBlob
from("direct:start")
  .process(exchange -> {
    final PageRange pageRange = new PageRange().setStart(0).setEnd(511);

    exchange.getIn().setHeader(BlobConstants.PAGE_BLOB_RANGE, pageRange);
  })
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=resizePageBlob&serviceClient=#client")
  .to("mock:result");
  • clearPageBlob
from("direct:start")
  .process(exchange -> {
    final PageRange pageRange = new PageRange().setStart(0).setEnd(511);

    exchange.getIn().setHeader(BlobConstants.PAGE_BLOB_RANGE, pageRange);
  })
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=clearPageBlob&serviceClient=#client")
  .to("mock:result");
  • getPageBlobRanges
from("direct:start")
  .process(exchange -> {
    final PageRange pageRange = new PageRange().setStart(0).setEnd(511);

    exchange.getIn().setHeader(BlobConstants.PAGE_BLOB_RANGE, pageRange);
  })
  .to("azure-storage-blob://camelazure/container1?blobName=blob&operation=getPageBlobRanges&serviceClient=#client")
  .log("${body}")
  .to("mock:result");
  • copyBlob
from("direct:copyBlob")
  .process(exchange -> {
    exchange.getIn().setHeader(BlobConstants.BLOB_NAME, "file.txt");
    exchange.getMessage().setHeader(BlobConstants.SOURCE_BLOB_CONTAINER_NAME, "containerblob1");
    exchange.getMessage().setHeader(BlobConstants.SOURCE_BLOB_ACCOUNT_NAME, "account");
  })
  .to("azure-storage-blob://account/containerblob2?operation=copyBlob&sourceBlobAccessKey=RAW(accessKey)")
  .to("mock:result");

이렇게 하면 계정 'account'의 컨테이너 containerblob1에 있는 file.txt가 동일한 계정의 컨테이너 containerblob2에 복사됩니다.

8.5.8. 개발 노트(Important)

모든 통합 테스트에서는 Testcontainers 를 사용하고 기본적으로 실행됩니다. Azure 서비스를 사용하여 모든 통합 테스트를 실행하려면 Azure accessKey 및 accountName이 필요합니다. Azure 클라이언트가 마이너 버전 업그레이드에서도 문제를 해결할 수 있으므로 모든 변경 사항을 사용하여 통합 테스트를 실행해야 합니다.In addition to the mocked unit tests you will need to run the integration tests with every change you make or even client upgrade as the Azure client can break things even on minor versions upgrade. 통합 테스트를 실행하려면 이 구성 요소 디렉터리에서 다음 maven 명령을 실행합니다.

mvn verify -PfullTests -DaccountName=myacc -DaccessKey=mykey

accountName 은 Azure 계정 이름이고 accessKey 는 Azure Portal에서 생성되는 액세스 키입니다.

8.6. Spring Boot Auto-Configuration

Spring Boot와 함께 azure-storage-blob를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-azure-storage-blob-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

구성 요소는 아래에 나열된 32개의 옵션을 지원합니다.

이름설명Default유형

camel.component.azure-storage-blob.access-key

Azure Blob 서비스의 인증에 사용할 연결된 azure 계정 이름에 대한 액세스 키입니다.

 

문자열

camel.component.azure-storage-blob.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.azure-storage-blob.blob-name

컨테이너에서 특정 Blob을 사용하려면 Blob 이름입니다. 그러나 생산자에서는 Blob 수준의 작업에만 필요합니다.

 

문자열

camel.component.azure-storage-blob.blob-offset

업로드 또는 다운로드 작업에 대한 Blob 오프셋을 설정합니다. 기본값은 0입니다.

0

long

camel.component.azure-storage-blob.blob-sequence-number

요청을 추적하는 데 사용할 수 있는 사용자 제어 값입니다. 순서 숫자의 값은 0에서 263~1 사이여야 합니다. 기본값은 0입니다.

0

long

camel.component.azure-storage-blob.blob-type

각 Blob 유형에 대한 적절한 설정을 시작하기 위해 Blob 유형입니다.

 

BlobType

camel.component.azure-storage-blob.block-list-type

반환할 블록 유형을 지정합니다.

 

BlockListType

camel.component.azure-storage-blob.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.azure-storage-blob.change-feed-context

getChangeFeed 생산자 작업을 사용할 때 서비스 호출 중에 10.0.0.1 파이프라인을 통해 전달되는 추가 컨텍스트가 제공됩니다. 옵션은 com.azure.core.util.Context 유형입니다.

 

context

camel.component.azure-storage-blob.change-feed-end-time

getChangeFeed 생산자 작업을 사용할 때 결과를 필터링하여 종료 시간 전 약으로 이벤트를 반환합니다. 참고: 다음 시간에 속하는 몇 개의 이벤트도 반환할 수 있습니다. 이 시간에 속하는 몇 가지 이벤트가 누락될 수 있습니다. 한 시간 동안의 모든 이벤트를 반환하려면 종료 시간을 1시간으로 반올림합니다. 옵션은 java.time.OffsetDateTime 유형입니다.

 

OffsetDateTime

camel.component.azure-storage-blob.change-feed-start-time

getChangeFeed 생산자 작업을 사용할 때 결과를 필터링하여 시작 시간 후 약으로 이벤트를 반환합니다. 참고: 이전 시간에 속한 몇 개의 이벤트도 반환할 수 있습니다. 이 시간에 속하는 몇 가지 이벤트가 누락될 수 있습니다. 한 시간 동안의 모든 이벤트를 반환하려면 시작 시간을 1시간으로 반올림합니다. 옵션은 java.time.OffsetDateTime 유형입니다.

 

OffsetDateTime

camel.component.azure-storage-blob.close-stream-after-read

스트림을 읽은 후 종료하거나 열린 상태로 유지하며 기본값은 true입니다.

true

부울

camel.component.azure-storage-blob.close-stream-after-write

쓰기 후 스트림을 닫거나 열린 상태로 유지하며 기본값은 true입니다.

true

부울

camel.component.azure-storage-blob.commit-block-list-later

가 true로 설정되면 준비된 블록이 직접 커밋되지 않습니다.

true

부울

camel.component.azure-storage-blob.configuration

구성 요소 구성 요소입니다. 옵션은 org.apache.camel.component.azure.storage.blob.BlobConfiguration 유형입니다.

 

BlobConfiguration

camel.component.azure-storage-blob.create-append-blob

가 true로 설정되면 추가 블록을 커밋할 때 추가 블록이 생성됩니다.

true

부울

camel.component.azure-storage-blob.create-page-blob

가 true로 설정되면 페이지 Blob을 업로드할 때 페이지가 생성됩니다.

true

부울

camel.component.azure-storage-blob.credentials

StorageSharedKeyCredential를 삽입하여 azure 클라이언트를 만들 수 있습니다. 이에는 중요한 인증 정보가 들어 있습니다. 옵션은 com.azure.storage.common.StorageSharedKeyCredential 유형입니다.

 

StorageSharedKeyCredential

camel.component.azure-storage-blob.data-count

범위에 포함할 바이트 수입니다. 0을 지정하면 보다 크거나 같아야 합니다.

 

long

camel.component.azure-storage-blob.download-link-expiration

URL 다운로드 링크의 기본 만료(millis)를 재정의합니다.

 

long

camel.component.azure-storage-blob.enabled

azure-storage-blob 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.azure-storage-blob.file-dir

다운로드한 Blob이 저장되는 파일 디렉터리이며, 생산자와 소비자 모두에 사용할 수 있습니다.

 

문자열

camel.component.azure-storage-blob.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.azure-storage-blob.max-results-per-page

모든 BlobPrefix 요소를 포함하여 반환할 Blob의 최대 수를 지정합니다. 요청이 maxResultsPerPage를 지정하지 않거나 5,000보다 큰 값을 지정하는 경우 서버는 최대 5,000개의 항목을 반환합니다.

 

정수

camel.component.azure-storage-blob.max-retry-requests

응답 본문에서 데이터를 읽는 동안 수행할 최대 추가 HTTP 가져오기 요청 수를 지정합니다.

0

정수

camel.component.azure-storage-blob.operation

생산자에서 이 구성 요소와 함께 사용할 수 있는 Blob 작업입니다.

 

BlobOperationsDefinition

camel.component.azure-storage-blob.page-blob-size

최대 8TB 페이지 Blob의 최대 크기를 지정합니다. 페이지 Blob 크기는 512바이트 경계에 맞게 조정되어야 합니다.

512

long

camel.component.azure-storage-blob.prefix

결과를 필터링하여 이름이 지정된 접두사로 시작하는 Blob만 반환합니다. 모든 Blob을 반환하려면 null일 수 있습니다.

 

문자열

camel.component.azure-storage-blob.regex

결과를 필터링하여 이름이 지정된 정규식과 일치하는 Blob만 반환합니다. 접두사와 regex가 모두 설정된 경우 모두 반환하는 null일 수 있으며 regex는 우선 순위를 사용하고 접두사는 무시됩니다.

 

문자열

camel.component.azure-storage-blob.service-client

스토리지 계정으로 클라이언트입니다. 이 클라이언트는 특정 스토리지 계정에 대한 상태를 유지하지 않지만 대신 서비스의 리소스에 적절한 요청을 보내는 편리한 방법입니다. Blob 및 컨테이너에 대한 URL을 구성하는 데도 사용할 수 있습니다. 이 클라이언트에는 서비스 계정에 대한 작업이 포함되어 있습니다. 컨테이너의 작업은 BlobServiceClient#getBlobContainerClient(String)를 통해 BlobContainerClient에서 사용할 수 있으며 Blob의 작업은 BlobContainerClient#getBlobClient(String)를 통해 BlobClient에서 사용할 수 있습니다.Operations on a container are available on BlobContainerClient through BlobServiceClient#getBlobContainerClient(String), and operations on a BlobClient are available on BlobClient through BlobContainerClient#getBlobClient(String). 옵션은 com.azure.storage.blob.BlobServiceClient 유형입니다.

 

BlobServiceClient

camel.component.azure-storage-blob.source-blob-access-key

소스 Blob 액세스 키: copyblob 작업의 경우, 슬프게도 소스 Blob에 대한 accessKey가 있어야 헤더로 accessKey를 복사해야 하며, 키로 설정할 수 있도록 안전하지 않습니다.

 

문자열

camel.component.azure-storage-blob.timeout

RuntimeException이 발생할 수 있는 선택적 시간 초과 값입니다. 옵션은 java.time.Duration 유형입니다.

 

기간

9장. Azure Storage Queue Service

생산자 및 소비자 모두 지원

Azure Storage Queue 구성 요소는 Azure API v12를 사용하여 Azure Storage 대기열 서비스로 메시지 저장 및 검색을 지원합니다. 그러나 v12 이상의 버전의 경우 이 구성 요소가 변경 중단 정도에 따라 이러한 변경 사항을 채택할 수 있는지 확인합니다.

사전 요구 사항

유효한 Windows Azure Storage 계정이 있어야 합니다. 자세한 내용은 Azure 문서 포털에서 확인할 수 있습니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-azure-storage-queue</artifactId>
    <version>{CamelSBVersion}</version>
  <!-- use the same version as your Camel core version -->
</dependency>

9.1. URI 형식

azure-storage-queue://accountName[/queueName][?options]

소비자의 경우 accountName 및 queueName이 필요합니다. 생산자의 경우, 예를 들어 작업이 서비스 수준(예: listQueues)에 있는 경우 요청되는 작업에 따라 달라지지만, 큐 수준에서 요청된 작업(예: createQueue, sendMessage 및 queueName 등)이 모두 필요한 경우 accountQueue와 queueName만 필요합니다.

대기열이 아직 없는 경우 큐가 생성됩니다. 다음 형식의 URI에 쿼리 옵션을 추가할 수 있습니다.

?options=value&option2=value&…

9.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

9.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

9.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

9.3. 구성 요소 옵션

Azure Storage Queue Service 구성 요소는 아래에 나열된 15개의 옵션을 지원합니다.

이름설명Default유형

구성 (공용)

구성 요소 구성 요소입니다.

 

QueueConfiguration

ServiceClient (공용)

대기열 서비스와 상호 작용할 수 있는 스토리지 계정에 대한 자동 유선 서비스 클라이언트입니다. 이 클라이언트는 특정 스토리지 계정에 대한 상태를 유지하지 않지만 대신 서비스의 리소스에 적절한 요청을 보내는 편리한 방법입니다. 이 클라이언트에는 Azure Storage에서 큐 계정과 상호 작용하는 모든 작업이 포함되어 있습니다. 클라이언트에서 허용하는 작업은 큐를 생성, 나열 및 삭제하고 계정의 속성을 검색 및 업데이트하고 계정의 통계를 검색하는 것입니다.

 

QueueServiceClient

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

CreateQueue (producer)

가 true로 설정되면 메시지를 큐로 보낼 때 큐가 자동으로 생성됩니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

작업 (producer)

생산자에 대한 서비스 작업 힌트를 대기열에 넣습니다.

CloudEvent 값:

  • listQueues
  • createQueue
  • deleteQueue
  • clearQueue
  • sendMessage
  • deleteMessage
  • receiveMessages
  • peekMessages
  • updateMessage
 

QueueOperationDefinition

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

maxMessages (queue)

요청된 모든 메시지보다 큐에 메시지가 있는 경우 가져올 최대 메시지 수가 반환됩니다. 비어 있는 메시지 1개만 검색하면 허용되는 범위는 1~32개의 메시지입니다.

1

정수

MessageID (queue)

삭제하거나 업데이트할 메시지의 ID입니다.

 

문자열

popReceipt (queue)

메시지 삭제 또는 업데이트와 일치해야 하는 고유 식별자입니다.

 

문자열

타임아웃 (queue)

작업에 적용되는 선택적 제한 시간입니다. 시간 초과가 종료되기 전에 응답이 반환되지 않으면 RuntimeException이 발생합니다.

 

기간

TimeToLive (queue)

메시지가 큐에 유지되는 기간입니다. 설정되지 않으면 값이 7일로 설정되어 있으면 -1이 전달되면 메시지가 만료되지 않습니다. 이름은 -1 또는 양의 숫자여야 합니다. 형식은 다음과 같은 형식이어야 합니다: PnDTnHn.nS. 예를 들면 PT20.345S간마크로 20.345초, P2DECDHE-ECDHEparses를 2 일로 사용하지만, EndpointDsl/ComponentDsl을 사용하는 경우에는 EndpointDsl/ComponentDsl과 같은 작업을 수행할 수 있습니다.

 

기간

visibilityTimeout (queue)

큐에서 메시지가 표시되지 않는 기간의 제한 시간입니다. 제한 시간은 1초에서 7일 사이여야 합니다. 형식은 다음과 같은 형식이어야 합니다: PnDTnHn.nS. 예를 들면 PT20.345S간마크로 20.345초, P2DECDHE-ECDHEparses를 2 일로 사용하지만, EndpointDsl/ComponentDsl을 사용하는 경우에는 EndpointDsl/ComponentDsl과 같은 작업을 수행할 수 있습니다.

 

기간

AccessKey ( 보안)

Azure 대기열 서비스를 사용한 인증에 사용할 연결된 azure 계정 이름에 대한 액세스 키입니다.

 

문자열

자격 증명 (보안)

StorageSharedKeyCredential를 삽입하여 azure 클라이언트를 만들 수 있습니다. 이에는 중요한 인증 정보가 들어 있습니다.

 

StorageSharedKeyCredential

9.4. 끝점 옵션

Azure Storage Queue Service 엔드포인트는 URI 구문을 사용하여 구성됩니다.

azure-storage-queue:accountName/queueName

다음과 같은 경로 및 쿼리 매개변수 사용:

9.4.1. 경로 매개변수(2 매개변수)

이름설명Default유형

AccountName ( common)

Azure 큐 서비스를 사용한 인증에 사용할 Azure 계정 이름입니다.

 

문자열

queueName (common)

대기열 리소스 이름입니다.

 

문자열

9.4.2. 쿼리 매개변수(31 매개변수)

이름설명Default유형

ServiceClient (공용)

대기열 서비스와 상호 작용할 수 있는 스토리지 계정에 대한 자동 유선 서비스 클라이언트입니다. 이 클라이언트는 특정 스토리지 계정에 대한 상태를 유지하지 않지만 대신 서비스의 리소스에 적절한 요청을 보내는 편리한 방법입니다. 이 클라이언트에는 Azure Storage에서 큐 계정과 상호 작용하는 모든 작업이 포함되어 있습니다. 클라이언트에서 허용하는 작업은 큐를 생성, 나열 및 삭제하고 계정의 속성을 검색 및 업데이트하고 계정의 통계를 검색하는 것입니다.

 

QueueServiceClient

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

CreateQueue (producer)

가 true로 설정되면 메시지를 큐로 보낼 때 큐가 자동으로 생성됩니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

작업 (producer)

생산자에 대한 서비스 작업 힌트를 대기열에 넣습니다.

CloudEvent 값:

  • listQueues
  • createQueue
  • deleteQueue
  • clearQueue
  • sendMessage
  • deleteMessage
  • receiveMessages
  • peekMessages
  • updateMessage
 

QueueOperationDefinition

maxMessages (queue)

요청된 모든 메시지보다 큐에 메시지가 있는 경우 가져올 최대 메시지 수가 반환됩니다. 비어 있는 메시지 1개만 검색하면 허용되는 범위는 1~32개의 메시지입니다.

1

정수

MessageID (queue)

삭제하거나 업데이트할 메시지의 ID입니다.

 

문자열

popReceipt (queue)

메시지 삭제 또는 업데이트와 일치해야 하는 고유 식별자입니다.

 

문자열

타임아웃 (queue)

작업에 적용되는 선택적 제한 시간입니다. 시간 초과가 종료되기 전에 응답이 반환되지 않으면 RuntimeException이 발생합니다.

 

기간

TimeToLive (queue)

메시지가 큐에 유지되는 기간입니다. 설정되지 않으면 값이 7일로 설정되어 있으면 -1이 전달되면 메시지가 만료되지 않습니다. 이름은 -1 또는 양의 숫자여야 합니다. 형식은 다음과 같은 형식이어야 합니다: PnDTnHn.nS. 예를 들면 PT20.345S간마크로 20.345초, P2DECDHE-ECDHEparses를 2 일로 사용하지만, EndpointDsl/ComponentDsl을 사용하는 경우에는 EndpointDsl/ComponentDsl과 같은 작업을 수행할 수 있습니다.

 

기간

visibilityTimeout (queue)

큐에서 메시지가 표시되지 않는 기간의 제한 시간입니다. 제한 시간은 1초에서 7일 사이여야 합니다. 형식은 다음과 같은 형식이어야 합니다: PnDTnHn.nS. 예를 들면 PT20.345S간마크로 20.345초, P2DECDHE-ECDHEparses를 2 일로 사용하지만, EndpointDsl/ComponentDsl을 사용하는 경우에는 EndpointDsl/ComponentDsl과 같은 작업을 수행할 수 있습니다.

 

기간

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

AccessKey ( 보안)

Azure 대기열 서비스를 사용한 인증에 사용할 연결된 azure 계정 이름에 대한 액세스 키입니다.

 

문자열

자격 증명 (보안)

StorageSharedKeyCredential를 삽입하여 azure 클라이언트를 만들 수 있습니다. 이에는 중요한 인증 정보가 들어 있습니다.

 

StorageSharedKeyCredential

필수 정보 옵션

이 구성 요소를 사용하려면 필요한 Azure 인증 정보를 제공하기 위해 세 가지 옵션이 있습니다.

  • Azure 계정에 accountNameaccessKey 를 제공하는 것이 가장 간단한 방법입니다. Azure Portal을 통해 accessKey를 생성할 수 있습니다.
  • 인증 정보 옵션에 제공할 수 있는 StorageSharedKeyCredential 인스턴스를 제공합니다.
  • serviceClient 로 제공할 수 있는 QueueServiceClient 인스턴스를 제공합니다. 참고: 특정 클라이언트(예: QueueClient)를 생성할 필요가 없으며, QueueServiceClient는 하위 수준의 클라이언트를 검색하는 데 사용할 수 있는 상위 수준을 나타냅니다.

9.5. 사용법

예를 들어 storageAccount 스토리지 계정의 대기열 메시지Queue 에서 메시지 콘텐츠를 가져오려면 다음 스니펫을 사용합니다.

from("azure-storage-queue://storageAccount/messageQueue?accessKey=yourAccessKey").
to("file://queuedirectory");

9.5.1. 구성 요소 프로듀서에서 평가한 메시지 헤더

header변수 이름유형작업설명

CamelAzureStorageQueueSegmentOptions

QueueConstants.QUEUES_SEGMENT_OPTIONS

QueuesSegmentOptions

listQueues

큐 나열 옵션

CamelAzureStorageQueueTimeout

QueueConstants.TIMEOUT

기간

All

\{@link RuntimeException}을 초과하는 선택적 타임아웃 값입니다.

CamelAzureStorageQueueMetadata

QueueConstants.METADATA

Map<String,String>

createQueue

큐와 연결할 메타데이터

CamelAzureStorageQueueTimeToLive

QueueConstants.TIME_TO_LIVE

기간

sendMessage

메시지가 큐에 유지되는 기간입니다. 설정되지 않으면 값이 7일로 설정되어 있으면 -1이 전달되면 메시지가 만료되지 않습니다. 이름은 -1 또는 양의 숫자여야 합니다.

CamelAzureStorageQueueVisibilityTimeout

QueueConstants.VISIBILITY_TIMEOUT

기간

sendMessage, receiveMessages, updateMessage

큐에서 메시지가 표시되지 않는 기간의 제한 시간입니다. 설정되지 않으면 기본값은 0으로 설정되고 메시지가 즉시 표시됩니다. 제한 시간은 0초에서 7일 사이여야 합니다.

CamelAzureStorageQueueCreateQueue

QueueConstants.CREATE_QUEUE

boolean

sendMessage

true 로 설정되면 메시지를 큐로 보낼 때 큐가 자동으로 생성됩니다.

CamelAzureStorageQueuePopReceipt

QueueConstants.POP_RECEIPT

문자열

deleteMessage, updateMessage

메시지 삭제 또는 업데이트와 일치해야 하는 고유 식별자입니다.

CamelAzureStorageQueueMessageId

QueueConstants.MESSAGE_ID

문자열

deleteMessage, updateMessage

삭제하거나 업데이트할 메시지의 ID입니다.

CamelAzureStorageQueueMaxMessages

QueueConstants.MAX_MESSAGES

정수

receiveMessages,peekMessages

요청된 모든 메시지보다 큐에 메시지가 있는 경우 가져올 최대 메시지 수가 반환됩니다. 비어 있는 메시지 1개만 검색하면 허용되는 범위는 1~32개의 메시지입니다.

CamelAzureStorageQueueOperation

QueueConstants.QUEUE_OPERATION

QueueOperationDefinition

All

실행할 생산자 작업을 지정합니다. 생산자 작업과 관련된 이 페이지의 문서를 참조하십시오.

CamelAzureStorageQueueName

QueueConstants.QUEUE_NAME

문자열

All

큐 이름을 재정의합니다.

9.5.2. 구성 요소 프로듀서 또는 소비자가 설정한 메시지 헤더

header변수 이름유형설명

CamelAzureStorageQueueMessageId

QueueConstants.MESSAGE_ID

문자열

큐로 전송되는 메시지의 ID입니다.

CamelAzureStorageQueueInsertionTime

QueueConstants.INSERTION_TIME

OffsetDateTime

Message가 Queue에 삽입된 시간입니다.

CamelAzureStorageQueueExpirationTime

QueueConstants.EXPIRATION_TIME

OffsetDateTime

메시지가 만료되고 자동으로 삭제되는 시간입니다.

CamelAzureStorageQueuePopReceipt

QueueConstants.POP_RECEIPT

문자열

이 값은 메시지를 삭제/업데이트하는 데 필요합니다. 이 팝업을 사용하여 삭제가 실패하면 다른 클라이언트가 메시지를 큐에 추가했습니다.

CamelAzureStorageQueueTimeNextVisible

QueueConstants.TIME_NEXT_VISIBLE

OffsetDateTime

메시지가 Queue에 다시 표시될 시간입니다.

CamelAzureStorageQueueDequeueCount

QueueConstants.DEQUEUE_COUNT

long

메시지가 큐에 없는 횟수입니다.

CamelAzureStorageQueueRawHttpHeaders

QueueConstants.RAW_HTTP_HEADERS

HttpHeaders

사용자가 사용할 수 있는 구문이 아닌 httpHeaders를 반환합니다.

9.5.3. 고급 Azure 스토리지 큐 구성

Camel 애플리케이션이 방화벽 뒤에서 실행 중이거나 QueueServiceClient 인스턴스 구성을 더 많이 제어해야 하는 경우 자체 인스턴스를 생성할 수 있습니다.

StorageSharedKeyCredential credential = new StorageSharedKeyCredential("yourAccountName", "yourAccessKey");
String uri = String.format("https://%s.queue.core.windows.net", "yourAccountName");

QueueServiceClient client = new QueueServiceClientBuilder()
                          .endpoint(uri)
                          .credential(credential)
                          .buildClient();
// This is camel context
context.getRegistry().bind("client", client);

그런 다음 Camel azure-storage-queue 구성 요소 구성에서 이 인스턴스를 참조합니다.

from("azure-storage-queue://cameldev/queue1?serviceClient=#client")
.to("file://outputFolder?fileName=output.txt&fileExist=Append");

9.5.4. 레지스트리에서 QueueServiceClient 클라이언트 자동 검색

이 구성 요소는 QueueServiceClient console이 레지스트리에 있는지 감지할 수 있습니다. 해당 유형의 유일한 인스턴스인 경우 이 인스턴스가 클라이언트로 사용되며 위의 예제와 같이 uri 매개변수로 정의할 필요가 없습니다. 이 기능은 끝점을 더 스마트하게 구성하는 데 매우 유용할 수 있습니다.

9.5.5. Azure Storage Queue Producer 작업

Camel Azure Storage Queue 구성 요소는 생산자 측에서 다양한 작업을 제공합니다.

서비스 수준에서의 작업

이러한 작업의 경우 accountName필요합니다.

작업설명

listQueues

지정된 마커부터 필터를 전달하는 스토리지 계정의 큐를 나열합니다.

큐 수준의 작업

이러한 작업의 경우 accountNamequeueName필요합니다.

작업설명

createQueue

새 큐를 생성합니다.

deleteQueue

큐를 영구적으로 삭제합니다.

clearQueue

큐의 모든 메시지를 삭제합니다.

sendMessage

Default Producer Operation 은 지정된 Time-to-Live 및 큐에서 메시지가 표시되지 않는 시간 초과 기간을 사용하여 메시지를 보냅니다. 메시지 텍스트는 교환 메시지 본문에서 평가됩니다. 기본적으로 큐가 없으면 먼저 빈 큐가 생성됩니다. 이 설정을 비활성화하려면 config createQueue 또는 header CamelAzureStorageQueueCreateQueuefalse 로 설정합니다.

deleteMessage

큐에서 지정된 메시지를 삭제합니다.

receiveMessages

대기열에서 최대 메시지 수를 검색하고 시간 초과 기간 동안 다른 작업에서 숨깁니다. 그러나 안정성 이유로 인해 큐에서 메시지를 큐에 추가하지 않습니다.

peekMessages

큐 앞에서 최대 메시지 수까지 메시지를 읽습니다.

updateMessage

큐의 특정 메시지를 새 메시지로 업데이트하고 가시성 타임아웃을 재설정합니다. 메시지 텍스트는 교환 메시지 본문에서 평가됩니다.

이러한 작업을 camel 애플리케이션에 사용하는 방법을 알아보려면 이 페이지의 예제 섹션을 참조하십시오.

9.5.6. 소비자 예

하나의 일괄 처리에서 최대 5개의 메시지가 있는 파일 구성 요소로 큐를 사용하려면 다음과 같이 수행할 수 있습니다.

from("azure-storage-queue://cameldev/queue1?serviceClient=#client&maxMessages=5")
.to("file://outputFolder?fileName=output.txt&fileExist=Append");

9.5.7. 생산자 작업 예

  • listQueues:
from("direct:start")
    .process(exchange -> {
      // set the header you want the producer to evaluate, refer to the previous
      // section to learn about the headers that can be set
      // e.g, to only returns list of queues with 'awesome' prefix:
      exchange.getIn().setHeader(QueueConstants.QUEUES_SEGMENT_OPTIONS, new QueuesSegmentOptions().setPrefix("awesome"));
     })
    .to("azure-storage-queue://cameldev?serviceClient=#client&operation=listQueues")
    .log("${body}")
    .to("mock:result");
  • createQueue:
from("direct:start")
    .process(exchange -> {
      // set the header you want the producer to evaluate, refer to the previous
      // section to learn about the headers that can be set
      // e.g:
      exchange.getIn().setHeader(QueueConstants.QUEUE_NAME, "overrideName");
     })
    .to("azure-storage-queue://cameldev/test?serviceClient=#client&operation=createQueue");
  • deleteQueue:
from("direct:start")
    .process(exchange -> {
      // set the header you want the producer to evaluate, refer to the previous
      // section to learn about the headers that can be set
      // e.g:
      exchange.getIn().setHeader(QueueConstants.QUEUE_NAME, "overrideName");
     })
    .to("azure-storage-queue://cameldev/test?serviceClient=#client&operation=deleteQueue");
  • clearQueue:
from("direct:start")
    .process(exchange -> {
      // set the header you want the producer to evaluate, refer to the previous
      // section to learn about the headers that can be set
      // e.g:
      exchange.getIn().setHeader(QueueConstants.QUEUE_NAME, "overrideName");
     })
    .to("azure-storage-queue://cameldev/test?serviceClient=#client&operation=clearQueue");
  • sendMessage:
from("direct:start")
    .process(exchange -> {
      // set the header you want the producer to evaluate, refer to the previous
      // section to learn about the headers that can be set
      // e.g:
      exchange.getIn().setBody("message to send");
      // we set a visibility of 1min
      exchange.getIn().setHeader(QueueConstants.VISIBILITY_TIMEOUT, Duration.ofMinutes(1));
     })
    .to("azure-storage-queue://cameldev/test?serviceClient=#client");
  • deleteMessage:
from("direct:start")
    .process(exchange -> {
      // set the header you want the producer to evaluate, refer to the previous
      // section to learn about the headers that can be set
      // e.g:
      // Mandatory header:
      exchange.getIn().setHeader(QueueConstants.MESSAGE_ID, "1");
      // Mandatory header:
      exchange.getIn().setHeader(QueueConstants.POP_RECEIPT, "PAAAAHEEERXXX-1");
     })
    .to("azure-storage-queue://cameldev/test?serviceClient=#client&operation=deleteMessage");
  • receiveMessages:
from("direct:start")
    .to("azure-storage-queue://cameldev/test?serviceClient=#client&operation=receiveMessages")
    .process(exchange -> {
        final List<QueueMessageItem> messageItems = exchange.getMessage().getBody(List.class);
        messageItems.forEach(messageItem -> System.out.println(messageItem.getMessageText()));
    })
   .to("mock:result");
  • peekMessages:
from("direct:start")
    .to("azure-storage-queue://cameldev/test?serviceClient=#client&operation=peekMessages")
    .process(exchange -> {
        final List<PeekedMessageItem> messageItems = exchange.getMessage().getBody(List.class);
        messageItems.forEach(messageItem -> System.out.println(messageItem.getMessageText()));
    })
   .to("mock:result");
  • updateMessage:
from("direct:start")
   .process(exchange -> {
       // set the header you want the producer to evaluate, refer to the previous
       // section to learn about the headers that can be set
       // e.g:
       exchange.getIn().setBody("new message text");
       // Mandatory header:
       exchange.getIn().setHeader(QueueConstants.MESSAGE_ID, "1");
       // Mandatory header:
       exchange.getIn().setHeader(QueueConstants.POP_RECEIPT, "PAAAAHEEERXXX-1");
       // Mandatory header:
       exchange.getIn().setHeader(QueueConstants.VISIBILITY_TIMEOUT, Duration.ofMinutes(1));
    })
    .to("azure-storage-queue://cameldev/test?serviceClient=#client&operation=updateMessage");

9.5.8. 개발 노트(Important)

이 구성 요소를 개발할 때 통합 테스트를 실행하려면 Azure accessKey를 가져와야 합니다. Azure 클라이언트가 마이너 버전 업그레이드에서도 문제를 해결할 수 있으므로 모든 변경 사항을 사용하여 통합 테스트를 실행해야 합니다.In addition to the mocked unit tests you will need to run the integration tests with every change you make or even client upgrade as the Azure client can break things even on minor versions upgrade. 통합 테스트를 실행하려면 이 구성 요소 디렉터리에서 다음 maven 명령을 실행합니다.

mvn verify -PfullTests -DaccountName=myacc -DaccessKey=mykey

accountName 은 Azure 계정 이름이고 accessKey 는 Azure Portal에서 생성되는 액세스 키입니다.

9.6. Spring Boot Auto-Configuration

Spring Boot와 함께 azure-storage-queue를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-azure-storage-queue-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.azure-storage-queue.access-key

Azure 대기열 서비스를 사용한 인증에 사용할 연결된 azure 계정 이름에 대한 액세스 키입니다.

 

문자열

camel.component.azure-storage-queue.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.azure-storage-queue.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.azure-storage-queue.configuration

구성 요소 구성 요소입니다. 옵션은 org.apache.camel.component.azure.storage.queue.QueueConfiguration 유형입니다.

 

QueueConfiguration

camel.component.azure-storage-queue.create-queue

가 true로 설정되면 메시지를 큐로 보낼 때 큐가 자동으로 생성됩니다.

false

부울

camel.component.azure-storage-queue.credentials

StorageSharedKeyCredential를 삽입하여 azure 클라이언트를 만들 수 있습니다. 이에는 중요한 인증 정보가 들어 있습니다. 옵션은 com.azure.storage.common.StorageSharedKeyCredential 유형입니다.

 

StorageSharedKeyCredential

camel.component.azure-storage-queue.enabled

azure-storage-queue 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.azure-storage-queue.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.azure-storage-queue.max-messages

요청된 모든 메시지보다 큐에 메시지가 있는 경우 가져올 최대 메시지 수가 반환됩니다. 비어 있는 메시지 1개만 검색하면 허용되는 범위는 1~32개의 메시지입니다.

1

정수

camel.component.azure-storage-queue.message-id

삭제하거나 업데이트할 메시지의 ID입니다.

 

문자열

camel.component.azure-storage-queue.operation

생산자에 대한 서비스 작업 힌트를 대기열에 넣습니다.

 

QueueOperationDefinition

camel.component.azure-storage-queue.pop-receipt

메시지 삭제 또는 업데이트와 일치해야 하는 고유 식별자입니다.

 

문자열

camel.component.azure-storage-queue.service-client

큐 서비스와 상호 작용하기 위해 스토리지 계정에 대한 서비스 클라이언트입니다. 이 클라이언트는 특정 스토리지 계정에 대한 상태를 유지하지 않지만 대신 서비스의 리소스에 적절한 요청을 보내는 편리한 방법입니다. 이 클라이언트에는 Azure Storage에서 큐 계정과 상호 작용하는 모든 작업이 포함되어 있습니다. 클라이언트에서 허용하는 작업은 큐를 생성, 나열 및 삭제하고 계정의 속성을 검색 및 업데이트하고 계정의 통계를 검색하는 것입니다. 옵션은 com.azure.storage.queue.QueueServiceClient 유형입니다.

 

QueueServiceClient

camel.component.azure-storage-queue.time-to-live

메시지가 큐에 유지되는 기간입니다. 설정되지 않으면 값이 7일로 설정되어 있으면 -1이 전달되면 메시지가 만료되지 않습니다. 이름은 -1 또는 양의 숫자여야 합니다. 형식은 다음과 같은 형식이어야 합니다: PnDTnHn.nS. 예를 들면 PT20.345S간마크로 20.345초, P2DECDHE-ECDHEparses를 2 일로 사용하지만, EndpointDsl/ComponentDsl을 사용하는 경우에는 EndpointDsl/ComponentDsl과 같은 작업을 수행할 수 있습니다. 옵션은 java.time.Duration 유형입니다.

 

기간

camel.component.azure-storage-queue.timeout

작업에 적용되는 선택적 제한 시간입니다. 시간 초과가 종료되기 전에 응답이 반환되지 않으면 RuntimeException이 발생합니다. 옵션은 java.time.Duration 유형입니다.

 

기간

camel.component.azure-storage-queue.visibility-timeout

큐에서 메시지가 표시되지 않는 기간의 제한 시간입니다. 제한 시간은 1초에서 7일 사이여야 합니다. 형식은 다음과 같은 형식이어야 합니다: PnDTnHn.nS. 예를 들면 PT20.345S간마크로 20.345초, P2DECDHE-ECDHEparses를 2 일로 사용하지만, EndpointDsl/ComponentDsl을 사용하는 경우에는 EndpointDsl/ComponentDsl과 같은 작업을 수행할 수 있습니다. 옵션은 java.time.Duration 유형입니다.

 

기간

10장. console

프로듀서만 지원됩니다.

CloudEvent 구성 요소는 빈을 Camel 메시지 교환에 바인딩합니다.

10.1. URI 형식

bean:beanName[?options]

여기서 consoleID는 레지스트리에서 빈 을 검색하는 데 사용되는 모든 문자열이 될 수 있습니다.

10.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

10.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

10.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

10.3. 구성 요소 옵션

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

이름설명Default유형

cache (producer)

더 이상 사용되지 않는 singleton 옵션 사용.

true

부울

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

범위 (producer)

console의 범위입니다. singleton 범위(기본값)를 사용하는 경우 빈은 한 번만 생성되거나 조회되며 엔드포인트의 수명 동안 재사용됩니다. 동시 스레드가 cluster를 동시에 호출하는 경우 빈이 스레드로부터 안전해야 합니다. 요청 범위를 사용할 때 빈은 요청당 한 번 생성되거나(예:) 조회됩니다. 요청을 처리하는 동안 빈에 상태를 저장하려는 경우 사용할 수 있으며 요청을 처리하는 동안 동일한 balloon 인스턴스를 여러 번 호출하려는 경우 사용할 수 있습니다. console은 인스턴스가 동일한 요청에서만 호출되므로 스레드로부터 안전할 필요가 없습니다. 위임 범위를 사용하면 호출별로 빈이 검색되거나 생성됩니다. 그러나 조회의 경우 Spring 또는 CDI(사용 중인 경우)와 같은 console 레지스트리에 위임됩니다. 이러한 레지스트리에 위임은 구성에 따라 singleton 또는 typetype 범위로 작동할 수 있으므로type을 사용할 때 위임된 레지스트리에 따라 달라집니다.

CloudEvent 값:

  • singleton
  • 요청
  • 프로토 타입

singleton

BeanScope

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

10.4. 끝점 옵션

CloudEvent 엔드포인트는 URI 구문을 사용하여 구성됩니다.

bean:beanName

다음과 같은 경로 및 쿼리 매개변수 사용:

10.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

clusterlanName (common)

호출할 빈의 이름을 설정합니다.

 

문자열

10.4.2. 쿼리 매개 변수 (5 매개변수)

이름설명Default유형

캐시 (공용)

대신 사용 범위 옵션을 사용하지 않습니다.

 

부울

방법 (공용)

빈에서 호출할 메서드의 이름을 설정합니다.

 

문자열

범위 (공용)

console의 범위입니다. singleton 범위(기본값)를 사용하는 경우 빈은 한 번만 생성되거나 조회되며 엔드포인트의 수명 동안 재사용됩니다. 동시 스레드가 cluster를 동시에 호출하는 경우 빈이 스레드로부터 안전해야 합니다. 요청 범위를 사용할 때 빈은 요청당 한 번 생성되거나(예:) 조회됩니다. 요청을 처리하는 동안 빈에 상태를 저장하려는 경우 사용할 수 있으며 요청을 처리하는 동안 동일한 balloon 인스턴스를 여러 번 호출하려는 경우 사용할 수 있습니다. console은 인스턴스가 동일한 요청에서만 호출되므로 스레드로부터 안전할 필요가 없습니다. 승격 범위를 사용하면 호출별로 빈이 검색되거나 생성됩니다. 그러나 조회의 경우 Spring 또는 CDI(사용 중인 경우)와 같은 console 레지스트리에 위임됩니다. 이러한 레지스트리에 위임은 구성에 따라 singleton 또는 typetype 범위로 작동할 수 있으므로type을 사용할 때 위임된 레지스트리에 따라 달라집니다.

CloudEvent 값:

  • singleton
  • 요청
  • 프로토 타입

singleton

BeanScope

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

매개변수 (advanced)

빈에서 추가 속성을 구성하는 데 사용됩니다.

 

map

10.5. 사용

메시지를 사용하는 데 사용되는 오브젝트 인스턴스는 레지스트리에 명시적으로 등록되어 있어야 합니다. 예를 들어 Spring을 사용하는 경우 Spring 구성 XML 파일에 빈을 정의해야 합니다.

바인딩 방법을 사용하여 Camel의 레지스트리 를 통해 수동으로 빈을 등록할 수도 있습니다.

엔드 포인트가 등록되면 이를 사용하여 교환을 처리하는 Camel 경로를 구축할 수 있습니다.

빈: 엔드포인트는 경로에 대한 입력으로 정의할 수 없습니다. 즉, 해당 엔드포인트에서 사용할 수 없으며 일부 인바운드 메시지 끝점에서 출력으로만 라우팅할 수 있습니다. 따라서 직접: 또는 큐: 끝점을 입력으로 사용하는 것이 좋습니다.

Proxy>-< er에서 createProxy () 메서드를 사용하여 exchange를 생성하여 임의의 끝점으로 보낼 프록시를 만들 수 있습니다.

XML DSL을 사용하는 것과 동일한 경로:

<route>
   <from uri="direct:hello"/>
   <to uri="bean:bye"/>
</route>

10.6. 빈을 끝점으로 사용

Camel은 또한 endpoint로 module 호출을 지원합니다. 교환이 myBean Camel로 라우팅될 때 kubeconfig 바인딩을 사용하여 빈을 호출하는 것입니다. 빈의 소스는 일반 명령일 뿐입니다.

Camel은 Exchange의 In body를 String 유형으로 변환하고 Exchange Out 본문에 메서드 출력을 저장하여 sayHello 메서드를 호출합니다.

10.7. Java DSL console 구문

Java DSL에는 구성 요소에 대한 syntactic sugar가 포함되어 있습니다. 빈을 끝점으로 명시적으로 지정하는 대신 다음 구문을 사용할 수 있습니다.

// Send message to the bean endpoint
// and invoke method resolved using Bean Binding.
from("direct:start").bean("beanName");

// Send message to the bean endpoint
// and invoke given method.
from("direct:start").bean("beanName", "methodName");

console에 대한 참조 이름을 전달하는 대신, Camel이 레지스트리에서 조회할 수 있도록 해당 참조 자체를 지정할 수 있습니다.

// Send message to the given bean instance.
from("direct:start").bean(new ExampleBean());

// Explicit selection of bean method to be invoked.
from("direct:start").bean(new ExampleBean(), "methodName");

// Camel will create the instance of bean and cache it for you.
from("direct:start").bean(ExampleBean.class);

10.8. triggerlan Binding

호출할 빈 메서드가 선택되는 방법( method 매개 변수를 통해 명시적으로 지정되지 않은 경우) 및 Message에서 매개 변수 값을 구성하는 방법은 Camel의 모든 다양한 InstallPlan 통합 메커니즘에서 사용되는 CloudEvent 바인딩 메커니즘에 의해 정의되는 방법입니다.

10.9. Spring Boot Auto-Configuration

Spring Boot와 함께 빈을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-bean-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- use the same version as your Camel core version -->
</dependency>

구성 요소는 아래에 나열된 13개의 옵션을 지원합니다.

이름설명Default유형

camel.component.bean.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.bean.enabled

빈 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.bean.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.bean.scope

console의 범위입니다. singleton 범위(기본값)를 사용하는 경우 빈은 한 번만 생성되거나 조회되며 엔드포인트의 수명 동안 재사용됩니다. 동시 스레드가 cluster를 동시에 호출하는 경우 빈이 스레드로부터 안전해야 합니다. 요청 범위를 사용할 때 빈은 요청당 한 번 생성되거나(예:) 조회됩니다. 요청을 처리하는 동안 빈에 상태를 저장하려는 경우 사용할 수 있으며 요청을 처리하는 동안 동일한 balloon 인스턴스를 여러 번 호출하려는 경우 사용할 수 있습니다. console은 인스턴스가 동일한 요청에서만 호출되므로 스레드로부터 안전할 필요가 없습니다. 위임 범위를 사용하면 호출별로 빈이 검색되거나 생성됩니다. 그러나 조회의 경우 Spring 또는 CDI(사용 중인 경우)와 같은 console 레지스트리에 위임됩니다. 이러한 레지스트리에 위임은 구성에 따라 singleton 또는 typetype 범위로 작동할 수 있으므로type을 사용할 때 위임된 레지스트리에 따라 달라집니다.

 

BeanScope

camel.component.class.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.class.enabled

클래스 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.class.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.class.scope

console의 범위입니다. singleton 범위(기본값)를 사용하는 경우 빈은 한 번만 생성되거나 조회되며 엔드포인트의 수명 동안 재사용됩니다. 동시 스레드가 cluster를 동시에 호출하는 경우 빈이 스레드로부터 안전해야 합니다. 요청 범위를 사용할 때 빈은 요청당 한 번 생성되거나(예:) 조회됩니다. 요청을 처리하는 동안 빈에 상태를 저장하려는 경우 사용할 수 있으며 요청을 처리하는 동안 동일한 balloon 인스턴스를 여러 번 호출하려는 경우 사용할 수 있습니다. console은 인스턴스가 동일한 요청에서만 호출되므로 스레드로부터 안전할 필요가 없습니다. 위임 범위를 사용하면 호출별로 빈이 검색되거나 생성됩니다. 그러나 조회의 경우 Spring 또는 CDI(사용 중인 경우)와 같은 console 레지스트리에 위임됩니다. 이러한 레지스트리에 위임은 구성에 따라 singleton 또는 typetype 범위로 작동할 수 있으므로type을 사용할 때 위임된 레지스트리에 따라 달라집니다.

 

BeanScope

camel.language.bean.enabled

빈 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.bean.scope

console의 범위입니다. singleton 범위(기본값)를 사용하는 경우 빈은 한 번만 생성되거나 조회되며 엔드포인트의 수명 동안 재사용됩니다. 동시 스레드가 cluster를 동시에 호출하는 경우 빈이 스레드로부터 안전해야 합니다. 요청 범위를 사용할 때 빈은 요청당 한 번 생성되거나(예:) 조회됩니다. 요청을 처리하는 동안 빈에 상태를 저장하려는 경우 사용할 수 있으며 요청을 처리하는 동안 동일한 balloon 인스턴스를 여러 번 호출하려는 경우 사용할 수 있습니다. console은 인스턴스가 동일한 요청에서만 호출되므로 스레드로부터 안전할 필요가 없습니다. 승격 범위를 사용하면 호출별로 빈이 검색되거나 생성됩니다. 그러나 조회의 경우 Spring 또는 CDI(사용 중인 경우)와 같은 Citadel 레지스트리에 위임됩니다. 이 레지스트리에는 구성에 따라 singleton 또는 typetype 범위로 작동할 수 있습니다. 따라서 시제품 범위를 사용할 때 이 값은 빈 레지스트리 구현에 따라 달라집니다.

singleton

문자열

camel.language.bean.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.component.bean.cache

더 이상 사용되지 않는 singleton 옵션 사용.

true

부울

camel.component.class.cache

더 이상 사용되지 않는 singleton 옵션 사용.

true

부울

11장. apprun Validator

프로듀서만 지원됩니다.

Validator 구성 요소는 Java validator Validation API()를 사용하여 메시지 본문의 빈 유효성 검사를 수행합니다. Camel은 LABEL Validator 인 참조 구현을 사용합니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-bean-validator</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

11.1. URI 형식

bean-validator:label[?options]

여기서 레이블 은 끝점을 설명하는 임의의 텍스트 값입니다. 다음 형식의 URI에 쿼리 옵션을 추가할 수 있습니다.

?option=value&option=value&…​

11.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

11.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

11.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

11.3. 구성 요소 옵션

ScanSetting Validator 구성 요소는 아래에 나열된 8 옵션을 지원합니다.

이름설명Default유형

ignoreConfiguration (producer)

META-INF/validation.xml 파일의 데이터를 무시할지 여부입니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

constraintValidatorFactory (advanced)

사용자 정의 ConstraintValidatorFactory를 사용하려면 다음을 수행합니다.

 

ConstraintValidatorFactory

messageInterpolator (advanced)

사용자 지정 MessageInterpolator를 사용하려면 다음을 수행합니다.

 

MessageInterpolator

traversableResolver (advanced)

사용자 정의 TraversableResolver를 사용합니다.

 

TraversableResolver

validationProviderResolver (advanced)

사용자 지정 ValidationProviderResolver를 사용하려면 다음을 수행합니다.

 

ValidationProviderResolver

ValidatorFactory (advanced)

Autowired 사용자 정의 ValidatorFactory를 사용합니다.

 

ValidatorFactory

11.4. 끝점 옵션

CloudEvent Validator 끝점은 URI 구문을 사용하여 구성됩니다.

bean-validator:label

다음과 같은 경로 및 쿼리 매개변수 사용:

11.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

레이블 (producer)

필수 레이블은 끝점을 설명하는 임의의 텍스트 값입니다.

 

문자열

11.4.2. 쿼리 매개변수 (8 매개변수)

이름설명Default유형

그룹 (producer)

사용자 정의 검증 그룹을 사용하려면 다음을 수행합니다.

javax.validation.groups.Default

문자열

ignoreConfiguration (producer)

META-INF/validation.xml 파일의 데이터를 무시할지 여부입니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

constraintValidatorFactory (advanced)

사용자 정의 ConstraintValidatorFactory를 사용하려면 다음을 수행합니다.

 

ConstraintValidatorFactory

messageInterpolator (advanced)

사용자 지정 MessageInterpolator를 사용하려면 다음을 수행합니다.

 

MessageInterpolator

traversableResolver (advanced)

사용자 정의 TraversableResolver를 사용합니다.

 

TraversableResolver

validationProviderResolver (advanced)

사용자 지정 ValidationProviderResolver를 사용하려면 다음을 수행합니다.

 

ValidationProviderResolver

ValidatorFactory (advanced)

사용자 정의 ValidatorFactory를 사용합니다.

 

ValidatorFactory

11.5. OSGi 배포

OSGi 환경에서 iPXE Validator를 사용하려면 org.apache.camel.component.component.ovn.validator.HibernateValidationProviderResolver와 마찬가지로 전용 ValidationProviderResolver 구현을 사용합니다. 아래 스니펫에서는 이러한 접근 방식을 보여줍니다. downloaded ValidationProviderResolver 를 사용할 수도 있습니다.

Using HibernateValidationProviderResolver

from("direct:test").
  to("bean-validator://ValidationProviderResolverTest?validationProviderResolver=#myValidationProviderResolver");

<bean id="myValidationProviderResolver" class="org.apache.camel.component.bean.validator.HibernateValidationProviderResolver"/>

사용자 정의 ValidationProviderResolver 가 정의되어 있지 않고 유효성 검사기 구성 요소가 OSGi 환경에 배포된 경우 iPXE ValidationProviderResolver 가 자동으로 사용됩니다.

11.6. 예제

다음 주석이 있는 Java 빈이 있다고 가정합니다.

Car.java

public class Car {

    @NotNull
    private String manufacturer;

    @NotNull
    @Size(min = 5, max = 14, groups = OptionalChecks.class)
    private String licensePlate;

    // getter and setter
}

사용자 정의 검증 그룹에 대한 인터페이스 정의

OptionalChecks.java

public interface OptionalChecks {
}

다음 Camel 경로에서는 제조업체 및 라이센스Plate 속성에 대한 @NotNull 제약 조건만 검증됩니다(기본 그룹 javax.validation.groups.Default사용).

from("direct:start")
.to("bean-validator://x")
.to("mock:end")

OptionalChecks 그룹에서 제약 조건을 확인하려면 다음과 같이 경로를 정의해야 합니다.

from("direct:start")
.to("bean-validator://x?group=OptionalChecks")
.to("mock:end")

두 그룹의 제약 조건을 확인하려면 먼저 새 인터페이스를 정의해야 합니다.

AllChecks.java

@GroupSequence({Default.class, OptionalChecks.class})
public interface AllChecks {
}

그런 다음 경로 정의가 다음과 같이 표시됩니다.

from("direct:start")
.to("bean-validator://x?group=AllChecks")
.to("mock:end")

그리고 자체 메시지 인터폴레이터, 트래버스 가능한 해결자 및 제약 조건 검증기 팩토리를 제공해야 하는 경우 다음과 같은 경로를 작성해야 합니다.

<bean id="myMessageInterpolator" class="my.ConstraintValidatorFactory" />
<bean id="myTraversableResolver" class="my.TraversableResolver" />
<bean id="myConstraintValidatorFactory" class="my.ConstraintValidatorFactory" />
from("direct:start")
.to("bean-validator://x?group=AllChecks&messageInterpolator=#myMessageInterpolator
&traversableResolver=#myTraversableResolver&constraintValidatorFactory=#myConstraintValidatorFactory")
.to("mock:end")

또한 제약 조건을 Java 주석이 아닌 XML로 설명할 수 있습니다. 이 경우 다음과 같이 META-INF/validation.xml 파일을 제공해야 합니다.

validation.xml

<validation-config
    xmlns="http://jboss.org/xml/ns/javax/validation/configuration"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://jboss.org/xml/ns/javax/validation/configuration">

    <default-provider>org.hibernate.validator.HibernateValidator</default-provider>
    <message-interpolator>org.hibernate.validator.engine.ResourceBundleMessageInterpolator</message-interpolator>
    <traversable-resolver>org.hibernate.validator.engine.resolver.DefaultTraversableResolver</traversable-resolver>
    <constraint-validator-factory>org.hibernate.validator.engine.ConstraintValidatorFactoryImpl</constraint-validator-factory>
    <constraint-mapping>/constraints-car.xml</constraint-mapping>

</validation-config>

constraints-car.xml 파일

constraints-car.xml

<constraint-mappings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://jboss.org/xml/ns/javax/validation/mapping validation-mapping-1.0.xsd"
    xmlns="http://jboss.org/xml/ns/javax/validation/mapping">

    <default-package>org.apache.camel.component.bean.validator</default-package>

    <bean class="CarWithoutAnnotations" ignore-annotations="true">
        <field name="manufacturer">
            <constraint annotation="javax.validation.constraints.NotNull" />
        </field>

        <field name="licensePlate">
            <constraint annotation="javax.validation.constraints.NotNull" />

            <constraint annotation="javax.validation.constraints.Size">
                <groups>
                    <value>org.apache.camel.component.bean.validator.OptionalChecks</value>
                </groups>
                <element name="min">5</element>
                <element name="max">14</element>
            </constraint>
        </field>
    </bean>
</constraint-mappings>

OrderedChecks 에 대한 예제 경로 정의의 XML 구문은 다음과 같습니다.

본문에는 검증할 클래스의 인스턴스가 포함되어야 합니다.

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
    http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
    http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd">

    <camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
        <route>
            <from uri="direct:start"/>
            <to uri="bean-validator://x?group=org.apache.camel.component.bean.validator.OrderedChecks"/>
        </route>
    </camelContext>
</beans>

11.7. Spring Boot Auto-Configuration

Spring Boot와 함께 console-validator를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-bean-validator-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.bean-validator.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.bean-validator.constraint-validator-factory

사용자 정의 ConstraintValidatorFactory를 사용하려면 다음을 수행합니다. 옵션은 javax.validation.ConstraintValidatorFactory 유형입니다.

 

ConstraintValidatorFactory

camel.component.bean-validator.enabled

balloon-validator 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.bean-validator.ignore-xml-configuration

META-INF/validation.xml 파일의 데이터를 무시할지 여부입니다.

false

부울

camel.component.bean-validator.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.bean-validator.message-interpolator

사용자 지정 MessageInterpolator를 사용하려면 다음을 수행합니다. 옵션은 javax.validation.MessageInterpolator 유형입니다.

 

MessageInterpolator

camel.component.bean-validator.traversable-resolver

사용자 정의 TraversableResolver를 사용합니다. 옵션은 javax.validation.TraversableResolver 유형입니다.

 

TraversableResolver

camel.component.bean-validator.validation-provider-resolver

사용자 지정 ValidationProviderResolver를 사용하려면 다음을 수행합니다. 옵션은 javax.validation.ValidationProviderResolver 유형입니다.

 

ValidationProviderResolver

camel.component.bean-validator.validator-factory

사용자 정의 ValidatorFactory를 사용합니다. 옵션은 javax.validation.ValidatorFactory 유형입니다.

 

ValidatorFactory

12장. 찾아보기

생산자 및 소비자 모두 지원

Browse 구성 요소는 테스트, 시각화화 도구 또는 디버깅에 유용할 수 있는 간단한 BrowsableEndpoint를 제공합니다. 엔드 포인트로 전송되는 교환은 모두 찾아보실 수 있습니다.

12.1. URI 형식

browse:someName[?options]

여기서 someName 은 끝점을 고유하게 식별하는 문자열일 수 있습니다.

12.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

12.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

12.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

12.3. 구성 요소 옵션

찾아보기 구성 요소는 아래에 나열된 세 가지 옵션을 지원합니다.

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

12.4. 끝점 옵션

Browse 엔드포인트는 URI 구문을 사용하여 구성됩니다.

browse:name

다음과 같은 경로 및 쿼리 매개변수 사용:

12.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

이름 (common)

필수: 끝점을 고유하게 식별하는 문자열일 수 있는 이름입니다.

 

문자열

12.4.2. 쿼리 매개변수 (4 매개변수)

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

12.5. sample

아래 경로에서 찾아보기를 삽입하여 전달되는 교환을 검색할 수 있도록 구성 요소를 삽입합니다.In the route below, we insert a browse: component to be able to browse the Exchanges that are passed through:

from("activemq:order.in").to("browse:orderReceived").to("bean:processOrder");

이제 Java 코드 내에서 수신된 교환을 검사할 수 있습니다.

private CamelContext context;

public void inspectReceivedOrders() {
    BrowsableEndpoint browse = context.getEndpoint("browse:orderReceived", BrowsableEndpoint.class);
    List<Exchange> exchanges = browse.getExchanges();

    // then we can inspect the list of received exchanges from Java
    for (Exchange exchange : exchanges) {
        String payload = exchange.getIn().getBody();
        // do something with payload
    }
}

12.6. Spring Boot Auto-Configuration

Spring Boot로 검색하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-browse-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.browse.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.browse.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.browse.enabled

찾아보기 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.browse.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

13장. Cassandra CQL

생산자 및 소비자 모두 지원

ApacheECDHE 는 상용 하드웨어에서 대량의 용량을 처리하도록 설계된 오픈 소스 NoSQL 데이터베이스입니다. Amazon의 10.0.0.1과 마찬가지로, CloudEvent는 단일 장애 지점과 고 가용성을 피하기 위해 피어 투 피어 및 마스터리스 아키텍처를 보유하고 있습니다. Google의 BigTable과 마찬가지로 CloudEvent 데이터는 Thrift RPC API 또는 CQL이라는 SQL 유사 API를 통해 액세스할 수 있는 열 제품군을 사용하여 구조화됩니다.

참고

이 구성 요소는 Thrift API가 아닌 CQL3 API를 사용하여 CloudEvent 2.0+를 통합하는 것을 목표로 합니다. DataStax에서 제공하는 CloudEvent Java 드라이버 를 기반으로 합니다.

13.1. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

13.1.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

13.1.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

13.2. 구성 요소 옵션

gRPC CQL 구성 요소는 아래에 나열된 세 가지 옵션을 지원합니다.

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

13.3. 끝점 옵션

ECDHE CQL 끝점은 URI 구문을 사용하여 구성됩니다.

cql:beanRef:hosts:port/keyspace

다음과 같은 경로 및 쿼리 매개변수 사용:

13.3.1. 경로 매개변수 (4 매개변수)

이름설명Default유형

clusterlanRef (공용)

blankRef는 빈:id를 사용하여 정의합니다.

 

문자열

호스트 (공용)

hostname 서버. 여러 호스트를 쉼표로 분리할 수 있습니다.

 

문자열

포트 (공용)

CloudEvent 서버의 포트 번호.

 

정수

keyspace (common)

사용할 키 공간입니다.

 

문자열

13.3.2. 쿼리 매개변수(30 매개변수)

이름설명Default유형

clustername (common)

클러스터 이름.

 

문자열

consistencyLevel (common)

사용할 일관성 수준.

CloudEvent 값:

  • ANY
  • ONE
  • TWO
  • THREE
  • QUORUM
  • ALL
  • LOCAL_ONE
  • LOCAL_QUORUM
  • EACH_QUORUM
  • SERIAL
  • LOCAL_SERIAL
 

DefaultConsistencyLevel

C QL (common)

실행할 CQL 쿼리입니다. 메시지 헤더로 CamelCqlQuery 키를 사용하여 재정의할 수 있습니다.

 

문자열

데이터 센터 (공용)

사용할 데이터 센터입니다.

datacenter1

문자열

LoadBalancingPolicyClass (common)

특정 LoadBalancingPolicyClass를 사용하려면 다음을 수행합니다.

 

문자열

암호 (common)

세션 인증의 암호입니다.

 

문자열

prepareStatements (common)

준비 상태 또는 일반 명령문을 사용할지 여부입니다.

true

boolean

resultSetConversionStrategy (common)

ResultSet을 메시지 본문 ALL, ONE, LIMIT_10, LIMIT_100.​로 변환하는 논리를 구현하는 사용자 지정 클래스를 사용하려면 다음을 수행합니다.

 

ResultSetConversionStrategy

세션 (공용)

Session 인스턴스를 사용하려면 (일반적으로 이 옵션을 사용하지 않습니다).

 

CqlSession

사용자 이름 (common)

세션 인증의 사용자 이름입니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

13.4. 끝점 연결 구문

끝점은 CloudEvent 연결을 시작하거나 기존 연결을 사용할 수 있습니다.

URI설명

cql:localhost/keyspace

단일 호스트, 기본 포트, 일반적으로 테스트용 단일 호스트, 기본 포트

cql:host1,host2/keyspace

멀티 호스트, 기본 포트

cql:host1,host2:9042/keyspace

멀티 호스트, 사용자 정의 포트

cql:host1,host2

기본 포트 및 키 공간

cql:bean:sessionRef

제공된 세션 참조

cql:bean:clusterRef/keyspace

제공된 클러스터 참조

CloudEvent 연결(SSL 옵션, 풀 밸런싱 정책, 재시도 정책, 재연결 정책…​)을 미세 조정하려면 자체 클러스터 인스턴스를 생성하고 Camel 엔드포인트에 제공합니다.

13.5. 메시지

13.5.1. 수신 메시지

CamelECDHE 엔드포인트에는 쿼리 매개변수로 CQL문에 바인딩되는 간단한 오브젝트(오브젝 또는 Object [] 또는 Collection<Object> )가 많이 필요합니다. 메시지 본문이 null 또는 비어 있으면 바인딩 매개 변수 없이 CQL 쿼리가 실행됩니다.

headers

  • CamelCqlQuery (선택 사항, 문자열 또는 RegularStatement)

    CQL 쿼리는 일반 문자열로 쿼리하거나 QueryBuilder 를 사용하여 빌드됩니다.

13.5.2. 발신 메시지

CamelECDHE 엔드포인트는 resultSetConversionStrategy 에 따라 하나 이상의 Row 개체를 생성합니다.

  • resultSetConversionStrategyALL 또는 LIMIT_[0-9]+인 경우 list<Row >
  • single' Row' resultSetConversionStrategyone인 경우
  • 다른 모든 항목, resultSetConversionStrategyResultSetConversionStrategy의 사용자 정의 구현입니다.

13.6. 리포지토리

CloudEvent는 idempotent 및 집계 EIP에 대한 메시지 키 또는 메시지를 저장하는 데 사용할 수 있습니다.

still be the best tool for queuing use cases yet, readECDHE anti-patterns queue and queue such as SSDT .NET Framework 사용 사례 큐 및 큐와 같은 대기열 을 읽는 것이 가장 좋은 도구가 아닐 수 있습니다. 이러한 테이블에 LeveledCompaction 및 작은 GC 유예 설정을 사용하여 tombstoned 행을 신속하게 제거할 수 있습니다.

13.7. idempotent 리포지토리

NamedCassandraIdempotentRepository 는 다음과 같이 table에 메시지 키를 저장합니다.

CAMEL_IDEMPOTENT.cql

CREATE TABLE CAMEL_IDEMPOTENT (
  NAME varchar,   -- Repository name
  KEY varchar,    -- Message key
  PRIMARY KEY (NAME, KEY)
) WITH compaction = {'class':'LeveledCompactionStrategy'}
  AND gc_grace_seconds = 86400;

이 리포지토리 구현에서는 경량 트랜잭션(Compare and Set라고도 함)을 사용하며, Memcached 2.0.7 이상이 필요합니다.

또는 CloudEvent IdempotentRepository 에는 NAME 열이 없으며 다른 데이터 모델을 사용하도록 확장할 수 있습니다.

옵션Default설명

table

CAMEL_IDEMPOTENT

테이블 이름

pkColumns

NAME,' KEY'

기본 키 열

name

 

리포지토리 이름, NAME 열에 사용되는 값

ttl

 

사용할 수 있는 주요 시간

writeConsistencyLevel

 

키 삽입/삭제에 사용되는 일관성 수준: ANY,ONE,TWO,QUORUM,LOCAL_QUORUM

readConsistencyLevel

 

키 읽기/확인에 사용되는 일관성 수준: ONE,TWO,QUORUM,LOCAL_QUORUM

13.8. 집계 리포지터리

NamedCassandraAggregationRepository 는 다음과 같이 table의 상관 키로 인한 상관관계를 저장합니다.

CAMEL_AGGREGATION.cql

CREATE TABLE CAMEL_AGGREGATION (
  NAME varchar,        -- Repository name
  KEY varchar,         -- Correlation id
  EXCHANGE_ID varchar, -- Exchange id
  EXCHANGE blob,       -- Serialized exchange
  PRIMARY KEY (NAME, KEY)
) WITH compaction = {'class':'LeveledCompactionStrategy'}
  AND gc_grace_seconds = 86400;

또는ECDHE AggregationRepository 에는 NAME 열이 없으며 다른 데이터 모델을 사용하도록 확장할 수 있습니다.

옵션Default설명

table

CAMEL_AGGREGATION

테이블 이름

pkColumns

NAME,KEY

기본 키 열

exchangeIdColumn

EXCHANGE_ID

교환 Id 열

exchangeColumn

EXCHANGE

교환 콘텐츠 열

name

 

리포지토리 이름, NAME 열에 사용되는 값

ttl

 

교환할 수 있는 시간

writeConsistencyLevel

 

교환 삽입/삭제에 사용되는 일관성 수준: ANY,ONE,TWO,QUORUM,LOCAL_QUORUM

readConsistencyLevel

 

교환을 읽고 확인하는 데 사용되는 일관성 수준: ONE,TWO,QUORUM,LOCAL_QUORUM

13.9. 예

테이블에 어떤 것을 삽입하려면 다음 코드를 사용할 수 있습니다.

String CQL = "insert into camel_user(login, first_name, last_name) values (?, ?, ?)";
from("direct:input")
    .to("cql://localhost/camel_ks?cql=" + CQL);

이 시점에서 목록을 본문으로 사용하여 데이터를 삽입할 수 있어야 합니다.

Arrays.asList("davsclaus", "Claus", "Ibsen")

동일한 방법을 사용하여 테이블을 업데이트하거나 쿼리할 수 있습니다.

13.10. Spring Boot Auto-Configuration

Spring Boot와 함께 cql을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-cassandraql-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.cql.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.cql.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.cql.enabled

cql 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.cql.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

14장. Control Bus

프로듀서만 지원됩니다.

EIP 패턴의 Control Bus 를 사용하면 프레임워크 내에서 통합 시스템을 모니터링하고 관리할 수 있습니다.

Control Bus를 사용하여 엔터프라이즈 통합 시스템 관리. Control Bus는 애플리케이션 데이터에 의해 사용되는 것과 동일한 메시징 메커니즘을 사용하지만 별도의 채널을 사용하여 메시지 흐름과 관련된 구성 요소 관리와 관련된 데이터를 전송합니다.

Camel에서는 CamelContext 의 Java API 또는 org.apache.camel.api.management 패키지에서 Java API를 사용하거나 여기에 예제가 있는 이벤트 알림기를 사용하여 관리 및 모니터링할 수 있습니다.

ControlBus 구성 요소를 사용하면 Control Bus EIP 패턴을 기반으로 Camel 애플리케이션을 쉽게 관리할 수 있습니다. 예를 들어 메시지를 엔드포인트로 전송하면 경로 라이프사이클을 제어하거나 성능 통계를 수집할 수 있습니다.

controlbus:command[?options]

여기서 command 는 사용할 명령 유형을 식별하는 문자열일 수 있습니다.

14.1. 명령

명령설명

Route

routeIdaction 매개변수를 사용하여 경로를 제어하려면 다음을 수행합니다.

언어

메시지 본문을 평가하는 데 사용할 을 지정할 수 있습니다. 평가 결과가 있는 경우 결과는 메시지 본문에 배치됩니다.

14.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

14.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

14.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

14.3. 구성 요소 옵션

Control Bus 구성 요소는 아래에 나열된 두 가지 옵션을 지원합니다.

이름설명Default유형

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

14.4. 끝점 옵션

Control Bus 엔드포인트는 URI 구문을 사용하여 구성됩니다.

controlbus:command:language

다음과 같은 경로 및 쿼리 매개변수 사용:

14.4.1. 경로 매개변수(2 매개변수)

이름설명Default유형

명령 (producer)

필수 명령은 경로 또는 언어일 수 있습니다.

CloudEvent 값:

  • Route
  • 언어
 

문자열

언어 (producer)

메시지 본문을 평가하는 데 사용할 언어의 이름을 지정할 수 있습니다. 평가 결과가 있는 경우 결과는 메시지 본문에 배치됩니다.

CloudEvent 값:

  • console
  • 상수
  • el
  • exchangeProperty
  • file
  • Groovy
  • header
  • jsonpath
  • MVEL
  • ognl
  • Ref
  • simple
  • SPEL
  • sql
  • terterer
  • tokenize
  • CloudEvent
  • xquery
  • xtokenize
 

언어

14.4.1.1. 쿼리 매개변수 (6 매개변수)

이름설명Default유형

작업 (producer)

start, stop 또는 status 중 하나일 수 있는 작업을 나타냅니다. 경로를 시작하거나 중지하거나 메시지 본문의 출력으로 경로의 상태를 가져옵니다. Camel 2.11.1 이후의 일시 중단 및 재개를 사용하여 경로를 일시 중지하거나 재개할 수 있습니다. 또한 Camel 2.11.1부터 stats를 사용하여 XML 형식으로 반환된 성능 정적을 얻을 수 있습니다. routeId 옵션을 사용하여 routeId가 정의되지 않은 경우 전체 CamelContext에 대한 통계를 얻을 수 있습니다. 재시작 작업은 경로를 다시 시작합니다.

CloudEvent 값:

  • start
  • 중지
  • 일시 중단
  • resume
  • 재시작
  • status
  • 통계
 

문자열

Async (producer)

제어 버스 작업을 비동기적으로 실행할지 여부입니다. 중요: 이 옵션을 사용하면 작업의 결과가 교환에 설정되지 않습니다. 이는 작업을 동기적으로 실행하는 경우에만 가능합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

loggingLevel (producer)

작업 완료 시 로깅에 사용되는 로깅 수준 또는 작업 처리 중에 예외가 발생한 경우.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

INFO

LoggingLevel

restartDelay (producer)

경로를 다시 시작할 때 사용할 밀리 초의 지연입니다.

1000

int

routeId (producer)

경로를 ID로 지정하려면 다음을 수행합니다. special 키워드 current는 현재 경로를 나타냅니다.

 

문자열

14.5. route 명령 사용

route 명령을 사용하면 지정된 경로에서 일반적인 작업을 매우 쉽게 수행할 수 있습니다. 예를 들어 경로를 시작하기 위해 이 끝점에 빈 메시지를 보낼 수 있습니다.

template.sendBody("controlbus:route?routeId=foo&action=start", null);

경로 상태를 가져오려면 다음을 수행할 수 있습니다.

String status = template.requestBody("controlbus:route?routeId=foo&action=status", null, String.class);

14.6. 성능 통계 얻기

이를 위해서는 경로별 또는 CamelContext에 대한 성능 통계를 가져올 수 있는 (기본적으로) 활성화되어야 합니다. 예를 들어 foo라는 경로에 대한 통계를 얻으려면 다음을 수행할 수 있습니다.

String xml = template.requestBody("controlbus:route?routeId=foo&action=stats", null, String.class);

반환된 통계는 XML 형식으로 되어 있습니다. ManagedRouteMBean 에서 dumpRouteStatsAs 10.0.0.1 작업을 사용하여 ScanSetting 에서 가져올 수 있는 데이터와 동일합니다.

전체 CamelContext에 대한 통계를 얻으려면 다음과 같이 routeId 매개변수를 생략합니다.

String xml = template.requestBody("controlbus:route?action=stats", null, String.class);

14.7. 간단한 언어 사용

예를 들어 컨트롤 버스와 함께 간단한 언어를 사용하여 특정 경로를 중지할 수 있습니다. 다음 메시지가 포함된 "controlbus:simple" 엔드포인트에 메시지를 보낼 수 있습니다.

template.sendBody("controlbus:language:simple", "${camelContext.getRouteController().stopRoute('myRoute')}");

이는 빈 작업이므로 결과가 반환되지 않습니다. 그러나 경로 상태를 원하는 경우 다음을 수행할 수 있습니다.

String status = template.requestBody("controlbus:language:simple", "${camelContext.getRouteStatus('myRoute')}", String.class);

route 명령을 사용하여 경로의 라이프사이클을 제어하는 것이 더 쉽습니다. 언어 명령을 사용하면 Groovy 와 같은 강력한 권한이 있거나 일부 간단한 언어를 확장하는 언어 스크립트를 실행할 수 있습니다.

예를 들어 Camel 자체를 종료하는 경우 다음을 수행할 수 있습니다.

template.sendBody("controlbus:language:simple?async=true", "${camelContext.stop()}");

async=true 를 사용하여 Camel을 비동기식으로 중지합니다. 그렇지 않으면 제어 버스 구성 요소로 보낸 메시지를 진행 중이던 동안 Camel을 중지하려고 합니다.

참고

Groovy 와 같은 다른 언어도 사용할 수 있습니다.

14.8. Spring Boot Auto-Configuration

Spring Boot와 함께 controlbus를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-controlbus-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.controlbus.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.controlbus.enabled

controlbus 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.controlbus.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

15장. cron

소비자만 지원됩니다.

Cron 구성 요소는 Unix cron 구문을 사용하여 지정된 특정 시간 간격으로 이벤트를 트리거할 수 있는 일반 인터페이스 구성 요소입니다(예: 0/2 * * * * * ? 는 2초마다 이벤트를 트리거할 수 있음).

인터페이스 구성 요소인 Cron 구성 요소에는 기본 구현이 포함되지 않습니다. 대신 사용자가 선택한 구현을 연결해야 합니다.

다음 표준 Camel 구성 요소는 Cron 엔드 포인트를 지원합니다.

  • Camel-quartz
  • Camel-spring

Cron 구성 요소는 Camel K 에서도 지원되며, 이 구성 요소는 Kubernetes 스케줄러를 사용하여 cron 표현식에 필요한 경우 경로를 트리거할 수 있습니다. Kubernetes cron 구문과 호환되는 cron 표현식을 사용할 때 Camel K를 추가 라이브러리를 연결할 필요가 없습니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-cron</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

특정 구현을 연결하기 위해 추가 라이브러리가 필요할 수 있습니다.

15.1. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

15.1.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

15.1.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

15.2. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

cronService (advanced)

여러 구현이 제공될 때 사용할 CamelCronService의 ID입니다.

 

문자열

15.3. 끝점 옵션

Cron 끝점은 URI 구문을 사용하여 구성됩니다.

cron:name

다음과 같은 경로 및 쿼리 매개변수 사용:

15.3.1. 경로 매개변수(1 매개변수)

이름설명Default유형

이름 (consumer)

cron 트리거의 이름이 필요합니다.

 

문자열

15.3.2. 쿼리 매개변수 (4 매개변수)

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

일정 (consumer)

이벤트를 생성하는 데 사용할 cron 표현식입니다.

 

문자열

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

15.4. 사용법

구성 요소를 사용하여 다음 예와 같이 지정된 시간에 이벤트를 트리거할 수 있습니다.

from("cron:tab?schedule=0/1+*+*+*+*+?")
.setBody().constant("event")
.log("${body}");

스케줄 표현식 0/3+10+*+0/3 10 * * * * ? 로 작성할 수도 있고, 매 10초 동안만 3초마다 이벤트를 트리거할 수 있습니다.

일정 표현식의 일부는 (순위로)를 의미합니다.

  • 초(선택 사항)
  • 몇 분
  • 몇 시간
  • 달의 날
  • 요일
  • 년 (선택 사항)

스케줄 표현식은 5~7개 부분으로 구성될 수 있습니다. 표현식이 6개 부분으로 구성되면 첫 번째 항목은 "초" 부분이며 연도는 누락된 것으로 간주됩니다.

일정 표현식의 다른 유효한 예는 다음과 같습니다.

  • 0/2 * * * ? (5개 파트, 2분마다 이벤트)
  • 0 0/2 * * MON-FRI 2030 (7부, 2030)년에 2분마다 이벤트

경로는 XML DSL을 사용하여 작성할 수도 있습니다.

<route>
    <from uri="cron:tab?schedule=0/1+*+*+*+*+?"/>
    <setBody>
      <constant>event</constant>
    </setBody>
    <to uri="log:info"/>
</route>

15.5. Spring Boot Auto-Configuration

Spring Boot와 함께 cron을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-cron-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.cron.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.cron.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.cron.cron-service

여러 구현이 제공될 때 사용할 CamelCronService의 ID입니다.

 

문자열

camel.component.cron.enabled

cron 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

16장. CXF

생산자 및 소비자 모두 지원

CXF 구성 요소는 CXF에서 호스팅되는 10.0.0.1 -WS 서비스에 연결하기 위해 Apache CXF 와의 통합을 제공합니다.

작은 정보

스트리밍 모드에서 CXF를 사용하는 경우 (DataFormat 옵션 참조) Stream 캐싱도 읽습니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-cxf-soap</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

16.1. URI 형식

이 엔드포인트에는 cxfEndpointsomeAddress 의 두 가지 URI 형식이 있습니다.

cxf:bean:cxfEndpoint[?options]

여기서 cxfEndpoint 는 Spring console 레지스트리의 빈을 참조하는 빈 ID를 나타냅니다. 이 URI 형식을 사용하면 대부분의 끝점 세부 정보가 빈 정의에 지정됩니다.

cxf://someAddress[?options]

여기서 someAddress 는 CXF 끝점의 주소를 지정합니다. 이 URI 형식을 사용하면 대부분의 끝점 세부 정보는 옵션을 사용하여 지정됩니다.

위의 두 스타일 모두 다음과 같이 URI에 옵션을 추가할 수 있습니다.

cxf:bean:cxfEndpoint?wsdlURL=wsdl/hello_world.wsdl&dataFormat=PAYLOAD

16.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

16.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

16.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형 의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

16.3. 구성 요소 옵션

CXF 구성 요소는 아래에 나열된 6 옵션을 지원합니다.

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

allowStreaming (advanced)

이 옵션은 PAYLOAD 모드에서 실행할 때 CXF 구성 요소를 제어하는지 여부를 제어합니다.이 옵션은 들어오는 메시지를 skopeo로 구문 분석하거나 경우에 따라 스트리밍을 허용하는 javax.xml.transform.Source 개체로 페이로드를 유지합니다.

 

부울

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

headerFilterStrategy (filter)

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지와 헤더를 필터링합니다.

 

HeaderFilterStrategy

useGlobalSslContextParameters (security)

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

boolean

16.4. 끝점 옵션

CXF 끝점은 URI 구문을 사용하여 구성됩니다.

cxf:beanId:address

다음과 같은 경로 및 쿼리 매개변수 사용:

16.4.1. 경로 매개변수(2 매개변수)

이름설명Default유형

clusterlanId (common)

구성된 기존 CxfEndpoint를 조회하려면 다음을 수행하십시오. 접두사로 console:을 사용해야 합니다.

 

문자열

주소 (서비스)

서비스 게시 주소입니다.

 

문자열

16.4.2. 쿼리 매개변수(35 매개변수)

이름설명Default유형

dataFormat (공용)

CXF 끝점에서 지원하는 데이터 유형 메시지입니다.

CloudEvent 값:

  • PAYLOAD
  • RAW
  • MESSAGE
  • CXF_MESSAGE
  • POJO

POJO

DataFormat

wrapStyle (common)

CloudEvent 본문에 매개 변수가 표시되는 방법을 설명하는 WSDL 스타일입니다. 값이 false인 경우 CXF는 document-literal unwrapped 스타일을 선택하고 값이 true이면 CXF는 document-literal wrap 스타일을 선택합니다.

 

부울

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

cookieHandler (producer)

HTTP 세션을 유지하도록 쿠키 처리기를 구성합니다.

 

CookieHandler

defaultOperationName (producer)

이 옵션은 원격 서비스를 호출하는 CxfProducer에서 사용할 기본 operationName을 설정합니다.

 

문자열

defaultOperationNamespace (producer)

이 옵션은 원격 서비스를 호출하는 CxfProducer에서 사용할 기본 operationNamespace를 설정합니다.

 

문자열

HostnameVerifier (producer)

사용할 호스트 이름 확인자입니다. # 표기법을 사용하여 레지스트리에서 HostnameVerifier를 참조합니다.

 

HostnameVerifier

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

sslContextParameters (producer)

Camel SSL 설정 참조. # 표기법을 사용하여 SSL 컨텍스트를 참조합니다.

 

SSLContextParameters

래핑 (producer)

CXF 엔드 포인트 프로듀서가 호출할 작업의 종류입니다.

false

boolean

동기 (제조자(고급))

동기 처리를 엄격하게 사용해야 하는지 여부를 설정합니다.

false

boolean

allowStreaming (advanced)

이 옵션은 PAYLOAD 모드에서 실행할 때 CXF 구성 요소를 제어하는지 여부를 제어합니다.이 옵션은 들어오는 메시지를 skopeo로 구문 분석하거나 경우에 따라 스트리밍을 허용하는 javax.xml.transform.Source 개체로 페이로드를 유지합니다.

 

부울

버스 (advanced)

사용자 정의 구성된 CXF 버스를 사용합니다.

 

버스

연속 시간 제한 (advanced)

이 옵션은 CXF 서버가>-<ty 또는 Servlet 전송을 사용할 때 기본적으로 CxfConsumer에서 사용할 수 있는 CXF 연속 타임아웃을 설정하는 데 사용됩니다.

30000

long

cxfBinding (advanced)

사용자 지정 CxfBinding을 사용하여 Camel Message와 CXF Message 간 바인딩을 제어합니다.

 

CxfBinding

cxfConfigurer (advanced)

이 옵션은 프로그래밍 방식으로 CXF 끝점 구성을 지원하는 org.apache.camel.component.cxf.CxfEndpointConfigurer 구현을 적용할 수 있습니다. 사용자는 CxfEndpointConfigurer의 configure{ServerClient} 메서드를 구현하여 CXF 서버 및 클라이언트를 구성할 수 있습니다.

 

CxfConfigurer

defaultBus (advanced)

CXF 엔드포인트가 자체적으로 버스를 생성하는 경우 기본 버스를 설정합니다.

false

boolean

headerFilterStrategy (advanced)

사용자 정의 HeaderFilterStrategy를 사용하여 Camel 메시지 간 헤더를 필터링하려면 다음을 수행합니다.

 

HeaderFilterStrategy

mergeProtocolHeaders (advanced)

프로토콜 헤더 병합 여부입니다. 활성화하면 Camel과 CXF 간의 헤더 전파가 일관되고 비슷합니다. 자세한 내용은 CAMEL-6393을 참조하십시오.

false

boolean

mtomEnabled (advanced)

MTOM(연결)을 활성화하려면 다음을 수행합니다. 이를 위해서는 gRPC 또는 PAYLOAD 데이터 형식 모드를 사용해야 합니다.

false

boolean

속성 (고급)

맵의 키/값 쌍을 사용하여 추가 CXF 옵션을 설정하려면 다음을 수행하십시오. 예를 들어 stacktraces를 10.0.0.1 결함, properties.faultStackTraceEnabled=true로 설정하려면 다음을 수행하십시오.

 

map

skipPayloadMessagePartCheck (advanced)

message validation을 비활성화해야 하는지 여부를 설정합니다.

false

boolean

loggingFeatureEnabled (logging)

이 옵션을 사용하면 인바운드 및 아웃바운드 iPXE 메시지를 로그에 쓰는 CXF 로깅 기능을 활성화합니다.

false

boolean

loggingSizeLimit (logging)

로깅 기능이 활성화되고 제한 없이 -1이 출력될 때 로거에서 출력하는 총 바이트 수 크기를 제한하려면 다음을 수행합니다.

49152

int

skipFaultLogging (logging)

이 옵션은 PhaseInterceptor가 catch된 Fault 로깅을 건너뛸지 여부를 제어합니다.

false

boolean

암호 (보안)

이 옵션은 CXF 클라이언트에 대한 암호의 기본 인증 정보를 설정하는 데 사용됩니다.

 

문자열

사용자 이름 (보안)

이 옵션은 CXF 클라이언트에 대한 사용자 이름의 기본 인증 정보를 설정하는 데 사용됩니다.

 

문자열

bindingId (service)

사용할 서비스 모델의 bindingId입니다.

 

문자열

portName (서비스)

이 서비스가 구현 중인 엔드포인트 이름은 wsdl:portname에 매핑됩니다. ns:PORT_NAME 형식에서 ns는 이 범위에서 유효한 네임스페이스 접두사입니다.

 

문자열

publishedEndpointUrl (service)

이 옵션은 서비스 주소 url 더하기 wsd를 사용하여 액세스할 수 있는 WSDL에서 게시한 endpointUrl을 덮어쓸 수 있습니다.

 

문자열

serviceClass (서비스)

SEI(Service Endpoint Interface) 클래스의 클래스 이름입니다. 이 클래스에는 주석이 있거나 주석이 없을 수 있습니다.

 

클래스

ServiceName (서비스)

이 서비스가 구현하는 서비스 이름은 wsdl:servicename에 매핑됩니다.

 

문자열

wsdlURL (서비스)

WSDL의 위치입니다. classpath, 파일 시스템에 있거나 원격으로 호스팅될 수 있습니다.

 

문자열

serviceNameportNameQNames 이므로 제공하는 경우 위의 예제와 같이 해당 {namespace}를 사용하여 접두사를 붙여야 합니다.

16.4.3. 데이터 형식에 대한 설명

Apache Camel에서 Camel CXF 구성 요소는 웹 서비스와 경로를 통합하는 핵심입니다. Camel CXF 구성 요소를 사용하여 다음 방법 중 하나로 사용할 수 있는 CXF 엔드포인트를 생성할 수 있습니다.

  • Consumer -(경로 시작)는 경로와 통합되는 웹 서비스 인스턴스를 나타냅니다. 경로에 삽입된 페이로드 유형은 끝점의 dataFormat 옵션의 값에 따라 다릅니다.
  • 생산자 - 경로의 다른 지점에서는 현재 교환 오브젝트를 원격 웹 서비스의 작업 호출로 변환하는 WS 클라이언트 프록시를 나타냅니다. 현재 교환의 형식은 끝점의 dataFormat 설정과 일치해야 합니다.
DataFormat설명

POJO

Java 오브젝트(이전 Java 오브젝트)는 대상 서버에서 호출되는 메서드에 대한 Java 매개변수입니다. 프로토콜 및 LogicalECDHE-WS 핸들러가 모두 지원됩니다.

PAYLOAD

PAYLOAD 는 CXF 끝점의 메시지 구성이 적용된 후 메시지 페이로드( soap:body의 콘텐츠)입니다. ProtocolECDHE-WS 핸들러만 지원됩니다. logical#177-WS 핸들러는 지원되지 않습니다.

RAW

RAW 모드는 전송 계층에서 수신한 원시 메시지 스트림을 제공합니다. 스트림을 만지거나 변경할 수 없으며 이러한 종류의 DataFormat을 사용하는 경우 CXF 인터셉터 중 일부가 제거되므로 camel-cxf 소비자 후에는 soap 헤더를 볼 수 없습니다. CloudEvent-WS 처리기는 지원되지 않습니다.

CXF_MESSAGE

CXF_MESSAGE 를 사용하면 전송 계층에서 메시지를 원시 iPXE 메시지로 변환하여 CXF 인터셉터의 전체 기능을 호출할 수 있습니다.

exchange 속성인 CamelCXFDataFormat 을 검색하여 교환의 데이터 형식 모드를 확인할 수 있습니다. 교환 키 상수는 org.apache.camel.component.cxf.common.message.CxfConstants.DATA_FORMAT_PROPERTY 에 정의되어 있습니다.

16.4.4. RAW 모드에서 CXF의 LoggingOutInterceptor를 활성화하는 방법

CXF의 LoggingOutInterceptor 는 로깅 시스템(Java Util Logging)으로 전선되는 아웃바운드 메시지를 출력합니다. LoggingOutInterceptorPRE_STREAM 단계( PRE_STREAM 단계가 RAW 모드에서 제거됨)이므로 WRITE 단계 중에 LoggingOutInterceptor 를 실행하도록 구성해야 합니다. 다음은 예제입니다.

@Bean
public CxfEndpoint serviceEndpoint(LoggingOutInterceptor loggingOutInterceptor) {
    CxfSpringEndpoint cxfEndpoint = new CxfSpringEndpoint();
    cxfEndpoint.setAddress("http://localhost:" + port
                            + "/services" + SERVICE_ADDRESS);
    cxfEndpoint.setServiceClass(org.apache.camel.component.cxf.HelloService.class);
    Map<String, Object> properties = new HashMap<String, Object>();
    properties.put("dataFormat", "RAW");
    cxfEndpoint.setProperties(properties);
    cxfEndpoint.getOutInterceptors().add(loggingOutInterceptor);
    return cxfEndpoint;
}


@Bean
public LoggingOutInterceptor loggingOutInterceptor() {
    LoggingOutInterceptor logger = new LoggingOutInterceptor("write");
    return logger;
}

16.4.5. relayHeaders 옵션에 대한 설명

GDBWSWSDL -first 개발자의 관점에서 대역 내 및 대역 외 유선 헤더가 있습니다.

in-band 헤더는 iPXE 헤더와 같은 엔드포인트에 대한 WSDL 바인딩 계약의 일부로 명시적으로 정의된 헤더입니다.

대역 외 헤더는 전선을 통해 직렬화되는 헤더이지만 WSDL 바인딩 계약의 일부가 아닌 헤더입니다.

헤더 릴레이/필터링은 양방향입니다.

경로에 CXF 엔드포인트가 있고 개발자에게 다른 CloudEventWS 엔드포인트에서 사용할 경로를 따라 중계되는 온-the-wire 헤더가 있어야 하는 경우, relayHeaderstrue 로 설정해야 합니다.

16.4.6. iPXE 모드에서만 사용 가능

relayHeaders=true 는 헤더를 릴레이하려는 의도를 나타냅니다. 지정된 헤더가 릴레이되었는지의 실제 결정은 MessageHeadersRelay 인터페이스를 구현하는 플러그 가능 인스턴스에 위임됩니다. 헤더를 릴레이해야 하는지 결정하는 데 필요한 MessageHeadersRelay 의 구체적인 구현이 제공됩니다. 이미 잘 알려진 iPXE 네임 스페이스에 자신을 바인딩하는 SoapMessageHeadersRelay 구현이 있습니다. 현재 대역 외 헤더만 필터링되고 relayHeaders=true 인 경우 in-band 헤더가 항상 중계됩니다. 런타임에 네임 스페이스를 알 수 없는 전선에 헤더가 있는 경우 대체 DefaultMessageHeadersRelay 가 사용되므로 모든 헤더를 릴레이할 수 있습니다.

relayHeaders=false 설정은band 및 out-of-band의 모든 헤더를 삭제해야 함을 지정합니다.

자체 MessageHeadersRelay 구현을 플러그인화하거나 릴레이 목록에 추가할 수 있습니다. 사전 로드된 릴레이 인스턴스를 재정의하려면 MessageHeadersRelay 구현에서 재정의하려는 것과 동일한 네임 스페이스를 서비스해야 합니다. 또한 덮어쓰기 중 하나는 재정의하려는 이름으로 모든 네임 스페이스를 서비스해야 합니다. 그렇지 않으면 경로 시작 시 런타임 예외가 발생합니다. 이 경우 인스턴스 매핑을 릴레이하기 위해 네임 스페이스에 모호성을 도입하기 때문입니다.

<cxf:cxfEndpoint ...>
   <cxf:properties>
     <entry key="org.apache.camel.cxf.message.headers.relays">
       <list>
         <ref bean="customHeadersRelay"/>
       </list>
     </entry>
   </cxf:properties>
 </cxf:cxfEndpoint>
 <bean id="customHeadersRelay" class="org.apache.camel.component.cxf.soap.headers.CustomHeadersRelay"/>

헤더를 릴레이/드롭할 수 있는 방법을 보여주는 테스트를 살펴보십시오.

https://github.com/apache/camel/blob/main/components/camel-cxf/src/test/java/org/apache/camel/component/cxf/soap/headers/CxfMessageHeadersRelayTest.java

  • emptyDirPAYLOAD 모드가 지원됩니다. VMDK 모드에서는 in-band 헤더가 처리되어 CXF에 의해 헤더 목록에서 제거되므로 대역 외 메시지 헤더만 필터링에 사용할 수 있습니다. in-band 헤더는 192.0.2. 모드의 MessageContentList 에 통합됩니다. camel-cxf 구성 요소는 MessageContentList 에서 대역 내 헤더를 제거하려고 합니다. 대역 내 헤더를 필터링해야 하는 경우 PAYLOAD 모드 또는 플러그인을 CXF 엔드포인트에 CXF 인터셉터/JAXWS Handler에 사용하십시오.
  • Message Header Relay 메커니즘이 CxfHeaderFilterStrategy 에 병합되었습니다. relayHeaders 옵션, 해당 의미 체계 및 기본값은 동일하게 유지되지만 CxfHeaderFilterStrategy 의 속성입니다. 다음은 구성하는 예입니다.
@Bean
public HeaderFilterStrategy dropAllMessageHeadersStrategy() {
    CxfHeaderFilterStrategy headerFilterStrategy = new CxfHeaderFilterStrategy();
    headerFilterStrategy.setRelayHeaders(false);
    return headerFilterStrategy;
}

그러면 끝점이 CxfHeaderFilterStrategy 를 참조할 수 있습니다.

@Bean
public CxfEndpoint routerNoRelayEndpoint(HeaderFilterStrategy dropAllMessageHeadersStrategy) {
    CxfSpringEndpoint cxfEndpoint = new CxfSpringEndpoint();
    cxfEndpoint.setServiceClass(org.apache.camel.component.cxf.soap.headers.HeaderTester.class);
    cxfEndpoint.setAddress("/CxfMessageHeadersRelayTest/HeaderService/routerNoRelayEndpoint");
    cxfEndpoint.setWsdlURL("soap_header.wsdl");
    cxfEndpoint.setEndpointNameAsQName(
        QName.valueOf("{http://apache.org/camel/component/cxf/soap/headers}SoapPortNoRelay"));
    cxfEndpoint.setServiceNameAsQName(SERVICENAME);
    Map<String, Object> properties = new HashMap<String, Object>();
    properties.put("dataFormat", "PAYLOAD");
    cxfEndpoint.setProperties(properties);
    cxfEndpoint.setHeaderFilterStrategy(dropAllMessageHeadersStrategy);
    return cxfEndpoint;
}

@Bean
public CxfEndpoint serviceNoRelayEndpoint(HeaderFilterStrategy dropAllMessageHeadersStrategy) {
    CxfSpringEndpoint cxfEndpoint = new CxfSpringEndpoint();
    cxfEndpoint.setServiceClass(org.apache.camel.component.cxf.soap.headers.HeaderTester.class);
    cxfEndpoint.setAddress("http://localhost:" + port + "/services/CxfMessageHeadersRelayTest/HeaderService/routerNoRelayEndpointBackend");
    cxfEndpoint.setWsdlURL("soap_header.wsdl");
    cxfEndpoint.setEndpointNameAsQName(
        QName.valueOf("{http://apache.org/camel/component/cxf/soap/headers}SoapPortNoRelay"));
    cxfEndpoint.setServiceNameAsQName(SERVICENAME);
    Map<String, Object> properties = new HashMap<String, Object>();
    properties.put("dataFormat", "PAYLOAD");
    cxfEndpoint.setProperties(properties);
    cxfEndpoint.setHeaderFilterStrategy(dropAllMessageHeadersStrategy);
    return cxfEndpoint;
}

그런 다음 다음과 같이 경로를 설정합니다.

rom("cxf:bean:routerNoRelayEndpoint")
    .to("cxf:bean:serviceNoRelayEndpoint");
  • MessageHeadersRelay 인터페이스가 약간 변경되었으며 이름이 MessageHeaderFilter 로 변경되었습니다. CxfHeaderFilterStrategy 의 속성입니다. 다음은 사용자 정의 Message Header Filters를 구성하는 예입니다.
@Bean
public HeaderFilterStrategy customMessageFilterStrategy() {
    CxfHeaderFilterStrategy headerFilterStrategy = new CxfHeaderFilterStrategy();
    List<MessageHeaderFilter> headerFilterList = new ArrayList<MessageHeaderFilter>();
    headerFilterList.add(new SoapMessageHeaderFilter());
    headerFilterList.add(new CustomHeaderFilter());
    headerFilterStrategy.setMessageHeaderFilters(headerFilterList);
    return headerFilterStrategy;
}
  • relayHeaders 외에 다음 속성을 CxfHeaderFilterStrategy 에서 구성할 수 있습니다.
이름필수 항목설명

relayHeaders

없음

모든 메시지 헤더는 Message Header Filters Type:boolean Default:true에 의해 처리됩니다.

relayAllMessageHeaders

없음

모든 메시지 헤더는 (Message Header Filter에 의한 처리없이) Type:booleanDefault:false

allowFilterNamespaceClash

없음

활성화 네임스페이스에서 두 필터가 겹치면 속성 제어 방법을 처리합니다. 값이 true 이면 마지막 값이 우선합니다. 값이 false 이면 Type:boolean Default:false예외가 발생합니다.

16.5. Spring으로 CXF 엔드 포인트를 구성

아래 표시된 Spring 구성 파일을 사용하여 CXF 엔드 포인트를 구성할 수 있으며, endpoint를 camelContext 태그에 포함할 수도 있습니다. 서비스 끝점을 호출할 때 operationNameoperationNamespace 헤더를 명시적으로 설정하여 호출하는 작업을 명시적으로 표시할 수 있습니다.

<beans xmlns="http://www.springframework.org/schema/beans"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:cxf="http://camel.apache.org/schema/cxf"
        xsi:schemaLocation="
        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
        http://camel.apache.org/schema/cxf http://camel.apache.org/schema/cxf/camel-cxf.xsd
        http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd">
     <cxf:cxfEndpoint id="routerEndpoint" address="http://localhost:9003/CamelContext/RouterPort"
            serviceClass="org.apache.hello_world_soap_http.GreeterImpl"/>
     <cxf:cxfEndpoint id="serviceEndpoint" address="http://localhost:9000/SoapContext/SoapPort"
            wsdlURL="testutils/hello_world.wsdl"
            serviceClass="org.apache.hello_world_soap_http.Greeter"
            endpointName="s:SoapPort"
            serviceName="s:SOAPService"
        xmlns:s="http://apache.org/hello_world_soap_http" />
     <camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
       <route>
         <from uri="cxf:bean:routerEndpoint" />
         <to uri="cxf:bean:serviceEndpoint" />
       </route>
    </camelContext>
  </beans>

루트 빈 요소에 지정된>-<-WS schemaLocation 속성을 포함해야 합니다. 이를 통해 CXF는 파일의 유효성을 검증할 수 있으며 필수입니다. 또한 < cxf:cxfEndpoint/ > 태그 끝에 네임스페이스 선언도 기록해 둡니다. 결합된 {namespace}localName 구문이 현재 이 태그의 속성 값에 대해 지원되지 않기 때문에 이러한 선언이 필요합니다.

cxf:cxfEndpoint 요소는 많은 추가 특성을 지원합니다.

이름현재의

PortName

이 서비스가 구현되고 있는 엔드포인트 이름은 wsdl:port@name 에 매핑됩니다. ns:PORT_NAME 형식에서 ns 는 이 범위에서 유효한 네임스페이스 접두사입니다.

serviceName

이 서비스가 구현하는 서비스 이름은 wsdl:service@name 에 매핑됩니다. ns:SERVICE_NAME 형식에서 ns 는 이 범위에서 유효한 네임스페이스 접두사입니다.

wsdlURL

WSDL의 위치입니다. classpath, 파일 시스템에 있거나 원격으로 호스팅될 수 있습니다.

bindingId

사용할 서비스 모델의 bindingId 입니다.

address

서비스 게시 주소입니다.

bus

GDB-WS 엔드포인트에서 사용할 버스 이름입니다.

serviceClass

SEI(Service Endpoint Interface) 클래스의 클래스 이름입니다. 이 클래스에는 주석이 있거나 주석이 없을 수 있습니다.

또한 여러 자식 요소를 지원합니다.

이름현재의

cxf:inInterceptors

이 끝점에 대해 들어오는 인터셉터입니다. <ECDHE& gt; 또는 & lt; ref> 목록입니다.

cxf:inFaultInterceptors

이 엔드포인트에 대해 들어오는 오류 인터셉터입니다. <ECDHE& gt; 또는 & lt; ref> 목록입니다.

cxf:outInterceptors

이 끝점에 대한 발신 인터셉터입니다. <ECDHE& gt; 또는 & lt; ref> 목록입니다.

cxf:outFaultInterceptors

이 엔드포인트에 대한 발신 오류 인터셉터입니다. <ECDHE& gt; 또는 & lt; ref> 목록입니다.

CXF:properties

CloudEvent-WS 엔드포인트에 제공해야 하는 속성 맵입니다. 아래를 참조하십시오.

CXF:handlers

192.0.2.-WS 엔드포인트에 제공해야 하는 handler 목록입니다. 아래를 참조하십시오.

cxf:dataBinding

끝점에서 사용할 DataBinding 을 지정할 수 있습니다. Spring <ovn class="MyDataBinding"/ > 구문을 사용하여 제공할 수 있습니다.

CXF:binding

이 끝점에서 사용할 BindingFactory 를 지정할 수 있습니다. Spring <ovn class="MyBindingFactory"/ > 구문을 사용하여 제공할 수 있습니다.

CXF:features

이 끝점의 인터셉터를 보유하는 기능입니다. 빈 또는 ref 목록

cxf:schemaLocations

사용할 끝점의 스키마 위치입니다. schemaLocations 목록

cxf:serviceFactory

이 끝점에서 사용할 서비스 팩토리입니다. Spring <ovn class="MyServiceFactory"/ > 구문을 사용하여 제공할 수 있습니다.

CXFECDHE -WS 구성 페이지에서 인터셉터, 속성 및 처리기를 제공하는 방법을 보여주는 고급 예제를 찾을 수 있습니다.

참고

cxf:properties를 사용하여 spring 구성 파일에서 camel-cxf 끝점의 dataFormat 및 setDefaultBus 속성을 설정할 수 있습니다.

<cxf:cxfEndpoint id="testEndpoint" address="http://localhost:9000/router"
     serviceClass="org.apache.camel.component.cxf.HelloService"
     endpointName="s:PortName"
     serviceName="s:ServiceName"
     xmlns:s="http://www.example.com/test">
     <cxf:properties>
       <entry key="dataFormat" value="RAW"/>
       <entry key="setDefaultBus" value="true"/>
     </cxf:properties>
   </cxf:cxfEndpoint>
참고

SpringBoot에서는 Spring XML 파일을 사용하여 camel-cxf 를 구성하고 다음 예제와 유사한 코드를 사용하여 XML 구성 빈을 생성할 수 있습니다.

@ImportResource({
		"classpath:spring-configuration.xml"
})

그러나 구성된 Java 코드(다른 예와 같이) 구성된 빈을 사용하는 것이 SpringBoot에서 가장 좋습니다.

16.6. java.util.logging 대신 camel-cxf 구성 요소를 사용하여 log4j를 사용하도록 설정하는 방법

CXF의 기본 로거는 java.util.logging 입니다. 이를 log4j로 변경하려면 다음과 같이 진행합니다. classpath에 META-INF/cxf/org.apache.cxf.logger 라는 파일을 만듭니다. 이 파일에는 한 줄에 주석이 없는 org.apache.cxf.common.logging.Log4jLogger 가 있어야 합니다.

16.7. How to let camel-cxf response start with xml processing instruction

PHP와 같은 일부 CHAP 클라이언트를 사용하는 경우 CXF가 XML 처리 명령 < ?xml version="1.0" encoding="utf-8" >을 추가하지 않기 때문에 이러한 종류의 오류가 발생합니다.

Error:sendSms: SoapFault exception: [Client] looks like we got no XML document in [...]

이 문제를 해결하려면 아래 WriteECDHEDeclarationInterceptor에서와 같이 사용자를 위해 XML 시작 문서를 작성하도록 staffxOutInterceptor 에게 지시합니다.

public class WriteXmlDeclarationInterceptor extends AbstractPhaseInterceptor<SoapMessage> {
    public WriteXmlDeclarationInterceptor() {
        super(Phase.PRE_STREAM);
        addBefore(StaxOutInterceptor.class.getName());
    }

    public void handleMessage(SoapMessage message) throws Fault {
        message.put("org.apache.cxf.stax.force-start-document", Boolean.TRUE);
    }

}

대안으로 CxfConsumerTest 에 설명된 대로 메시지 헤더를 추가할 수 있습니다.

 // set up the response context which force start document
 Map<String, Object> map = new HashMap<String, Object>();
 map.put("org.apache.cxf.stax.force-start-document", Boolean.TRUE);
 exchange.getOut().setHeader(Client.RESPONSE_CONTEXT, map);

16.8. 메시지 헤더에서 CXF 생산자 주소를 재정의하는 방법

camel-cxf 생산자는 메시지 헤더 CamelDestinationOverrideUrl 을 설정하여 대상 서비스 주소를 덮어쓸 수 있도록 지원합니다.

 // set up the service address from the message header to override the setting of CXF endpoint
 exchange.getIn().setHeader(Exchange.DESTINATION_OVERRIDE_URL, constant(getServiceAddress()));

16.9. How to consume a message from a camel-cxf endpoint in CloudEvent data format

camel-cxf 엔드포인트 소비자 데이터 형식은 CXF 호출자 를 기반으로 하므로 메시지 헤더에는 CxfConstants.OPERATION_NAME 이라는 속성이 있고 메시지 본문은 SEI 메서드 매개변수 목록입니다.

PersonProcessor 예제 코드를 고려하십시오.

public class PersonProcessor implements Processor {

    private static final Logger LOG = LoggerFactory.getLogger(PersonProcessor.class);

    @Override
    @SuppressWarnings("unchecked")
    public void process(Exchange exchange) throws Exception {
        LOG.info("processing exchange in camel");

        BindingOperationInfo boi = (BindingOperationInfo) exchange.getProperty(BindingOperationInfo.class.getName());
        if (boi != null) {
            LOG.info("boi.isUnwrapped" + boi.isUnwrapped());
        }
        // Get the parameters list which element is the holder.
        MessageContentsList msgList = (MessageContentsList) exchange.getIn().getBody();
        Holder<String> personId = (Holder<String>) msgList.get(0);
        Holder<String> ssn = (Holder<String>) msgList.get(1);
        Holder<String> name = (Holder<String>) msgList.get(2);

        if (personId.value == null || personId.value.length() == 0) {
            LOG.info("person id 123, so throwing exception");
            // Try to throw out the soap fault message
            org.apache.camel.wsdl_first.types.UnknownPersonFault personFault
                    = new org.apache.camel.wsdl_first.types.UnknownPersonFault();
            personFault.setPersonId("");
            org.apache.camel.wsdl_first.UnknownPersonFault fault
                    = new org.apache.camel.wsdl_first.UnknownPersonFault("Get the null value of person name", personFault);
            exchange.getMessage().setBody(fault);
            return;
        }

        name.value = "Bonjour";
        ssn.value = "123";
        LOG.info("setting Bonjour as the response");
        // Set the response message, first element is the return value of the operation,
        // the others are the holders of method parameters
        exchange.getMessage().setBody(new Object[] { null, personId, ssn, name });
    }

}

16.10. how to prepare the message for the camel-cxf endpoint in#177 data format

camel-cxf 끝점 프로듀서는 CXF 클라이언트 API 를 기반으로 합니다. 먼저 메시지 헤더에 작업 이름을 지정한 다음 메서드 매개변수를 목록에 추가하고 이 매개변수 목록으로 메시지를 초기화해야 합니다. 응답 메시지의 본문은 messageContentsList이며 해당 목록의 결과를 가져올 수 있습니다.

메시지 헤더에 작업 이름을 지정하지 않으면 CxfProducerCxfEndpoint기본OperationName 을 사용하려고 합니다. CxfEndpoint기본OperationName 이 설정되지 않은 경우 Operation 목록에서 첫 번째 operationName을 선택합니다.

메시지 본문에서 개체 배열을 가져오려면 CxfProducerRouterTest.testInvokingSimpleServerWithParams 와 같이 message.getBody(Object[].class) 를 사용하여 본문을 가져올 수 있습니다.

Exchange senderExchange = new DefaultExchange(context, ExchangePattern.InOut);
final List<String> params = new ArrayList<>();
// Prepare the request message for the camel-cxf procedure
params.add(TEST_MESSAGE);
senderExchange.getIn().setBody(params);
senderExchange.getIn().setHeader(CxfConstants.OPERATION_NAME, ECHO_OPERATION);

Exchange exchange = template.send("direct:EndpointA", senderExchange);

org.apache.camel.Message out = exchange.getMessage();
// The response message's body is an MessageContentsList which first element is the return value of the operation,
// If there are some holder parameters, the holder parameter will be filled in the reset of List.
// The result will be extract from the MessageContentsList with the String class type
MessageContentsList result = (MessageContentsList) out.getBody();
LOG.info("Received output text: " + result.get(0));
Map<String, Object> responseContext = CastUtils.cast((Map<?, ?>) out.getHeader(Client.RESPONSE_CONTEXT));
assertNotNull(responseContext);
assertEquals("UTF-8", responseContext.get(org.apache.cxf.message.Message.ENCODING),
        "We should get the response context here");
assertEquals("echo " + TEST_MESSAGE, result.get(0), "Reply body on Camel is wrong");

16.11. PAYLOAD 데이터 형식의 camel-cxf 끝점에 대한 메시지를 처리하는 방법

PAYLOAD 는 사용자가 네이티브 CxfPayload로 CloudEvent의 페이로드를 처리하는 것을 의미합니다. message.getBody()org.apache.camel.component.cxf.CxfPayload 오브젝트를 반환합니다. 이때 message.getBody에 대한 getter와 here 본문이 있습니다.

CxfConsumerPayloadTest 를 참조하십시오.

protected RouteBuilder createRouteBuilder() {
    return new RouteBuilder() {
        public void configure() {
            from(simpleEndpointURI + "&dataFormat=PAYLOAD").to("log:info").process(new Processor() {
                @SuppressWarnings("unchecked")
                public void process(final Exchange exchange) throws Exception {
                    CxfPayload<SoapHeader> requestPayload = exchange.getIn().getBody(CxfPayload.class);
                    List<Source> inElements = requestPayload.getBodySources();
                    List<Source> outElements = new ArrayList<>();
                    // You can use a customer toStringConverter to turn a CxfPayLoad message into String as you want
                    String request = exchange.getIn().getBody(String.class);
                    XmlConverter converter = new XmlConverter();
                    String documentString = ECHO_RESPONSE;

                    Element in = new XmlConverter().toDOMElement(inElements.get(0));
                    // Just check the element namespace
                    if (!in.getNamespaceURI().equals(ELEMENT_NAMESPACE)) {
                        throw new IllegalArgumentException("Wrong element namespace");
                    }
                    if (in.getLocalName().equals("echoBoolean")) {
                        documentString = ECHO_BOOLEAN_RESPONSE;
                        checkRequest("ECHO_BOOLEAN_REQUEST", request);
                    } else {
                        documentString = ECHO_RESPONSE;
                        checkRequest("ECHO_REQUEST", request);
                    }
                    Document outDocument = converter.toDOMDocument(documentString, exchange);
                    outElements.add(new DOMSource(outDocument.getDocumentElement()));
                    // set the payload header with null
                    CxfPayload<SoapHeader> responsePayload = new CxfPayload<>(null, outElements, null);
                    exchange.getMessage().setBody(responsePayload);
                }
            });
        }
    };
}

16.12. VMDK 모드에서 iPXE 헤더를 가져오고 설정하는 방법

CloudEvent 는 camel-cxf 엔드포인트에서 Camel exchange를 생성하거나 사용할 때 데이터 형식이 "Java 개체 목록"임을 나타냅니다. Camel이 이 모드에서 메시지 본문을 10.0.0.1s로 노출하지만 camel-cxf는 여전히 읽기 및 쓰기 headers에 대한 액세스를 제공합니다. 그러나 CXF 인터셉터가 처리된 후 헤더 목록에서 대역 내 CHAP 헤더를 제거하므로 대역 외 iPXE 헤더만 generated 모드에서 camel-cxf를 사용할 수 있습니다.

다음 예제에서는 CHAP 헤더를 가져오고 설정하는 방법을 보여줍니다. 하나의 Camel-cxf 끝점에서 다른 endpoint로 전달되는 경로가 있다고 가정합니다. 즉, iPXE 클라이언트 → Camel → CXF 서비스입니다. 요청이 CXF 서비스에 나가기 전에 (1)에서 두 개의 프로세서를 첨부할 수 있습니다. (2) 응답이 iPXE Client로 반환되기 전에 이 예에서 processor (1) 및 (2)는 InsertRequestOutHeaderProcessor 및 InsertResponseOutHeaderProcessor입니다. 이 경로는 다음과 같습니다.

from("cxf:bean:routerRelayEndpointWithInsertion")
    .process(new InsertRequestOutHeaderProcessor())
    .to("cxf:bean:serviceRelayEndpointWithInsertion")
    .process(new InsertResponseOutHeaderProcessor());

iPXE routerRelayEndpointWithInsertionserviceRelayEndpointWithInsertion 은 다음과 같이 정의됩니다.

@Bean
public CxfEndpoint routerRelayEndpointWithInsertion() {
    CxfSpringEndpoint cxfEndpoint = new CxfSpringEndpoint();
    cxfEndpoint.setServiceClass(org.apache.camel.component.cxf.soap.headers.HeaderTester.class);
    cxfEndpoint.setAddress("/CxfMessageHeadersRelayTest/HeaderService/routerRelayEndpointWithInsertion");
    cxfEndpoint.setWsdlURL("soap_header.wsdl");
    cxfEndpoint.setEndpointNameAsQName(
        QName.valueOf("{http://apache.org/camel/component/cxf/soap/headers}SoapPortRelayWithInsertion"));
    cxfEndpoint.setServiceNameAsQName(SERVICENAME);
    cxfEndpoint.getFeatures().add(new LoggingFeature());
    return cxfEndpoint;
}

@Bean
public CxfEndpoint serviceRelayEndpointWithInsertion() {
    CxfSpringEndpoint cxfEndpoint = new CxfSpringEndpoint();
    cxfEndpoint.setServiceClass(org.apache.camel.component.cxf.soap.headers.HeaderTester.class);
    cxfEndpoint.setAddress("http://localhost:" + port + "/services/CxfMessageHeadersRelayTest/HeaderService/routerRelayEndpointWithInsertionBackend");
    cxfEndpoint.setWsdlURL("soap_header.wsdl");
    cxfEndpoint.setEndpointNameAsQName(
        QName.valueOf("{http://apache.org/camel/component/cxf/soap/headers}SoapPortRelayWithInsertion"));
    cxfEndpoint.setServiceNameAsQName(SERVICENAME);
    cxfEndpoint.getFeatures().add(new LoggingFeature());
    return cxfEndpoint;
}

CloudEvent 헤더는 Camel Message 헤더로 또는 에서 전파됩니다. Camel 메시지 헤더 이름은 CXF(org.apache.cxf.headers.Header.HEADER_LIST)에 정의된 상수인 "org.apache.cxf.headers.Header.list"입니다. 헤더 값은 CXF SoapHeader 오브젝트 목록(org.apache.cxf.binding.soap.SoapHeader)입니다. 다음 스니펫은 InsertResponseOutHeaderProcessor(응답 메시지에 새 iPXE 헤더를 삽입함)입니다. InsertResponseOutHeaderProcessor 및 InsertRequestOutHeaderProcessor 모두에서 iPXE 헤더에 액세스하는 방법은 실제로 동일합니다. 두 프로세서의 유일한 차이점은 삽입된 CHAP 헤더의 방향을 설정하는 것입니다.

CxfMessageHeadersRelayTest 에서 InsertResponseOutHeaderProcessor 예제를 찾을 수 있습니다.

public static class InsertResponseOutHeaderProcessor implements Processor {

    public void process(Exchange exchange) throws Exception {
        List<SoapHeader> soapHeaders = CastUtils.cast((List<?>)exchange.getIn().getHeader(Header.HEADER_LIST));

        // Insert a new header
        String xml = "<?xml version=\"1.0\" encoding=\"utf-8\"?><outofbandHeader "
            + "xmlns=\"http://cxf.apache.org/outofband/Header\" hdrAttribute=\"testHdrAttribute\" "
            + "xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\" soap:mustUnderstand=\"1\">"
            + "<name>New_testOobHeader</name><value>New_testOobHeaderValue</value></outofbandHeader>";
        SoapHeader newHeader = new SoapHeader(soapHeaders.get(0).getName(),
                       DOMUtils.readXml(new StringReader(xml)).getDocumentElement());
        // make sure direction is OUT since it is a response message.
        newHeader.setDirection(Direction.DIRECTION_OUT);
        //newHeader.setMustUnderstand(false);
        soapHeaders.add(newHeader);

    }

}

16.13. PAYLOAD 모드에서 iPXE 헤더를 가져오고 설정하는 방법

PAYLOAD 데이터 형식의 camel-cxf 엔드포인트에 대한 메시지를 처리하는 방법 섹션에서 PAYLOAD 모드에서 CxfPayload 오브젝트로 CHAP 메시지에 액세스하는 방법을 이미 보여주었습니다.

CxfPayload 오브젝트를 가져온 후 CxfPayload.getHeaders() 메서드를 호출하면 List of ScanSetting(SOAP 헤더)를 반환할 수 있습니다.

예를 들어 CxfPayLoadSoapHeaderTest 를 참조하십시오.

from(getRouterEndpointURI()).process(new Processor() {
    @SuppressWarnings("unchecked")
    public void process(Exchange exchange) throws Exception {
        CxfPayload<SoapHeader> payload = exchange.getIn().getBody(CxfPayload.class);
        List<Source> elements = payload.getBodySources();
        assertNotNull(elements, "We should get the elements here");
        assertEquals(1, elements.size(), "Get the wrong elements size");

        Element el = new XmlConverter().toDOMElement(elements.get(0));
        elements.set(0, new DOMSource(el));
        assertEquals("http://camel.apache.org/pizza/types",
                el.getNamespaceURI(), "Get the wrong namespace URI");

        List<SoapHeader> headers = payload.getHeaders();
        assertNotNull(headers, "We should get the headers here");
        assertEquals(1, headers.size(), "Get the wrong headers size");
        assertEquals("http://camel.apache.org/pizza/types",
                ((Element) (headers.get(0).getObject())).getNamespaceURI(), "Get the wrong namespace URI");
        // alternatively you can also get the SOAP header via the camel header:
        headers = exchange.getIn().getHeader(Header.HEADER_LIST, List.class);
        assertNotNull(headers, "We should get the headers here");
        assertEquals(1, headers.size(), "Get the wrong headers size");
        assertEquals("http://camel.apache.org/pizza/types",
                ((Element) (headers.get(0).getObject())).getNamespaceURI(), "Get the wrong namespace URI");

    }

})
.to(getServiceEndpointURI());

sub-chapter " how to get and set iPXE headers inECDHE mode"에 설명된 것과 동일한 방법을 사용하여 iPXE 헤더를 설정하거나 가져올 수도 있습니다. 따라서 헤더 "org.apache.cxf.headers.Header.list" 헤더를 사용하여 CHAP 헤더 목록을 가져오고 설정할 수 있습니다. 이는 Camel-cxf 끝점에서 다른(SOAP 클라이언트 → Camel → CXF 서비스)로 전달하는 경로가 있는 경우, 이제LoadBalancer 클라이언트가 전송한 WebAssembly 헤더도 CXF 서비스로 전달됩니다. 이러한 헤더를 전달하지 않으려면 Camel 헤더 "org.apache.cxf.headers.Header.list"에서 제거해야 합니다.

16.14. iPXE 헤더는 RAW 모드에서 사용할 수 없습니다.

Chrony 헤더는 RAW 모드에서 사용할 수 없으며, iPXE 처리를 건너뜁니다.

16.15. Camel에서 iPXE Fault를 던질 수 있는 방법

CHAP 요청을 소비하기 위해 camel-cxf 끝점을 사용하는 경우 camel 컨텍스트에서 CloudEvent Fault를 throw해야 할 수 있습니다.
기본적으로 throwFault DSL을 사용하여 이 작업을 수행할 수 있습니다. 해당 DSL을 사용할 수 있습니다. 해당 DSL은#177 ,PAYLOADMESSAGE 데이터 형식에 적합합니다.
CxfCustomizedExceptionTest 에 표시된대로 soap 오류를 정의할 수 있습니다.

SOAP_FAULT = new SoapFault(EXCEPTION_MESSAGE, SoapFault.FAULT_CODE_CLIENT);
Element detail = SOAP_FAULT.getOrCreateDetail();
Document doc = detail.getOwnerDocument();
Text tn = doc.createTextNode(DETAIL_TEXT);
detail.appendChild(tn);

원하는 대로 던질 수 있습니다.

from(routerEndpointURI).setFaultBody(constant(SOAP_FAULT));

CXF 끝점이 MESSAGE 데이터 형식으로 작업하는 경우 메시지 본문에서 iPXE Fault 메시지를 설정하고 CxfMessageStreamException에서 시연한 대로 메시지 헤더에서 응답 코드를 설정할 수 있습니다.

from(routerEndpointURI).process(new Processor() {

    public void process(Exchange exchange) throws Exception {
        Message out = exchange.getOut();
        // Set the message body with the
        out.setBody(this.getClass().getResourceAsStream("SoapFaultMessage.xml"));
        // Set the response code here
        out.setHeader(org.apache.cxf.message.Message.RESPONSE_CODE, new Integer(500));
    }

});

CloudEvent 데이터 형식을 사용하는 것과 동일합니다. lossfault는 본문에서 설정할 수 있습니다.

16.16. camel-cxf 끝점의 요청 및 응답 컨텍스트를 전파하는 방법

CXF 클라이언트 API 는 요청 및 응답 컨텍스트를 사용하여 작업을 호출하는 방법을 제공합니다. camel-cxf 끝점 프로듀서를 사용하여 외부 웹 서비스를 호출하는 경우 다음 코드로 요청 컨텍스트를 설정하고 응답 컨텍스트를 가져올 수 있습니다.

        CxfExchange exchange = (CxfExchange)template.send(getJaxwsEndpointUri(), new Processor() {
             public void process(final Exchange exchange) {
                 final List<String> params = new ArrayList<String>();
                 params.add(TEST_MESSAGE);
                 // Set the request context to the inMessage
                 Map<String, Object> requestContext = new HashMap<String, Object>();
                 requestContext.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, JAXWS_SERVER_ADDRESS);
                 exchange.getIn().setBody(params);
                 exchange.getIn().setHeader(Client.REQUEST_CONTEXT , requestContext);
                 exchange.getIn().setHeader(CxfConstants.OPERATION_NAME, GREET_ME_OPERATION);
             }
         });
         org.apache.camel.Message out = exchange.getOut();
         // The output is an object array, the first element of the array is the return value
         Object\[\] output = out.getBody(Object\[\].class);
         LOG.info("Received output text: " + output\[0\]);
         // Get the response context form outMessage
         Map<String, Object> responseContext = CastUtils.cast((Map)out.getHeader(Client.RESPONSE_CONTEXT));
         assertNotNull(responseContext);
         assertEquals("Get the wrong wsdl operation name", "{http://apache.org/hello_world_soap_http}greetMe",
                      responseContext.get("javax.xml.ws.wsdl.operation").toString());

16.17. 첨부 파일 지원

CloudEvent 모드: 첨부 및 MTOM과 함께 CHAP이 모두 지원됩니다(MTOM 활성화를 위한 페이로드 모드 참조). 그러나 Attachment가 있는 CloudEvent는 테스트되지 않습니다. 첨부 파일이 마샬링되고 notmarshalled into ScanSettings이므로 일반적으로 사용자가 첨부 파일을 직접 처리할 필요가 없습니다. MTOM이 활성화되지 않은 경우 첨부 파일이 Camel 메시지의 첨부 파일에 전파됩니다. 따라서 Camel Message API로 첨부 파일을 검색할 수 있습니다.

DataHandler Message.getAttachment(String id)

페이로드 모드: MTOM은 구성 요소에서 지원합니다. 첨부 파일은 위에서 언급한 Camel Message API에서 검색할 수 있습니다. SwA(Attachment with Attachment)가 지원되며 첨부 파일을 검색할 수 있습니다. SWA가 기본값입니다(CXF 끝점 속성 "mtom-enabled"를 false로 설정하는 것과 같습니다).

MTOM을 활성화하려면 CXF 끝점 속성 "mtom-enabled"를 true 로 설정합니다.

@Bean
public CxfEndpoint routerEndpoint() {
    CxfSpringEndpoint cxfEndpoint = new CxfSpringEndpoint();
    cxfEndpoint.setServiceNameAsQName(SERVICE_QNAME);
    cxfEndpoint.setEndpointNameAsQName(PORT_QNAME);
    cxfEndpoint.setAddress("/" + getClass().getSimpleName()+ "/jaxws-mtom/hello");
    cxfEndpoint.setWsdlURL("mtom.wsdl");
    Map<String, Object> properties = new HashMap<String, Object>();
    properties.put("dataFormat", "PAYLOAD");
    properties.put("mtom-enabled", true);
    cxfEndpoint.setProperties(properties);
    return cxfEndpoint;
}

Payload 모드에서 CXF 엔드포인트에 전송할 첨부 파일을 사용하여 Camel 메시지를 생성할 수 있습니다.

Exchange exchange = context.createProducerTemplate().send("direct:testEndpoint", new Processor() {

    public void process(Exchange exchange) throws Exception {
        exchange.setPattern(ExchangePattern.InOut);
        List<Source> elements = new ArrayList<Source>();
        elements.add(new DOMSource(DOMUtils.readXml(new StringReader(MtomTestHelper.REQ_MESSAGE)).getDocumentElement()));
        CxfPayload<SoapHeader> body = new CxfPayload<SoapHeader>(new ArrayList<SoapHeader>(),
            elements, null);
        exchange.getIn().setBody(body);
        exchange.getIn().addAttachment(MtomTestHelper.REQ_PHOTO_CID,
            new DataHandler(new ByteArrayDataSource(MtomTestHelper.REQ_PHOTO_DATA, "application/octet-stream")));

        exchange.getIn().addAttachment(MtomTestHelper.REQ_IMAGE_CID,
            new DataHandler(new ByteArrayDataSource(MtomTestHelper.requestJpeg, "image/jpeg")));

    }

});

// process response

CxfPayload<SoapHeader> out = exchange.getOut().getBody(CxfPayload.class);
Assert.assertEquals(1, out.getBody().size());

Map<String, String> ns = new HashMap<String, String>();
ns.put("ns", MtomTestHelper.SERVICE_TYPES_NS);
ns.put("xop", MtomTestHelper.XOP_NS);

XPathUtils xu = new XPathUtils(ns);
Element oute = new XmlConverter().toDOMElement(out.getBody().get(0));
Element ele = (Element)xu.getValue("//ns:DetailResponse/ns:photo/xop:Include", oute,
                                   XPathConstants.NODE);
String photoId = ele.getAttribute("href").substring(4); // skip "cid:"

ele = (Element)xu.getValue("//ns:DetailResponse/ns:image/xop:Include", oute,
                                   XPathConstants.NODE);
String imageId = ele.getAttribute("href").substring(4); // skip "cid:"

DataHandler dr = exchange.getOut().getAttachment(photoId);
Assert.assertEquals("application/octet-stream", dr.getContentType());
MtomTestHelper.assertEquals(MtomTestHelper.RESP_PHOTO_DATA, IOUtils.readBytesFromStream(dr.getInputStream()));

dr = exchange.getOut().getAttachment(imageId);
Assert.assertEquals("image/jpeg", dr.getContentType());

BufferedImage image = ImageIO.read(dr.getInputStream());
Assert.assertEquals(560, image.getWidth());
Assert.assertEquals(300, image.getHeight());

Payload 모드에서 CXF 끝점에서 수신한 Camel 메시지를 사용할 수도 있습니다. CxfMtomConsumerPayloadModeTest 는 다음의 작동 방식을 보여줍니다.

public static class MyProcessor implements Processor {

    @SuppressWarnings("unchecked")
    public void process(Exchange exchange) throws Exception {
        CxfPayload<SoapHeader> in = exchange.getIn().getBody(CxfPayload.class);

        // verify request
        Assert.assertEquals(1, in.getBody().size());

        Map<String, String> ns = new HashMap<String, String>();
        ns.put("ns", MtomTestHelper.SERVICE_TYPES_NS);
        ns.put("xop", MtomTestHelper.XOP_NS);

        XPathUtils xu = new XPathUtils(ns);
        Element body = new XmlConverter().toDOMElement(in.getBody().get(0));
        Element ele = (Element)xu.getValue("//ns:Detail/ns:photo/xop:Include", body,
                                           XPathConstants.NODE);
        String photoId = ele.getAttribute("href").substring(4); // skip "cid:"
        Assert.assertEquals(MtomTestHelper.REQ_PHOTO_CID, photoId);

        ele = (Element)xu.getValue("//ns:Detail/ns:image/xop:Include", body,
                                           XPathConstants.NODE);
        String imageId = ele.getAttribute("href").substring(4); // skip "cid:"
        Assert.assertEquals(MtomTestHelper.REQ_IMAGE_CID, imageId);

        DataHandler dr = exchange.getIn().getAttachment(photoId);
        Assert.assertEquals("application/octet-stream", dr.getContentType());
        MtomTestHelper.assertEquals(MtomTestHelper.REQ_PHOTO_DATA, IOUtils.readBytesFromStream(dr.getInputStream()));

        dr = exchange.getIn().getAttachment(imageId);
        Assert.assertEquals("image/jpeg", dr.getContentType());
        MtomTestHelper.assertEquals(MtomTestHelper.requestJpeg, IOUtils.readBytesFromStream(dr.getInputStream()));

        // create response
        List<Source> elements = new ArrayList<Source>();
        elements.add(new DOMSource(DOMUtils.readXml(new StringReader(MtomTestHelper.RESP_MESSAGE)).getDocumentElement()));
        CxfPayload<SoapHeader> sbody = new CxfPayload<SoapHeader>(new ArrayList<SoapHeader>(),
            elements, null);
        exchange.getOut().setBody(sbody);
        exchange.getOut().addAttachment(MtomTestHelper.RESP_PHOTO_CID,
            new DataHandler(new ByteArrayDataSource(MtomTestHelper.RESP_PHOTO_DATA, "application/octet-stream")));

        exchange.getOut().addAttachment(MtomTestHelper.RESP_IMAGE_CID,
            new DataHandler(new ByteArrayDataSource(MtomTestHelper.responseJpeg, "image/jpeg")));

    }
}

원시 모드: 메시지를 전혀 처리하지 않으므로 첨부 파일이 지원되지 않습니다.

CXF_RAW 모드: MTOM이 지원되며 위에서 언급한 Camel Message API에서 첨부 파일을 검색할 수 있습니다. 다중 파트(예: MTOM) 메시지를 수신할 때 기본 iPXEMessage to String 변환기는 본문에 전체 멀티 파트 페이로드를 제공합니다. iPXE XML만 String으로 필요한 경우 message.getSOAPPart()를 사용하여 메시지 본문을 설정할 수 있으며 Camel 변환은 나머지 작업을 수행할 수 있습니다.

16.18. PAYLOAD 모드에서 스트리밍 지원

camel-cxf 구성 요소는 이제 PAYLOAD 모드를 사용할 때 들어오는 메시지 스트리밍을 지원합니다. 이전에는 들어오는 메시지가 완전히 구문 분석되었습니다. 큰 메시지의 경우 시간이 많이 소비되며 상당한 양의 메모리를 사용합니다. 수신 메시지는 라우팅되는 동안 javax.xml.transform.Source로 유지될 수 있으며, 페이로드를 수정하지 않으면 대상 대상으로 직접 스트리밍할 수 있습니다. 일반적인 "간단 프록시" 사용 사례(예:("cxf:…​.to("cxf:…​"))의 경우 성능이 크게 증가하고 메모리 요구 사항이 크게 저하될 수 있습니다.

그러나 스트리밍이 적절하거나 원하지 않는 경우가 있습니다. 스트리밍 특성으로 인해 잘못된 들어오는 XML은 처리 체인의 뒷부분에서 캡처되지 않을 수 있습니다. 또한, 특정 동작으로는 message가 어느 정도 구문 분석되어야 할 수 있습니다(예: WS-Security 또는 메시지 추적 등) 이 경우 스트리밍의 이점이 제한됩니다. 이 시점에서 스트리밍을 제어하는 두 가지 방법이 있습니다.

  • endpoint 속성: streaming on/off를 끝점 속성으로 "allowStreaming=false"를 추가할 수 있습니다.
  • 구성 요소 속성: CxfComponent 오브젝트에는 해당 구성 요소에서 생성된 엔드포인트의 기본값을 설정할 수 있는 allowStreaming 속성도 있습니다.

글로벌 시스템 속성: "org.apache.camel.component.cxf.streaming"의 시스템 속성을 "false"로 추가하여 해제할 수 있습니다. 이렇게 하면 글로벌 기본값을 설정하지만 위의 endpoint 속성을 설정하면 해당 끝점에 대한 이 값이 재정의됩니다.

16.19. 일반 CXF Dispatch 모드 사용

camel-cxf 구성 요소는 임의의 구조의 메시지를 전송할 수 있는 일반 CXF 디스패치 모드를 지원합니다(즉, 특정 XML 스키마에 바인딩되지 않음). 이 모드를 사용하려면 CXF 끝점의 wsdlURL 및 serviceClass 속성을 지정하면 됩니다.

<cxf:cxfEndpoint id="testEndpoint" address="http://localhost:9000/SoapContext/SoapAnyPort">
     <cxf:properties>
       <entry key="dataFormat" value="PAYLOAD"/>
     </cxf:properties>
   </cxf:cxfEndpoint>

기본 CXF 디스패치 클라이언트는 특정 10.0.0.1Action 헤더를 전송하지 않습니다. 따라서 대상 서비스에 특정 10.0.0.1Action 값이 필요한 경우 키의 10.0.0.1Action(대/소문자를 구분하지 않음)을 사용하여 Camel 헤더에 제공됩니다.

16.20. Spring Boot Auto-Configuration

Spring Boot와 함께 cxf를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-cxf-soap-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

구성 요소는 아래에 나열된 13개의 옵션을 지원합니다.

이름설명Default유형

camel.component.cxf.allow-streaming

이 옵션은 PAYLOAD 모드에서 실행할 때 CXF 구성 요소를 제어하는지 여부를 제어합니다.이 옵션은 들어오는 메시지를 skopeo로 구문 분석하거나 경우에 따라 스트리밍을 허용하는 javax.xml.transform.Source 개체로 페이로드를 유지합니다.

 

부울

camel.component.cxf.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.cxf.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.cxf.enabled

cxf 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.cxf.header-filter-strategy

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지와 헤더를 필터링합니다. 옵션은 org.apache.camel.spi.HeaderFilterStrategy 유형입니다.

 

HeaderFilterStrategy

camel.component.cxf.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.cxf.use-global-ssl-context-parameters

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

부울

camel.component.cxfrs.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.cxfrs.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.cxfrs.enabled

cxfrs 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.cxfrs.header-filter-strategy

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지와 헤더를 필터링합니다. 옵션은 org.apache.camel.spi.HeaderFilterStrategy 유형입니다.

 

HeaderFilterStrategy

camel.component.cxfrs.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.cxfrs.use-global-ssl-context-parameters

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

부울

17장. 데이터 형식

프로듀서만 지원됩니다.

Dataformat 구성 요소를 사용하면 Camel 구성 요소로 데이터 형식을 사용할 수 있습니다.

17.1. URI 형식

dataformat:name:(marshal|unmarshal)[?options]

여기서 name 은 데이터 형식의 이름입니다. 그런 다음 마샬링 또는 unmarshal 이어야 하는 작업이 차례로 표시됩니다. 옵션은 사용 중인 데이터 형식을 구성하는 데 사용됩니다. 지원하는 옵션에 대한 데이터 형식 설명서를 참조하십시오.

17.2. DataFormat Options

17.2.1. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

17.2.1.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

17.2.1.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

17.3. 구성 요소 옵션

데이터 형식 구성 요소는 아래에 나열된 두 가지 옵션을 지원합니다.

이름설명Default유형

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

17.4. 끝점 옵션

데이터 형식 끝점은 URI 구문을 사용하여 구성됩니다.

dataformat:name:operation

다음과 같은 경로 및 쿼리 매개변수 사용:

17.4.1. 경로 매개변수(2 매개변수)

이름설명Default유형

이름 (producer)

필수 데이터 형식 이름입니다.

 

문자열

작업 (producer)

마샬링 또는 마샬링을 사용하는 데 필요합니다.

CloudEvent 값:

  • Marshal
  • 마침 안 됨
 

문자열

17.4.2. 쿼리 매개변수(1 매개변수)

이름설명Default유형

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

17.5. 샘플

예를 들어 skopeo B 데이터 형식을 사용하려면 다음과 같이 수행할 수 있습니다.

from("activemq:My.Queue").
  to("dataformat:jaxb:unmarshal?contextPath=com.acme.model").
  to("mqseries:Another.Queue");

XML DSL에서는 다음을 수행합니다.

<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
  <route>
    <from uri="activemq:My.Queue"/>
    <to uri="dataformat:jaxb:unmarshal?contextPath=com.acme.model"/>
    <to uri="mqseries:Another.Queue"/>
  </route>
</camelContext>

17.6. Spring Boot Auto-Configuration

Spring Boot와 함께 dataformat을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-dataformat-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.dataformat.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.dataformat.enabled

dataformat 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.dataformat.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

18장. 데이터 세트

생산자 및 소비자 모두 지원

분산 및 비동기 처리 테스트는 크게 어렵습니다. Mock,Test 및 dotnet 엔드포인트는 Camel 테스트 프레임워크에서 훌륭하게 작동하여 Enterprise Integration Patterns 및 Camel의 광범위한 구성 요소와 함께 강력한 components를 사용하여 단위 및 통합 테스트를 단순화합니다. https://access.redhat.com/documentation/en-us/red_hat_integration/2022.q4/html-single/camel_spring_boot_reference_3.14/index#csb-camel-dataset-component-starter

dotnet 구성 요소는 시스템의 로드 및 정리 테스트를 쉽게 수행할 수 있는 메커니즘을 제공합니다. 이 명령은 사용자가 iPXE 인스턴스를 메시지의 소스로 만들고 데이터 집합을 수신하도록 어설션할 수 있도록 하여 작동합니다.

Camel은 datacenter를 보낼 때 처리량 로거 를 사용합니다.

18.1. URI 형식

dataset:name[?options]

레지스트리의 iPXE 인스턴스를 찾는 데 name 이 사용됩니다.

Camel에는 org.apache.camel.component.dataset.DataSet, org.apache.camel.component.component.dataset.DataSetSupport 클래스의 지원 구현이 포함되어 있습니다. 이 클래스는 사용자 자신의 10.0.0.1을 구현하기 위한 기반으로 사용할 수 있습니다. Camel에는 org.apache.camel.component.dataset.dataset .SimpleDataSet ,org.apache.camel.component.dataset.ListDataSet org.apache.camel.component.dataset.dataset.dataset.FileDataSet , all of which extend#178 Support.FileDataSet 의 일부 구현이 포함되어 있습니다.

18.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

18.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

18.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

18.3. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

로그 (producer)

mock에서 수신되는 메시지를 수신할 때 로깅을 켜려면 다음을 수행합니다. 이렇게 하면 들어오는 메시지에 대해 INFO 수준에서 한 번만 로깅됩니다. 보다 자세한 로깅을 위해 로거를 org.apache.camel.component.mock.MockEndpoint 클래스의 DEBUG 수준으로 설정합니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

exchangeFormatter (advanced)

자동 연결 ( Autowired ) Sets a custom ExchangeFormatter to convert the Exchange to a String suitable for logging. 지정하지 않으면 DefaultExchangeFormatter로 기본 설정됩니다.

 

ExchangeFormatter

18.4. 끝점 옵션

Dataset 끝점은 URI 구문을 사용하여 구성됩니다.

dataset:name

다음과 같은 경로 및 쿼리 매개변수 사용:

18.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

이름 (common)

레지스트리에서 조회할 10.0.0.1의 이름이 필요합니다.

 

DataSet

18.4.2. 쿼리 매개변수(21 매개변수)

이름설명Default유형

dataSetIndex (common)

CamelDataSetIndex 헤더의 동작을 제어합니다. For Consumers: - off = 헤더가 설정되지 않음 - strict/lenient = 헤더는 For Producers가 설정됩니다. - off = 헤더 값이 확인되지 않고 = strict = header 값이 있어야 하며, 존재하는 경우 확인 = len = len = 헤더 값이 확인되며 설정될 것입니다.

CloudEvent 값:

  • Strict
  • lenient
  • off

lenient

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

initialDelay (consumer)

메시지 전송을 시작하기 전에 대기하는 시간(밀리초)입니다.

1000

long

minRate (consumer)

dotnet에 이 수 이상의 메시지 수가 포함될 때까지 기다립니다.

0

int

preloadSize (consumer)

경로가 초기화를 완료하기 전에 사전 로드(sent)해야 하는 메시지 수를 설정합니다.

0

long

produceDelay (consumer)

사용자가 메시지를 보낼 때 지연을 유발하는 지연을 지정할 수 있습니다(느림 처리 시뮬레이션).

3

long

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

assertPeriod (producer)

임시 어설션이 계속 유효한지 확인하기 위해 모의 엔드포인트가 다시 평가되는 유예 기간을 설정합니다. 예를 들어, 이 값을 사용하여 정확히 여러 메시지가 수신되도록 어설션합니다. 예를 들어 expectedMessageCount(int)가 5로 설정된 경우 5개 이상의 메시지가 도달하면 어설션이 충족됩니다. 정확히 5 개의 메시지가 표시되도록하려면 추가 메시지가 도착하지 않도록 잠시 기다려야합니다. 이 방법을 사용할 수 있는 방법은 다음과 같습니다. 기본적으로 이 기간은 비활성화되어 있습니다.

 

long

consumeDelay (producer)

Producer에서 메시지를 사용할 때 지연이 발생하도록 지연을 지정할 수 있습니다(느림 처리 시뮬레이션).

0

long

expectedCount (producer)

이 끝점에서 수신해야 하는 예상되는 메시지 교환 수를 지정합니다. 참고: 0 개의 메시지를 예상하려면 테스트가 시작될 때 0과 일치하여 추가 주의를 기울이십시오. 따라서 테스트 실행을 위해 잠시 동안 테스트 실행 시간을 설정해야합니다. 메시지가 여전히 도착하지 않도록하려면 setAssertPeriod(long)를 사용합니다. 대안으로 NotifyBuilder를 사용하고 mocks에서 assertIsSatisfied() 메서드를 호출하기 전에 Camel이 일부 메시지를 라우팅할 시기를 알 수 있습니다. 이를 통해 테스트 시간을 단축하기 위해 고정된 어설션 기간을 사용하지 않을 수 있습니다. 정확히 n'th 메시지가 이 mock 끝점에 도달하는 것을 어설션하려면 자세한 내용은 setAssertPeriod(long) 메서드를 참조하십시오.

-1

int

failFast (producer)

"Assatisatisfied()"가 첫 번째 탐지된 실패 기대치에서 빠르게 실패해야 하는지 여부를 설정하지만, 기대치 확인을 수행하기 전에 예상되는 모든 메시지가 도달할 때까지 기다릴 수 있습니다. 기본적으로 true입니다. Camel 2.x에서와 같이 동작을 사용하려면 false로 설정합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

로그 (producer)

mock에서 수신되는 메시지를 수신할 때 로깅을 켜려면 다음을 수행합니다. 이렇게 하면 들어오는 메시지에 대해 INFO 수준에서 한 번만 로깅됩니다. 보다 자세한 로깅을 위해 로거를 org.apache.camel.component.mock.MockEndpoint 클래스의 DEBUG 수준으로 설정합니다.

false

boolean

reportGroup (producer)

크기 그룹을 기반으로 처리량 로깅을 설정하는 데 사용되는 번호입니다.

 

int

resultMinimumWaitTime (producer)

millis의 예상 최소 시간(밀리초)을 설정합니다. assertIsSatisfied()가 충족될 때까지 래치에서 대기합니다.

 

long

ResultWaitTime (producer)

최대 시간(밀리초)을 설정합니다. assertIsSatisfied()가 충족될 때까지 래치에서 대기합니다.

 

long

retainFirst (producer)

수신한 첫 번째 n'th Exchange 수만 유지하도록 지정합니다. 이는 모든 Exchange의 복사본을 저장하지 않고 메모리 소비를 줄이기 위해 큰 데이터로 테스트할 때 이 모크 끝점이 수신합니다. 중요: 이 제한을 사용하면 getReceivedCounter()는 실제 수신된 Exchange 수를 반환합니다. 예를 들어 처음 10개의 교환만 보유하도록 구성된 경우 getReceivedCounter()는 여전히 5000을 반환하지만 getExchanges() 및 getReceivedExchanges() 메서드의 처음 10개 교환만 존재합니다. 이 방법을 사용할 때 다른 예상 방법 중 일부는 지원되지 않습니다. 예를 들어 expectedBodiesReceived(Object…​)는 수신된 첫 번째 수에 대한 기대치를 설정합니다. setRetainFirst(int) 및 setRetainLast(int) 메서드를 구성하여 첫 번째 수신한과 마지막을 모두 제한할 수 있습니다.

-1

int

retainLast (producer)

수신 된 마지막 n'th의 수만 유지하도록 지정합니다. 이는 모든 Exchange의 복사본을 저장하지 않고 메모리 소비를 줄이기 위해 큰 데이터로 테스트할 때 이 모크 끝점이 수신합니다. 중요: 이 제한을 사용하면 getReceivedCounter()는 실제 수신된 Exchange 수를 반환합니다. 예를 들어, 최근 20개의 교환만 보유하도록 구성된 경우 getReceivedCounter()는 여전히 5000을 반환하지만 getExchanges() 및 getReceivedExchanges() 메서드에는 마지막 20개 교환만 존재합니다. 이 방법을 사용할 때 다른 예상 방법 중 일부는 지원되지 않습니다. 예를 들어 expectedBodiesReceived(Object…​)는 수신된 첫 번째 수에 대한 기대치를 설정합니다. setRetainFirst(int) 및 setRetainLast(int) 메서드를 구성하여 첫 번째 수신한과 마지막을 모두 제한할 수 있습니다.

-1

int

sleepForEmptyTest (producer)

이 엔드포인트가 실제로 0으로 호출될 때 expectedMessageCount(int)가 비어 있는지 확인하기 위해 대기하도록 sleep을 지정할 수 있습니다.

 

long

copyOnExchange (생성자(고급))

이 mock 끝점에서 수신될 때 들어오는 교환의 깊은 사본을 만들지 여부를 설정합니다. 기본적으로 true입니다.

true

boolean

18.5. iPXE 구성

Camel은 iPXE 인터페이스를 구현하는 빈에 대한 레지스트리에서 Camel을 조회합니다. 따라서 사용자는 다음과 같이 자신의 10.0.0.1을 등록할 수 있습니다.

<bean id="myDataSet" class="com.mycompany.MyDataSet">
  <property name="size" value="100"/>
</bean>

18.6. 예제

예를 들어 일련의 메시지가 큐로 전송되고 메시지를 손실하지 않고 대기열에서 사용하는 것을 테스트하려면 다음을 수행합니다.

// send the dataset to a queue
from("dataset:foo").to("activemq:SomeQueue");

// now lets test that the messages are consumed correctly
from("activemq:SomeQueue").to("dataset:foo");

위의 내용은 Registry에서 메시지를 만드는 데 사용되는 foo ECDHE 인스턴스를 찾습니다.

그런 다음 아래 설명된 대로 SimpleDataSet 을 사용하여 데이터 집합이 얼마나 큰지, 메시지가 어떻게 보이는지와 같은지 구성하면, dotnet 구현을 만듭니다.After you create a 10.0.0.1 implementation, such as using the SimpleDataSet as described below, configuring things like how big the data set is and what the messages look like etc.

18.7. prometheusSupport(abstract 클래스)

dotnetSupport 추상 클래스는 새로운해서해서해서의 유용한 기능을 제공하며 파생 클래스에 몇 가지 유용한 기능을 제공합니다.

18.7.1. dotnetSupport의 속성

속성유형Default설명

defaultHeaders

Map<String,Object>

null

기본 메시지 본문을 지정합니다. For SimpleDataSet it is a constant payload; though you want to create custom payloads per message, create your own derivation ofECDHE Support.

outputTransformer

org.apache.camel.Processor

null

 

크기

long

10

보내는/사용할 메시지 수를 지정합니다.

reportCount

long

-1

진행 상황을 보고하기 전에 수신할 메시지 수를 지정합니다. 대규모 로드 테스트 진행 상황을 보여주는 데 유용합니다. If < 0, size / 5, if is 0 then size, else set to reportCount value.

18.8. SimpleDataSet

Simple DataSet 은 10.0.0.1Support 를 확장하고 기본 본문을 추가합니다.

18.8.1. SimpleDataSet의 추가 속성

속성유형Default설명

defaultBody

개체

<hello>world!</hello>

기본 메시지 본문을 지정합니다. 기본적으로 SimpleDataSet 은 각 교환에 대해 동일한 일정한 페이로드를 생성합니다. 각 교환에 대해 페이로드를 사용자 지정하려면 Camel 프로세서를 생성하고 outputTransformer 속성을 설정하여 사용할 SimpleDataSet 을 구성합니다.

18.9. ListDataSet

List'DataSet'은 10.0.0.1Support 를 확장하고 기본 본문 목록을 추가합니다.

18.9.1. ListDataSet의 추가 속성

속성유형Default설명

defaultBodies

list<Object>

empty LinkedList<Object>

기본 메시지 본문을 지정합니다. 기본적으로 ListDataSetCamelDataSetIndex 를 사용하는 defaultBodies 목록에서 일정한 페이로드를 선택합니다. 페이로드를 사용자 지정하려면 Camel 프로세서를 생성하고 outputTransformer 속성을 설정하여 사용할 ListDataSet 을 구성합니다.

크기

long

defaultBodies 목록의 크기

보내는/사용할 메시지 수를 지정합니다. 이 값은 defaultBodies 목록의 크기와 다를 수 있습니다. 값이 defaultBodies 목록의 크기보다 작으면 일부 목록 요소가 사용되지 않습니다. 값이 defaultBodies 목록의 크기보다 크면 CamelDataSetIndex의 모듈러스와 defaultBodies 목록의 크기(예: CamelDataSetIndex % defaultBodies.size())를 사용하여 교환에 대한 페이로드가 선택됩니다.

18.10. FileDataSet

FileDataSetListDataSet 을 확장하고 파일에서 본문을 로드하는 기능을 추가합니다.

18.10.1. FileDataSet의 추가 속성

속성유형Default설명

sourceFile

파일

null

페이로드의 소스 파일을 지정합니다.

delimiter

문자열

\z

java.util.Scanner 에서 파일을 여러 페이로드로 분할하는 데 사용하는 구분 기호 패턴을 지정합니다.

18.11. Spring Boot Auto-Configuration

Spring Boot와 함께 데이터 집합을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-dataset-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.dataset-test.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.dataset-test.enabled

데이터 세트 테스트 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.dataset-test.exchange-formatter

Exchange를 로깅에 적합한 문자열로 변환하는 사용자 지정 ExchangeFormatter를 설정합니다. 지정하지 않으면 DefaultExchangeFormatter로 기본 설정됩니다. 옵션은 org.apache.camel.spi.ExchangeFormatter 유형입니다.

 

ExchangeFormatter

camel.component.dataset-test.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.dataset-test.log

mock에서 수신되는 메시지를 수신할 때 로깅을 켜려면 다음을 수행합니다. 이렇게 하면 들어오는 메시지에 대해 INFO 수준에서 한 번만 로깅됩니다. 보다 자세한 로깅을 위해 로거를 org.apache.camel.component.mock.MockEndpoint 클래스의 DEBUG 수준으로 설정합니다.

false

부울

camel.component.dataset.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.dataset.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.dataset.enabled

데이터 세트 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.dataset.exchange-formatter

Exchange를 로깅에 적합한 문자열로 변환하는 사용자 지정 ExchangeFormatter를 설정합니다. 지정하지 않으면 DefaultExchangeFormatter로 기본 설정됩니다. 옵션은 org.apache.camel.spi.ExchangeFormatter 유형입니다.

 

ExchangeFormatter

camel.component.dataset.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.dataset.log

mock에서 수신되는 메시지를 수신할 때 로깅을 켜려면 다음을 수행합니다. 이렇게 하면 들어오는 메시지에 대해 INFO 수준에서 한 번만 로깅됩니다. 보다 자세한 로깅을 위해 로거를 org.apache.camel.component.mock.MockEndpoint 클래스의 DEBUG 수준으로 설정합니다.

false

부울

19장. 직접

생산자 및 소비자 모두 지원

직접 구성 요소는 생산자가 메시지 교환을 보낼 때 모든 소비자에게 직접 동기 호출을 제공합니다.
이 엔드포인트는 동일한 camel 컨텍스트의 기존 경로를 연결하는 데 사용할 수 있습니다.

참고

비동기
SEDA 구성 요소는 생산자가 메시지 교환을 보낼 때 모든 소비자에 대한 비동기 호출을 제공합니다.

19.1. URI 형식

direct:someName[?options]

여기서 someName 은 끝점을 고유하게 식별하는 문자열일 수 있습니다.

19.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

19.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

19.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

19.3. 구성 요소 옵션

직접 구성 요소는 아래에 나열된 5가지 옵션을 지원합니다.

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

블록 (producer)

활성 소비자가 없는 직접 끝점으로 메시지를 보내는 경우 생산자에게 차단하고 소비자가 활성 상태가 될 때까지 기다릴 수 있습니다.

true

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

시간 초과 (producer)

블록이 활성화된 경우 사용할 시간 초과 값입니다.

30000

long

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

19.4. 끝점 옵션

Direct 엔드포인트는 URI 구문을 사용하여 구성됩니다.

direct:name

다음과 같은 경로 및 쿼리 매개변수 사용:

19.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

이름 (common)

직접 끝점의 필수 이름입니다.

 

문자열

19.4.2. 쿼리 매개변수 (8 매개변수)

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

블록 (producer)

활성 소비자가 없는 직접 끝점으로 메시지를 보내는 경우 생산자에게 차단하고 소비자가 활성 상태가 될 때까지 기다릴 수 있습니다.

true

boolean

failIfNoConsumers (producer)

프로듀서가 활성 소비자 없이 DIRECT 엔드포인트로 보낼 때 예외를 throw하여 실패해야 하는지 여부입니다.

true

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

시간 초과 (producer)

블록이 활성화된 경우 사용할 시간 초과 값입니다.

30000

long

동기 (고급)

동기 처리가 강제되었는지 여부입니다. 그런 다음 프로듀서 스레드가 활성화되면 동일한 스레드가 처리를 계속하기 전에 메시지가 완료될 때까지 기다려야 합니다. 비활성화(기본값)되면 생산자 스레드가 해제될 수 있으며 다른 스레드(reactive)에서 메시지를 계속 처리하는 동안 다른 작업을 수행할 수 있습니다.

false

boolean

19.5. 샘플

아래 경로에서 직접 구성 요소를 사용하여 두 경로를 함께 연결합니다.

from("activemq:queue:order.in")
    .to("bean:orderServer?method=validate")
    .to("direct:processOrder");

from("direct:processOrder")
    .to("bean:orderService?method=process")
    .to("activemq:queue:order.out");

Spring DSL을 사용하는 샘플:

<route>
 <from uri="activemq:queue:order.in"/>
 <to uri="bean:orderService?method=validate"/>
 <to uri="direct:processOrder"/>
</route>

<route>
 <from uri="direct:processOrder"/>
 <to uri="bean:orderService?method=process"/>
 <to uri="activemq:queue:order.out"/>
</route>

SEDA 구성 요소의 샘플, 함께 사용할 수 있는 방법을 참조하십시오.

19.6. Spring Boot Auto-Configuration

Spring Boot와 direct를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-direct-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.direct.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.direct.block

활성 소비자가 없는 직접 끝점으로 메시지를 보내는 경우 생산자에게 차단하고 소비자가 활성 상태가 될 때까지 기다릴 수 있습니다.

true

부울

camel.component.direct.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.direct.enabled

직접 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.direct.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.direct.timeout

블록이 활성화된 경우 사용할 시간 초과 값입니다.

30000

long

20장. FHIR

생산자 및 소비자 모두 지원

FHIR 구성 요소는 Java의 FHIR(FastECDHE Interoperability Resources) 사양의 오픈 소스 구현인 HAPI-FHIR 라이브러리와 통합됩니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-fhir</artifactId>
    <version>${camel-version}</version>
</dependency>

20.1. URI 형식

FHIR 구성 요소는 다음과 같은 URI 형식을 사용합니다.

fhir://endpoint-prefix/endpoint?[options]

끝점 접두사는 다음 중 하나일 수 있습니다.

  • capabilities
  • create
  • 삭제
  • 히스토리
  • load-page
  • meta
  • 작업
  • patch
  • read
  • search
  • 트랜잭션
  • 업데이트
  • 검증

20.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

20.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

20.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

20.3. 구성 요소 옵션

FHIR 구성 요소는 아래에 나열된 27 옵션을 지원합니다.

이름설명Default유형

인코딩 (common)

모든 요청에 사용할 인코딩입니다.

CloudEvent 값:

  • JSON
  • XML
 

문자열

fhirVersion (common)

사용할 FHIR 버전입니다.

CloudEvent 값:

  • DSTU2
  • DSTU2_HL7ORG
  • DSTU2_1
  • DSTU3
  • R4
  • R5

R4

문자열

로그 (공용)

모든 요청과 응답을 기록합니다.

false

boolean

시프린트 (common)

거의 모든 요청을 인쇄합니다.

false

boolean

serverUrl (common)

FHIR 서버 기본 URL입니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

클라이언트 (고급)

사용자 지정 클라이언트를 사용합니다.

 

IGenericClient

clientFactory (advanced)

사용자 지정 클라이언트 팩토리를 사용합니다.

 

IRestfulClientFactory

압축 (고급)

발신(ECDHE/PUT) 콘텐츠를 GZIP 형식으로 압축합니다.

false

boolean

구성 (고급)

공유 구성을 사용하려면 다음을 수행합니다.

 

FhirConfiguration

connectionTimeout (advanced)

초기 TCP 연결을 시도하고 설정하는 데 걸리는 시간(ms)입니다.

10000

정수

deferModelScanning (advanced)

이 옵션을 설정하면 지정된 유형의 하위 목록에 실제로 액세스할 때까지 모델 클래스를 스캔하지 않습니다.

false

boolean

fhirContext (advanced)

FhirContext는 생성할 비용이 많이 드는 오브젝트입니다. 여러 인스턴스가 생성되지 않도록 하려면 직접 설정할 수 있습니다.

 

FhirContext

forceConformanceCheck (advanced)

강제 적합성 확인.

false

boolean

sessionCookie (advanced)

HTTP 세션 쿠키는 모든 요청에 추가합니다.

 

문자열

socketTimeout (advanced)

개별 읽기/쓰기 작업(ms)에 대해 차단하는 기간입니다.

10000

정수

요약 (고급)

_summary param을 사용하여 서버에서 응답을 수정하도록 요청합니다.

CloudEvent 값:

  • COUNT
  • TEXT
  • DATA
  • TRUE
  • FALSE
 

문자열

validationMode (advanced)

Camel이 FHIR 서버의 적합성을 검증해야 하는 경우는 무엇입니까.

CloudEvent 값:

  • NEVER
  • ONCE

ONCE

문자열

proxyHost (proxy)

프록시 호스트입니다.

 

문자열

proxyPassword (proxy)

프록시 암호입니다.

 

문자열

proxyPort (proxy)

프록시 포트입니다.

 

정수

proxyUser (proxy)

프록시 사용자 이름입니다.

 

문자열

accessToken (security)

OAuth 액세스 토큰.

 

문자열

암호 (보안)

기본 인증에 사용할 사용자 이름입니다.

 

문자열

사용자 이름 (보안)

기본 인증에 사용할 사용자 이름입니다.

 

문자열

20.4. 끝점 옵션

FHIR 엔드포인트는 URI 구문을 사용하여 구성됩니다.

fhir:apiName/methodName

다음과 같은 경로 및 쿼리 매개변수 사용:

20.4.1. 경로 매개변수(2 매개변수)

이름설명Default유형

apiName (common)

수행할 작업 종류가 필요합니다.

CloudEvent 값:

  • CAPABILITIES
  • CREATE
  • DELETE
  • 히스토리
  • LOAD_PAGE
  • META
  • 작업
  • PATCH
  • READ
  • SEARCH
  • 트랜잭션
  • UPDATE
  • 검증
 

FhirApiName

methodName (common)

선택한 작업에 사용할 하위 작업은 무엇입니까.

 

문자열

20.4.2. 쿼리 매개변수(44 매개변수)

이름설명Default유형

인코딩 (common)

모든 요청에 사용할 인코딩입니다.

CloudEvent 값:

  • JSON
  • XML
 

문자열

fhirVersion (common)

사용할 FHIR 버전입니다.

CloudEvent 값:

  • DSTU2
  • DSTU2_HL7ORG
  • DSTU2_1
  • DSTU3
  • R4
  • R5

R4

문자열

inBody (common)

교환에 전달할 매개 변수의 이름을 설정합니다.

 

문자열

로그 (공용)

모든 요청과 응답을 기록합니다.

false

boolean

시프린트 (common)

거의 모든 요청을 인쇄합니다.

false

boolean

serverUrl (common)

FHIR 서버 기본 URL입니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

클라이언트 (고급)

사용자 지정 클라이언트를 사용합니다.

 

IGenericClient

clientFactory (advanced)

사용자 지정 클라이언트 팩토리를 사용합니다.

 

IRestfulClientFactory

압축 (고급)

발신(ECDHE/PUT) 콘텐츠를 GZIP 형식으로 압축합니다.

false

boolean

connectionTimeout (advanced)

초기 TCP 연결을 시도하고 설정하는 데 걸리는 시간(ms)입니다.

10000

정수

deferModelScanning (advanced)

이 옵션을 설정하면 지정된 유형의 하위 목록에 실제로 액세스할 때까지 모델 클래스를 스캔하지 않습니다.

false

boolean

fhirContext (advanced)

FhirContext는 생성할 비용이 많이 드는 오브젝트입니다. 여러 인스턴스가 생성되지 않도록 하려면 직접 설정할 수 있습니다.

 

FhirContext

forceConformanceCheck (advanced)

강제 적합성 확인.

false

boolean

sessionCookie (advanced)

HTTP 세션 쿠키는 모든 요청에 추가합니다.

 

문자열

socketTimeout (advanced)

개별 읽기/쓰기 작업(ms)에 대해 차단하는 기간입니다.

10000

정수

요약 (고급)

_summary param을 사용하여 서버에서 응답을 수정하도록 요청합니다.

CloudEvent 값:

  • COUNT
  • TEXT
  • DATA
  • TRUE
  • FALSE
 

문자열

validationMode (advanced)

Camel이 FHIR 서버의 적합성을 검증해야 하는 경우는 무엇입니까.

CloudEvent 값:

  • NEVER
  • ONCE

ONCE

문자열

proxyHost (proxy)

프록시 호스트입니다.

 

문자열

proxyPassword (proxy)

프록시 암호입니다.

 

문자열

proxyPort (proxy)

프록시 포트입니다.

 

정수

proxyUser (proxy)

프록시 사용자 이름입니다.

 

문자열

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

accessToken (security)

OAuth 액세스 토큰.

 

문자열

암호 (보안)

기본 인증에 사용할 사용자 이름입니다.

 

문자열

사용자 이름 (보안)

기본 인증에 사용할 사용자 이름입니다.

 

문자열

20.5. API 매개변수(13 API)

@FHIR 엔드포인트는 API 기반 구성 요소이며 사용되는 API 이름과 API 메서드를 기반으로 하는 추가 매개변수가 있습니다. API 이름 및 API 방법은 끝점 URI에 apiName/methodName 경로 매개변수로 있습니다.

fhir:apiName/methodName

아래 표에 나열된 13개의 API 이름이 있습니다.

API 이름유형설명

capabilities

둘 다

API to Fetch the capability statement for the server

create

둘 다

서버에 새 리소스 인스턴스를 생성하는 create 작업의 API

삭제

둘 다

서버 리소스에서 논리 삭제를 수행하는 삭제 작업의 API

history

둘 다

기록 방법의 API

load-page

둘 다

atom 번들 내 link type=next 태그에 지정된 링크를 사용하여 paged 세트에서 이전/다음 리소스 번들을 로드하는 API

meta

둘 다

리소스 또는 서버에서 태그 및 기타 메타 요소를 가져오고, 추가하고, 제거하는 데 사용할 수 있는 메타 작업에 대한 API

작업

둘 다

확장된 FHIR 작업을 위한 API

patch

둘 다

서버 리소스에서 논리 패치를 수행하는 패치 작업 API

read

둘 다

읽기 작업을 위한 API 메서드

search

둘 다

지정된 기준 세트와 일치하는 리소스를 검색하는 API

트랜잭션

둘 다

단일 단위로 실행할 서버로 트랜잭션(리소스 수집)을 전송하는 API

업데이트

둘 다

서버 리소스에서 논리 삭제를 수행하는 업데이트 작업의 API

검증

둘 다

리소스 검증을 위한 API

각 API는 다음 섹션에 설명되어 있습니다.

20.5.1. API: 기능

생산자 및 소비자 모두 지원

capabilities API는 다음과 같이 구문에 정의되어 있습니다.

fhir:capabilities/methodName?[parameters]

이 방법은 아래 표에 나열되어 있으며 각 방법에 대한 자세한 구문이 나와 있습니다. (API 메소드에는 이름 대신 구문에 사용할 수 있는 단축 별칭 이름이 있을 수 있습니다.)

방법설명

ofType

지정된 모델 유형을 사용하여 적합성 명령 검색

20.5.1.1. method ofType

서명:

  • org.ECDHE7.fhir.instance.model.api.IBaseConformance ofType(Class<org.>-<7.fhir.instance.model.api.IBaseConformance> 유형, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters);

fhir/ofType API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

type

모델 유형입니다.

클래스

위의 매개변수 외에도 fhir API는 쿼리 매개 변수 중 하나를 사용할 수도 있습니다.

임의의 매개변수는 끝점 URI로 제공되거나 메시지 헤더에서 동적으로 제공할 수 있습니다. 메시지 헤더 이름은 CamelFhir.parameter 형식이어야 합니다. inBody 매개변수는 메시지 헤더를 덮어씁니다. 즉, Body=myParameterName VERSION의 엔드포인트 매개변수는 CamelFhir.myParameterName ECDHE 헤더를 재정의합니다.

20.5.2. API: create

생산자 및 소비자 모두 지원

create API는 다음과 같이 구문에 정의되어 있습니다.

fhir:create/methodName?[parameters]

1 방법은 아래 표에 나열되어 있으며 각 방법에 대한 자세한 구문이 나와 있습니다. (API 메소드에는 이름 대신 구문에 사용할 수 있는 단축 별칭 이름이 있을 수 있습니다.)

방법설명

resource

서버에서 IBaseResource를 만듭니다.

20.5.2.1. 메서드 리소스

서명:

  • ca.uhhn.fhir.rest.api.apiOutcome resource(String resourceAsString, String url, ca.uhn.fhir.rest.api.api.Prefer>-<Enum preference, java.util.cam.camel.component.api.api.ExtraParameters, Object> 추가 매개 변수);
  • ca.uhn.fhir.rest.api.MethodOutcome 리소스(org.>-<7.fhir.instance.api.api.IBaseResource 리소스, 문자열 URL, ca.uhhn.fhir.rest.api.Prefer#177Enum preference, java.util.Map.camel.apache.camel.component.api.ExtraParameter)

fhir/resource API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

preferReturn

요청에 Prefer 헤더를 추가하여 결과의 일부로 리소스 본문을 포함하거나 억제하도록 요청합니다. 서버가 리소스를 반환하면 MethodOutcome#getResource()를 통해 클라이언트에 액세스할 수 있는 것이 null일 수 있습니다.

PreferReturnEnum

resource

생성할 리소스입니다.

IBaseResource

resourceAsString

생성할 리소스입니다.

문자열

url

사용할 검색 URL입니다. 이 URL의 형식은 ResourceTypeParameters 형식이어야 합니다(예: Patientname=Smith&identifier=13.2.4.11.4%7C847366).

문자열

위의 매개변수 외에도 fhir API는 쿼리 매개 변수 중 하나를 사용할 수도 있습니다.

임의의 매개변수는 끝점 URI로 제공되거나 메시지 헤더에서 동적으로 제공할 수 있습니다. 메시지 헤더 이름은 CamelFhir.parameter 형식이어야 합니다. inBody 매개변수는 메시지 헤더를 덮어씁니다. 즉, Body=myParameterName VERSION의 엔드포인트 매개변수는 CamelFhir.myParameterName ECDHE 헤더를 재정의합니다.

20.5.3. api: delete

생산자 및 소비자 모두 지원

삭제 API는 다음과 같이 구문에 정의되어 있습니다.

fhir:delete/methodName?[parameters]

3 가지 방법은 아래 표에 나열되어 있으며 각 방법에 대한 자세한 구문이 나와 있습니다. (API 메소드에는 이름 대신 구문에 사용할 수 있는 단축 별칭 이름이 있을 수 있습니다.)

방법설명

resource

지정된 리소스를 삭제합니다.

resourceById

E 리소스 유형별 리소스를 삭제합니다.

resourceConditionalByUrl

지정된 검색 URL에 대해 삭제가 조건부 삭제로 수행되도록 지정합니다.

20.5.3.1. 메서드 리소스

서명:

  • org.ECDHE7.fhir.instance.model.api.IBaseOperationOutcome 리소스(org.>-<7.fhir.instance.model.api.IBaseResource 리소스, java.util.Map<org.apache.camel.component.api.api.ExtraParameters, Object> extraParameters);

fhir/resource API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

resource

삭제할 IBaseResource

IBaseResource

20.5.3.2. 메서드 resourceById

서명:

  • org.ECDHE7.fhir.instance.model.api.IBaseOperationOutcome resourceById(String type, String stringId, java.util.Map<org.apache.camel.camel.component.api.api.ExtraParameters, Object> extraParameters);
  • org.ECDHE7.fhir.instance.model.api.IBaseOperationOutcome resourceById(org.>-<7.fhir.instance.model.api.IIdType ID, java.util.Map<org.apache.camel.component.api.ExtraParameters, Object> 추가Parameters);

fhir/resourceById API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

id

리소스를 참조하는 IIdType

IIdType

stringId

id입니다.

문자열

type

리소스 유형(예: Patient)

문자열

20.5.3.3. 메서드 resourceConditionalByUrl

서명:

  • org.>-<7.fhir.instance.model.api.IBaseOperationOutcome resourceConditionalByUrl(String url, java.util.Map<org.apache.camel.component.api.api.ExtraParameters, Object> extraParameters);

fhir/resourceConditionalByUrl API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

url

사용할 검색 URL입니다. 이 URL의 형식은 ResourceTypeParameters 형식이어야 합니다(예: Patientname=Smith&identifier=13.2.4.11.4%7C847366).

문자열

위의 매개변수 외에도 fhir API는 쿼리 매개 변수 중 하나를 사용할 수도 있습니다.

임의의 매개변수는 끝점 URI로 제공되거나 메시지 헤더에서 동적으로 제공할 수 있습니다. 메시지 헤더 이름은 CamelFhir.parameter 형식이어야 합니다. inBody 매개변수는 메시지 헤더를 덮어씁니다. 즉, Body=myParameterName VERSION의 엔드포인트 매개변수는 CamelFhir.myParameterName ECDHE 헤더를 재정의합니다.

20.5.4. API: history

생산자 및 소비자 모두 지원

기록 API는 다음과 같이 구문에 정의되어 있습니다.

fhir:history/methodName?[parameters]

3 가지 방법은 아래 표에 나열되어 있으며 각 방법에 대한 자세한 구문이 나와 있습니다. (API 메소드에는 이름 대신 구문에 사용할 수 있는 단축 별칭 이름이 있을 수 있습니다.)

방법설명

onInstance

서버의 특정 리소스(ID 및 유형별)의 모든 버전에서 작업을 수행합니다.

onServer

서버에서 모든 유형의 모든 리소스에 대해 작업을 수행합니다.

onType

서버에서 지정된 유형의 모든 리소스에 대해 작업을 수행합니다.

20.5.4.1. OnInstance

서명:

  • org.>-<7.fhir.instance.model.api.IBaseBundle onInstance(org.>-<7.fhir.model.api.IIdType id, Class<org.fhir.instance.model.api.IBaseBundle> returnType, Integer count, java.util.Dateoff, java.util.Dateoff, org.>-<7.fhir.instance.model.api.IPrimitiveType<java.util.Date> iCutoff, java.util.Map<org.apache.camel.component.api.api.ExtraParameters, Object> extraParameters);

fhir/onInstance API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

count

서버에서 리소스 수까지만 반환하도록 요청합니다. NULL이 될 수 있습니다.

정수

cutoff

서버가 지정된 시간(포함) 이후에 생성된 리소스 버전만 반환하도록 요청하면 NULL이 될 수 있습니다.

날짜

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

iCutoff

서버가 지정된 시간(포함) 이후에 생성된 리소스 버전만 반환하도록 요청하면 NULL이 될 수 있습니다.

IPrimitiveType

id

IIdType에서 리소스 유형과 리소스 ID로 채워야 하는 IIdType

IIdType

returnType

메서드에서 Bundle 리소스(예: ca.uhn.fhir.model.dstu2.resource.Bundle)를 반환하도록 요청합니다. DSTU2 서버에 액세스하는 경우 이 방법을 사용합니다.

클래스

20.5.4.2. OnServer 방법

서명:

  • org.ECDHE7.fhir.instance.model.api.IBaseBundle onServer(Class<org.>-<7.fhir.instance.model.api.api.IBaseBundle> returnType, Integer count, java.util.Date cutoff, org.#1777.fhir.instance.model.api.api.api.api.util.util.Date> iCutoff, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);

fhir/onServer API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

count

서버에서 리소스 수까지만 반환하도록 요청합니다. NULL이 될 수 있습니다.

정수

cutoff

서버가 지정된 시간(포함) 이후에 생성된 리소스 버전만 반환하도록 요청하면 NULL이 될 수 있습니다.

날짜

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

iCutoff

서버가 지정된 시간(포함) 이후에 생성된 리소스 버전만 반환하도록 요청하면 NULL이 될 수 있습니다.

IPrimitiveType

returnType

메서드에서 Bundle 리소스(예: ca.uhn.fhir.model.dstu2.resource.Bundle)를 반환하도록 요청합니다. DSTU2 서버에 액세스하는 경우 이 방법을 사용합니다.

클래스

20.5.4.3. OnType 방법

서명:

  • org.>-<7.fhir.instance.model.api.IBaseBundle onType(Class<org.>-<7.fhir.instance.api.api.IBaseResource> 리소스 유형, Class<org.>-<7.fhir.instance.instance.instance.api.IBaseBundle> returnType, java.util.Date cutoff, java.util.Dateoff, org.>-<7.fhir.instance.model.api.IPrimitiveType<java.util.Date> iCutoff, java.util.Map<org.apache.camel.component.api.api.ExtraParameters, Object> extraParameters);

fhir/onType API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

count

서버에서 리소스 수까지만 반환하도록 요청합니다. NULL이 될 수 있습니다.

정수

cutoff

서버가 지정된 시간(포함) 이후에 생성된 리소스 버전만 반환하도록 요청하면 NULL이 될 수 있습니다.

날짜

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

iCutoff

서버가 지정된 시간(포함) 이후에 생성된 리소스 버전만 반환하도록 요청하면 NULL이 될 수 있습니다.

IPrimitiveType

resourceType

검색할 리소스 유형입니다.

클래스

returnType

메서드에서 Bundle 리소스(예: ca.uhn.fhir.model.dstu2.resource.Bundle)를 반환하도록 요청합니다. DSTU2 서버에 액세스하는 경우 이 방법을 사용합니다.

클래스

위의 매개변수 외에도 fhir API는 쿼리 매개 변수 중 하나를 사용할 수도 있습니다.

임의의 매개변수는 끝점 URI로 제공되거나 메시지 헤더에서 동적으로 제공할 수 있습니다. 메시지 헤더 이름은 CamelFhir.parameter 형식이어야 합니다. inBody 매개변수는 메시지 헤더를 덮어씁니다. 즉, Body=myParameterName VERSION의 엔드포인트 매개변수는 CamelFhir.myParameterName ECDHE 헤더를 재정의합니다.

20.5.5. api: load-page

생산자 및 소비자 모두 지원

load-page API는 다음과 같이 구문에 정의되어 있습니다.

fhir:load-page/methodName?[parameters]

3 가지 방법은 아래 표에 나열되어 있으며 각 방법에 대한 자세한 구문이 나와 있습니다. (API 메소드에는 이름 대신 구문에 사용할 수 있는 단축 별칭 이름이 있을 수 있습니다.)

방법설명

byUrl

지정된 URL 및 번들 유형을 사용하여 결과 페이지를 로드하고 DSTU1 Atom 번들을 반환합니다.

다음

번들의 다음 내용이 포함된 링크를 사용하여 결과의 다음 페이지를 로드합니다.

이전

번들의 prev와 관련된 링크를 사용하여 이전 결과 페이지를 로드합니다.

20.5.5.1. byUrl

서명:

  • org.ECDHE7.fhir.instance.model.api.IBaseBundle byUrl(문자열 URL, Class<org.>-<7.fhir.instance.model.api.IBaseBundle> returnType, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters);

fhir/byUrl API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

returnType

반환 유형

클래스

url

검색 URL

문자열

20.5.5.2. 방법 next

서명:

  • org.ECDHE7.fhir.instance.model.api.IBaseBundle next(org.>-<7.fhir.instance.model.api.api.IBaseBundle 번들, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);

fhir/next API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

번들

The IBaseBundle

IBaseBundle

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

20.5.5.3. 이전 방법

서명:

  • org.ECDHE7.fhir.instance.model.api.IBaseBundle 이전(org.>-<7.fhir.instance.api.api.api.IBaseBundle 번들, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);

fhir/previous API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

번들

The IBaseBundle

IBaseBundle

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

위의 매개변수 외에도 fhir API는 쿼리 매개 변수 중 하나를 사용할 수도 있습니다.

임의의 매개변수는 끝점 URI로 제공되거나 메시지 헤더에서 동적으로 제공할 수 있습니다. 메시지 헤더 이름은 CamelFhir.parameter 형식이어야 합니다. inBody 매개변수는 메시지 헤더를 덮어씁니다. 즉, Body=myParameterName VERSION의 엔드포인트 매개변수는 CamelFhir.myParameterName ECDHE 헤더를 재정의합니다.

20.5.6. API: meta

생산자 및 소비자 모두 지원

meta API는 다음과 같이 구문에 정의되어 있습니다.

fhir:meta/methodName?[parameters]

5 메서드가 아래 표에 나열되어 있으며 각 방법에 대한 자세한 구문이 나와 있습니다. (API 메소드에는 이름 대신 구문에 사용할 수 있는 단축 별칭 이름이 있을 수 있습니다.)

방법설명

add

지정된 메타데이터의 요소를 기존 세트에 추가합니다(제거되지 않음).

삭제

지정된 ID에서 지정된 메타데이터의 요소 삭제

getFromResource

특정 리소스에서 현재 메타데이터 가져오기

getFromServer

전체 서버에서 현재 메타데이터를 가져옵니다.

getFromType

특정 유형에서 현재 메타데이터 가져오기

20.5.6.1. 방법 추가

서명:

  • org.ECDHE7.fhir.instance.model.api.IBaseMetaType add(org.>-<7.fhir.instance.model.api.IBaseMetaType 메타, org.>-<7.fhir.instance.model.api.IIdType id, java.util.Map<org.apache.camel.component.component.ExtraParameters)

fhir/add API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

id

ID

IIdType

meta

IBaseMetaType 클래스

IBaseMetaType

20.5.6.2. method delete

서명:

  • org.ECDHE7.fhir.instance.model.api.IBaseMetaType delete(org.>-<7.fhir.instance.model.api.IBaseMetaType 메타, org.>-<7.fhir.instance.model.api.IIdType id, java.util.Map<org.apache.camel.component.component.ExtraParameters);

fhir/delete API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

id

ID

IIdType

meta

IBaseMetaType 클래스

IBaseMetaType

20.5.6.3. 메서드 getFromResource

서명:

  • org.util.fhir.instance.api.IBaseMetaType getFromResource(Class<org.>-<7.fhir.instance.model.api.IBaseMetaType> metaType, org.ECDHE7.fhir.instance.model.api.IIdType id, java.util.Map<org.apache.camel.component.fhir.api.Extrar>)

fhir/getFromResource API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

id

ID

IIdType

metaType

IBaseMetaType 클래스

클래스

20.5.6.4. 메서드 getFromServer

서명:

  • org.ECDHE7.fhir.instance.api.IBaseMetaType getFromServer(Class<org.>-<7.fhir.instance.model.api.IBaseMetaType> metaType, java.util.Map.apache.camel.component.fhir.api.ExtraParameters);

fhir/getFromServer API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

metaType

지정된 FHIR 모델 버전의 메타 데이터 유형 유형 (메타드Dt.class 또는 metaType.class)

클래스

20.5.6.5. 메서드 getFromType

서명:

  • org.ECDHE7.fhir.instance.api.IBaseMetaType getFromType(Class<org.>-<7.fhir.instance.model.api.IBaseMetaType> metaType, String resourceType, java.util.Map<org.camel.camel.component.api.api.ExtraParameters);

fhir/getFromType API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

metaType

IBaseMetaType 클래스

클래스

resourceType

리소스 유형(예: Patient)

문자열

위의 매개변수 외에도 fhir API는 쿼리 매개 변수 중 하나를 사용할 수도 있습니다.

임의의 매개변수는 끝점 URI로 제공되거나 메시지 헤더에서 동적으로 제공할 수 있습니다. 메시지 헤더 이름은 CamelFhir.parameter 형식이어야 합니다. inBody 매개변수는 메시지 헤더를 덮어씁니다. 즉, Body=myParameterName VERSION의 엔드포인트 매개변수는 CamelFhir.myParameterName ECDHE 헤더를 재정의합니다.

20.5.7. API: 작업

생산자 및 소비자 모두 지원

작업 API는 다음과 같이 구문에 정의되어 있습니다.

fhir:operation/methodName?[parameters]

5 메서드가 아래 표에 나열되어 있으며 각 방법에 대한 자세한 구문이 나와 있습니다. (API 메소드에는 이름 대신 구문에 사용할 수 있는 단축 별칭 이름이 있을 수 있습니다.)

방법설명

onInstance

서버의 특정 리소스(ID 및 유형별)의 모든 버전에서 작업을 수행합니다.

onInstanceVersion

이 작업은 특정 버전의 리소스에서 작동합니다.

onServer

서버에서 모든 유형의 모든 리소스에 대해 작업을 수행합니다.

onType

서버에서 지정된 유형의 모든 리소스에 대해 작업을 수행합니다.

processMessage

이 작업을 FHIR 사양에 정의된 $process-message라고 합니다.

20.5.7.1. OnInstance

서명:

  • org.>-<7.fhir.instance.model.api.IBaseResource onInstance(org.>-<7.fhir.instance.model.api.IIdType ID, org.ovn7.fhir.instance.api.api.api.IBaseParameters 매개변수, Class<org. first7.fhir.instance.instance.api.instance.IBaseParameter> outputParameter>, 부울 useHttpGet, Class<org.>-<7.fhir.model.api.IBaseResource> returnType, java.util.Map<org.apache.camel.component.api.api.ExtraParameters, Object> extraParameters);

fhir/onInstance API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

id

리소스(버전이 제거됨)

IIdType

name

작업 이름

문자열

outputParameterType

출력 매개 변수에 사용할 유형(사용 중인 FHIR 구조의 버전에서 Parameters.class로 설정되어야 함)은 NULL이 될 수 있습니다.

클래스

parameters

입력으로 사용할 매개변수입니다. 또한 작업에 입력 매개 변수가 필요하지 않은 경우 null일 수도 있습니다.

IBaseParameters

returnType

이 작업에서 Parameters 리소스 대신 단일 리소스 본문을 반환 유형으로 반환하는 경우 이 메서드를 사용하여 해당 리소스 유형을 지정합니다. 이는 Parameters 리소스 대신 번들을 반환하는 특정 작업(예: Patient/NNN/$everything)에 유용하며, 이는 NULL이 될 수 있습니다.

클래스

useHttpGet

HTTP GET 동사 사용

부울

20.5.7.2. OnInstanceVersion 방법

서명:

  • org.>-<7.fhir.instance.model.api.IBaseResource onInstanceVersion(org.>-<7.fhir.instance.api.api.IIdType ID, org.>-<7.fhir.instance.model.api.IBaseParameters 매개변수, Class<org.fhir.instance.instance.api.fhir.model.api.ioBaseParameter> outputParameter, outputParameter> 부울 useHttpGet, Class<org.>-<7.fhir.model.api.IBaseResource> returnType, java.util.Map<org.apache.camel.component.api.api.ExtraParameters, Object> extraParameters);

fhir/onInstanceVersion API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

id

리소스 버전

IIdType

name

작업 이름

문자열

outputParameterType

출력 매개 변수에 사용할 유형(사용 중인 FHIR 구조의 버전에서 Parameters.class로 설정되어야 함)은 NULL이 될 수 있습니다.

클래스

parameters

입력으로 사용할 매개변수입니다. 또한 작업에 입력 매개 변수가 필요하지 않은 경우 null일 수도 있습니다.

IBaseParameters

returnType

이 작업에서 Parameters 리소스 대신 단일 리소스 본문을 반환 유형으로 반환하는 경우 이 메서드를 사용하여 해당 리소스 유형을 지정합니다. 이는 Parameters 리소스 대신 번들을 반환하는 특정 작업(예: Patient/NNN/$everything)에 유용하며, 이는 NULL이 될 수 있습니다.

클래스

useHttpGet

HTTP GET 동사 사용

부울

20.5.7.3. OnServer 방법

서명:

  • org.ECDHE7.fhir.instance.model.api.IBaseResource onServer(String name, org.ECDHE7.fhir.instance.api.api.IBaseParameters 매개변수, Class<org.>-<7.fhir.instance.instance.instance.api.IBaseParameters> outputParameterType, 부울 useHttpGet, Class<org.Forwarded7.fhir.instance.api.api.fhir.instance>, boolean useHttpGet, Class<org.fhir.instance.api java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);

fhir/onServer API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

name

작업 이름

문자열

outputParameterType

출력 매개 변수에 사용할 유형(사용 중인 FHIR 구조의 버전에서 Parameters.class로 설정되어야 함)은 NULL이 될 수 있습니다.

클래스

parameters

입력으로 사용할 매개변수입니다. 또한 작업에 입력 매개 변수가 필요하지 않은 경우 null일 수도 있습니다.

IBaseParameters

returnType

이 작업에서 Parameters 리소스 대신 단일 리소스 본문을 반환 유형으로 반환하는 경우 이 메서드를 사용하여 해당 리소스 유형을 지정합니다. 이는 Parameters 리소스 대신 번들을 반환하는 특정 작업(예: Patient/NNN/$everything)에 유용하며, 이는 NULL이 될 수 있습니다.

클래스

useHttpGet

HTTP GET 동사 사용

부울

20.5.7.4. OnType 방법

서명:

  • org.>-<7.fhir.instance.model.api.IBaseResource onType(Class<org.>-<7.fhir.instance.api.api.api.IBaseResource> 리소스 유형, 문자열 이름, org.ECDHE7.fhir.instance.api.IBaseParameters 매개변수, Class<org.anchor7.fhir.instance.api.fBaseParameter> 출력 매개 변수, 부울 useHttpGet, Class<org.>-<7.fhir.model.api.IBaseResource> returnType, java.util.Map<org.apache.camel.component.api.api.ExtraParameters, Object> extraParameters);

fhir/onType API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

name

작업 이름

문자열

outputParameterType

출력 매개 변수에 사용할 유형(사용 중인 FHIR 구조의 버전에서 Parameters.class로 설정되어야 함)은 NULL이 될 수 있습니다.

클래스

parameters

입력으로 사용할 매개변수입니다. 또한 작업에 입력 매개 변수가 필요하지 않은 경우 null일 수도 있습니다.

IBaseParameters

resourceType

작동할 리소스 유형입니다.

클래스

returnType

이 작업에서 Parameters 리소스 대신 단일 리소스 본문을 반환 유형으로 반환하는 경우 이 메서드를 사용하여 해당 리소스 유형을 지정합니다. 이는 Parameters 리소스 대신 번들을 반환하는 특정 작업(예: Patient/NNN/$everything)에 유용하며, 이는 NULL이 될 수 있습니다.

클래스

useHttpGet

HTTP GET 동사 사용

부울

20.5.7.5. 방법 processMessage

서명:

  • org.ECDHE7.fhir.instance.model.api.IBaseBundle processMessage(String respondToUri, org.knative7.fhir.instance.model.api.IBaseBundle, 부울 비동기, Class<org.fhir.instance.model.api.IBaseBundle> responseClass, java.util.Map<org.apache.camel.component.Exhir>Ex.Ex.comExhir.comEx.fhir.com

fhir/processMessage API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

asynchronous

메시지를 비동기식 또는 동기적으로 처리할지 여부에 관계없이 기본값은 synchronous입니다.

부울

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

msgBundle

Message Bundle을 메시지 서버로 POST로 설정합니다.

IBaseBundle

respondToUri

수신 서버의 응답이 이 URI로 전송되어야 함을 나타내는 선택적 쿼리 매개변수가 NULL일 수 있습니다.

문자열

responseClass

응답 클래스

클래스

위의 매개변수 외에도 fhir API는 쿼리 매개 변수 중 하나를 사용할 수도 있습니다.

임의의 매개변수는 끝점 URI로 제공되거나 메시지 헤더에서 동적으로 제공할 수 있습니다. 메시지 헤더 이름은 CamelFhir.parameter 형식이어야 합니다. inBody 매개변수는 메시지 헤더를 덮어씁니다. 즉, Body=myParameterName VERSION의 엔드포인트 매개변수는 CamelFhir.myParameterName ECDHE 헤더를 재정의합니다.

20.5.8. API: 패치

생산자 및 소비자 모두 지원

패치 API는 다음과 같이 구문에 정의되어 있습니다.

fhir:patch/methodName?[parameters]

2 메서드가 아래 표에 나열되어 있으며 각 방법에 대한 자세한 구문이 나와 있습니다. (API 메소드에는 이름 대신 구문에 사용할 수 있는 단축 별칭 이름이 있을 수 있습니다.)

방법설명

patchById

지정된 리소스 ID에 패치 적용

patchByUrl

지정된 검색 URL에 대해 조건부 생성으로 업데이트를 수행해야 함을 지정합니다.

20.5.8.1. 메서드 patchById

서명:

  • ca.uhn.fhir.rest.api.api.MethodOutcome patchById(String patchBody, String stringId, ca.uhhn.fhir.rest.api.Prefer>-<Enum preference, java.util.camel.component.api.api.ExtraParameters);
  • ca.uhn.fhir.rest.api.api.MethodOutcome patchById(String patchBody, org.>-<7.fhir.instance.model.api.IIdType id, ca.uhn.fhir.rest.api.Prefer>-<Enum prefer#177, java.util.apache.camel.component.fhir.api.ExtraParameter> extraParameter);

fhir/patchById API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

id

패치할 리소스 ID

IIdType

patchBody

XML 또는 JSON에서 직렬화된 패치 문서의 본문

문자열

preferReturn

요청에 Prefer 헤더를 추가하여 결과의 일부로 리소스 본문을 포함하거나 억제하도록 요청합니다. 서버가 리소스를 반환하면 MethodOutcome#getResource()를 통해 클라이언트에 액세스할 수 있는 항목을 구문 분석합니다.

PreferReturnEnum

stringId

패치할 리소스 ID

문자열

20.5.8.2. patchByUrl 방법

서명:

  • ca.uhn.fhir.rest.api.api.MethodOutcome patchByUrl(String patchBody, String url, ca.uhhn.fhir.rest.api.api.Prefer>-<Enum preferred, java.util.camel.component.fhir.api.ExtraParameters);

fhir/patchByUrl API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

patchBody

XML 또는 JSON에서 직렬화된 패치 문서의 본문

문자열

preferReturn

요청에 Prefer 헤더를 추가하여 결과의 일부로 리소스 본문을 포함하거나 억제하도록 요청합니다. 서버가 리소스를 반환하면 MethodOutcome#getResource()를 통해 클라이언트에 액세스할 수 있는 항목을 구문 분석합니다.

PreferReturnEnum

url

사용할 검색 URL입니다. 이 URL의 형식은 ResourceTypeParameters 형식이어야 합니다(예: Patientname=Smith&identifier=13.2.4.11.4%7C847366).

문자열

위의 매개변수 외에도 fhir API는 쿼리 매개 변수 중 하나를 사용할 수도 있습니다.

임의의 매개변수는 끝점 URI로 제공되거나 메시지 헤더에서 동적으로 제공할 수 있습니다. 메시지 헤더 이름은 CamelFhir.parameter 형식이어야 합니다. inBody 매개변수는 메시지 헤더를 덮어씁니다. 즉, Body=myParameterName VERSION의 엔드포인트 매개변수는 CamelFhir.myParameterName ECDHE 헤더를 재정의합니다.

20.5.9. api: read

생산자 및 소비자 모두 지원

read API는 다음과 같이 구문에 정의되어 있습니다.

fhir:read/methodName?[parameters]

2 메서드가 아래 표에 나열되어 있으며 각 방법에 대한 자세한 구문이 나와 있습니다. (API 메소드에는 이름 대신 구문에 사용할 수 있는 단축 별칭 이름이 있을 수 있습니다.)

방법설명

resourceById

id로 서버에서 IBaseResource 읽기

resourceByUrl

url로 서버에서 IBaseResource 읽기

20.5.9.1. 메서드 resourceById

서명:

  • org.>-<7.fhir.instance.model.api.IBaseResource resourceById(Class<org.>-<7.fhir.instance.model.api.api.IBaseResource> 리소스, Long longId, String ifVersionMatches, 부울 returnNull, org.>-<7.fhir.instance.api.IBaseResource, returnResource, returnResource, 부울 throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
  • org.>-<7.fhir.instance.model.api.IBaseResource resourceById(Class<org.>-<7.fhir.instance.instance.api.api.IBaseResource> 리소스, 문자열 stringId, String 버전, VersionMatches, 부울 returnNull, org.ECDHE7.fhir.instance.api.IBaseResource return, return,api.IBaseResource, return, 부울 throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
  • org.>-<7.fhir.instance.model.api.IBaseResource resourceById(Class<org.>-<7.fhir.model.api.IBaseResource> 리소스, org.>-<7.fhir.instance.model.api.IIdType id, String ifVersionMatches, 부울 returnNull, 부울 returnNull, org.ECDHE7.fhir.instance.model.api.IBaseResource returnResource, 부울 throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
  • org.ECDHE7.fhir.instance.api.api.IBaseResource resourceById(String resourceClass, Long longId, String ifVersionMatches, org.>-<7.fhir.instance.model.api.IBaseResource returnResource, 부울 throwError, java.util.Map<org.apache.camel.component.api.Extrar> extraParameter)
  • org.ECDHE7.fhir.instance.api.api.IBaseResource resourceById(String resourceClass, String stringId, String ifVersionMatches, String version, 부울 returnNull, org.>-<7.fhir.instance.model.api.IBaseResource returnResource, Boolean throwError, java.util.apache.camel.component.fhir.fhir> extraParameter, extraParameter);
  • org.>-<7.fhir.instance.model.api.IBaseResource resourceById(String resourceClass, org.>-<7.fhir.instance.model.api.IIdType ID, String ifVersionMatches, 부울 returnNull, org.#1777.fhir.instance.model.api.IBaseResource returnResource, 부울 throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);

fhir/resourceById API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

id

리소스를 참조하는 IIdType

IIdType

ifVersionMatches

서버의 최신 버전과 일치하는 버전

문자열

longId

리소스 ID

long

resource

읽을 리소스(예: Patient)

클래스

resourceClass

읽을 리소스(예: Patient)

문자열

returnNull

버전이 일치하는 경우 null 반환

부울

returnResource

버전이 일치하는 경우 리소스 반환

IBaseResource

stringId

리소스 ID

문자열

throwError

버전이 일치하면 오류가 발생

부울

버전

리소스 버전

문자열

20.5.9.2. 메서드 resourceByUrl

서명:

  • org.>-<7.fhir.instance.model.api.IBaseResource resourceByUrl(Class<org.>-<7.fhir.instance.model.api.IBaseResource> 리소스, String url, String ifVersionMatches, 부울 returnNull, org.>-<7.fhir.instance.api.IBaseResource, returnResource, returnResource, 부울 throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
  • org.>-<7.fhir.instance.model.api.IBaseResource resourceByUrl(Class<org.>-<7.fhir.model.api.IBaseResource> 리소스, org.>-<7.fhir.instance.model.api.IIdType iUrl, String ifVersionMatches, 부울 returnNull, 부울 returnNull, org.ECDHE7.fhir.instance.model.api.IBaseResource returnResource, 부울 throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
  • org.ECDHE7.fhir.instance.api.api.IBaseResource resourceByUrl(String resourceClass, String url, String ifVersionMatches, org.>-<7.fhir.instance.api.api.IBaseResource returnResource, 부울 throwError, java.util.apache.camel.apache.camel.component.api.apis> extraParameter> extraParameters);
  • org.>-<7.fhir.instance.model.api.IBaseResource resourceByUrl(String resourceClass, org.>-<7.fhir.model.api.api.IIdType iUrl, 부울 ifVersionMatches, 부울 returnNull, org.>-<7.fhir.instance.api.api.IBaseResource returnResource, 부울 throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);

fhir/resourceByUrl API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

iUrl

절대 URL로 리소스를 참조하는 IIdType

IIdType

ifVersionMatches

서버의 최신 버전과 일치하는 버전

문자열

resource

읽을 리소스(예: Patient)

클래스

resourceClass

읽을 리소스(예: Patient.class)

문자열

returnNull

버전이 일치하는 경우 null 반환

부울

returnResource

버전이 일치하는 경우 리소스 반환

IBaseResource

throwError

버전이 일치하면 오류가 발생

부울

url

절대 URL로 리소스 참조

문자열

위의 매개변수 외에도 fhir API는 쿼리 매개 변수 중 하나를 사용할 수도 있습니다.

임의의 매개변수는 끝점 URI로 제공되거나 메시지 헤더에서 동적으로 제공할 수 있습니다. 메시지 헤더 이름은 CamelFhir.parameter 형식이어야 합니다. inBody 매개변수는 메시지 헤더를 덮어씁니다. 즉, Body=myParameterName VERSION의 엔드포인트 매개변수는 CamelFhir.myParameterName ECDHE 헤더를 재정의합니다.

20.5.11. API: 트랜잭션

생산자 및 소비자 모두 지원

트랜잭션 API는 다음과 같이 구문에 정의되어 있습니다.

fhir:transaction/methodName?[parameters]

2 메서드가 아래 표에 나열되어 있으며 각 방법에 대한 자세한 구문이 나와 있습니다. (API 메소드에는 이름 대신 구문에 사용할 수 있는 단축 별칭 이름이 있을 수 있습니다.)

방법설명

withBundle

지정된 원시 텍스트( Bundle 리소스여야 함)를 트랜잭션 입력으로 사용합니다.

withResources

리소스 목록을 트랜잭션 입력으로 사용

20.5.11.1. Bundle을 사용하는 방법

서명:

  • string withBundle(String stringBundle, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
  • org.ECDHE7.fhir.instance.model.api.IBaseBundle withBundle(org.>-<7.fhir.instance.model.api.api.IBaseBundle 번들, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);

fhir/withBundle API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

번들

트랜잭션에서 사용할 번들

IBaseBundle

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

stringBundle

트랜잭션에서 사용할 번들

문자열

20.5.11.2. withResources 방법

서명:

  • java.util.List<org.>-<7.fhir.model.api.IBaseResource> withResources(java.util.List<org.List<org.instance.instance.model.api.IBaseResource> 리소스, java.util.Map<org.apache.camel.component.component.fhir.api.ExtraParameters);

fhir/withResources API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

resources

트랜잭션에서 사용할 리소스

list

위의 매개변수 외에도 fhir API는 쿼리 매개 변수 중 하나를 사용할 수도 있습니다.

임의의 매개변수는 끝점 URI로 제공되거나 메시지 헤더에서 동적으로 제공할 수 있습니다. 메시지 헤더 이름은 CamelFhir.parameter 형식이어야 합니다. inBody 매개변수는 메시지 헤더를 덮어씁니다. 즉, Body=myParameterName VERSION의 엔드포인트 매개변수는 CamelFhir.myParameterName ECDHE 헤더를 재정의합니다.

20.5.12. api: update

생산자 및 소비자 모두 지원

업데이트 API는 다음과 같이 구문에 정의되어 있습니다.

fhir:update/methodName?[parameters]

2 메서드가 아래 표에 나열되어 있으며 각 방법에 대한 자세한 구문이 나와 있습니다. (API 메소드에는 이름 대신 구문에 사용할 수 있는 단축 별칭 이름이 있을 수 있습니다.)

방법설명

resource

id로 서버에서 IBaseResource 업데이트

resourceBySearchUrl

검색 URL을 통해 서버에서 IBaseResource 업데이트

20.5.12.1. 메서드 리소스

서명:

  • ca.uhhn.fhir.rest.api.apiOutcome resource(String resourceAsString, String stringId, ca.uhhn.fhir.rest.api.api.Prefer>-<Enum preference, java.util.camel.component.api.api.ExtraParameters, Object> extraParameters);
  • ca.uhn.fhir.rest.api.apiOutcome resource(String resourceAsString, org.ECDHE7.fhir.instance.model.api.IIdType id, ca.uhn.fhir.rest.api.Prefer#177Enum prefer>-<, java.util.Map.camel.component.api.ExtraParameter> extraParameter> extraParameter> extraParameters);
  • ca.uhn.fhir.rest.api.MethodOutcome 리소스(org.>-<7.fhir.instance.api.api.IBaseResource 리소스, 문자열 stringId, ca.uhn.fhir.rest.api.Prefer#177Enum preference, java.util.Map.camel.apache.camel.component.api.ExtraParameter> extraParameter)
  • ca.uhn.fhir.api.api.MethodOutcome resource(org.>-<7.fhir.instance.api.api.IBaseResource 리소스, org.>-<7.fhir.instance.model.api.IIdType id, ca.uhn.fhir.rest.api.api.Prefer#177Enum preferForwarded, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);

fhir/resource API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

id

리소스를 참조하는 IIdType

IIdType

preferReturn

서버에 결과의 일부로 리소스 본문을 포함하거나 억제하는지 여부

PreferReturnEnum

resource

업데이트할 리소스(예: Patient)

IBaseResource

resourceAsString

업데이트할 리소스 본문입니다.

문자열

stringId

리소스를 참조하는 ID

문자열

20.5.12.2. 메서드 resourceBySearchUrl

서명:

  • ca.uhhn.fhir.rest.api.api.MethodOutcome resourceBySearchUrl(String resourceAsString, String url, ca.uhhn.fhir.rest.api.Prefer>-<Enum preference, java.util.apache.camel.component.api.api> extraParameters);
  • ca.uhn.fhir.rest.api.api.MethodOutcome resourceBySearchUrl(org.>-<7.fhir.instance.model.api.IBaseResource 리소스, 문자열 URL, ca.uhn.fhir.rest.api.Prefer>-<Enum prefer#177, java.util.apache.camel.component.fhir.api.ExtraParameter> extraParameter);

fhir/resourceBySearchUrl API 메서드에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

preferReturn

서버에 결과의 일부로 리소스 본문을 포함하거나 억제하는지 여부

PreferReturnEnum

resource

업데이트할 리소스(예: Patient)

IBaseResource

resourceAsString

업데이트할 리소스 본문입니다.

문자열

url

지정된 검색 URL에 대해 조건부 생성으로 업데이트를 수행해야 함을 지정합니다.

문자열

위의 매개변수 외에도 fhir API는 쿼리 매개 변수 중 하나를 사용할 수도 있습니다.

임의의 매개변수는 끝점 URI로 제공되거나 메시지 헤더에서 동적으로 제공할 수 있습니다. 메시지 헤더 이름은 CamelFhir.parameter 형식이어야 합니다. inBody 매개변수는 메시지 헤더를 덮어씁니다. 즉, Body=myParameterName VERSION의 엔드포인트 매개변수는 CamelFhir.myParameterName ECDHE 헤더를 재정의합니다.

20.5.13. api: validate

생산자 및 소비자 모두 지원

검증 API는 다음과 같이 구문에 정의되어 있습니다.

fhir:validate/methodName?[parameters]

1 방법은 아래 표에 나열되어 있으며 각 방법에 대한 자세한 구문이 나와 있습니다. (API 메소드에는 이름 대신 구문에 사용할 수 있는 단축 별칭 이름이 있을 수 있습니다.)

방법설명

resource

리소스 검증

20.5.13.1. 메서드 리소스

서명:

  • ca.uhn.fhir.rest.api.MethodOutcome 리소스(String resourceAsString, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
  • ca.uhn.fhir.rest.api.MethodOutcome 리소스(org.>-<7.fhir.instance.api.api.api.IBaseResource 리소스, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);

fhir/resource API 방법에는 아래 표에 나열된 매개변수가 있습니다.

매개변수설명유형

extraParameters

전달할 수 있는 매개변수의 전체 목록은 ExtraParameters를 참조하십시오.

map

resource

유효성을 검사할 IBaseResource입니다.

IBaseResource

resourceAsString

확인할 원시 리소스

문자열

위의 매개변수 외에도 fhir API는 쿼리 매개 변수 중 하나를 사용할 수도 있습니다.

임의의 매개변수는 끝점 URI로 제공되거나 메시지 헤더에서 동적으로 제공할 수 있습니다. 메시지 헤더 이름은 CamelFhir.parameter 형식이어야 합니다. inBody 매개변수는 메시지 헤더를 덮어씁니다. 즉, Body=myParameterName VERSION의 엔드포인트 매개변수는 CamelFhir.myParameterName ECDHE 헤더를 재정의합니다.

20.6. Spring Boot Auto-Configuration

Spring Boot와 함께 fhir를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-fhir-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

이 구성 요소는 아래 나열된 Multus 옵션을 지원합니다.

이름설명Default유형

camel.component.fhir.access-token

OAuth 액세스 토큰.

 

문자열

camel.component.fhir.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.fhir.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.fhir.client

사용자 지정 클라이언트를 사용합니다. 옵션은 ca.uhn.fhir.rest.client.api.IGenericClient 유형입니다.

 

IGenericClient

camel.component.fhir.client-factory

사용자 지정 클라이언트 팩토리를 사용합니다. 옵션은 ca.uhn.fhir.rest.client.api.IRestfulClientFactory 유형입니다.

 

IRestfulClientFactory

camel.component.fhir.compress

발신(ECDHE/PUT) 콘텐츠를 GZIP 형식으로 압축합니다.

false

부울

camel.component.fhir.configuration

공유 구성을 사용하려면 다음을 수행합니다. 옵션은 org.apache.camel.component.fhir.FhirConfiguration 유형입니다.

 

FhirConfiguration

camel.component.fhir.connection-timeout

초기 TCP 연결을 시도하고 설정하는 데 걸리는 시간(ms)입니다.

10000

정수

camel.component.fhir.defer-model-scanning

이 옵션을 설정하면 지정된 유형의 하위 목록에 실제로 액세스할 때까지 모델 클래스를 스캔하지 않습니다.

false

부울

camel.component.fhir.enabled

fhir 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.fhir.encoding

모든 요청에 사용할 인코딩입니다.

 

문자열

camel.component.fhir.fhir-context

FhirContext는 생성할 비용이 많이 드는 오브젝트입니다. 여러 인스턴스가 생성되지 않도록 하려면 직접 설정할 수 있습니다. 옵션은 ca.uhn.fhir.context.FhirContext 유형입니다.

 

FhirContext

camel.component.fhir.fhir-version

사용할 FHIR 버전입니다.

R4

문자열

camel.component.fhir.force-conformance-check

강제 적합성 확인.

false

부울

camel.component.fhir.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.fhir.log

모든 요청과 응답을 기록합니다.

false

부울

camel.component.fhir.password

기본 인증에 사용할 사용자 이름입니다.

 

문자열

camel.component.fhir.pretty-print

거의 모든 요청을 인쇄합니다.

false

부울

camel.component.fhir.proxy-host

프록시 호스트입니다.

 

문자열

camel.component.fhir.proxy-password

프록시 암호입니다.

 

문자열

camel.component.fhir.proxy-port

프록시 포트입니다.

 

정수

camel.component.fhir.proxy-user

프록시 사용자 이름입니다.

 

문자열

camel.component.fhir.server-url

FHIR 서버 기본 URL입니다.

 

문자열

camel.component.fhir.session-cookie

HTTP 세션 쿠키는 모든 요청에 추가합니다.

 

문자열

camel.component.fhir.socket-timeout

개별 읽기/쓰기 작업(ms)에 대해 차단하는 기간입니다.

10000

정수

camel.component.fhir.summary

_summary param을 사용하여 서버에서 응답을 수정하도록 요청합니다.

 

문자열

camel.component.fhir.username

기본 인증에 사용할 사용자 이름입니다.

 

문자열

camel.component.fhir.validation-mode

Camel이 FHIR 서버의 적합성을 검증해야 하는 경우는 무엇입니까.

ONCE

문자열

camel.dataformat.fhirjson.content-type-header

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

true

부울

camel.dataformat.fhirjson.dont-encode-elements

제공되는 경우 인코딩할 수 없는 요소를 지정합니다. 이 필드에 유효한 값은 다음과 같습니다. 환자 - 모든 자식 Patient.name을 인코딩하지 않음 - 환자의 이름 Patient.name.family - Do't encode the patient's family name .text - don't encode the text element on any resource (only the first position may contain a wildcard) DSTU2 참고 사항: Patient.meta와 같은 메타 값은 DSTU2 구문 분석기에서 작동하지만 Patient.meta.lastUpdated와 같은 메타에 하위 요소가 있는 값은 DSTU3 모드에서만 작동합니다.

 

Set

camel.dataformat.fhirjson.dont-strip-versions-from-references-at-paths

값이 제공된 경우 지정된 경로의 리소스 참조에는 인코딩 프로세스 중에 자동으로 제거되는 대신 인코딩된 리소스 버전이 포함됩니다. 이 설정은 구문 분석 프로세스에는 영향을 미치지 않습니다. 이 방법은 setStripVersionsFromReferences(String)보다 세분화된 수준의 제어를 제공하고, setStripVersionsFromReferences(String)가 true(기본값)로 설정된 경우에도 이 메서드에 지정된 모든 경로가 인코딩됩니다.

 

list

camel.dataformat.fhirjson.enabled

fhirJson 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.fhirjson.encode-elements

제공되는 경우 인코딩해야 하는 요소를 다른 모든 항목을 제외하도록 지정합니다. 이 필드에 유효한 값은 Patient - Encode patient 및 모든 children Patient.name - 환자의 이름 Patient.name.family - 환자의 제품군 이름 .text만 인코딩 - 모든 리소스에 텍스트 요소만 인코딩됩니다(단, 첫 번째 위치에 와일드카드가 포함되어 있음) - 필수 필드를 유발하는 특수한 경우(만 0)로 인코딩됩니다.

 

Set

camel.dataformat.fhirjson.encode-elements-applies-to-child-resources-only

true(기본값은 false)로 설정하면 setEncode 10.0.0.1s(Set)에 제공된 값이 루트 리소스(일반적으로 Bundle)에 적용되지 않지만 포함된 하위 리소스(즉, 해당 번들의 검색 결과 리소스)에 적용됩니다.

false

부울

camel.dataformat.fhirjson.fhir-version

사용할 FHIR 버전입니다. 가능한 값은 DSTU2,DSTU2_HL7ORG,DSTU2_1,DSTU3,R4입니다.

DSTU3

문자열

camel.dataformat.fhirjson.omit-resource-id

true(기본값은 false)로 설정하면 인코딩되는 리소스의 ID가 출력에 포함되지 않습니다. 포함된 리소스에는 적용되지 않으며 루트 리소스에만 적용됩니다. 즉, 이 값이 true로 설정되면 포함된 리소스에는 여전히 로컬 ID가 있지만 외부/포함 ID에는 ID가 없습니다.

false

부울

camel.dataformat.fhirjson.override-resource-id-with-bundle-entry-full-url

true(기본값)로 설정하면 fullUrl이 정의된 경우 Bundle.entry.fullUrl이 Bundle.entry.resource의 리소스 ID를 덮어씁니다. 이 동작은 소스 데이터를 Bundle 오브젝트로 구문 분석할 때 발생합니다. 원하는 동작이 아닌 경우 이 값을 false로 설정합니다(예: 클라이언트 코드가 fullUrl과 리소스 ID 간의 추가 유효성 검사를 수행하려고 함).

false

부울

camel.dataformat.fhirjson.pretty-print

매우 인쇄 플래그를 설정합니다. 즉, 구문 분석기가 출력을 축소하는 대신 요소 간 사람이 읽을 수 있는 간격 및 줄 바꿈으로 리소스를 인코딩합니다.

false

부울

camel.dataformat.fhirjson.server-base-url

이 parser에서 사용하는 서버의 기본 URL을 설정합니다. 값이 설정되면 절대 URL로 제공된 경우 리소스 참조가 상대 참조로 전환되지만 지정된 기본과 일치하는 기본이 있는 경우 리소스 참조가 상대 참조로 변환됩니다.

 

문자열

camel.dataformat.fhirjson.strip-versions-from-references

true(기본값)로 설정하면 버전이 포함된 리소스 참조가 리소스가 인코딩될 때 버전이 제거됩니다. 대부분의 경우 한 리소스에서 다른 리소스로의 참조가 ID 및 버전이 아닌 ID별 리소스에 속해야 하므로 일반적으로 좋은 동작입니다. 그러나 경우에 따라 리소스 링크에서 버전을 유지하는 것이 좋습니다. 이 경우 이 값은 false로 설정되어야 합니다. 이 방법은 참조 인코딩을 전역적으로 비활성화하는 기능을 제공합니다. 세분화된 제어가 필요한 경우 setDontStripVersionsFromReferencesAtPaths(List)를 사용합니다.

false

부울

camel.dataformat.fhirjson.summary-mode

true(기본값은 false)로 설정된 경우 FHIR 사양에 표시된 요소만 요약 요소로 표시됩니다.

false

부울

camel.dataformat.fhirjson.suppress-narratives

true(기본값은 false)로 설정하면 인코딩된 값에 내포가 포함되지 않습니다.

false

부울

camel.dataformat.fhirxml.content-type-header

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

true

부울

camel.dataformat.fhirxml.dont-encode-elements

제공되는 경우 인코딩할 수 없는 요소를 지정합니다. 이 필드에 유효한 값은 다음과 같습니다. 환자 - 모든 자식 Patient.name을 인코딩하지 않음 - 환자의 이름 Patient.name.family - Do't encode the patient's family name .text - don't encode the text element on any resource (only the first position may contain a wildcard) DSTU2 참고 사항: Patient.meta와 같은 메타 값은 DSTU2 구문 분석기에서 작동하지만 Patient.meta.lastUpdated와 같은 메타에 하위 요소가 있는 값은 DSTU3 모드에서만 작동합니다.

 

Set

camel.dataformat.fhirxml.dont-strip-versions-from-references-at-paths

값이 제공된 경우 지정된 경로의 리소스 참조에는 인코딩 프로세스 중에 자동으로 제거되는 대신 인코딩된 리소스 버전이 포함됩니다. 이 설정은 구문 분석 프로세스에는 영향을 미치지 않습니다. 이 방법은 setStripVersionsFromReferences(String)보다 세분화된 수준의 제어를 제공하고, setStripVersionsFromReferences(String)가 true(기본값)로 설정된 경우에도 이 메서드에 지정된 모든 경로가 인코딩됩니다.

 

list

camel.dataformat.fhirxml.enabled

fhirECDHE 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.fhirxml.encode-elements

제공되는 경우 인코딩해야 하는 요소를 다른 모든 항목을 제외하도록 지정합니다. 이 필드에 유효한 값은 Patient - Encode patient 및 모든 children Patient.name - 환자의 이름 Patient.name.family - 환자의 제품군 이름 .text만 인코딩 - 모든 리소스에 텍스트 요소만 인코딩됩니다(단, 첫 번째 위치에 와일드카드가 포함되어 있음) - 필수 필드를 유발하는 특수한 경우(만 0)로 인코딩됩니다.

 

Set

camel.dataformat.fhirxml.encode-elements-applies-to-child-resources-only

true(기본값은 false)로 설정하면 setEncode 10.0.0.1s(Set)에 제공된 값이 루트 리소스(일반적으로 Bundle)에 적용되지 않지만 포함된 하위 리소스(즉, 해당 번들의 검색 결과 리소스)에 적용됩니다.

false

부울

camel.dataformat.fhirxml.fhir-version

사용할 FHIR 버전입니다. 가능한 값은 DSTU2,DSTU2_HL7ORG,DSTU2_1,DSTU3,R4입니다.

DSTU3

문자열

camel.dataformat.fhirxml.omit-resource-id

true(기본값은 false)로 설정하면 인코딩되는 리소스의 ID가 출력에 포함되지 않습니다. 포함된 리소스에는 적용되지 않으며 루트 리소스에만 적용됩니다. 즉, 이 값이 true로 설정되면 포함된 리소스에는 여전히 로컬 ID가 있지만 외부/포함 ID에는 ID가 없습니다.

false

부울

camel.dataformat.fhirxml.override-resource-id-with-bundle-entry-full-url

true(기본값)로 설정하면 fullUrl이 정의된 경우 Bundle.entry.fullUrl이 Bundle.entry.resource의 리소스 ID를 덮어씁니다. 이 동작은 소스 데이터를 Bundle 오브젝트로 구문 분석할 때 발생합니다. 원하는 동작이 아닌 경우 이 값을 false로 설정합니다(예: 클라이언트 코드가 fullUrl과 리소스 ID 간의 추가 유효성 검사를 수행하려고 함).

false

부울

camel.dataformat.fhirxml.pretty-print

매우 인쇄 플래그를 설정합니다. 즉, 구문 분석기가 출력을 축소하는 대신 요소 간 사람이 읽을 수 있는 간격 및 줄 바꿈으로 리소스를 인코딩합니다.

false

부울

camel.dataformat.fhirxml.server-base-url

이 parser에서 사용하는 서버의 기본 URL을 설정합니다. 값이 설정되면 절대 URL로 제공된 경우 리소스 참조가 상대 참조로 전환되지만 지정된 기본과 일치하는 기본이 있는 경우 리소스 참조가 상대 참조로 변환됩니다.

 

문자열

camel.dataformat.fhirxml.strip-versions-from-references

true(기본값)로 설정하면 버전이 포함된 리소스 참조가 리소스가 인코딩될 때 버전이 제거됩니다. 대부분의 경우 한 리소스에서 다른 리소스로의 참조가 ID 및 버전이 아닌 ID별 리소스에 속해야 하므로 일반적으로 좋은 동작입니다. 그러나 경우에 따라 리소스 링크에서 버전을 유지하는 것이 좋습니다. 이 경우 이 값은 false로 설정되어야 합니다. 이 방법은 참조 인코딩을 전역적으로 비활성화하는 기능을 제공합니다. 세분화된 제어가 필요한 경우 setDontStripVersionsFromReferencesAtPaths(List)를 사용합니다.

false

부울

camel.dataformat.fhirxml.summary-mode

true(기본값은 false)로 설정된 경우 FHIR 사양에 표시된 요소만 요약 요소로 표시됩니다.

false

부울

camel.dataformat.fhirxml.suppress-narratives

true(기본값은 false)로 설정하면 인코딩된 값에 내포가 포함되지 않습니다.

false

부울

21장. 파일

생산자 및 소비자 모두 지원

파일 구성 요소를 사용하면 파일 시스템에 액세스할 수 있으므로 다른 구성 요소의 다른 Camel 구성 요소 또는 메시지에서 파일을 처리하여 디스크에 저장할 수 있습니다.

21.1. URI 형식

file:directoryName[?options]

여기서 directoryName 은 기본 파일 디렉터리를 나타냅니다.

디렉터리만

Camel은 시작 디렉터리로 구성된 엔드포인트만 지원합니다. directoryName 은 디렉토리여야 합니다. 단일 파일만 사용하려면 fileName=thefilename.g.를 설정하여 fileName 옵션을 사용할 수 있습니다. 또한 시작 디렉터리에는 ${ } 자리 표시자가 있는 동적 표현식이 포함되어서는 안 됩니다. 다시 fileName 옵션을 사용하여 파일 이름의 동적 부분을 지정합니다.

참고

다른 애플리케이션에 의해 현재 작성 중인 파일을 읽지 않도록합니다.
JDK File IO API는 다른 애플리케이션이 현재 파일을 작성/복사하고 있는지 여부를 탐지하는 데 다소 제한되어 있습니다. 또한 구현은 OS 플랫폼에 따라 다를 수 있습니다. 이로 인해 Camel이 다른 프로세스에서 파일이 잠기지 않고 파일을 사용하기 시작할 수 있다고 생각할 수 있습니다. 따라서 사용자 환경에 어떤 제품군을 직접 조사해야 합니다. 이 Camel에 도움이 되도록 다양한 readLock 옵션과 doneFileName 옵션을 사용할 수 있습니다. 다른 사용자가 파일을 직접 삭제하는 폴더의 파일 사용 섹션을 참조하십시오.

21.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

21.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

21.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

21.3. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

21.4. 끝점 옵션

File 끝점은 URI 구문을 사용하여 구성됩니다.

file:directoryName

다음과 같은 경로 및 쿼리 매개변수 사용:

21.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

directoryname (common)

필수 시작 디렉터리입니다.

 

파일

21.4.2. 쿼리 매개변수(94 매개변수)

이름설명Default유형

triggerset (common)

이 옵션은 파일의 인코딩을 지정하는 데 사용됩니다. 소비자에서 이를 사용하여 파일 콘텐츠에 액세스하는 경우 Camel이 파일 콘텐츠를 로드해야 하는sterset을 확인할 수 있는 파일의 인코딩을 지정할 수 있습니다. 마찬가지로 이 파일을 작성할 때 이 옵션을 사용하여 파일을 쓰기 위해 어떤 wholeset를 지정할 수 있습니다. Camel 파일을 작성할 때 메시지 내용을 메모리로 읽어서 데이터를 구성된 stateset로 변환해야 할 수도 있으므로 큰 메시지가 있는 경우에는 사용하지 마십시오.

 

문자열

doneFileName (common)

생산자: 제공되는 경우 Camel은 원본 파일이 작성될 때 두 번째 완료된 파일을 작성합니다. 완료된 파일은 비어 있습니다. 이 옵션은 사용할 파일 이름을 설정합니다. 둘 중 고정 이름을 지정할 수 있습니다. 또는 동적 자리 표시자를 사용할 수 있습니다. 완료된 파일은 항상 원래 파일과 동일한 폴더에 작성됩니다. 소비자: 제공된 경우 Camel은 완료된 파일이 있는 경우에만 파일을 사용합니다. 이 옵션은 사용할 파일 이름을 설정합니다. 둘 중 고정 이름을 지정할 수 있습니다. 또는 동적 자리 표시자를 사용할 수 있습니다. done 파일은 항상 원래 파일과 동일한 폴더에 표시됩니다. $\\{file.name} 및 $\\{file.name.next}만 동적 자리 표시자로 지원됩니다.

 

문자열

파일 이름 (common)

파일 언어와 같은 표현식을 사용하여 동적으로 파일 이름을 설정합니다. 소비자의 경우 파일 이름 필터로 사용됩니다. 생산자의 경우 작성할 파일 이름을 평가하는 데 사용됩니다. 표현식이 설정된 경우 CamelFileName 헤더보다 우선합니다. (참고: 헤더 자체는 표현식일 수도 있습니다.) 표현식 옵션은 문자열 및 표현식 유형을 모두 지원합니다. 표현식이 String 유형인 경우 File Language를 사용하여 항상 평가됩니다. 표현식이 Expression 유형인 경우 지정된 Expression 유형이 사용됩니다. 예를 들어 OGNL 식을 사용할 수 있습니다. 소비자는 이를 사용하여 파일 이름을 필터링할 수 있으므로 파일 언어 구문: mydata-$\{date:now:yyyMMdd}.txt를 사용하여 오늘 파일을 사용할 수 있습니다. 생산자는 기존 CamelFileName 헤더보다 우선하는 CamelOverruleFileName 헤더를 지원합니다. CamelOverruleFileName은 한 번만 사용되는 헤더이므로 CamelFileName의 임시 저장소에서 쉽게 복원할 수 있습니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

삭제 (consumer)

true인 경우 파일이 처리된 후 삭제됩니다.

false

boolean

moveFailed (consumer)

간단한 언어를 기반으로 이동 실패 표현식을 설정합니다. 예를 들어 파일을 .error 하위 디렉터리로 이동하려면 .error를 사용합니다. 참고: 파일을 실패 위치로 이동하면 Camel에서 오류를 처리하고 파일을 다시 가져오지 않습니다.

 

문자열

noop (consumer)

true인 경우 파일은 어떤 방식으로든 이동되거나 삭제되지 않습니다. 이 옵션은 읽기 전용 데이터 또는 ETL 유형 요구 사항에 적합합니다. noop=true인 경우 Camel은 동일한 파일을 반복해서 사용하지 않도록 idempotent=true도 설정합니다.

false

boolean

pre home (consumer)

표현식(예: File Language)은 처리하기 전에 파일 이름을 동적으로 설정하는 데 사용됩니다. 예를 들어 in-progress 파일을 순서순으로 이동하려면 이 값을 순서대로 설정합니다.

 

문자열

preSort (consumer)

사전 정렬을 활성화하면 소비자는 폴링 중에 파일 및 디렉터리 이름을 정렬하며 파일 시스템에서 검색됩니다. 정렬된 순서로 파일에 대해 작업을 수행해야 하는 경우 이 작업을 수행할 수 있습니다. 사전 정렬은 소비자가 필터링을 시작하기 전에 실행되고 Camel을 통해 처리할 파일을 수락합니다. 이 옵션은 default=false이며 비활성화되어 있습니다.

false

boolean

재귀 (consumer)

디렉토리가 있는 경우 는 모든 하위 디렉터리에서도 파일을 찾습니다.

false

boolean

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

directoryMustExist (consumer (advanced))

startingDirectoryMustExist 옵션과 유사하지만 폴링 중에 적용됩니다(Consumer 시작 후).

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

extendedAttributes (consumer (advanced))

관심 있는 파일 속성을 정의하려면 다음을 수행합니다. posix:permissions,posix:owner,basic:lastAccessTime과 같이 posix:, basic:lastAccessTime과 같은 기본 와일드카드를 지원합니다.

 

문자열

inProgressRepository (consumer (advanced)

플러그인 가능한 in-progress 리포지토리 org.apache.camel.spi.IdempotentRepository. in-progress 리포지토리는 사용 중인 진행 중인 파일의 현재를 설명하는 데 사용됩니다. 기본적으로 메모리 기반 리포지토리가 사용됩니다.

 

IdempotentRepository

localWorkDirectory (consumer (advanced))

사용하는 경우 로컬 작업 디렉터리를 사용하여 원격 파일 내용을 로컬 파일에 직접 저장하여 콘텐츠를 메모리에 로드하지 않도록 할 수 있습니다. 이는 매우 큰 원격 파일을 사용하고 따라서 메모리를 절약할 수 있는 경우 유용합니다.

 

문자열

onCompletionExceptionHandler (consumer (advanced))

사용자 지정 org.apache.camel.spi.ExceptionHandler를 사용하여 소비자가 커밋 또는 롤백을 수행하는 완료 프로세스에서 파일 중에 발생하는 모든 throw된 예외를 처리합니다. 기본 구현은 WARN 수준에서 모든 예외를 기록하고 무시합니다.

 

ExceptionHandler

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

probeContentType (consumer (advanced))

콘텐츠 유형을 검색할지 여부입니다. 그런 다음 소비자는 Files#probeContentType(java.nio.file.Path)을 사용하여 파일의 콘텐츠 유형을 결정하고 메시지에서 Exchange#FILE_CONTENT_TYPE 키가 있는 헤더로 저장합니다.

false

boolean

processStrategy (consumer (advanced))

플러그형 org.apache.camel.component.file.GenericFileProcessStrategy를 사용하여 자체 readLock 옵션 또는 유사한 기능을 구현할 수 있습니다. 특수한 준비 파일과 같이 파일을 소비하기 전에 특수 조건을 충족해야 하는 경우에도 사용할 수 있습니다. 이 옵션을 설정하면 readLock 옵션이 적용되지 않습니다.

 

GenericFileProcessStrategy

resumeStrategy (consumer (advanced))

파일에 대한 재시작 전략을 설정합니다. 이렇게 하면 애플리케이션을 중지하기 전에 마지막 시점 이후에 파일을 읽기 위한 전략을 정의할 수 있습니다. 구현 세부 사항은 FileConsumerResumeStrategy를 참조하십시오.

 

FileConsumerResumeStrategy

startingDirectoryMustExist (consumer (advanced)

시작 디렉터리가 있어야 하는지 여부입니다. autoCreate 옵션은 기본적으로 활성화되어 있습니다. 즉, 시작 디렉터리는 일반적으로 존재하지 않는 경우 자동으로 생성됩니다. autoCreate를 비활성화하고 이를 활성화하여 시작 디렉터리가 있는지 확인할 수 있습니다. 디렉터리가 존재하지 않는 경우 예외가 발생합니다.

false

boolean

startingDirectoryMustHaveAccess (consumer (advanced)

시작 디렉터리에 액세스 권한이 있는지 여부입니다. 디렉터리가 존재하는지 확인하려면 startingDirectoryMustExist 매개변수를 true로 설정해야 합니다. 디렉터리에 읽기 및 쓰기 권한이 없는 경우 예외가 발생합니다.

false

boolean

appendChars (producer)

파일을 작성한 후 문자(텍스트)를 추가하는 데 사용됩니다. 예를 들어 새 파일 또는 기존 파일을 작성하고 추가할 때 새 줄 또는 기타 구분자를 추가할 수 있습니다. 새 줄(슬래시-n 또는 슬래시-r) 또는 탭(슬래시-t) 문자를 지정하려면 추가 슬래시인 eg slash-slash-n으로 이스케이프합니다.

 

문자열

fileExist (producer)

동일한 이름의 파일이 이미 있는 경우 어떻게 해야 합니까. 기본으로 override는 기존 파일을 대체합니다. - Append - 기존 파일에 콘텐츠를 추가합니다. - Fail - 기존 파일이 이미 있음을 나타내는 GenericFileOperationException이 발생합니다. - Ignore -는 자동으로 문제를 무시하고 기존 파일을 덮어쓰지 않지만 모든 것이 고칩니다. - Move - option은 moveExisting 옵션을 사용해야 합니다. 옵션 eagerDeleteTargetFile을 사용하여 파일을 이동하는 경우 수행할 작업을 제어할 수 있으며, 기존 파일이 이미 있으므로 이동 작업이 실패할 수 있습니다. 이동 옵션은 대상 파일을 작성하기 전에 기존 파일을 모두 이동합니다. - TryRename은 tempFileName 옵션을 사용하는 경우에만 적용됩니다. 이렇게 하면 exists 검사를 수행하지 않고 임시 이름에서 실제 이름으로 파일 이름을 변경할 수 있습니다. 일부 파일 시스템 및 특히 FTP 서버에서는 이 검사가 더 빨라질 수 있습니다.

CloudEvent 값:

  • 덮어쓰기
  • append
  • 실패
  • Ignore
  • 이동
  • TryRename

덮어쓰기

GenericFileExist

flatten (producer)

flatten은 선행 경로를 제거하기 위해 파일 이름 경로를 평면화하는 데 사용되므로 파일 이름일 뿐입니다. 이를 통해 재귀적으로 하위 디렉터리를 사용할 수 있지만, 다른 디렉토리에 파일을 쓰는 경우 단일 디렉토리에 기록됩니다. 생산자에서 이 값을 true로 설정하면 CamelFileName 헤더의 모든 파일 이름이 선행 경로로 제거됩니다.

false

boolean

jackStartingDirectory (producer)

시작 디렉터리(및 하위)에 파일 쓰기(제한)에만 사용됩니다. 이 기능은 기본적으로 Camel이 외부 디렉토리에 파일을 쓸 수 없도록 합니다(추가 보안 강화). 상위 폴더 또는 루트 폴더와 같은 시작 디렉토리 외부의 디렉터리에 파일 쓰기를 허용하도록 이 전원을 켤 수 있습니다.

true

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

GoExisting (producer)

fileExist=anchor가 구성될 때 사용할 파일 이름을 계산하는 데 사용되는 파일 언어(예: File Language)입니다. 파일을 백업 하위 디렉터리로 이동하려면 backup을 입력합니다. 이 옵션은 다음 File Language 토큰만 지원합니다. file:name, file:name.ext, file:name.noext, file:onlyname, file:onlyname.noext, file:ext, file:parent. FTP 구성 요소는 현재 디렉터리를 기반으로 하는 상대 디렉터리로만 이동할 수 있으므로 file:parent는 FTP 구성 요소에서 지원되지 않습니다.

 

문자열

tempFileName (producer)

tempPrefix 옵션과 동일하지만 임시 파일 이름 지정에 대해 파일 언어를 사용할 때 더 세밀한 제어를 제공합니다. tempFilename의 위치는 기본 uri의 대상 디렉터리가 아닌 'fileName' 옵션의 최종 파일 위치를 기준으로 합니다. 예를 들어 옵션 fileName에 디렉터리 접두사인 dir/finalFilename이 포함된 경우 tempFileName은 해당 하위 디렉터리 디렉터리와 관련이 있습니다.

 

문자열

tempPrefix (producer)

이 옵션은 임시 이름을 사용하여 파일을 작성한 다음 쓰기가 완료된 후 실제 이름으로 이름을 변경하는 데 사용됩니다. 작성 중인 파일을 식별하고 진행 중인 파일에서도 소비자(재정의 읽기 잠금을 사용하지 않음)를 방지할 수 있습니다. 는 종종 큰 파일을 업로드할 때 FTP에서 사용됩니다.

 

문자열

allowNullBody (producer (advanced))

파일 쓰기 중에 null 본문이 허용되는지 지정하는 데 사용됩니다. true로 설정하면 빈 파일이 생성되고 false로 설정된 경우 null 본문을 파일 구성 요소로 보내려고 하면 'Cannot write null body to file' will be thrown. fileExist 옵션이 'Override'로 설정되면 파일이 잘리며 파일을 첨부하도록 설정하면 변경되지 않은 상태로 유지됩니다.

false

boolean

all (producer)

프로듀서에서 보내는 파일 권한을 지정하십시오, ScanSetting 값은 4.6.1과 777 사이여야 합니다. 0755에 선행 숫자가 있는 경우 무시하겠습니다.

 

문자열

ChronyDirectory (producer)

프로듀서가 누락된 디렉토리를 만들 때 사용되는 디렉토리 권한을 지정하십시오. Chrony 값은 4.6.1과 777 사이에 있어야 합니다. 0755와 같은 선행 숫자가 있는 경우 무시하겠습니다.

 

문자열

eagerDeleteTargetFile (producer (advanced))

기존 대상 파일을 신속하게 삭제할지 여부입니다. 이 옵션은 fileExists=Override 및 tempFileName 옵션도 사용하는 경우에만 적용됩니다. 이를 사용하여 임시 파일을 작성하기 전에 대상 파일을 비활성화(false로 설정)할 수 있습니다. 예를 들어, 임시 파일을 작성하는 동안 큰 파일을 작성하고 대상 파일이 존재하도록 할 수 있습니다. 이렇게 하면 임시 파일의 이름이 대상 파일 이름으로 변경되기 직전의 마지막 시간까지 대상 파일이 삭제됩니다. 이 옵션은 fileExist=anchor가 활성화되고 기존 파일이 존재하는 경우 기존 파일을 삭제할지 여부를 제어하는 데도 사용됩니다. 이 옵션 copyAndDeleteOnRenameFails false, 기존 파일이 존재하는 경우, true인 경우 이동 작업 전에 기존 파일이 삭제되면 예외가 발생합니다.

true

boolean

forceWrites (advanced)

파일 시스템에 쓰기를 강제 동기화할지 여부입니다. 이 수준의 보장을 원하지 않는 경우 (예: 로그 / 감사 로그 등에 쓰는 경우) 이 기능을 끄면 성능이 향상됩니다.

true

boolean

keepLastModified (producer (advanced))

은 소스 파일에서 마지막으로 수정된 타임스탬프를 유지합니다(있는 경우). 는 타임 스탬프에 Exchange.FILE_LAST_MODIFIED 헤더를 사용합니다. 이 헤더에는 java.util.Date 또는 타임스탬프와 함께 긴 시간이 포함될 수 있습니다. 타임스탬프가 존재하고 옵션이 활성화되어 있으면 기록된 파일에 이 타임스탬프가 설정됩니다. 참고: 이 옵션은 파일 프로듀서에만 적용됩니다. 이 옵션은 FTP 생산자와 함께 사용할 수 없습니다.

false

boolean

moveExistingFileStrategy (producer (advanced))

fileExist=3-4가 구성될 때 사용할 특수 이름 지정 토큰으로 파일을 이동하는 데 사용되는 전략(Custom Strategy)입니다. 기본적으로 사용자 정의 전략이 제공되지 않는 경우 사용되는 구현이 있습니다.

 

FileMoveExistingStrategy

autoCreate (advanced)

파일의 경로 이름에 누락된 디렉터리를 자동으로 생성합니다. 파일 소비자의 경우 이는 시작 디렉터리 만들기를 의미합니다. 파일 생산자의 경우 파일을 작성해야 하는 디렉터리를 나타냅니다.

true

boolean

bufferSize (advanced)

파일을 쓰는 데 사용되는 버퍼 크기(또는 파일을 다운로드하고 업로드하는 FTP의 경우)

131072

int

copyAndDeleteOnRenameFail (advanced)

파일 이름을 직접 변경할 수 없는 경우 복사 및 삭제 파일을 대체할지 여부입니다. 이 옵션은 FTP 구성 요소에서 사용할 수 없습니다.

true

boolean

renameUsingCopy (advanced)

복사 및 삭제 전략을 사용하여 이름 변경 작업을 수행합니다. 이는 주로 일반 이름 변경 작업이 신뢰할 수 없는 환경에서 사용됩니다(예: 다른 파일 시스템 또는 네트워크에서). 이 옵션은 추가 지연 후에만 복사 및 삭제 전략으로 대체되는 copyAndDeleteOnRenameFail 매개변수보다 우선합니다.

false

boolean

동기 (고급)

동기 처리를 엄격하게 사용해야 하는지 여부를 설정합니다.

false

boolean

antExclude (filter)

ant 스타일 필터 제외. antInclude 및 antExclude를 모두 사용하면 antExclude가 antInclude보다 우선합니다. 여러 제외 항목을 쉼표로 구분된 형식으로 지정할 수 있습니다.

 

문자열

antFilterCaseSensitive (filter)

ant 필터에 대/소문자 구분 플래그를 설정합니다.

true

boolean

antInclude (filter)

ant 스타일 필터 포함. 여러 포함을 쉼표로 구분된 형식으로 지정할 수 있습니다.

 

문자열

eagerMaxMessagesPerPoll (필터)

maxMessagesPerPoll의 제한이 eager인지 여부를 제어할 수 있습니다. If eager then the limit is during the scanning of files. 여기서 as false는 모든 파일을 스캔한 다음 정렬을 수행합니다. 이 옵션을 false로 설정하면 모든 파일을 먼저 정렬한 다음 폴링을 제한할 수 있습니다. 정렬을 수행하기 위해 모든 파일 세부 정보가 메모리에 있기 때문에 메모리 사용량이 더 높아야 합니다.

true

boolean

제외 (필터)

은 파일을 제외하는 데 사용됩니다. 파일 이름이 regex 패턴과 일치하는 경우(대소문자를 구분하지 않음). 더하기 기호와 같은 기호를 사용하는 경우 끝점 uri로 구성하는 경우 RAW() 구문을 사용하여 이 기호를 구성해야 합니다. 엔드 포인트 배리 구성에 대한 자세한 내용을 참조하십시오.

 

문자열

excludeExt (filter)

은 파일 확장 이름과 일치하는 파일을 제외하는 데 사용됩니다(대/소문자를 구분하지 않음). 예를 들어 bak 파일을 제외하려면 excludeExt=bak을 사용합니다. 여러 확장은 쉼표로 분리할 수 있습니다. 예를 들어 bak 및 dat 파일을 제외하려면 excludeExt=bak,dat를 사용합니다. 파일 확장자에는 모든 부분이 포함되어 있습니다. 예를 들어 mydata.tar.gz라는 파일이 있으면 tar.gz라는 확장자가 있습니다. 유연성을 높이기 위해 include/exclude 옵션을 사용하십시오.

 

문자열

필터 (필터)

org.apache.camel.component.file.GenericFileFilter 클래스로서의 Pluggable 필터. filter가 accept() 메서드에서 false를 반환하는 경우 파일을 건너뜁니다.

 

GenericFileFilter

filterDirectory (filter)

간단한 언어를 기반으로 디렉터리를 필터링합니다. 예를 들어 현재 날짜를 필터링하려면 $\\{date:yyyyMMdd}와 같은 간단한 날짜 패턴을 사용할 수 있습니다.

 

문자열

filterFile (필터)

간단한 언어를 기반으로 파일을 필터링합니다. 예를 들어 파일 크기를 필터링하려면 $\\{file:size} 5000을 사용할 수 있습니다.

 

문자열

idempotent (필터)

Idempotent Consumer EIP 패턴을 사용하여 Camel이 이미 파일을 처리할 수 있도록 하는 옵션입니다. 기본적으로 1000개의 항목을 보유하는 메모리 기반 LRUCache를 사용합니다. noop=true인 경우 동일한 파일을 반복해서 사용하지 않도록 idempotent도 활성화됩니다.

false

부울

idempotentKey (filter)

사용자 정의 idempotent 키를 사용합니다. 기본적으로 파일의 절대 경로가 사용됩니다. 예를 들어 파일 이름 및 파일 크기를 사용하는 데 File Language를 사용할 수 있습니다. idempotentKey=$\{file:name}-$\{file:size}.

 

문자열

idempotentRepository (필터)

연결이 가능한 리포지토리 org.apache.camel.spi.IdempotentRepository는 지정하지 않고 idempotent가 true인 경우 기본적으로 MemoryIdempotentRepository를 사용합니다.

 

IdempotentRepository

포함 (필터)

파일 이름이 regex 패턴과 일치하는 경우 파일을 포함하는 데 사용됩니다(대개 대소문자를 구분하지 않음). 더하기 기호와 같은 기호를 사용하는 경우 끝점 uri로 구성하는 경우 RAW() 구문을 사용하여 이 기호를 구성해야 합니다. 엔드 포인트 배리 구성에 대한 자세한 내용을 참조하십시오.

 

문자열

includeExt (필터)

은 파일 확장 이름과 일치하는 파일 확장 이름(대/소문자를 구분하지 않음)을 포함하는 데 사용됩니다. 예를 들어 txt 파일을 포함하고 includeExt=txt를 사용합니다. txt 및 xml 파일을 포함하도록 여러 확장 기능을 쉼표로 분리할 수 있습니다. includeExt=txt,xml을 사용합니다. 파일 확장자에는 모든 부분이 포함되어 있습니다. 예를 들어 mydata.tar.gz라는 파일이 있으면 tar.gz라는 확장자가 있습니다. 유연성을 높이기 위해 include/exclude 옵션을 사용하십시오.

 

문자열

maxdepth (필터)

디렉터리를 재귀적으로 처리할 때 트래버스할 최대 깊이입니다.

2147483647

int

maxMessagesPerPoll (필터)

폴링당 수집할 최대 메시지를 정의하려면 다음을 수행합니다. 기본적으로 최대값은 설정되어 있지 않습니다. 수천 개의 파일이 있는 서버를 시작할 때 방지하도록 1000의 제한을 설정하는 데 사용할 수 있습니다. 이를 비활성화하려면 0 또는 negative의 값을 설정합니다. 주의: 이 옵션이 사용 중이면 파일 및 FTP 구성 요소는 정렬 전에 제한됩니다. 예를 들어 100000개의 파일이 있고 maxMessagesPerPoll=500을 사용하는 경우 처음 500개 파일만 선택하고 정렬합니다. eagerMaxMessagesPerPoll 옵션을 사용하여 먼저 모든 파일을 스캔한 다음 나중에 정렬할 수 있도록 이 값을 false로 설정할 수 있습니다.

 

int

minDepth (필터)

디렉터리를 재귀적으로 처리할 때 처리를 시작하는 최소 깊이입니다. minDepth=1을 사용하면 기본 디렉터리가 됩니다. minDepth=2를 사용하면 첫 번째 하위 디렉터리가 됩니다.

 

int

이동 (필터)

처리 후 이동 시 파일 이름을 동적으로 설정하는 데 사용되는 표현식(예: Simple Language)입니다. 파일을 .done 하위 디렉터리로 이동하려면 .done을 입력합니다.

 

문자열

exclusiveReadLockStrategy (lock)

Pluggable read-lock as a org.apache.camel.component.file.GenericFileExclusiveReadLockStrategy 구현

 

GenericFileExclusiveReadLockStrategy

readLock (lock)

소비자가 파일에 전용 읽기 잠금이 있는 경우에만 파일을 폴링하는 데 사용합니다(즉, 파일은 in-progress 또는 작성 중 없음). Camel은 파일 잠금이 부여될 때까지 기다립니다. 이 옵션은 전략으로 빌드를 제공합니다. - none - 읽기 잠금이 사용되지 않음 - markerFile - Camel은 마커 파일(fileName.camelLock)을 생성한 다음 잠금을 유지합니다. 이 옵션은 FTP 구성 요소에서 사용할 수 없습니다 - changed - Changed는 파일이 현재 복사 중인지 여부를 감지하기 위해 파일 길이/수정 타임스탬프를 사용하고 있습니다. 적어도 1 sec를 사용하여 이 옵션을 사용하여 다른 옵션보다 빠르게 파일을 사용할 수는 없지만 JDK IO API가 다른 프로세스에서 현재 파일을 사용하고 있는지 여부를 확인할 수 없기 때문에 더 신뢰할 수 없습니다. 옵션 readLockCheckInterval을 사용하여 검사 빈도를 설정할 수 있습니다. - fileLock -는 java.nio.channels.FileLock를 사용합니다. 이 옵션은 Windows OS 및 FTP 구성 요소에 사용할 수 없습니다. 이 방법은 파일 시스템이 분산 파일 잠금을 지원하지 않는 한 마운트/공유를 통해 원격 파일 시스템에 액세스하는 것을 피해야 합니다. - rename은 전용 읽기-lock을 얻을 수 있는 경우 파일 이름을 테스트로 사용하는 것입니다. - idempotent - (파일 구성 요소) idempotent는 read-lock으로 idempotent를 사용하는 것입니다. 이를 통해 idempotent 리포지토리 구현에서 이를 지원하는 경우 클러스터링을 지원하는 읽기 잠금을 사용할 수 있습니다. - idempotent-changed - (파일 구성 요소 전용) idempotent-changed-changed는 idempotentRepository를 사용하고 결합된 읽기 잠금으로 변경된 것입니다. 이를 통해 idempotent 리포지토리 구현에서 이를 지원하는 경우 클러스터링을 지원하는 읽기 잠금을 사용할 수 있습니다. - idempotent-rename - (파일 구성 요소 전용) idempotentRepository는 idempotentRepository를 사용하고 결합된 읽기 잠금으로 이름을 변경합니다. 이를 통해 idempotent 리포지토리 구현이 that.Notice를 지원하는 경우 클러스터링을 지원하는 읽기 잠금을 사용할 수 있습니다. 다양한 읽기 잠금이 클러스터형 모드에서 작동하는 데 적합하지는 않으며, 다른 노드의 동시 소비자가 공유 파일 시스템의 동일한 파일에 대해 경쟁하는 데 적합하지 않습니다. markerFile은 원자 작업과 가까운 작업을 사용하여 빈 마커 파일을 생성하지만 클러스터에서는 작동하지 않을 수 있습니다. fileLock은 더 잘 작동할 수 있지만 파일 시스템은 분산 파일 잠금을 지원해야 합니다. idempotent 읽기 잠금을 사용하면 idempotent 리포지토리에서 Hazelcast Component 또는 Infinispan과 같은 클러스터링을 지원하는 경우 클러스터링을 지원할 수 있습니다.

CloudEvent 값:

  • none
  • markerFile
  • fileLock
  • rename
  • changed
  • idempotent
  • idempotent-changed
  • idempotent-rename

none

문자열

readLockCheckInterval (lock)

읽기 잠금에서 지원하는 경우 읽기-잠재 간격(밀리초)입니다. 이 간격은 읽기 잠금을 취득하려는 시도 사이에 자고하는 데 사용됩니다. 예를 들어 변경된 읽기 잠금을 사용하는 경우 느린 쓰기를 위해 더 높은 간격 기간을 설정할 수 있습니다. 프로듀서가 매우 느린 경우 1 sec의 기본값은 너무 빠를 수 있습니다. 알림: FTP의 경우 기본 readLockCheckInterval은 5000입니다. readLockTimeout 값은 readLockCheckInterval보다 커야 하지만, 지문 규칙에 따라 readLockCheckInterval보다 2배 이상 높은 시간 초과가 발생합니다. 이는 읽기 잠금 프로세스에서 시간 초과에 도달하기 전에 잠금을 해제할 수 있도록 허용되도록 하려면 이 작업이 필요합니다.

1000

long

readLockDeleteOrphanLockFiles (lock)

시작 시 마커 파일로 잠금을 읽을지 여부에 관계없이 Camel이 올바르게 종료되지 않은 경우(예: JVM 충돌) 파일 시스템에 남아 있을 수 있는 고립된 읽기 잠금 파일을 삭제해야 합니다. 이 옵션을 false로 설정하면 분리된 잠금 파일이 있으면 Camel이 해당 파일을 찾지 못하므로 다른 노드에서 동일한 공유 디렉터리에서 파일을 동시에 읽을 수도 있습니다.

true

boolean

readLockIdempotentReleaseAsync (lock)

지연된 릴리스 작업이 동기인지 비동기식인지 여부입니다. 자세한 내용은 readLockIdempotentReleaseDelay 옵션에서 참조하십시오.

false

boolean

readLockIdempotentReleaseAsyncPoolSize (lock)

비동기 릴리스 작업을 사용할 때 예약된 스레드 풀의 스레드 수입니다. 기본적으로 1개의 코어 스레드를 사용하는 것은 거의 모든 사용 사례에 충분해야 하며, idempotent 리포지토리를 업데이트하는 경우 이 값을 더 높은 값으로 설정하거나 처리할 파일이 많이 있는 경우에만 이 값을 더 높은 값으로 설정해야 합니다. readLockIdempotentReleaseExecutorService 옵션을 구성하여 공유 스레드 풀을 사용하는 경우 이 옵션을 사용하지 않습니다. 자세한 내용은 readLockIdempotentReleaseDelay 옵션에서 참조하십시오.

 

int

ReadLockIdempotentReleaseDelay (lock)

릴리스 작업 시간(millis)을 지연할지 여부입니다. 이는 파일이 읽기-잠금된 상태/활성 클러스터 시나리오에서 공유 idempotent 리포지토리를 사용하는 활성/활성 클러스터 시나리오에서 릴리스 작업을 지연시켜 race-conditions로 인해 다른 노드에서 동일한 파일을 잠재적으로 스캔하고 가져올 수 없도록 하는 데 사용할 수 있습니다. 릴리스 작업의 시간을 늘리면 이러한 상황을 방지하는 데 도움이 됩니다. 참고 지연은 readLockRemoveOnCommit을 true로 구성한 경우에만 필요합니다.

 

int

ReadLockIdempotentReleaseExecutorService (lock)

비동기 릴리스 작업에 사용자 지정 및 공유 스레드 풀을 사용하려면 다음을 수행합니다. 자세한 내용은 readLockIdempotentReleaseDelay 옵션에서 참조하십시오.

 

ScheduledExecutorService

readLockLoggingLevel (lock)

읽기 잠금을 얻을 수 없을 때 사용되는 로깅 수준입니다. 기본적으로 DEBUG가 기록됩니다. 로깅이 없는 경우 이 수준을 OFF로 변경할 수 있습니다. 이 옵션은 readLock of types: changed, fileLock, idempotent, idempotent-changed, idempotent-rename, rename에 적용됩니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

DEBUG

LoggingLevel

readLockMarkerFile (lock)

변경됨, 이름 변경 또는 전용 읽기 잠금 유형과 함께 마커 파일을 사용할지 여부입니다. 기본적으로 마커 파일은 동일한 파일을 선택하는 다른 프로세스를 방지하기 위해 사용됩니다. 이 옵션을 false로 설정하여 이 동작을 해제할 수 있습니다. 예를 들어 Camel 애플리케이션에서 마커 파일을 파일 시스템에 작성하지 않으려면 다음을 수행하십시오.

true

boolean

readLockMinAge (lock)

이 옵션은 readLock=changed에만 적용됩니다. 읽기 잠금을 얻기 전에 파일이 있어야 하는 최소 기간을 지정할 수 있습니다. 예를 들어 readLockMinAge=300s를 사용하여 파일이 마지막 5분 동안 있어야 합니다. 이렇게 하면 변경된 읽기 잠금이 빨라질 수 있습니다. 이는 지정된 기간 이상의 파일만 취득하려고 시도하기 때문입니다.

0

long

readLockMinLength (lock)

이 옵션은 readLock=changed에만 적용됩니다. 최소 파일 길이를 구성할 수 있습니다. 기본적으로 Camel은 파일에 데이터를 포함할 것으로 예상하므로 기본값은 1입니다. 이 옵션을 0으로 설정하여 길이가 0인 파일을 사용할 수 있습니다.

1

long

readLockRemoveOnCommit (lock)

이 옵션은 readLock=idempotent에만 적용됩니다. 파일을 처리할 때 idempotent 리포지토리에서 파일 이름 항목을 제거할지 여부를 지정하고 커밋이 수행됩니다. 기본적으로 파일이 제거되지 않아 경쟁 조건이 발생하지 않으므로 다른 활성 노드가 파일을 가져 오려고 할 수 있습니다. 대신 idempotent 리포지토리는 X분 후에 파일 이름 항목을 제거하도록 구성할 수 있는 제거 전략을 지원할 수 있습니다. 자세한 내용은 readLockIdempotentReleaseDelay 옵션에서 참조하십시오.

false

boolean

readLockRemoveOnRollback (lock)

이 옵션은 readLock=idempotent에만 적용됩니다. 파일을 처리하는 데 실패하여 롤백이 발생할 때 idempotent 리포지토리에서 파일 이름 항목을 제거할지 여부를 지정할 수 있습니다. 이 옵션이 false이면 파일 이름 항목이 확인됩니다(파일이 커밋한 것처럼).

true

boolean

readLockTimeout (lock)

읽기-잠재에서 지원하는 경우 읽기-잠재에 대한 millis의 선택적 타임아웃입니다. 읽기-잠재를 부여할 수 없고 시간 초과가 트리거되면 Camel이 파일을 건너뜁니다. 다음 폴링 Camel에서 파일을 다시 시도할 것이며, 이번에는 읽기 잠금이 부여될 수 있습니다. 영구적으로 표시하려면 0 이하의 값을 사용합니다. 현재 fileLock, 변경 및 이름 변경이 시간 초과를 지원합니다. 알림: FTP의 경우 기본 readLockTimeout 값은 10000 대신 10.0.0.1입니다. readLockTimeout 값은 readLockCheckInterval보다 커야 하지만, 지문 규칙에 따라 readLockCheckInterval보다 2배 이상 높은 시간 초과가 발생합니다. 이는 읽기 잠금 프로세스에서 시간 초과에 도달하기 전에 잠금을 해제할 수 있도록 허용되도록 하려면 이 작업이 필요합니다.

10000

long

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

shuffle (sort)

파일 목록을 셔플합니다(임의 임의 순서로 정렬).

false

boolean

sortby (sort)

파일 언어를 사용하여 기본 제공 정렬. 중첩된 정렬을 지원하므로 파일 이름 및 수정된 날짜에 따라 두 번째 그룹 정렬으로 정렬할 수 있습니다.Supports nested sorts, so you can have a sort by file name and as a 2nd group sort by modified date.

 

문자열

Sort er (sort)

Pluggable sorter as a java.util.Comparator 클래스.

 

comparator

참고


파일 프로듀서의 기본 동작은기본적으로 동일한 이름의 기존 파일을 덮어씁니다.

21.5. 작업 이동 및 삭제

이동 또는 삭제 작업은 라우팅이 완료된 후에도 실행되므로 Exchange 를 처리하는 동안 파일이 계속 inbox 폴더에 있습니다.

예를 들어 이를 설명하겠습니다.

from("file://inbox?move=.done").to("bean:handleOrder");

파일이 inbox 폴더에 삭제되면 파일 소비자는 이를 확인하고 handleOrder console로 라우팅되는 새 FileExchange 를 생성합니다. 그런 다음 console은 File 오브젝트를 처리합니다. 이 시점에서 파일은 여전히 inbox 폴더에 있습니다. 빈이 완료되고 경로가 완료되면 파일 소비자는 이동 작업을 수행하고 파일을 .done 하위 폴더로 이동합니다.

이동 및 pre >-< 옵션은 디렉터리 이름으로 간주됩니다( File Language와 같은 표현식을 사용하는 경우 또는 간단한 표현식 평가 결과는 사용할 파일 이름입니다. 예를 들어, 설정한 경우 다음을 수행합니다.

move=../backup/copy-of-${file:name}

그런 다음 사용할 파일 언어를 사용하는 File 언어를 사용하는데, 이는 상대 또는 절대일 수 있습니다. 상대적인 경우 파일이 사용된 폴더의 하위 폴더로 디렉터리가 생성됩니다.

기본적으로 Camel은 사용된 파일을 파일이 사용된 디렉토리를 기준으로 .camel 하위 폴더로 이동합니다.

처리 후 파일을 삭제하려면 경로는 다음과 같아야 합니다.

from("file://inbox?delete=true").to("bean:handleOrder");

처리되기 전에 파일을 이동하는 사전 이동 작업을 도입했습니다. 이를 통해 처리되기 전에 이 하위 폴더로 이동할 때 어떤 파일이 검사되었는지 표시할 수 있습니다.

from("file://inbox?preMove=inprogress").to("bean:handleOrder");

사전 이동과 일반 이동을 결합할 수 있습니다.

from("file://inbox?preMove=inprogress&move=.done").to("bean:handleOrder");

이 경우 파일은 처리할 때 진행 중인 폴더에 있고 처리 후 .done 폴더로 이동합니다.

21.6. 이동 및 PreForwarded 옵션에 대한 세밀한 제어

movepre >-< 옵션은 표현식 기반이므로 File Language의 전체 기능을 사용하여 디렉토리 및 이름 패턴의 고급 구성을 수행할 수 있습니다.
Camel은 실제로 내부적으로 파일 언어 표현식으로 입력한 디렉토리 이름을 변환합니다. 따라서 move=.done Camel을 입력하면 ${file:parent}/.done/${file:onlyname} 로 변환합니다. 이는 Camel이 옵션 값에 $\{ }를 직접 제공하지 않았음을 감지한 경우에만 수행됩니다. 따라서 $\{ } Camel을 입력하면 변환 되지 않으므로 전체 성능이 저하됩니다.

따라서 오늘 날짜가 패턴인 백업 폴더로 파일을 이동하려는 경우 다음을 수행할 수 있습니다.

move=backup/${date:now:yyyyMMdd}/${file:name}

21.7. moveFailed 정보

moveFailed 옵션을 사용하면 선택한 오류 폴더와 같은 다른 위치로 성공적으로 처리할 수 없는 파일을 이동할 수 있습니다. 예를 들어 타임스탬프가 있는 오류 폴더에 있는 파일을 이동하려면 moveFailed=/error/${file:noext}-${date:now:yyyMMddHHmmsSSS}.${\'file:ext}를 사용할 수 있습니다.

자세한 내용은 다음에서 참조하십시오.

21.8. 메시지 헤더

이 구성 요소에서 지원되는 헤더는 다음과 같습니다.

21.8.1. 파일 프로듀서만 해당

header설명

CamelFileName

작성할 파일의 이름(부트 포인트 디렉터리와 관련)을 지정합니다. 이 이름은 문자열 일 수 있습니다. File Language 또는 Simple language 표현식이 있는 문자열 또는 Expression 개체일 수 있습니다. null 이면 Camel은 메시지 고유 ID를 기반으로 파일 이름을 자동으로 생성합니다.

CamelFileNameProduced

기록된 출력 파일의 실제 절대 파일 경로(path + name)입니다. 이 헤더는 Camel에 의해 설정되며 최종 사용자에게 작성된 파일 이름을 제공합니다.

CamelOverruleFileName

CamelFileName 헤더를 덮어쓸 때 사용되며 대신 값을 사용합니다(단어가 파일을 작성한 후 이 헤더를 제거하므로 한 번만). 값은 문자열일 수 있습니다. fileName 옵션이 구성되어 있으면 이 옵션이 계속 평가되고 있습니다.

21.8.2. 파일 소비자만 해당

header설명

CamelFileName

소비된 파일의 이름이 끝점에 구성된 시작 디렉터리에서 오프셋된 상대 파일 경로입니다.

CamelFileNameOnly

파일 이름(본 경로가 없는 이름)만 해당합니다.

CamelFileAbsolute

사용된 파일이 절대 경로를 나타내는지 여부를 지정하는 부울 옵션입니다. 일반적으로 상대 경로의 경우 false 여야 합니다. 절대 경로는 일반적으로 사용되지 않아야 하지만 파일을 절대 경로로 이동할 수 있도록 move 옵션에 추가했습니다. 그러나 다른 곳에서도 사용할 수 있습니다.

CamelFileAbsolutePath

파일의 절대 경로입니다. 상대 파일의 경우 이 경로에 상대 경로가 대신 있습니다.

CamelFilePath

파일 경로입니다. 상대 파일의 경우 이 값은 시작 디렉토리 + 상대 파일 이름입니다. 절대 파일의 경우 절대 경로입니다.

CamelFileRelativePath

상대 경로입니다.

CamelFileParent

부모 경로입니다.

CamelFileLength

파일 크기를 포함하는 값입니다.

CamelFileLastModified

파일의 마지막 수정된 타임스탬프를 포함하는 Long 값입니다.

21.9. 일괄 소비자

이 구성 요소는 Batch Consumer를 구현합니다.

21.10. Exchange 속성, 파일 소비자만 지원

파일 소비자는 폴링한 파일의 일괄 처리를 지원합니다.As the file consumer implements the BatchConsumer it supports batching the files it polls. 일괄 처리를 통해 Camel이 다음 추가 속성을 교환에 추가하므로 폴링된 파일 수, 현재 인덱스 및 배치가 이미 완료되었는지 여부를 알 수 있습니다.

속성설명

CamelBatchSize

이 배치에서 폴링된 총 파일 수입니다.

CamelBatchIndex

배치의 현재 인덱스입니다. 0에서 시작합니다.

CamelBatchComplete

일괄 처리의 마지막 교환을 나타내는 부울 값입니다. 마지막 항목에 대해서만 true 입니다.

이를 통해 이 배치에 존재하는 파일 수를 알 수 있으며 예를 들어 Aggregator2에서 이 수의 파일을 집계하도록 할 수 있습니다.

21.11. grafset 사용

Charset 옵션을 사용하면 소비자 및 생산자 끝점 모두에서 파일의 인코딩을 구성할 수 있습니다. 예를 들어 utf-8 파일을 읽고 iso-8859-1로 파일을 변환하려는 경우 다음을 수행할 수 있습니다.

from("file:inbox?charset=utf-8")
  .to("file:outbox?charset=iso-8859-1")

경로에서 convertBodyTo 를 사용할 수도 있습니다. 아래 예제에서는 utf-8 형식으로 파일을 계속 입력했지만 파일 내용을 iso-8859-1 형식의 바이트 배열로 변환하려고 합니다. 그런 다음 빈에서 데이터를 처리하도록 합니다. 현재Charset을 사용하여 받은 편지함 폴더에 콘텐츠를 쓰기 전에 다음을 수행합니다.

from("file:inbox?charset=utf-8")
  .convertBodyTo(byte[].class, "iso-8859-1")
  .to("bean:myBean")
  .to("file:outbox");

소비자 엔드포인트에서Charset을 생략하면 Camel은 파일의 Charset을 알 수 없으며 기본적으로 "UTF-8"을 사용합니다. 그러나 org.apache.camel.default.charset 키를 사용하여 다른 기본 인코딩을 재정의하고 사용하도록 JVM 시스템 속성을 구성할 수 있습니다.

아래 예제에서는 파일이 UTF-8 인코딩에 없는 경우 문제가 될 수 있습니다. 이 인코딩은 파일을 읽기 위한 기본 인코딩입니다.
이 예제에서는 파일을 작성할 때 콘텐츠가 이미 바이트 배열로 변환되어 있으므로 추가 인코딩 없이 콘텐츠를 그대로 그대로 씁니다.

from("file:inbox")
  .convertBodyTo(byte[].class, "iso-8859-1")
  .to("bean:myBean")
  .to("file:outbox");

또한 Exchange.CHARSET_NAME 키로 교환에 속성을 설정하여 파일을 작성할 때 인코딩 동적 인코딩을 재정의하고 제어할 수도 있습니다. 예를 들어 아래 경로에서는 메시지 헤더의 값으로 속성을 설정합니다.

from("file:inbox")
  .convertBodyTo(byte[].class, "iso-8859-1")
  .to("bean:myBean")
  .setProperty(Exchange.CHARSET_NAME, header("someCharsetHeader"))
  .to("file:outbox");

동일한 인코딩으로 파일을 선택하고 특정 인코딩으로 파일을 쓰고 특정 인코딩으로 파일을 쓰고자 하는 경우 끝점에서 줄임표 옵션을 사용하는 것이 좋습니다.

끝점에her set 옵션을 명시적으로 구성한 경우에는 Exchange.CHARSET_NAME 속성에 관계없이 해당 구성이 사용됩니다.

몇 가지 문제가 있는 경우 org.apache.camel.component.file 에서 DEBUG 로깅을 활성화할 수 있으며, 특정charset을 사용하여 파일을 읽고 쓸 때 Camel 로그를 사용할 수 있습니다.
예를 들어 아래 경로는 다음을 기록합니다.

from("file:inbox?charset=utf-8")
  .to("file:outbox?charset=iso-8859-1")

및 로그:

DEBUG GenericFileConverter           - Read file /Users/davsclaus/workspace/camel/camel-core/target/charset/input/input.txt with charset utf-8
DEBUG FileOperations                 - Using Reader to write file: target/charset/output.txt with charset: iso-8859-1

21.12. 폴더 및 파일 이름이 있는 Common gotchas

Camel이 파일(파일 작성)을 생성할 때 선택한 파일 이름을 설정하는 방법에 영향을 미치는 몇 가지 gotchas가 있습니다. 기본적으로 Camel은 파일 이름으로 메시지 ID를 사용하며 일반적으로 생성된 고유 ID이므로 ID-MACHINENAME-2443-1211718892437-1-0 과 같은 파일 이름으로 끝납니다. 이러한 파일 이름이 필요하지 않은 경우 CamelFileName 메시지 헤더에 파일 이름을 제공해야 합니다. constant, Exchange.FILE_NAME 도 사용할 수 있습니다.

아래 샘플 코드는 파일 이름으로 메시지 ID를 사용하여 파일을 생성합니다.

from("direct:report").to("file:target/reports");

report.txt 를 사용해야 하는 파일 이름으로 사용하려면 다음을 수행합니다.

from("direct:report").setHeader(Exchange.FILE_NAME, constant("report.txt")).to( "file:target/reports");
  • 위의 것과 동일하지만 CamelFileName:
from("direct:report").setHeader("CamelFileName", constant("report.txt")).to( "file:target/reports");

그리고 fileName URI 옵션을 사용하여 엔드포인트에서 파일 이름을 설정하는 구문입니다.

from("direct:report").to("file:target/reports/?fileName=report.txt");

21.13. 파일 이름 표현식

filename은 expression 옵션을 사용하거나 Camel File Name 헤더에서 문자열 기반 파일 언어 표현식으로 설정할 수 있습니다. 구문 및 샘플은 파일 언어를 참조하십시오.

21.14. 다른 사용자가 파일을 직접 삭제하는 폴더의 파일 사용

다른 애플리케이션이 직접 파일을 작성하는 폴더의 파일을 사용하는 경우 주의하십시오. 다양한 readLock 옵션을 살펴보고 사용 사례에 적합한 항목을 확인하십시오. 그러나 가장 좋은 방법은 다른 폴더에 쓰고 쓰기 후 드롭 폴더의 파일을 이동하는 것입니다. 그러나 drop 폴더에 직접 파일을 작성하는 경우 옵션을 변경하면 파일이 현재 파일 변경된 알고리즘을 사용하여 일정 기간 동안 파일 크기 / 수정 사항이 변경되는지 여부를 확인할 수 있습니다. 다른 readLock 옵션은이를 감지하는 데 항상 좋은 것은 아니지만 Java File API에 의존합니다. 파일이 완료되고 사용될 준비가 되었는지를 나타내는 마커 파일(done 파일)을 사용하는 doneFileName 옵션을 확인할 수도 있습니다.

21.15. 완료된 파일 사용

아래와 같이 완료된 파일을 작성하는 섹션도 참조하십시오.

완료된 파일이 있는 경우에만 파일을 사용하려면 끝점에 doneFileName 옵션을 사용할 수 있습니다.

from("file:bar?doneFileName=done");

는 bar 폴더의 파일만 사용합니다. 완료된 파일이 대상 파일과 동일한 디렉터리에 있는 경우에만 사용됩니다. Camel은 파일을 사용할 때 완료된 파일을 자동으로 삭제합니다. noop=true 가 구성된 경우 Camel은 완료된 파일을 자동으로 삭제하지 않습니다.

그러나 대상 파일당 하나의 수행 파일이 있는 것이 더 일반적입니다. 즉, 1:1 상관 관계가 있습니다. 이렇게 하려면 doneFileName 옵션에서 동적 자리 표시자를 사용해야 합니다. 현재 Camel은 다음 두 가지 동적 토큰을 지원합니다. file:namefile:name.noext 는 $\{ }로 묶어야 합니다. 소비자는 완료된 파일 이름의 정적 부분만 접두사 또는 접미사(둘 다 아님)로 지원합니다.

from("file:bar?doneFileName=${file:name}.done");

이 예제에서는 이름 파일 이름이 .done인 완료된 파일이 있는 경우에만 파일을 폴링합니다. 예를 들면 다음과 같습니다

  • hello.txt - 사용할 파일입니다.
  • hello.txt.done - 연결된 완료된 파일입니다.

다음과 같이 완료된 파일에 접두사를 사용할 수도 있습니다.

from("file:bar?doneFileName=ready-${file:name}");
  • hello.txt - 사용할 파일입니다.
  • ready-hello.txt - 연결된 완료된 파일

21.16. 완료된 파일 작성

파일을 작성한 후에는 한 종류의 마커로 추가 완료파일을 작성하여 파일이 완료되어 작성되었음을 다른 사용자에게 표시할 수 있습니다. 이를 위해 파일 프로듀서 엔드포인트에서 doneFileName 옵션을 사용할 수 있습니다.

.to("file:bar?doneFileName=done");

은 대상 파일과 동일한 디렉터리에서 done 이라는 파일을 생성할 수 있습니다.

그러나 대상 파일당 하나의 수행 파일이 있는 것이 더 일반적입니다. 즉, 1:1 상관 관계가 있습니다. 이렇게 하려면 doneFileName 옵션에서 동적 자리 표시자를 사용해야 합니다. 현재 Camel은 다음 두 가지 동적 토큰을 지원합니다. file:namefile:name.noext 는 $\{ }로 묶어야 합니다.

.to("file:bar?doneFileName=done-${file:name}");

예를 들어 대상 파일이 대상 파일과 동일한 디렉토리에 foo.txt 인 경우 done-foo.txt 라는 파일을 생성합니다.

.to("file:bar?doneFileName=${file:name}.done");

예를 들어 대상 파일이 대상 파일과 동일한 디렉터리에 foo.txt.done 인 경우 파일 foo.txt 를 생성합니다.

.to("file:bar?doneFileName=${file:name.noext}.done");

예를 들어 대상 파일이 대상 파일과 동일한 디렉터리에 foo.done 인 경우 foo. done이라는 파일을 생성합니다.

21.17. 샘플

21.17.1. 디렉토리에서 읽고 다른 디렉토리에 쓰기

from("file://inputdir/?delete=true").to("file://outputdir")

21.17.2. 디렉토리에서 읽고 overrule 동적 이름을 사용하여 다른 디렉토리에 씁니다.

from("file://inputdir/?delete=true").to("file://outputdir?overruleFile=copy-of-${file:name}")

디렉토리에서 수신 대기하고 해당 파일에 대한 메시지를 생성합니다. 내용을 outputdir 에 복사하고 inputdir 에서 파일을 삭제합니다.

21.17.3. 디렉터리에서 재귀적으로 읽기 및 다른 쓰기

from("file://inputdir/?recursive=true&delete=true").to("file://outputdir")

디렉토리에서 수신 대기하고 해당 파일에 대한 메시지를 생성합니다. 내용을 outputdir 에 복사하고 inputdir 에서 파일을 삭제합니다. 은 반복적으로 하위 디렉터리로 스캔합니다. 는 모든 하위 디렉터리 디렉터리를 포함하여 inputdiroutputdir 의 동일한 디렉토리 구조에 있는 파일을 축소합니다.

inputdir/foo.txt
inputdir/sub/bar.txt

그러면 다음과 같은 출력 레이아웃이 생성됩니다.

outputdir/foo.txt
outputdir/sub/bar.txt

21.18. flatten 사용

동일한 디렉터리의 outputdir 디렉터리에 파일을 저장하고 소스 디렉터리 레이아웃을 무시하려면 파일 프로듀서 측에 flatten=true 옵션을 추가하기만 하면 됩니다.

from("file://inputdir/?recursive=true&delete=true").to("file://outputdir?flatten=true")

그러면 다음과 같은 출력 레이아웃이 생성됩니다.

outputdir/foo.txt
outputdir/bar.txt

21.19. 디렉토리에서 읽기 및 기본 이동 작업

Camel은 기본적으로 처리된 모든 파일을 파일에서 사용된 디렉토리의 .camel 하위 디렉터리로 이동합니다.

from("file://inputdir/?recursive=true&delete=true").to("file://outputdir")

이전레이아웃에 영향을 줍니다.

inputdir/foo.txt
inputdir/sub/bar.txt

inputdir/.camel/foo.txt
inputdir/sub/.camel/bar.txt
outputdir/foo.txt
outputdir/sub/bar.txt

21.20. 디렉토리에서 읽고 java에서 메시지를 처리

from("file://inputdir/").process(new Processor() {
  public void process(Exchange exchange) throws Exception {
    Object body = exchange.getIn().getBody();
    // do some business logic with the input body
  }
});

본문은 inputdir 디렉터리에 방금 삭제된 파일을 가리키는 File 개체가 됩니다.

21.21. 파일에 쓰기

Camel은 물론 파일을 작성할 수도 있습니다(예: 파일 생성). 아래 샘플에서는 디렉터리에 쓰기 전에 처리하는 SEDA 큐에 대한 일부 보고서를 받습니다.

21.21.1. Exchange.FILE_NAME을 사용하여 하위 디렉터리에 쓰기

단일 경로를 사용하면 여러 하위 디렉터리에 파일을 쓸 수 있습니다. 다음과 같이 경로가 설정되어 있는 경우 다음을 수행하십시오.

<route>
  <from uri="bean:myBean"/>
  <to uri="file:/rootDirectory"/>
</route>

myBean 헤더를 Exchange.FILE_NAME 을 다음과 같은 값으로 설정할 수 있습니다.

Exchange.FILE_NAME = hello.txt => /rootDirectory/hello.txt
Exchange.FILE_NAME = foo/bye.txt => /rootDirectory/foo/bye.txt

이를 통해 단일 경로를 통해 여러 대상에 파일을 쓸 수 있습니다.

21.21.2. 최종 대상을 기준으로 임시 디렉터리를 통해 파일 작성

경우에 따라 대상 디렉터리와 관련된 일부 디렉터리에 임시로 파일을 써야 합니다. 이러한 상황은 일반적으로 필터링 기능이 제한된 일부 외부 프로세스가 쓰기 중인 디렉터리에서 읽고 있는 경우 발생합니다. 아래 예에서 파일은 /var/myapp/filesInProgress 디렉토리에 기록되고 데이터 전송이 완료된 후 원자적으로 /var/myapp/finalDirectory 'directory로 이동합니다.

from("direct:start").
  to("file:///var/myapp/finalDirectory?tempPrefix=/../filesInProgress/");

21.22. 파일 이름에 표현식 사용

이 샘플에서는 현재 날짜를 하위 폴더 이름으로 사용하여 소비된 파일을 백업 폴더로 이동하려고 합니다.

from("file://inbox?move=backup/${date:now:yyyyMMdd}/${file:name}").to("...");

자세한 내용은 파일 언어를 참조하십시오.

21.23. 동일한 파일을 두 번 이상 읽는 것을 방지 (idempotent consumer)

Camel은 구성 요소 내에서 직접 Idempotent Consumer를 지원하므로 이미 처리된 파일을 건너뜁니다. 이 기능은 idempotent=true 옵션을 설정하여 활성화할 수 있습니다.

from("file://inbox?idempotent=true").to("...");

Camel은 절대 파일 이름을 idempotent 키로 사용하여 중복 파일을 탐지합니다. idempotentKey 옵션에서 표현식을 사용하여 이 키를 사용자 지정할 수 있습니다. 예를 들어 이름과 파일 크기를 키로 사용합니다.

<route>
  <from uri="file://inbox?idempotent=true&amp;idempotentKey=${file:name}-${file:size}"/>
  <to uri="bean:processInbox"/>
</route>

기본적으로 Camel은 사용된 파일을 추적하기 위해 메모리 기반 저장소의 를 사용하며, 최근 사용된 캐시는 최대 1000개의 항목을 유지합니다. 값에 # sign in the value를 사용하여 idempotentRepository 옵션을 사용하여 이 저장소의 자체 구현을 플러그인할 수 있습니다. 이 값이 지정된 ID가 있는 레지스트리의 빈을 참조함을 나타낼 수 있습니다.

 <!-- define our store as a plain spring bean -->
 <bean id="myStore" class="com.mycompany.MyIdempotentStore"/>

<route>
  <from uri="file://inbox?idempotent=true&amp;idempotentRepository=#myStore"/>
  <to uri="bean:processInbox"/>
</route>

Camel은 이전에 소비되어 있기 때문에 파일을 건너뛰면 DEBUG 수준에서 로그됩니다.

DEBUG FileConsumer is idempotent and the file has been consumed before. Will skip this file: target\idempotent\report.txt

21.24. 파일 기반 idempotent 리포지토리 사용

이 섹션에서는 기본적으로 사용되는 메모리 내 기반 대신 파일 기반 idempotent 리포지토리 org.apache.camel.processor.idempotent.FileIdempotentRepository 를 사용합니다.
이 리포지토리는 1차 수준 캐시를 사용하여 파일 리포지토리를 읽지 않습니다. 1 수준 캐시의 콘텐츠만 파일 리포지토리를 사용합니다. 따라서 리포지토리는 서버를 다시 시작한 후에도 유지될 수 있습니다. 시작 시 파일의 콘텐츠를 첫 번째 수준 캐시에 로드합니다. 파일 구조는 파일의 별도의 행에 키를 저장하므로 매우 간단합니다. 기본적으로 파일 저장소의 크기 제한은 1mb입니다. 파일이 크게 증가하면 Camel이 파일 저장소가 줄어들면 1단계 캐시를 새로 빈 파일로 플러시하여 콘텐츠를 다시 빌드합니다.

파일 idempotent 리포지토리를 생성하는 Spring XML을 사용하여 리포지토리를 구성하고 # sign를 사용하여 레지스트리 조회를 나타내는 idempotentRepository 와 함께 리포지토리를 사용하도록 파일 소비자를 정의합니다.

21.25. JPA 기반 idempotent 리포지토리 사용

이 섹션에서는 기본적으로 사용되는 메모리 내 기반 대신 JPA 기반 idempotent 리포지토리를 사용합니다.

먼저 org.apache.camel.processor.idempotent.jpa.MessageProcessed 를 모델로 사용해야 하는 META-INF/persistence.xml 에 persistence-unit이 필요합니다.

<persistence-unit name="idempotentDb" transaction-type="RESOURCE_LOCAL">
  <class>org.apache.camel.processor.idempotent.jpa.MessageProcessed</class>

  <properties>
    <property name="openjpa.ConnectionURL" value="jdbc:derby:target/idempotentTest;create=true"/>
    <property name="openjpa.ConnectionDriverName" value="org.apache.derby.jdbc.EmbeddedDriver"/>
    <property name="openjpa.jdbc.SynchronizeMappings" value="buildSchema"/>
    <property name="openjpa.Log" value="DefaultLevel=WARN, Tool=INFO"/>
    <property name="openjpa.Multithreaded" value="true"/>
  </properties>
</persistence-unit>

다음으로, Spring XML 파일에 JPA idempotent 리포지토리를 생성할 수도 있습니다.

<!-- we define our jpa based idempotent repository we want to use in the file consumer -->
<bean id="jpaStore" class="org.apache.camel.processor.idempotent.jpa.JpaMessageIdRepository">
    <!-- Here we refer to the entityManagerFactory -->
    <constructor-arg index="0" ref="entityManagerFactory"/>
    <!-- This 2nd parameter is the name  (= a category name).
         You can have different repositories with different names -->
    <constructor-arg index="1" value="FileConsumer"/>
</bean>

그리고 yes는 # 구문 옵션을 사용하여 idempotentRepository 를 사용하여 파일 소비자 끝점에서 jpaStore Velero를 참조하기만 하면 됩니다.

<route>
  <from uri="file://inbox?idempotent=true&amp;idempotentRepository=#jpaStore"/>
  <to uri="bean:processInbox"/>
</route>

21.26. org.apache.camel.component.file.GenericFileFilter를 사용하여 필터링합니다.

Camel은 플러그형 필터링 전략을 지원합니다. 그런 다음 처리 중인 특정 파일을 건너뛰도록 이러한 필터를 사용하여 끝점을 구성할 수 있습니다.

샘플에서 파일 이름에서 건너뛰기 시작하는 파일을 건너뛰는 자체 필터를 빌드했습니다.

그런 다음 filter 속성을 사용하여 Spring XML 파일에서 정의한 필터(# 표기법 사용)를 참조하도록 경로를 구성할 수 있습니다.

<!-- define our filter as a plain spring bean -->
<bean id="myFilter" class="com.mycompany.MyFileFilter"/>

<route>
  <from uri="file://inbox?filter=#myFilter"/>
  <to uri="bean:processInbox"/>
</route>

21.27. ANT 경로 일치자를 사용하여 필터링

ANT 경로 matcher는ECDHE PathMatcher 를 기반으로 합니다.

파일 경로는 다음 규칙과 일치합니다.

  • 하나의 문자를 찾습니다.Match one character.
  • 0개 이상의 문자를 찾습니다.Match zero or more characters.
  • ** 경로의 0개 이상의 디렉터리 일치

antIncludeantExclude 옵션을 사용하면 필터를 정의하지 않고도 ANT 스타일 include/exclude를 쉽게 지정할 수 있습니다. 자세한 내용은 위의 URI 옵션을 참조하십시오.

아래 샘플은 이를 사용하는 방법을 보여줍니다.

21.27.1. Comparator를 사용한 정렬

Camel은 플러그형 정렬 전략을 지원합니다. 이 전략은 Java에서 java.util.Comparator 에서 빌드를 사용하는 것입니다. 그런 다음 이러한 비교자를 사용하여 엔드포인트를 구성하고 Camel이 파일을 정렬하도록 할 수 있습니다.

샘플에서 파일 이름별로 정렬하는 자체 비교기를 구축했습니다.

그리고 sorter 옵션을 사용하여 경로를 구성하여 Spring XML 파일에 정의한 sorter(mySorter)를 참조할 수 있습니다.

 <!-- define our sorter as a plain spring bean -->
 <bean id="mySorter" class="com.mycompany.MyFileSorter"/>

<route>
  <from uri="file://inbox?sorter=#mySorter"/>
  <to uri="bean:processInbox"/>
</route>
참고

URI 옵션은 # 구문을 사용하여 빈을 참조할 수있습니다.
Spring DSL 경로에서는 id 앞에 #을 추가하여 레지스트리의 빈을 참조할 수 있습니다. 따라서 sorter=#mySorter 를 작성하면 Camel에 ID가 mySorter 가 있는 빈의 Registry에서 확인하도록 지시합니다.

21.27.2. sortBy를 사용하여 정렬

Camel은 플러그형 정렬 전략을 지원합니다. 이렇게 하면 파일 언어를 사용하여 정렬을 구성합니다. sortBy 옵션은 다음과 같이 구성됩니다.

sortBy=group 1;group 2;group 3;...

여기서 각 그룹은 대시 콜론으로 구분됩니다. 간단한 상황에서는 한 그룹을 사용하므로 간단한 예제가 될 수 있습니다.

sortBy=file:name

이렇게 하면 파일 이름으로 정렬됩니다. reverse: 를 그룹으로 붙여서 순서를 취소할 수 있으므로 정렬은 이제 Z..A입니다.

sortBy=reverse:file:name

파일 언어의 전체 기능이 있으므로 다른 매개 변수 중 일부를 사용할 수 있으므로 파일 크기에 따라 정렬하려면 다음을 수행합니다.

sortBy=file:length

이 경우 ignoreCase: for string comparison를 사용하여 대소문자를 무시하도록 구성할 수 있습니다. 따라서 파일 이름 정렬을 사용하지만 케이스를 무시하려면 다음을 수행합니다.

sortBy=ignoreCase:file:name

무시 사례와 역방향을 결합할 수 있지만 역방향을 먼저 지정해야 합니다.

sortBy=reverse:ignoreCase:file:name

아래 샘플에서 마지막으로 수정된 파일로 정렬하려고 하므로 다음을 수행합니다.

sortBy=file:modified

그런 다음 이름으로 그룹화하려고 하므로 수정 사항이 동일한 파일이 이름순으로 정렬됩니다.

sortBy=file:modified;file:name

이제 문제가 있습니다, 해결할 수 있습니까? 파일의 수정된 타임 스탬프는 밀리초 단위이기 때문에 너무 좋지만 날짜만 기준으로 정렬하고 하위 그룹을 이름으로 정렬하려면 어떻게 해야 합니까?
파일 언어의 진정한 장점이 있기 때문에 패턴을 지원하는 날짜 명령을 사용할 수 있습니다. 따라서 이 문제는 다음과 같이 해결될 수 있습니다.

sortBy=date:file:yyyyMMdd;file:name

네, 이는 매우 강력하며, 그룹당 리버스를 사용할 수 있는 방법에 따라 oh는 파일 이름을 반전할 수 있습니다.

sortBy=date:file:yyyyMMdd;reverse:file:name

21.28. GenericFileProcessStrategy 사용

옵션 processStrategy 를 사용하여 자체 시작,커밋롤백 논리를 구현할 수 있는 사용자 정의 GenericFileProcessStrategy 를 사용할 수 있습니다.
예를 들어 시스템이 사용해야 하는 폴더에 파일을 쓰는 것을 가정할 수 있습니다. 그러나 다른 준비 파일을 작성하기 전에 파일 사용을 시작하지 않아야 합니다.

따라서 자체 GenericFileProcessStrategy 를 구현하여 이를 다음과 같이 구현할 수 있습니다.

  • start() 메서드에서 특수 준비 파일이 존재하는지 테스트할 수 있습니다. start 메서드는 부울 을 반환하여 파일을 사용할 수 있는지 여부를 나타냅니다.
  • abort() 메서드 특수 논리에서 start 작업에서 false 를 반환한 경우(예: 리소스 정리 등)를 실행할 수 있습니다.
  • commit() 메서드에서 실제 파일을 이동하고 준비된 파일도 삭제할 수 있습니다.

21.29. 필터 사용

filter 옵션을 사용하면 org.apache.camel.component.file.GenericFileFilter 인터페이스를 구현하여 Java 코드에서 사용자 정의 필터를 구현할 수 있습니다. 이 인터페이스에는 부울을 반환하는 accept 메서드가 있습니다. 파일을 포함하도록 true 를 반환하고, 파일을 건너뛰려면 false 를 반환합니다. GenericFile 에 파일이 디렉터리인지 여부에 대한 isDirectory 메서드가 있습니다. 이를 통해 원하지 않는 디렉터리를 필터링하여 원하지 않는 디렉터리를 트래버스하지 않도록 할 수 있습니다.

예를 들어 이름에 "skip" 로 시작하는 디렉터리를 건너뛰려면 다음과 같이 구현할 수 있습니다.

21.30. bridgeErrorHandler 사용

Camel Error Handler를 사용하여 파일 소비자에서 발생하는 모든 예외를 처리하려면 다음과 같이 bridgeErrorHandler 옵션을 활성화할 수 있습니다.

// to handle any IOException being thrown
onException(IOException.class)
    .handled(true)
    .log("IOException occurred due: ${exception.message}")
    .transform().simple("Error ${exception.message}")
    .to("mock:error");

// this is the file route that pickup files, notice how we bridge the consumer to use the Camel routing error handler
// the exclusiveReadLockStrategy is only configured because this is from an unit test, so we use that to simulate exceptions
from("file:target/nospace?bridgeErrorHandler=true")
    .convertBodyTo(String.class)
    .to("mock:result");

따라서 이 옵션을 활성화하려면 경로의 오류 처리기에서 해당 옵션을 사용해야 합니다.

중요

bridgeErrorHandler
를 사용하는 경우 bridgeErrorHandler를 사용할 때 interceptors onCompletions가 적용되지 않습니다. 교환은 Camel 오류 처리기에 의해 직접 처리되며 인터셉터와 같은 이전 작업(OnCompletion)을 허용하지 않습니다.

21.31. 디버그 로깅

이 구성 요소에는 문제가 있는 경우 유용할 수 있는 로그 수준 TRACE 가 있습니다.

21.32. Spring Boot Auto-Configuration

Spring Boot로 파일을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-file-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.cluster.file.acquire-lock-delay

잠금을 받기 시작하기 전에 대기하는 시간입니다.

 

문자열

camel.cluster.file.acquire-lock-interval

잠금을 시도하려는 시도 사이에 대기하는 시간입니다.

 

문자열

camel.cluster.file.attributes

사용자 지정 서비스 속성.

 

map

camel.cluster.file.enabled

파일 클러스터 서비스를 활성화해야 하는지 여부를 설정하며, 기본값은 false입니다.

false

부울

camel.cluster.file.id

클러스터 서비스 ID.

 

문자열

camel.cluster.file.order

서비스 조회 순서/우선 우선 순위.

 

정수

camel.cluster.file.root

루트 경로입니다.

 

문자열

camel.component.file.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.file.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.file.enabled

파일 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.file.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

22장. FTP

생산자 및 소비자 모두 지원

이 구성 요소는 FTP 및 SFTP 프로토콜을 통해 원격 파일 시스템에 대한 액세스를 제공합니다.

원격 FTP 서버에서 사용할 때 파일 사용과 관련된 세부 사항은 아래 파일을 추가로 사용할 때 Default 라는 섹션을 읽어 보십시오.

절대 경로는 지원되지 않습니다. Camel은 디렉토리 이름에서 모든 선행 슬래시를 트리밍하여 절대 경로를 기준으로 변환합니다. 로그에 WARN 메시지가 출력됩니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-ftp</artifactId>
    <version>{CamelSBVersion}</version>See the documentation of the Apache Commons
    <!-- use the same version as your Camel core version -->
</dependency>

22.1. URI 형식

ftp://[username@]hostname[:port]/directoryname[?options]
sftp://[username@]hostname[:port]/directoryname[?options]
ftps://[username@]hostname[:port]/directoryname[?options]

여기서 directoryname 은 기본 디렉터리를 나타냅니다. 디렉터리 이름은 상대 경로입니다. 절대 경로는 지원되지 않습니다. 상대 경로는 /inbox/us와 같은 중첩 폴더를 포함할 수 있습니다.

autoCreate 옵션이 지원됩니다. 소비자가 시작되면 폴링을 예약하기 전에 끝점에 대해 구성된 디렉터리를 생성하는 추가 FTP 작업이 수행됩니다. autoCreate 의 기본값은 true 입니다.

사용자 이름을 제공하지 않으면 암호 없이 익명 로그인을 시도합니다.
포트 번호를 제공하지 않으면 Camel은 프로토콜(ftp = 21, sftp = 22, ftps = 2222)에 따라 기본값을 제공합니다.

다음 형식으로 URI에 쿼리 옵션을 추가할 수 있습니다. ?option=value&option=value&…​

이 구성 요소는 실제 FTP 작업에 두 개의 다른 라이브러리를 사용합니다. FTP 및 FTPS는 SFTP가 JCature JSCH 를 사용하는 동안 Apache Commons Net 을 사용합니다.

FTPS( FTP Secure라고도 함)는 TLS(Transport Layer Security) 및 SSL(Secure Sockets Layer) 암호화 프로토콜 지원을 추가하는 FTP의 확장입니다.

22.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

22.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

22.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

22.3. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

22.4. 끝점 옵션

FTP 끝점은 URI 구문을 사용하여 구성됩니다.

ftp:host:port/directoryName

다음과 같은 경로 및 쿼리 매개변수 사용:

22.4.1. 경로 매개변수 (3 매개변수)

이름설명Default유형

호스트 (공용)

FTP 서버의 필수 호스트 이름입니다.

 

문자열

포트 (공용)

FTP 서버의 포트입니다.

 

int

directoryname (common)

시작 디렉터리입니다.

 

문자열

22.4.2. 쿼리 매개변수 (111 매개변수)

이름설명Default유형

바이너리 (공용)

파일 전송 모드, BINARY 또는 ASCII를 지정합니다. 기본값은 ASCII(false)입니다.

false

boolean

triggerset (common)

이 옵션은 파일의 인코딩을 지정하는 데 사용됩니다. 소비자에서 이를 사용하여 파일 콘텐츠에 액세스하는 경우 Camel이 파일 콘텐츠를 로드해야 하는sterset을 확인할 수 있는 파일의 인코딩을 지정할 수 있습니다. 마찬가지로 이 파일을 작성할 때 이 옵션을 사용하여 파일을 쓰기 위해 어떤 wholeset를 지정할 수 있습니다. Camel 파일을 작성할 때 메시지 내용을 메모리로 읽어서 데이터를 구성된 stateset로 변환해야 할 수도 있으므로 큰 메시지가 있는 경우에는 사용하지 마십시오.

 

문자열

연결 해제 (공용)

사용 후 바로 원격 FTP 서버에서 연결을 끊을지 여부입니다. FTP 서버에 대한 현재 연결만 연결을 끊습니다. 중지하려는 소비자가 있는 경우 대신 소비자/라우트를 중지해야 합니다.

false

boolean

doneFileName (common)

생산자: 제공되는 경우 Camel은 원본 파일이 작성될 때 두 번째 완료된 파일을 작성합니다. 완료된 파일은 비어 있습니다. 이 옵션은 사용할 파일 이름을 설정합니다. 둘 중 고정 이름을 지정할 수 있습니다. 또는 동적 자리 표시자를 사용할 수 있습니다. 완료된 파일은 항상 원래 파일과 동일한 폴더에 작성됩니다. 소비자: 제공된 경우 Camel은 완료된 파일이 있는 경우에만 파일을 사용합니다. 이 옵션은 사용할 파일 이름을 설정합니다. 둘 중 고정 이름을 지정할 수 있습니다. 또는 동적 자리 표시자를 사용할 수 있습니다. done 파일은 항상 원래 파일과 동일한 폴더에 표시됩니다. $\\{file.name} 및 $\\{file.name.next}만 동적 자리 표시자로 지원됩니다.

 

문자열

파일 이름 (common)

파일 언어와 같은 표현식을 사용하여 동적으로 파일 이름을 설정합니다. 소비자의 경우 파일 이름 필터로 사용됩니다. 생산자의 경우 작성할 파일 이름을 평가하는 데 사용됩니다. 표현식이 설정된 경우 CamelFileName 헤더보다 우선합니다. (참고: 헤더 자체는 표현식일 수도 있습니다.) 표현식 옵션은 문자열 및 표현식 유형을 모두 지원합니다. 표현식이 String 유형인 경우 File Language를 사용하여 항상 평가됩니다. 표현식이 Expression 유형인 경우 지정된 Expression 유형이 사용됩니다. 예를 들어 OGNL 식을 사용할 수 있습니다. 소비자는 이를 사용하여 파일 이름을 필터링할 수 있으므로 파일 언어 구문: mydata-$\{date:now:yyyMMdd}.txt를 사용하여 오늘 파일을 사용할 수 있습니다. 생산자는 기존 CamelFileName 헤더보다 우선하는 CamelOverruleFileName 헤더를 지원합니다. CamelOverruleFileName은 한 번만 사용되는 헤더이므로 CamelFileName의 임시 저장소에서 쉽게 복원할 수 있습니다.

 

문자열

passiveMode (common)

패시브 모드 연결을 설정합니다. 기본값은 활성 모드 연결입니다.

false

boolean

구분 기(common)

사용할 경로 구분자를 설정합니다. unix = uses unix style path separator Windows = Windows style path separator Auto = (if default) 파일 이름에서 기존 경로 구분자를 사용합니다.

CloudEvent 값:

  • UNIX
  • Windows
  • auto

UNIX

PathSeparator

transferLoggingIntervalSeconds (common)

진행 중인 업로드 작업 진행 상황을 로깅할 때 사용할 간격(초)을 구성합니다. 이는 작업에 시간이 더 오래 걸리는 경우 로깅 진행에 사용됩니다.

5

int

transferLoggingLevel (common)

업로드 및 다운로드 작업의 진행 상황을 로깅할 때 사용할 로깅 수준을 구성합니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

DEBUG

LoggingLevel

transferLoggingVerbose (common)

업로드 및 다운로드 작업의 진행 상황을 상세히 로깅할 수 있는 기능(단계별)을 설정합니다.

false

boolean

fastExistsCheck (common (advanced))

이 옵션을 true로 설정하면 camel-ftp가 목록 파일을 직접 사용하여 파일이 존재하는지 확인합니다. 일부 FTP 서버는 파일을 직접 나열하지 못할 수 있으므로 옵션이 false인 경우 camel-ftp는 기존 방법을 사용하여 디렉토리를 나열하고 파일이 존재하는지 확인합니다. 이 옵션은 또한 readLock=changed에 영향을 미치므로 파일 정보를 업데이트하는 빠른 검사를 수행할지 여부를 제어합니다. FTP 서버에 파일이 많은 경우 프로세스 속도를 높이는 데 사용할 수 있습니다.

false

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

삭제 (consumer)

true인 경우 파일이 처리된 후 삭제됩니다.

false

boolean

moveFailed (consumer)

간단한 언어를 기반으로 이동 실패 표현식을 설정합니다. 예를 들어 파일을 .error 하위 디렉터리로 이동하려면 .error를 사용합니다. 참고: 파일을 실패 위치로 이동하면 Camel에서 오류를 처리하고 파일을 다시 가져오지 않습니다.

 

문자열

noop (consumer)

true인 경우 파일은 어떤 방식으로든 이동되거나 삭제되지 않습니다. 이 옵션은 읽기 전용 데이터 또는 ETL 유형 요구 사항에 적합합니다. noop=true인 경우 Camel은 동일한 파일을 반복해서 사용하지 않도록 idempotent=true도 설정합니다.

false

boolean

pre home (consumer)

표현식(예: File Language)은 처리하기 전에 파일 이름을 동적으로 설정하는 데 사용됩니다. 예를 들어 in-progress 파일을 순서순으로 이동하려면 이 값을 순서대로 설정합니다.

 

문자열

preSort (consumer)

사전 정렬을 활성화하면 소비자는 폴링 중에 파일 및 디렉터리 이름을 정렬하며 파일 시스템에서 검색됩니다. 정렬된 순서로 파일에 대해 작업을 수행해야 하는 경우 이 작업을 수행할 수 있습니다. 사전 정렬은 소비자가 필터링을 시작하기 전에 실행되고 Camel을 통해 처리할 파일을 수락합니다. 이 옵션은 default=false이며 비활성화되어 있습니다.

false

boolean

재귀 (consumer)

디렉토리가 있는 경우 는 모든 하위 디렉터리에서도 파일을 찾습니다.

false

boolean

resumeDownload (consumer)

Resume Download가 활성화되어 있는지 여부를 설정합니다. FTP 서버에서 이를 지원해야 합니다(대부분의 모든 FTP 서버가 지원됨). 또한 localWorkDirectory 옵션은 다운로드된 파일이 로컬 디렉터리에 저장되도록 구성해야 하며, 다운로드 다시 시작을 지원하는 데 필요한 옵션 바이너리를 활성화해야 합니다.

false

boolean

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

streamDownload (consumer)

로컬 작업 디렉터리를 사용하지 않는 경우 사용할 다운로드 방법을 설정합니다. true로 설정하면 원격 파일이 읽을 때 경로로 스트리밍됩니다. false로 설정하면 경로로 전송되기 전에 원격 파일이 메모리에 로드됩니다. 이 옵션을 활성화하면 둘 다 동시에 활성화할 수 없으므로 stepECDHE=false를 설정해야 합니다.

false

boolean

다운로드 (advanced) 다운로드 (consumer)

FTP 사용자가 파일을 다운로드해야하는지 여부. 이 옵션을 false로 설정하면 메시지 본문이 null이지만 소비자는 파일 이름, 파일 크기 등과 같은 파일에 대한 세부 정보가 있는 Camel Exchange를 계속 트리거합니다. 단지 파일이 다운로드되지 않을 것입니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

handleDirectoryParserAbsoluteResult (consumer (advanced)

디렉토리 구문 분석기가 절대 경로가 있는 경우 소비자가 하위 폴더 및 파일을 처리하는 방법을 설정할 수 있습니다. 이로 인해 일부 FTP 서버는 절대 경로가 있는 파일 이름을 반환할 수 있으며, 이렇게 하면 반환된 경로를 상대 경로로 변환하여 FTP 구성 요소가 이를 처리해야 합니다.

false

boolean

ignoreFileNotFoundOrPermissionError (consumer (advanced))

존재하지 않거나 권한 오류로 인해 디렉터리의 파일을 나열하려는 경우 또는 파일을 다운로드할 때 무시할지 여부입니다. 기본적으로 디렉터리 또는 파일이 없거나 사용 권한이 충분하지 않으면 예외가 발생합니다. 이 옵션을 true로 설정하면 대신 무시해도 됩니다.

false

boolean

inProgressRepository (consumer (advanced)

플러그인 가능한 in-progress 리포지토리 org.apache.camel.spi.IdempotentRepository. in-progress 리포지토리는 사용 중인 진행 중인 파일의 현재를 설명하는 데 사용됩니다. 기본적으로 메모리 기반 리포지토리가 사용됩니다.

 

IdempotentRepository

localWorkDirectory (consumer (advanced))

사용하는 경우 로컬 작업 디렉터리를 사용하여 원격 파일 내용을 로컬 파일에 직접 저장하여 콘텐츠를 메모리에 로드하지 않도록 할 수 있습니다. 이는 매우 큰 원격 파일을 사용하고 따라서 메모리를 절약할 수 있는 경우 유용합니다.

 

문자열

onCompletionExceptionHandler (consumer (advanced))

사용자 지정 org.apache.camel.spi.ExceptionHandler를 사용하여 소비자가 커밋 또는 롤백을 수행하는 완료 프로세스에서 파일 중에 발생하는 모든 throw된 예외를 처리합니다. 기본 구현은 WARN 수준에서 모든 예외를 기록하고 무시합니다.

 

ExceptionHandler

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

processStrategy (consumer (advanced))

플러그형 org.apache.camel.component.file.GenericFileProcessStrategy를 사용하여 자체 readLock 옵션 또는 유사한 기능을 구현할 수 있습니다. 특수한 준비 파일과 같이 파일을 소비하기 전에 특수 조건을 충족해야 하는 경우에도 사용할 수 있습니다. 이 옵션을 설정하면 readLock 옵션이 적용되지 않습니다.

 

GenericFileProcessStrategy

UseList (consumer(advanced))

파일을 다운로드할 때 LIST 명령 사용을 허용할지 여부입니다. 기본값은 true입니다. 경우에 따라 특정 파일을 다운로드하고 LIST 명령을 사용할 수 없으므로 이 옵션을 false로 설정할 수 있습니다. 이 옵션을 사용할 때 다운로드할 특정 파일에는 파일 크기, 타임스탬프, 권한 등과 같은 메타 데이터 정보가 포함되어 있지 않습니다. 이러한 정보는 LIST 명령을 사용할 때만 검색할 수 있기 때문입니다.

true

boolean

fileExist (producer)

동일한 이름의 파일이 이미 있는 경우 어떻게 해야 합니까. 기본으로 override는 기존 파일을 대체합니다. - Append - 기존 파일에 콘텐츠를 추가합니다. - Fail - 기존 파일이 이미 있음을 나타내는 GenericFileOperationException이 발생합니다. - Ignore -는 자동으로 문제를 무시하고 기존 파일을 덮어쓰지 않지만 모든 것이 고칩니다. - Move - option은 moveExisting 옵션을 사용해야 합니다. 옵션 eagerDeleteTargetFile을 사용하여 파일을 이동하는 경우 수행할 작업을 제어할 수 있으며, 기존 파일이 이미 있으므로 이동 작업이 실패할 수 있습니다. 이동 옵션은 대상 파일을 작성하기 전에 기존 파일을 모두 이동합니다. - TryRename은 tempFileName 옵션을 사용하는 경우에만 적용됩니다. 이렇게 하면 exists 검사를 수행하지 않고 임시 이름에서 실제 이름으로 파일 이름을 변경할 수 있습니다. 일부 파일 시스템 및 특히 FTP 서버에서는 이 검사가 더 빨라질 수 있습니다.

CloudEvent 값:

  • 덮어쓰기
  • append
  • 실패
  • Ignore
  • 이동
  • TryRename

덮어쓰기

GenericFileExist

flatten (producer)

flatten은 선행 경로를 제거하기 위해 파일 이름 경로를 평면화하는 데 사용되므로 파일 이름일 뿐입니다. 이를 통해 재귀적으로 하위 디렉터리를 사용할 수 있지만, 다른 디렉토리에 파일을 쓰는 경우 단일 디렉토리에 기록됩니다. 생산자에서 이 값을 true로 설정하면 CamelFileName 헤더의 모든 파일 이름이 선행 경로로 제거됩니다.

false

boolean

jackStartingDirectory (producer)

시작 디렉터리(및 하위)에 파일 쓰기(제한)에만 사용됩니다. 이 기능은 기본적으로 Camel이 외부 디렉토리에 파일을 쓸 수 없도록 합니다(추가 보안 강화). 상위 폴더 또는 루트 폴더와 같은 시작 디렉토리 외부의 디렉터리에 파일 쓰기를 허용하도록 이 전원을 켤 수 있습니다.

true

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

GoExisting (producer)

fileExist=anchor가 구성될 때 사용할 파일 이름을 계산하는 데 사용되는 파일 언어(예: File Language)입니다. 파일을 백업 하위 디렉터리로 이동하려면 backup을 입력합니다. 이 옵션은 다음 File Language 토큰만 지원합니다. file:name, file:name.ext, file:name.noext, file:onlyname, file:onlyname.noext, file:ext, file:parent. FTP 구성 요소는 현재 디렉터리를 기반으로 하는 상대 디렉터리로만 이동할 수 있으므로 file:parent는 FTP 구성 요소에서 지원되지 않습니다.

 

문자열

tempFileName (producer)

tempPrefix 옵션과 동일하지만 임시 파일 이름 지정에 대해 파일 언어를 사용할 때 더 세밀한 제어를 제공합니다. tempFilename의 위치는 기본 uri의 대상 디렉터리가 아닌 'fileName' 옵션의 최종 파일 위치를 기준으로 합니다. 예를 들어 옵션 fileName에 디렉터리 접두사인 dir/finalFilename이 포함된 경우 tempFileName은 해당 하위 디렉터리 디렉터리와 관련이 있습니다.

 

문자열

tempPrefix (producer)

이 옵션은 임시 이름을 사용하여 파일을 작성한 다음 쓰기가 완료된 후 실제 이름으로 이름을 변경하는 데 사용됩니다. 작성 중인 파일을 식별하고 진행 중인 파일에서도 소비자(재정의 읽기 잠금을 사용하지 않음)를 방지할 수 있습니다. 는 종종 큰 파일을 업로드할 때 FTP에서 사용됩니다.

 

문자열

allowNullBody (producer (advanced))

파일 쓰기 중에 null 본문이 허용되는지 지정하는 데 사용됩니다. true로 설정하면 빈 파일이 생성되고 false로 설정된 경우 null 본문을 파일 구성 요소로 보내려고 하면 'Cannot write null body to file' will be thrown. fileExist 옵션이 'Override'로 설정되면 파일이 잘리며 파일을 첨부하도록 설정하면 변경되지 않은 상태로 유지됩니다.

false

boolean

all (producer)

저장된 파일에 skopeo를 설정할 수 있습니다. 예: ScanSetting=640.

 

문자열

disconnectOnBatchComplete (producer (advanced))

배치 업로드가 완료된 직후 원격 FTP 서버에서의 연결을 해제할지 여부입니다. disconnectOnBatchComplete는 FTP 서버에 대한 현재 연결만 연결을 끊습니다.

false

boolean

eagerDeleteTargetFile (producer (advanced))

기존 대상 파일을 신속하게 삭제할지 여부입니다. 이 옵션은 fileExists=Override 및 tempFileName 옵션도 사용하는 경우에만 적용됩니다. 이를 사용하여 임시 파일을 작성하기 전에 대상 파일을 비활성화(false로 설정)할 수 있습니다. 예를 들어, 임시 파일을 작성하는 동안 큰 파일을 작성하고 대상 파일이 존재하도록 할 수 있습니다. 이렇게 하면 임시 파일의 이름이 대상 파일 이름으로 변경되기 직전의 마지막 시간까지 대상 파일이 삭제됩니다. 이 옵션은 fileExist=anchor가 활성화되고 기존 파일이 존재하는 경우 기존 파일을 삭제할지 여부를 제어하는 데도 사용됩니다. 이 옵션 copyAndDeleteOnRenameFails false, 기존 파일이 존재하는 경우, true인 경우 이동 작업 전에 기존 파일이 삭제되면 예외가 발생합니다.

true

boolean

keepLastModified (producer (advanced))

은 소스 파일에서 마지막으로 수정된 타임스탬프를 유지합니다(있는 경우). 는 타임 스탬프에 Exchange.FILE_LAST_MODIFIED 헤더를 사용합니다. 이 헤더에는 java.util.Date 또는 타임스탬프와 함께 긴 시간이 포함될 수 있습니다. 타임스탬프가 존재하고 옵션이 활성화되어 있으면 기록된 파일에 이 타임스탬프가 설정됩니다. 참고: 이 옵션은 파일 프로듀서에만 적용됩니다. 이 옵션은 FTP 생산자와 함께 사용할 수 없습니다.

false

boolean

moveExistingFileStrategy (producer (advanced))

fileExist=3-4가 구성될 때 사용할 특수 이름 지정 토큰으로 파일을 이동하는 데 사용되는 전략(Custom Strategy)입니다. 기본적으로 사용자 정의 전략이 제공되지 않는 경우 사용되는 구현이 있습니다.

 

FileMoveExistingStrategy

sendNoop (producer (advanced))

FTP 서버에 파일을 업로드하기 전에 noop 명령을 사전 쓰기 검사로 보낼지 여부입니다. 연결의 유효성 검사가 여전히 유효하므로 기본적으로 이 기능이 활성화되어 파일을 업로드할 수 있도록 자동으로 다시 연결할 수 있습니다. 그러나 이로 인해 문제가 발생하면 이 옵션을 해제할 수 있습니다.

true

boolean

activePortRange (advanced)

활성 모드에서 클라이언트 측 포트 범위를 설정합니다. 구문은 minPort-maxPort both 포트 번호가 포함되어 있습니다. 즉, 1xxxx 포트를 모두 포함하는 10000-19999의 포트 번호가 포함됩니다.

 

문자열

autoCreate (advanced)

파일의 경로 이름에 누락된 디렉터리를 자동으로 생성합니다. 파일 소비자의 경우 이는 시작 디렉터리 만들기를 의미합니다. 파일 생산자의 경우 파일을 작성해야 하는 디렉터리를 나타냅니다.

true

boolean

bufferSize (advanced)

파일을 쓰는 데 사용되는 버퍼 크기(또는 파일을 다운로드하고 업로드하는 FTP의 경우)

131072

int

ConnectTimeout (advanced)

FTPClient 및 JSCH 둘 다에서 사용되는 연결을 기다리는 데 필요한 연결 시간 초과를 설정합니다.

10000

int

FTPClient (advanced)

FTPClient의 사용자 지정 인스턴스를 사용하려면 다음을 수행합니다.

 

FTPClient

ftpClientConfig (advanced)

FTPClientConfig의 사용자 지정 인스턴스를 사용하여 끝점에서 사용해야 하는 FTP 클라이언트를 구성하려면 다음을 수행합니다.

 

FTPClientConfig

ftpClientConfigParameters (advanced)

FtpComponent에서 FTPClientConfig에 대한 추가 매개변수를 제공하는 데 사용합니다.

 

map

ftpClientParameters (advanced)

FtpComponent에서 FTPClient에 대한 추가 매개변수를 제공하는 데 사용됩니다.

 

map

maximumReconnectAttempts (advanced)

원격 FTP 서버에 연결을 시도할 때 Camel이 수행하는 최대 재연결 시도를 지정합니다. 이 동작을 비활성화하려면 0을 사용합니다.

 

int

reconnectDelay (advanced)

다시 연결 시도를 수행하기 전에 Camel의 지연이 대기됩니다.

1000

long

siteCommand (advanced)

로그인에 성공한 후 실행할 선택적 사이트 명령을 설정합니다. 새 줄 문자를 사용하여 여러 사이트 명령을 분리할 수 있습니다.

 

문자열

soTimeout (advanced)

제한 시간 FTP 및 FTPS가millis에서 SocketOptions.SO_TIMEOUT 값을 설정합니다. 중단된 연결이 없도록 이 옵션을 300000으로 설정하는 것이 좋습니다. SFTP에서 이 옵션은 JSCH Session 인스턴스에서 시간 초과로 설정됩니다.

300000

int

단계 ( advanced)

파일을 다운로드할 때 파일 구조를 트래버스하는 동안 디렉토리를 변경할지, 디렉토리에 파일을 업로드할 때 디렉토리를 변경할지 여부를 설정합니다. 예를 들어 보안상의 이유로 FTP 서버의 디렉토리를 변경할 수 없는 경우 이를 비활성화할 수 있습니다. stepECDHE는 streamDownload와 함께 사용할 수 없습니다.

true

boolean

동기 (고급)

동기 처리를 엄격하게 사용해야 하는지 여부를 설정합니다.

false

boolean

throwExceptionOnConnectFailed (advanced)

연결에 실패(exhausted)By 기본 예외가 발생하지 않고 WARN이 기록되는 경우 예외가 throw됩니다. 이를 사용하여 throw되는 예외를 활성화하고 org.apache.camel.spi.PollingConsumerPollStrategy 롤백 방법에서 발생한 예외를 처리할 수 있습니다.

false

boolean

시간 초과 (advanced)

FTPClient에서만 사용되는 응답을 기다리는 데이터 시간 초과를 설정합니다.

30000

int

antExclude (filter)

ant 스타일 필터 제외. antInclude 및 antExclude를 모두 사용하면 antExclude가 antInclude보다 우선합니다. 여러 제외 항목을 쉼표로 구분된 형식으로 지정할 수 있습니다.

 

문자열

antFilterCaseSensitive (filter)

ant 필터에 대/소문자 구분 플래그를 설정합니다.

true

boolean

antInclude (filter)

ant 스타일 필터 포함. 여러 포함을 쉼표로 구분된 형식으로 지정할 수 있습니다.

 

문자열

eagerMaxMessagesPerPoll (필터)

maxMessagesPerPoll의 제한이 eager인지 여부를 제어할 수 있습니다. If eager then the limit is during the scanning of files. 여기서 as false는 모든 파일을 스캔한 다음 정렬을 수행합니다. 이 옵션을 false로 설정하면 모든 파일을 먼저 정렬한 다음 폴링을 제한할 수 있습니다. 정렬을 수행하기 위해 모든 파일 세부 정보가 메모리에 있기 때문에 메모리 사용량이 더 높아야 합니다.

true

boolean

제외 (필터)

은 파일을 제외하는 데 사용됩니다. 파일 이름이 regex 패턴과 일치하는 경우(대소문자를 구분하지 않음). 더하기 기호와 같은 기호를 사용하는 경우 끝점 uri로 구성하는 경우 RAW() 구문을 사용하여 이 기호를 구성해야 합니다. 엔드 포인트 배리 구성에 대한 자세한 내용을 참조하십시오.

 

문자열

excludeExt (filter)

은 파일 확장 이름과 일치하는 파일을 제외하는 데 사용됩니다(대/소문자를 구분하지 않음). 예를 들어 bak 파일을 제외하려면 excludeExt=bak을 사용합니다. 여러 확장은 쉼표로 분리할 수 있습니다. 예를 들어 bak 및 dat 파일을 제외하려면 excludeExt=bak,dat를 사용합니다. 파일 확장자에는 모든 부분이 포함되어 있습니다. 예를 들어 mydata.tar.gz라는 파일이 있으면 tar.gz라는 확장자가 있습니다. 유연성을 높이기 위해 include/exclude 옵션을 사용하십시오.

 

문자열

필터 (필터)

org.apache.camel.component.file.GenericFileFilter 클래스로서의 Pluggable 필터. filter가 accept() 메서드에서 false를 반환하는 경우 파일을 건너뜁니다.

 

GenericFileFilter

filterDirectory (filter)

간단한 언어를 기반으로 디렉터리를 필터링합니다. 예를 들어 현재 날짜를 필터링하려면 $\\{date:yyyyMMdd}와 같은 간단한 날짜 패턴을 사용할 수 있습니다.

 

문자열

filterFile (필터)

간단한 언어를 기반으로 파일을 필터링합니다. 예를 들어 파일 크기를 필터링하려면 $\\{file:size} 5000을 사용할 수 있습니다.

 

문자열

idempotent (필터)

Idempotent Consumer EIP 패턴을 사용하여 Camel이 이미 파일을 처리할 수 있도록 하는 옵션입니다. 기본적으로 1000개의 항목을 보유하는 메모리 기반 LRUCache를 사용합니다. noop=true인 경우 동일한 파일을 반복해서 사용하지 않도록 idempotent도 활성화됩니다.

false

부울

idempotentKey (filter)

사용자 정의 idempotent 키를 사용합니다. 기본적으로 파일의 절대 경로가 사용됩니다. 예를 들어 파일 이름 및 파일 크기를 사용하는 데 File Language를 사용할 수 있습니다. idempotentKey=$\{file:name}-$\{file:size}.

 

문자열

idempotentRepository (필터)

연결이 가능한 리포지토리 org.apache.camel.spi.IdempotentRepository는 지정하지 않고 idempotent가 true인 경우 기본적으로 MemoryIdempotentRepository를 사용합니다.

 

IdempotentRepository

포함 (필터)

파일 이름이 regex 패턴과 일치하는 경우 파일을 포함하는 데 사용됩니다(대개 대소문자를 구분하지 않음). 더하기 기호와 같은 기호를 사용하는 경우 끝점 uri로 구성하는 경우 RAW() 구문을 사용하여 이 기호를 구성해야 합니다. 엔드 포인트 배리 구성에 대한 자세한 내용을 참조하십시오.

 

문자열

includeExt (필터)

은 파일 확장 이름과 일치하는 파일 확장 이름(대/소문자를 구분하지 않음)을 포함하는 데 사용됩니다. 예를 들어 txt 파일을 포함하고 includeExt=txt를 사용합니다. txt 및 xml 파일을 포함하도록 여러 확장 기능을 쉼표로 분리할 수 있습니다. includeExt=txt,xml을 사용합니다. 파일 확장자에는 모든 부분이 포함되어 있습니다. 예를 들어 mydata.tar.gz라는 파일이 있으면 tar.gz라는 확장자가 있습니다. 유연성을 높이기 위해 include/exclude 옵션을 사용하십시오.

 

문자열

maxdepth (필터)

디렉터리를 재귀적으로 처리할 때 트래버스할 최대 깊이입니다.

2147483647

int

maxMessagesPerPoll (필터)

폴링당 수집할 최대 메시지를 정의하려면 다음을 수행합니다. 기본적으로 최대값은 설정되어 있지 않습니다. 수천 개의 파일이 있는 서버를 시작할 때 방지하도록 1000의 제한을 설정하는 데 사용할 수 있습니다. 이를 비활성화하려면 0 또는 negative의 값을 설정합니다. 주의: 이 옵션이 사용 중이면 파일 및 FTP 구성 요소는 정렬 전에 제한됩니다. 예를 들어 100000개의 파일이 있고 maxMessagesPerPoll=500을 사용하는 경우 처음 500개 파일만 선택하고 정렬합니다. eagerMaxMessagesPerPoll 옵션을 사용하여 먼저 모든 파일을 스캔한 다음 나중에 정렬할 수 있도록 이 값을 false로 설정할 수 있습니다.

 

int

minDepth (필터)

디렉터리를 재귀적으로 처리할 때 처리를 시작하는 최소 깊이입니다. minDepth=1을 사용하면 기본 디렉터리가 됩니다. minDepth=2를 사용하면 첫 번째 하위 디렉터리가 됩니다.

 

int

이동 (필터)

처리 후 이동 시 파일 이름을 동적으로 설정하는 데 사용되는 표현식(예: Simple Language)입니다. 파일을 .done 하위 디렉터리로 이동하려면 .done을 입력합니다.

 

문자열

exclusiveReadLockStrategy (lock)

Pluggable read-lock as a org.apache.camel.component.file.GenericFileExclusiveReadLockStrategy 구현

 

GenericFileExclusiveReadLockStrategy

readLock (lock)

소비자가 파일에 전용 읽기 잠금이 있는 경우에만 파일을 폴링하는 데 사용합니다(즉, 파일은 in-progress 또는 작성 중 없음). Camel은 파일 잠금이 부여될 때까지 기다립니다. 이 옵션은 전략으로 빌드를 제공합니다. - none - 읽기 잠금이 사용되지 않음 - markerFile - Camel은 마커 파일(fileName.camelLock)을 생성한 다음 잠금을 유지합니다. 이 옵션은 FTP 구성 요소에서 사용할 수 없습니다 - changed - Changed는 파일이 현재 복사 중인지 여부를 감지하기 위해 파일 길이/수정 타임스탬프를 사용하고 있습니다. 적어도 1 sec를 사용하여 이 옵션을 사용하여 다른 옵션보다 빠르게 파일을 사용할 수는 없지만 JDK IO API가 다른 프로세스에서 현재 파일을 사용하고 있는지 여부를 확인할 수 없기 때문에 더 신뢰할 수 없습니다. 옵션 readLockCheckInterval을 사용하여 검사 빈도를 설정할 수 있습니다. - fileLock -는 java.nio.channels.FileLock를 사용합니다. 이 옵션은 Windows OS 및 FTP 구성 요소에 사용할 수 없습니다. 이 방법은 파일 시스템이 분산 파일 잠금을 지원하지 않는 한 마운트/공유를 통해 원격 파일 시스템에 액세스하는 것을 피해야 합니다. - rename은 전용 읽기-lock을 얻을 수 있는 경우 파일 이름을 테스트로 사용하는 것입니다. - idempotent - (파일 구성 요소) idempotent는 read-lock으로 idempotent를 사용하는 것입니다. 이를 통해 idempotent 리포지토리 구현에서 이를 지원하는 경우 클러스터링을 지원하는 읽기 잠금을 사용할 수 있습니다. - idempotent-changed - (파일 구성 요소 전용) idempotent-changed-changed는 idempotentRepository를 사용하고 결합된 읽기 잠금으로 변경된 것입니다. 이를 통해 idempotent 리포지토리 구현에서 이를 지원하는 경우 클러스터링을 지원하는 읽기 잠금을 사용할 수 있습니다. - idempotent-rename - (파일 구성 요소 전용) idempotentRepository는 idempotentRepository를 사용하고 결합된 읽기 잠금으로 이름을 변경합니다. 이를 통해 idempotent 리포지토리 구현이 that.Notice를 지원하는 경우 클러스터링을 지원하는 읽기 잠금을 사용할 수 있습니다. 다양한 읽기 잠금이 클러스터형 모드에서 작동하는 데 적합하지는 않으며, 다른 노드의 동시 소비자가 공유 파일 시스템의 동일한 파일에 대해 경쟁하는 데 적합하지 않습니다. markerFile은 원자 작업과 가까운 작업을 사용하여 빈 마커 파일을 생성하지만 클러스터에서는 작동하지 않을 수 있습니다. fileLock은 더 잘 작동할 수 있지만 파일 시스템은 분산 파일 잠금을 지원해야 합니다. idempotent 읽기 잠금을 사용하면 idempotent 리포지토리에서 Hazelcast Component 또는 Infinispan과 같은 클러스터링을 지원하는 경우 클러스터링을 지원할 수 있습니다.

CloudEvent 값:

  • none
  • markerFile
  • fileLock
  • rename
  • changed
  • idempotent
  • idempotent-changed
  • idempotent-rename

none

문자열

readLockCheckInterval (lock)

읽기 잠금에서 지원하는 경우 읽기-잠재 간격(밀리초)입니다. 이 간격은 읽기 잠금을 취득하려는 시도 사이에 자고하는 데 사용됩니다. 예를 들어 변경된 읽기 잠금을 사용하는 경우 느린 쓰기를 위해 더 높은 간격 기간을 설정할 수 있습니다. 프로듀서가 매우 느린 경우 1 sec의 기본값은 너무 빠를 수 있습니다. 알림: FTP의 경우 기본 readLockCheckInterval은 5000입니다. readLockTimeout 값은 readLockCheckInterval보다 커야 하지만, 지문 규칙에 따라 readLockCheckInterval보다 2배 이상 높은 시간 초과가 발생합니다. 이는 읽기 잠금 프로세스에서 시간 초과에 도달하기 전에 잠금을 해제할 수 있도록 허용되도록 하려면 이 작업이 필요합니다.

1000

long

readLockDeleteOrphanLockFiles (lock)

시작 시 마커 파일로 잠금을 읽을지 여부에 관계없이 Camel이 올바르게 종료되지 않은 경우(예: JVM 충돌) 파일 시스템에 남아 있을 수 있는 고립된 읽기 잠금 파일을 삭제해야 합니다. 이 옵션을 false로 설정하면 분리된 잠금 파일이 있으면 Camel이 해당 파일을 찾지 못하므로 다른 노드에서 동일한 공유 디렉터리에서 파일을 동시에 읽을 수도 있습니다.

true

boolean

readLockLoggingLevel (lock)

읽기 잠금을 얻을 수 없을 때 사용되는 로깅 수준입니다. 기본적으로 DEBUG가 기록됩니다. 로깅이 없는 경우 이 수준을 OFF로 변경할 수 있습니다. 이 옵션은 readLock of types: changed, fileLock, idempotent, idempotent-changed, idempotent-rename, rename에 적용됩니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

DEBUG

LoggingLevel

readLockMarkerFile (lock)

변경됨, 이름 변경 또는 전용 읽기 잠금 유형과 함께 마커 파일을 사용할지 여부입니다. 기본적으로 마커 파일은 동일한 파일을 선택하는 다른 프로세스를 방지하기 위해 사용됩니다. 이 옵션을 false로 설정하여 이 동작을 해제할 수 있습니다. 예를 들어 Camel 애플리케이션에서 마커 파일을 파일 시스템에 작성하지 않으려면 다음을 수행하십시오.

true

boolean

readLockMinAge (lock)

이 옵션은 readLock=changed에만 적용됩니다. 읽기 잠금을 얻기 전에 파일이 있어야 하는 최소 기간을 지정할 수 있습니다. 예를 들어 readLockMinAge=300s를 사용하여 파일이 마지막 5분 동안 있어야 합니다. 이렇게 하면 변경된 읽기 잠금이 빨라질 수 있습니다. 이는 지정된 기간 이상의 파일만 취득하려고 시도하기 때문입니다.

0

long

readLockMinLength (lock)

이 옵션은 readLock=changed에만 적용됩니다. 최소 파일 길이를 구성할 수 있습니다. 기본적으로 Camel은 파일에 데이터를 포함할 것으로 예상하므로 기본값은 1입니다. 이 옵션을 0으로 설정하여 길이가 0인 파일을 사용할 수 있습니다.

1

long

readLockRemoveOnCommit (lock)

이 옵션은 readLock=idempotent에만 적용됩니다. 파일을 처리할 때 idempotent 리포지토리에서 파일 이름 항목을 제거할지 여부를 지정하고 커밋이 수행됩니다. 기본적으로 파일이 제거되지 않아 경쟁 조건이 발생하지 않으므로 다른 활성 노드가 파일을 가져 오려고 할 수 있습니다. 대신 idempotent 리포지토리는 X분 후에 파일 이름 항목을 제거하도록 구성할 수 있는 제거 전략을 지원할 수 있습니다. 자세한 내용은 readLockIdempotentReleaseDelay 옵션에서 참조하십시오.

false

boolean

readLockRemoveOnRollback (lock)

이 옵션은 readLock=idempotent에만 적용됩니다. 파일을 처리하는 데 실패하여 롤백이 발생할 때 idempotent 리포지토리에서 파일 이름 항목을 제거할지 여부를 지정할 수 있습니다. 이 옵션이 false이면 파일 이름 항목이 확인됩니다(파일이 커밋한 것처럼).

true

boolean

readLockTimeout (lock)

읽기-잠재에서 지원하는 경우 읽기-잠재에 대한 millis의 선택적 타임아웃입니다. 읽기-잠재를 부여할 수 없고 시간 초과가 트리거되면 Camel이 파일을 건너뜁니다. 다음 폴링 Camel에서 파일을 다시 시도할 것이며, 이번에는 읽기 잠금이 부여될 수 있습니다. 영구적으로 표시하려면 0 이하의 값을 사용합니다. 현재 fileLock, 변경 및 이름 변경이 시간 초과를 지원합니다. 알림: FTP의 경우 기본 readLockTimeout 값은 10000 대신 10.0.0.1입니다. readLockTimeout 값은 readLockCheckInterval보다 커야 하지만, 지문 규칙에 따라 readLockCheckInterval보다 2배 이상 높은 시간 초과가 발생합니다. 이는 읽기 잠금 프로세스에서 시간 초과에 도달하기 전에 잠금을 해제할 수 있도록 허용되도록 하려면 이 작업이 필요합니다.

10000

long

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

계정 (보안)

로그인에 사용할 계정입니다.

 

문자열

암호 (보안)

로그인에 사용할 암호입니다.

 

문자열

사용자 이름 (보안)

로그인에 사용할 사용자 이름입니다.

 

문자열

shuffle (sort)

파일 목록을 셔플합니다(임의 임의 순서로 정렬).

false

boolean

sortby (sort)

파일 언어를 사용하여 기본 제공 정렬. 중첩된 정렬을 지원하므로 파일 이름 및 수정된 날짜에 따라 두 번째 그룹 정렬으로 정렬할 수 있습니다.Supports nested sorts, so you can have a sort by file name and as a 2nd group sort by modified date.

 

문자열

Sort er (sort)

Pluggable sorter as a java.util.Comparator 클래스.

 

comparator

22.5. FTPS 구성 요소 기본 신뢰 저장소

FTPS 구성 요소가 있는 SSL과 관련된 ftpClient. 속성을 사용하는 경우 신뢰 저장소는 모든 인증서를 수락합니다. 신뢰 선택적 인증서만 사용하려는 경우 ftpClient.trustStore.xxx 옵션을 사용하여 신뢰 저장소를 구성하거나 사용자 지정 ftpClient 를 구성하여 신뢰 저장소를 구성해야 합니다.

sslContextParameters 를 사용할 때 신뢰 저장소는 제공된 SSLContextParameters 인스턴스의 구성에 의해 관리됩니다.

ftpClient. 또는 ftpClient Config. 접두사를 사용하여 URI에서 직접 ftpClient 및 ftpClientConfig에서 추가 옵션을 구성할 수 있습니다.

예를 들어 FTPClient 에서 setDataTimeout 을 30초로 설정하려면 다음을 수행할 수 있습니다.

from("ftp://foo@myserver?password=secret&ftpClient.dataTimeout=30000").to("bean:foo");

혼합하여 일치하고 두 접두사를 모두 사용하여 날짜 형식 또는 시간대를 구성할 수 있습니다.

from("ftp://foo@myserver?password=secret&ftpClient.dataTimeout=30000&ftpClientConfig.serverLanguageCode=fr").to("bean:foo");

원하는 만큼의 옵션을 사용할 수 있습니다.

가능한 옵션 및 자세한 내용은 Apache Commons FTPClientConfig 설명서를 참조하십시오. Apache Commons FTPClient의 경우

URL에 많은 긴 구성이 있는 것을 선호하지 않으면 ftpClient 또는 ftpClientConfig 를 Registry에서 Camel 조회를 사용하여 사용할 수 있습니다.

예를 들면 다음과 같습니다.

   <bean id="myConfig" class="org.apache.commons.net.ftp.FTPClientConfig">
       <property name="lenientFutureDates" value="true"/>
       <property name="serverLanguageCode" value="fr"/>
   </bean>

URL에서 # 표기법을 사용할 때 Camel이 이 template을 조회하도록 합니다.

from("ftp://foo@myserver?password=secret&ftpClientConfig=#myConfig").to("bean:foo");

22.6. 예

ftp://someone@someftpserver.com/public/upload/images/holiday2008?password=secret&binary=true

ftp://someoneelse@someotherftpserver.co.uk:12049/reports/2008/password=secret&binary=false

ftp://publicftpserver.com/download

22.7. 동시성

FTP 소비자는 동시성을 지원하지 않습니다.

FTP 소비자(동일 끝점 포함)는 동시성을 지원하지 않습니다(지원 FTP 클라이언트는 스레드로부터 안전하지 않음).
여러 FTP 소비자를 사용하여 다른 끝점에서 폴링할 수 있습니다. 동시 소비자를 지원하지 않는 단일 끝점일 뿐입니다.

FTP 프로듀서에는 이 문제가 없으며 동시성이 지원됩니다.

22.8. 더 알아보기

이 구성 요소는 File 구성 요소의 확장입니다. 따라서 파일 구성 요소 페이지에 더 많은 샘플과 세부 사항이 있습니다.

22.9. 파일을 사용할 때 기본값

FTP 소비자는 기본적으로 원격 FTP 서버에서 소비된 파일을 그대로 유지합니다. 파일을 삭제하거나 다른 위치로 이동하려는 경우 명시적으로 구성해야 합니다. 예를 들어 delete=true 를 사용하여 파일을 삭제하거나 move=.done 을 사용하여 파일을 숨겨진된 하위 디렉터리로 이동할 수 있습니다.

일반 파일 소비자는 기본적으로 파일을 .camel 하위 디렉터리로 이동하므로 달라집니다. FTP 소비자에 대해 Camel이 기본적으로 이 작업을 수행하지 않는 이유는 파일을 이동하거나 삭제할 수 있도록 기본적으로 권한이 부족할 수 있기 때문입니다.

22.9.1. 제한

옵션 readLock 을 사용하면 Camel이 현재 작성 중인 파일을 사용하지 않도록 할 수 있습니다. 그러나 이 옵션은 사용자에게 쓰기 액세스 권한이 필요하므로 기본적으로 해제됩니다. 읽기 잠금에 대한 자세한 내용은 File2의 옵션 표를 참조하십시오.
현재 FTP를 통해 작성 중인 파일을 사용하지 않는 다른 방법이 있습니다. 예를 들어 임시 대상에 쓰고 파일을 작성한 후 이동할 수 있습니다.

move 또는 preanchor 옵션을 사용하여 파일을 이동할 때 파일은 FTP_ROOT 폴더로 제한됩니다. 이렇게 하면 FTP 영역 외부에서 파일을 이동할 수 없습니다. 파일을 다른 영역으로 이동하려면 소프트 링크를 사용하여 파일을 소프트 링크 폴더로 이동할 수 있습니다.

22.10. 메시지 헤더

다음 메시지 헤더를 사용하여 구성 요소의 동작에 영향을 미칠 수 있습니다.

header설명

CamelFileName

엔드포인트로 보낼 때 출력 메시지에 사용할 출력 파일 이름( endpoint 디렉터리 관련)을 지정합니다. 이 값이 없고 표현식이 없는 경우 생성된 메시지 ID가 파일 이름으로 대신 사용됩니다.

CamelFileNameProduced

기록된 출력 파일의 실제 filepath(path + name)입니다. 이 헤더는 Camel에 의해 설정되며 용도는 최종 사용자에게 작성된 파일 이름을 제공하는 것입니다.

CamelFileNameConsumed

사용된 파일의 이름

CamelFileHost

원격 호스트 이름입니다.

CamelFileLocalWorkPath

로컬 작업 디렉터리가 사용되는 경우 로컬 작업 파일의 경로입니다.

또한 FTP/ECDHES 소비자 및 생산자는 다음 헤더를 사용하여 Camel Message 를 보강합니다.

header설명

CamelFtpReplyCode

FTP 클라이언트 응답 코드(유형은 정수임)

CamelFtpReplyString

FTP 클라이언트 응답 문자열

22.10.1. 교환 속성

Camel은 다음과 같은 교환 속성을 설정합니다.

header설명

CamelBatchIndex

이 배치에서 사용되는 총 파일 수의 현재 인덱스입니다.

CamelBatchSize

이 배치에서 사용되는 총 파일 수입니다.

CamelBatchComplete

이 배치에 더 이상 파일이 없는 경우 True입니다.

22.11. 시간 초과 정보

두 개의 라이브러리 세트(상위 참조)에는 시간 초과 설정을 위한 API가 다릅니다. 두 명령 모두 connectTimeout 옵션을 사용하여 네트워크 연결을 설정하도록 millis의 시간 초과를 설정할 수 있습니다. 개별 soTimeoutftpClient.soTimeout 사용에 해당하는 FTP/ECDHES에도 설정할 수 있습니다. SFTP는 soTimeout 으로 connectTimeout 을 자동으로 사용합니다. 시간 초과 옵션은 ftpClient.dataTimeout 값에 해당하는 데이터 시간 초과로 FTP/ECDHES에만 적용됩니다. 모든 시간 제한 값은 밀리에 있습니다.

22.12. 로컬 작업 디렉터리 사용

Camel은 원격 FTP 서버의 소비와 파일을 로컬 작업 디렉터리로 직접 다운로드할 수 있도록 지원합니다. 이렇게 하면 FileOutputStream 을 사용하여 로컬 파일로 직접 스트리밍되므로 전체 원격 파일 콘텐츠를 메모리에 읽을 수 없습니다.

Camel은 파일을 다운로드하는 동안 확장자와 .inprogress 를 사용하여 원격 파일과 이름이 동일한 로컬 파일에 저장됩니다. 이후 파일의 이름이 .inprogress 접미사를 제거하도록 변경됩니다. 마지막으로 교환이 완료되면 로컬 파일이 삭제됩니다.

따라서 원격 FTP 서버에서 파일을 다운로드하여 파일로 저장하려면 다음과 같은 파일 끝점으로 라우팅해야 합니다.

from("ftp://someone@someserver.com?password=secret&localWorkDirectory=/tmp").to("file://inbox");
참고

위의 경로는 전체 파일 콘텐츠를 메모리로 읽는 것을 피하기 때문에 매우 효율적입니다. 원격 파일을 로컬 파일 스트림으로 직접 다운로드합니다. 그런 다음 java.io.File 처리가 Exchange 본문으로 사용됩니다. 파일 프로듀서는 이 사실을 활용하고 java.io.File 이 대상 파일 이름에 java.io.File.rename 을 처리하고 직접 작업할 수 있습니다. Camel은 로컬 작업 파일임을 알고 있으므로 파일 복사 대신 이름을 최적화하고 사용할 수 있습니다. 작업 파일은 영구적으로 삭제해야 합니다.

22.13. 단계 변경 디렉터리

Camel FTP는 파일을 사용하거나 파일 다운로드(예: 업로드) 생성 시 디렉터리를 트래킹하는 과정에서 두 가지 모드로 작동할 수 있습니다.

  • 단계
  • 단계적이지 않음

상황 및 보안 문제에 따라 둘 중 하나를 선택할 수 있습니다. 일부 Camel 최종 사용자는 단계를 사용하는 경우에만 파일을 다운로드할 수 있지만 다른 사용자는 파일이 없는 경우에만 다운로드할 수 있습니다.

단계 옵션을 사용하여 동작을 제어할 수 있습니다.

대부분의 경우 디렉터리를 변경하면 사용자가 홈 디렉터리의 홈 디렉토리에 한정될 때와 홈 디렉터리가 "/" 로 보고될 때만 작동합니다.

이 두 항목의 차이점은 예제를 통해 가장 잘 설명되어 있습니다. 원격 FTP 서버에 다음과 같은 디렉토리 구조가 있다고 가정하면 파일을 트래버스하고 다운로드해야 합니다.

/
/one
/one/two
/one/two/sub-a
/one/two/sub-b

그리고 각 하위(a.txt) 및 하위(b.txt) 폴더에 파일이 있습니다.

22.14. stepECDHE=true(기본 모드) 사용

TYPE A
200 Type set to A
PWD
257 "/" is current directory.
CWD one
250 CWD successful. "/one" is current directory.
CWD two
250 CWD successful. "/one/two" is current directory.
SYST
215 UNIX emulated by FileZilla
PORT 127,0,0,1,17,94
200 Port command successful
LIST
150 Opening data channel for directory list.
226 Transfer OK
CWD sub-a
250 CWD successful. "/one/two/sub-a" is current directory.
PORT 127,0,0,1,17,95
200 Port command successful
LIST
150 Opening data channel for directory list.
226 Transfer OK
CDUP
200 CDUP successful. "/one/two" is current directory.
CWD sub-b
250 CWD successful. "/one/two/sub-b" is current directory.
PORT 127,0,0,1,17,96
200 Port command successful
LIST
150 Opening data channel for directory list.
226 Transfer OK
CDUP
200 CDUP successful. "/one/two" is current directory.
CWD /
250 CWD successful. "/" is current directory.
PWD
257 "/" is current directory.
CWD one
250 CWD successful. "/one" is current directory.
CWD two
250 CWD successful. "/one/two" is current directory.
PORT 127,0,0,1,17,97
200 Port command successful
RETR foo.txt
150 Opening data channel for file transfer.
226 Transfer OK
CWD /
250 CWD successful. "/" is current directory.
PWD
257 "/" is current directory.
CWD one
250 CWD successful. "/one" is current directory.
CWD two
250 CWD successful. "/one/two" is current directory.
CWD sub-a
250 CWD successful. "/one/two/sub-a" is current directory.
PORT 127,0,0,1,17,98
200 Port command successful
RETR a.txt
150 Opening data channel for file transfer.
226 Transfer OK
CWD /
250 CWD successful. "/" is current directory.
PWD
257 "/" is current directory.
CWD one
250 CWD successful. "/one" is current directory.
CWD two
250 CWD successful. "/one/two" is current directory.
CWD sub-b
250 CWD successful. "/one/two/sub-b" is current directory.
PORT 127,0,0,1,17,99
200 Port command successful
RETR b.txt
150 Opening data channel for file transfer.
226 Transfer OK
CWD /
250 CWD successful. "/" is current directory.
QUIT
221 Goodbye
disconnected.

단계가 활성화될 때 볼 수 있듯이 CD xxx를 사용하여 디렉터리 구조를 트래버스합니다.

22.15. stepECDHE=false 사용

230 Logged on
TYPE A
200 Type set to A
SYST
215 UNIX emulated by FileZilla
PORT 127,0,0,1,4,122
200 Port command successful
LIST one/two
150 Opening data channel for directory list
226 Transfer OK
PORT 127,0,0,1,4,123
200 Port command successful
LIST one/two/sub-a
150 Opening data channel for directory list
226 Transfer OK
PORT 127,0,0,1,4,124
200 Port command successful
LIST one/two/sub-b
150 Opening data channel for directory list
226 Transfer OK
PORT 127,0,0,1,4,125
200 Port command successful
RETR one/two/foo.txt
150 Opening data channel for file transfer.
226 Transfer OK
PORT 127,0,0,1,4,126
200 Port command successful
RETR one/two/sub-a/a.txt
150 Opening data channel for file transfer.
226 Transfer OK
PORT 127,0,0,1,4,127
200 Port command successful
RETR one/two/sub-b/b.txt
150 Opening data channel for file transfer.
226 Transfer OK
QUIT
221 Goodbye
disconnected.

단계를 사용하지 않는 경우 확인할 수 있으므로 CD 작업이 전혀 호출되지 않습니다.

22.16. 샘플

아래 샘플에서는 Camel을 설정하여 FTP 서버의 모든 보고서를 BINARY 콘텐츠로 한 번(60분)하고 로컬 파일 시스템에 파일로 저장하도록 설정합니다.

XML DSL을 사용하는 경로:

  <route>
     <from uri="ftp://scott@localhost/public/reports?password=tiger&amp;binary=true&amp;delay=60000"/>
     <to uri="file://target/test-reports"/>
  </route>

22.16.1. 원격 FTPS 서버(간체 SSL) 및 클라이언트 인증 사용

from("ftps://admin@localhost:2222/public/camel?password=admin&securityProtocol=SSL&implicit=true
      &ftpClient.keyStore.file=./src/test/resources/server.jks
      &ftpClient.keyStore.password=password&ftpClient.keyStore.keyPassword=password")
  .to("bean:foo");

22.16.2. 원격 FTPS 서버(explicit TLS) 및 사용자 정의 신뢰 저장소 구성 사용

from("ftps://admin@localhost:2222/public/camel?password=admin&ftpClient.trustStore.file=./src/test/resources/server.jks&ftpClient.trustStore.password=password")
  .to("bean:foo");

22.17. 사용자 정의 필터링

Camel은 플러그형 필터링 전략을 지원합니다. 이 전략은 Java의 org.apache.camel.component.file.GenericFileFilter 에서 빌드를 사용하는 것입니다. 그런 다음 이러한 필터를 사용하여 끝점을 구성하여 처리되기 전에 특정 필터를 건너뛸 수 있습니다.

샘플에서 파일 이름으로 시작하는 파일만 허용하는 자체 필터를 빌드했습니다.

그런 다음 filter 속성을 사용하여 Spring XML 파일에서 정의한 필터(# 표기법 사용)를 참조하도록 경로를 구성할 수 있습니다.

   <!-- define our sorter as a plain spring bean -->
   <bean id="myFilter" class="com.mycompany.MyFileFilter"/>

  <route>
    <from uri="ftp://someuser@someftpserver.com?password=secret&amp;filter=#myFilter"/>
    <to uri="bean:processInbox"/>
  </route>

22.18. ANT 경로 일치자를 사용하여 필터링

ANT 경로 matcher는 camel-spring journalctl에 기본적으로 제공되는 필터입니다. Maven을 사용하는 경우 camel-spring 에 의존해야합니다.
그 이유는 Spring의ECDHE PathMatcher 를 활용하여 실제 일치를 수행하기 때문입니다.

파일 경로는 다음 규칙과 일치합니다.

  • 하나의 문자를 찾습니다.Match one character.
  • 0개 이상의 문자를 찾습니다.Match zero or more characters.
  • ** 경로의 0개 이상의 디렉터리 일치

아래 샘플은 이를 사용하는 방법을 보여줍니다.

22.19. SFTP에서 프록시 사용

HTTP 프록시를 사용하여 원격 호스트에 연결하려면 다음과 같은 방법으로 경로를 구성할 수 있습니다.

<!-- define our sorter as a plain spring bean -->
<bean id="proxy" class="com.jcraft.jsch.ProxyHTTP">
  <constructor-arg value="localhost"/>
  <constructor-arg value="7777"/>
</bean>

<route>
  <from uri="sftp://localhost:9999/root?username=admin&password=admin&proxy=#proxy"/>
  <to uri="bean:processFile"/>
</route>

필요한 경우 사용자 이름과 암호를 프록시에 할당할 수도 있습니다. 모든 옵션을 찾으려면 com.jknative.jsch.Proxy 설명서를 참조하십시오.

22.20. 기본 SFTP 인증 방법 설정

sftp 구성 요소에서 사용해야 하는 인증 방법 목록을 명시적으로 지정하려면 preferredAuthentications 옵션을 사용합니다. 예를 들어 Camel에서 개인/공용 SSH 키로 인증을 시도하고 공개 키를 사용할 수 없는 경우 사용자/암호 인증으로 폴백하려면 다음 경로 구성을 사용합니다.

from("sftp://localhost:9999/root?username=admin&password=admin&preferredAuthentications=publickey,password").
  to("bean:processFile");

22.21. 고정 이름을 사용하여 단일 파일 사용

단일 파일을 다운로드하고 파일 이름을 알고자 할 때 fileName=myFileName.txt 를 사용하여 Camel에 다운로드할 파일 이름을 알 수 있습니다. 기본적으로 소비자는 디렉토리 목록을 수행하기 위해 FTP LIST 명령을 수행한 다음 fileName 옵션에 따라 이러한 파일을 필터링합니다. 이 사용 사례에서는 useList=false 를 설정하여 디렉토리 목록을 끄는 것이 좋습니다. 예를 들어 FTP 서버에 로그인하는 데 사용된 사용자 계정에는 FTP LIST 명령을 수행할 수 있는 권한이 없을 수 있습니다. 따라서 useList=false 로 이 기능을 끄고 fileName=myFileName.txt 로 다운로드할 파일의 고정 이름을 제공하면 FTP 사용자가 파일을 계속 다운로드할 수 있습니다. 어떤 이유로든 파일이 존재하지 않는 경우 Camel은 기본적으로 예외를 throw합니다. 이 기능을 끄고 ignoreFileNotFoundOrPermissionError=true 를 설정하여 이를 무시하고 이를 무시할 수 있습니다.

예를 들어 단일 파일을 선택하고 삭제한 Camel 경로가 있는 경우 다음을 수행할 수 있습니다.

from("ftp://admin@localhost:21/nolist/?password=admin&stepwise=false&useList=false&ignoreFileNotFoundOrPermissionError=true&fileName=report.txt&delete=true")
  .to("activemq:queue:report");

위에서 설명한 모든 옵션을 사용했습니다.

또한 ConsumerTemplate 과 함께 사용할 수도 있습니다. 예를 들어 단일 파일(있는 경우)을 다운로드하고 파일 내용을 String 유형으로 캡처하려면 다음을 수행합니다.

String data = template.retrieveBodyNoWait("ftp://admin@localhost:21/nolist/?password=admin&stepwise=false&useList=false&ignoreFileNotFoundOrPermissionError=true&fileName=report.txt&delete=true", String.class);

22.22. 디버그 로깅

이 구성 요소에는 문제가 있는 경우 유용할 수 있는 로그 수준 TRACE 가 있습니다.

22.23. Spring Boot Auto-Configuration

Spring Boot와 함께 ftp를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-ftp-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

구성 요소는 아래에 나열된 13개의 옵션을 지원합니다.

이름설명Default유형

camel.component.ftp.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.ftp.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.ftp.enabled

ftp 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.ftp.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.ftps.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.ftps.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.ftps.enabled

ftps 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.ftps.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.ftps.use-global-ssl-context-parameters

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

부울

camel.component.sftp.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.sftp.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.sftp.enabled

sftp 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.sftp.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

23장. HTTP

프로듀서만 지원됩니다.

HTTP 구성 요소는 HTTP를 사용하여 외부 서버를 호출하는 클라이언트로서 외부 HTTP 리소스 호출을 위한 HTTP 기반 끝점을 제공합니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-http</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

23.1. URI 형식

http:hostname[:port][/resourceUri][?options]

기본적으로 HTTP에는 포트 80을 사용하고 HTTPS에는 443을 사용합니다.

23.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

23.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

23.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

23.3. 구성 요소 옵션

HTTP 구성 요소는 아래에 나열된 37 옵션을 지원합니다.

이름설명Default유형

cookieStore (producer)

사용자 지정 org.apache.http.client.CookieStore를 사용합니다. 기본적으로 org.apache.http.impl.client.BasicCookieStore가 사용되는 메모리 내 쿠키 저장소입니다. bridgeEndpoint=true인 경우 쿠키 저장소가 noop 쿠키 저장소가 되도록 하려면 쿠키 저장소가 브리징(예: 프록시 역할을 함)이므로 저장해서는 안 됩니다.

 

CookieStore

copyHeaders (producer)

이 옵션이 true이면 IN 교환 헤더가 복사 전략에 따라 OUT 교환 헤더로 복사됩니다. 이 값을 false로 설정하면 HTTP 응답의 헤더만 포함할 수 있습니다( IN 헤더를 전파하지 않음).

true

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

responsePayloadStreamingThreshold (producer)

이 임계값(바이트)의 임계값은 응답 페이로드를 바이트 배열로 메모리에 저장할지 또는 스트리밍할지 여부를 제어합니다. 항상 스트리밍 모드를 사용하려면 이 값을 -1로 설정합니다.

8192

int

skipRequestHeaders (producer (advanced))

모든 Camel 헤더를 HTTP 요청 헤더로 매핑할지 여부를 건너뜁니다. HTTP 요청에 Camel 헤더의 데이터를 포함할 필요가 없는 경우 JVM 가비지 수집기에 대한 많은 오브젝트 할당으로 오버헤드를 구문 분석할 수 있습니다.

false

boolean

skipResponseHeaders (producer (advanced))

모든 HTTP 응답 헤더를 Camel 헤더에 매핑할지 여부를 건너뜁니다. HTTP 헤더에 필요한 데이터가 없는 경우 JVM 가비지 수집기에 대한 많은 개체 할당을 사용하여 오버헤드를 구문 분석하지 못할 수 있습니다.

false

boolean

allowJavaSerializedObject (advanced)

요청이 context-type=application/x-java-serialized-object를 사용할 때 Java 직렬화를 허용할지 여부입니다. 이는 기본적으로 해제되어 있습니다. 이를 활성화하면 Java가 요청에서 Java로 들어오는 데이터를 역직렬화하고 잠재적 보안 위험이 될 수 있음을 알고 있습니다.

false

boolean

authCachingDisabled (advanced)

인증 체계 캐싱을 비활성화합니다.

false

boolean

automaticRetriesDisabled (advanced)

자동 요청 복구 및 재실행을 비활성화합니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

clientConnectionManager (advanced)

사용자 지정 및 공유 10.0.0.1ClientConnectionManager를 사용하여 연결을 관리합니다. 이 값을 구성한 경우 항상 이 구성 요소에서 생성한 모든 엔드포인트에 사용됩니다.

 

HttpClientConnectionManager

connectionsPerRoute (advanced)

경로당 최대 연결 수입니다.

20

int

connectionStateDisabled (advanced)

연결 상태 추적을 비활성화합니다.

false

boolean

connectionTimeToLive (advanced)

라이브 연결 시간, 시간 단위는 밀리초이며, 기본값은 항상 활성 상태를 유지합니다.

 

long

contentCompressionDisabled (advanced)

자동 콘텐츠 압축을 비활성화합니다.

false

boolean

cookieManagementDisabled (advanced)

상태(cookie) 관리를 비활성화합니다.

false

boolean

defaultUserAgentDisabled (advanced)

사용자가 제공하지 않은 경우 이 빌더에서 설정한 기본 사용자 에이전트를 비활성화합니다.

false

boolean

httpBinding (advanced)

사용자 지정>-<Binding을 사용하여 Camel 메시지와 10.0.0.1Client 간 매핑을 제어하려면 다음을 수행합니다.

 

HttpBinding

httpClientConfigurer (advanced)

사용자 지정>-<ClientConfigurer를 사용하여 사용할 10.0.0.1Client의 구성을 수행합니다.

 

HttpClientConfigurer

httpConfiguration (advanced)

공유 10.0.0.1Configuration을 기본 구성으로 사용하려면 다음을 수행합니다.

 

HttpConfiguration

CloudEventContext (advanced)

요청을 실행할 때 사용자 지정 org.apache.http.protocol.HttpContext를 사용합니다.

 

HttpContext

maxTotalConnections (advanced)

최대 연결 수입니다.

200

int

redirectHandlingDisabled (advanced)

자동 리디렉션 처리를 비활성화합니다.

false

boolean

headerFilterStrategy (filter)

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지와 헤더를 필터링합니다.

 

HeaderFilterStrategy

proxyAuthDomain (proxy)

사용할 프록시 인증 도메인입니다.

 

문자열

proxyAuthHost (proxy)

프록시 인증 호스트

 

문자열

proxyAuthMethod (proxy)

사용할 프록시 인증 방법입니다.

CloudEvent 값:

  • Basic
  • 다이제스트
  • NTLM
 

문자열

proxyAuthNtHost (proxy)

NTML과 함께 사용할 프록시 인증 도메인(workstation 이름)입니다.

 

문자열

proxyAuthPassword (proxy)

프록시 인증 암호입니다.

 

문자열

proxyAuthPort (proxy)

프록시 인증 포트입니다.

 

정수

proxyAuthUsername (proxy)

프록시 인증 사용자 이름.

 

문자열

sslContextParameters (보안)

SSLContextParameters를 사용하여 보안을 구성하려면 다음을 수행합니다. 중요: org.apache.camel.support.jsse.SSLContextParameters 인스턴스 한 개만 iPXEComponent에 따라 지원됩니다. 2개 이상의 서로 다른 인스턴스를 사용해야 하는 경우 필요한 인스턴스당 새 10.0.0.1Component를 정의해야 합니다.

 

SSLContextParameters

useGlobalSslContextParameters (security)

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

boolean

X 509HostnameVerifier (보안)

DefaultHostnameVerifier 또는 NoopHostnameVerifier와 같은 사용자 정의 X509HostnameVerifier를 사용하려면 다음을 수행하십시오.

 

HostnameVerifier

connectionRequestTimeout (timeout)

연결 관리자에서 연결을 요청할 때 사용되는 시간(밀리초)입니다. 시간 제한 값이 0은 무한 타임아웃으로 해석됩니다. 시간 제한 값이 0은 무한 타임아웃으로 해석됩니다. 음수 값은 정의되지 않은(시스템 기본값)으로 해석됩니다.

-1

int

ConnectTimeout (timeout)

연결이 설정될 때까지 제한 시간(밀리초)을 결정합니다. 시간 제한 값이 0은 무한 타임아웃으로 해석됩니다. 시간 제한 값이 0은 무한 타임아웃으로 해석됩니다. 음수 값은 정의되지 않은(시스템 기본값)으로 해석됩니다.

-1

int

socketTimeout (timeout)

데이터 대기 시간 초과 시간(밀리초)을 정의합니다. 이는 연속된 두 데이터 패킷 간 최대 비활성 기간을 다르게 배치합니다. 시간 제한 값이 0은 무한 타임아웃으로 해석됩니다. 음수 값은 정의되지 않은(시스템 기본값)으로 해석됩니다.

-1

int

23.4. 끝점 옵션

HTTP 끝점은 URI 구문을 사용하여 구성됩니다.

http://httpUri

다음과 같은 경로 및 쿼리 매개변수 사용:

23.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

httpUri (common)

호출할 HTTP 끝점의 URL이 필요합니다.

 

URI

23.4.2. 쿼리 매개변수(51 매개변수)

이름설명Default유형

청크 (producer)

이 옵션이 false이면 Servlet은 HTTP 스트리밍을 비활성화하고 응답에서 콘텐츠 길이 헤더를 설정합니다.

true

boolean

disableStreamCache (common)

Servlet의 원시 입력 스트림이 캐시되는지 여부를 결정합니다(Camel은 파일, 스트림 캐싱) 캐시의 memory/overflow에 스트림을 읽습니다. 기본적으로 Camel은 Servlet 입력 스트림을 캐시하여 여러 번 읽기를 지원하여 Camel이 스트림에서 모든 데이터를 검색할 수 있도록 지원합니다. 그러나 예를 들어 파일 또는 기타 영구 저장소로 직접 스트리밍하는 것과 같은 원시 스트림에 액세스해야 하는 경우 이 옵션을 true로 설정할 수 있습니다. DefaultHttpBinding은 요청 입력 스트림 스트림을 스트림 캐시에 복사하여 스트림 읽기를 여러 번 지원하기 위해 이 옵션이 false인 경우 메시지 본문에 저장합니다. Servlet을 사용하여 끝점을 브리지/proxy하는 경우 메시지 페이로드를 여러 번 읽을 필요가 없는 경우 이 옵션을 활성화하여 성능을 개선하는 것이 좋습니다. http 생산자는 기본적으로 응답 본문 스트림을 캐시합니다. 이 옵션을 true로 설정하면 생산자는 응답 본문 스트림을 캐시하지 않지만 응답 스트림을 메시지 본문으로 사용합니다.

false

boolean

headerFilterStrategy (common)

사용자 정의 HeaderFilterStrategy를 사용하여 Camel 메시지 간 헤더를 필터링하려면 다음을 수행합니다.

 

HeaderFilterStrategy

httpBinding (공용 (advanced))

사용자 지정>-<Binding을 사용하여 Camel 메시지와 10.0.0.1Client 간 매핑을 제어하려면 다음을 수행합니다.

 

HttpBinding

bridgeEndpoint (producer)

옵션이 true인 경우 10.0.0.1Producer는 Exchange.HTTP_URI 헤더를 무시하고 요청에 끝점의 URI를 사용합니다. 또한 throwExceptionOnFailure 옵션을 false로 설정하여 10.0.0.1Producer에서 모든 오류 응답을 다시 보낼 수 있습니다.

false

boolean

clearExpiredCookies (producer)

HTTP 요청을 보내기 전에 만료된 쿠키를 지울지 여부입니다. 이렇게 하면 쿠키 저장소가 만료될 때 더 최신 제거되는 새로운 쿠키를 추가하여 계속 증가하지 않습니다. 구성 요소에 쿠키 관리를 비활성화한 경우 이 옵션도 사용할 수 없습니다.

true

boolean

connectionvdd (producer)

Connection Close 헤더를 HTTP 요청에 추가해야 하는지 여부를 지정합니다. 기본적으로 연결 10.0.0.1은 false입니다.

false

boolean

copyHeaders (producer)

이 옵션이 true이면 IN 교환 헤더가 복사 전략에 따라 OUT 교환 헤더로 복사됩니다. 이 값을 false로 설정하면 HTTP 응답의 헤더만 포함할 수 있습니다( IN 헤더를 전파하지 않음).

true

boolean

customHostHeader (producer)

생산자에 사용자 정의 호스트 헤더를 사용하려면 다음을 수행합니다. 쿼리에서 설정하지 않으면 무시됩니다. set는 url에서 파생된 호스트 헤더를 덮어씁니다.

 

문자열

httpMethod (producer)

사용할 HTTP 메서드를 구성합니다. 설정된 경우 10.0.0.1Method 헤더가 이 옵션을 덮어쓸 수 없습니다.

CloudEvent 값:

  • GET
  • POST
  • PUT
  • DELETE
  • HEAD
  • OPTIONS
  • TRACE
  • PATCH
 

HttpMethods

ignoreResponseBody (producer)

이 옵션이 true인 경우 http 생산자는 응답 본문을 읽고 입력 스트림을 캐시하지 않습니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

preserveHostHeader (producer)

옵션이 true인 경우 10.0.0.1Producer는 Host 헤더를 현재 교환 호스트 헤더에 포함된 값으로 설정합니다. 이는 다운스트림 서버에서 수신한 호스트 헤더가 업스트림 클라이언트에서 호출한 URL을 반영하도록 하려는 역방향 프록시 애플리케이션에서 유용합니다. 이 경우 호스트 헤더를 사용하여 프록시 서비스에 대한 정확한 URL을 생성할 수 있습니다.

false

boolean

throwExceptionOnFailure (producer)

원격 서버에서 실패한 응답의 경우 10.0.0.1OperationFailedException을 비활성화하는 옵션입니다. 이렇게 하면 HTTP 상태 코드에 관계없이 모든 응답을 가져올 수 있습니다.

true

boolean

transferException (producer)

소비자 측에서 활성화되어 있고 Exchange에 실패한 처리가 있고 발생된 Exception이 응답에서 application/x-java-serialized-object 콘텐츠 유형으로 직렬화된 경우. 프로듀서 측에서 예외는 역직렬화되어 있는 그대로 throw되며, 10.0.0.1OperationFailedException 대신 그대로 throw됩니다. 발생한 예외를 직렬화해야 합니다. 이는 기본적으로 해제되어 있습니다. 이를 활성화하면 Java가 요청에서 Java로 들어오는 데이터를 역직렬화하고 잠재적 보안 위험이 될 수 있음을 알고 있습니다.

false

boolean

cookieHandler (제조자 (advanced)

HTTP 세션을 유지하도록 쿠키 처리기를 구성합니다.

 

CookieHandler

cookieStore (producer)

사용자 정의Store를 사용합니다. 기본적으로는 메모리 내 쿠키 저장소인 BasicCookieStore가 사용됩니다. bridgeEndpoint=true인 경우 쿠키 저장소가 noop 쿠키 저장소가 되도록 하려면 쿠키 저장소가 브리징(예: 프록시 역할을 함)이므로 저장해서는 안 됩니다. cookieHandler가 설정된 경우 쿠키 저장소도 쿠키 처리가 cookieHandler에 의해 수행되므로 noop 쿠키 저장소가 되도록 강제 적용합니다.

 

CookieStore

deleteWithBody (제조(advanced))

HTTP DELETE에 메시지 본문이 포함되어야 하는지 여부입니다. 기본적으로 HTTP DELETE에는 HTTP 본문이 포함되어 있지 않습니다. 그러나 드문 경우지만 사용자는 메시지 본문을 포함해야 할 수도 있습니다.

false

boolean

getWithBody (생성자(고급))

HTTP GET에 메시지 본문이 포함되어야 하는지 여부입니다. 기본적으로 HTTP GET에는 HTTP 본문이 포함되어 있지 않습니다. 그러나 드문 경우지만 사용자는 메시지 본문을 포함해야 할 수도 있습니다.

false

boolean

okStatusCodeRange (producer (advanced))

상태 코드는 성공 응답으로 간주됩니다. 값이 포함되어 있습니다. 여러 범위를 쉼표로 구분하여 정의할 수 있습니다(예: 200-204,209,301-304). 각 범위는 단일 번호이거나 대시가 포함된 범위와 연결되어 있어야 합니다.

200-299

문자열

skipRequestHeaders (producer (advanced))

모든 Camel 헤더를 HTTP 요청 헤더로 매핑할지 여부를 건너뜁니다. HTTP 요청에 Camel 헤더의 데이터를 포함할 필요가 없는 경우 JVM 가비지 수집기에 대한 많은 오브젝트 할당으로 오버헤드를 구문 분석할 수 있습니다.

false

boolean

skipResponseHeaders (producer (advanced))

모든 HTTP 응답 헤더를 Camel 헤더에 매핑할지 여부를 건너뜁니다. HTTP 헤더에 필요한 데이터가 없는 경우 JVM 가비지 수집기에 대한 많은 개체 할당을 사용하여 오버헤드를 구문 분석하지 못할 수 있습니다.

false

boolean

Useragent (producer)

사용자 정의 HTTP User-Agent 요청 헤더를 설정하려면 다음을 수행합니다.

 

문자열

ClientBuilder (advanced)

이 끝점의 생산자 또는 소비자가 사용하는 새 RequestConfig 인스턴스에 사용되는 http 클라이언트 요청 매개변수에 대한 액세스 권한을 제공합니다.

 

HttpClientBuilder

clientConnectionManager (advanced)

사용자 지정 10.0.0.1ClientConnectionManager를 사용하여 연결을 관리합니다.

 

HttpClientConnectionManager

connectionsPerRoute (advanced)

경로당 최대 연결 수입니다.

20

int

iPXEClient (advanced)

생산자에서 사용할 사용자 지정 10.0.0.1Client를 설정합니다.

 

HttpClient

httpClientConfigurer (advanced)

인증 메커니즘 등을 구성하는 것과 같은 생산자 또는 소비자가 생성한 새 10.0.0.1Client 인스턴스에 대한 사용자 지정 구성 전략을 등록합니다.

 

HttpClientConfigurer

httpClientOptions (advanced)

맵의 키/값을 사용하여 10.0.0.1Client를 구성하려면 다음을 수행하십시오.

 

map

CloudEventContext (advanced)

사용자 지정 10.0.0.1Context 인스턴스를 사용하려면 다음을 수행합니다.

 

HttpContext

maxTotalConnections (advanced)

최대 연결 수입니다.

200

int

UseSystemProperties (advanced)

구성의 대체로 시스템 속성을 사용하려면 다음을 수행합니다.

false

boolean

proxyAuthDomain (proxy)

NTML에서 사용할 프록시 인증 도메인입니다.

 

문자열

proxyAuthHost (proxy)

프록시 인증 호스트

 

문자열

proxyAuthMethod (proxy)

사용할 프록시 인증 방법입니다.

CloudEvent 값:

  • Basic
  • 다이제스트
  • NTLM
 

문자열

proxyAuthNtHost (proxy)

NTML과 함께 사용할 프록시 인증 도메인(workstation 이름)입니다.

 

문자열

proxyAuthPassword (proxy)

프록시 인증 암호입니다.

 

문자열

proxyAuthPort (proxy)

프록시 인증 포트입니다.

 

int

proxyAuthScheme (proxy)

사용할 프록시 인증 스키마입니다.

CloudEvent 값:

  • http
  • https
 

문자열

proxyAuthUsername (proxy)

프록시 인증 사용자 이름.

 

문자열

proxyHost (proxy)

사용할 프록시 호스트 이름입니다.

 

문자열

proxyPort (proxy)

사용할 프록시 포트입니다.

 

int

authDomain (보안)

NTML에서 사용할 인증 도메인입니다.

 

문자열

AuthenticationPreemptive (security)

이 옵션이 true이면 camel-http가 서버에 선점 기본 인증을 보냅니다.

false

boolean

authHost (security)

NTML에서 사용할 인증 호스트입니다.

 

문자열

authMethod (보안)

Basic, Digest 또는 NTLM 값의 쉼표로 구분된 목록으로 사용할 수 있는 인증 방법

 

문자열

authMethodPriority (보안)

기본, 다이제스트 또는 NTLM으로 사용할 인증 방법을 지정합니다.

CloudEvent 값:

  • Basic
  • 다이제스트
  • NTLM
 

문자열

authPassword (보안)

인증 암호입니다.

 

문자열

authUsername (보안)

인증 사용자 이름.

 

문자열

sslContextParameters (보안)

SSLContextParameters를 사용하여 보안을 구성하려면 다음을 수행합니다. 중요: org.apache.camel.util.jsse.SSLContextParameters 인스턴스 한 개만 iPXEComponent에 따라 지원됩니다. 2개 이상의 서로 다른 인스턴스를 사용해야 하는 경우 필요한 인스턴스당 새 10.0.0.1Component를 정의해야 합니다.

 

SSLContextParameters

X 509HostnameVerifier (보안)

DefaultHostnameVerifier 또는 NoopHostnameVerifier와 같은 사용자 정의 X509HostnameVerifier를 사용하려면 다음을 수행하십시오.

 

HostnameVerifier

23.5. 메시지 헤더

이름유형설명

Exchange.HTTP_URI

문자열

호출할 URI입니다. 엔드포인트에서 직접 설정된 기존 URI를 재정의합니다. 이 URI는 호출할 http 서버의 URI입니다. 보안 등과 같은 엔드포인트 옵션을 구성할 수 있는 Camel 끝점 uri와 동일하지 않습니다. 이 헤더는 이를 지원하지 않으며 http 서버의 배만 지원합니다.

Exchange.HTTP_PATH

문자열

요청 URI의 경로인 헤더는 HTTP_URI로 요청 URI를 빌드하는 데 사용됩니다.

Exchange.HTTP_QUERY

문자열

URI 매개변수입니다. 엔드포인트에 직접 설정된 기존 URI 매개변수를 덮어씁니다.

Exchange.HTTP_RESPONSE_CODE

int

외부 서버의 HTTP 응답 코드입니다. OK는 200입니다.

Exchange.HTTP_RESPONSE_TEXT

문자열

외부 서버의 HTTP 응답 텍스트입니다.

Exchange.HTTP_CHARACTER_ENCODING

문자열

문자 인코딩.

Exchange.CONTENT_TYPE

문자열

HTTP 콘텐츠 유형입니다. 는 IN 및 OUT 메시지 모두에 설정되어 콘텐츠 유형(예: text/html )을 제공합니다.

exchange.CONTENT_ENCODING

문자열

HTTP 콘텐츠 인코딩입니다. 은 콘텐츠 인코딩(예: gzip )을 제공하기 위해 IN 및 OUT 메시지 모두에 설정됩니다.

23.6. 메시지 body

Camel은 외부 서버의 HTTP 응답을 OUT 본문에 저장합니다. IN 메시지의 모든 헤더는 OUT 메시지로 복사되므로 라우팅 중에 헤더가 보존됩니다. 또한 Camel은 OUT 메시지 헤더에 HTTP 응답 헤더를 추가합니다.

23.7. 시스템 속성 사용

useSystemProperties를 true로 설정하면 HTTP Client는 다음 System Properties를 찾고 이를 사용합니다.

  • ssl.TrustManagerFactory.algorithm
  • javax.net.ssl.trustStoreType
  • javax.net.ssl.trustStore
  • javax.net.ssl.trustStoreProvider
  • javax.net.ssl.trustStorePassword
  • java.home
  • ssl.KeyManagerFactory.algorithm
  • javax.net.ssl.keyStoreType
  • javax.net.ssl.keyStore
  • javax.net.ssl.keyStoreProvider
  • javax.net.ssl.keyStorePassword
  • http.proxyHost
  • http.proxyPort
  • http.nonProxyHosts
  • http.keepAlive
  • http.maxConnections

23.8. 응답 코드

Camel은 HTTP 응답 코드에 따라 처리합니다.

  • 응답 코드는 100.299 범위에 있으며 Camel은 이를 성공 대응으로 간주합니다.
  • 응답 코드는 300..399 범위에 있으며 Camel은 이를 리디렉션 응답과 관련이 있으며 해당 정보를 사용하여 10.0.0.1 OperationFailedException 이 발생합니다.
  • 응답 코드는 400+이며 Camel은 이를 외부 서버 실패로 간주하며, 해당 정보를 사용하여 10.0.0.1 OperationFailedException 을 생성합니다.

throwExceptionOnFailure 옵션인 throwExceptionOnFailure, 실패한 응답 코드에 대해 10.0.0.1 OperationFailedException 이 발생하지 않도록 false 로 설정할 수 있습니다. 이를 통해 원격 서버에서 모든 응답을 가져올 수 있습니다.
다음은 이를 보여주는 샘플입니다.

23.9. 예외

10.0.0.1OperationFailedException 예외에는 다음 정보가 포함됩니다.

  • HTTP 상태 코드
  • HTTP 상태 줄(상태 코드의 텍스트)
  • 리디렉션 위치(서버가 리디렉션을 반환한 경우)
  • 서버에서 응답로 본문을 제공한 경우 java.lang.String 로 응답한 응답 본문

23.10. 사용할 HTTP 메서드

사용해야 하는 HTTP 메서드를 결정하는 데 다음 알고리즘을 사용합니다.
1. 끝점 구성(httpMethod)으로 제공된 방법을 사용합니다.
2. 헤더에 제공된 방법 (change.HTTP_METHOD).
3. GET if query string is provided in header.
4. GET if 엔드포인트가 쿼리 문자열로 구성됩니다.
5. 전송할 데이터가 있는 경우 POST (body는 null이 아님).
6. 그렇지 않으면 GET 입니다.

23.11. iPXEServletRequest 및>-<ServletResponse에 액세스하는 방법

Camel 유형 변환기 시스템을 사용하여 이 두 가지에 액세스할 수 있습니다.

HttpServletRequest request = exchange.getIn().getBody(HttpServletRequest.class);
HttpServletResponse response = exchange.getIn().getBody(HttpServletResponse.class);
참고

camel-jetty 또는 camel-cxf 끝점 이후 프로세서에서뿐만 아니라 요청 및 응답을 가져올 수 있습니다.

23.12. 호출할 URI 구성

HTTP 생산자의 URI를 직접 끝점 URI를 설정할 수 있습니다. 아래 경로에서 Camel은 HTTP를 사용하여 외부 서버인 oldhost 를 호출합니다.

from("direct:start")
        .to("http://oldhost");

동일한 Spring 샘플:

<camelContext xmlns="http://activemq.apache.org/camel/schema/spring">
  <route>
    <from uri="direct:start"/>
    <to uri="http://oldhost"/>
  </route>
</camelContext>

메시지에서 키 Exchange.HTTP_URI 로 헤더를 추가하여 HTTP 끝점 URI를 덮어쓸 수 있습니다.

from("direct:start")
  .setHeader(Exchange.HTTP_URI, constant("http://newhost"))
  .to("http://oldhost");

위의 예에서 Camel은 엔드포인트가 http://oldhost/ 로 구성되어 있어도 http://newhost/을 호출합니다.
http 끝점이 브리지 모드에서 작동 중인 경우 Exchange.HTTP_URI 의 메시지 헤더를 무시합니다.

23.13. URI 매개변수 구성

http 생산자는 HTTP 서버로 전송할 URI 매개변수를 지원합니다. URI 매개변수는 끝점 URI에서 직접 설정하거나 메시지에서 Exchange.HTTP_QUERY 키가 있는 헤더로 설정할 수 있습니다.

from("direct:start")
  .to("http://oldhost?order=123&detail=short");

헤더에 제공된 옵션:

from("direct:start")
  .setHeader(Exchange.HTTP_QUERY, constant("order=123&detail=short"))
  .to("http://oldhost");

23.14. http 메서드(GET/PATCH/POST/PUT/DELETE/HEAD/OPTIONS/TRACE)를 HTTP 프로듀서에 설정하는 방법

HTTP 구성 요소는 메시지 헤더를 설정하여 HTTP 요청 메서드를 설정하는 방법을 제공합니다. 예를 들면 다음과 같습니다.

from("direct:start")
  .setHeader(Exchange.HTTP_METHOD, constant(org.apache.camel.component.http.HttpMethods.POST))
  .to("http://www.google.com")
  .to("mock:results");

문자열 상수를 사용하여 메서드를 약간 더 짧게 작성할 수 있습니다.

.setHeader("CamelHttpMethod", constant("POST"))

동일한 Spring 샘플:

<camelContext xmlns="http://activemq.apache.org/camel/schema/spring">
  <route>
    <from uri="direct:start"/>
    <setHeader name="CamelHttpMethod">
        <constant>POST</constant>
    </setHeader>
    <to uri="http://www.google.com"/>
    <to uri="mock:results"/>
  </route>
</camelContext>

23.15. 클라이언트 시간 초과 사용 - SO_TIMEOUT

10.0.0.1 SOTimeoutTest 단위 테스트를 참조하십시오.

23.16. 프록시 구성

HTTP 구성 요소는 프록시를 구성하는 방법을 제공합니다.

from("direct:start")
  .to("http://oldhost?proxyAuthHost=www.myproxy.com&proxyAuthPort=80");

proxyAuthUsernameproxyAuthPassword 옵션을 통해 프록시 인증을 지원합니다.

23.16.1. URI 외부 프록시 설정 사용

시스템 속성 충돌을 방지하려면 CamelContext 또는 URI에서만 프록시 구성을 설정할 수 있습니다.
Java DSL :

 context.getGlobalOptions().put("http.proxyHost", "172.168.18.9");
 context.getGlobalOptions().put("http.proxyPort", "8080");

Spring XML

   <camelContext>
       <properties>
           <property key="http.proxyHost" value="172.168.18.9"/>
           <property key="http.proxyPort" value="8080"/>
      </properties>
   </camelContext>

Camel은 먼저 Java System 또는 CamelContext 속성의 설정을 설정한 다음 제공되는 경우 끝점 프록시 옵션을 설정합니다.
따라서 끝점 옵션으로 시스템 속성을 재정의할 수 있습니다.

사용할 스키마를 명시적으로 구성하도록 설정할 수 있는 http.proxyScheme 속성도 있습니다.

23.17. Veleroset 구성

데이터를 보내는 데 POST 를 사용하는 경우 Exchange 속성을 사용하여Char set 을 구성할 수 있습니다.

exchange.setProperty(Exchange.CHARSET_NAME, "ISO-8859-1");

23.17.1. 예약된 폴링이 있는 샘플

이 샘플은 10 초마다 Google 홈페이지를 폴링하고 파일 message.html 에 페이지를 작성합니다.

from("timer://foo?fixedRate=true&delay=0&period=10000")
  .to("http://www.google.com")
  .setHeader(FileComponent.HEADER_FILE_NAME, "message.html")
  .to("file:target/google");

23.17.2. 끝점 URI의 URI 매개변수

이 샘플에는 웹 브라우저에 입력한 전체 URI 끝점이 있습니다. 물론 웹 브라우저에서와 마찬가지로 & amp; 문자를 구분자로 사용하여 여러 URI 매개변수를 설정할 수 있습니다. Camel은 여기에 장애가 없습니다.

// we query for Camel at the Google page
template.sendBody("http://www.google.com/search?q=Camel", null);

23.17.3. 메시지의 URI 매개변수

Map headers = new HashMap();
headers.put(Exchange.HTTP_QUERY, "q=Camel&lr=lang_en");
// we query for Camel and English language at Google
template.sendBody("http://www.google.com/search", null, headers);

위의 헤더 값은 접두사로 ?를 붙일 수 없으며, 앞에 ? 와 같이 매개변수를 빈번하게 분리할 수 있다는 것을 알 수 있습니다.

23.17.4. 응답 코드 가져오기

Exchange.HTTP_RESPONSE_CODE 를 사용하여 아웃 메시지 헤더에서 값을 가져와서 HTTP 구성 요소에서 HTTP 응답 코드를 가져올 수 있습니다.

Exchange exchange = template.send("http://www.google.com/search", new Processor() {
  public void process(Exchange exchange) throws Exception {
    exchange.getIn().setHeader(Exchange.HTTP_QUERY, constant("hl=en&q=activemq"));
  }
});
Message out = exchange.getOut();
int responseCode = out.getHeader(Exchange.HTTP_RESPONSE_CODE, Integer.class);

23.18. 영사 비활성화

쿠키를 비활성화하려면 이 URI 옵션을 추가하여 쿠키를 무시하도록 HTTP 클라이언트를 설정할 수 있습니다.
httpClient.cookieSpec=ignoreCookies

23.19. 스트리밍 메시지 본문이 있는 기본 인증

Non>-<ableRequestException 을 방지하려면 옵션을 추가하여 Preemptive Basic Authentication을 수행해야 합니다.
authenticationPreemptive=true

23.20. 고급 사용량

HTTP 프로듀서에 대한 더 많은 제어가 필요한 경우, 사용자 지정 동작을 제공하기 위해 다양한 클래스를 설정할 수 있는>-< Component 를 사용해야 합니다.

23.20.1. HTTP 클라이언트용 SSL 설정

JSSE 설정 utility 사용

HTTP 구성 요소는 Camel JSSE 구성 utility 를 통해 SSL/TLS 구성을 지원합니다. 이 유틸리티를 사용하면 작성하는데 필요한 구성 요소별 코드의 양이 크게 감소하고 끝점 및 구성 요소 수준에서 구성할 수 있습니다. 다음 예제에서는 HTTP 구성 요소에서 유틸리티를 사용하는 방법을 보여줍니다.

구성 요소의 프로그래밍 방식 구성

KeyStoreParameters ksp = new KeyStoreParameters();
ksp.setResource("/users/home/server/keystore.jks");
ksp.setPassword("keystorePassword");

KeyManagersParameters kmp = new KeyManagersParameters();
kmp.setKeyStore(ksp);
kmp.setKeyPassword("keyPassword");

SSLContextParameters scp = new SSLContextParameters();
scp.setKeyManagers(kmp);

HttpComponent httpComponent = getContext().getComponent("https", HttpComponent.class);
httpComponent.setSslContextParameters(scp);

끝점의 Spring DSL 기반 구성

  <camel:sslContextParameters
      id="sslContextParameters">
    <camel:keyManagers
        keyPassword="keyPassword">
      <camel:keyStore
          resource="/users/home/server/keystore.jks"
          password="keystorePassword"/>
    </camel:keyManagers>
  </camel:sslContextParameters>

  <to uri="https://127.0.0.1/mail/?sslContextParameters=#sslContextParameters"/>

Apache HTTP 클라이언트 직접 구성

기본적으로 camel-http 구성 요소는 Apache 10.0.0.1Client 상단에 빌드됩니다. 자세한 내용은 SSL/TLS 사용자 지정을 참조하거나 org.apache.camel.component.http.HttpsServerTestSupport 단위 테스트 기본 클래스를 살펴보십시오.
사용자 정의 org.apache.camel.component.http.HttpClientConfigurer 를 구현하여 http 클라이언트에서 전체 제어가 필요한 경우 일부 구성을 수행할 수도 있습니다.

그러나 키 저장소 및 신뢰 저장소를 지정하려는 경우 Apache HTTPECDHE ClientConfigurer 를 사용하여 이 작업을 수행할 수 있습니다. 예를 들면 다음과 같습니다.

KeyStore keystore = ...;
KeyStore truststore = ...;

SchemeRegistry registry = new SchemeRegistry();
registry.register(new Scheme("https", 443, new SSLSocketFactory(keystore, "mypassword", truststore)));

그런 다음 10.0.0.1 ClientConfigurer 를 구현하는 클래스를 생성하고 위의 예제마다 키 저장소 또는 신뢰 저장소를 제공하는 https 프로토콜을 등록해야합니다. 그런 다음 camel route 빌더 클래스에서 다음과 같이 연결할 수 있습니다.

HttpComponent httpComponent = getContext().getComponent("http", HttpComponent.class);
httpComponent.setHttpClientConfigurer(new MyHttpClientConfigurer());

Spring DSL을 사용하여 이 작업을 수행하는 경우 URI를 사용하여 10.0.0.1 ClientConfigurer 를 지정할 수 있습니다. 예를 들면 다음과 같습니다.

<bean id="myHttpClientConfigurer"
 class="my.https.HttpClientConfigurer">
</bean>

<to uri="https://myhostname.com:443/myURL?httpClientConfigurer=myHttpClientConfigurer"/>

>-<ClientConfigurer를 구현하고 위에서 설명한대로 키 저장소 및 신뢰 저장소를 구성하는 한, 잘 작동합니다.

HTTPS를 사용하여 gotchas 인증

최종 사용자는 HTTPS를 사용한 인증에 문제가 있다고 보고했습니다. 사용자 정의 구성된 org.apache.http.protocol.HttpContext 를 제공하여 결국 문제를 해결했습니다.

  • 1. 10.0.0.1Contexts에 대한 (Spring) 팩토리를 생성합니다.
public class HttpContextFactory {

  private String httpHost = "localhost";
  private String httpPort = 9001;

  private BasicHttpContext httpContext = new BasicHttpContext();
  private BasicAuthCache authCache = new BasicAuthCache();
  private BasicScheme basicAuth = new BasicScheme();

  public HttpContext getObject() {
    authCache.put(new HttpHost(httpHost, httpPort), basicAuth);

    httpContext.setAttribute(ClientContext.AUTH_CACHE, authCache);

    return httpContext;
  }

  // getter and setter
}
  • 2. Spring 애플리케이션 컨텍스트 파일에서 10.0.0.1Context를 선언합니다.
<bean id="myHttpContext" factory-bean="httpContextFactory" factory-method="getObject"/>
  • 3. http URL에서 컨텍스트를 참조합니다.
<to uri="https://myhostname.com:443/myURL?httpContext=myHttpContext"/>

다른 SSLContextParameters 사용

HTTP 구성 요소는 구성 요소당 org.apache.camel.support.jsse.SSLContextParameters 인스턴스 하나만 지원합니다. 2개 이상의 인스턴스를 사용해야 하는 경우 다음과 같이 여러 HTTP 구성 요소를 설정해야 합니다. 2개의 구성 요소가 있는 경우 각각 sslContextParameters 속성의 자체 인스턴스를 사용합니다.

<bean id="http-foo" class="org.apache.camel.component.http.HttpComponent">
   <property name="sslContextParameters" ref="sslContextParams1"/>
   <property name="x509HostnameVerifier" ref="hostnameVerifier"/>
</bean>

<bean id="http-bar" class="org.apache.camel.component.http.HttpComponent">
   <property name="sslContextParameters" ref="sslContextParams2"/>
   <property name="x509HostnameVerifier" ref="hostnameVerifier"/>
</bean>

23.21. Spring Boot Auto-Configuration

Spring Boot와 함께 http를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-http-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

구성 요소는 아래에 나열된 38개의 옵션을 지원합니다.

이름설명Default유형

camel.component.http.allow-java-serialized-object

요청이 context-type=application/x-java-serialized-object를 사용할 때 Java 직렬화를 허용할지 여부입니다. 이는 기본적으로 해제되어 있습니다. 이를 활성화하면 Java가 요청에서 Java로 들어오는 데이터를 역직렬화하고 잠재적 보안 위험이 될 수 있음을 알고 있습니다.

false

부울

camel.component.http.auth-caching-disabled

인증 체계 캐싱을 비활성화합니다.

false

부울

camel.component.http.automatic-retries-disabled

자동 요청 복구 및 재실행을 비활성화합니다.

false

부울

camel.component.http.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.http.client-connection-manager

사용자 지정 및 공유 10.0.0.1ClientConnectionManager를 사용하여 연결을 관리합니다. 이 값을 구성한 경우 항상 이 구성 요소에서 생성한 모든 엔드포인트에 사용됩니다. 옵션은 org.apache.http.conn.HttpClientConnectionManager 유형입니다.

 

HttpClientConnectionManager

camel.component.http.connect-timeout

연결이 설정될 때까지 제한 시간(밀리초)을 결정합니다. 시간 제한 값이 0은 무한 타임아웃으로 해석됩니다. 시간 제한 값이 0은 무한 타임아웃으로 해석됩니다. 음수 값은 정의되지 않은(시스템 기본값)으로 해석됩니다.

-1

정수

camel.component.http.connection-request-timeout

연결 관리자에서 연결을 요청할 때 사용되는 시간(밀리초)입니다. 시간 제한 값이 0은 무한 타임아웃으로 해석됩니다. 시간 제한 값이 0은 무한 타임아웃으로 해석됩니다. 음수 값은 정의되지 않은(시스템 기본값)으로 해석됩니다.

-1

정수

camel.component.http.connection-state-disabled

연결 상태 추적을 비활성화합니다.

false

부울

camel.component.http.connection-time-to-live

라이브 연결 시간, 시간 단위는 밀리초이며, 기본값은 항상 활성 상태를 유지합니다.

 

long

camel.component.http.connections-per-route

경로당 최대 연결 수입니다.

20

정수

camel.component.http.content-compression-disabled

자동 콘텐츠 압축을 비활성화합니다.

false

부울

camel.component.http.cookie-management-disabled

상태(cookie) 관리를 비활성화합니다.

false

부울

camel.component.http.cookie-store

사용자 지정 org.apache.http.client.CookieStore를 사용합니다. 기본적으로 org.apache.http.impl.client.BasicCookieStore가 사용되는 메모리 내 쿠키 저장소입니다. bridgeEndpoint=true인 경우 쿠키 저장소가 noop 쿠키 저장소가 되도록 하려면 쿠키 저장소가 브리징(예: 프록시 역할을 함)이므로 저장해서는 안 됩니다. 옵션은 org.apache.http.client.CookieStore 유형입니다.

 

CookieStore

camel.component.http.copy-headers

이 옵션이 true이면 IN 교환 헤더가 복사 전략에 따라 OUT 교환 헤더로 복사됩니다. 이 값을 false로 설정하면 HTTP 응답의 헤더만 포함할 수 있습니다( IN 헤더를 전파하지 않음).

true

부울

camel.component.http.default-user-agent-disabled

사용자가 제공하지 않은 경우 이 빌더에서 설정한 기본 사용자 에이전트를 비활성화합니다.

false

부울

camel.component.http.enabled

http 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.http.header-filter-strategy

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지와 헤더를 필터링합니다. 옵션은 org.apache.camel.spi.HeaderFilterStrategy 유형입니다.

 

HeaderFilterStrategy

camel.component.http.http-binding

사용자 지정>-<Binding을 사용하여 Camel 메시지와 10.0.0.1Client 간 매핑을 제어하려면 다음을 수행합니다. 옵션은 org.apache.camel.http.common.HttpBinding 유형입니다.

 

HttpBinding

camel.component.http.http-client-configurer

사용자 지정>-<ClientConfigurer를 사용하여 사용할 10.0.0.1Client의 구성을 수행합니다. 옵션은 org.apache.camel.component.http.HttpClientConfigurer 유형입니다.

 

HttpClientConfigurer

camel.component.http.http-configuration

공유 10.0.0.1Configuration을 기본 구성으로 사용하려면 다음을 수행합니다. 옵션은 org.apache.camel.http.common.HttpConfiguration 유형입니다.

 

HttpConfiguration

camel.component.http.http-context

요청을 실행할 때 사용자 지정 org.apache.http.protocol.HttpContext를 사용합니다. 옵션은 org.apache.http.protocol.HttpContext 유형입니다.

 

HttpContext

camel.component.http.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.http.max-total-connections

최대 연결 수입니다.

200

정수

camel.component.http.proxy-auth-domain

사용할 프록시 인증 도메인입니다.

 

문자열

camel.component.http.proxy-auth-host

프록시 인증 호스트

 

문자열

camel.component.http.proxy-auth-method

사용할 프록시 인증 방법입니다.

 

문자열

camel.component.http.proxy-auth-nt-host

NTML과 함께 사용할 프록시 인증 도메인(workstation 이름)입니다.

 

문자열

camel.component.http.proxy-auth-password

프록시 인증 암호입니다.

 

문자열

camel.component.http.proxy-auth-port

프록시 인증 포트입니다.

 

정수

camel.component.http.proxy-auth-username

프록시 인증 사용자 이름.

 

문자열

camel.component.http.redirect-handling-disabled

자동 리디렉션 처리를 비활성화합니다.

false

부울

camel.component.http.response-payload-streaming-threshold

이 임계값(바이트)의 임계값은 응답 페이로드를 바이트 배열로 메모리에 저장할지 또는 스트리밍할지 여부를 제어합니다. 항상 스트리밍 모드를 사용하려면 이 값을 -1로 설정합니다.

8192

정수

camel.component.http.skip-request-headers

모든 Camel 헤더를 HTTP 요청 헤더로 매핑할지 여부를 건너뜁니다. HTTP 요청에 Camel 헤더의 데이터를 포함할 필요가 없는 경우 JVM 가비지 수집기에 대한 많은 오브젝트 할당으로 오버헤드를 구문 분석할 수 있습니다.

false

부울

camel.component.http.skip-response-headers

모든 HTTP 응답 헤더를 Camel 헤더에 매핑할지 여부를 건너뜁니다. HTTP 헤더에 필요한 데이터가 없는 경우 JVM 가비지 수집기에 대한 많은 개체 할당을 사용하여 오버헤드를 구문 분석하지 못할 수 있습니다.

false

부울

camel.component.http.socket-timeout

데이터 대기 시간 초과 시간(밀리초)을 정의합니다. 이는 연속된 두 데이터 패킷 간 최대 비활성 기간을 다르게 배치합니다. 시간 제한 값이 0은 무한 타임아웃으로 해석됩니다. 음수 값은 정의되지 않은(시스템 기본값)으로 해석됩니다.

-1

정수

camel.component.http.ssl-context-parameters

SSLContextParameters를 사용하여 보안을 구성하려면 다음을 수행합니다. 중요: org.apache.camel.support.jsse.SSLContextParameters 인스턴스 한 개만 iPXEComponent에 따라 지원됩니다. 2개 이상의 서로 다른 인스턴스를 사용해야 하는 경우 필요한 인스턴스당 새 10.0.0.1Component를 정의해야 합니다. 옵션은 org.apache.camel.support.jsse.SSLContextParameters 유형입니다.

 

SSLContextParameters

camel.component.http.use-global-ssl-context-parameters

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

부울

camel.component.http.x509-hostname-verifier

DefaultHostnameVerifier 또는 NoopHostnameVerifier와 같은 사용자 정의 X509HostnameVerifier를 사용하려면 다음을 수행하십시오. 옵션은 javax.net.ssl.HostnameVerifier 유형입니다.

 

HostnameVerifier

24장. Infinispan

생산자 및 소비자 모두 지원

이 구성 요소를 사용하면 Hot Rod procol을 사용하여 Infinispan 분산 데이터 그리드/캐시 캐시와 상호 작용할 수 있습니다. Infinispan은 Java로 작성된 확장성이 뛰어난 고가용성 키/값 데이터 저장소 및 데이터 그리드 플랫폼입니다.

Maven을 사용하는 경우 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-infinispan</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

24.1. URI 형식

infinispan://cacheName?[options]

생산자는 HotRod 프로토콜을 사용하여 원격 캐시로 메시지를 보낼 수 있습니다. 소비자는 HotRod 프로토콜을 사용하여 원격 캐시의 이벤트를 수신할 수 있습니다.

24.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

24.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

24.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

24.3. 구성 요소 옵션

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

이름설명Default유형

구성 (공용)

구성 요소 구성입니다.

 

InfinispanRemoteConfiguration

호스트 (공용)

Infinispan 인스턴스의 캐시 호스트를 지정합니다.

 

문자열

queryBuilder (common)

쿼리 빌더를 지정합니다.

 

InfinispanQueryBuilder

보안 (공용)

보안 Infinispan 인스턴스에 연결 중인지 정의합니다.

false

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

customListener (consumer)

제공되는 경우 사용 중인 사용자 정의 리스너를 반환합니다.

 

InfinispanRemoteCustomListener

eventTypes (consumer)

consumer.Multiple 이벤트를 쉼표로 구분할 수 있는 이벤트 유형 집합을 지정합니다. 가능한 이벤트 유형은 CLIENT_CACHE_ENTRY_CREATED, CLIENT_CACHE_ENTRY_MODIFIED, CLIENT_CACHE_ENTRY_REMOVED, CLIENT_CACHE_ENTRY_EXPIRED, CLIENT_CACHE_FAILOVER입니다.

 

문자열

defaultValue (producer)

일부 생산자 작업에 특정 기본값을 설정합니다.

 

개체

(producer)

생산자 작업에 대한 특정 키를 설정합니다.

 

개체

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

oldValue (producer)

일부 생산자 작업에 대해 특정 이전 값을 설정합니다.

 

개체

작업 (producer)

수행할 작업입니다.

CloudEvent 값:

  • PUT
  • PUTASYNC
  • PUTALL
  • PUTALLASYNC
  • PUTIFABSENT
  • PUTIFABSENTASYNC
  • GET
  • GETORDEFAULT
  • CONTAINSKEY
  • CONTAINSVALUE
  • REMOVE
  • REMOVEASYNC
  • REPLACE
  • REPLACEASYNC
  • 크기
  • CLEAR
  • CLEARASYNC
  • QUERY
  • STATS
  • COMPUTE
  • COMPUTEASYNC

PUT

InfinispanOperation

(producer)

생산자 작업에 대한 특정 값을 설정합니다.

 

개체

암호 (보안)

infinispan 인스턴스에 액세스할 암호를 정의합니다.

 

문자열

saslMechanism ( security)

infinispan 인스턴스에 액세스할 SASL Mechanism을 정의합니다.

 

문자열

securityRealm ( security)

infinispan 인스턴스에 액세스할 보안 영역을 정의합니다.

 

문자열

securityServerName ( security)

infinispan 인스턴스에 액세스할 보안 서버 이름을 정의합니다.

 

문자열

사용자 이름 (보안)

infinispan 인스턴스에 액세스할 사용자 이름을 정의합니다.

 

문자열

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

cacheContainer (advanced)

Autowired 연결할 캐시 컨테이너를 지정합니다.

 

RemoteCacheManager

cacheContainerConfiguration (advanced)

CacheContainer 구성 자동 연결입니다. cacheContainer가 정의되지 않은 경우 사용됩니다.

 

설정

ConfigurationProperties (advanced)

CacheManager의 특정 속성을 구현합니다.

 

map

configurationUri (advanced)

CacheManager의 구현 특정 URI입니다.

 

문자열

플래그 (고급)

각 캐시 호출에 기본적으로 적용되는 org.infinispan.client.hotrod.Forwarded의 쉼표로 구분된 목록입니다.

 

문자열

remappingFunction (advanced)

컴퓨팅 작업에 사용할 특정 remappingFunction을 설정합니다.

 

BiFunction

resultHeader (advanced)

메시지 본문 대신 작업 결과를 헤더에 저장합니다. 기본적으로 resultHeader == null 및 쿼리 결과는 메시지 본문에 저장되고 메시지 본문의 기존 콘텐츠가 삭제됩니다. resultHeader가 설정된 경우 값은 쿼리 결과를 저장하기 위해 헤더 이름으로 사용되며 원래 메시지 본문은 보존됩니다. 이 값은 CamelInfinispanOperationResultHeader라는 메시지 헤더로 덮어쓸 수 있습니다.

 

문자열

24.4. 끝점 옵션

Infinispan 엔드포인트는 URI 구문을 사용하여 구성됩니다.

infinispan:cacheName

다음과 같은 경로 및 쿼리 매개변수 사용:

24.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

cacheName (common)

사용할 캐시의 이름입니다. 현재 구성된 캐시된 관리자의 기존 캐시 이름을 사용하려면 current를 사용합니다. 또는 기본 캐시 관리자 이름에 기본값을 사용합니다.

 

문자열

24.4.2. 쿼리 매개변수(26 매개변수)

이름설명Default유형

호스트 (공용)

Infinispan 인스턴스의 캐시 호스트를 지정합니다.

 

문자열

queryBuilder (common)

쿼리 빌더를 지정합니다.

 

InfinispanQueryBuilder

보안 (공용)

보안 Infinispan 인스턴스에 연결 중인지 정의합니다.

false

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

customListener (consumer)

제공되는 경우 사용 중인 사용자 정의 리스너를 반환합니다.

 

InfinispanRemoteCustomListener

eventTypes (consumer)

consumer.Multiple 이벤트를 쉼표로 구분할 수 있는 이벤트 유형 집합을 지정합니다. 가능한 이벤트 유형은 CLIENT_CACHE_ENTRY_CREATED, CLIENT_CACHE_ENTRY_MODIFIED, CLIENT_CACHE_ENTRY_REMOVED, CLIENT_CACHE_ENTRY_EXPIRED, CLIENT_CACHE_FAILOVER입니다.

 

문자열

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

defaultValue (producer)

일부 생산자 작업에 특정 기본값을 설정합니다.

 

개체

(producer)

생산자 작업에 대한 특정 키를 설정합니다.

 

개체

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

oldValue (producer)

일부 생산자 작업에 대해 특정 이전 값을 설정합니다.

 

개체

작업 (producer)

수행할 작업입니다.

CloudEvent 값:

  • PUT
  • PUTASYNC
  • PUTALL
  • PUTALLASYNC
  • PUTIFABSENT
  • PUTIFABSENTASYNC
  • GET
  • GETORDEFAULT
  • CONTAINSKEY
  • CONTAINSVALUE
  • REMOVE
  • REMOVEASYNC
  • REPLACE
  • REPLACEASYNC
  • 크기
  • CLEAR
  • CLEARASYNC
  • QUERY
  • STATS
  • COMPUTE
  • COMPUTEASYNC

PUT

InfinispanOperation

(producer)

생산자 작업에 대한 특정 값을 설정합니다.

 

개체

암호 (보안)

infinispan 인스턴스에 액세스할 암호를 정의합니다.

 

문자열

saslMechanism ( security)

infinispan 인스턴스에 액세스할 SASL Mechanism을 정의합니다.

 

문자열

securityRealm ( security)

infinispan 인스턴스에 액세스할 보안 영역을 정의합니다.

 

문자열

securityServerName ( security)

infinispan 인스턴스에 액세스할 보안 서버 이름을 정의합니다.

 

문자열

사용자 이름 (보안)

infinispan 인스턴스에 액세스할 사용자 이름을 정의합니다.

 

문자열

cacheContainer (advanced)

Autowired 연결할 캐시 컨테이너를 지정합니다.

 

RemoteCacheManager

cacheContainerConfiguration (advanced)

CacheContainer 구성 자동 연결입니다. cacheContainer가 정의되지 않은 경우 사용됩니다.

 

설정

ConfigurationProperties (advanced)

CacheManager의 특정 속성을 구현합니다.

 

map

configurationUri (advanced)

CacheManager의 구현 특정 URI입니다.

 

문자열

플래그 (고급)

각 캐시 호출에 기본적으로 적용되는 org.infinispan.client.hotrod.Forwarded의 쉼표로 구분된 목록입니다.

 

문자열

remappingFunction (advanced)

컴퓨팅 작업에 사용할 특정 remappingFunction을 설정합니다.

 

BiFunction

resultHeader (advanced)

메시지 본문 대신 작업 결과를 헤더에 저장합니다. 기본적으로 resultHeader == null 및 쿼리 결과는 메시지 본문에 저장되고 메시지 본문의 기존 콘텐츠가 삭제됩니다. resultHeader가 설정된 경우 값은 쿼리 결과를 저장하기 위해 헤더 이름으로 사용되며 원래 메시지 본문은 보존됩니다. 이 값은 CamelInfinispanOperationResultHeader라는 메시지 헤더로 덮어쓸 수 있습니다.

 

문자열

24.5. Camel Operations

이 섹션에는 사용 가능한 모든 작업이 해당 헤더 정보와 함께 나열됩니다.

표 24.1. 표 1. 작업 배치

작업 이름설명

InfinispanOperation.PUT

만료를 사용하여 선택적으로 캐시에 키/값 쌍을 배치합니다.

InfinispanOperation.PUTASYNC

캐시에 키/값 쌍을 비동기식으로 배치합니다(선택 사항: 만료됨).

InfinispanOperation.PUTIFABSENT

인증서가 존재하지 않는 경우 캐시에 키/값 쌍을 저장(선택 사항)

InfinispanOperation.PUTIFABSENTASYNC

캐시에 키가 없는 경우 필요에 따라 만료되는 키/값 쌍을 비동기식으로 배치합니다.

  • 필수 헤더:

    • CamelInfinispanKey
    • CamelInfinispanValue
  • 선택적 헤더:

    • CamelInfinispanLifespanTime
    • CamelInfinispanLifespanTimeUnit
    • CamelInfinispanMaxIdleTime
    • CamelInfinispanMaxIdleTimeUnit
  • 결과 헤더:

    • CamelInfinispanOperationResult

표 24.2. 테이블 2. 모든 작업 배치

작업 이름설명

InfinispanOperation.PUTALL

만료를 사용하여 선택적으로 캐시에 여러 항목을 추가합니다.

CamelInfinispanOperation.PUTALLASYNC

필요에 따라 만료와 함께 여러 항목을 캐시에 비동기식으로 추가합니다.

  • 필수 헤더:

    • CamelInfinispanMap
  • 선택적 헤더:

    • CamelInfinispanLifespanTime
    • CamelInfinispanLifespanTimeUnit
    • CamelInfinispanMaxIdleTime
    • CamelInfinispanMaxIdleTimeUnit

표 24.3. 테이블 3. 작업 가져오기

작업 이름설명

InfinispanOperation.GET

캐시에서 특정 키와 관련된 값을 검색합니다.

InfinispanOperation.GETORDEFAULT

캐시에서 특정 키와 연결된 값 또는 기본값을 검색합니다.

  • 필수 헤더:

    • CamelInfinispanKey

표 24.4. 테이블 4. 키 작업 포함

작업 이름설명

InfinispanOperation.CONTAINSKEY

캐시에 특정 키가 포함되어 있는지 여부 확인

  • 필수 헤더

    • CamelInfinispanKey
  • 결과 헤더

    • CamelInfinispanOperationResult

표 24.5. 테이블 5. 값 작업 포함

작업 이름설명

InfinispanOperation.CONTAINSVALUE

캐시에 특정 값이 포함되어 있는지 여부 확인

  • 필수 헤더:

    • CamelInfinispanKey

표 24.6. 테이블 6. 작업 제거

작업 이름설명

InfinispanOperation.REMOVE

캐시에서 항목을 제거합니다. 선택적으로 값이 지정된 값과 일치하는 경우에만

InfinispanOperation.REMOVEASYNC

비동기식으로 캐시에서 항목을 제거합니다. 선택적으로 값이 지정된 값과 일치하는 경우에만

  • 필수 헤더:

    • CamelInfinispanKey
  • 선택적 헤더:

    • CamelInfinispanValue
  • 결과 헤더:

    • CamelInfinispanOperationResult

표 24.7. 테이블 7. 작업 교체

작업 이름설명

InfinispanOperation.REPLACE

캐시의 항목을 조건부로 바꾸고 선택적으로 만료로 교체

InfinispanOperation.REPLACEASYNC

캐시의 항목을 비동기적으로 조건부로 대체(선택사항: 만료됨)

  • 필수 헤더:

    • CamelInfinispanKey
    • CamelInfinispanValue
    • CamelInfinispanOldValue
  • 선택적 헤더:

    • CamelInfinispanLifespanTime
    • CamelInfinispanLifespanTimeUnit
    • CamelInfinispanMaxIdleTime
    • CamelInfinispanMaxIdleTimeUnit
  • 결과 헤더:

    • CamelInfinispanOperationResult

표 24.8. 테이블 8. 명확한 작업

작업 이름설명

InfinispanOperation.CLEAR

캐시를 지웁니다.

InfinispanOperation.CLEARASYNC

캐시 비동기식 지웁니다.

표 24.9. 테이블 9. 크기 작업

작업 이름설명

InfinispanOperation.SIZE

캐시의 항목 수를 반환합니다.

  • 결과 헤더

    • CamelInfinispanOperationResult

표 24.10. 테이블 10. 통계 작업

작업 이름설명

InfinispanOperation.STATS

캐시에 대한 통계를 반환합니다.

  • 결과 헤더:

    • CamelInfinispanOperationResult

표 24.11. 표 11. 쿼리 작업

작업 이름설명

InfinispanOperation.QUERY

캐시에서 쿼리 실행

  • 필수 헤더:

    • CamelInfinispanQueryBuilder
  • 결과 헤더:

    • CamelInfinispanOperationResult
참고

put(key, value) 및 remove(key)와 같은 쓰기 메서드에서는 기본적으로 이전 값을 반환하지 않습니다.

24.6. 메시지 헤더

이름기본값유형context설명

CamelInfinispanCacheName

null

문자열

shared

작업 또는 이벤트에 참여하는 캐시입니다.

CamelInfinispanOperation

PUT

InfinispanOperation

프로듀서

수행할 작업입니다.

CamelInfinispanMap

null

map

프로듀서

CamelInfinispanOperationPutAll 작업 시 사용할 맵

CamelInfinispanKey

null

개체

shared

이벤트를 생성하는 키 또는 작업에 대한 작업을 수행하는 키입니다.

CamelInfinispanValue

null

개체

프로듀서

작업에 사용할 값입니다.

CamelInfinispanEventType

null

문자열

소비자

수신된 이벤트의 유형입니다.

CamelInfinispanLifespanTime

null

long

프로듀서

캐시 내부의 값의 Lifespan 시간입니다. 음수 값은 무한으로 해석됩니다.

CamelInfinispanTimeUnit

null

문자열

프로듀서

항목 Lifespan Time의 시간 단위입니다.

CamelInfinispanMaxIdleTime

null

long

프로듀서

항목이 만료된 것으로 간주되기 전에 유휴 상태일 수 있는 최대 시간입니다.

CamelInfinispanMaxIdleTimeUnit

null

문자열

프로듀서

최대 유휴 시간 항목의 시간 단위입니다.

CamelInfinispanQueryBuilder

null

InfinispanQueryBuilder

프로듀서

QUERY 명령에 사용할 쿼리 빌드(기본값: InifinispanConfiguration's)

CamelInfinispanOperationResultHeader

null

문자열

프로듀서

메시지 본문이 아닌 헤더에 작업 결과를 저장

24.7. 예

  • 키/값을 이름이 지정된 캐시에 배치합니다.

    from("direct:start")
        .setHeader(InfinispanConstants.OPERATION).constant(InfinispanOperation.PUT) (1)
        .setHeader(InfinispanConstants.KEY).constant("123") (2)
        .to("infinispan:myCacheName&cacheContainer=#cacheContainer"); (3)

    여기서,

  • 1 - 수행할 작업 설정
  • 2 - 캐시에서 요소를 식별하는 데 사용되는 키 설정
  • 3 - 레지스트리에서 구성된 캐시 관리자 cacheContainer 를 사용하여 요소를 myCacheName이라는 캐시에 배치

    항목이 만료되고 캐시에서 제거되기 전에 수명 및/또는 유휴 시간을 구성할 수 있습니다. 예를 들면 다음과 같습니다.

    from("direct:start")
        .setHeader(InfinispanConstants.OPERATION).constant(InfinispanOperation.GET)
        .setHeader(InfinispanConstants.KEY).constant("123")
        .setHeader(InfinispanConstants.LIFESPAN_TIME).constant(100L) (1)
        .setHeader(InfinispanConstants.LIFESPAN_TIME_UNIT.constant(TimeUnit.MILLISECONDS.toString()) (2)
        .to("infinispan:myCacheName");

여기서,

  • 1 - 항목의 수명을 설정합니다.
  • 2 - 수명 기간의 시간 단위 설정

쿼리

from("direct:start")
    .setHeader(InfinispanConstants.OPERATION, InfinispanConstants.QUERY)
    .setHeader(InfinispanConstants.QUERY_BUILDER, new InfinispanQueryBuilder() {
        @Override
        public Query build(QueryFactory<Query> qf) {
            return qf.from(User.class).having("name").like("%abc%").build();
        }
    })
    .to("infinispan:myCacheName?cacheContainer=#cacheManager") ;

참고

도메인 오브젝트에 대한 .proto 설명자는 원격 Data Grid 서버에 등록해야 합니다. 공식 Infinispan 설명서의 원격 쿼리 예제 를 참조하십시오.

사용자 정의 청취자

from("infinispan://?cacheContainer=#cacheManager&customListener=#myCustomListener")
  .to("mock:result");

myCustomListener 인스턴스가 있어야 하며 Camel은 레지스트리에서 검색할 수 있어야 합니다. 사용자는 org.apache.camel.component.infinispan.remote.InfinispanRemoteCustomListener 클래스를 확장하고 패키지 org.infinispan.client.hotrod.annotation 에서 찾을 수 있는 @ClientListener 로 결과 클래스에 주석을 달 것을 권장합니다.

24.8. Infinispan 기반 idempotent 리포지토리 사용

이 섹션에서는 Infinispan 기반 idempotent 리포지토리를 사용합니다.

Java 예

InfinispanRemoteConfiguration conf = new InfinispanRemoteConfiguration(); (1)
conf.setHosts("localhost:1122")

InfinispanRemoteIdempotentRepository repo = new InfinispanRemoteIdempotentRepository("idempotent");  (2)
repo.setConfiguration(conf);

context.addRoutes(new RouteBuilder() {
    @Override
    public void configure() {
        from("direct:start")
            .idempotentConsumer(header("MessageID"), repo) (3)
            .to("mock:result");
    }
});

여기서,

  • 1 - 캐시 구성
  • 2 - 리포지토리 빈 구성
  • 3 - 리포지터리를 경로로 설정

XML 예

<bean id="infinispanRepo" class="org.apache.camel.component.infinispan.remote.InfinispanRemoteIdempotentRepository" destroy-method="stop">
  <constructor-arg value="idempotent"/> (1)
  <property name="configuration"> (2)
    <bean class="org.apache.camel.component.infinispan.remote.InfinispanRemoteConfiguration">
      <property name="hosts" value="localhost:11222"/>
    </bean>
  </property>
</bean>

<camelContext xmlns="http://camel.apache.org/schema/spring">
    <route>
        <from uri="direct:start" />
        <idempotentConsumer messageIdRepositoryRef="infinispanRepo"> (3)
            <header>MessageID</header>
            <to uri="mock:result" />
        </idempotentConsumer>
    </route>
</camelContext>

여기서,

  • 1 - 리포지터리에서 사용할 캐시의 이름을 설정합니다.
  • 2 - 리포지토리 빈 구성
  • 3 - 리포지터리를 경로로 설정

24.9. Infinispan 기반 집계 리포지토리 사용

이 섹션에서는 Infinispan 기반 집계 리포지토리를 사용할 것입니다.

Java 예

InfinispanRemoteConfiguration conf = new InfinispanRemoteConfiguration(); (1)
conf.setHosts("localhost:1122")

InfinispanRemoteAggregationRepository repo = new InfinispanRemoteAggregationRepository();  (2)
repo.setCacheName("aggregation");
repo.setConfiguration(conf);

context.addRoutes(new RouteBuilder() {
    @Override
    public void configure() {
        from("direct:start")
                .aggregate(header("MessageID"))
                .completionSize(3)
                .aggregationRepository(repo) (3)
                .aggregationStrategyRef("myStrategy")
                .to("mock:result");
    }
});

여기서,

  • 1 - 캐시 구성
  • 2 - 리포지토리 빈 생성
  • 3 - 리포지터리를 경로로 설정

XML 예

<bean id="infinispanRepo" class="org.apache.camel.component.infinispan.remote.InfinispanRemoteAggregationRepository" destroy-method="stop">
  <constructor-arg value="aggregation"/> (1)
  <property name="configuration"> (2)
    <bean class="org.apache.camel.component.infinispan.remote.InfinispanRemoteConfiguration">
      <property name="hosts" value="localhost:11222"/>
    </bean>
  </property>
</bean>

<camelContext xmlns="http://camel.apache.org/schema/spring">
    <route>
        <from uri="direct:start" />
        <aggregate strategyRef="myStrategy"
                   completionSize="3"
                   aggregationRepositoryRef="infinispanRepo"> (3)
            <correlationExpression>
                <header>MessageID</header>
            </correlationExpression>
            <to uri="mock:result"/>
        </aggregate>
    </route>
</camelContext>

여기서,

  • 1 - 리포지터리에서 사용할 캐시의 이름을 설정합니다.
  • 2 - 리포지토리 빈 구성
  • 3 - 리포지터리를 경로로 설정
참고

Infinispan 11이 릴리스되면 생성된 모든 캐시에 인코딩 구성을 설정해야 합니다. 이는 또한 이벤트를 활용하는 데도 중요합니다. 자세한 내용은 공식 Infinispan 설명서의 Data Encoding 및 MediaTypes 를 참조하십시오.

24.10. Spring Boot Auto-Configuration

Spring Boot와 함께 infinispan을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-infinispan-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.infinispan.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.infinispan.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.infinispan.cache-container

연결할 캐시 컨테이너를 지정합니다. 옵션은 org.infinispan.client.hotrod.RemoteCacheManager 유형입니다.

 

RemoteCacheManager

camel.component.infinispan.cache-container-configuration

CacheContainer 구성입니다. cacheContainer가 정의되지 않은 경우 사용됩니다. 옵션은 org.infinispan.client.hotrod.configuration.Configuration 유형입니다.

 

설정

camel.component.infinispan.configuration

구성 요소 구성입니다. 옵션은 org.apache.camel.component.infinispan.remote.InfinispanRemoteConfiguration 유형입니다.

 

InfinispanRemoteConfiguration

camel.component.infinispan.configuration-properties

CacheManager의 특정 속성을 구현합니다.

 

map

camel.component.infinispan.configuration-uri

CacheManager의 구현 특정 URI입니다.

 

문자열

camel.component.infinispan.custom-listener

제공되는 경우 사용 중인 사용자 정의 리스너를 반환합니다. 옵션은 org.apache.camel.component.infinispan.remote.InfinispanRemoteCustomListener 유형입니다.

 

InfinispanRemoteCustomListener

camel.component.infinispan.enabled

infinispan 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.infinispan.event-types

consumer.Multiple 이벤트를 쉼표로 구분할 수 있는 이벤트 유형 집합을 지정합니다. 가능한 이벤트 유형은 CLIENT_CACHE_ENTRY_CREATED, CLIENT_CACHE_ENTRY_MODIFIED, CLIENT_CACHE_ENTRY_REMOVED, CLIENT_CACHE_ENTRY_EXPIRED, CLIENT_CACHE_FAILOVER입니다.

 

문자열

camel.component.infinispan.flags

각 캐시 호출에 기본적으로 적용되는 org.infinispan.client.hotrod.Forwarded의 쉼표로 구분된 목록입니다.

 

문자열

camel.component.infinispan.hosts

Infinispan 인스턴스의 캐시 호스트를 지정합니다.

 

문자열

camel.component.infinispan.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.infinispan.operation

수행할 작업입니다.

 

InfinispanOperation

camel.component.infinispan.password

infinispan 인스턴스에 액세스할 암호를 정의합니다.

 

문자열

camel.component.infinispan.query-builder

쿼리 빌더를 지정합니다. 옵션은 org.apache.camel.component.infinispan.InfinispanQueryBuilder 유형입니다.

 

InfinispanQueryBuilder

camel.component.infinispan.remapping-function

컴퓨팅 작업에 사용할 특정 remappingFunction을 설정합니다. 옵션은 java.util.function.BiFunction 유형입니다.

 

BiFunction

camel.component.infinispan.result-header

메시지 본문 대신 작업 결과를 헤더에 저장합니다. 기본적으로 resultHeader == null 및 쿼리 결과는 메시지 본문에 저장되고 메시지 본문의 기존 콘텐츠가 삭제됩니다. resultHeader가 설정된 경우 값은 쿼리 결과를 저장하기 위해 헤더 이름으로 사용되며 원래 메시지 본문은 보존됩니다. 이 값은 CamelInfinispanOperationResultHeader라는 메시지 헤더로 덮어쓸 수 있습니다.

 

문자열

camel.component.infinispan.sasl-mechanism

infinispan 인스턴스에 액세스할 SASL Mechanism을 정의합니다.

 

문자열

camel.component.infinispan.secure

보안 Infinispan 인스턴스에 연결 중인지 정의합니다.

false

부울

camel.component.infinispan.security-realm

infinispan 인스턴스에 액세스할 보안 영역을 정의합니다.

 

문자열

camel.component.infinispan.security-server-name

infinispan 인스턴스에 액세스할 보안 서버 이름을 정의합니다.

 

문자열

camel.component.infinispan.username

infinispan 인스턴스에 액세스할 사용자 이름을 정의합니다.

 

문자열

25장. Jira

생산자 및 소비자 모두 지원

JIRA 구성 요소는 JIRA 용 Atlassian의 REST Java 클라이언트를 캡슐화하여 JIRA API와 상호 작용합니다. 현재 새로운 문제 및 새 댓글에 대한 폴링을 제공합니다. 또한 새로운 문제를 생성하고, 코멘트를 추가하고, 문제를 변경하고, 감시자를 추가하며, 첨부 파일을 추가하고, 문제 상태를 전환할 수 있습니다.

이 끝점은 웹 후크 대신 간단한 폴링에 의존합니다. 이유는 다음과 같습니다.

  • 신뢰성 / 안정성에 대한 우려
  • 일반적으로 폴링 중인 페이로드 유형이 크지 않습니다(API에서 페이징을 사용할 수 있음)
  • 웹 후크가 실패하는 경우 공개적으로 액세스할 수 없는 위치에서 실행되는 애플리케이션을 지원해야 합니다.

JIRA API는 상당히 확장입니다. 따라서 이 구성 요소는 추가 상호 작용을 제공하기 위해 쉽게 확장할 수 있습니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-jira</artifactId>
    <version>${camel-version}</version>
</dependency>

25.1. URI 형식

jira://type[?options]

Jira 유형은 다음 작업을 허용합니다.

사용자의 경우:

  • newIssues: 경로가 시작된 후 새 문제만 검색합니다.
  • newComments: 경로가 시작된 후 새 주석만 검색합니다.
  • watchUpdates: 제공된 jql을 기반으로 업데이트된 필드/issue만 검색합니다.

생산자의 경우:

  • addIssue: 문제 추가
  • AddComment: 지정된 문제에 대한 코멘트를 추가합니다.
  • attach: 지정된 문제에 대한 첨부 파일 추가
  • DeleteIssue: 지정된 문제 삭제
  • updateIssue: 지정된 문제의 필드를 업데이트
  • transitionIssue: 지정된 문제의 상태를 전환
  • 감시자: 지정된 문제의 감시자 추가/제거

Jira는 완전히 사용자 정의할 수 있으므로 서로 다른 Jira 서버 간에 변경될 수 있으므로 프로젝트 및 워크플로우에 대한 필드 ID가 있는지 확인해야 합니다.

25.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

25.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

25.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

25.3. 구성 요소 옵션

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

이름설명Default유형

지연 (공용)

다음 폴링을 위해 경과할 시간(밀리초)입니다.

6000

정수

jiraUrl (common)

필수 Jira 서버 URL 예: .

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

구성 (고급)

공유 기본 지라 설정을 사용하려면 다음을 수행합니다.

 

JiraConfiguration

accessToken (security)

(OAuth만 해당) Jira 서버에서 생성한 액세스 토큰입니다.

 

문자열

consumerKey (보안)

(OAuth 전용) Jira 설정의 소비자 키입니다.

 

문자열

암호 (보안)

(기본 인증만 해당) Jira 서버에 인증할 암호입니다. 사용자 이름 기본 인증이 사용되는 경우에만 사용합니다.

 

문자열

PrivateKey (보안)

(OAuth 만) 서버에 대화를 암호화하기 위해 클라이언트가 생성한 개인 키입니다.

 

문자열

사용자 이름 (보안)

(기본 인증만 해당) Jira 서버에 인증할 사용자 이름입니다. Jira 서버에서 OAuth가 활성화되지 않은 경우에만 사용합니다. 사용자 이름과 OAuth 토큰 매개 변수를 설정하지 마십시오. 둘 다 설정된 경우 사용자 이름 기본 인증이 우선합니다.

 

문자열

검증 코드 (보안)

(OAuth만 해당) Jira의 확인 코드는 권한 부여 절차의 첫 번째 단계에서 생성되었습니다.

 

문자열

25.4. 끝점 옵션

Jira 끝점은 URI 구문을 사용하여 구성됩니다.

jira:type

다음과 같은 경로 및 쿼리 매개변수 사용:

25.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

유형 (공용)

수행할 작업이 필요합니다. 소비자: NewIssues, NewComments. 생산자: AddIsue, AttachFile, DeleteIssue, TransitionIssue, UpdateIssue, Watchers. 자세한 내용은 이 클래스 javadoc 설명을 참조하십시오.

CloudEvent 값:

  • ADDCOMMENT
  • ADDISSUE
  • ATTACH
  • DELETEISSUE
  • NEWISSUES
  • NEWCOMMENTS
  • WATCHUPDATES
  • UPDATEISSUE
  • TRANSITIONISSUE
  • 감시자
  • ADDISSUELINK
  • ADDWORKLOG
  • FETCHISSUE
  • FETCHCOMMENTS
 

JiraType

25.4.2. 쿼리 매개변수 (16 매개변수)

이름설명Default유형

지연 (공용)

다음 폴링을 위해 경과할 시간(밀리초)입니다.

6000

정수

jiraUrl (common)

필수 Jira 서버 URL 예: .

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

jql (consumer)

JQL은 원하는 데이터를 검색할 수 있는 JIRA의 쿼리 언어입니다. 예를 들어 jql=project=MyProject Where MyProject는 JIRA의 제품 키입니다. RAW()를 사용하고 그 내부의 JQL을 설정하여 camel 구문 분석을 방지합니다(예: RAW(project in (MYP,COM) AND resolution = Unresolved).

 

문자열

maxresults (consumer)

검색할 최대 문제 수입니다.

50

정수

sendOnlyUpdatedField (consumer)

교환 본문 또는 문제 개체에서 변경된 필드만 전송하기 위한 표시기입니다. 기본적으로 소비자는 변경된 필드만 보냅니다.

true

boolean

watchedFields (consumer)

변경 사항을 조사할 쉼표로 구분된 필드 목록입니다. status,Priority가 기본값입니다.

상태,Priority

문자열

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

accessToken (security)

(OAuth만 해당) Jira 서버에서 생성한 액세스 토큰입니다.

 

문자열

consumerKey (보안)

(OAuth 전용) Jira 설정의 소비자 키입니다.

 

문자열

암호 (보안)

(기본 인증만 해당) Jira 서버에 인증할 암호입니다. 사용자 이름 기본 인증이 사용되는 경우에만 사용합니다.

 

문자열

PrivateKey (보안)

(OAuth 만) 서버에 대화를 암호화하기 위해 클라이언트가 생성한 개인 키입니다.

 

문자열

사용자 이름 (보안)

(기본 인증만 해당) Jira 서버에 인증할 사용자 이름입니다. Jira 서버에서 OAuth가 활성화되지 않은 경우에만 사용합니다. 사용자 이름과 OAuth 토큰 매개 변수를 설정하지 마십시오. 둘 다 설정된 경우 사용자 이름 기본 인증이 우선합니다.

 

문자열

검증 코드 (보안)

(OAuth만 해당) Jira의 확인 코드는 권한 부여 절차의 첫 번째 단계에서 생성되었습니다.

 

문자열

25.5. 클라이언트 10.0.0.1

Jira 끝점에 자동으로 설정되도록 레지스트리에서 JiraRestClientFactory 이름을 JiraRestClientFactory 로 바인딩할 수 있습니다.

25.6. 인증

Camel-jira는 기본 인증OAuth 3 승인 인증을 지원합니다.

사용자 및 시스템에 최상의 보안을 제공하므로 가능한 한 OAuth를 사용하는 것이 좋습니다.

25.6.1. 기본 인증 요구 사항:

  • 사용자 이름 및 암호

25.6.2. OAuth 인증 요구 사항:

Jira OAuth 설명서 의 튜토리얼에 따라 클라이언트 개인 키, 소비자 키, 확인 코드 및 액세스 토큰을 생성합니다.

  • 시스템에서 로컬로 생성된 개인 키입니다.
  • Jira 서버에서 생성한 확인 코드입니다.
  • Jira 서버 설정에 설정된 소비자 키입니다.
  • Jira 서버에서 생성한 액세스 토큰입니다.

25.7. JQL

JQL URI 옵션은 두 소비자 끝점에서 모두 사용합니다. 이론적으로 "프로젝트 키" 등과 같은 항목은 URI 옵션 자체 일 수 있습니다. 그러나 JQL 사용을 요구하면 소비자는 훨씬 더 유연하고 강력해집니다.

최소한 소비자는 다음을 필요로 합니다.

jira://[type]?[required options]&jql=project=[project key]

주목해야 할 한 가지 중요한 점은 newIssues 사용자가 JQL을 자동으로 다음과 같이 설정한다는 것입니다.

  • JQL 에ECDHE BY 키 추가
  • 앞의 id > latestIssueId 는 camel 경로가 시작된 후 추가된 문제를 검색합니다.

이는 프로젝트의 모든 단일 문제를 인덱싱해야 하는 대신 시작 처리를 최적화하기 위한 것입니다.

또 다른 참고 사항은 마찬가지로 newComments 소비자는 프로젝트에서 모든 단일 문제와 코멘트를 인덱싱해야 한다는 것입니다. 따라서 대규모 프로젝트의 경우 JQL 표현식을 최대한 최적화하는 것이 중요합니다. 예를 들어, JIRA Toolkit 플러그인에는 쿼리에 "여러 개의 댓글" 사용자 지정 필드간 '"number of comments" > 0'이 포함되어 있습니다. 또한 상태(status=Open)에 따라 최소화하여 폴링 지연을 늘립니다. 예제:

jira://[type]?[required options]&jql=RAW(project=[project key] AND status in (Open, \"Coding In Progress\") AND \"Number of comments\">0)"

25.8. 작업

Jira 작업을 사용할 때 설정할 헤더 목록을 참조하십시오. 생산자의 author 필드는 JIRA 측에서 인증된 사용자로 자동 설정됩니다.

필수 필드가 설정되지 않은 경우 IllegalArgumentException이 발생합니다.

issue type, priority, transition과 같은 필드에 id 가 필요한 작업이 있습니다. jira 설치 및 프로젝트 워크플로우에 따라 다를 수 있으므로 jira 프로젝트의 유효한 ID를 확인하십시오.

25.9. AddIssue

필수 항목:

선택 사항:

  • IssueAssignee: assignee 사용자
  • IssuePriorityId 또는 IssuePriorityName: 문제의 우선 순위는 http://jira_server/rest/api/2/priority 에서 유효한 목록을 볼 수 있습니다.
  • IssueComponents: 유효한 구성 요소 이름이 있는 문자열 목록입니다.
  • IssueWatchersAdd: 감시자 목록에 추가할 사용자 이름이 있는 문자열 목록입니다.
  • IssueDescription: 문제에 대한 설명입니다.

25.10. AddComment

필수 항목:

  • IssueKey: 문제 키 식별자입니다.
  • 교환의 본문은 설명입니다.

25.11. attach

호출당 하나의 파일만 첨부해야 합니다.

필수 항목:

  • IssueKey: 문제 키 식별자입니다.
  • 교환의 본문은 파일유형이어야 합니다.

25.12. DeleteIssue

필수 항목:

  • IssueKey: 문제 키 식별자입니다.

25.13. TransitionIsue

필수 항목:

  • IssueKey: 문제 키 식별자입니다.
  • IssueTransitionId: 문제 전환 ID 입니다.
  • 교환의 본문은 설명입니다.

25.14. UpdateIssue

  • IssueKey: 문제 키 식별자입니다.
  • IssueTypeId 또는 IssueTypeName: 문제 유형의 ID 또는 문제 유형의 이름은 http://jira_server/rest/api/2/issue/createmeta?projectKeys=SAMPLE_KEY 에서 유효한 목록을 확인할 수 있습니다.
  • IssueSummary: 문제의 요약입니다.
  • IssueAssignee: assignee 사용자
  • IssuePriorityId 또는 IssuePriorityName: 문제의 우선 순위는 http://jira_server/rest/api/2/priority 에서 유효한 목록을 볼 수 있습니다.
  • IssueComponents: 유효한 구성 요소 이름이 있는 문자열 목록입니다.
  • IssueDescription: 문제에 대한 설명입니다.

25.15. watcher

  • IssueKey: 문제 키 식별자입니다.
  • IssueWatchersAdd: 감시자 목록에 추가할 사용자 이름이 있는 문자열 목록입니다.
  • IssueWatchersRemove: 감시자 목록에서 제거할 사용자 이름이 있는 문자열 목록입니다.

25.16. WatchUpdates (consumer)

  • watchedFields Comma separated list of fields to watch for changes i.e Status,Priority,Assignee,Components etc.
  • sendOnlyUpdatedField 기본적으로 변경된 필드만 본문으로 전송됩니다.

모든 메시지에는 변경에 대한 추가 정보를 추가하는 다음 헤더도 포함됩니다.

  • issueKey: 업데이트된 문제의 키
  • changed: 업데이트된 필드의 이름 (i.e Status)
  • watchedIssues: 업데이트시 감시되는 모든 문제 키 목록

25.17. Spring Boot Auto-Configuration

Spring Boot와 함께 jira를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-jira-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

구성 요소는 아래에 나열된 13개의 옵션을 지원합니다.

이름설명Default유형

camel.component.jira.access-token

(OAuth만 해당) Jira 서버에서 생성한 액세스 토큰입니다.

 

문자열

camel.component.jira.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.jira.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.jira.configuration

공유 기본 지라 설정을 사용하려면 다음을 수행합니다. 옵션은 org.apache.camel.component.jira.JiraConfiguration 유형입니다.

 

JiraConfiguration

camel.component.jira.consumer-key

(OAuth 전용) Jira 설정의 소비자 키입니다.

 

문자열

camel.component.jira.delay

다음 폴링을 위해 경과할 시간(밀리초)입니다.

6000

정수

camel.component.jira.enabled

jira 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.jira.jira-url

Jira 서버 URL(예: http://my_jira.com:8081/).

 

문자열

camel.component.jira.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.jira.password

(기본 인증만 해당) Jira 서버에 인증할 암호입니다. 사용자 이름 기본 인증이 사용되는 경우에만 사용합니다.

 

문자열

camel.component.jira.private-key

(OAuth 만) 서버에 대화를 암호화하기 위해 클라이언트가 생성한 개인 키입니다.

 

문자열

camel.component.jira.username

(기본 인증만 해당) Jira 서버에 인증할 사용자 이름입니다. Jira 서버에서 OAuth가 활성화되지 않은 경우에만 사용합니다. 사용자 이름과 OAuth 토큰 매개 변수를 설정하지 마십시오. 둘 다 설정된 경우 사용자 이름 기본 인증이 우선합니다.

 

문자열

camel.component.jira.verification-code

(OAuth만 해당) Jira의 확인 코드는 권한 부여 절차의 첫 번째 단계에서 생성되었습니다.

 

문자열

26장. JMS

생산자 및 소비자 모두 지원

이 구성 요소를 사용하면 JMS Queue 또는 Topic으로 메시지를 보내거나(또는 사용)할 수 있습니다. 보낸 데 Spring의 JmsTemplate 및 사용할 MessageListenerContainer 를 포함하여 선언적 트랜잭션에 Spring의 JMS 지원을 사용합니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-jms</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>
참고

ActiveMQ
Apache ActiveMQ 를 사용하는 경우 ActiveMQ에 최적화되었으므로 ActiveMQ 구성 요소를 선호해야 합니다. 이 페이지의 모든 옵션과 샘플은 ActiveMQ 구성 요소에도 유효합니다.

참고


전송 및 캐싱
JMS 와 트랜잭션을 사용하는 경우 성능에 영향을 줄 수 있으므로 아래의 트랜잭션 및 캐시 수준을 확인합니다.

참고

Camel은 성능 및 클러스터형 환경에 대한다양한 옵션을 제공하므로 Camel에 대한 중요한 참고 사항을 보려면 이 페이지의 아래 JMS에 대한 Request-reply 섹션을 자세히 읽어 보십시오.

26.1. URI 형식

jms:[queue:|topic:]destinationName[?options]

destinationName 은 JMS 대기열 또는 주제 이름입니다. 기본적으로 destinationName 은 대기열 이름으로 해석됩니다. 예를 들어, 큐에 연결하려면 FOO.BAR 을 사용합니다.

jms:FOO.BAR

원하는 경우 선택적 queue: 접두사를 포함할 수 있습니다.

jms:queue:FOO.BAR

항목에 연결하려면 topic: 접두사를 포함해야 합니다. 예를 들어, topic, 10.0.0.1s .Prices 에 연결하려면 다음을 사용합니다.

jms:topic:Stocks.Prices

다음 형식을 사용하여 URI에 쿼리 옵션을 추가합니다.

?option=value&option=value&…​

26.1.1. ActiveMQ 사용

JMS 구성 요소는 메시지를 보내는 데 Spring 2의 JmsTemplate 을 재사용합니다. 이는 비J2EE 컨테이너에서 사용하기에 적합하지 않으며 일반적으로 성능 저하 를 방지하기 위해 JMS 공급자의 일부 캐싱이 필요합니다.

Apache ActiveMQ 를 메시지 브로커로 사용하려는 경우 다음 중 하나를 수행하는 것이 좋습니다.

  • ActiveMQ 구성 요소를 사용하는데 이미 최적화된 ActiveMQ 구성 요소 사용
  • ActiveMQ에서 PoolingConnectionFactory 를 사용합니다.

26.1.2. 트랜잭션 및 캐시 수준

메시지를 사용하고 트랜잭션(transacted=true)을 사용하는 경우 캐시 수준에 대한 기본 설정이 성능에 영향을 미칠 수 있습니다.

XA 트랜잭션을 사용하는 경우 XA 트랜잭션이 제대로 작동하지 않을 수 있으므로 캐시할 수 없습니다.

XA를 사용하지 않는 경우 cacheLevelName=CACHE_CONSUMER 설정과 같이 성능이 빨라지므로 캐싱을 고려해야 합니다.

cacheLevelName 의 기본 설정은 CACHE_AUTO 입니다. 이 기본 자동은 모드를 감지하고 그에 따라 캐시 수준을 설정합니다.

  • CACHE_CONSUMER if transacted=false
  • CACHE_NONE if transacted=true

따라서 기본 설정은 보수적이라고 할 수 있습니다. XA가 아닌 트랜잭션을 사용하는 경우 cacheLevelName=CACHE_CONSUMER 를 사용하는 것이 좋습니다.

26.1.3. 조정된 서브스크립션

지속성 주제 서브스크립션을 사용하려면 clientId 및 detect SubscriptionName 을 둘 다 지정해야 합니다. clientId 값은 고유해야 하며 전체 네트워크의 단일 JMS 연결 인스턴스에서만 사용할 수 있습니다. 이러한 제한을 피하기 위해 가상 주제를 대신 사용하는 것을 선호할 수 있습니다. 여기에서 중장성 메시지의 배경을 더 많이 볼 수 있습니다.

26.1.4. 메시지 헤더 매핑

메시지 헤더를 사용하는 경우 JMS 사양은 헤더 이름이 유효한 Java 식별자여야 함을 나타냅니다. 따라서 헤더의 이름을 유효한 Java 식별자로 지정합니다. 이 작업을 수행하는 한 가지 이점은 JMS 선택기 내에서 헤더를 사용할 수 있다는 것입니다(SQL92 구문에 헤더에 Java 식별자 구문이 필요한 경우).

헤더 이름을 매핑하기 위한 간단한 전략이 기본적으로 사용됩니다. 전략은 아래에 표시된 대로 헤더 이름의 점과 하이픈을 모두 교체하고 헤더 이름이 전선을 통해 전송된 JMS 메시지에서 복원될 때 교체를 되돌리는 것입니다. 이것은 무엇을 의미합니까? 더 이상 빈 구성 요소에서 호출할 메서드 이름 손실, 파일 구성 요소의 파일 이름 헤더가 손실되지 않습니다.

Camel에서 헤더 이름을 수락하는 현재 헤더 이름 전략은 다음과 같습니다.

  • 점을 'DOT' 로 교체하고 Camel이 메시지를 사용할 때 교체가 반전됩니다.
  • 하이픈이 'HYPHEN' 로 대체되고 Camel에서 메시지를 사용할 때 교체가 반전됩니다.

JMSConfiguration 개체의 속성에 매핑되는 JMS 끝점에서 다양한 속성을 구성할 수 있습니다.

참고

Spring JMS
이러한 속성 중 대다수는 Camel이 메시지를 전송 및 수신하는 데 사용하는 Spring JMS의 속성에 매핑
됩니다. 따라서 관련 Spring 문서를 참조하여 이러한 속성에 대한 자세한 정보를 얻을 수 있습니다.

26.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

26.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

26.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

26.3. 구성 요소 옵션

JMS 구성 요소는 아래에 나열된 98 옵션을 지원합니다.

이름설명Default유형

ClientID (common)

사용할 JMS 클라이언트 ID를 설정합니다. 이 값은 지정하는 경우 고유해야 하며 단일 JMS 연결 인스턴스에서만 사용할 수 있습니다. 일반적으로 지속성 주제 서브스크립션에만 필요합니다. Apache ActiveMQ를 사용하는 경우 대신 Virtual Topics를 사용할 수 있습니다.

 

문자열

ConnectionFactory (common)

사용할 연결 팩토리입니다. 연결 팩토리는 구성 요소 또는 끝점에서 구성해야 합니다.

 

ConnectionFactory

disableReplyTo (공용)

Camel이 메시지에서 JMSReplyTo 헤더를 무시하는지 여부를 지정합니다. true인 경우 Camel은 JMSReplyTo 헤더에 지정된 대상으로 회신을 다시 보내지 않습니다. Camel을 경로에서 사용하고 코드의 다른 구성 요소가 응답 메시지를 처리하므로 Camel이 응답 메시지를 자동으로 다시 전송하지 않도록 하려면 이 옵션을 사용할 수 있습니다. 다른 메시지 브로커 간의 프록시로 Camel을 사용하고 한 시스템에서 다른 시스템으로 메시지를 라우팅하려는 경우에도 이 옵션을 사용할 수 있습니다.

false

boolean

fluentdSubscriptionName (common)

해제된 주제 서브스크립션을 지정하기 위한 조정된 구독자 이름입니다. clientId 옵션도 구성해야 합니다.

 

문자열

jmsMessageType (common)

JMS 메시지를 전송하기 위해 특정 javax.jms.Message 구현을 강제로 사용할 수 있습니다. 가능한 값은 10.0.0.1s, Map, Object, Stream, text입니다. 기본적으로 Camel은 In body type에서 사용할 JMS 메시지 유형을 결정합니다. 이 옵션을 사용하면 지정할 수 있습니다.

CloudEvent 값:

  • 바이트
  • map
  • 개체
  • stream
  • text
 

JmsMessageType

replyTo (common)

명시적인 ReplyTo 대상을 제공합니다(sumJMSReplyTo() in consumer.getJMSReplyTo()의 수신 값 재정의).

 

문자열

testConnectionOnStartup (common)

시작 시 연결을 테스트할지 여부를 지정합니다. 이렇게 하면 Camel이 시작되면 모든 JMS 소비자가 JMS 브로커와 유효한 연결을 갖습니다. 연결을 부여할 수 없는 경우 Camel이 시작 시 예외를 발생시킵니다. 이렇게 하면 실패한 연결로 Camel이 시작되지 않습니다. JMS 생산자도 테스트됩니다.

false

boolean

acknowledgementModeName (consumer)

SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, AUTO_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE 중 하나인 JMS 승인 이름.

CloudEvent 값:

  • SESSION_TRANSACTED
  • CLIENT_ACKNOWLEDGE
  • AUTO_ACKNOWLEDGE
  • DUPS_OK_ACKNOWLEDGE

AUTO_ACKNOWLEDGE

문자열

artemisConsumerPriority (consumer)

소비자 우선 순위를 사용하면 높은 우선 순위의 소비자가 활성화된 동안 메시지를 수신하는지 확인할 수 있습니다. 일반적으로 큐에 연결된 활성 소비자는 라운드 로빈 방식으로 메시지를 수신합니다. 소비자 우선순위가 사용 중인 경우 여러 활성 사용자가 동일한 높은 우선 순위로 있는 경우 메시지가 라운드 로빈으로 전달됩니다. 높은 우선 순위의 소비자가 메시지를 사용하는 데 사용할 수 없는 경우 또는 높은 우선 순위의 소비자가 메시지를 수락하지 않은 경우(예: 소비자와 연결된 모든 선택기의 기준을 충족하지 않기 때문에 메시지는 우선 순위가 낮은 소비자만 사용하게 됩니다).

 

int

asyncConsumer (consumer)

JmsConsumer에서 교환을 비동기식으로 처리할지 여부입니다. 활성화하면 JmsConsumer가 JMS 대기열에서 다음 메시지를 선택할 수 있지만 이전 메시지는 비동기 라우팅 엔진에서 비동기적으로 처리됩니다. 즉, 메시지가 100% 엄격하게 처리되지 않을 수 있습니다. 비활성화 된 경우 (기본적으로) 교환은 JmsConsumer가 JMS 큐에서 다음 메시지를 선택하기 전에 완전히 처리됩니다. 트랜잭션이 활성화된 경우 트랜잭션을 동시에 실행해야 하므로 비동기식으로 asyncConsumer=true가 실행되지 않습니다(Camel 3.0에서 비동기 트랜잭션을 지원할 수 있음).

false

boolean

autoStartup (consumer)

소비자 컨테이너가 자동으로 시작되어야 하는지 여부를 지정합니다.

true

boolean

cacheLevel (consumer)

기본 JMS 리소스의 ID로 캐시 수준을 설정합니다. 자세한 내용은 cacheLevelName 옵션을 참조하십시오.

 

int

cacheLevelName (consumer)

기본 JMS 리소스에 대한 이름별로 캐시 수준을 설정합니다. 가능한 값은 CACHE_AUTO, CACHE_CONNECTION, CACHE_CONSUMER, CACHE_NONE 및 CACHE_SESSION입니다. 기본 설정은 CACHE_AUTO입니다. 자세한 내용은 Spring 문서 및 트랜잭션 캐시 수준을 참조하십시오.

CloudEvent 값:

  • CACHE_AUTO
  • CACHE_CONNECTION
  • CACHE_CONSUMER
  • CACHE_NONE
  • CACHE_SESSION

CACHE_AUTO

문자열

concurrentConsumers (consumer)

JMS에서 사용할 때 기본 동시 소비자 수를 지정합니다( JMS를 통해 요청/응답이 아님). 스레드의 동적 확장/다운을 제어하려면 maxMessagesPerTask 옵션도 참조하십시오. JMS를 통해 요청/응답을 수행할 때 replyToConcurrentConsumers 옵션은 응답 메시지 리스너에서 동시 소비자 수를 제어하는 데 사용됩니다.

1

int

maxConcurrentConsumers (consumer)

JMS에서 사용할 때 최대 동시 소비자 수를 지정합니다( JMS를 통해 요청/응답이 아님). 스레드의 동적 확장/다운을 제어하려면 maxMessagesPerTask 옵션도 참조하십시오. JMS를 통해 요청/응답을 수행할 때 option replyToMaxConcurrentConsumers는 응답 메시지 리스너에서 동시 소비자 수를 제어하는 데 사용됩니다.

 

int

replyToDeliveryPersistent (consumer)

응답에 기본적으로 영구 전달을 사용할지 여부를 지정합니다.

true

boolean

선택기 (consumer)

사용할 JMS 선택기를 설정합니다.

 

문자열

SubscriptionDurable (consumer)

서브스크립션을 사용할지 여부를 설정합니다. 사용할 고정 서브스크립션 이름은 subscriptionName 속성을 통해 지정할 수 있습니다. 기본값은 false입니다. 일반적으로 메시지 리스너 클래스 이름이 서브스크립션 이름으로 충분하지 않으면 일반적으로 subscriptionName 값과 함께 하기 위해 이 값을 true로 설정합니다. 주제(pub-sub 도메인)를 청취할 때만 의미가 있으므로 이 방법에서도 barSubDomain 플래그를 전환합니다.

false

boolean

subscriptionName (consumer)

생성할 서브스크립션의 이름을 설정합니다. 공유 또는 지속성 서브스크립션을 사용하는 주제(pub-sub 도메인)의 경우 적용됩니다. 서브스크립션 이름은 이 클라이언트의 JMS 클라이언트 ID 내에서 고유해야 합니다. 기본값은 지정된 메시지 리스너의 클래스 이름입니다. 참고: 공유 서브스크립션( JMS 2.0 필요)을 제외한 각 서브스크립션에 대해 동시 소비자(이 메시지 리스너 컨테이너의 기본값인) 1개만 허용됩니다.

 

문자열

subscriptionShared (consumer)

서브스크립션을 공유할지 여부를 설정합니다. 사용할 공유 서브스크립션 이름은 subscriptionName 속성을 통해 지정할 수 있습니다. 기본값은 false입니다. 일반적으로 메시지 리스너 클래스 이름이 서브스크립션 이름으로 충분하지 않는 한 공유 서브스크립션을 등록하려면 이 값을 true로 설정합니다. 공유 서브스크립션은 또한 불안정할 수 있으므로 이 플래그는 subscriptionDurable과 결합될 수 있습니다. 주제(pub-sub 도메인)를 청취할 때만 의미가 있으므로 이 방법에서도 barSubDomain 플래그를 전환합니다. JMS 2.0 호환 메시지 브로커가 필요합니다.

false

boolean

acceptMessagesWhileStopping (consumer)

중지하는 동안 소비자가 메시지를 수락하는지 여부를 지정합니다. 큐에 있는 메시지가 여전히 있는 동안 런타임에 JMS 경로를 시작하고 중지하는 경우 이 옵션을 활성화하는 것을 고려할 수 있습니다. 이 옵션이 false이고 JMS 경로를 중지하면 메시지가 거부될 수 있으며 JMS 브로커는 다시 거부될 수 있으며, 결국 메시지가 JMS 브로커에서 dead letter queue로 이동될 수 있습니다. 이 옵션을 사용하지 않도록 설정하는 것이 좋습니다.

false

boolean

allowReplyManagerQuickStop (consumer (advanced))

request-reply 메시징에 대해 응답 관리자에 사용되는 DefaultMessageListenerContainer.runningAllowed 플래그를 사용하면 JmsConfiguration#isAcceptMessagesWhileStopping이 활성화되고 org.apache.camel.CamelContext가 중지되는 경우 DefaultMessageListenerContainer.runningAllowed 플래그를 빠르게 중지할 수 있습니다. 이 빠른 중지 기능은 일반 JMS 소비자에서 기본적으로 활성화되어 있지만 응답 관리자를 활성화하려면 이 플래그를 활성화해야 합니다.

false

boolean

Consumer (consumer)

사용할 소비자 유형(간단, 기본값 또는 사용자 지정) 중 하나일 수 있습니다. 소비자 유형에 따라 사용할 Spring JMS 리스너가 결정됩니다. Default는 org.springframework.jms.listener.DefaultMessageListenerContainer를 사용합니다. Simple는 org.springframework.jms.listener.SimpleMessageListenerContainer를 사용합니다. Custom이 지정되면 messageListenerContainerFactory로 정의된 MessageListenerContainerFactory 옵션에 따라 사용할 org.springframework.jms.listener.AbstractMessageListenerContainerContainery가 결정됩니다.

CloudEvent 값:

  • simple
  • Default
  • 사용자 지정

Default

ConsumerType

defaultTaskExecutorType (consumer(advanced))

소비자 끝점과 생산자 끝점의 ReplyTo 소비자 모두에 DefaultMessageListenerContainer에서 사용할 기본 TaskExecutor 유형을 지정합니다. 가능한 값: SimpleAsync(S Spring의 SimpleAsyncTaskExecutor 사용) 또는 ThreadPool(프링의 ThreadPoolTaskExecutor를 최적의 값으로 사용) - 캐시된 threadpool-like. 설정하지 않으면 기본적으로 소비자 엔드포인트에 캐시된 스레드 풀을 사용하고 응답 소비자에는 SimpleAsync를 사용하는 이전 동작으로 설정됩니다. ThreadPool을 사용하면 동시 소비자를 동적으로 증가 및 줄임으로써 탄력적 구성에서 스레드 트래시를 줄이는 것이 좋습니다.

CloudEvent 값:

  • ThreadPool
  • SimpleAsync
 

DefaultTaskExecutorType

eagerLoadingOfProperties (consumer)

JMS 속성이 필요하지 않을 수 있으므로 일반적으로 비효율적이지만 기본 JMS 공급자 및 JMS 속성 사용에 대한 모든 문제를 조기에 가져올 수 있으므로 메시지가 로드되는 즉시 JMS 속성 및 페이로드를 빠르게 로드할 수 있습니다. eagerPoisonBody 옵션도 참조하십시오.

false

boolean

eagerPoisonBody (consumer (advanced))

eagerLoadingOfProperties가 활성화되어 있고 JMS 메시지 페이로드(JMS 본문 또는 JMS 속성)가 Poison이면 이 텍스트를 메시지 본문으로 설정하여 메시지가 처리될 수 있도록 합니다(Emblict의 원인은 Exchange에서 예외로 저장됨). 이 기능은 eagerPoisonBody=false를 설정하여 비활성화할 수 있습니다. eagerLoadingOfProperties 옵션도 참조하십시오.

$\{exception.message}로 인한 JMS 메시지 중독

문자열

exposeListenerSession (consumer (advanced))

메시지를 사용할 때 리스너 세션을 노출할지 여부를 지정합니다.

false

boolean

replyToSameDestinationAllowed (consumer (advanced))

JMS 소비자가 소비자가 소비하기 위해 사용 중인 동일한 대상으로 응답 메시지를 보낼 수 있는지의 여부입니다. 이렇게 하면 동일한 메시지를 소비하고 자체에 전송하여 끝없는 루프를 방지할 수 있습니다.

false

boolean

taskExecutor (consumer(advanced))

메시지를 사용하기 위한 사용자 지정 작업 executor를 지정할 수 있습니다.

 

TaskExecutor

deliveryDelay (producer)

JMS에 대한 send 호출에 사용할 전달 지연을 설정합니다. 이 옵션을 사용하려면 JMS 2.0 호환 브로커가 필요합니다.

-1

long

deliveryMode (producer)

사용할 전달 모드를 지정합니다. 가능한 값은 javax.jms.DeliveryMode에서 정의한 값입니다. NON_PERSISTENT = 1 및 PERSISTENT = 2.

CloudEvent 값:

  • 1
  • 2
 

정수

deliveryPersistent (producer)

기본적으로 영구 제공이 사용되는지 여부를 지정합니다.

true

boolean

explicitQosEnabled (producer)

메시지를 보낼 때 deliveryMode, priority 또는 timeToLive 서비스 수준을 사용해야 하는 경우 설정합니다. 이 옵션은 Spring의 JmsTemplate을 기반으로 합니다. deliveryMode, priority 및 timeToLive 옵션은 현재 끝점에 적용됩니다. 이는 메시지 세분성으로 작동하는 preserveMessageQos 옵션과 달리 Camel In 메시지 헤더에서만 QoS 속성을 읽습니다.

false

부울

formatDateHeadersToIso8601 (producer)

ISO 8601 표준에 따라 JMS 날짜 속성의 형식을 지정할지 여부를 설정합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

preserveMessageQos (producer)

JMS 끝점의 QoS 설정이 아니라 메시지에 지정된 QoS 설정을 사용하여 메시지를 보내려면 true로 설정합니다. 다음 세 개의 헤더는 JMSPriority, JMSDeliveryMode 및 JMSExpiration으로 간주됩니다. 전부 또는 일부만 제공할 수 있습니다. 제공되지 않는 경우 Camel은 대신 엔드포인트의 값을 사용하도록 대체됩니다. 따라서 이 옵션을 사용하면 헤더가 끝점의 값을 덮어씁니다. 반면 explicitQosEnabled 옵션은 메시지 헤더의 값이 아닌 끝점에 설정된 옵션만 사용합니다.

false

boolean

priority (producer)

1보다 큰 값은 전송할 때 메시지 우선 순위를 지정합니다(여기서 1은 가장 낮은 우선 순위이고 9가 가장 높은 값입니다). 이 옵션이 적용되려면 explicitQosEnabled 옵션도 활성화해야 합니다.

CloudEvent 값:

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9

4

int

replyToConcurrentConsumers (producer)

JMS를 통해 요청/응답할 때 동시 소비자의 기본 수를 지정합니다. 스레드의 동적 확장/다운을 제어하려면 maxMessagesPerTask 옵션도 참조하십시오.

1

int

replyToMaxConcurrentConsumers (producer)

JMS를 통해 request/reply를 사용할 때 최대 동시 소비자 수를 지정합니다. 스레드의 동적 확장/다운을 제어하려면 maxMessagesPerTask 옵션도 참조하십시오.

 

int

replyToOnTimeoutMaxConcurrentConsumers (producer)

JMS를 통해 요청/응답을 사용할 때 타임아웃이 발생할 때 연속 라우팅에 대한 최대 동시 소비자 수를 지정합니다.

1

int

replyToOverride (producer)

JMS 메시지에 명시적으로 ReplyTo 대상을 제공하여 replyTo 설정을 덮어씁니다. 메시지를 원격 큐로 전달하고 ReplyTo 대상에서 응답 메시지를 수신하려는 경우 유용합니다.

 

문자열

replyToType (producer)

JMS를 통해 request/reply를 수행할 때 replyTo 큐에 사용할 전략 종류를 명시적으로 지정할 수 있습니다. 가능한 값은 임시, 공유 또는 제외입니다. 기본적으로 Camel은 임시 대기열을 사용합니다. 그러나 replyTo가 구성된 경우 기본적으로 Shared가 사용됩니다. 이 옵션을 사용하면 공유된 큐 대신 전용 큐를 사용할 수 있습니다. 자세한 내용과 특히 클러스터형 환경에서 실행되는 경우의 영향 및 공유 응답 대기열의 성능이 대체 시간 및 제외보다 성능이 적다는 사실에 대한 자세한 내용은 Camel JMS 문서를 참조하십시오.

CloudEvent 값:

  • 임시
  • shared
  • exclusive
 

ReplyToType

requestTimeout (producer)

InOut 교환 패턴 (밀리초)을 사용할 때 응답을 기다리는 시간 초과입니다. 기본값은 20초입니다. CamelJmsRequestTimeout 헤더를 포함하여 이 엔드포인트 구성 시간 값을 재정의하고 메시지마다 개별 시간 초과 값을 포함할 수 있습니다. requestTimeoutCheckerInterval 옵션도 참조하십시오.

20000

long

TimeToLive (producer)

메시지를 보낼 때 메시지의 라이브 시간(밀리초)을 지정합니다.

-1

long

allowECDHEHeaders (producer (advanced))

이 옵션은 JMS 사양에 따라 유효하지 않은 값을 가질 수 있는 추가 헤더를 허용하는 데 사용됩니다. 예를 들어 WMQ와 같은 일부 메시지 시스템은 바이트 배열 또는 기타 유효하지 않은 유형이 있는 값이 포함된 JMS_IBM_MQECDHE_ 접두사를 사용하여 헤더 이름으로 이 작업을 수행합니다. 쉼표로 구분된 여러 헤더 이름을 지정하고 와일드카드 일치의 경우 접미사로 사용할 수 있습니다.

 

문자열

allowNullBody (producer (advanced))

본문 없이 메시지를 보낼 수 있는지 여부입니다. 이 옵션이 false이고 메시지 본문이 null이면 JMSException이 발생합니다.

true

boolean

alwaysCopyMessage (producer (advanced))

true인 경우 Camel은 전송을 위해 생산자로 전달할 때 항상 메시지의 JMS 메시지 사본을 만듭니다. replyToDestinationSelectorName이 설정된 경우와 같이 메시지를 복사하는 것이 필요합니다(예: replyToDestinationSelectorName이 설정된 경우 Camel은 alwaysCopyMessage 옵션을 true로 설정합니다).

false

boolean

correlationProperty (producer (advanced))

InOut 교환 패턴을 사용하는 경우 JMSCorrelationID JMS 속성 대신 이 JMS 속성을 사용하여 메시지의 상관 관계를 파악합니다. 설정된 메시지가 이 속성의 값에만 관련이 있는 경우 JMSCorrelationID 속성 값은 무시되며 Camel에서 설정하지 않습니다.

 

문자열

disableTimeToLive (producer (advanced))

이 옵션을 사용하여 실시간으로 비활성화 시간을 강제 적용합니다. 예를 들어 JMS를 통해 요청/응답을 수행하는 경우 Camel은 기본적으로 전송 중인 메시지에 실시간 requestTimeout 값을 사용합니다. 문제는 발신자와 수신자 시스템의 시계가 동기화되어 있어야 한다는 것입니다. 항상 압축하기 쉬운 것은 아닙니다. 따라서 disableTimeToLive=true를 사용하여 전송된 메시지에 실시간 값으로 시간을 설정하지 않을 수 있습니다. 그러면 메시지가 수신자 시스템에서 만료되지 않습니다. 자세한 내용은 아래 섹션(Time to live)을 참조하십시오.

false

boolean

forceSendOriginalMessage (producer)

mapJmsMessage=false Camel을 사용하면 경로 중 헤더(get 또는 set)를 만지면 새 JMS 대상으로 전송할 새 JMS 메시지를 생성합니다. Camel이 수신한 원래 JMS 메시지를 전송하도록 하려면 이 옵션을 true로 설정합니다.

false

boolean

includeSentJMSMessageID (producer(advanced))

InOnly를 사용하여 JMS 대상으로 보내는 경우에만 적용됩니다(예: 실행 및 잊기). 이 옵션을 활성화하면 메시지가 JMS 대상으로 전송되었을 때 JMS 클라이언트가 사용한 실제 JMSMessageID를 사용하여 Camel Exchange를 보강합니다.

false

boolean

replyToCacheLevelName (producer (advanced))

JMS를 통해 요청/reply할 때 응답 소비자의 이름별로 캐시 수준을 설정합니다. 이 옵션은 고정 응답 큐(임시 아님)를 사용하는 경우에만 적용됩니다. Camel은 기본적으로 사용합니다. 전용 또는 공유 w/ replyToSelectorName의 경우 CACHE_CONSUMER입니다. 그리고 replyToSelectorName 없이 공유되는 경우 CACHE_SESSION IBMNodePolicy와 같은 일부 JMS 브로커는 replyToCacheLevelName=CACHE_NONE을 작동으로 설정해야 할 수 있습니다. 참고: 임시 대기열을 사용하는 경우 CACHE_NONE은 허용되지 않으며 CACHE_CONSUMER 또는 CACHE_SESSION과 같은 더 높은 값을 사용해야 합니다.

CloudEvent 값:

  • CACHE_AUTO
  • CACHE_CONNECTION
  • CACHE_CONSUMER
  • CACHE_NONE
  • CACHE_SESSION
 

문자열

replyToDestinationSelectorName (producer)

공유 큐를 사용할 때(즉, 임시 응답 큐를 사용하지 않는 경우) 다른 사용자의 응답을 필터링할 수 있도록 고정 이름을 사용하여 JMS 선택기를 설정합니다.

 

문자열

streamMessageTypeEnabled (producer (advanced))

StreamMessage 유형이 활성화되었는지 여부를 설정합니다. 파일, InputStream 등과 같은 스트리밍 유형의 메시지 페이로드는 CloudEventsMessage 또는 StreamMessage로 전송됩니다. 이 옵션은 사용할 유형을 제어합니다. 기본적으로는 전체 메시지 페이로드를 메모리로 읽어오는 데 사용됩니다. 이 옵션을 사용하면 메시지 페이로드가 청크의 메모리에 읽어지고 각 청크는 더 이상 데이터가 없을 때까지 StreamMessage에 기록됩니다.

false

boolean

allowAutoLoadBalancerredConnectionFactory (advanced)

연결 팩토리가 구성되지 않은 경우 레지스트리에서 ConnectionFactory를 자동 검색할지 여부입니다. 하나의 ConnectionFactory 인스턴스만 발견되면 사용됩니다. 이는 기본적으로 활성화되어 있습니다.

true

boolean

allowAutoECDHEredDestinationResolver (advanced)

대상 해결 프로그램이 구성되지 않은 경우 레지스트리에서 DestinationResolver를 자동 검색할지 여부입니다. DestinationResolver 인스턴스가 하나만 발견되면 사용됩니다. 이는 기본적으로 활성화되어 있습니다.

true

boolean

allowSerializedHeaders (advanced)

직렬화된 헤더를 포함할지 여부를 제어합니다. transferExchange가 true인 경우에만 적용됩니다. 이를 위해 오브젝트를 직렬화할 수 있어야 합니다. Camel은 비합리화 가능한 오브젝트를 제외하고 WARN 수준에서 기록합니다.

false

boolean

artemisStreamingEnabled (고급)

Apache Artemis 스트리밍 모드를 최적화할지 여부입니다. 이렇게 하면 Artemis를 JMS StreamMessage 유형과 함께 사용할 때 메모리 오버헤드가 줄어들 수 있습니다. 이 옵션은 Apache Artemis를 사용하는 경우에만 활성화해야 합니다.

false

boolean

asyncStartListener (advanced)

경로를 시작할 때 JmsConsumer 메시지 리스너를 비동기식으로 시작할지 여부입니다. 예를 들어 JmsConsumer가 원격 JMS 브로커에 대한 연결을 가져올 수 없는 경우 재시도 및/또는 장애 조치 동안 차단될 수 있습니다. 이로 인해 Camel이 경로를 시작하는 동안 차단됩니다. 이 옵션을 true로 설정하면 시작 라우팅이 허용되고 JmsConsumer는 비동기 모드에서 전용 스레드를 사용하여 JMS 브로커에 연결합니다. 이 옵션을 사용하는 경우 연결을 설정할 수 없는 경우 예외가 WARN 수준에서 기록되고 소비자는 메시지를 수신할 수 없습니다. 그런 다음 다시 시도하도록 경로를 다시 시작할 수 있습니다.

false

boolean

asyncStopListener (advanced)

경로를 중지할 때 JmsConsumer 메시지 리스너를 비동기식으로 중지할지 여부입니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

구성 (고급)

공유 JMS 구성을 사용하려면 다음을 수행합니다.

 

JmsConfiguration

destinationResolver (advanced)

플러그형 org.springframework.jms.support.destination.DestinationResolver - 자체 확인 프로그램을 사용할 수 있습니다(예: JNDI 레지스트리에서 실제 대상 조회).

 

DestinationResolver

errorHandler (advanced)

메시지를 처리하는 동안 발생하지 않는 예외의 경우 호출할 org.springframework.util.ErrorHandler를 지정합니다. 기본적으로 이러한 예외는 errorHandler가 구성되지 않은 경우 WARN 수준에서 기록됩니다. 로깅 수준과 errorHandlerLoggingLevel 및 errorHandlerLogStackTrace 옵션을 사용하여 스택 추적을 로깅할지 여부를 구성할 수 있습니다. 이렇게 하면 사용자 정의 errorHandler를 코딩하는 것보다 훨씬 쉽게 구성할 수 있습니다.

 

ErrorHandler

exceptionListener (advanced)

기본 JMS 예외 예외에 대한 알림을 받을 JMS Exception Listener를 지정합니다.

 

ExceptionListener

idleConsumerLimit (advanced)

언제든지 유휴 상태로 설정할 수 있는 소비자 수에 대한 제한을 지정합니다.

1

int

idleTaskExecutionLimit (advanced)

실행 내에서 메시지를 수신하지 않고 수신 작업의 유휴 실행에 대한 제한을 지정합니다. 이 제한에 도달하면 작업이 종료되고 다른 실행 중인 작업에 수신이 유지됩니다(동적 스케줄링의 경우 maxConcurrentConsumers 설정 참조). Spring에서 제공하는 추가 문서도 있습니다.

1

int

includeAllJMSXProperties (advanced)

JMS에서 Camel Message로 매핑할 때 모든 JMSXxxx 속성을 포함할지 여부입니다. 이 값을 true로 설정하면 JMSXAppID 및 JMSXUserID 등과 같은 속성이 포함됩니다. 참고: 사용자 정의 headerFilterStrategy를 사용하는 경우 이 옵션은 적용되지 않습니다.

false

boolean

jmsKeyFormatStrategy (advanced)

JMS 키를 인코딩 및 디코딩하여 JMS 사양을 준수할 수 있도록 연결 가능한 전략입니다. Camel은 기본적으로 default 및 passthrough의 두 가지 구현을 제공합니다. 기본 전략은 점과 하이픈(. 및 -)을 안전하게 마샬링합니다. 패스스루 전략은 키를 그대로 유지합니다. JMS 헤더 키에 잘못된 문자가 포함되어 있는지 확인하지 않는 JMS 브로커에 사용할 수 있습니다. org.apache.camel.component.jms.JmsKeyFormatStrategy의 자체 구현을 제공하고 # 표기법을 사용하여 참조할 수 있습니다.

CloudEvent 값:

  • default
  • passthrough
 

JmsKeyFormatStrategy

mapJmsMessage (advanced)

Camel이 수신된 JMS 메시지를 javax.jms.knativeMessage와 같이 적절한 페이로드 유형으로 자동으로 매핑할지 여부를 String 등에 지정합니다.

true

boolean

maxMessagesPerTask (advanced)

작업당 메시지 수입니다. -1은 무제한입니다. 동시 소비자(예: min max)에 범위를 사용하는 경우 이 옵션을 사용하여 작업이 덜 필요할 때 소비자의 축소 속도를 제어하기 위해 값을 100으로 설정할 수 있습니다.

-1

int

MessageConverter (advanced)

javax.jms.jms.support.converter.MessageConverter 사용자 지정 Spring org.springframework.jms.MessageConverter를 사용하여 javax.jms.Message로 매핑하는 방법을 제어할 수 있습니다.

 

MessageConverter

messageCreatedStrategy (advanced)

Camel이 JMS 메시지를 보낼 때 Camel이 javax.jms.Message 개체의 새 인스턴스를 생성할 때 호출되는 지정된 MessageCreatedStrategy를 사용하려면 다음을 수행합니다.

 

MessageCreatedStrategy

messageIdEnabled (advanced)

전송할 때 메시지 ID를 추가해야 하는지 여부를 지정합니다. 이는 JMS 브로커에 대한 힌트일 뿐입니다. JMS 공급자가 이 힌트를 수락하면 이러한 메시지에 메시지 ID가 null로 설정되어 있어야 합니다. 공급자가 힌트를 무시하면 메시지 ID를 정상적인 고유 값으로 설정해야 합니다.

true

boolean

messageListenerContainerFactory (advanced)

메시지를 사용하는 데 사용할 org.springframework.jms.listener.AbstractMessageListenerContainery를 결정하는 데 사용되는 MessageListenerContainerFactory의 레지스트리 ID입니다. 이 값을 설정하면 consumerType이 Custom으로 자동 설정됩니다.

 

MessageListenerContainerFactory

messageTimestampEnabled (advanced)

메시지 전송 시 타임스탬프를 기본적으로 사용하도록 설정해야 하는지 여부를 지정합니다. 이는 JMS 브로커에 대한 힌트일 뿐입니다. JMS 공급자가 이 힌트를 수락하는 경우 이러한 메시지에는 타임스탬프가 0으로 설정되어 있어야 합니다. 공급자가 타임스탬프를 일반 값으로 설정해야 하는 힌트를 무시합니다.

true

boolean

ineSubNoLocal (advanced)

자체 연결에 의해 게시되는 메시지 전달을 억제할지 여부를 지정합니다.

false

boolean

queueECDHEStrategy (advanced)

큐를 검색할 때 사용자 지정 Queue>-<Strategy를 사용하려면 다음을 수행합니다.

 

QueueBrowseStrategy

receiveTimeout (advanced)

메시지 수신에 대한 제한 시간(밀리초)입니다.

1000

long

복구 간격 (advanced)

연결을 새로 고치는 경우(예: 밀리초) 복구 시도 간격을 지정합니다. 기본값은 5000ms, 즉 5초입니다.

5000

long

requestTimeoutCheckerInterval (advanced)

Camel이 JMS를 통해 요청/응답할 때 시간 초과 교환을 확인하는 빈도를 설정합니다. 기본적으로 Camel 검사는 초당 한 번 확인합니다. 그러나 시간 초과가 발생할 때 더 빠르게 대응해야 하는 경우 이 간격을 줄여 더 자주 확인할 수 있습니다. 시간 초과는 옵션 requestTimeout에 따라 결정됩니다.

1000

long

동기 (고급)

동기 처리를 엄격하게 사용해야 하는지 여부를 설정합니다.

false

boolean

TransferException (advanced)

사용 가능하며 소비자 측에서 Request Reply messaging (InOut)를 사용하고 있는 경우, 발생한 Exception은 javax.jms.ObjectMessage로 응답으로 다시 전송됩니다. 클라이언트가 Camel인 경우 반환된 Exception이 다시 표시됩니다. 이를 통해 Camel JMS를 라우팅의 브리지로 사용할 수 있습니다(예: 영구 대기열을 사용하여 강력한 라우팅 가능). transferExchange를 사용하도록 설정한 경우에도 이 옵션이 우선합니다. catch된 예외는 직렬화할 수 있어야 합니다. 소비자 측의 원래 예외는 org.apache.camel.RuntimeCamelException과 같은 외부 예외로 래핑할 수 있습니다. 데이터가 Java Object serialization을 사용하고 있으며 수신한 데이터를 클래스 수준에서 역직렬화할 수 있어야 하므로 생산자와 소비자 간에 강력한 결합이 강제 적용됩니다.

false

boolean

transfer exchange (advanced)

본문과 헤더 대신 전선을 통해 교환을 전송할 수 있습니다. 본문, 외부, Fault 본문, In headers, Out headers, Fault headers, Fault headers, exchange properties, exchange exception. 이를 위해 오브젝트를 직렬화할 수 있어야 합니다. Camel은 비합리화 가능한 오브젝트를 제외하고 WARN 수준에서 기록합니다. 생산자와 소비자 양쪽 모두에서 이 옵션을 활성화해야 하므로 Camel은 페이로드가 일반 페이로드가 아니라 Exchange임을 알고 있습니다. 데이터가 Java Object serialization을 사용하고 있고 수신자가 클래스 수준에서 데이터를 역직렬화할 수 있어야 하므로, 호환되는 Camel 버전을 사용해야 하는 생산자와 소비자 간에 강력한 결합이 강제 적용됩니다.

false

boolean

useMessageIDAsCorrelationID (advanced)

JMSMessageID가 항상 InOut 메시지의 JMSCorrelationID로 사용되어야 하는지 여부를 지정합니다.

false

boolean

waitForProvisionCorrelationToBeUpdatedCounter (advanced)

JMS에 대해 요청/응답을 수행할 때 및 option useMessageIDAsCorrelationID가 활성화될 때 임시 상관 관계 ID가 실제 상관 ID로 업데이트될 때까지 대기하는 횟수입니다.

50

int

waitForProvisionCorrelationToBeUpdatedThreadSleepingTime (advanced)

프로비저닝 상관 관계 ID가 업데이트되기를 기다리는 동안 매번 millis의 간격이 유휴 상태가 됩니다.

100

long

headerFilterStrategy (filter)

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지와 헤더를 필터링합니다.

 

HeaderFilterStrategy

errorHandlerLoggingLevel (logging)

사용되지 않는 예외에 대해 기본 errorHandler 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

WARN

LoggingLevel

errorHandlerLogStackTrace (logging)

기본 errorHandler에 의해 stacktraces가 기록될지 여부를 제어할 수 있습니다.

true

boolean

암호 (보안)

ConnectionFactory와 함께 사용할 암호입니다. ConnectionFactory에서 직접 사용자 이름/암호를 구성할 수도 있습니다.

 

문자열

사용자 이름 (보안)

ConnectionFactory와 함께 사용할 사용자 이름입니다. ConnectionFactory에서 직접 사용자 이름/암호를 구성할 수도 있습니다.

 

문자열

트랜잭션됨 (ECDHE)

변환 모드를 사용할지 여부를 지정합니다.

false

boolean

TransactedInOut (ECDHE)

이 플래그가 true로 설정된 경우 InOut 작업(응답 요청)이 Transacted 모드를 사용하도록 기본지 여부를 지정합니다. 이 플래그를 true로 설정한 경우 Spring JmsTemplate이 true로 설정되고 InOut 작업에 사용되는 JmsTemplate에서 표시되는 acknowledgeMode가 true로 설정됩니다. Spring JMS: JTA 트랜잭션 내에서Queue에 전달된 매개변수는 createTopic 메서드가 고려되지 않습니다. Java EE 트랜잭션 컨텍스트에 따라 컨테이너는 이러한 값에 대해 자체 결정을 내립니다. 유사하게, 이러한 매개 변수는 이 경우 Spring JMS가 기존 JMS 세션에서 작동하기 때문에 로컬 관리 트랜잭션 내에서 고려되지 않습니다. 이 플래그를 true로 설정하면 관리 트랜잭션 외부에서 실행할 때 짧은 로컬 JMS 트랜잭션과 관리 트랜잭션(XA 트랜잭션 제외)이 있는 경우 동기화된 로컬 JMS 트랜잭션이 사용됩니다. 이는 JMS 트랜잭션이 기본 트랜잭션 직후에 커밋되는 기본 트랜잭션(기본 JDBC 트랜잭션일 수 있음)과 함께 관리되는 로컬 JMS 트랜잭션이 영향을 미칩니다.

false

boolean

lazyCreateTransactionManager (ECDHE (advanced))

true인 경우 Camel은 옵션이 transacted=true인 경우 트랜잭션 관리자가 삽입되지 않은 경우 JmsTransactionManager를 생성합니다.

true

boolean

TransactionManager (advanced)

Spring 트랜잭션 관리자가 사용할 수 있습니다.

 

PlatformTransactionManager

TransactionName (advanced)

사용할 트랜잭션의 이름입니다.

 

문자열

트랜잭션Timeout (advanced)

트랜잭션 모드를 사용하는 경우 트랜잭션 제한 값(초)입니다.

-1

int

26.4. 끝점 옵션

JMS 엔드포인트는 URI 구문을 사용하여 구성됩니다.

jms:destinationType:destinationName

다음과 같은 경로 및 쿼리 매개변수 사용:

26.4.1. 경로 매개변수(2 매개변수)

이름설명Default유형

destinationType (common)

사용할 대상의 종류입니다.

CloudEvent 값:

  • 주제
  • temp-queue
  • temp-topic

문자열

destinationName (common)

대상으로 사용할 큐 또는 항목의 이름입니다.

 

문자열

26.4.2. 쿼리 매개변수(95 매개변수)

이름설명Default유형

ClientID (common)

사용할 JMS 클라이언트 ID를 설정합니다. 이 값은 지정하는 경우 고유해야 하며 단일 JMS 연결 인스턴스에서만 사용할 수 있습니다. 일반적으로 지속성 주제 서브스크립션에만 필요합니다. Apache ActiveMQ를 사용하는 경우 대신 Virtual Topics를 사용할 수 있습니다.

 

문자열

ConnectionFactory (common)

사용할 연결 팩토리입니다. 연결 팩토리는 구성 요소 또는 끝점에서 구성해야 합니다.

 

ConnectionFactory

disableReplyTo (공용)

Camel이 메시지에서 JMSReplyTo 헤더를 무시하는지 여부를 지정합니다. true인 경우 Camel은 JMSReplyTo 헤더에 지정된 대상으로 회신을 다시 보내지 않습니다. Camel을 경로에서 사용하고 코드의 다른 구성 요소가 응답 메시지를 처리하므로 Camel이 응답 메시지를 자동으로 다시 전송하지 않도록 하려면 이 옵션을 사용할 수 있습니다. 다른 메시지 브로커 간의 프록시로 Camel을 사용하고 한 시스템에서 다른 시스템으로 메시지를 라우팅하려는 경우에도 이 옵션을 사용할 수 있습니다.

false

boolean

fluentdSubscriptionName (common)

해제된 주제 서브스크립션을 지정하기 위한 조정된 구독자 이름입니다. clientId 옵션도 구성해야 합니다.

 

문자열

jmsMessageType (common)

JMS 메시지를 전송하기 위해 특정 javax.jms.Message 구현을 강제로 사용할 수 있습니다. 가능한 값은 10.0.0.1s, Map, Object, Stream, text입니다. 기본적으로 Camel은 In body type에서 사용할 JMS 메시지 유형을 결정합니다. 이 옵션을 사용하면 지정할 수 있습니다.

CloudEvent 값:

  • 바이트
  • map
  • 개체
  • stream
  • text
 

JmsMessageType

replyTo (common)

명시적인 ReplyTo 대상을 제공합니다(sumJMSReplyTo() in consumer.getJMSReplyTo()의 수신 값 재정의).

 

문자열

testConnectionOnStartup (common)

시작 시 연결을 테스트할지 여부를 지정합니다. 이렇게 하면 Camel이 시작되면 모든 JMS 소비자가 JMS 브로커와 유효한 연결을 갖습니다. 연결을 부여할 수 없는 경우 Camel이 시작 시 예외를 발생시킵니다. 이렇게 하면 실패한 연결로 Camel이 시작되지 않습니다. JMS 생산자도 테스트됩니다.

false

boolean

acknowledgementModeName (consumer)

SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, AUTO_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE 중 하나인 JMS 승인 이름.

CloudEvent 값:

  • SESSION_TRANSACTED
  • CLIENT_ACKNOWLEDGE
  • AUTO_ACKNOWLEDGE
  • DUPS_OK_ACKNOWLEDGE

AUTO_ACKNOWLEDGE

문자열

artemisConsumerPriority (consumer)

소비자 우선 순위를 사용하면 높은 우선 순위의 소비자가 활성화된 동안 메시지를 수신하는지 확인할 수 있습니다. 일반적으로 큐에 연결된 활성 소비자는 라운드 로빈 방식으로 메시지를 수신합니다. 소비자 우선순위가 사용 중인 경우 여러 활성 사용자가 동일한 높은 우선 순위로 있는 경우 메시지가 라운드 로빈으로 전달됩니다. 높은 우선 순위의 소비자가 메시지를 사용하는 데 사용할 수 없는 경우 또는 높은 우선 순위의 소비자가 메시지를 수락하지 않은 경우(예: 소비자와 연결된 모든 선택기의 기준을 충족하지 않기 때문에 메시지는 우선 순위가 낮은 소비자만 사용하게 됩니다).

 

int

asyncConsumer (consumer)

JmsConsumer에서 교환을 비동기식으로 처리할지 여부입니다. 활성화하면 JmsConsumer가 JMS 대기열에서 다음 메시지를 선택할 수 있지만 이전 메시지는 비동기 라우팅 엔진에서 비동기적으로 처리됩니다. 즉, 메시지가 100% 엄격하게 처리되지 않을 수 있습니다. 비활성화 된 경우 (기본적으로) 교환은 JmsConsumer가 JMS 큐에서 다음 메시지를 선택하기 전에 완전히 처리됩니다. 트랜잭션이 활성화된 경우 트랜잭션을 동시에 실행해야 하므로 비동기식으로 asyncConsumer=true가 실행되지 않습니다(Camel 3.0에서 비동기 트랜잭션을 지원할 수 있음).

false

boolean

autoStartup (consumer)

소비자 컨테이너가 자동으로 시작되어야 하는지 여부를 지정합니다.

true

boolean

cacheLevel (consumer)

기본 JMS 리소스의 ID로 캐시 수준을 설정합니다. 자세한 내용은 cacheLevelName 옵션을 참조하십시오.

 

int

cacheLevelName (consumer)

기본 JMS 리소스에 대한 이름별로 캐시 수준을 설정합니다. 가능한 값은 CACHE_AUTO, CACHE_CONNECTION, CACHE_CONSUMER, CACHE_NONE 및 CACHE_SESSION입니다. 기본 설정은 CACHE_AUTO입니다. 자세한 내용은 Spring 문서 및 트랜잭션 캐시 수준을 참조하십시오.

CloudEvent 값:

  • CACHE_AUTO
  • CACHE_CONNECTION
  • CACHE_CONSUMER
  • CACHE_NONE
  • CACHE_SESSION

CACHE_AUTO

문자열

concurrentConsumers (consumer)

JMS에서 사용할 때 기본 동시 소비자 수를 지정합니다( JMS를 통해 요청/응답이 아님). 스레드의 동적 확장/다운을 제어하려면 maxMessagesPerTask 옵션도 참조하십시오. JMS를 통해 요청/응답을 수행할 때 replyToConcurrentConsumers 옵션은 응답 메시지 리스너에서 동시 소비자 수를 제어하는 데 사용됩니다.

1

int

maxConcurrentConsumers (consumer)

JMS에서 사용할 때 최대 동시 소비자 수를 지정합니다( JMS를 통해 요청/응답이 아님). 스레드의 동적 확장/다운을 제어하려면 maxMessagesPerTask 옵션도 참조하십시오. JMS를 통해 요청/응답을 수행할 때 option replyToMaxConcurrentConsumers는 응답 메시지 리스너에서 동시 소비자 수를 제어하는 데 사용됩니다.

 

int

replyToDeliveryPersistent (consumer)

응답에 기본적으로 영구 전달을 사용할지 여부를 지정합니다.

true

boolean

선택기 (consumer)

사용할 JMS 선택기를 설정합니다.

 

문자열

SubscriptionDurable (consumer)

서브스크립션을 사용할지 여부를 설정합니다. 사용할 고정 서브스크립션 이름은 subscriptionName 속성을 통해 지정할 수 있습니다. 기본값은 false입니다. 일반적으로 메시지 리스너 클래스 이름이 서브스크립션 이름으로 충분하지 않으면 일반적으로 subscriptionName 값과 함께 하기 위해 이 값을 true로 설정합니다. 주제(pub-sub 도메인)를 청취할 때만 의미가 있으므로 이 방법에서도 barSubDomain 플래그를 전환합니다.

false

boolean

subscriptionName (consumer)

생성할 서브스크립션의 이름을 설정합니다. 공유 또는 지속성 서브스크립션을 사용하는 주제(pub-sub 도메인)의 경우 적용됩니다. 서브스크립션 이름은 이 클라이언트의 JMS 클라이언트 ID 내에서 고유해야 합니다. 기본값은 지정된 메시지 리스너의 클래스 이름입니다. 참고: 공유 서브스크립션( JMS 2.0 필요)을 제외한 각 서브스크립션에 대해 동시 소비자(이 메시지 리스너 컨테이너의 기본값인) 1개만 허용됩니다.

 

문자열

subscriptionShared (consumer)

서브스크립션을 공유할지 여부를 설정합니다. 사용할 공유 서브스크립션 이름은 subscriptionName 속성을 통해 지정할 수 있습니다. 기본값은 false입니다. 일반적으로 메시지 리스너 클래스 이름이 서브스크립션 이름으로 충분하지 않는 한 공유 서브스크립션을 등록하려면 이 값을 true로 설정합니다. 공유 서브스크립션은 또한 불안정할 수 있으므로 이 플래그는 subscriptionDurable과 결합될 수 있습니다. 주제(pub-sub 도메인)를 청취할 때만 의미가 있으므로 이 방법에서도 barSubDomain 플래그를 전환합니다. JMS 2.0 호환 메시지 브로커가 필요합니다.

false

boolean

acceptMessagesWhileStopping (consumer)

중지하는 동안 소비자가 메시지를 수락하는지 여부를 지정합니다. 큐에 있는 메시지가 여전히 있는 동안 런타임에 JMS 경로를 시작하고 중지하는 경우 이 옵션을 활성화하는 것을 고려할 수 있습니다. 이 옵션이 false이고 JMS 경로를 중지하면 메시지가 거부될 수 있으며 JMS 브로커는 다시 거부될 수 있으며, 결국 메시지가 JMS 브로커에서 dead letter queue로 이동될 수 있습니다. 이 옵션을 사용하지 않도록 설정하는 것이 좋습니다.

false

boolean

allowReplyManagerQuickStop (consumer (advanced))

request-reply 메시징에 대해 응답 관리자에 사용되는 DefaultMessageListenerContainer.runningAllowed 플래그를 사용하면 JmsConfiguration#isAcceptMessagesWhileStopping이 활성화되고 org.apache.camel.CamelContext가 중지되는 경우 DefaultMessageListenerContainer.runningAllowed 플래그를 빠르게 중지할 수 있습니다. 이 빠른 중지 기능은 일반 JMS 소비자에서 기본적으로 활성화되어 있지만 응답 관리자를 활성화하려면 이 플래그를 활성화해야 합니다.

false

boolean

Consumer (consumer)

사용할 소비자 유형(간단, 기본값 또는 사용자 지정) 중 하나일 수 있습니다. 소비자 유형에 따라 사용할 Spring JMS 리스너가 결정됩니다. Default는 org.springframework.jms.listener.DefaultMessageListenerContainer를 사용합니다. Simple는 org.springframework.jms.listener.SimpleMessageListenerContainer를 사용합니다. Custom이 지정되면 messageListenerContainerFactory로 정의된 MessageListenerContainerFactory 옵션에 따라 사용할 org.springframework.jms.listener.AbstractMessageListenerContainerContainery가 결정됩니다.

CloudEvent 값:

  • simple
  • Default
  • 사용자 지정

Default

ConsumerType

defaultTaskExecutorType (consumer(advanced))

소비자 끝점과 생산자 끝점의 ReplyTo 소비자 모두에 DefaultMessageListenerContainer에서 사용할 기본 TaskExecutor 유형을 지정합니다. 가능한 값: SimpleAsync(S Spring의 SimpleAsyncTaskExecutor 사용) 또는 ThreadPool(프링의 ThreadPoolTaskExecutor를 최적의 값으로 사용) - 캐시된 threadpool-like. 설정하지 않으면 기본적으로 소비자 엔드포인트에 캐시된 스레드 풀을 사용하고 응답 소비자에는 SimpleAsync를 사용하는 이전 동작으로 설정됩니다. ThreadPool을 사용하면 동시 소비자를 동적으로 증가 및 줄임으로써 탄력적 구성에서 스레드 트래시를 줄이는 것이 좋습니다.

CloudEvent 값:

  • ThreadPool
  • SimpleAsync
 

DefaultTaskExecutorType

eagerLoadingOfProperties (consumer)

JMS 속성이 필요하지 않을 수 있으므로 일반적으로 비효율적이지만 기본 JMS 공급자 및 JMS 속성 사용에 대한 모든 문제를 조기에 가져올 수 있으므로 메시지가 로드되는 즉시 JMS 속성 및 페이로드를 빠르게 로드할 수 있습니다. eagerPoisonBody 옵션도 참조하십시오.

false

boolean

eagerPoisonBody (consumer (advanced))

eagerLoadingOfProperties가 활성화되어 있고 JMS 메시지 페이로드(JMS 본문 또는 JMS 속성)가 Poison이면 이 텍스트를 메시지 본문으로 설정하여 메시지가 처리될 수 있도록 합니다(Emblict의 원인은 Exchange에서 예외로 저장됨). 이 기능은 eagerPoisonBody=false를 설정하여 비활성화할 수 있습니다. eagerLoadingOfProperties 옵션도 참조하십시오.

$\{exception.message}로 인한 JMS 메시지 중독

문자열

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

exposeListenerSession (consumer (advanced))

메시지를 사용할 때 리스너 세션을 노출할지 여부를 지정합니다.

false

boolean

replyToSameDestinationAllowed (consumer (advanced))

JMS 소비자가 소비자가 소비하기 위해 사용 중인 동일한 대상으로 응답 메시지를 보낼 수 있는지의 여부입니다. 이렇게 하면 동일한 메시지를 소비하고 자체에 전송하여 끝없는 루프를 방지할 수 있습니다.

false

boolean

taskExecutor (consumer(advanced))

메시지를 사용하기 위한 사용자 지정 작업 executor를 지정할 수 있습니다.

 

TaskExecutor

deliveryDelay (producer)

JMS에 대한 send 호출에 사용할 전달 지연을 설정합니다. 이 옵션을 사용하려면 JMS 2.0 호환 브로커가 필요합니다.

-1

long

deliveryMode (producer)

사용할 전달 모드를 지정합니다. 가능한 값은 javax.jms.DeliveryMode에서 정의한 값입니다. NON_PERSISTENT = 1 및 PERSISTENT = 2.

CloudEvent 값:

  • 1
  • 2
 

정수

deliveryPersistent (producer)

기본적으로 영구 제공이 사용되는지 여부를 지정합니다.

true

boolean

explicitQosEnabled (producer)

메시지를 보낼 때 deliveryMode, priority 또는 timeToLive 서비스 수준을 사용해야 하는 경우 설정합니다. 이 옵션은 Spring의 JmsTemplate을 기반으로 합니다. deliveryMode, priority 및 timeToLive 옵션은 현재 끝점에 적용됩니다. 이는 메시지 세분성으로 작동하는 preserveMessageQos 옵션과 달리 Camel In 메시지 헤더에서만 QoS 속성을 읽습니다.

false

부울

formatDateHeadersToIso8601 (producer)

ISO 8601 표준에 따라 JMS 날짜 속성의 형식을 지정할지 여부를 설정합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

preserveMessageQos (producer)

JMS 끝점의 QoS 설정이 아니라 메시지에 지정된 QoS 설정을 사용하여 메시지를 보내려면 true로 설정합니다. 다음 세 개의 헤더는 JMSPriority, JMSDeliveryMode 및 JMSExpiration으로 간주됩니다. 전부 또는 일부만 제공할 수 있습니다. 제공되지 않는 경우 Camel은 대신 엔드포인트의 값을 사용하도록 대체됩니다. 따라서 이 옵션을 사용하면 헤더가 끝점의 값을 덮어씁니다. 반면 explicitQosEnabled 옵션은 메시지 헤더의 값이 아닌 끝점에 설정된 옵션만 사용합니다.

false

boolean

priority (producer)

1보다 큰 값은 전송할 때 메시지 우선 순위를 지정합니다(여기서 1은 가장 낮은 우선 순위이고 9가 가장 높은 값입니다). 이 옵션이 적용되려면 explicitQosEnabled 옵션도 활성화해야 합니다.

CloudEvent 값:

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9

4

int

replyToConcurrentConsumers (producer)

JMS를 통해 요청/응답할 때 동시 소비자의 기본 수를 지정합니다. 스레드의 동적 확장/다운을 제어하려면 maxMessagesPerTask 옵션도 참조하십시오.

1

int

replyToMaxConcurrentConsumers (producer)

JMS를 통해 request/reply를 사용할 때 최대 동시 소비자 수를 지정합니다. 스레드의 동적 확장/다운을 제어하려면 maxMessagesPerTask 옵션도 참조하십시오.

 

int

replyToOnTimeoutMaxConcurrentConsumers (producer)

JMS를 통해 요청/응답을 사용할 때 타임아웃이 발생할 때 연속 라우팅에 대한 최대 동시 소비자 수를 지정합니다.

1

int

replyToOverride (producer)

JMS 메시지에 명시적으로 ReplyTo 대상을 제공하여 replyTo 설정을 덮어씁니다. 메시지를 원격 큐로 전달하고 ReplyTo 대상에서 응답 메시지를 수신하려는 경우 유용합니다.

 

문자열

replyToType (producer)

JMS를 통해 request/reply를 수행할 때 replyTo 큐에 사용할 전략 종류를 명시적으로 지정할 수 있습니다. 가능한 값은 임시, 공유 또는 제외입니다. 기본적으로 Camel은 임시 대기열을 사용합니다. 그러나 replyTo가 구성된 경우 기본적으로 Shared가 사용됩니다. 이 옵션을 사용하면 공유된 큐 대신 전용 큐를 사용할 수 있습니다. 자세한 내용과 특히 클러스터형 환경에서 실행되는 경우의 영향 및 공유 응답 대기열의 성능이 대체 시간 및 제외보다 성능이 적다는 사실에 대한 자세한 내용은 Camel JMS 문서를 참조하십시오.

CloudEvent 값:

  • 임시
  • shared
  • exclusive
 

ReplyToType

requestTimeout (producer)

InOut 교환 패턴 (밀리초)을 사용할 때 응답을 기다리는 시간 초과입니다. 기본값은 20초입니다. CamelJmsRequestTimeout 헤더를 포함하여 이 엔드포인트 구성 시간 값을 재정의하고 메시지마다 개별 시간 초과 값을 포함할 수 있습니다. requestTimeoutCheckerInterval 옵션도 참조하십시오.

20000

long

TimeToLive (producer)

메시지를 보낼 때 메시지의 라이브 시간(밀리초)을 지정합니다.

-1

long

allowECDHEHeaders (producer (advanced))

이 옵션은 JMS 사양에 따라 유효하지 않은 값을 가질 수 있는 추가 헤더를 허용하는 데 사용됩니다. 예를 들어 WMQ와 같은 일부 메시지 시스템은 바이트 배열 또는 기타 유효하지 않은 유형이 있는 값이 포함된 JMS_IBM_MQECDHE_ 접두사를 사용하여 헤더 이름으로 이 작업을 수행합니다. 쉼표로 구분된 여러 헤더 이름을 지정하고 와일드카드 일치의 경우 접미사로 사용할 수 있습니다.

 

문자열

allowNullBody (producer (advanced))

본문 없이 메시지를 보낼 수 있는지 여부입니다. 이 옵션이 false이고 메시지 본문이 null이면 JMSException이 발생합니다.

true

boolean

alwaysCopyMessage (producer (advanced))

true인 경우 Camel은 전송을 위해 생산자로 전달할 때 항상 메시지의 JMS 메시지 사본을 만듭니다. replyToDestinationSelectorName이 설정된 경우와 같이 메시지를 복사하는 것이 필요합니다(예: replyToDestinationSelectorName이 설정된 경우 Camel은 alwaysCopyMessage 옵션을 true로 설정합니다).

false

boolean

correlationProperty (producer (advanced))

InOut 교환 패턴을 사용하는 경우 JMSCorrelationID JMS 속성 대신 이 JMS 속성을 사용하여 메시지의 상관 관계를 파악합니다. 설정된 메시지가 이 속성의 값에만 관련이 있는 경우 JMSCorrelationID 속성 값은 무시되며 Camel에서 설정하지 않습니다.

 

문자열

disableTimeToLive (producer (advanced))

이 옵션을 사용하여 실시간으로 비활성화 시간을 강제 적용합니다. 예를 들어 JMS를 통해 요청/응답을 수행하는 경우 Camel은 기본적으로 전송 중인 메시지에 실시간 requestTimeout 값을 사용합니다. 문제는 발신자와 수신자 시스템의 시계가 동기화되어 있어야 한다는 것입니다. 항상 압축하기 쉬운 것은 아닙니다. 따라서 disableTimeToLive=true를 사용하여 전송된 메시지에 실시간 값으로 시간을 설정하지 않을 수 있습니다. 그러면 메시지가 수신자 시스템에서 만료되지 않습니다. 자세한 내용은 아래 섹션(Time to live)을 참조하십시오.

false

boolean

forceSendOriginalMessage (producer)

mapJmsMessage=false Camel을 사용하면 경로 중 헤더(get 또는 set)를 만지면 새 JMS 대상으로 전송할 새 JMS 메시지를 생성합니다. Camel이 수신한 원래 JMS 메시지를 전송하도록 하려면 이 옵션을 true로 설정합니다.

false

boolean

includeSentJMSMessageID (producer(advanced))

InOnly를 사용하여 JMS 대상으로 보내는 경우에만 적용됩니다(예: 실행 및 잊기). 이 옵션을 활성화하면 메시지가 JMS 대상으로 전송되었을 때 JMS 클라이언트가 사용한 실제 JMSMessageID를 사용하여 Camel Exchange를 보강합니다.

false

boolean

replyToCacheLevelName (producer (advanced))

JMS를 통해 요청/reply할 때 응답 소비자의 이름별로 캐시 수준을 설정합니다. 이 옵션은 고정 응답 큐(임시 아님)를 사용하는 경우에만 적용됩니다. Camel은 기본적으로 사용합니다. 전용 또는 공유 w/ replyToSelectorName의 경우 CACHE_CONSUMER입니다. 그리고 replyToSelectorName 없이 공유되는 경우 CACHE_SESSION IBMNodePolicy와 같은 일부 JMS 브로커는 replyToCacheLevelName=CACHE_NONE을 작동으로 설정해야 할 수 있습니다. 참고: 임시 대기열을 사용하는 경우 CACHE_NONE은 허용되지 않으며 CACHE_CONSUMER 또는 CACHE_SESSION과 같은 더 높은 값을 사용해야 합니다.

CloudEvent 값:

  • CACHE_AUTO
  • CACHE_CONNECTION
  • CACHE_CONSUMER
  • CACHE_NONE
  • CACHE_SESSION
 

문자열

replyToDestinationSelectorName (producer)

공유 큐를 사용할 때(즉, 임시 응답 큐를 사용하지 않는 경우) 다른 사용자의 응답을 필터링할 수 있도록 고정 이름을 사용하여 JMS 선택기를 설정합니다.

 

문자열

streamMessageTypeEnabled (producer (advanced))

StreamMessage 유형이 활성화되었는지 여부를 설정합니다. 파일, InputStream 등과 같은 스트리밍 유형의 메시지 페이로드는 CloudEventsMessage 또는 StreamMessage로 전송됩니다. 이 옵션은 사용할 유형을 제어합니다. 기본적으로는 전체 메시지 페이로드를 메모리로 읽어오는 데 사용됩니다. 이 옵션을 사용하면 메시지 페이로드가 청크의 메모리에 읽어지고 각 청크는 더 이상 데이터가 없을 때까지 StreamMessage에 기록됩니다.

false

boolean

allowSerializedHeaders (advanced)

직렬화된 헤더를 포함할지 여부를 제어합니다. transferExchange가 true인 경우에만 적용됩니다. 이를 위해 오브젝트를 직렬화할 수 있어야 합니다. Camel은 비합리화 가능한 오브젝트를 제외하고 WARN 수준에서 기록합니다.

false

boolean

artemisStreamingEnabled (고급)

Apache Artemis 스트리밍 모드를 최적화할지 여부입니다. 이렇게 하면 Artemis를 JMS StreamMessage 유형과 함께 사용할 때 메모리 오버헤드가 줄어들 수 있습니다. 이 옵션은 Apache Artemis를 사용하는 경우에만 활성화해야 합니다.

false

boolean

asyncStartListener (advanced)

경로를 시작할 때 JmsConsumer 메시지 리스너를 비동기식으로 시작할지 여부입니다. 예를 들어 JmsConsumer가 원격 JMS 브로커에 대한 연결을 가져올 수 없는 경우 재시도 및/또는 장애 조치 동안 차단될 수 있습니다. 이로 인해 Camel이 경로를 시작하는 동안 차단됩니다. 이 옵션을 true로 설정하면 시작 라우팅이 허용되고 JmsConsumer는 비동기 모드에서 전용 스레드를 사용하여 JMS 브로커에 연결합니다. 이 옵션을 사용하는 경우 연결을 설정할 수 없는 경우 예외가 WARN 수준에서 기록되고 소비자는 메시지를 수신할 수 없습니다. 그런 다음 다시 시도하도록 경로를 다시 시작할 수 있습니다.

false

boolean

asyncStopListener (advanced)

경로를 중지할 때 JmsConsumer 메시지 리스너를 비동기식으로 중지할지 여부입니다.

false

boolean

destinationResolver (advanced)

플러그형 org.springframework.jms.support.destination.DestinationResolver - 자체 확인 프로그램을 사용할 수 있습니다(예: JNDI 레지스트리에서 실제 대상 조회).

 

DestinationResolver

errorHandler (advanced)

메시지를 처리하는 동안 발생하지 않는 예외의 경우 호출할 org.springframework.util.ErrorHandler를 지정합니다. 기본적으로 이러한 예외는 errorHandler가 구성되지 않은 경우 WARN 수준에서 기록됩니다. 로깅 수준과 errorHandlerLoggingLevel 및 errorHandlerLogStackTrace 옵션을 사용하여 스택 추적을 로깅할지 여부를 구성할 수 있습니다. 이렇게 하면 사용자 정의 errorHandler를 코딩하는 것보다 훨씬 쉽게 구성할 수 있습니다.

 

ErrorHandler

exceptionListener (advanced)

기본 JMS 예외 예외에 대한 알림을 받을 JMS Exception Listener를 지정합니다.

 

ExceptionListener

headerFilterStrategy (advanced)

사용자 정의 HeaderFilterStrategy를 사용하여 Camel 메시지 간 헤더를 필터링하려면 다음을 수행합니다.

 

HeaderFilterStrategy

idleConsumerLimit (advanced)

언제든지 유휴 상태로 설정할 수 있는 소비자 수에 대한 제한을 지정합니다.

1

int

idleTaskExecutionLimit (advanced)

실행 내에서 메시지를 수신하지 않고 수신 작업의 유휴 실행에 대한 제한을 지정합니다. 이 제한에 도달하면 작업이 종료되고 다른 실행 중인 작업에 수신이 유지됩니다(동적 스케줄링의 경우 maxConcurrentConsumers 설정 참조). Spring에서 제공하는 추가 문서도 있습니다.

1

int

includeAllJMSXProperties (advanced)

JMS에서 Camel Message로 매핑할 때 모든 JMSXxxx 속성을 포함할지 여부입니다. 이 값을 true로 설정하면 JMSXAppID 및 JMSXUserID 등과 같은 속성이 포함됩니다. 참고: 사용자 정의 headerFilterStrategy를 사용하는 경우 이 옵션은 적용되지 않습니다.

false

boolean

jmsKeyFormatStrategy (advanced)

JMS 키를 인코딩 및 디코딩하여 JMS 사양을 준수할 수 있도록 연결 가능한 전략입니다. Camel은 기본적으로 default 및 passthrough의 두 가지 구현을 제공합니다. 기본 전략은 점과 하이픈(. 및 -)을 안전하게 마샬링합니다. 패스스루 전략은 키를 그대로 유지합니다. JMS 헤더 키에 잘못된 문자가 포함되어 있는지 확인하지 않는 JMS 브로커에 사용할 수 있습니다. org.apache.camel.component.jms.JmsKeyFormatStrategy의 자체 구현을 제공하고 # 표기법을 사용하여 참조할 수 있습니다.

CloudEvent 값:

  • default
  • passthrough
 

JmsKeyFormatStrategy

mapJmsMessage (advanced)

Camel이 수신된 JMS 메시지를 javax.jms.knativeMessage와 같이 적절한 페이로드 유형으로 자동으로 매핑할지 여부를 String 등에 지정합니다.

true

boolean

maxMessagesPerTask (advanced)

작업당 메시지 수입니다. -1은 무제한입니다. 동시 소비자(예: min max)에 범위를 사용하는 경우 이 옵션을 사용하여 작업이 덜 필요할 때 소비자의 축소 속도를 제어하기 위해 값을 100으로 설정할 수 있습니다.

-1

int

MessageConverter (advanced)

javax.jms.jms.support.converter.MessageConverter 사용자 지정 Spring org.springframework.jms.MessageConverter를 사용하여 javax.jms.Message로 매핑하는 방법을 제어할 수 있습니다.

 

MessageConverter

messageCreatedStrategy (advanced)

Camel이 JMS 메시지를 보낼 때 Camel이 javax.jms.Message 개체의 새 인스턴스를 생성할 때 호출되는 지정된 MessageCreatedStrategy를 사용하려면 다음을 수행합니다.

 

MessageCreatedStrategy

messageIdEnabled (advanced)

전송할 때 메시지 ID를 추가해야 하는지 여부를 지정합니다. 이는 JMS 브로커에 대한 힌트일 뿐입니다. JMS 공급자가 이 힌트를 수락하면 이러한 메시지에 메시지 ID가 null로 설정되어 있어야 합니다. 공급자가 힌트를 무시하면 메시지 ID를 정상적인 고유 값으로 설정해야 합니다.

true

boolean

messageListenerContainerFactory (advanced)

메시지를 사용하는 데 사용할 org.springframework.jms.listener.AbstractMessageListenerContainery를 결정하는 데 사용되는 MessageListenerContainerFactory의 레지스트리 ID입니다. 이 값을 설정하면 consumerType이 Custom으로 자동 설정됩니다.

 

MessageListenerContainerFactory

messageTimestampEnabled (advanced)

메시지 전송 시 타임스탬프를 기본적으로 사용하도록 설정해야 하는지 여부를 지정합니다. 이는 JMS 브로커에 대한 힌트일 뿐입니다. JMS 공급자가 이 힌트를 수락하는 경우 이러한 메시지에는 타임스탬프가 0으로 설정되어 있어야 합니다. 공급자가 타임스탬프를 일반 값으로 설정해야 하는 힌트를 무시합니다.

true

boolean

ineSubNoLocal (advanced)

자체 연결에 의해 게시되는 메시지 전달을 억제할지 여부를 지정합니다.

false

boolean

receiveTimeout (advanced)

메시지 수신에 대한 제한 시간(밀리초)입니다.

1000

long

복구 간격 (advanced)

연결을 새로 고치는 경우(예: 밀리초) 복구 시도 간격을 지정합니다. 기본값은 5000ms, 즉 5초입니다.

5000

long

requestTimeoutCheckerInterval (advanced)

Camel이 JMS를 통해 요청/응답할 때 시간 초과 교환을 확인하는 빈도를 설정합니다. 기본적으로 Camel 검사는 초당 한 번 확인합니다. 그러나 시간 초과가 발생할 때 더 빠르게 대응해야 하는 경우 이 간격을 줄여 더 자주 확인할 수 있습니다. 시간 초과는 옵션 requestTimeout에 따라 결정됩니다.

1000

long

동기 (고급)

동기 처리를 엄격하게 사용해야 하는지 여부를 설정합니다.

false

boolean

TransferException (advanced)

사용 가능하며 소비자 측에서 Request Reply messaging (InOut)를 사용하고 있는 경우, 발생한 Exception은 javax.jms.ObjectMessage로 응답으로 다시 전송됩니다. 클라이언트가 Camel인 경우 반환된 Exception이 다시 표시됩니다. 이를 통해 Camel JMS를 라우팅의 브리지로 사용할 수 있습니다(예: 영구 대기열을 사용하여 강력한 라우팅 가능). transferExchange를 사용하도록 설정한 경우에도 이 옵션이 우선합니다. catch된 예외는 직렬화할 수 있어야 합니다. 소비자 측의 원래 예외는 org.apache.camel.RuntimeCamelException과 같은 외부 예외로 래핑할 수 있습니다. 데이터가 Java Object serialization을 사용하고 있으며 수신한 데이터를 클래스 수준에서 역직렬화할 수 있어야 하므로 생산자와 소비자 간에 강력한 결합이 강제 적용됩니다.

false

boolean

transfer exchange (advanced)

본문과 헤더 대신 전선을 통해 교환을 전송할 수 있습니다. 본문, 외부, Fault 본문, In headers, Out headers, Fault headers, Fault headers, exchange properties, exchange exception. 이를 위해 오브젝트를 직렬화할 수 있어야 합니다. Camel은 비합리화 가능한 오브젝트를 제외하고 WARN 수준에서 기록합니다. 생산자와 소비자 양쪽 모두에서 이 옵션을 활성화해야 하므로 Camel은 페이로드가 일반 페이로드가 아니라 Exchange임을 알고 있습니다. 데이터가 Java Object serialization을 사용하고 있고 수신자가 클래스 수준에서 데이터를 역직렬화할 수 있어야 하므로, 호환되는 Camel 버전을 사용해야 하는 생산자와 소비자 간에 강력한 결합이 강제 적용됩니다.

false

boolean

useMessageIDAsCorrelationID (advanced)

JMSMessageID가 항상 InOut 메시지의 JMSCorrelationID로 사용되어야 하는지 여부를 지정합니다.

false

boolean

waitForProvisionCorrelationToBeUpdatedCounter (advanced)

JMS에 대해 요청/응답을 수행할 때 및 option useMessageIDAsCorrelationID가 활성화될 때 임시 상관 관계 ID가 실제 상관 ID로 업데이트될 때까지 대기하는 횟수입니다.

50

int

waitForProvisionCorrelationToBeUpdatedThreadSleepingTime (advanced)

프로비저닝 상관 관계 ID가 업데이트되기를 기다리는 동안 매번 millis의 간격이 유휴 상태가 됩니다.

100

long

errorHandlerLoggingLevel (logging)

사용되지 않는 예외에 대해 기본 errorHandler 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

WARN

LoggingLevel

errorHandlerLogStackTrace (logging)

기본 errorHandler에 의해 stacktraces가 기록될지 여부를 제어할 수 있습니다.

true

boolean

암호 (보안)

ConnectionFactory와 함께 사용할 암호입니다. ConnectionFactory에서 직접 사용자 이름/암호를 구성할 수도 있습니다.

 

문자열

사용자 이름 (보안)

ConnectionFactory와 함께 사용할 사용자 이름입니다. ConnectionFactory에서 직접 사용자 이름/암호를 구성할 수도 있습니다.

 

문자열

트랜잭션됨 (ECDHE)

변환 모드를 사용할지 여부를 지정합니다.

false

boolean

TransactedInOut (ECDHE)

이 플래그가 true로 설정된 경우 InOut 작업(응답 요청)이 Transacted 모드를 사용하도록 기본지 여부를 지정합니다. 이 플래그를 true로 설정한 경우 Spring JmsTemplate이 true로 설정되고 InOut 작업에 사용되는 JmsTemplate에서 표시되는 acknowledgeMode가 true로 설정됩니다. Spring JMS: JTA 트랜잭션 내에서Queue에 전달된 매개변수는 createTopic 메서드가 고려되지 않습니다. Java EE 트랜잭션 컨텍스트에 따라 컨테이너는 이러한 값에 대해 자체 결정을 내립니다. 유사하게, 이러한 매개 변수는 이 경우 Spring JMS가 기존 JMS 세션에서 작동하기 때문에 로컬 관리 트랜잭션 내에서 고려되지 않습니다. 이 플래그를 true로 설정하면 관리 트랜잭션 외부에서 실행할 때 짧은 로컬 JMS 트랜잭션과 관리 트랜잭션(XA 트랜잭션 제외)이 있는 경우 동기화된 로컬 JMS 트랜잭션이 사용됩니다. 이는 JMS 트랜잭션이 기본 트랜잭션 직후에 커밋되는 기본 트랜잭션(기본 JDBC 트랜잭션일 수 있음)과 함께 관리되는 로컬 JMS 트랜잭션이 영향을 미칩니다.

false

boolean

lazyCreateTransactionManager (ECDHE (advanced))

true인 경우 Camel은 옵션이 transacted=true인 경우 트랜잭션 관리자가 삽입되지 않은 경우 JmsTransactionManager를 생성합니다.

true

boolean

TransactionManager (advanced)

Spring 트랜잭션 관리자가 사용할 수 있습니다.

 

PlatformTransactionManager

TransactionName (advanced)

사용할 트랜잭션의 이름입니다.

 

문자열

트랜잭션Timeout (advanced)

트랜잭션 모드를 사용하는 경우 트랜잭션 제한 값(초)입니다.

-1

int

26.5. 샘플

JMS는 다른 구성 요소에도 많은 예에서 사용됩니다. 그러나 시작하기 위해 아래에서 몇 가지 샘플을 제공합니다.

26.5.1. JMS에서 수신

다음 샘플에서는 JMS 메시지를 수신하고 메시지를 10.0.0.1으로 라우팅하는 경로를 구성합니다.

from("jms:queue:foo").
   to("bean:myBusinessLogic");

물론 EIP 패턴 중 하나를 사용할 수 있으므로 경로가 컨텍스트를 기반으로 할 수 있습니다. 예를 들어, 다음은 큰 소비자를 위한 주문 주제를 필터링하는 방법입니다.

from("jms:topic:OrdersTopic").
  filter().method("myBean", "isGoldCustomer").
  to("jms:queue:BigSpendersQueue");

26.5.2. JMS로 전송

아래 샘플에서 파일 폴더를 폴링하고 파일 콘텐츠를 JMS 주제로 보냅니다. 파일 내용을 10.0.0.1sMessage 대신 textMessage로 원하는 경우 본문을 String으로 변환해야 합니다.As we want the content of the file as a text Message instead of a 10.0.0.1sMessage, we need to convert the body to a String:

from("file://orders").
  convertBodyTo(String.class).
  to("jms:topic:OrdersTopic");

26.5.3. 주석 사용

Camel에는 주석도 있으므로 CloudEvent Consuming 및ECDHE Producing을 사용할 수 있습니다.

26.5.4. Spring DSL 샘플

이전 예에서는 Java DSL을 사용합니다. Camel은 Spring XML DSL도 지원합니다. 다음은 Spring DSL을 사용하는 큰 용도 샘플입니다.

<route>
  <from uri="jms:topic:OrdersTopic"/>
  <filter>
    <method ref="myBean" method="isGoldCustomer"/>
    <to uri="jms:queue:BigSpendersQueue"/>
  </filter>
</route>

26.5.5. 기타 샘플

JMS는 이 Camel 설명서의 다른 구성 요소 및 EIP 패턴에 대한 많은 예에서 나타납니다. 문서를 자유롭게 검색할 수 있습니다.

26.5.6. JMS를 Dead Letter Queue로 사용

일반적으로 JMS 를 전송으로 사용하면 페이로드로 본문과 헤더만 전송됩니다. Dead Letter Channel 과 함께 JMS 대기열을 사용하려는 경우 JMS 대기열을 Dead Letter Queue로 사용하여 생성된 Exception은 JMS 메시지에 저장되지 않습니다. 그러나 JMS dead letter 큐에서 transferExchange 옵션을 사용하여 Camel에 org.apache.camel.support.DefaultExchangeHolder 가 있는 javax.jms.ObjectMessage 로 전체 교환을 저장하도록 지시할 수 있습니다. 이를 통해 Dead Letter Queue에서 소비하고 Exchange.EXCEPTION_CAUGHT 키를 사용하여 Exchange 속성에서 발생한 예외를 검색할 수 있습니다. 아래 데모에서는 이를 보여줍니다.

// setup error handler to use JMS as queue and store the entire Exchange
errorHandler(deadLetterChannel("jms:queue:dead?transferExchange=true"));

그런 다음 JMS 큐에서 사용하고 문제를 분석할 수 있습니다.

from("jms:queue:dead").to("bean:myErrorAnalyzer");

// and in our bean
String body = exchange.getIn().getBody();
Exception cause = exchange.getProperty(Exchange.EXCEPTION_CAUGHT, Exception.class);
// the cause message is
String problem = cause.getMessage();

26.5.7. JMS를 Dead Letter Channel로 사용하여 오류를 저장

JMS를 사용하여 원인 오류 메시지를 저장하거나 사용자 지정 본문을 저장하여 초기화할 수 있습니다. 다음 예제에서는 MessageECDHE EIP를 사용하여 JMS dead letter 큐로 이동하기 전에 실패한 교환에 대해 변환을 수행합니다.

// we sent it to a seda dead queue first
errorHandler(deadLetterChannel("seda:dead"));

// and on the seda dead queue we can do the custom transformation before its sent to the JMS queue
from("seda:dead").transform(exceptionMessage()).to("jms:queue:dead");

여기서는 원본 원인 오류 메시지만 변환에 저장합니다. 그러나 모든 표현식을 사용하여 원하는 내용을 보낼 수 있습니다. 예를 들어 CloudEvent에서 메서드를 호출하거나 사용자 지정 프로세서를 사용할 수 있습니다.

26.6. JMS와 Camel 간의 메시지 매핑

Camel은 javax.jms.Messageorg.apache.camel.Message 사이에 메시지를 자동으로 매핑합니다.

Camel은 JMS 메시지를 전송할 때 메시지 본문을 다음 JMS 메시지 유형으로 변환합니다.

본문 유형JMS Messagecomment

문자열

javax.jms.TextMessage

 

org.w3c.dom.Node

javax.jms.TextMessage

10.0.0.1은 String 으로 변환됩니다.

map

javax.jms.MapMessage

 

java.io.Serializable

javax.jms.ObjectMessage

 

byte[]

javax.jms.BytesMessage

 

java.io.File

javax.jms.BytesMessage

 

java.io.Reader

javax.jms.BytesMessage

 

java.io.InputStream

javax.jms.BytesMessage

 

java.nio.ByteBuffer

javax.jms.BytesMessage

 

Camel은 JMS 메시지를 수신할 때 JMS 메시지를 다음 본문 유형으로 변환합니다.

JMS Message본문 유형

javax.jms.TextMessage

문자열

javax.jms.BytesMessage

byte[]

javax.jms.MapMessage

map<String, Object>

javax.jms.ObjectMessage

개체

26.6.1. JMS 메시지 자동 매핑 비활성화

mapJmsMessage 옵션을 사용하여 위의 자동 매핑을 비활성화할 수 있습니다. 비활성화되면 Camel은 수신된 JMS 메시지를 매핑하지 않고 대신 페이로드로 직접 사용합니다. 이를 통해 매핑 오버헤드를 방지하고 Camel이 JMS 메시지를 통과하도록 할 수 있습니다. 예를 들어, javax.jms.ObjectMessage JMS 메시지를 classpath에 없는 클래스로 라우팅할 수도 있습니다.

26.6.2. 사용자 정의 MessageConverter 사용

messageConverter 옵션을 사용하여 Spring org.springframework.jms.support.converter.MessageConverter 클래스에서 직접 매핑할 수 있습니다.

예를 들어 아래 경로에서 JMS 주문 큐로 메시지를 보낼 때 사용자 지정 메시지 변환기를 사용합니다.

from("file://inbox/order").to("jms:queue:order?messageConverter=#myMessageConverter");

JMS 대상에서 사용할 때 사용자 지정 메시지 변환기를 사용할 수도 있습니다.

26.6.3. 선택한 매핑 전략 제어

엔드포인트 URL에서 jmsMessageType 옵션을 사용하여 모든 메시지에 대해 특정 메시지 유형을 강제 적용할 수 있습니다.

아래 경로에서는 폴더의 파일을 폴링하여 JMS 생산자 끝점에서 텍스트 메시지를 사용해야 하므로 javax.jms.knativeMessage 로 보냅니다.

from("file://inbox/order").to("jms:queue:order?jmsMessageType=Text");

CamelJmsMessageType 키로 헤더를 설정하여 각 메시지에 사용할 메시지 유형을 지정할 수도 있습니다. 예를 들면 다음과 같습니다.

from("file://inbox/order").setHeader("CamelJmsMessageType", JmsMessageType.Text).to("jms:queue:order");

가능한 값은 org.apache.camel.jms.JmsMessageType 에 정의되어 있습니다.

26.7. 전송할 때 메시지 형식

JMS 전선을 통해 전송되는 교환은 JMS Message 사양 을 준수해야 합니다.

exchange.in.header 의 경우 헤더 키에 대해 다음 규칙이 적용됩니다.

  • JMS 또는 JMSX 로 시작하는 키는 예약되어 있습니다.
  • exchange.in.headers 키는 리터럴이어야 하며 모두 유효한 Java 식별자여야 합니다(키 이름에 점을 사용하지 마십시오).
  • Camel은 Dots & hyphens를 사용하는 경우 dots & hyphens를 대체합니다.
    .는 메시지를 사용할 때 'DOT' 및 리버스 교체로 교체됩니다.
    -'HYPHEN' 및 Camel이 메시지를 사용할 때 리버스 교체로 교체됩니다.
  • 키 포맷에 대한 자체 사용자 정의 전략을 사용할 수 있는 jmsKeyFormatStrategy 옵션도 참조하십시오.

exchange.in.header 의 경우 헤더 값에 대해 다음 규칙이 적용됩니다.

  • 값은 primitives 또는 카운터 오브젝트 (예: Integer,Long,Character)여야 합니다. 형식, 문자열,collectdSequence,Date,BigDecimalBigInteger 는 모두 toString() 표현으로 변환됩니다. 다른 모든 유형은 삭제됩니다.

Camel은 지정된 헤더 값을 삭제하는 경우 DEBUG 수준에서 org.apache.camel.component.jms.JmsBinding 범주로 기록합니다. 예를 들면 다음과 같습니다.

2008-07-09 06:43:04,046 [main           ] DEBUG JmsBinding
  - Ignoring non primitive header: order of class: org.apache.camel.component.jms.issues.DummyOrder with value: DummyOrder{orderId=333, itemId=4444, quantity=2}

26.8. 수신할 때 메시지 형식

Camel은 메시지를 수신할 때 교환에 다음 속성을 추가합니다.

속성유형설명

org.apache.camel.jms.replyDestination

javax.jms.Destination

응답 대상입니다.

Camel은 JMS 메시지를 수신할 때 In 메시지 헤더에 다음 JMS 속성을 추가합니다.

header유형설명

JMSCorrelationID

문자열

JMS 상관 관계 ID입니다.

JMSDeliveryMode

int

JMS 전달 모드입니다.

JMSDestination

javax.jms.Destination

JMS 대상입니다.

JMSExpiration

long

JMS 만료입니다.

JMSMessageID

문자열

JMS 고유 메시지 ID입니다.

JMSPriority

int

JMS 우선순위(0이 가장 낮은 우선 순위로, 9가 가장 높은 순위)입니다.

JMSRedelivered

boolean

JMS 메시지가 재전송됨입니다.

JMSReplyTo

javax.jms.Destination

JMS reply-to 대상입니다.

JMSTimestamp

long

JMS 타임스탬프입니다.

JMSType

문자열

JMS 유형입니다.

JMSXGroupID

문자열

JMS 그룹 ID입니다.

위의 모든 정보는 표준 JMS이므로 JMS 설명서에서 자세한 내용을 확인할 수 있습니다.

26.9. Camel을 사용하여 메시지 전송 및 수신 및 JMSReplyTo 정보

JMS 구성 요소는 복잡하고 경우에 따라 작동하는 방식에 주의해야 합니다. 이것은 찾기 위한 영역/파이프트의 일부에 대한 간략한 요약입니다.

Camel이 JMSProducer 를 사용하여 메시지를 전송하면 다음 조건을 확인합니다.

  • 상기 메시지 교환 패턴은, The message exchange pattern,
  • JMSReplyTo 가 끝점에 또는 메시지 헤더에 설정되었는지 여부
  • JMS 끝점에 다음 옵션이 설정되어 있는지 여부: disableReplyTo,preserveMessageQos,explicitQosEnabled.

이 모든 작업은 사용 사례를 지원하도록 이해하고 구성하는 데 복잡할 수 있습니다.

26.9.1. JmsProducer

JmsProducer 는 구성에 따라 다음과 같이 작동합니다.

교환 패턴기타 옵션설명

InOut

-

Camel은 응답을 예상하고 임시 JMSReplyTo 를 설정한 후 메시지를 보낸 후 임시 대기열에서 응답 메시지를 수신하기 시작합니다.

InOut

JMSReplyTo 가 설정됨

Camel은 응답을 예상하고 메시지를 보낸 후 지정된 JMSReplyTo 대기열에서 응답 메시지를 수신하기 시작합니다.

InOnly

-

Camel은 메시지를 전송하고 응답을 예상하지 않습니다.

InOnly

JMSReplyTo 가 설정됨

기본적으로 Camel은 JMSReplyTo 대상을 삭제하고 메시지를 보내기 전에 JMSReplyTo 헤더를 지웁니다. 그런 다음 Camel은 메시지를 전송하고 응답을 예상하지 않습니다. Camel은 WARN 수준에서 로그에 이 값을 기록합니다( Camel 2.6 에서 DEBUG 수준으로 변경됨). preserveMessageQuo=true 를 사용하여 Camel에 JMSReplyTo 를 유지하도록 지시할 수 있습니다. 모든 상황에서 JmsProducer 는 응답을 예상하지 않으므로 메시지를 보낸 후 계속 진행합니다.

26.9.2. JmsConsumer

JmsConsumer 는 구성에 따라 다음과 같이 작동합니다.

교환 패턴기타 옵션설명

InOut

-

Camel은 응답을 JMSReplyTo 대기열로 다시 보냅니다.

InOnly

-

Camel은 패턴은 InOnly 이므로 회신을 다시 보내지 않습니다.

-

disableReplyTo=true

이 옵션은 응답을 표시하지 않습니다.

따라서 교환에 설정된 메시지 교환 패턴에 주의하십시오.

경로 중간에 있는 JMS 대상에 메시지를 보내는 경우 사용할 교환 패턴을 지정할 수 있습니다. 자세한 내용은 Request Reply에서 참조하십시오.
이 기능은 InOnly 메시지를 JMS 항목에 보내려는 경우에 유용합니다.

from("activemq:queue:in")
   .to("bean:validateOrder")
   .to(ExchangePattern.InOnly, "activemq:topic:order")
   .to("bean:handleOrder");

26.10. 끝점 재사용 및 런타임 시 계산된 다른 대상으로 전송

다양한 JMS 대상에 메시지를 보내야 하는 경우 JMS 끝점을 재사용하고 메시지 헤더에서 실제 대상을 지정하는 것이 좋습니다. 이를 통해 Camel은 동일한 엔드포인트를 재사용할 수 있지만 다른 대상으로 보낼 수 있습니다. 이렇게 하면 메모리 및 스레드 리소스에 대한 끝점의 수가 크게 감소하고 발생합니다.

다음 헤더에 대상을 지정할 수 있습니다.

header유형설명

CamelJmsDestination

javax.jms.Destination

대상 오브젝트입니다.

CamelJmsDestinationName

문자열

대상 이름입니다.

예를 들어 다음 경로는 런타임에 대상을 계산하고 이를 사용하여 JMS URL에 표시되는 대상을 재정의하는 방법을 보여줍니다.

from("file://inbox")
  .to("bean:computeDestination")
  .to("activemq:queue:dummy");

큐 이름 dummy 는 자리 표시자일 뿐입니다. JMS 끝점 URL의 일부로 제공해야 하지만 이 예제에서는 무시됩니다.

computeDestination 빈에서 다음과 같이 CamelJmsDestinationName 헤더를 설정하여 실제 대상을 지정합니다.

public void setJmsHeader(Exchange exchange) {
   String id = ....
   exchange.getIn().setHeader("CamelJmsDestinationName", "order:" + id");
}

그런 다음 Camel은 이 헤더를 읽고 끝점에 구성된 헤더가 아닌 대상으로 사용합니다. 따라서 이 예에서 Camel은 id 값이 2라고 가정하여 activemq:queue:order:2 로 메시지를 보냅니다.

CamelJmsDestinationCamelJmsDestinationName 헤더가 모두 설정된 경우 CamelJmsDestination 이 우선합니다. JMS 생산자가 교환에서 CamelJmsDestinationCamelJmsDestinationName 헤더를 모두 제거하고 경로의 우발 루프를 방지하기 위해 생성된 JMS 메시지에 전달하지 않도록 합니다(메시지가 다른 JMS 끝점으로 전달될 경우의 시나리오).

26.11. 다양한 JMS 공급자 구성

다음과 같이 Spring XML에서 JMS 공급자를 구성할 수 있습니다.

기본적으로 원하는 만큼 JMS 구성 요소 인스턴스를 구성하고 id 특성을 사용하여 고유한 이름을 지정할 수 있습니다. 앞의 예제에서는 activemq 구성 요소를 구성합니다. 동일한 작업을 수행하여 MQSeries, TibCo, BEA, Sonic 등을 구성할 수 있습니다.

이름이 지정된 JMS 구성 요소가 있으면 URI를 사용하여 해당 구성 요소 내의 엔드포인트를 참조할 수 있습니다. 예를 들어 구성 요소 이름 activemq 의 경우 URI 형식 activemq:[queue:|topic:]destinationName 을 사용하여 대상을 참조할 수 있습니다. 다른 모든 JMS 공급자에 대해 동일한 접근 방식을 사용할 수 있습니다.

이 작업은 SpringCamelContext에서 끝점 URI에 사용하는 스키마 이름에 대한 Spring 컨텍스트에서 구성 요소를 가져오고 Component에서 끝점 URI를 확인하도록 합니다.

26.11.1. JNDI를 사용하여 ConnectionFactory 검색

J2EE 컨테이너를 사용하는 경우 Spring에서 일반적인 <ovn> 메커니즘을 사용하는 대신 JMS ConnectionFactory 를 찾으려면 JNDI를 조회해야 할 수 있습니다. Spring의 팩토리 빈 또는 새로운 Spring XML 네임스페이스를 사용하여 이 작업을 수행할 수 있습니다. 예를 들면 다음과 같습니다.

<bean id="weblogic" class="org.apache.camel.component.jms.JmsComponent">
  <property name="connectionFactory" ref="myConnectionFactory"/>
</bean>

<jee:jndi-lookup id="myConnectionFactory" jndi-name="jms/connectionFactory"/>

JNDI 조회에 대한 자세한 내용은 Spring 참조 설명서의 jee 스키마 를 참조하십시오.

26.12. 동시 소비자

JMS의 일반적인 요구 사항은 애플리케이션의 응답성을 높이기 위해 여러 스레드에서 동시에 메시지를 사용하는 것입니다. 다음과 같이 concurrentConsumers 옵션을 설정하여 JMS 끝점을 서비스하는 스레드 수를 지정할 수 있습니다.

from("jms:SomeQueue?concurrentConsumers=20").
  bean(MyClass.class);

다음 방법 중 하나로 이 옵션을 구성할 수 있습니다.

  • JmsComponent 에서
  • 끝점 URI 또는
  • JmsEndpoint 에서 직접 setConcurrentConsumers() 를 호출하여 다음을 실행합니다.

26.12.1. async Consuming with async consumer

각 동시 소비자는 현재 메시지가 완전히 처리되었을 때 JMS 브로커에서 사용 가능한 다음 메시지만 선택합니다. asyncConsumer=true 옵션을 설정하여 소비자가 JMS 대기열에서 다음 메시지를 선택하도록 할 수 있으며 이전 메시지는 비동기식 라우팅 엔진으로 처리됩니다. 페이지 상단에 있는 표의 asyncConsumer 옵션에 대한 자세한 내용을 참조하십시오.

from("jms:SomeQueue?concurrentConsumers=20&asyncConsumer=true").
  bean(MyClass.class);

26.13. JMS를 통한 요청

Camel은 JMS에 대한 요청을 지원합니다. JMS 큐로 메시지를 보낼 때 교환의 MEP는 InOut 이어야 합니다.

Camel은 성능 및 클러스터 환경에 영향을 미치는 JMS에 대해 요청을 구성하거나 구성하는 다양한 옵션을 제공합니다. 아래 표는 옵션을 요약합니다.

옵션성능Cluster설명

임시

신속 (Fast)

제공됨

임시 대기열은 응답 큐로 사용되며 Camel에서 자동으로 생성합니다. 이를 사용하려면 replyTo 큐 이름을 지정하지 않습니다. 필요한 경우 replyToType=Temporary 를 구성하여 임시 대기열이 사용 중임을 알 수 있습니다.

shared

느림

제공됨

공유 영구 큐는 응답 큐로 사용됩니다. 일부 브로커는 Apache ActiveMQ와 같은 이동에 해당 큐를 생성할 수 있지만 이전에 대기열을 생성해야 합니다. 이를 사용하려면 replyTo 큐 이름을 지정해야 합니다. 그리고 선택적으로 replyToType=Shared 를 구성하여 공유 대기열이 사용 중임을 알 수 있습니다. 공유 대기열은 이 Camel 애플리케이션을 동시에 실행하는 여러 노드로 클러스터된 환경에서 사용할 수 있습니다. 모두 동일한 공유 응답 큐를 사용합니다. 이는 JMS Message 선택기가 예상 응답 메시지의 상관 관계를 유지하는 데 사용되기 때문에 가능합니다. 그러나 성능에 영향을 미칩니다. JMS 메시지 선택기는 Temporary 또는 Exclusive 대기열만큼 빠르지 않기 때문에 속도가 느립니다. 더 나은 성능을 위해 이 문제를 해결하는 방법은 아래를 참조하십시오.

exclusive

신속 (Fast)

아니요 (*예)

전용 영구 큐는 응답 큐로 사용됩니다. 일부 브로커는 Apache ActiveMQ와 같은 이동에 해당 큐를 생성할 수 있지만 이전에 대기열을 생성해야 합니다. 이를 사용하려면 replyTo 큐 이름을 지정해야 합니다. replyTo 큐 이름이 구성된 경우 기본적으로 Shared 가 사용되므로 Camel에 전용 큐를 사용하도록 지정하려면 replyToType=Exclusive 를 구성해야 합니다. 배타적 응답 대기열을 사용하는 경우 JMS Message 선택기를 사용하지 않으므로 다른 애플리케이션에서도 이 큐를 사용하지 않아야 합니다. 이 Camel 애플리케이션을 실행하는 여러 노드가 있는 클러스터된 환경에서 배타적 대기열을 사용할 수 없습니다. 응답 대기열이 요청 메시지를 보낸 동일한 노드로 다시 제공되는지 제어할 수 없으므로 공유 대기열이 이를 확인하는 데 JMS Message 선택기를 사용합니다. 노드당 고유한 이름으로 각 Exclusive reply 큐를 구성하는 경우 클러스터형 환경에서 실행할 수 있습니다. 그러면 응답 메시지가 지정된 노드의 해당 큐로 다시 전송되어 응답 메시지를 기다립니다.

concurrentConsumers

신속 (Fast)

제공됨

동시 메시지 리스너를 사용하여 동시에 응답 메시지를 처리할 수 있습니다. concurrentConsumersmaxConcurrentConsumers 옵션을 사용하여 범위를 지정할 수 있습니다. 알림: 공유 응답 대기열을 사용하면 동시 리스너에서도 작동하지 않을 수 있으므로 이 옵션을 주의해서 사용하십시오.

maxConcurrentConsumers

신속 (Fast)

제공됨

동시 메시지 리스너를 사용하여 동시에 응답 메시지를 처리할 수 있습니다. concurrentConsumersmaxConcurrentConsumers 옵션을 사용하여 범위를 지정할 수 있습니다. 알림: 공유 응답 대기열을 사용하면 동시 리스너에서도 작동하지 않을 수 있으므로 이 옵션을 주의해서 사용하십시오.

JmsProducerInOut 을 감지하고 사용할 응답 대상과 함께 JMSReplyTo 헤더를 제공합니다. 기본적으로 Camel은 임시 큐를 사용하지만 끝점에서 replyTo 옵션을 사용하여 고정 응답 큐를 지정할 수 있습니다(정의된 응답 큐 참조).

Camel은 응답 대기열에서 수신 대기하는 소비자를 자동으로 설정하므로 아무 작업 수행하지 않아야 합니다.
이 소비자는 응답을 수신 대기하는 Spring DefaultMessageListenerContainer 입니다. 그러나 이는 동시 소비자 1개로 고정되어 있습니다.
즉, 응답을 처리할 수 있는 스레드가 1개뿐이므로 응답이 순서대로 처리됩니다. concurrentConsumersmaxConcurrentConsumers 옵션을 사용하여 동시 스레드를 사용하도록 리스너를 구성할 수 있습니다. 이렇게 하면 아래와 같이 Camel에서 이 값을 더 쉽게 구성할 수 있습니다.

from(xxx)
.inOut().to("activemq:queue:foo?concurrentConsumers=5")
.to(yyy)
.to(zzz);

이 경로에서는 Camel에 5 스레드가 있는 스레드 풀을 사용하여 비동기식으로 응답을 라우팅하도록 지시합니다.

26.13.1. request-reply over JMS 및 공유 고정된 응답 대기열 사용

아래 예제와 같이 JMS를 통해 요청 시 고정된 응답 대기열을 사용하는 경우 주의를 기울이십시오.

from(xxx)
.inOut().to("activemq:queue:foo?replyTo=bar")
.to(yyy)

이 예에서는 "bar"라는 고정된 응답 큐가 사용됩니다. 기본적으로 Camel은 고정 응답 대기열을 사용할 때 대기열이 공유되므로 JMSSelector 를 사용하여 예상되는 응답 메시지만 선택합니다(예: JMSCorrelationID). 전용 고정 응답 대기열은 다음 섹션을 참조하십시오. 즉, 임시 대기열만큼 빠르지 않습니다. receiveTimeout 옵션을 사용하여 Camel이 응답 메시지를 가져오는 빈도를 가속화할 수 있습니다. 기본적으로 1000 밀is입니다. 따라서 더 빨리 만들기 위해 다음과 같이 초당 4 회 당 4 배를 가져 오기 위해 250 밀is로 설정할 수 있습니다.

from(xxx)
.inOut().to("activemq:queue:foo?replyTo=bar&receiveTimeout=250")
.to(yyy)

이로 인해 Camel이 메시지 브로커에 더 자주 가져오기 요청을 보내 더 많은 네트워크 트래픽이 필요합니다.
가능한 경우 일반적으로 임시 큐를 사용하는 것이 좋습니다.

26.13.2. JMS를 통한 요청 및 전용 고정 응답 대기열 사용

이전 예에서 Camel은 "bar"라는 고정된 응답 대기열이 공유될 것으로 예상하므로 JMSSelector 를 사용하여 예상 응답 메시지만 사용합니다. 그러나 JMS 선택기가 더 느리기 때문에 이 작업을 수행하는 결함이 있습니다. 또한 응답 대기열의 소비자는 새로운 JMS 선택기 ID로 업데이트하는 속도가 느립니다. 실제로 receiveTimeout 옵션이 시간 초과된 경우에만 업데이트됩니다. 기본값은 1초입니다. 따라서 이론적으로는 응답 메시지가 감지되는 데 약 1초 정도 걸릴 수 있습니다. 반면 고정 응답 대기열이 Camel 응답 소비자에만 한정적인 경우 JMS 선택기를 사용하지 않도록 할 수 있으므로 성능이 향상됩니다. 실제로 임시 대기열을 사용하는 것처럼 빠릅니다. 다음 예제와 같이 Camel에 응답 대기열이 독점적임을 알리기 위해 Exclusive
로 설정할 수 있는 ReplyToType 옵션이 있습니다.

from(xxx)
.inOut().to("activemq:queue:foo?replyTo=bar&replyToType=Exclusive")
.to(yyy)

큐는 각 끝점에 대해 배타적이어야 합니다. 두 개의 경로가 있으면 각각 다음 예와 같이 고유한 응답 대기열이 필요합니다.

from(xxx)
.inOut().to("activemq:queue:foo?replyTo=bar&replyToType=Exclusive")
.to(yyy)

from(aaa)
.inOut().to("activemq:queue:order?replyTo=order.reply&replyToType=Exclusive")
.to(bbb)

클러스터형 환경에서 실행되는 경우에도 마찬가지입니다. 그런 다음 클러스터의 각 노드는 고유한 응답 대기열 이름을 사용해야 합니다. 그렇지 않으면 클러스터의 각 노드가 다른 노드에서 응답로 의도한 메시지를 선택할 수 있습니다. 클러스터형 환경의 경우 공유 응답 대기열을 대신 사용하는 것이 좋습니다.

26.14. 발신자와 수신자 간 클럭 동기화

시스템 간에 메시징을 수행할 때 시스템의 시계가 동기화된 것이 좋습니다. 예를 들어 JMS 메시지를 보낼 때 시간을 메시지의 라이브 값으로 설정할 수 있습니다. 그러면 수신자는 이 값을 검사하고 메시지가 이미 만료되었는지 확인하여 메시지를 소비하고 처리하는 대신 메시지를 삭제할 수 있습니다. 그러나 이를 위해서는 발신자와 수신자 모두 시계가 동기화되어야 합니다. ActiveMQ 를 사용하는 경우 타임 스탬프 플러그인 을 사용하여 시계를 동기화할 수 있습니다.

26.15. 라이브 시간 정보

동기화된 시계에 대해 먼저 읽습니다.

Camel을 사용하여 JMS 를 통해 request/reply(InOut)를 수행하면 Camel은 발신자 측에 시간 초과를 사용하며, 이는 requestTimeout 옵션에서 기본 20초입니다. 이 값은 더 높거나 낮은 값을 설정하여 제어할 수 있습니다. 그러나 라이브 값의 시간은 전송 중인 메시지에 여전히 설정됩니다. 이렇게 하려면 시스템 간에 시계를 동기화해야 합니다. 그렇지 않은 경우 설정 중인 라이브 값을 사용하지 않도록 설정할 수 있습니다. 이제 Camel 2.8 이후의 disableTimeToLive 옵션을 사용할 수 있습니다. 따라서 이 옵션을 disableTimeToLive=true 로 설정하면 Camel은 JMS 메시지를 전송할 때 실시간 값으로 설정하지 않습니다. 그러나 요청 제한 시간은 계속 활성화되어 있습니다. 예를 들어 JMS 를 요청/응답하고 라이브 시간이 비활성화된 경우 Camel은 계속 시간 초과를 20초( 요청Timeout 옵션)로 사용합니다. 물론 이 옵션도 설정할 수 있습니다. 따라서 두 가지 옵션 requestTimeoutdisableTimeToLive 를 사용하면 request/reply를 수행할 때 세부적으로 제어할 수 있습니다.

메시지에 헤더를 제공하고 엔드포인트 구성 값 대신 요청 시간 초과 값으로 사용할 수 있습니다. 예를 들면 다음과 같습니다.

   from("direct:someWhere")
     .to("jms:queue:foo?replyTo=bar&requestTimeout=30s")
     .to("bean:processReply");

위의 경로에는 requestTimeout 이 30초로 구성되었습니다. 따라서 Camel은 해당 응답 메시지가 바 큐에서 다시 표시될 때까지 30초 동안 기다립니다. 응답 메시지가 수신되지 않으면 org.apache.camel.ExchangeTimedOutException 이 Exchange에 설정되고 Camel은 메시지를 계속 라우팅하고, 이로 인해 예외가 발생하며 Camel의 오류 처리기가 반응합니다.

메시지 제한 시간별 값을 사용하려면 org.apache.camel.component.jmsConstants.JmsConstants#JMS_REQUEST_TIMEOUT 키로 헤더를 설정할 수 있습니다. 이에는 시간 초과 값이 "CamelJmsRequestTimeout" 이 있습니다.

예를 들어, 빈을 사용하여 다음과 같이 서비스 빈에서 "whatIsTheTimeout" 메서드 호출과 같이 개별 메시지당 시간 초과 값을 계산할 수 있습니다.

from("direct:someWhere")
  .setHeader("CamelJmsRequestTimeout", method(ServiceBean.class, "whatIsTheTimeout"))
  .to("jms:queue:foo?replyTo=bar&requestTimeout=30s")
  .to("bean:processReply");

Camel을 사용하여 JMS 에서 실행 및 잊어버린 경우 Camel은 기본적으로 메시지의 라이브 값으로 설정할 시간을 설정하지 않습니다. timeToLive 옵션을 사용하여 값을 구성할 수 있습니다. 예를 들어 5초를 나타내기 위해 timeToLive=5000 을 설정합니다. disableTimeToLive 옵션을 사용하면 InOnly 메시징에 대한 라이브 시간을 강제로 비활성화할 수 있습니다. requestTimeout 옵션이 InOnly 메시징에 사용되지 않습니다.

26.16. iPXE 사용 활성화

일반적인 요구 사항은 트랜잭션에서 큐에서 사용한 다음 Camel 경로를 사용하여 메시지를 처리하는 것입니다. 이렇게 하려면 구성 요소/엔드포인트에서 다음 속성을 설정해야 합니다.

  • Transacted = true
  • TransactionManager = Transsaction Manager - 일반적으로 JmsTransactionManager

자세한 내용은 Transactional Client EIP 패턴을 참조하십시오.

JMS에 대한 트랜잭션 및 [reply]

JMS를 통해 Request Reply를 사용하면 단일 트랜잭션을 사용할 수 없습니다. JMS는 커밋이 수행될 때까지 메시지를 보내지 않으므로 서버 측은 트랜잭션이 커밋될 때까지 전혀 수신되지 않습니다. 따라서 Request Reply 를 사용하려면 요청을 보낸 후 별도의 트랜잭션을 사용하여 응답을 수신해야 합니다.

이 문제를 해결하기 위해 JMS 구성 요소는 다른 속성을 사용하여 단방향 메시징 및 요청 응답 메시지에 트랜잭션 사용을 지정합니다.

트랜잭션된 속성은 InOnly 메시지 교환 패턴(MEP) 에만 적용됩니다.

구성 요소/엔드포인트에서 다음 속성을 사용하여 변환된 세션 API 를 활용할 수 있습니다.

  • Transacted = true
  • lazyCreateTransactionManager = false

이렇게 하면 구성된 TransactionManager 없이 로컬 트랜잭션을 사용할 때 cacheLevel 설정이 적용됩니다. TransactionManager가 구성되면 DMLC 수준에서 캐싱이 수행되지 않으며 풀링된 연결 팩토리에 의존해야 합니다. 이러한 종류의 설정에 대한 자세한 내용은 여기 및 여기를 참조하십시오.

26.17. 최근 응답에 JMSReplyTo 사용

Camel을 JMS 리스너로 사용할 때 키 ReplyTo javax.jms.Destination 오브젝트의 값을 사용하여 Exchange 속성을 설정합니다. 다음과 같이 이 대상 을 얻을 수 있습니다.

Destination replyDestination = exchange.getIn().getHeader(JmsConstants.JMS_REPLY_DESTINATION, Destination.class);

나중에 이를 사용하여 일반 JMS 또는 Camel을 사용하여 응답을 보냅니다.

// we need to pass in the JMS component, and in this sample we use ActiveMQ
JmsEndpoint endpoint = JmsEndpoint.newInstance(replyDestination, activeMQComponent);
// now we have the endpoint we can use regular Camel API to send a message to it
template.sendBody(endpoint, "Here is the late reply.");

응답을 보내는 다른 해결책은 보낼 때 동일한 Exchange 속성에 replyDestination 오브젝트를 제공하는 것입니다. 그런 다음 Camel이 이 속성을 선택하여 실제 대상에 사용합니다. 그러나 끝점 URI에는 더미 대상을 포함해야 합니다. 예를 들면 다음과 같습니다.

// we pretend to send it to some non existing dummy queue
template.send("activemq:queue:dummy, new Processor() {
   public void process(Exchange exchange) throws Exception {
      // and here we override the destination with the ReplyTo destination object so the message is sent to there instead of dummy
      exchange.getIn().setHeader(JmsConstants.JMS_DESTINATION, replyDestination);
      exchange.getIn().setBody("Here is the late reply.");
    }
}

26.18. 요청 시간 초과 사용

아래 샘플에서 Request Reply 스타일 메시지 교환(예: requestBody 메서드 = InOut사용)을 Camel에서 추가로 처리하기 위해 느린 큐로 전송하고 반환되는 응답을 기다립니다.

26.19. InOnly 메시지 전송 및 JMSReplyTo 헤더 유지

camel-jms 를 사용하여 JMS 대상으로 보내는 경우 생산자는 MEP를 사용하여 InOnly 또는 InOut 메시징을 탐지합니다. 그러나 InOnly 메시지를 보내려는 경우가 있지만 JMSReplyTo 헤더를 유지할 수 있습니다. 이렇게 하려면 Camel에 보관하도록 지시해야 합니다. 그러지 않으면 JMSReplyTo 헤더가 삭제됩니다.

예를 들어 InOnly 메시지를 foo 큐에 전송하지만 bar 큐가 있는 JMSReplyTo 를 사용하면 다음과 같이 수행할 수 있습니다.

template.send("activemq:queue:foo?preserveMessageQos=true", new Processor() {
   public void process(Exchange exchange) throws Exception {
      exchange.getIn().setBody("World");
      exchange.getIn().setHeader("JMSReplyTo", "bar");
    }
});

preserveMessageQos=true 를 사용하여 Camel에 JMSReplyTo 헤더를 유지하도록 지시합니다.

26.20. 대상에서 JMS 공급자 옵션 설정

IBM의anchor MQ와 같은 일부 JMS 공급자에는 JMS 대상에서 옵션을 설정해야 합니다. 예를 들어 targetClient 옵션을 지정해야 할 수도 있습니다. targetClient 는 Camel URI 옵션이 아닌 CloudEvent MQ 옵션이므로 다음과 같이 JMS 대상 이름에 이 옵션을 설정해야 합니다.

// ...
.setHeader("CamelJmsDestinationName", constant("queue:///MY_QUEUE?targetClient=1"))
.to("wmq:queue:MY_QUEUE?useMessageIDAsCorrelationID=true");

WMQ의 일부 버전에서는 대상 이름에서 이 옵션을 허용하지 않으므로 다음과 같은 예외가 발생합니다.

com.ibm.msg.client.jms.DetailedJMSException: JMSCC0005: The specified
value 'MY_QUEUE?targetClient=1' is not allowed for
'XMSC_DESTINATION_NAME'

해결방법은 사용자 지정 DestinationResolver를 사용하는 것입니다.

JmsComponent wmq = new JmsComponent(connectionFactory);

wmq.setDestinationResolver(new DestinationResolver() {
    public Destination resolveDestinationName(Session session, String destinationName, boolean pubSubDomain) throws JMSException {
        MQQueueSession wmqSession = (MQQueueSession) session;
        return wmqSession.createQueue("queue:///" + destinationName + "?targetClient=1");
    }
});

26.21. Spring Boot Auto-Configuration

Spring Boot와 함께 jms를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-jms-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.jms.accept-messages-while-stopping

중지하는 동안 소비자가 메시지를 수락하는지 여부를 지정합니다. 큐에 있는 메시지가 여전히 있는 동안 런타임에 JMS 경로를 시작하고 중지하는 경우 이 옵션을 활성화하는 것을 고려할 수 있습니다. 이 옵션이 false이고 JMS 경로를 중지하면 메시지가 거부될 수 있으며 JMS 브로커는 다시 거부될 수 있으며, 결국 메시지가 JMS 브로커에서 dead letter queue로 이동될 수 있습니다. 이 옵션을 사용하지 않도록 설정하는 것이 좋습니다.

false

부울

camel.component.jms.acknowledgement-mode-name

SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, AUTO_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE 중 하나인 JMS 승인 이름.

AUTO_ACKNOWLEDGE

문자열

camel.component.jms.allow-additional-headers

이 옵션은 JMS 사양에 따라 유효하지 않은 값을 가질 수 있는 추가 헤더를 허용하는 데 사용됩니다. 예를 들어 WMQ와 같은 일부 메시지 시스템은 바이트 배열 또는 기타 유효하지 않은 유형이 있는 값이 포함된 JMS_IBM_MQECDHE_ 접두사를 사용하여 헤더 이름으로 이 작업을 수행합니다. 쉼표로 구분된 여러 헤더 이름을 지정하고 와일드카드 일치의 경우 접미사로 사용할 수 있습니다.

 

문자열

camel.component.jms.allow-auto-wired-connection-factory

연결 팩토리가 구성되지 않은 경우 레지스트리에서 ConnectionFactory를 자동 검색할지 여부입니다. 하나의 ConnectionFactory 인스턴스만 발견되면 사용됩니다. 이는 기본적으로 활성화되어 있습니다.

true

부울

camel.component.jms.allow-auto-wired-destination-resolver

대상 해결 프로그램이 구성되지 않은 경우 레지스트리에서 DestinationResolver를 자동 검색할지 여부입니다. DestinationResolver 인스턴스가 하나만 발견되면 사용됩니다. 이는 기본적으로 활성화되어 있습니다.

true

부울

camel.component.jms.allow-null-body

본문 없이 메시지를 보낼 수 있는지 여부입니다. 이 옵션이 false이고 메시지 본문이 null이면 JMSException이 발생합니다.

true

부울

camel.component.jms.allow-reply-manager-quick-stop

request-reply 메시징에 대해 응답 관리자에 사용되는 DefaultMessageListenerContainer.runningAllowed 플래그를 사용하면 JmsConfiguration#isAcceptMessagesWhileStopping이 활성화되고 org.apache.camel.CamelContext가 중지되는 경우 DefaultMessageListenerContainer.runningAllowed 플래그를 빠르게 중지할 수 있습니다. 이 빠른 중지 기능은 일반 JMS 소비자에서 기본적으로 활성화되어 있지만 응답 관리자를 활성화하려면 이 플래그를 활성화해야 합니다.

false

부울

camel.component.jms.allow-serialized-headers

직렬화된 헤더를 포함할지 여부를 제어합니다. transferExchange가 true인 경우에만 적용됩니다. 이를 위해 오브젝트를 직렬화할 수 있어야 합니다. Camel은 비합리화 가능한 오브젝트를 제외하고 WARN 수준에서 기록합니다.

false

부울

camel.component.jms.always-copy-message

true인 경우 Camel은 전송을 위해 생산자로 전달할 때 항상 메시지의 JMS 메시지 사본을 만듭니다. replyToDestinationSelectorName이 설정된 경우와 같이 메시지를 복사하는 것이 필요합니다(예: replyToDestinationSelectorName이 설정된 경우 Camel은 alwaysCopyMessage 옵션을 true로 설정합니다).

false

부울

camel.component.jms.artemis-consumer-priority

소비자 우선 순위를 사용하면 높은 우선 순위의 소비자가 활성화된 동안 메시지를 수신하는지 확인할 수 있습니다. 일반적으로 큐에 연결된 활성 소비자는 라운드 로빈 방식으로 메시지를 수신합니다. 소비자 우선순위가 사용 중인 경우 여러 활성 사용자가 동일한 높은 우선 순위로 있는 경우 메시지가 라운드 로빈으로 전달됩니다. 높은 우선 순위의 소비자가 메시지를 사용하는 데 사용할 수 없는 경우 또는 높은 우선 순위의 소비자가 메시지를 수락하지 않은 경우(예: 소비자와 연결된 모든 선택기의 기준을 충족하지 않기 때문에 메시지는 우선 순위가 낮은 소비자만 사용하게 됩니다).

 

정수

camel.component.jms.artemis-streaming-enabled

Apache Artemis 스트리밍 모드를 최적화할지 여부입니다. 이렇게 하면 Artemis를 JMS StreamMessage 유형과 함께 사용할 때 메모리 오버헤드가 줄어들 수 있습니다. 이 옵션은 Apache Artemis를 사용하는 경우에만 활성화해야 합니다.

false

부울

camel.component.jms.async-consumer

JmsConsumer에서 교환을 비동기식으로 처리할지 여부입니다. 활성화하면 JmsConsumer가 JMS 대기열에서 다음 메시지를 선택할 수 있지만 이전 메시지는 비동기 라우팅 엔진에서 비동기적으로 처리됩니다. 즉, 메시지가 100% 엄격하게 처리되지 않을 수 있습니다. 비활성화 된 경우 (기본적으로) 교환은 JmsConsumer가 JMS 큐에서 다음 메시지를 선택하기 전에 완전히 처리됩니다. 트랜잭션이 활성화된 경우 트랜잭션을 동시에 실행해야 하므로 비동기식으로 asyncConsumer=true가 실행되지 않습니다(Camel 3.0에서 비동기 트랜잭션을 지원할 수 있음).

false

부울

camel.component.jms.async-start-listener

경로를 시작할 때 JmsConsumer 메시지 리스너를 비동기식으로 시작할지 여부입니다. 예를 들어 JmsConsumer가 원격 JMS 브로커에 대한 연결을 가져올 수 없는 경우 재시도 및/또는 장애 조치 동안 차단될 수 있습니다. 이로 인해 Camel이 경로를 시작하는 동안 차단됩니다. 이 옵션을 true로 설정하면 시작 라우팅이 허용되고 JmsConsumer는 비동기 모드에서 전용 스레드를 사용하여 JMS 브로커에 연결합니다. 이 옵션을 사용하는 경우 연결을 설정할 수 없는 경우 예외가 WARN 수준에서 기록되고 소비자는 메시지를 수신할 수 없습니다. 그런 다음 다시 시도하도록 경로를 다시 시작할 수 있습니다.

false

부울

camel.component.jms.async-stop-listener

경로를 중지할 때 JmsConsumer 메시지 리스너를 비동기식으로 중지할지 여부입니다.

false

부울

camel.component.jms.auto-startup

소비자 컨테이너가 자동으로 시작되어야 하는지 여부를 지정합니다.

true

부울

camel.component.jms.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.jms.cache-level

기본 JMS 리소스의 ID로 캐시 수준을 설정합니다. 자세한 내용은 cacheLevelName 옵션을 참조하십시오.

 

정수

camel.component.jms.cache-level-name

기본 JMS 리소스에 대한 이름별로 캐시 수준을 설정합니다. 가능한 값은 CACHE_AUTO, CACHE_CONNECTION, CACHE_CONSUMER, CACHE_NONE 및 CACHE_SESSION입니다. 기본 설정은 CACHE_AUTO입니다. 자세한 내용은 Spring 문서 및 트랜잭션 캐시 수준을 참조하십시오.

CACHE_AUTO

문자열

camel.component.jms.client-id

사용할 JMS 클라이언트 ID를 설정합니다. 이 값은 지정하는 경우 고유해야 하며 단일 JMS 연결 인스턴스에서만 사용할 수 있습니다. 일반적으로 지속성 주제 서브스크립션에만 필요합니다. Apache ActiveMQ를 사용하는 경우 대신 Virtual Topics를 사용할 수 있습니다.

 

문자열

camel.component.jms.concurrent-consumers

JMS에서 사용할 때 기본 동시 소비자 수를 지정합니다( JMS를 통해 요청/응답이 아님). 스레드의 동적 확장/다운을 제어하려면 maxMessagesPerTask 옵션도 참조하십시오. JMS를 통해 요청/응답을 수행할 때 replyToConcurrentConsumers 옵션은 응답 메시지 리스너에서 동시 소비자 수를 제어하는 데 사용됩니다.

1

정수

camel.component.jms.configuration

공유 JMS 구성을 사용하려면 다음을 수행합니다. 옵션은 org.apache.camel.component.jms.JmsConfiguration 유형입니다.

 

JmsConfiguration

camel.component.jms.connection-factory

사용할 연결 팩토리입니다. 연결 팩토리는 구성 요소 또는 끝점에서 구성해야 합니다. 옵션은 javax.jms.ConnectionFactory 유형입니다.

 

ConnectionFactory

camel.component.jms.consumer-type

사용할 소비자 유형(간단, 기본값 또는 사용자 지정) 중 하나일 수 있습니다. 소비자 유형에 따라 사용할 Spring JMS 리스너가 결정됩니다. Default는 org.springframework.jms.listener.DefaultMessageListenerContainer를 사용합니다. Simple는 org.springframework.jms.listener.SimpleMessageListenerContainer를 사용합니다. Custom이 지정되면 messageListenerContainerFactory로 정의된 MessageListenerContainerFactory 옵션에 따라 사용할 org.springframework.jms.listener.AbstractMessageListenerContainerContainery가 결정됩니다.

 

ConsumerType

camel.component.jms.correlation-property

InOut 교환 패턴을 사용하는 경우 JMSCorrelationID JMS 속성 대신 이 JMS 속성을 사용하여 메시지의 상관 관계를 파악합니다. 설정된 메시지가 이 속성의 값에만 관련이 있는 경우 JMSCorrelationID 속성 값은 무시되며 Camel에서 설정하지 않습니다.

 

문자열

camel.component.jms.default-task-executor-type

소비자 끝점과 생산자 끝점의 ReplyTo 소비자 모두에 DefaultMessageListenerContainer에서 사용할 기본 TaskExecutor 유형을 지정합니다. 가능한 값: SimpleAsync(S Spring의 SimpleAsyncTaskExecutor 사용) 또는 ThreadPool(프링의 ThreadPoolTaskExecutor를 최적의 값으로 사용) - 캐시된 threadpool-like. 설정하지 않으면 기본적으로 소비자 엔드포인트에 캐시된 스레드 풀을 사용하고 응답 소비자에는 SimpleAsync를 사용하는 이전 동작으로 설정됩니다. ThreadPool을 사용하면 동시 소비자를 동적으로 증가 및 줄임으로써 탄력적 구성에서 스레드 트래시를 줄이는 것이 좋습니다.

 

DefaultTaskExecutorType

camel.component.jms.delivery-delay

JMS에 대한 send 호출에 사용할 전달 지연을 설정합니다. 이 옵션을 사용하려면 JMS 2.0 호환 브로커가 필요합니다.

-1

long

camel.component.jms.delivery-mode

사용할 전달 모드를 지정합니다. 가능한 값은 javax.jms.DeliveryMode에서 정의한 값입니다. NON_PERSISTENT = 1 및 PERSISTENT = 2.

 

정수

camel.component.jms.delivery-persistent

기본적으로 영구 제공이 사용되는지 여부를 지정합니다.

true

부울

camel.component.jms.destination-resolver

플러그형 org.springframework.jms.support.destination.DestinationResolver - 자체 확인 프로그램을 사용할 수 있습니다(예: JNDI 레지스트리에서 실제 대상 조회). 옵션은 org.springframework.jms.support.destination.DestinationResolver 유형입니다.

 

DestinationResolver

camel.component.jms.disable-reply-to

Camel이 메시지에서 JMSReplyTo 헤더를 무시하는지 여부를 지정합니다. true인 경우 Camel은 JMSReplyTo 헤더에 지정된 대상으로 회신을 다시 보내지 않습니다. Camel을 경로에서 사용하고 코드의 다른 구성 요소가 응답 메시지를 처리하므로 Camel이 응답 메시지를 자동으로 다시 전송하지 않도록 하려면 이 옵션을 사용할 수 있습니다. 다른 메시지 브로커 간의 프록시로 Camel을 사용하고 한 시스템에서 다른 시스템으로 메시지를 라우팅하려는 경우에도 이 옵션을 사용할 수 있습니다.

false

부울

camel.component.jms.disable-time-to-live

이 옵션을 사용하여 실시간으로 비활성화 시간을 강제 적용합니다. 예를 들어 JMS를 통해 요청/응답을 수행하는 경우 Camel은 기본적으로 전송 중인 메시지에 실시간 requestTimeout 값을 사용합니다. 문제는 발신자와 수신자 시스템의 시계가 동기화되어 있어야 한다는 것입니다. 항상 압축하기 쉬운 것은 아닙니다. 따라서 disableTimeToLive=true를 사용하여 전송된 메시지에 실시간 값으로 시간을 설정하지 않을 수 있습니다. 그러면 메시지가 수신자 시스템에서 만료되지 않습니다. 자세한 내용은 아래 섹션(Time to live)을 참조하십시오.

false

부울

camel.component.jms.durable-subscription-name

해제된 주제 서브스크립션을 지정하기 위한 조정된 구독자 이름입니다. clientId 옵션도 구성해야 합니다.

 

문자열

camel.component.jms.eager-loading-of-properties

JMS 속성이 필요하지 않을 수 있으므로 일반적으로 비효율적이지만 기본 JMS 공급자 및 JMS 속성 사용에 대한 모든 문제를 조기에 가져올 수 있으므로 메시지가 로드되는 즉시 JMS 속성 및 페이로드를 빠르게 로드할 수 있습니다. eagerPoisonBody 옵션도 참조하십시오.

false

부울

camel.component.jms.eager-poison-body

eagerLoadingOfProperties가 활성화되어 있고 JMS 메시지 페이로드(JMS 본문 또는 JMS 속성)가 Poison이면 이 텍스트를 메시지 본문으로 설정하여 메시지가 처리될 수 있도록 합니다(Emblict의 원인은 Exchange에서 예외로 저장됨). 이 기능은 eagerPoisonBody=false를 설정하여 비활성화할 수 있습니다. eagerLoadingOfProperties 옵션도 참조하십시오.

$\{exception.message}로 인한 JMS 메시지 중독

문자열

camel.component.jms.enabled

jms 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.jms.error-handler

메시지를 처리하는 동안 발생하지 않는 예외의 경우 호출할 org.springframework.util.ErrorHandler를 지정합니다. 기본적으로 이러한 예외는 errorHandler가 구성되지 않은 경우 WARN 수준에서 기록됩니다. 로깅 수준과 errorHandlerLoggingLevel 및 errorHandlerLogStackTrace 옵션을 사용하여 스택 추적을 로깅할지 여부를 구성할 수 있습니다. 이렇게 하면 사용자 정의 errorHandler를 코딩하는 것보다 훨씬 쉽게 구성할 수 있습니다. 옵션은 org.springframework.util.ErrorHandler 유형입니다.

 

ErrorHandler

camel.component.jms.error-handler-log-stack-trace

기본 errorHandler에 의해 stacktraces가 기록될지 여부를 제어할 수 있습니다.

true

부울

camel.component.jms.error-handler-logging-level

사용되지 않는 예외에 대해 기본 errorHandler 로깅 수준을 구성할 수 있습니다.

 

LoggingLevel

camel.component.jms.exception-listener

기본 JMS 예외 예외에 대한 알림을 받을 JMS Exception Listener를 지정합니다. 옵션은 javax.jms.ExceptionListener 유형입니다.

 

ExceptionListener

camel.component.jms.explicit-qos-enabled

메시지를 보낼 때 deliveryMode, priority 또는 timeToLive 서비스 수준을 사용해야 하는 경우 설정합니다. 이 옵션은 Spring의 JmsTemplate을 기반으로 합니다. deliveryMode, priority 및 timeToLive 옵션은 현재 끝점에 적용됩니다. 이는 메시지 세분성으로 작동하는 preserveMessageQos 옵션과 달리 Camel In 메시지 헤더에서만 QoS 속성을 읽습니다.

false

부울

camel.component.jms.expose-listener-session

메시지를 사용할 때 리스너 세션을 노출할지 여부를 지정합니다.

false

부울

camel.component.jms.force-send-original-message

mapJmsMessage=false Camel을 사용하면 경로 중 헤더(get 또는 set)를 만지면 새 JMS 대상으로 전송할 새 JMS 메시지를 생성합니다. Camel이 수신한 원래 JMS 메시지를 전송하도록 하려면 이 옵션을 true로 설정합니다.

false

부울

camel.component.jms.format-date-headers-to-iso8601

ISO 8601 표준에 따라 JMS 날짜 속성의 형식을 지정할지 여부를 설정합니다.

false

부울

camel.component.jms.header-filter-strategy

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지와 헤더를 필터링합니다. 옵션은 org.apache.camel.spi.HeaderFilterStrategy 유형입니다.

 

HeaderFilterStrategy

camel.component.jms.idle-consumer-limit

언제든지 유휴 상태로 설정할 수 있는 소비자 수에 대한 제한을 지정합니다.

1

정수

camel.component.jms.idle-task-execution-limit

실행 내에서 메시지를 수신하지 않고 수신 작업의 유휴 실행에 대한 제한을 지정합니다. 이 제한에 도달하면 작업이 종료되고 다른 실행 중인 작업에 수신이 유지됩니다(동적 스케줄링의 경우 maxConcurrentConsumers 설정 참조). Spring에서 제공하는 추가 문서도 있습니다.

1

정수

camel.component.jms.include-all-j-m-s-x-properties

JMS에서 Camel Message로 매핑할 때 모든 JMSXxxx 속성을 포함할지 여부입니다. 이 값을 true로 설정하면 JMSXAppID 및 JMSXUserID 등과 같은 속성이 포함됩니다. 참고: 사용자 정의 headerFilterStrategy를 사용하는 경우 이 옵션은 적용되지 않습니다.

false

부울

camel.component.jms.include-sent-j-m-s-message-i-d

InOnly를 사용하여 JMS 대상으로 보내는 경우에만 적용됩니다(예: 실행 및 잊기). 이 옵션을 활성화하면 메시지가 JMS 대상으로 전송되었을 때 JMS 클라이언트가 사용한 실제 JMSMessageID를 사용하여 Camel Exchange를 보강합니다.

false

부울

camel.component.jms.jms-key-format-strategy

JMS 키를 인코딩 및 디코딩하여 JMS 사양을 준수할 수 있도록 연결 가능한 전략입니다. Camel은 기본적으로 default 및 passthrough의 두 가지 구현을 제공합니다. 기본 전략은 점과 하이픈(. 및 -)을 안전하게 마샬링합니다. 패스스루 전략은 키를 그대로 유지합니다. JMS 헤더 키에 잘못된 문자가 포함되어 있는지 확인하지 않는 JMS 브로커에 사용할 수 있습니다. org.apache.camel.component.jms.JmsKeyFormatStrategy의 자체 구현을 제공하고 # 표기법을 사용하여 참조할 수 있습니다.

 

JmsKeyFormatStrategy

camel.component.jms.jms-message-type

JMS 메시지를 전송하기 위해 특정 javax.jms.Message 구현을 강제로 사용할 수 있습니다. 가능한 값은 10.0.0.1s, Map, Object, Stream, text입니다. 기본적으로 Camel은 In body type에서 사용할 JMS 메시지 유형을 결정합니다. 이 옵션을 사용하면 지정할 수 있습니다.

 

JmsMessageType

camel.component.jms.lazy-create-transaction-manager

true인 경우 Camel은 옵션이 transacted=true인 경우 트랜잭션 관리자가 삽입되지 않은 경우 JmsTransactionManager를 생성합니다.

true

부울

camel.component.jms.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.jms.map-jms-message

Camel이 수신된 JMS 메시지를 javax.jms.knativeMessage와 같이 적절한 페이로드 유형으로 자동으로 매핑할지 여부를 String 등에 지정합니다.

true

부울

camel.component.jms.max-concurrent-consumers

JMS에서 사용할 때 최대 동시 소비자 수를 지정합니다( JMS를 통해 요청/응답이 아님). 스레드의 동적 확장/다운을 제어하려면 maxMessagesPerTask 옵션도 참조하십시오. JMS를 통해 요청/응답을 수행할 때 option replyToMaxConcurrentConsumers는 응답 메시지 리스너에서 동시 소비자 수를 제어하는 데 사용됩니다.

 

정수

camel.component.jms.max-messages-per-task

작업당 메시지 수입니다. -1은 무제한입니다. 동시 소비자(예: min max)에 범위를 사용하는 경우 이 옵션을 사용하여 작업이 덜 필요할 때 소비자의 축소 속도를 제어하기 위해 값을 100으로 설정할 수 있습니다.

-1

정수

camel.component.jms.message-converter

javax.jms.jms.support.converter.MessageConverter 사용자 지정 Spring org.springframework.jms.MessageConverter를 사용하여 javax.jms.Message로 매핑하는 방법을 제어할 수 있습니다. 옵션은 org.springframework.jms.support.converter.MessageConverter 유형입니다.

 

MessageConverter

camel.component.jms.message-created-strategy

Camel이 JMS 메시지를 보낼 때 Camel이 javax.jms.Message 개체의 새 인스턴스를 생성할 때 호출되는 지정된 MessageCreatedStrategy를 사용하려면 다음을 수행합니다. 옵션은 org.apache.camel.component.jms.MessageCreatedStrategy 유형입니다.

 

MessageCreatedStrategy

camel.component.jms.message-id-enabled

전송할 때 메시지 ID를 추가해야 하는지 여부를 지정합니다. 이는 JMS 브로커에 대한 힌트일 뿐입니다. JMS 공급자가 이 힌트를 수락하면 이러한 메시지에 메시지 ID가 null로 설정되어 있어야 합니다. 공급자가 힌트를 무시하면 메시지 ID를 정상적인 고유 값으로 설정해야 합니다.

true

부울

camel.component.jms.message-listener-container-factory

메시지를 사용하는 데 사용할 org.springframework.jms.listener.AbstractMessageListenerContainery를 결정하는 데 사용되는 MessageListenerContainerFactory의 레지스트리 ID입니다. 이 값을 설정하면 consumerType이 Custom으로 자동 설정됩니다. 옵션은 org.apache.camel.component.jms.MessageListenerContainerFactory 유형입니다.

 

MessageListenerContainerFactory

camel.component.jms.message-timestamp-enabled

메시지 전송 시 타임스탬프를 기본적으로 사용하도록 설정해야 하는지 여부를 지정합니다. 이는 JMS 브로커에 대한 힌트일 뿐입니다. JMS 공급자가 이 힌트를 수락하는 경우 이러한 메시지에는 타임스탬프가 0으로 설정되어 있어야 합니다. 공급자가 타임스탬프를 일반 값으로 설정해야 하는 힌트를 무시합니다.

true

부울

camel.component.jms.password

ConnectionFactory와 함께 사용할 암호입니다. ConnectionFactory에서 직접 사용자 이름/암호를 구성할 수도 있습니다.

 

문자열

camel.component.jms.preserve-message-qos

JMS 끝점의 QoS 설정이 아니라 메시지에 지정된 QoS 설정을 사용하여 메시지를 보내려면 true로 설정합니다. 다음 세 개의 헤더는 JMSPriority, JMSDeliveryMode 및 JMSExpiration으로 간주됩니다. 전부 또는 일부만 제공할 수 있습니다. 제공되지 않는 경우 Camel은 대신 엔드포인트의 값을 사용하도록 대체됩니다. 따라서 이 옵션을 사용하면 헤더가 끝점의 값을 덮어씁니다. 반면 explicitQosEnabled 옵션은 메시지 헤더의 값이 아닌 끝점에 설정된 옵션만 사용합니다.

false

부울

camel.component.jms.priority

1보다 큰 값은 전송할 때 메시지 우선 순위를 지정합니다(여기서 1은 가장 낮은 우선 순위이고 9가 가장 높은 값입니다). 이 옵션이 적용되려면 explicitQosEnabled 옵션도 활성화해야 합니다.

4

정수

camel.component.jms.pub-sub-no-local

자체 연결에 의해 게시되는 메시지 전달을 억제할지 여부를 지정합니다.

false

부울

camel.component.jms.queue-browse-strategy

큐를 검색할 때 사용자 지정 Queue>-<Strategy를 사용하려면 다음을 수행합니다. 옵션은 org.apache.camel.component.jms.Queue>-<Strategy 유형입니다.

 

QueueBrowseStrategy

camel.component.jms.receive-timeout

메시지 수신에 대한 제한 시간(밀리초)입니다. 옵션은 긴 유형입니다.

1000

long

camel.component.jms.recovery-interval

연결을 새로 고치는 경우(예: 밀리초) 복구 시도 간격을 지정합니다. 기본값은 5000ms, 즉 5초입니다. 옵션은 긴 유형입니다.

5000

long

camel.component.jms.reply-to

명시적인 ReplyTo 대상을 제공합니다(sumJMSReplyTo() in consumer.getJMSReplyTo()의 수신 값 재정의).

 

문자열

camel.component.jms.reply-to-cache-level-name

JMS를 통해 요청/reply할 때 응답 소비자의 이름별로 캐시 수준을 설정합니다. 이 옵션은 고정 응답 큐(임시 아님)를 사용하는 경우에만 적용됩니다. Camel은 기본적으로 사용합니다. 전용 또는 공유 w/ replyToSelectorName의 경우 CACHE_CONSUMER입니다. 그리고 replyToSelectorName 없이 공유되는 경우 CACHE_SESSION IBMNodePolicy와 같은 일부 JMS 브로커는 replyToCacheLevelName=CACHE_NONE을 작동으로 설정해야 할 수 있습니다. 참고: 임시 대기열을 사용하는 경우 CACHE_NONE은 허용되지 않으며 CACHE_CONSUMER 또는 CACHE_SESSION과 같은 더 높은 값을 사용해야 합니다.

 

문자열

camel.component.jms.reply-to-concurrent-consumers

JMS를 통해 요청/응답할 때 동시 소비자의 기본 수를 지정합니다. 스레드의 동적 확장/다운을 제어하려면 maxMessagesPerTask 옵션도 참조하십시오.

1

정수

camel.component.jms.reply-to-delivery-persistent

응답에 기본적으로 영구 전달을 사용할지 여부를 지정합니다.

true

부울

camel.component.jms.reply-to-destination-selector-name

공유 큐를 사용할 때(즉, 임시 응답 큐를 사용하지 않는 경우) 다른 사용자의 응답을 필터링할 수 있도록 고정 이름을 사용하여 JMS 선택기를 설정합니다.

 

문자열

camel.component.jms.reply-to-max-concurrent-consumers

JMS를 통해 request/reply를 사용할 때 최대 동시 소비자 수를 지정합니다. 스레드의 동적 확장/다운을 제어하려면 maxMessagesPerTask 옵션도 참조하십시오.

 

정수

camel.component.jms.reply-to-on-timeout-max-concurrent-consumers

JMS를 통해 요청/응답을 사용할 때 타임아웃이 발생할 때 연속 라우팅에 대한 최대 동시 소비자 수를 지정합니다.

1

정수

camel.component.jms.reply-to-override

JMS 메시지에 명시적으로 ReplyTo 대상을 제공하여 replyTo 설정을 덮어씁니다. 메시지를 원격 큐로 전달하고 ReplyTo 대상에서 응답 메시지를 수신하려는 경우 유용합니다.

 

문자열

camel.component.jms.reply-to-same-destination-allowed

JMS 소비자가 소비자가 소비하기 위해 사용 중인 동일한 대상으로 응답 메시지를 보낼 수 있는지의 여부입니다. 이렇게 하면 동일한 메시지를 소비하고 자체에 전송하여 끝없는 루프를 방지할 수 있습니다.

false

부울

camel.component.jms.reply-to-type

JMS를 통해 request/reply를 수행할 때 replyTo 큐에 사용할 전략 종류를 명시적으로 지정할 수 있습니다. 가능한 값은 임시, 공유 또는 제외입니다. 기본적으로 Camel은 임시 대기열을 사용합니다. 그러나 replyTo가 구성된 경우 기본적으로 Shared가 사용됩니다. 이 옵션을 사용하면 공유된 큐 대신 전용 큐를 사용할 수 있습니다. 자세한 내용과 특히 클러스터형 환경에서 실행되는 경우의 영향 및 공유 응답 대기열의 성능이 대체 시간 및 제외보다 성능이 적다는 사실에 대한 자세한 내용은 Camel JMS 문서를 참조하십시오.

 

ReplyToType

camel.component.jms.request-timeout

InOut 교환 패턴 (밀리초)을 사용할 때 응답을 기다리는 시간 초과입니다. 기본값은 20초입니다. CamelJmsRequestTimeout 헤더를 포함하여 이 엔드포인트 구성 시간 값을 재정의하고 메시지마다 개별 시간 초과 값을 포함할 수 있습니다. requestTimeoutCheckerInterval 옵션도 참조하십시오. 옵션은 긴 유형입니다.

20000

long

camel.component.jms.request-timeout-checker-interval

Camel이 JMS를 통해 요청/응답할 때 시간 초과 교환을 확인하는 빈도를 설정합니다. 기본적으로 Camel 검사는 초당 한 번 확인합니다. 그러나 시간 초과가 발생할 때 더 빠르게 대응해야 하는 경우 이 간격을 줄여 더 자주 확인할 수 있습니다. 시간 초과는 옵션 requestTimeout에 따라 결정됩니다. 옵션은 긴 유형입니다.

1000

long

camel.component.jms.selector

사용할 JMS 선택기를 설정합니다.

 

문자열

camel.component.jms.stream-message-type-enabled

StreamMessage 유형이 활성화되었는지 여부를 설정합니다. 파일, InputStream 등과 같은 스트리밍 유형의 메시지 페이로드는 CloudEventsMessage 또는 StreamMessage로 전송됩니다. 이 옵션은 사용할 유형을 제어합니다. 기본적으로는 전체 메시지 페이로드를 메모리로 읽어오는 데 사용됩니다. 이 옵션을 사용하면 메시지 페이로드가 청크의 메모리에 읽어지고 각 청크는 더 이상 데이터가 없을 때까지 StreamMessage에 기록됩니다.

false

부울

camel.component.jms.subscription-durable

서브스크립션을 사용할지 여부를 설정합니다. 사용할 고정 서브스크립션 이름은 subscriptionName 속성을 통해 지정할 수 있습니다. 기본값은 false입니다. 일반적으로 메시지 리스너 클래스 이름이 서브스크립션 이름으로 충분하지 않으면 일반적으로 subscriptionName 값과 함께 하기 위해 이 값을 true로 설정합니다. 주제(pub-sub 도메인)를 청취할 때만 의미가 있으므로 이 방법에서도 barSubDomain 플래그를 전환합니다.

false

부울

camel.component.jms.subscription-name

생성할 서브스크립션의 이름을 설정합니다. 공유 또는 지속성 서브스크립션을 사용하는 주제(pub-sub 도메인)의 경우 적용됩니다. 서브스크립션 이름은 이 클라이언트의 JMS 클라이언트 ID 내에서 고유해야 합니다. 기본값은 지정된 메시지 리스너의 클래스 이름입니다. 참고: 공유 서브스크립션( JMS 2.0 필요)을 제외한 각 서브스크립션에 대해 동시 소비자(이 메시지 리스너 컨테이너의 기본값인) 1개만 허용됩니다.

 

문자열

camel.component.jms.subscription-shared

서브스크립션을 공유할지 여부를 설정합니다. 사용할 공유 서브스크립션 이름은 subscriptionName 속성을 통해 지정할 수 있습니다. 기본값은 false입니다. 일반적으로 메시지 리스너 클래스 이름이 서브스크립션 이름으로 충분하지 않는 한 공유 서브스크립션을 등록하려면 이 값을 true로 설정합니다. 공유 서브스크립션은 또한 불안정할 수 있으므로 이 플래그는 subscriptionDurable과 결합될 수 있습니다. 주제(pub-sub 도메인)를 청취할 때만 의미가 있으므로 이 방법에서도 barSubDomain 플래그를 전환합니다. JMS 2.0 호환 메시지 브로커가 필요합니다.

false

부울

camel.component.jms.synchronous

동기 처리를 엄격하게 사용해야 하는지 여부를 설정합니다.

false

부울

camel.component.jms.task-executor

메시지를 사용하기 위한 사용자 지정 작업 executor를 지정할 수 있습니다. 옵션은 org.springframework.core.task.TaskExecutor 유형입니다.

 

TaskExecutor

camel.component.jms.test-connection-on-startup

시작 시 연결을 테스트할지 여부를 지정합니다. 이렇게 하면 Camel이 시작되면 모든 JMS 소비자가 JMS 브로커와 유효한 연결을 갖습니다. 연결을 부여할 수 없는 경우 Camel이 시작 시 예외를 발생시킵니다. 이렇게 하면 실패한 연결로 Camel이 시작되지 않습니다. JMS 생산자도 테스트됩니다.

false

부울

camel.component.jms.time-to-live

메시지를 보낼 때 메시지의 라이브 시간(밀리초)을 지정합니다.

-1

long

camel.component.jms.transacted

변환 모드를 사용할지 여부를 지정합니다.

false

부울

camel.component.jms.transacted-in-out

이 플래그가 true로 설정된 경우 InOut 작업(응답 요청)이 Transacted 모드를 사용하도록 기본지 여부를 지정합니다. 이 플래그를 true로 설정한 경우 Spring JmsTemplate이 true로 설정되고 InOut 작업에 사용되는 JmsTemplate에서 표시되는 acknowledgeMode가 true로 설정됩니다. Spring JMS: JTA 트랜잭션 내에서Queue에 전달된 매개변수는 createTopic 메서드가 고려되지 않습니다. Java EE 트랜잭션 컨텍스트에 따라 컨테이너는 이러한 값에 대해 자체 결정을 내립니다. 유사하게, 이러한 매개 변수는 이 경우 Spring JMS가 기존 JMS 세션에서 작동하기 때문에 로컬 관리 트랜잭션 내에서 고려되지 않습니다. 이 플래그를 true로 설정하면 관리 트랜잭션 외부에서 실행할 때 짧은 로컬 JMS 트랜잭션과 관리 트랜잭션(XA 트랜잭션 제외)이 있는 경우 동기화된 로컬 JMS 트랜잭션이 사용됩니다. 이는 JMS 트랜잭션이 기본 트랜잭션 직후에 커밋되는 기본 트랜잭션(기본 JDBC 트랜잭션일 수 있음)과 함께 관리되는 로컬 JMS 트랜잭션이 영향을 미칩니다.

false

부울

camel.component.jms.transaction-manager

Spring 트랜잭션 관리자가 사용할 수 있습니다. 옵션은 org.springframework.ECDHE.PlatformTransactionManager 유형입니다.

 

PlatformTransactionManager

camel.component.jms.transaction-name

사용할 트랜잭션의 이름입니다.

 

문자열

camel.component.jms.transaction-timeout

트랜잭션 모드를 사용하는 경우 트랜잭션 제한 값(초)입니다.

-1

정수

camel.component.jms.transfer-exception

사용 가능하며 소비자 측에서 Request Reply messaging (InOut)를 사용하고 있는 경우, 발생한 Exception은 javax.jms.ObjectMessage로 응답으로 다시 전송됩니다. 클라이언트가 Camel인 경우 반환된 Exception이 다시 표시됩니다. 이를 통해 Camel JMS를 라우팅의 브리지로 사용할 수 있습니다(예: 영구 대기열을 사용하여 강력한 라우팅 가능). transferExchange를 사용하도록 설정한 경우에도 이 옵션이 우선합니다. catch된 예외는 직렬화할 수 있어야 합니다. 소비자 측의 원래 예외는 org.apache.camel.RuntimeCamelException과 같은 외부 예외로 래핑할 수 있습니다. 데이터가 Java Object serialization을 사용하고 있으며 수신한 데이터를 클래스 수준에서 역직렬화할 수 있어야 하므로 생산자와 소비자 간에 강력한 결합이 강제 적용됩니다.

false

부울

camel.component.jms.transfer-exchange

본문과 헤더 대신 전선을 통해 교환을 전송할 수 있습니다. 본문, 외부, Fault 본문, In headers, Out headers, Fault headers, Fault headers, exchange properties, exchange exception. 이를 위해 오브젝트를 직렬화할 수 있어야 합니다. Camel은 비합리화 가능한 오브젝트를 제외하고 WARN 수준에서 기록합니다. 생산자와 소비자 양쪽 모두에서 이 옵션을 활성화해야 하므로 Camel은 페이로드가 일반 페이로드가 아니라 Exchange임을 알고 있습니다. 데이터가 Java Object serialization을 사용하고 있고 수신자가 클래스 수준에서 데이터를 역직렬화할 수 있어야 하므로, 호환되는 Camel 버전을 사용해야 하는 생산자와 소비자 간에 강력한 결합이 강제 적용됩니다.

false

부울

camel.component.jms.use-message-i-d-as-correlation-i-d

JMSMessageID가 항상 InOut 메시지의 JMSCorrelationID로 사용되어야 하는지 여부를 지정합니다.

false

부울

camel.component.jms.username

ConnectionFactory와 함께 사용할 사용자 이름입니다. ConnectionFactory에서 직접 사용자 이름/암호를 구성할 수도 있습니다.

 

문자열

camel.component.jms.wait-for-provision-correlation-to-be-updated-counter

JMS에 대해 요청/응답을 수행할 때 및 option useMessageIDAsCorrelationID가 활성화될 때 임시 상관 관계 ID가 실제 상관 ID로 업데이트될 때까지 대기하는 횟수입니다.

50

정수

camel.component.jms.wait-for-provision-correlation-to-be-updated-thread-sleeping-time

프로비저닝 상관 관계 ID가 업데이트되기를 기다리는 동안 매번 millis의 간격이 유휴 상태가 됩니다. 옵션은 긴 유형입니다.

100

long

27장. Kafka

생산자 및 소비자 모두 지원

Kafka 구성 요소는 Apache Kafka 메시지 브로커와 통신하는 데 사용됩니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-kafka</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

27.1. URI 형식

kafka:topic[?options]

27.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

27.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

27.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

27.3. 구성 요소 옵션

Kafka 구성 요소는 아래에 나열된 104 옵션을 지원합니다.

이름설명Default유형

추가 속성 (common)

kafka consumer 또는 kafka 생산자에 대한 추가 속성을 설정하며 camel 구성에서 직접 설정할 수 없는 경우 속성(예: Camel 구성에 아직 반영되지 않은 새 Kafka 속성)을 접두사로 추가해야 합니다. 예: 추가Properties.knativeal.id=12345&additionalProperties.schema.registry.url=http://localhost:8811/avro.

 

map

브로커 (공용)

사용할 Kafka 브로커의 URL입니다. 형식은 host1:port1,host2:port2이며 목록은 브로커의 하위 집합 또는 브로커의 하위 집합을 가리키는 VIP의 하위 집합일 수 있습니다. 이 옵션은 Kafka 설명서에서 bootstrap.servers라고 합니다.

 

문자열

ClientID (common)

클라이언트 ID는 호출 추적을 돕기 위해 각 요청에 전송된 사용자 지정 문자열입니다. 요청을 수행하는 애플리케이션을 논리적으로 식별해야 합니다.

 

문자열

구성 (공용)

엔드포인트에서 재사용할 공통 옵션을 사용하여 Kafka 구성 요소를 사전 설정할 수 있습니다.

 

KafkaConfiguration

headerFilterStrategy (common)

사용자 정의 HeaderFilterStrategy를 사용하여 Camel 메시지 간 헤더를 필터링하려면 다음을 수행합니다.

 

HeaderFilterStrategy

reconnectBackoffMaxMs (common)

브로커에 다시 연결할 때 대기하는 최대 시간(밀리초)입니다. 제공되는 경우 호스트당 백오프는 연속된 연결 실패마다 최대 최대 기하급수적으로 증가합니다. 백오프 증가를 계산한 후 연결 문제가 발생하지 않도록 20 % 임의 지터가 추가됩니다.

1000

정수

shutdownTimeout (common)

소비자 또는 생산자가 작업자 스레드를 종료하고 종료할 때까지 정상적으로 대기하는 시간(밀리초)입니다.

30000

int

allowManualCommit (consumer)

KafkaManualCommit을 통한 수동 커밋 허용 여부입니다. 이 옵션을 활성화하면 KafkaManualCommit 인스턴스가 Exchange 메시지 헤더에 저장되어 최종 사용자가 이 API에 액세스하고 Kafka 소비자를 통해 수동 오프셋 커밋을 수행할 수 있습니다.

false

boolean

autoCommitEnable (consumer)

true인 경우 사용자가 이미 가져온 메시지 오프셋을 ZooKeeper에 주기적으로 커밋합니다. 이 커밋된 오프셋은 프로세스가 새 소비자가 시작되는 위치로 실패할 때 사용됩니다.

true

부울

autoCommitIntervalMs (consumer)

소비자 오프셋이 zookeeper에 커밋되는 ms의 빈도입니다.

5000

정수

autoCommitOnStop (consumer)

소비자가 중지되어 브로커가 마지막으로 사용된 메시지에서 커밋이 있는지 확인할 때 명시적 자동 커밋을 수행할지 여부입니다. 이를 위해서는 autoCommitEnable 옵션이 설정되어 있어야 합니다. 가능한 값은 sync, async 또는 none입니다. 및 sync 값이 기본값입니다.

CloudEvent 값:

  • 동기화
  • async
  • none

동기화

문자열

autoOffsetReset (consumer)

ZooKeeper에 초기 오프셋이 없거나 오프셋이 범위를 벗어나면해야 할 일 : 가장 빠른 오프셋의 마지막으로 오프셋을 자동으로 재설정하십시오. 최신 오프셋으로 오프셋을 자동으로 재설정하십시오: 소비자에 예외가 발생합니다.

CloudEvent 값:

  • 최신 정보
  • 가장 빠른
  • none

최신 정보

문자열

breakOnFirstError (consumer)

이 옵션은 소비자가 교환을 처리하고 실패할 때 발생하는 상황을 제어합니다. 옵션이 false인 경우 소비자는 다음 메시지를 계속하고 처리합니다. 옵션이 true인 경우 소비자는 오류가 발생한 메시지의 오프셋을 다시 찾은 다음 이 메시지를 처리하기 위해 다시 시도합니다. 그러나 이로 인해 동일한 메시지가 무한한 처리로 이어질 수 있습니다. 그 바인딩이 실패할 때마다 실패할 수 있습니다. 따라서 Camel의 오류 처리기를 사용하여 이러한 문제를 처리하는 것이 좋습니다.

false

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

checkCrcs (consumer)

사용된 레코드의 CRC32를 자동으로 확인합니다. 이렇게 하면 메시지의 온-the-wire 또는 온-디스크 손상이 발생하지 않습니다. 이 검사에는 오버헤드가 추가되므로 과도한 성능을 원하는 경우 비활성화될 수 있습니다.

true

부울

commitTimeoutMs (consumer)

코드에서 동기 커밋이 완료될 때까지 대기하는 최대 시간(밀리초)입니다.

5000

long

consumerRequestTimeoutM (consumer)

구성은 클라이언트가 요청 응답을 기다리는 최대 시간을 제어합니다. 시간 초과가 경과하기 전에 응답이 수신되지 않으면 필요한 경우 클라이언트가 요청을 다시 전송하거나 재시도가 고갈되면 요청이 실패합니다.

40000

정수

consumersCount (consumer)

kafka 서버에 연결하는 소비자 수입니다. 각 소비자는 들어오는 데이터를 검색하고 처리하는 별도의 스레드에서 실행됩니다.

1

int

fetchMaxBytes (consumer)

서버에서 가져오기 요청에 대해 반환해야 하는 최대 데이터 양 This is not an absolute maximum, if the first message in the first message in the first message in the first message in the fetch is larger than this value, 메시지를 계속 반환하여 소비자가 진행할 수 있도록 합니다. 브로커가 승인한 최대 메시지 크기는 message.max.bytes(broker config) 또는 max.message.bytes(topic config)를 통해 정의됩니다. 소비자는 여러 가져오기를 병렬로 수행합니다.

52428800

정수

fetchMinBytes (consumer)

가져오기 요청에 대해 서버가 반환해야 하는 최소 데이터 양입니다. 데이터가 충분하지 않으면 요청은 요청에 응답하기 전에 많은 데이터가 누적될 때까지 기다립니다.

1

정수

fetchWaitMaxMs (consumer)

fetch.min.bytes를 즉시 충족하기에 충분하지 않은 경우 가져오기 요청에 응답하기 전에 서버가 차단하는 최대 시간입니다.

500

정수

groupId (consumer)

이 소비자가 속하는 소비자 프로세스 그룹을 고유하게 식별하는 문자열입니다. 동일한 그룹 ID를 여러 프로세스를 설정하면 해당 프로세스가 모두 동일한 소비자 그룹의 일부임을 나타냅니다. 이 옵션은 고객에게 필요합니다.

 

문자열

groupInstanceId (consumer)

최종 사용자가 제공하는 소비자 인스턴스의 고유 식별자입니다. 비어 있지 않은 문자열만 허용됩니다. 설정된 경우 소비자는 정적 멤버로 처리되므로 이 ID가 있는 하나의 인스턴스만 언제든지 소비자 그룹에 허용됩니다. 이는 일시적인 비가용성으로 인한 그룹 재조정(예: 프로세스 재시작)으로 인한 그룹 재조정을 방지하기 위해 더 큰 세션 시간 제한과 함께 사용할 수 있습니다. 설정하지 않으면 소비자는 기존 동작인 동적 멤버로 그룹을 조인합니다.

 

문자열

headerDeserializer (consumer)

사용자 지정 KafkaHeaderDeserializer를 사용하여 kafka 헤더 값을 역직렬화합니다.

 

KafkaHeaderDeserializer

heartbeatIntervalMs (consumer)

Kafka의 그룹 관리 기능을 사용할 때 소비자 조정자에게 하트비트 간 예상 시간입니다. 하트비트는 소비자의 세션이 활성 상태로 유지되고 새 소비자가 그룹을 참여하거나 나가면 재조정을 용이하게 하는 데 사용됩니다. 값은 session.timeout.ms보다 작아야 하지만 일반적으로 해당 값의 1/3을 넘지 않아야 합니다. 일반 리밸런스에 대해 예상 시간을 제어하도록 더욱 낮게 조정할 수 있습니다.

3000

정수

keyDeserializer (consumer)

Deserializer 인터페이스를 구현하는 키에 대한 Deserializer 클래스입니다.

org.apache.kafka.common.serialization.StringDeserializer

문자열

maxPartitionFetchBytes (consumer)

서버가 반환할 파티션당 최대 데이터 양입니다. 요청에 사용된 최대 총 메모리는 #partitions max.partition.fetch.bytes입니다. 이 크기는 서버에서 허용하는 최대 메시지 크기 이상이어야 합니다. 그러지 않으면 생산자가 소비자가 가져올 수 있는 것보다 큰 메시지를 보낼 수 있습니다. 이러한 경우 소비자는 특정 파티션에서 큰 메시지를 가져오려고 할 수 있습니다.

1048576

정수

maxPollIntervalMs (consumer)

소비자 그룹 관리를 사용할 때 poll() 호출 간 최대 지연입니다. 이렇게 하면 더 많은 레코드를 가져오기 전에 소비자가 유휴 상태가 될 수 있는 시간에 바인딩된 상한이 배치됩니다. poll()가 이 시간 만료 전에 호출되지 않은 경우 소비자는 실패한 것으로 간주되고 그룹이 파티션을 다른 멤버에 다시 할당하기 위해 재조정됩니다.

 

long

maxPollRecords (consumer)

poll()에 대한 단일 호출에서 반환된 최대 레코드 수입니다.

500

정수

offsetRepository (consumer)

주제의 각 파티션의 오프셋을 로컬로 저장하기 위해 사용할 오프셋 리포지토리입니다. 하나를 정의하면 자동 커밋이 비활성화됩니다.

 

StateRepository

partitionAssignor (consumer)

클라이언트가 그룹 관리를 사용할 때 클라이언트가 파티션 소유권을 배포하는 데 사용할 파티션 할당 전략의 클래스 이름입니다.

org.apache.kafka.clients.consumer.RangeAssignor

문자열

pollOnError (consumer)

kafka가 새 메시지를 폴링하는 동안 예외를 제한하면 어떻게 해야 합니까. 은 엔드포인트 수준에서 명시적 값을 구성하지 않는 한 기본적으로 구성 요소 구성의 값을 사용합니다. DISCARD는 메시지를 삭제하고 다음 메시지를 계속 폴링합니다. ERROR_HANDLER는 Camel의 오류 처리기를 사용하여 예외를 처리하고 나중에 다음 메시지를 계속 폴링합니다. RECONNECT는 소비자를 다시 연결하고 메시지를 다시 폴링하려고 시도하면 동일한 메시지를 다시 폴링하면 소비자 재시도에서 소비자를 다시 중지시킬 수 있습니다(고객이 메시지를 다시 사용할 수 있어야 하는 경우 수동으로 시작/다시 시작됨).

CloudEvent 값:

  • DISCARD
  • ERROR_HANDLER
  • RECONNECT
  • RETRY
  • STOP

ERROR_HANDLER

PollOnError

pollTimeoutM (consumer)

KafkaConsumer를 폴링할 때 사용되는 제한 시간입니다.

5000

long

resumeStrategy (consumer)

이 옵션을 사용하면 사용자 정의 재개 전략을 설정할 수 있습니다. resume 전략은 파티션이 할당될 때(예: 연결 또는 다시 연결할 때) 실행됩니다. 구현이 작업을 재개하는 방법을 사용자 지정하고 seekTo 및 offsetRepository 메커니즘에 대한 보다 유연한 대안으로 사용할 수 있습니다. 구현 세부 사항은 KafkaConsumerResumeStrategy를 참조하십시오. 이 옵션은 자동 커밋 설정에 영향을 미치지 않습니다. 이 설정을 사용하는 구현에서는 이와 함께 수동 커밋 옵션을 사용하여 평가할 수도 있습니다.

 

KafkaConsumerResumeStrategy

seekTo (consumer)

KafkaConsumer가 시작시 시작 또는 종료 시부터 읽는 경우 설정 : 처음부터 읽기 : 마지막부터 읽기 This is replacing the earlier property seekToBeginning.

CloudEvent 값:

  • Starting
  • end
 

문자열

sessionTimeoutM (consumer)

Kafka의 그룹 관리 기능을 사용할 때 오류를 감지하는 데 사용되는 시간 초과입니다.

10000

정수

specificAvroReader (consumer)

이를 통해 Confluent Platform 스키마 레지스트리 및 io.confluent.kafka.serializers.KafkaAvroDeserializer와 함께 사용할 수 있습니다. 이 옵션은 Confluent Platform (표준 Apache Kafka)에서만 사용할 수 있습니다.

false

boolean

topicIsPattern (consumer)

주제가 패턴(regular expression)인지 여부. 이를 사용하여 패턴과 일치하는 동적 주제 수를 서브스크립션할 수 있습니다.

false

boolean

valueDeserializer (consumer)

Deserializer 인터페이스를 구현하는 값에 대한 Deserializer 클래스입니다.

org.apache.kafka.common.serialization.StringDeserializer

문자열

kafkaManualCommitFactory (consumer (advanced)

KafkaManualCommit 인스턴스를 생성하는 데 사용할 Autowired anchor입니다. 이를 통해 사용자 지정 팩토리를 플러그인하여 사용자 지정 KafkaManualCommit 인스턴스를 생성할 수 있습니다. 이 경우 박스에서 제공되는 기본 구현에서 벗어난 수동 커밋을 수행할 때 특수 논리가 필요합니다.

 

KafkaManualCommitFactory

pollExceptionStrategy (consumer (advanced))

Autowired 소비자와 사용자 정의 전략을 사용하여 메시지를 풀링하는 동안 Kafka 브로커에서 발생하는 예외를 처리하는 방법을 제어합니다.

 

PollExceptionStrategy

bufferMemorySize (producer)

생산자가 서버로 전송되는 대기 중인 레코드를 버퍼링하는 데 사용할 수 있는 총 메모리 바이트입니다. 생산자가 block.on.buffer.full에서 지정한 기본 설정에 따라 서버에 레코드를 더 빠르게 전송하면 생산자가 사용하는 모든 메모리가 버퍼링에 사용되는 것은 아니지만 모든 메모리가 버퍼링에 사용되는 것은 아니기 때문에 프로듀서가 사용하는 기본 설정에 따라 예외를 차단하거나 throw합니다. 이 설정은 프로듀서에서 사용하는 모든 메모리가 버퍼링에 사용되는 것은 아니므로 하드 바인딩은 아닙니다. 일부 추가 메모리는 압축( 압축이 활성화된 경우)과 진행 중인 요청을 유지 관리하는 데 사용됩니다.

33554432

정수

compressionCodec (producer)

이 매개변수를 사용하면 이 프로듀서에서 생성한 모든 데이터에 대해 압축 코드c를 지정할 수 있습니다. 유효한 값은 none, gzip 및 snappy입니다.

CloudEvent 값:

  • none
  • gzip
  • snappy
  • lz4

none

문자열

connectionMaxIdleMs (producer)

이 구성에서 지정한 시간(밀리초) 후 유휴 연결을 종료합니다.

540000

정수

deliveryTimeoutM (producer)

send() 호출을 반환한 후 성공 또는 실패를 보고하는 시간에 상한입니다. 이렇게 하면 레코드가 전송 전에 지연되는 총 시간, 브로커의 승인 대기 시간(필요한 경우) 및 재시도 가능한 전송 실패에 허용되는 시간이 제한됩니다.

120000

정수

enableIdempotence (producer)

'true'로 설정하면 생산자가 스트림에 각 메시지의 사본을 정확히 1개씩 작성합니다. 'false'인 경우 생산자는 스트림에 재시도된 메시지의 중복을 작성할 수 있습니다. true로 설정하면 max.in.flight.requests.per.connection을 1로 설정하고 재시도할 수 없으며 추가 acks를 'all'로 설정해야 합니다.

false

boolean

headerSerializer (producer)

사용자 지정 KafkaHeaderSerializer를 사용하여 kafka 헤더 값을 직렬화합니다.

 

KafkaHeaderSerializer

(producer)

레코드 키(키가 지정되지 않은 경우 null)입니다. 이 옵션이 구성된 경우 헤더 KafkaConstants#KEY보다 우선합니다.

 

문자열

keySerializer (producer)

키의 serializer 클래스(제공되지 않은 경우 메시지의 기본값과 동일).

org.apache.kafka.common.serialization.StringSerializer

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

lingerMs (producer)

생산자는 단일 배치된 요청으로의 요청 전송 사이에 들어오는 모든 레코드를 그룹화합니다. 일반적으로 이는 전송 가능한 것보다 레코드가 더 빨리 도달할 때 로드 중에만 발생합니다. 그러나 경우에 따라 클라이언트는 중간 수준의 부하에서도 요청 수를 줄일 수 있습니다. 이 설정은 약간의 인공 지연을 추가하여 즉, 생산자가 즉시 레코드를 보내는 대신 지정된 지연까지 대기하여 전송이 함께 배치될 수 있도록 다른 레코드를 보낼 수 있도록 합니다. 이는 TCP의 Nagle 알고리즘과 유사합니다. 이 설정은 일괄 처리 지연에 대한 상한을 제공합니다. 이 설정에 관계없이 파티션의 batch.size 가치가 있는 경우 즉시 전송되지만 이 파티션에 누적된 바이트 수보다 적으면 더 많은 레코드가 표시되도록 지정된 시간에 대해 '어링er'합니다. 이 설정 기본값은 0입니다(예: no delay). 예를 들어 linger.ms=5를 설정하면 전송된 요청 수를 줄이는 효과가 있지만 로드 중에 전송된 레코드에 최대 5ms의 대기 시간을 더할 수 있습니다.

0

정수

maxBlockMs (producer)

구성에서는 kafka로 보내는 기간을 제어합니다. 이러한 방법은 여러 가지 이유로 차단될 수 있습니다. 예를 들어 버퍼 전체 메타데이터를 사용할 수 없습니다. 이 구성은 메타데이터 가져오기에 소비된 총 시간, 키 및 값의 직렬화, send()를 수행할 때 버퍼 메모리의 파티셔닝 및 할당에 최대 제한을 적용합니다. partitionsFor()의 경우 이 구성은 메타데이터 대기 시 최대 시간 임계값을 적용합니다.

60000

정수

maxInFlightRequest (producer)

인증되지 않은 최대 요청 수에 따라 클라이언트가 차단하기 전에 단일 연결을 통해 전송할 수 있습니다. 이 설정이 1보다 크고 전송에 실패한 경우 재시도로 인해 메시지 재순환 위험이 있습니다(예: 재시도가 활성화된 경우).

5

정수

maxRequestSize (producer)

요청의 최대 크기입니다. 이는 또한 실질적으로 최대 레코드 크기에 대한 제한입니다. 서버에는 이와 다를 수 있는 레코드 크기에 대한 자체 제한이 있습니다. 이 설정은 생산자가 대규모 요청을 보내지 않도록 단일 요청으로 전송할 레코드 배치 수를 제한합니다.

1048576

정수

metadataMaxAgeMs (producer)

이 기간(밀리초) 후 새 브로커 또는 파티션을 사전에 검색하기 위해 파티션 리더십 변경을 보지 못하더라도 메타데이터를 강제로 새로 고침합니다.

300000

정수

metricReporters (producer)

메트릭 보고자로 사용할 클래스 목록입니다. MetricReporter 인터페이스를 구현하면 새 지표 생성에 대한 알림을 받을 클래스를 연결할 수 있습니다. JmxReporter는 항상 통계를 등록하기 위해 포함됩니다.

 

문자열

metricsSampleWindowMs (producer)

메트릭으로 유지 관리되는 샘플 수입니다.

30000

정수

noOfMetricsSample (producer)

메트릭으로 유지 관리되는 샘플 수입니다.

2

정수

partitioner (producer)

하위 주제 간에 메시지를 분할하는 partitioner 클래스입니다. 기본 partitioner는 키의 해시를 기반으로 합니다.

org.apache.kafka.clients.producer.internals.DefaultPartitioner

문자열

partitionKey (producer)

레코드가 전송되는 파티션(또는 파티션이 지정되지 않은 경우 null)입니다. 이 옵션이 구성된 경우 헤더 KafkaConstants#PARTITION_KEY보다 우선합니다.

 

정수

producerBatchSize (producer)

생산자는 여러 레코드가 동일한 파티션에 전송될 때마다 레코드를 더 적은 수의 요청으로 함께 배치하려고 합니다. 이렇게 하면 클라이언트와 서버 모두에서 성능이 향상됩니다. 이 구성은 기본 배치 크기(바이트)를 제어합니다. 이 크기보다 큰 배치 레코드는 없습니다. 브로커에 전송된 요청에는 여러 일괄 처리가 포함됩니다. 하나는 전송 가능한 데이터가 있는 각 파티션에 대해 일괄 처리를 덜 일반화하고 처리량을 줄일 수 있습니다(0의 배치 크기는 완전히 비활성화됨). 배치 크기가 매우 큰 경우 추가 레코드를 예상할 때 항상 지정된 일괄 처리 크기의 버퍼를 할당하므로 메모리를 약간 더 불편하게 사용할 수 있습니다.

16384

정수

queueBufferingMaxMessages (producer)

생산자를 차단하거나 데이터를 삭제하기 전에 async 모드를 사용할 때 프로듀서에서 대기할 수 있는 최대 무의식 메시지 수입니다.

10000

정수

receiveBufferBytes (producer)

데이터를 읽을 때 사용할 TCP 수신 버퍼(SO_RCVBUF)의 크기입니다.

65536

정수

reconnectBackoffMs (producer)

지정된 호스트에 다시 연결하기 전에 대기하는 시간입니다. 이렇게 하면 엄격한 루프에서 호스트에 반복적으로 연결하는 것을 방지할 수 있습니다. 이 백오프는 소비자가 브로커로 보낸 모든 요청에 적용됩니다.

50

정수

recordMetadata (producer)

생산자가 Kafka로 전송한 RecordMetadata 결과를 저장해야 하는지 여부입니다. 결과는 RecordMetadata 메타데이터가 포함된 목록에 저장됩니다. 목록은 KafkaConstants#KAFKA_RECORDMETA 키가 있는 헤더에 저장됩니다.

true

boolean

requestRequiredAcks (producer)

생산자가 승인한 승인의 수에 따라 요청이 완료된 것을 고려하기 전에 리더를 수령해야 합니다. 이렇게 하면 전송되는 레코드의 중요도가 제어됩니다. acks=0로 설정하면 생산자가 서버의 승인을 전혀 기다리지 않습니다. 레코드는 소켓 버퍼에 즉시 추가되고 전송된 것으로 간주합니다. 이 경우 서버가 레코드를 수신했음을 보장할 수 없으며 재시도 구성은 적용되지 않습니다(클라이언트는 일반적으로 오류를 알 수 없기 때문에). 각 레코드에 대해 주어진 오프셋은 항상 -1로 설정됩니다. acks=1 이는 리더가 해당 로컬 로그에 레코드를 작성하지만 모든 팔로워의 완전한 승인을 기다리지 않고 응답한다는 것을 의미합니다. 이 경우 레코드 확인 후 바로 리더가 실패하지만, 팔로워가 복제되기 전에 해당 레코드가 손실됩니다. acks=all이 발생하면 비동기(in-sync) 복제본의 전체 세트를 확인하여 레코드를 승인할 수 있습니다. 이렇게 하면 하나 이상의 동기화 복제본이 활성 상태로 유지되는 한 레코드가 손실되지 않습니다. 이는 사용 가능한 보증입니다.

CloudEvent 값:

  • -1
  • 0
  • 1
  • all

1

문자열

requestTimeoutM (producer)

브로커가 클라이언트에 오류를 보내기 전에 request.required.acks 요구 사항을 충족하기 위해 대기하는 시간입니다.

30000

정수

재시도 (producer)

값을 0보다 크게 설정하면 클라이언트가 전송이 잠재적으로 일시적인 오류와 함께 실패하는 모든 레코드를 다시 보냅니다. 이 재시도는 클라이언트가 오류를 수신할 때 레코드를 재지정하는 경우와 다르지 않습니다. 재시도를 허용하면 두 개의 레코드가 단일 파티션에 전송되고 첫 번째 레코드가 실패하고 다시 시도되지만 두 번째 레코드가 먼저 표시될 수 있기 때문에 레코드 순서가 변경될 수 있습니다.

0

정수

retryBackoffMs (producer)

각 재시도 전에 생산자는 관련 주제의 메타데이터를 새로 고침하여 새 리더가 선택되었는지 확인합니다. 리더 선택에는 시간이 걸리므로 이 속성은 메타데이터를 새로 고치기 전에 프로듀서가 대기하는 시간을 지정합니다.

100

정수

sendBufferBytes (producer)

소켓 쓰기 버퍼 크기.

131072

정수

valueSerializer (producer)

메시지에 대한 serializer 클래스입니다.

org.apache.kafka.common.serialization.StringSerializer

문자열

workerpool (producer)

kafka 서버 이후에 Exchange를 계속 라우팅하는 데 사용자 지정 작업자 풀을 사용하려면 비동기 비차단 처리를 사용하여 KafkaProducer에서 전송된 메시지를 인식합니다. 이 옵션을 사용하는 경우 더 이상 필요하지 않은 경우 풀을 종료하려면 스레드 풀의 라이프사이클을 처리해야 합니다.

 

ExecutorService

workerPoolCoreSize (producer)

kafka 서버 이후에 Exchange를 계속 라우팅하기 위한 작업자 풀의 코어 스레드 수는 비동기 비차단 처리를 사용하여 KafkaProducer에서 전송된 메시지를 인식합니다.

10

정수

workerPoolMaxSize (producer)

kafka 서버 후에 Exchange를 계속 라우팅하기 위한 작업자 풀의 최대 스레드 수는 비동기 비차단 처리를 사용하여 KafkaProducer에서 전송된 메시지를 승인합니다.

20

정수

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

kafkaClientFactory (advanced)

org.apache.kafka.clients.consumer.KafkaConsumer.KafkaConsumer 및 org.apache.kafka.clients.producer.KafkaProducer 인스턴스를 생성하는 데 사용할 Autowired 10.0.0.1입니다. 이를 통해 vanill Kafka 클라이언트를 확장하는 논리를 사용하여 인스턴스를 생성하도록 사용자 지정 팩토리를 구성할 수 있습니다.

 

KafkaClientFactory

동기 (고급)

동기 처리를 엄격하게 사용해야 하는지 여부를 설정합니다.

false

boolean

schemaRegistryURL (confluent)

사용할 Confluent Platform 스키마 레지스트리 서버의 URL입니다. 형식은 host1:port1,host2:port2입니다. 이를 Confluent Platform 문서에서 schema.registry.url이라고 합니다. 이 옵션은 Confluent Platform (표준 Apache Kafka)에서만 사용할 수 있습니다.

 

문자열

interceptorClasses (monitoring)

생산자 또는 소비자에 대한 인터셉터를 설정합니다. 생산자 인터셉터는 org.apache.kafka.clients.producer.ProducerInterceptor 인터셉터를 구현하는 클래스여야 합니다. ConsumerInterceptor 인터셉터는 org.apache.kafka.clients.consumer.ConsumerInterceptor를 구현하는 클래스여야 합니다. 소비자에 Producer 인터셉터를 사용하는 경우 런타임에 클래스 캐스트를 발생시킵니다.

 

문자열

kerberosBeforeReloginMinTime (security)

새로 고침 시도 사이에 로그인 스레드 절전 시간.

60000

정수

kerberosInitCmd (security)

Kerberos kinit 명령 경로입니다. 기본값은 /usr/bin/kinit입니다.

/usr/bin/kinit

문자열

kerberosPrincipalToLocalRules (보안)

보안 주체 이름에서 짧은 이름(일반적으로 운영 체제 사용자 이름)으로 매핑하는 규칙 목록입니다. 규칙은 순서대로 평가되고 주체 이름과 일치하는 첫 번째 규칙은 짧은 이름에 매핑하는 데 사용됩니다. 목록의 이후 규칙은 무시됩니다. 기본적으로 {username}/{hostname}{REALM} 형식의 주체 이름은 {username}에 매핑됩니다. 형식에 대한 자세한 내용은 보안 권한 및 acls 문서를 참조하십시오. 여러 값을 쉼표로 구분할 수 있습니다.

DEFAULT

문자열

kerberosRenewJitter (security)

임의의 지터의 백분율이 갱신 시간에 추가되었습니다.

0.05

double

kerberosRenewWindowFactor (security)

로그인 스레드는 마지막 새로 고침에서 티켓 만료까지 지정된 창 요인에 도달할 때까지 유휴 상태가 됩니다. 이 때 티켓을 갱신하려고 합니다.

0.8

double

saslJaasConfig (security)

kafka sasl.jaas.config 매개변수 예제: org.apache.kafka.common.security.plain.PlainLoginModule 필수 username=USERNAME password=PASSWORD;를 노출합니다.

 

문자열

saslKerberosServiceName (security)

Kafka가 실행되는 Kerberos 사용자 이름입니다. Kafka의 10.0.0.1 구성 또는 Kafka 구성에서 정의할 수 있습니다.

 

문자열

saslMechanism (security)

SASL(Simple Authentication and Security Layer) 메커니즘이 사용되었습니다. 유효한 값은 의 내용을 참조하십시오.

GSSAPI

문자열

securityProtocol (보안)

브로커와 통신하는 데 사용되는 프로토콜입니다. SASL_PLAINTEXT, PLAINTEXT 및 SSL이 지원됩니다.

PLAINTEXT

문자열

sslCipherSuites (보안)

암호화 제품군 목록입니다. 이는 TLS 또는 SSL 네트워크 프로토콜을 사용하여 네트워크 연결의 보안 설정을 협상하는 데 사용되는 인증, 암호화, MAC 및 키 교환 알고리즘의 이름 지정 조합입니다. 기본적으로 사용 가능한 모든 암호화 제품군이 지원됩니다.

 

문자열

sslContextParameters (보안)

Camel SSLContextParameters 오브젝트를 사용한 SSL 구성입니다. 구성된 경우 다른 SSL 끝점 매개변수보다 먼저 적용됩니다. 참고: Kafka는 파일 위치의 키 저장소 로드만 지원하므로 KeyStoreParameters.resource 옵션에서 file:의 위치를 접두사로 지정합니다.

 

SSLContextParameters

sslEnabledProtocols (security)

SSL 연결에 활성화된 프로토콜 목록입니다. TLSv1.2, TLSv1.1 및 TLSv1은 기본적으로 활성화되어 있습니다.

 

문자열

sslEndpointAlgorithm (security)

서버 인증서를 사용하여 서버 호스트 이름을 검증하는 끝점 식별 알고리즘입니다.

https

문자열

sslKeymanagerAlgorithm (security)

SSL 연결에 대해 키 관리자 팩토리에서 사용하는 알고리즘입니다. 기본값은 Java 가상 머신에 대해 구성된 키 관리자 팩토리 알고리즘입니다.

SunX509

문자열

sslKeyPassword (security)

키 저장소 파일에 있는 개인 키의 암호입니다. 이는 클라이언트의 경우 선택 사항입니다.

 

문자열

sslKeystoreLocation (security)

키 저장소 파일의 위치입니다. 이는 클라이언트의 경우 선택 사항이며 클라이언트의 양방향 인증에 사용할 수 있습니다.

 

문자열

sslKeystorePassword (security)

키 저장소 파일의 저장소 암호입니다. 클라이언트의 경우 선택 사항이며 ssl.keystore.location이 구성된 경우에만 필요합니다.

 

문자열

sslKeystoreType (security)

키 저장소 파일의 파일 형식입니다. 이는 클라이언트의 경우 선택 사항입니다. 기본값은 JKS입니다.

JKS

문자열

SSLProtocol (보안)

SSLContext를 생성하는 데 사용되는 SSL 프로토콜입니다. 기본 설정은 TLS이며 대부분의 경우 적합합니다. 최근 JVM에서 허용되는 값은 TLS, TLSv1.1 및 TLSv1.2입니다. SSL, SSLv2 및 SSLv3은 이전 JVM에서 지원될 수 있지만 알려진 보안 취약점으로 인해 해당 사용이 권장되지 않습니다.

 

문자열

sslProvider (security)

SSL 연결에 사용되는 보안 공급자의 이름입니다. 기본값은 JVM의 기본 보안 공급자입니다.

 

문자열

sslTrustmanagerAlgorithm (security)

신뢰 관리자 팩토리에서 SSL 연결에 사용하는 알고리즘입니다. 기본값은 Java 가상 머신에 대해 구성된 신뢰 관리자 팩토리 알고리즘입니다.

PKIX

문자열

sslTruststoreLocation (security)

신뢰 저장소 파일의 위치입니다.

 

문자열

sslTruststorePassword (security)

신뢰 저장소 파일의 암호입니다.

 

문자열

sslTruststoreType (security)

신뢰 저장소 파일의 파일 형식입니다. 기본값은 JKS입니다.

JKS

문자열

useGlobalSslContextParameters (security)

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

boolean

27.4. 끝점 옵션

Kafka 끝점은 URI 구문을 사용하여 구성됩니다.

kafka:topic

다음과 같은 경로 및 쿼리 매개변수 사용:

27.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

주제 (공용)

사용할 항목의 이름입니다. 소비자에서는 쉼표를 사용하여 여러 주제를 분리할 수 있습니다. 생산자는 단일 항목에만 메시지를 보낼 수 있습니다.

 

문자열

27.4.2. 쿼리 매개변수(102 매개변수)

이름설명Default유형

추가 속성 (common)

kafka consumer 또는 kafka 생산자에 대한 추가 속성을 설정하며 camel 구성에서 직접 설정할 수 없는 경우 속성(예: Camel 구성에 아직 반영되지 않은 새 Kafka 속성)을 접두사로 추가해야 합니다. 예: 추가Properties.knativeal.id=12345&additionalProperties.schema.registry.url=http://localhost:8811/avro.

 

map

브로커 (공용)

사용할 Kafka 브로커의 URL입니다. 형식은 host1:port1,host2:port2이며 목록은 브로커의 하위 집합 또는 브로커의 하위 집합을 가리키는 VIP의 하위 집합일 수 있습니다. 이 옵션은 Kafka 설명서에서 bootstrap.servers라고 합니다.

 

문자열

ClientID (common)

클라이언트 ID는 호출 추적을 돕기 위해 각 요청에 전송된 사용자 지정 문자열입니다. 요청을 수행하는 애플리케이션을 논리적으로 식별해야 합니다.

 

문자열

headerFilterStrategy (common)

사용자 정의 HeaderFilterStrategy를 사용하여 Camel 메시지 간 헤더를 필터링하려면 다음을 수행합니다.

 

HeaderFilterStrategy

reconnectBackoffMaxMs (common)

브로커에 다시 연결할 때 대기하는 최대 시간(밀리초)입니다. 제공되는 경우 호스트당 백오프는 연속된 연결 실패마다 최대 최대 기하급수적으로 증가합니다. 백오프 증가를 계산한 후 연결 문제가 발생하지 않도록 20 % 임의 지터가 추가됩니다.

1000

정수

shutdownTimeout (common)

소비자 또는 생산자가 작업자 스레드를 종료하고 종료할 때까지 정상적으로 대기하는 시간(밀리초)입니다.

30000

int

allowManualCommit (consumer)

KafkaManualCommit을 통한 수동 커밋 허용 여부입니다. 이 옵션을 활성화하면 KafkaManualCommit 인스턴스가 Exchange 메시지 헤더에 저장되어 최종 사용자가 이 API에 액세스하고 Kafka 소비자를 통해 수동 오프셋 커밋을 수행할 수 있습니다.

false

boolean

autoCommitEnable (consumer)

true인 경우 사용자가 이미 가져온 메시지 오프셋을 ZooKeeper에 주기적으로 커밋합니다. 이 커밋된 오프셋은 프로세스가 새 소비자가 시작되는 위치로 실패할 때 사용됩니다.

true

부울

autoCommitIntervalMs (consumer)

소비자 오프셋이 zookeeper에 커밋되는 ms의 빈도입니다.

5000

정수

autoCommitOnStop (consumer)

소비자가 중지되어 브로커가 마지막으로 사용된 메시지에서 커밋이 있는지 확인할 때 명시적 자동 커밋을 수행할지 여부입니다. 이를 위해서는 autoCommitEnable 옵션이 설정되어 있어야 합니다. 가능한 값은 sync, async 또는 none입니다. 및 sync 값이 기본값입니다.

CloudEvent 값:

  • 동기화
  • async
  • none

동기화

문자열

autoOffsetReset (consumer)

ZooKeeper에 초기 오프셋이 없거나 오프셋이 범위를 벗어나면해야 할 일 : 가장 빠른 오프셋의 마지막으로 오프셋을 자동으로 재설정하십시오. 최신 오프셋으로 오프셋을 자동으로 재설정하십시오: 소비자에 예외가 발생합니다.

CloudEvent 값:

  • 최신 정보
  • 가장 빠른
  • none

최신 정보

문자열

breakOnFirstError (consumer)

이 옵션은 소비자가 교환을 처리하고 실패할 때 발생하는 상황을 제어합니다. 옵션이 false인 경우 소비자는 다음 메시지를 계속하고 처리합니다. 옵션이 true인 경우 소비자는 오류가 발생한 메시지의 오프셋을 다시 찾은 다음 이 메시지를 처리하기 위해 다시 시도합니다. 그러나 이로 인해 동일한 메시지가 무한한 처리로 이어질 수 있습니다. 그 바인딩이 실패할 때마다 실패할 수 있습니다. 따라서 Camel의 오류 처리기를 사용하여 이러한 문제를 처리하는 것이 좋습니다.

false

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

checkCrcs (consumer)

사용된 레코드의 CRC32를 자동으로 확인합니다. 이렇게 하면 메시지의 온-the-wire 또는 온-디스크 손상이 발생하지 않습니다. 이 검사에는 오버헤드가 추가되므로 과도한 성능을 원하는 경우 비활성화될 수 있습니다.

true

부울

commitTimeoutMs (consumer)

코드에서 동기 커밋이 완료될 때까지 대기하는 최대 시간(밀리초)입니다.

5000

long

consumerRequestTimeoutM (consumer)

구성은 클라이언트가 요청 응답을 기다리는 최대 시간을 제어합니다. 시간 초과가 경과하기 전에 응답이 수신되지 않으면 필요한 경우 클라이언트가 요청을 다시 전송하거나 재시도가 고갈되면 요청이 실패합니다.

40000

정수

consumersCount (consumer)

kafka 서버에 연결하는 소비자 수입니다. 각 소비자는 들어오는 데이터를 검색하고 처리하는 별도의 스레드에서 실행됩니다.

1

int

fetchMaxBytes (consumer)

서버에서 가져오기 요청에 대해 반환해야 하는 최대 데이터 양 This is not an absolute maximum, if the first message in the first message in the first message in the first message in the fetch is larger than this value, 메시지를 계속 반환하여 소비자가 진행할 수 있도록 합니다. 브로커가 승인한 최대 메시지 크기는 message.max.bytes(broker config) 또는 max.message.bytes(topic config)를 통해 정의됩니다. 소비자는 여러 가져오기를 병렬로 수행합니다.

52428800

정수

fetchMinBytes (consumer)

가져오기 요청에 대해 서버가 반환해야 하는 최소 데이터 양입니다. 데이터가 충분하지 않으면 요청은 요청에 응답하기 전에 많은 데이터가 누적될 때까지 기다립니다.

1

정수

fetchWaitMaxMs (consumer)

fetch.min.bytes를 즉시 충족하기에 충분하지 않은 경우 가져오기 요청에 응답하기 전에 서버가 차단하는 최대 시간입니다.

500

정수

groupId (consumer)

이 소비자가 속하는 소비자 프로세스 그룹을 고유하게 식별하는 문자열입니다. 동일한 그룹 ID를 여러 프로세스를 설정하면 해당 프로세스가 모두 동일한 소비자 그룹의 일부임을 나타냅니다. 이 옵션은 고객에게 필요합니다.

 

문자열

groupInstanceId (consumer)

최종 사용자가 제공하는 소비자 인스턴스의 고유 식별자입니다. 비어 있지 않은 문자열만 허용됩니다. 설정된 경우 소비자는 정적 멤버로 처리되므로 이 ID가 있는 하나의 인스턴스만 언제든지 소비자 그룹에 허용됩니다. 이는 일시적인 비가용성으로 인한 그룹 재조정(예: 프로세스 재시작)으로 인한 그룹 재조정을 방지하기 위해 더 큰 세션 시간 제한과 함께 사용할 수 있습니다. 설정하지 않으면 소비자는 기존 동작인 동적 멤버로 그룹을 조인합니다.

 

문자열

headerDeserializer (consumer)

사용자 지정 KafkaHeaderDeserializer를 사용하여 kafka 헤더 값을 역직렬화합니다.

 

KafkaHeaderDeserializer

heartbeatIntervalMs (consumer)

Kafka의 그룹 관리 기능을 사용할 때 소비자 조정자에게 하트비트 간 예상 시간입니다. 하트비트는 소비자의 세션이 활성 상태로 유지되고 새 소비자가 그룹을 참여하거나 나가면 재조정을 용이하게 하는 데 사용됩니다. 값은 session.timeout.ms보다 작아야 하지만 일반적으로 해당 값의 1/3을 넘지 않아야 합니다. 일반 리밸런스에 대해 예상 시간을 제어하도록 더욱 낮게 조정할 수 있습니다.

3000

정수

keyDeserializer (consumer)

Deserializer 인터페이스를 구현하는 키에 대한 Deserializer 클래스입니다.

org.apache.kafka.common.serialization.StringDeserializer

문자열

maxPartitionFetchBytes (consumer)

서버가 반환할 파티션당 최대 데이터 양입니다. 요청에 사용된 최대 총 메모리는 #partitions max.partition.fetch.bytes입니다. 이 크기는 서버에서 허용하는 최대 메시지 크기 이상이어야 합니다. 그러지 않으면 생산자가 소비자가 가져올 수 있는 것보다 큰 메시지를 보낼 수 있습니다. 이러한 경우 소비자는 특정 파티션에서 큰 메시지를 가져오려고 할 수 있습니다.

1048576

정수

maxPollIntervalMs (consumer)

소비자 그룹 관리를 사용할 때 poll() 호출 간 최대 지연입니다. 이렇게 하면 더 많은 레코드를 가져오기 전에 소비자가 유휴 상태가 될 수 있는 시간에 바인딩된 상한이 배치됩니다. poll()가 이 시간 만료 전에 호출되지 않은 경우 소비자는 실패한 것으로 간주되고 그룹이 파티션을 다른 멤버에 다시 할당하기 위해 재조정됩니다.

 

long

maxPollRecords (consumer)

poll()에 대한 단일 호출에서 반환된 최대 레코드 수입니다.

500

정수

offsetRepository (consumer)

주제의 각 파티션의 오프셋을 로컬로 저장하기 위해 사용할 오프셋 리포지토리입니다. 하나를 정의하면 자동 커밋이 비활성화됩니다.

 

StateRepository

partitionAssignor (consumer)

클라이언트가 그룹 관리를 사용할 때 클라이언트가 파티션 소유권을 배포하는 데 사용할 파티션 할당 전략의 클래스 이름입니다.

org.apache.kafka.clients.consumer.RangeAssignor

문자열

pollOnError (consumer)

kafka가 새 메시지를 폴링하는 동안 예외를 제한하면 어떻게 해야 합니까. 은 엔드포인트 수준에서 명시적 값을 구성하지 않는 한 기본적으로 구성 요소 구성의 값을 사용합니다. DISCARD는 메시지를 삭제하고 다음 메시지를 계속 폴링합니다. ERROR_HANDLER는 Camel의 오류 처리기를 사용하여 예외를 처리하고 나중에 다음 메시지를 계속 폴링합니다. RECONNECT는 소비자를 다시 연결하고 메시지를 다시 폴링하려고 시도하면 동일한 메시지를 다시 폴링하면 소비자 재시도에서 소비자를 다시 중지시킬 수 있습니다(고객이 메시지를 다시 사용할 수 있어야 하는 경우 수동으로 시작/다시 시작됨).

CloudEvent 값:

  • DISCARD
  • ERROR_HANDLER
  • RECONNECT
  • RETRY
  • STOP

ERROR_HANDLER

PollOnError

pollTimeoutM (consumer)

KafkaConsumer를 폴링할 때 사용되는 제한 시간입니다.

5000

long

resumeStrategy (consumer)

이 옵션을 사용하면 사용자 정의 재개 전략을 설정할 수 있습니다. resume 전략은 파티션이 할당될 때(예: 연결 또는 다시 연결할 때) 실행됩니다. 구현이 작업을 재개하는 방법을 사용자 지정하고 seekTo 및 offsetRepository 메커니즘에 대한 보다 유연한 대안으로 사용할 수 있습니다. 구현 세부 사항은 KafkaConsumerResumeStrategy를 참조하십시오. 이 옵션은 자동 커밋 설정에 영향을 미치지 않습니다. 이 설정을 사용하는 구현에서는 이와 함께 수동 커밋 옵션을 사용하여 평가할 수도 있습니다.

 

KafkaConsumerResumeStrategy

seekTo (consumer)

KafkaConsumer가 시작시 시작 또는 종료 시부터 읽는 경우 설정 : 처음부터 읽기 : 마지막부터 읽기 This is replacing the earlier property seekToBeginning.

CloudEvent 값:

  • Starting
  • end
 

문자열

sessionTimeoutM (consumer)

Kafka의 그룹 관리 기능을 사용할 때 오류를 감지하는 데 사용되는 시간 초과입니다.

10000

정수

specificAvroReader (consumer)

이를 통해 Confluent Platform 스키마 레지스트리 및 io.confluent.kafka.serializers.KafkaAvroDeserializer와 함께 사용할 수 있습니다. 이 옵션은 Confluent Platform (표준 Apache Kafka)에서만 사용할 수 있습니다.

false

boolean

topicIsPattern (consumer)

주제가 패턴(regular expression)인지 여부. 이를 사용하여 패턴과 일치하는 동적 주제 수를 서브스크립션할 수 있습니다.

false

boolean

valueDeserializer (consumer)

Deserializer 인터페이스를 구현하는 값에 대한 Deserializer 클래스입니다.

org.apache.kafka.common.serialization.StringDeserializer

문자열

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

kafkaManualCommitFactory (consumer (advanced)

KafkaManualCommit 인스턴스를 생성하는 데 사용할 팩토리입니다. 이를 통해 사용자 지정 팩토리를 플러그인하여 사용자 지정 KafkaManualCommit 인스턴스를 생성할 수 있습니다. 이 경우 박스에서 제공되는 기본 구현에서 벗어난 수동 커밋을 수행할 때 특수 논리가 필요합니다.

 

KafkaManualCommitFactory

bufferMemorySize (producer)

생산자가 서버로 전송되는 대기 중인 레코드를 버퍼링하는 데 사용할 수 있는 총 메모리 바이트입니다. 생산자가 block.on.buffer.full에서 지정한 기본 설정에 따라 서버에 레코드를 더 빠르게 전송하면 생산자가 사용하는 모든 메모리가 버퍼링에 사용되는 것은 아니지만 모든 메모리가 버퍼링에 사용되는 것은 아니기 때문에 프로듀서가 사용하는 기본 설정에 따라 예외를 차단하거나 throw합니다. 이 설정은 프로듀서에서 사용하는 모든 메모리가 버퍼링에 사용되는 것은 아니므로 하드 바인딩은 아닙니다. 일부 추가 메모리는 압축( 압축이 활성화된 경우)과 진행 중인 요청을 유지 관리하는 데 사용됩니다.

33554432

정수

compressionCodec (producer)

이 매개변수를 사용하면 이 프로듀서에서 생성한 모든 데이터에 대해 압축 코드c를 지정할 수 있습니다. 유효한 값은 none, gzip 및 snappy입니다.

CloudEvent 값:

  • none
  • gzip
  • snappy
  • lz4

none

문자열

connectionMaxIdleMs (producer)

이 구성에서 지정한 시간(밀리초) 후 유휴 연결을 종료합니다.

540000

정수

deliveryTimeoutM (producer)

send() 호출을 반환한 후 성공 또는 실패를 보고하는 시간에 상한입니다. 이렇게 하면 레코드가 전송 전에 지연되는 총 시간, 브로커의 승인 대기 시간(필요한 경우) 및 재시도 가능한 전송 실패에 허용되는 시간이 제한됩니다.

120000

정수

enableIdempotence (producer)

'true'로 설정하면 생산자가 스트림에 각 메시지의 사본을 정확히 1개씩 작성합니다. 'false'인 경우 생산자는 스트림에 재시도된 메시지의 중복을 작성할 수 있습니다. true로 설정하면 max.in.flight.requests.per.connection을 1로 설정하고 재시도할 수 없으며 추가 acks를 'all'로 설정해야 합니다.

false

boolean

headerSerializer (producer)

사용자 지정 KafkaHeaderSerializer를 사용하여 kafka 헤더 값을 직렬화합니다.

 

KafkaHeaderSerializer

(producer)

레코드 키(키가 지정되지 않은 경우 null)입니다. 이 옵션이 구성된 경우 헤더 KafkaConstants#KEY보다 우선합니다.

 

문자열

keySerializer (producer)

키의 serializer 클래스(제공되지 않은 경우 메시지의 기본값과 동일).

org.apache.kafka.common.serialization.StringSerializer

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

lingerMs (producer)

생산자는 단일 배치된 요청으로의 요청 전송 사이에 들어오는 모든 레코드를 그룹화합니다. 일반적으로 이는 전송 가능한 것보다 레코드가 더 빨리 도달할 때 로드 중에만 발생합니다. 그러나 경우에 따라 클라이언트는 중간 수준의 부하에서도 요청 수를 줄일 수 있습니다. 이 설정은 약간의 인공 지연을 추가하여 즉, 생산자가 즉시 레코드를 보내는 대신 지정된 지연까지 대기하여 전송이 함께 배치될 수 있도록 다른 레코드를 보낼 수 있도록 합니다. 이는 TCP의 Nagle 알고리즘과 유사합니다. 이 설정은 일괄 처리 지연에 대한 상한을 제공합니다. 이 설정에 관계없이 파티션의 batch.size 가치가 있는 경우 즉시 전송되지만 이 파티션에 누적된 바이트 수보다 적으면 더 많은 레코드가 표시되도록 지정된 시간에 대해 '어링er'합니다. 이 설정 기본값은 0입니다(예: no delay). 예를 들어 linger.ms=5를 설정하면 전송된 요청 수를 줄이는 효과가 있지만 로드 중에 전송된 레코드에 최대 5ms의 대기 시간을 더할 수 있습니다.

0

정수

maxBlockMs (producer)

구성에서는 kafka로 보내는 기간을 제어합니다. 이러한 방법은 여러 가지 이유로 차단될 수 있습니다. 예를 들어 버퍼 전체 메타데이터를 사용할 수 없습니다. 이 구성은 메타데이터 가져오기에 소비된 총 시간, 키 및 값의 직렬화, send()를 수행할 때 버퍼 메모리의 파티셔닝 및 할당에 최대 제한을 적용합니다. partitionsFor()의 경우 이 구성은 메타데이터 대기 시 최대 시간 임계값을 적용합니다.

60000

정수

maxInFlightRequest (producer)

인증되지 않은 최대 요청 수에 따라 클라이언트가 차단하기 전에 단일 연결을 통해 전송할 수 있습니다. 이 설정이 1보다 크고 전송에 실패한 경우 재시도로 인해 메시지 재순환 위험이 있습니다(예: 재시도가 활성화된 경우).

5

정수

maxRequestSize (producer)

요청의 최대 크기입니다. 이는 또한 실질적으로 최대 레코드 크기에 대한 제한입니다. 서버에는 이와 다를 수 있는 레코드 크기에 대한 자체 제한이 있습니다. 이 설정은 생산자가 대규모 요청을 보내지 않도록 단일 요청으로 전송할 레코드 배치 수를 제한합니다.

1048576

정수

metadataMaxAgeMs (producer)

이 기간(밀리초) 후 새 브로커 또는 파티션을 사전에 검색하기 위해 파티션 리더십 변경을 보지 못하더라도 메타데이터를 강제로 새로 고침합니다.

300000

정수

metricReporters (producer)

메트릭 보고자로 사용할 클래스 목록입니다. MetricReporter 인터페이스를 구현하면 새 지표 생성에 대한 알림을 받을 클래스를 연결할 수 있습니다. JmxReporter는 항상 통계를 등록하기 위해 포함됩니다.

 

문자열

metricsSampleWindowMs (producer)

메트릭으로 유지 관리되는 샘플 수입니다.

30000

정수

noOfMetricsSample (producer)

메트릭으로 유지 관리되는 샘플 수입니다.

2

정수

partitioner (producer)

하위 주제 간에 메시지를 분할하는 partitioner 클래스입니다. 기본 partitioner는 키의 해시를 기반으로 합니다.

org.apache.kafka.clients.producer.internals.DefaultPartitioner

문자열

partitionKey (producer)

레코드가 전송되는 파티션(또는 파티션이 지정되지 않은 경우 null)입니다. 이 옵션이 구성된 경우 헤더 KafkaConstants#PARTITION_KEY보다 우선합니다.

 

정수

producerBatchSize (producer)

생산자는 여러 레코드가 동일한 파티션에 전송될 때마다 레코드를 더 적은 수의 요청으로 함께 배치하려고 합니다. 이렇게 하면 클라이언트와 서버 모두에서 성능이 향상됩니다. 이 구성은 기본 배치 크기(바이트)를 제어합니다. 이 크기보다 큰 배치 레코드는 없습니다. 브로커에 전송된 요청에는 여러 일괄 처리가 포함됩니다. 하나는 전송 가능한 데이터가 있는 각 파티션에 대해 일괄 처리를 덜 일반화하고 처리량을 줄일 수 있습니다(0의 배치 크기는 완전히 비활성화됨). 배치 크기가 매우 큰 경우 추가 레코드를 예상할 때 항상 지정된 일괄 처리 크기의 버퍼를 할당하므로 메모리를 약간 더 불편하게 사용할 수 있습니다.

16384

정수

queueBufferingMaxMessages (producer)

생산자를 차단하거나 데이터를 삭제하기 전에 async 모드를 사용할 때 프로듀서에서 대기할 수 있는 최대 무의식 메시지 수입니다.

10000

정수

receiveBufferBytes (producer)

데이터를 읽을 때 사용할 TCP 수신 버퍼(SO_RCVBUF)의 크기입니다.

65536

정수

reconnectBackoffMs (producer)

지정된 호스트에 다시 연결하기 전에 대기하는 시간입니다. 이렇게 하면 엄격한 루프에서 호스트에 반복적으로 연결하는 것을 방지할 수 있습니다. 이 백오프는 소비자가 브로커로 보낸 모든 요청에 적용됩니다.

50

정수

recordMetadata (producer)

생산자가 Kafka로 전송한 RecordMetadata 결과를 저장해야 하는지 여부입니다. 결과는 RecordMetadata 메타데이터가 포함된 목록에 저장됩니다. 목록은 KafkaConstants#KAFKA_RECORDMETA 키가 있는 헤더에 저장됩니다.

true

boolean

requestRequiredAcks (producer)

생산자가 승인한 승인의 수에 따라 요청이 완료된 것을 고려하기 전에 리더를 수령해야 합니다. 이렇게 하면 전송되는 레코드의 중요도가 제어됩니다. acks=0로 설정하면 생산자가 서버의 승인을 전혀 기다리지 않습니다. 레코드는 소켓 버퍼에 즉시 추가되고 전송된 것으로 간주합니다. 이 경우 서버가 레코드를 수신했음을 보장할 수 없으며 재시도 구성은 적용되지 않습니다(클라이언트는 일반적으로 오류를 알 수 없기 때문에). 각 레코드에 대해 주어진 오프셋은 항상 -1로 설정됩니다. acks=1 이는 리더가 해당 로컬 로그에 레코드를 작성하지만 모든 팔로워의 완전한 승인을 기다리지 않고 응답한다는 것을 의미합니다. 이 경우 레코드 확인 후 바로 리더가 실패하지만, 팔로워가 복제되기 전에 해당 레코드가 손실됩니다. acks=all이 발생하면 비동기(in-sync) 복제본의 전체 세트를 확인하여 레코드를 승인할 수 있습니다. 이렇게 하면 하나 이상의 동기화 복제본이 활성 상태로 유지되는 한 레코드가 손실되지 않습니다. 이는 사용 가능한 보증입니다.

CloudEvent 값:

  • -1
  • 0
  • 1
  • all

1

문자열

requestTimeoutM (producer)

브로커가 클라이언트에 오류를 보내기 전에 request.required.acks 요구 사항을 충족하기 위해 대기하는 시간입니다.

30000

정수

재시도 (producer)

값을 0보다 크게 설정하면 클라이언트가 전송이 잠재적으로 일시적인 오류와 함께 실패하는 모든 레코드를 다시 보냅니다. 이 재시도는 클라이언트가 오류를 수신할 때 레코드를 재지정하는 경우와 다르지 않습니다. 재시도를 허용하면 두 개의 레코드가 단일 파티션에 전송되고 첫 번째 레코드가 실패하고 다시 시도되지만 두 번째 레코드가 먼저 표시될 수 있기 때문에 레코드 순서가 변경될 수 있습니다.

0

정수

retryBackoffMs (producer)

각 재시도 전에 생산자는 관련 주제의 메타데이터를 새로 고침하여 새 리더가 선택되었는지 확인합니다. 리더 선택에는 시간이 걸리므로 이 속성은 메타데이터를 새로 고치기 전에 프로듀서가 대기하는 시간을 지정합니다.

100

정수

sendBufferBytes (producer)

소켓 쓰기 버퍼 크기.

131072

정수

valueSerializer (producer)

메시지에 대한 serializer 클래스입니다.

org.apache.kafka.common.serialization.StringSerializer

문자열

workerpool (producer)

kafka 서버 이후에 Exchange를 계속 라우팅하는 데 사용자 지정 작업자 풀을 사용하려면 비동기 비차단 처리를 사용하여 KafkaProducer에서 전송된 메시지를 인식합니다. 이 옵션을 사용하는 경우 더 이상 필요하지 않은 경우 풀을 종료하려면 스레드 풀의 라이프사이클을 처리해야 합니다.

 

ExecutorService

workerPoolCoreSize (producer)

kafka 서버 이후에 Exchange를 계속 라우팅하기 위한 작업자 풀의 코어 스레드 수는 비동기 비차단 처리를 사용하여 KafkaProducer에서 전송된 메시지를 인식합니다.

10

정수

workerPoolMaxSize (producer)

kafka 서버 후에 Exchange를 계속 라우팅하기 위한 작업자 풀의 최대 스레드 수는 비동기 비차단 처리를 사용하여 KafkaProducer에서 전송된 메시지를 승인합니다.

20

정수

kafkaClientFactory (advanced)

org.apache.kafka.clients.consumer.KafkaConsumer 및 org.apache.kafka.clients.producer.KafkaProducer 인스턴스를 생성하는 데 사용할 팩토리입니다. 이를 통해 vanill Kafka 클라이언트를 확장하는 논리를 사용하여 인스턴스를 생성하도록 사용자 지정 팩토리를 구성할 수 있습니다.

 

KafkaClientFactory

동기 (고급)

동기 처리를 엄격하게 사용해야 하는지 여부를 설정합니다.

false

boolean

schemaRegistryURL (confluent)

사용할 Confluent Platform 스키마 레지스트리 서버의 URL입니다. 형식은 host1:port1,host2:port2입니다. 이를 Confluent Platform 문서에서 schema.registry.url이라고 합니다. 이 옵션은 Confluent Platform (표준 Apache Kafka)에서만 사용할 수 있습니다.

 

문자열

interceptorClasses (monitoring)

생산자 또는 소비자에 대한 인터셉터를 설정합니다. 생산자 인터셉터는 org.apache.kafka.clients.producer.ProducerInterceptor 인터셉터를 구현하는 클래스여야 합니다. ConsumerInterceptor 인터셉터는 org.apache.kafka.clients.consumer.ConsumerInterceptor를 구현하는 클래스여야 합니다. 소비자에 Producer 인터셉터를 사용하는 경우 런타임에 클래스 캐스트를 발생시킵니다.

 

문자열

kerberosBeforeReloginMinTime (security)

새로 고침 시도 사이에 로그인 스레드 절전 시간.

60000

정수

kerberosInitCmd (security)

Kerberos kinit 명령 경로입니다. 기본값은 /usr/bin/kinit입니다.

/usr/bin/kinit

문자열

kerberosPrincipalToLocalRules (보안)

보안 주체 이름에서 짧은 이름(일반적으로 운영 체제 사용자 이름)으로 매핑하는 규칙 목록입니다. 규칙은 순서대로 평가되고 주체 이름과 일치하는 첫 번째 규칙은 짧은 이름에 매핑하는 데 사용됩니다. 목록의 이후 규칙은 무시됩니다. 기본적으로 {username}/{hostname}{REALM} 형식의 주체 이름은 {username}에 매핑됩니다. 형식에 대한 자세한 내용은 보안 권한 및 acls 문서를 참조하십시오. 여러 값을 쉼표로 구분할 수 있습니다.

DEFAULT

문자열

kerberosRenewJitter (security)

임의의 지터의 백분율이 갱신 시간에 추가되었습니다.

0.05

double

kerberosRenewWindowFactor (security)

로그인 스레드는 마지막 새로 고침에서 티켓 만료까지 지정된 창 요인에 도달할 때까지 유휴 상태가 됩니다. 이 때 티켓을 갱신하려고 합니다.

0.8

double

saslJaasConfig (security)

kafka sasl.jaas.config 매개변수 예제: org.apache.kafka.common.security.plain.PlainLoginModule 필수 username=USERNAME password=PASSWORD;를 노출합니다.

 

문자열

saslKerberosServiceName (security)

Kafka가 실행되는 Kerberos 사용자 이름입니다. Kafka의 10.0.0.1 구성 또는 Kafka 구성에서 정의할 수 있습니다.

 

문자열

saslMechanism (security)

SASL(Simple Authentication and Security Layer) 메커니즘이 사용되었습니다. 유효한 값은 의 내용을 참조하십시오.

GSSAPI

문자열

securityProtocol (보안)

브로커와 통신하는 데 사용되는 프로토콜입니다. SASL_PLAINTEXT, PLAINTEXT 및 SSL이 지원됩니다.

PLAINTEXT

문자열

sslCipherSuites (보안)

암호화 제품군 목록입니다. 이는 TLS 또는 SSL 네트워크 프로토콜을 사용하여 네트워크 연결의 보안 설정을 협상하는 데 사용되는 인증, 암호화, MAC 및 키 교환 알고리즘의 이름 지정 조합입니다. 기본적으로 사용 가능한 모든 암호화 제품군이 지원됩니다.

 

문자열

sslContextParameters (보안)

Camel SSLContextParameters 오브젝트를 사용한 SSL 구성입니다. 구성된 경우 다른 SSL 끝점 매개변수보다 먼저 적용됩니다. 참고: Kafka는 파일 위치의 키 저장소 로드만 지원하므로 KeyStoreParameters.resource 옵션에서 file:의 위치를 접두사로 지정합니다.

 

SSLContextParameters

sslEnabledProtocols (security)

SSL 연결에 활성화된 프로토콜 목록입니다. TLSv1.2, TLSv1.1 및 TLSv1은 기본적으로 활성화되어 있습니다.

 

문자열

sslEndpointAlgorithm (security)

서버 인증서를 사용하여 서버 호스트 이름을 검증하는 끝점 식별 알고리즘입니다.

https

문자열

sslKeymanagerAlgorithm (security)

SSL 연결에 대해 키 관리자 팩토리에서 사용하는 알고리즘입니다. 기본값은 Java 가상 머신에 대해 구성된 키 관리자 팩토리 알고리즘입니다.

SunX509

문자열

sslKeyPassword (security)

키 저장소 파일에 있는 개인 키의 암호입니다. 이는 클라이언트의 경우 선택 사항입니다.

 

문자열

sslKeystoreLocation (security)

키 저장소 파일의 위치입니다. 이는 클라이언트의 경우 선택 사항이며 클라이언트의 양방향 인증에 사용할 수 있습니다.

 

문자열

sslKeystorePassword (security)

키 저장소 파일의 저장소 암호입니다. 클라이언트의 경우 선택 사항이며 ssl.keystore.location이 구성된 경우에만 필요합니다.

 

문자열

sslKeystoreType (security)

키 저장소 파일의 파일 형식입니다. 이는 클라이언트의 경우 선택 사항입니다. 기본값은 JKS입니다.

JKS

문자열

SSLProtocol (보안)

SSLContext를 생성하는 데 사용되는 SSL 프로토콜입니다. 기본 설정은 TLS이며 대부분의 경우 적합합니다. 최근 JVM에서 허용되는 값은 TLS, TLSv1.1 및 TLSv1.2입니다. SSL, SSLv2 및 SSLv3은 이전 JVM에서 지원될 수 있지만 알려진 보안 취약점으로 인해 해당 사용이 권장되지 않습니다.

 

문자열

sslProvider (security)

SSL 연결에 사용되는 보안 공급자의 이름입니다. 기본값은 JVM의 기본 보안 공급자입니다.

 

문자열

sslTrustmanagerAlgorithm (security)

신뢰 관리자 팩토리에서 SSL 연결에 사용하는 알고리즘입니다. 기본값은 Java 가상 머신에 대해 구성된 신뢰 관리자 팩토리 알고리즘입니다.

PKIX

문자열

sslTruststoreLocation (security)

신뢰 저장소 파일의 위치입니다.

 

문자열

sslTruststorePassword (security)

신뢰 저장소 파일의 암호입니다.

 

문자열

sslTruststoreType (security)

신뢰 저장소 파일의 파일 형식입니다. 기본값은 JKS입니다.

JKS

문자열

Producer/Consumer 구성에 대한 자세한 내용은 다음을 참조하십시오.

27.5. 메시지 헤더

27.5.1. 소비자 헤더

Kafka의 메시지를 사용할 때 다음 헤더를 사용할 수 있습니다.

헤더 상수헤더 값유형설명

KafkaConstants.TOPIC

"kafka.TOPIC"

문자열

메시지가 시작된 항목

KafkaConstants.PARTITION

"kafka.PARTITION"

정수

메시지가 저장된 파티션

KafkaConstants.OFFSET

"kafka.OFFSET"

long

메시지 오프셋

KafkaConstants.KEY

"kafka.KEY"

개체

구성된 경우 메시지의 키

KafkaConstants.HEADERS

"kafka.HEADERS"

org.apache.kafka.common.header.Headers

레코드 헤더

KafkaConstants.LAST_RECORD_BEFORE_COMMIT

"kafka.LAST_RECORD_BEFORE_COMMIT"

부울

커밋 전 마지막 레코드인지 여부( AutoCommitEnable 끝점 매개변수가 false인 경우에만 사용 가능)

KafkaConstants.LAST_POLL_RECORD

"kafka.LAST_POLL_RECORD"

부울

현재 폴링 요청 내의 마지막 레코드를 나타냅니다( autoCommitEnable 끝점 매개변수가 false 또는 allowManualCommittrue인 경우에만 사용 가능)

KafkaConstants.MANUAL_COMMIT

"CamelKafkaManualCommit"

KafkaManualCommit

Kafka 소비자를 사용할 때 수동 오프셋 커밋을 강제 적용하는 데 사용할 수 있습니다.

27.5.2. 생산자 헤더

Kafka로 메시지를 전송하기 전에 다음 헤더를 구성할 수 있습니다.

헤더 상수헤더 값유형설명

KafkaConstants.KEY

"kafka.KEY"

개체

필요: 모든 관련 메시지가 동일한 파티션에 포함되도록 하려면 메시지의 키입니다.

KafkaConstants.OVERRIDE_TOPIC

"kafka.OVERRIDE_TOPIC"

문자열

메시지를 보내는 주제(override 및 precedence)는 보존되지 않습니다.

KafkaConstants.OVERRIDE_TIMESTAMP

"kafka.OVERRIDE_TIMESTAMP"

long

또한 ProducerRecord에는 관련 타임 스탬프가 있습니다. 사용자가 타임스탬프를 제공하면 생산자는 제공된 타임 스탬프로 레코드를 스탬프하고 헤더가 유지되지 않습니다.

KafkaConstants.PARTITION_KEY

"kafka.PARTITION_KEY"

정수

파티션 명시적으로 지정

동적 항목에 메시지를 보내려면 생산자에서 제거된 대로 메시지를 따라 보내지 않는 일회성 헤더로 KafkaConstants.OVERRIDE_TOPIC 를 사용합니다.

Kafka로 메시지를 보낸 후 다음 헤더를 사용할 수 있습니다.

헤더 상수헤더 값유형설명

KafkaConstants.KAFKA_RECORDMETA

"org.apache.kafka.clients.producer.RecordMetadata"

List<RecordMetadata>

metadata( recordMetadata endpoint 매개변수가 true인 경우에만 구성됨)

27.6. 소비자 오류 처리

kafka 소비자가 kafka 브로커의 메시지를 폴링하는 동안 오류가 발생할 수 있습니다. 이 섹션에서는 발생하는 사항과 구성할 수 있는 사항에 대해 설명합니다.

소비자는 Kafka 폴링 API를 호출할 때 예외가 발생할 수 있습니다. 예를 들어 메시지가 유효하지 않은 데이터 및 기타 여러 종류의 오류로 인해 역직렬화될 수 없는 경우입니다. 이러한 오류는 재시도 하거나 하지 않는 KafkaException 의 형태입니다. 재시도할 수 있는 예외(RetriableException)는 다시 시도됩니다(중간 폴링 시간 사용). 다른 모든 예외는 pollOnError 구성에 따라 처리됩니다. 이 구성에는 다음과 같은 값이 있습니다.

  • DISCARD는 메시지를 삭제하고 다음 메시지를 계속 폴링합니다.
  • ERROR_HANDLER는 Camel의 오류 처리기를 사용하여 예외를 처리하고 나중에 다음 메시지를 계속 폴링합니다.
  • RECONNECT는 소비자를 다시 연결하고 메시지를 다시 폴링합니다.
  • RETRY는 소비자가 동일한 메시지를 다시 폴링하도록 합니다.
  • STOP는 소비자를 중지합니다. 소비자는 메시지를 다시 사용할 수 있어야 하는 경우 수동으로 시작/재시작해야 합니다.

기본값은 ERROR_HANDLER 로, Camel의 오류 처리기(구성된 경우)가 발생한 예외를 처리하도록 합니다. 그런 다음 다음 메시지를 계속 폴링합니다. 이 동작은 Camel 구성 요소에 있는 bridgeErrorHandler 옵션과 유사합니다.

고급 제어의 경우 org.apache.camel.component.kafka.PollExceptionStrategy 의 사용자 지정 구현을 구성 요소 수준에서 구성할 수 있으므로 위의 전략 중 어떤 예외가 발생하는지 제어할 수 있습니다.

27.7. 샘플

27.7.1. Kafka에서 메시지 사용

Kafka에서 메시지를 읽는 데 필요한 최소 경로는 다음과 같습니다.

from("kafka:test?brokers=localhost:9092")
    .log("Message received from Kafka : ${body}")
    .log("    on the topic ${headers[kafka.TOPIC]}")
    .log("    on the partition ${headers[kafka.PARTITION]}")
    .log("    with the offset ${headers[kafka.OFFSET]}")
    .log("    with the key ${headers[kafka.KEY]}")

여러 주제의 메시지를 사용해야 하는 경우 주제 이름의 쉼표로 구분된 목록을 사용할 수 있습니다.

from("kafka:test,test1,test2?brokers=localhost:9092")
    .log("Message received from Kafka : ${body}")
    .log("    on the topic ${headers[kafka.TOPIC]}")
    .log("    on the partition ${headers[kafka.PARTITION]}")
    .log("    with the offset ${headers[kafka.OFFSET]}")
    .log("    with the key ${headers[kafka.KEY]}")

주제 이름으로 패턴을 제공하고 topicIsPattern 옵션을 사용하여 패턴을 제공하는 여러 주제를 구독할 수도 있습니다.

from("kafka:test*?brokers=localhost:9092&topicIsPattern=true")
    .log("Message received from Kafka : ${body}")
    .log("    on the topic ${headers[kafka.TOPIC]}")
    .log("    on the partition ${headers[kafka.PARTITION]}")
    .log("    with the offset ${headers[kafka.OFFSET]}")
    .log("    with the key ${headers[kafka.KEY]}")

Kafka에서 메시지를 사용할 때 자체 오프셋 관리를 사용할 수 있으며 이 관리를 Kafka에 위임할 수 없습니다. 오프셋을 유지하려면 구성 요소에 File StateRepository 와 같은 StateRepository 구현이 필요합니다. 이 빈은 레지스트리에서 사용할 수 있어야 합니다. 이를 사용하는 방법:

// Create the repository in which the Kafka offsets will be persisted
FileStateRepository repository = FileStateRepository.fileStateRepository(new File("/path/to/repo.dat"));

// Bind this repository into the Camel registry
Registry registry = createCamelRegistry();
registry.bind("offsetRepo", repository);

// Configure the camel context
DefaultCamelContext camelContext = new DefaultCamelContext(registry);
camelContext.addRoutes(new RouteBuilder() {
    @Override
    public void configure() throws Exception {
        from("kafka:" + TOPIC + "?brokers=localhost:{{kafkaPort}}" +
                     // Setup the topic and broker address
                     "&groupId=A" +
                     // The consumer processor group ID
                     "&autoOffsetReset=earliest" +
                     // Ask to start from the beginning if we have unknown offset
                     "&offsetRepository=#offsetRepo")
                     // Keep the offsets in the previously configured repository
                .to("mock:result");
    }
});

27.7.2. Kafka에 메시지 생성

Kafka에 메시지를 작성하는 데 필요한 최소 경로는 다음과 같습니다.

from("direct:start")
    .setBody(constant("Message from Camel"))          // Message to send
    .setHeader(KafkaConstants.KEY, constant("Camel")) // Key of the message
    .to("kafka:test?brokers=localhost:9092");

27.8. SSL 구성

Kafka 구성 요소에서 SSL 통신을 구성하는 두 가지 방법이 있습니다.

첫 번째 방법은 많은 SSL 끝점 매개변수를 사용하는 것입니다.

from("kafka:" + TOPIC + "?brokers=localhost:{{kafkaPort}}" +
             "&groupId=A" +
             "&sslKeystoreLocation=/path/to/keystore.jks" +
             "&sslKeystorePassword=changeit" +
             "&sslKeyPassword=changeit" +
             "&securityProtocol=SSL")
        .to("mock:result");

두 번째 방법은 sslContextParameters 엔드포인트 매개변수를 사용하는 것입니다.

// Configure the SSLContextParameters object
KeyStoreParameters ksp = new KeyStoreParameters();
ksp.setResource("/path/to/keystore.jks");
ksp.setPassword("changeit");
KeyManagersParameters kmp = new KeyManagersParameters();
kmp.setKeyStore(ksp);
kmp.setKeyPassword("changeit");
SSLContextParameters scp = new SSLContextParameters();
scp.setKeyManagers(kmp);

// Bind this SSLContextParameters into the Camel registry
Registry registry = createCamelRegistry();
registry.bind("ssl", scp);

// Configure the camel context
DefaultCamelContext camelContext = new DefaultCamelContext(registry);
camelContext.addRoutes(new RouteBuilder() {
    @Override
    public void configure() throws Exception {
        from("kafka:" + TOPIC + "?brokers=localhost:{{kafkaPort}}" +
                     // Setup the topic and broker address
                     "&groupId=A" +
                     // The consumer processor group ID
                     "&sslContextParameters=#ssl" +
                     // The security protocol
                     "&securityProtocol=SSL)
                     // Reference the SSL configuration
                .to("mock:result");
    }
});

27.9. Kafka idempotent 리포지토리 사용

camel-kafka 라이브러리는 Kafka 주제 기반 idempotent 리포지토리를 제공합니다.

이 리포지토리는 Kafka 주제에서 idempotent 상태(add/remove)에 대한 모든 변경 사항을 저장하고 이벤트 소싱을 통해 각 리포지토리의 프로세스 인스턴스에 대한 로컬 메모리 캐시를 채웁니다. 사용된 주제는 idempotent 리포지토리 인스턴스별로 고유해야 합니다.

이 메커니즘에는 주제 파티션 수에 대한 요구 사항이 없습니다. 리포지토리가 모든 파티션에서 동시에 사용되기 때문입니다. 또한 주제의 복제 요인에 대한 요구 사항은 없습니다.

주제를 사용하는 각 리포지토리 인스턴스(예: 일반적으로 병렬로 실행되는 다른 시스템에서)는 자체 소비자 그룹을 제어하므로 동일한 주제를 사용하는 10개의 Camel 프로세스 클러스터에서 각각의 오프셋을 제어합니다.

시작 시 인스턴스는 주제를 구독하고 오프셋을 시작으로 되풀이하여 캐시를 최신 상태로 다시 빌드합니다. 이 캐시는 하나의 pollDurationMs in length에서 0 레코드를 반환할 때까지 온 상태로 간주되지 않습니다. 시작은 캐시가 워밍업되거나 30초가 될 때까지 완료되지 않습니다. 후자가 멱등 저장소가 발생하면 소비자가 주제의 마지막까지 오를 때까지 일관되지 않은 상태가 될 수 있습니다.

고유성 검사에 사용되는 헤더의 형식에 유의하십시오. 기본적으로 Strings를 데이터 형식으로 사용합니다. 기본 숫자 형식을 사용하는 경우 헤더를 적절하게 역직렬화해야 합니다. 예제를 보려면 아래 샘플을 확인하십시오.

KafkaIdempotentRepository 에는 다음과 같은 속성이 있습니다.

속성설명

주제

변경 사항을 브로드캐스트하는 데 사용할 Kafka 주제의 이름입니다. (필수)

bootstrapServers

내부 Kafka 생산자 및 소비자의 bootstrap.servers 속성입니다. consumerConfigproducerConfig 를 설정하지 않는 경우 이 값을 단축으로 사용합니다. 이 구성 요소를 사용하면 프로듀서 및 소비자에게 합리적인 기본 구성을 적용합니다.

producerConfig

변경 사항을 브로드캐스트하는 Kafka 생산자가 사용할 속성을 설정합니다. bootstrapServers 를 재정의하므로 Kafka bootstrap.servers 속성 자체를 정의해야 합니다.

consumerConfig

주제의 캐시를 채우는 Kafka 소비자가 사용할 속성을 설정합니다. bootstrapServers 를 재정의하므로 Kafka bootstrap.servers 속성 자체를 정의해야 합니다.

maxCacheSize

가장 최근에 사용된 키의 메모리(기본값 1000)는 몇 개입니까.

pollDurationMs

Kafka 소비자의 폴링 기간입니다. 로컬 캐시가 즉시 업데이트됩니다. 이 값은 캐시를 업데이트하는 다른 피어 뒤에서 캐시가 캐시 작업 메시지를 보낸 idempotent Consumer 인스턴스와 얼마나 멀리 떨어져 있는지에 영향을 미칩니다. 기본값은 100ms입니다.
이 값을 명시적으로 설정하는 경우 원격 캐시 활성 상태와 이 리포지토리의 소비자와 Kafka 브로커 간의 네트워크 트래픽 볼륨 간에 절충이 있음을 유의하십시오. 캐시 워밍업 프로세스는 또한 아무 것도 가져오는 하나의 폴링이 있는지에 따라 달라집니다 - 이는 스트림이 현재 시점까지 소비되었음을 나타냅니다. 주제에서 메시지를 보내는 비율에 대해 폴링 기간이 과도하게 길면 캐시를 워밍할 수 없으며 추적할 때까지 해당 피어에 대해 일관되지 않은 상태에서 작동할 가능성이 있습니다.

주제bootstrapServers 를 정의하여 리포지토리를 인스턴스화하거나 producerConfigconsumerConfig 속성 세트를 명시적으로 정의하여 SSL/SASL과 같은 기능을 활성화할 수 있습니다. 사용하려면 CamelContext 를 인식하므로 이 리포지토리를 Spring/Blueprint에서 수동으로 또는 등록한 Camel 레지스트리에 배치해야 합니다.

샘플 사용법은 다음과 같습니다.

KafkaIdempotentRepository kafkaIdempotentRepository = new KafkaIdempotentRepository("idempotent-db-inserts", "localhost:9091");

SimpleRegistry registry = new SimpleRegistry();
registry.put("insertDbIdemRepo", kafkaIdempotentRepository); // must be registered in the registry, to enable access to the CamelContext
CamelContext context = new CamelContext(registry);

// later in RouteBuilder...
from("direct:performInsert")
    .idempotentConsumer(header("id")).messageIdRepositoryRef("insertDbIdemRepo")
        // once-only insert into database
    .end()

XML에서:

<!-- simple -->
<bean id="insertDbIdemRepo"
  class="org.apache.camel.processor.idempotent.kafka.KafkaIdempotentRepository">
  <property name="topic" value="idempotent-db-inserts"/>
  <property name="bootstrapServers" value="localhost:9091"/>
</bean>

<!-- complex -->
<bean id="insertDbIdemRepo"
  class="org.apache.camel.processor.idempotent.kafka.KafkaIdempotentRepository">
  <property name="topic" value="idempotent-db-inserts"/>
  <property name="maxCacheSize" value="10000"/>
  <property name="consumerConfig">
    <props>
      <prop key="bootstrap.servers">localhost:9091</prop>
    </props>
  </property>
  <property name="producerConfig">
    <props>
      <prop key="bootstrap.servers">localhost:9091</prop>
    </props>
  </property>
</bean>

숫자 식별자와 함께 idempotency를 사용할 때 선택할 수 있는 대안은 세 가지가 있습니다. 첫 번째는 org.apache.camel.component.kafka.serde.KafkaSer dedeer의 정적 메서드 numericHeader 메서드를 사용하여 변환을 수행하는 것입니다.

from("direct:performInsert")
    .idempotentConsumer(numericHeader("id")).messageIdRepositoryRef("insertDbIdemRepo")
        // once-only insert into database
    .end()

또는 경로 URL을 통해 구성된 사용자 정의 serializer를 사용하여 변환을 수행할 수 있습니다.

public class CustomHeaderDeserializer extends DefaultKafkaHeaderDeserializer {
    private static final Logger LOG = LoggerFactory.getLogger(CustomHeaderDeserializer.class);

    @Override
    public Object deserialize(String key, byte[] value) {
        if (key.equals("id")) {
            BigInteger bi = new BigInteger(value);

            return String.valueOf(bi.longValue());
        } else {
            return super.deserialize(key, value);
        }
    }
}

프로세서에서 수행할 수도 있습니다.You can also do so in a processor:

from(from).routeId("foo")
    .process(exchange -> {
        byte[] id = exchange.getIn().getHeader("id", byte[].class);

        BigInteger bi = new BigInteger(id);
        exchange.getIn().setHeader("id", String.valueOf(bi.longValue()));
    })
    .idempotentConsumer(header("id"))
    .messageIdRepositoryRef("kafkaIdempotentRepository")
    .to(to);

27.10. Kafka 소비자에서 수동 커밋 사용

기본적으로 Kafka 소비자는 지정된 간격을 사용하여 백그라운드에서 오프셋이 자동으로 커밋됩니다.

수동 커밋을 강제 적용하려면 메시지 헤더에 저장된 Camel 교환에서 KafkaManualCommit API를 사용할 수 있습니다. 이렇게 하려면 KafkaComponent 또는 끝점에서 allowManualCommit 옵션을 true 로 설정하거나 끝점에서 수동 커밋을 설정해야 합니다. 예를 들면 다음과 같습니다.

KafkaComponent kafka = new KafkaComponent();
kafka.setAllowManualCommit(true);
...
camelContext.addComponent("kafka", kafka);

그런 다음 Camel Processor 와 같은 Java 코드의 KafkaManualCommit 을 사용할 수 있습니다.

public void process(Exchange exchange) {
    KafkaManualCommit manual =
        exchange.getIn().getHeader(KafkaConstants.MANUAL_COMMIT, KafkaManualCommit.class);
    manual.commit();
}

이렇게 하면 Kafka에서 커밋이 승인되거나 예외가 발생할 때까지 차단되는 동기 커밋이 강제 적용됩니다. 'DefaultKafkaManualAsyncCommitFactory' 구현으로 KafkaManualCommitFactory 를 구성하여 비동기 커밋을 사용할 수 있습니다.

그러면 kafka 비동기 커밋 API를 사용하여 다음 소비자 루프에서 커밋이 수행됩니다. 파티션의 레코드를 처리하여 고유한 스레드에 의해 커밋해야 합니다. 그렇지 않으면 일관성 없는 동작이 발생할 수 있습니다. 이는 집계의 완료 시간 초과 전략에 주로 유용합니다.

KafkaManualCommit 의 사용자 지정 구현을 사용하려면 사용자 지정 구현의 인스턴스를 생성하는 KafkaComponent 에 사용자 지정 KafkaManualCommitFactory 를 구성할 수 있습니다.

27.11. Kafka 헤더 전파

Kafka에서 메시지를 사용하면 헤더가 camel 교환 헤더로 자동으로 전파됩니다. 동일한 동작으로 지원되는 흐름 생성 - 특정 교환의 camel 헤더는 kafka 메시지 헤더로 전파됩니다.

kafka 헤더는 byte[] 값만 허용하므로 order camel exchange header는 해당 값을 bytes[] 로 직렬화해야 하며 그렇지 않으면 헤더를 건너뜁니다. 다음 헤더 값 유형이 지원됩니다. 문자열,Integer,Long,double,Boolean,byte[]. 참고: kafka 에서 camel exchange 전파되는 모든 헤더에는 기본적으로 byte[] 값이 포함됩니다. 기본 기능 uri 매개변수를 설정하려면 route 및 headerSerializer 에서 route에 대한 headerDeserializer 를 설정할 수 있습니다. 예제:

from("kafka:my_topic?headerDeserializer=#myDeserializer")
...
.to("kafka:my_topic?headerSerializer=#mySerializer")

기본적으로 모든 헤더는 KafkaHeaderFilterStrategy 에 의해 필터링됩니다. 전략은 Camel 또는 org.apache.camel 접두사로 시작하는 헤더를 필터링합니다. 기본 전략은 경로 간 headerFilterStrategy uri 매개변수를 사용하여 재정의 수 있습니다.

from("kafka:my_topic?headerFilterStrategy=#myStrategy")
...
.to("kafka:my_topic?headerFilterStrategy=#myStrategy")

myStrategy 오브젝트는 HeaderFilterStrategy 의 하위 클래스여야 하며 Camel 레지스트리(Maining/Blueprint)에서 Camel 레지스트리를 사용하여 CamelContext 에 배치해야 합니다.

27.12. Spring Boot Auto-Configuration

Spring Boot와 함께 kafka를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-kafka-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.kafka.additional-properties

kafka consumer 또는 kafka 생산자에 대한 추가 속성을 설정하며 camel 구성에서 직접 설정할 수 없는 경우 속성(예: Camel 구성에 아직 반영되지 않은 새 Kafka 속성)을 접두사로 추가해야 합니다. 예: 추가Properties.knativeal.id=12345&additionalProperties.schema.registry.url=http://localhost:8811/avro.

 

map

camel.component.kafka.allow-manual-commit

KafkaManualCommit을 통한 수동 커밋 허용 여부입니다. 이 옵션을 활성화하면 KafkaManualCommit 인스턴스가 Exchange 메시지 헤더에 저장되어 최종 사용자가 이 API에 액세스하고 Kafka 소비자를 통해 수동 오프셋 커밋을 수행할 수 있습니다.

false

부울

camel.component.kafka.auto-commit-enable

true인 경우 사용자가 이미 가져온 메시지 오프셋을 ZooKeeper에 주기적으로 커밋합니다. 이 커밋된 오프셋은 프로세스가 새 소비자가 시작되는 위치로 실패할 때 사용됩니다.

true

부울

camel.component.kafka.auto-commit-interval-ms

소비자 오프셋이 zookeeper에 커밋되는 ms의 빈도입니다.

5000

정수

camel.component.kafka.auto-commit-on-stop

소비자가 중지되어 브로커가 마지막으로 사용된 메시지에서 커밋이 있는지 확인할 때 명시적 자동 커밋을 수행할지 여부입니다. 이를 위해서는 autoCommitEnable 옵션이 설정되어 있어야 합니다. 가능한 값은 sync, async 또는 none입니다. 및 sync 값이 기본값입니다.

동기화

문자열

camel.component.kafka.auto-offset-reset

ZooKeeper에 초기 오프셋이 없거나 오프셋이 범위를 벗어나면해야 할 일 : 가장 빠른 오프셋의 마지막으로 오프셋을 자동으로 재설정하십시오. 최신 오프셋으로 오프셋을 자동으로 재설정하십시오: 소비자에 예외가 발생합니다.

최신 정보

문자열

camel.component.kafka.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.kafka.break-on-first-error

이 옵션은 소비자가 교환을 처리하고 실패할 때 발생하는 상황을 제어합니다. 옵션이 false인 경우 소비자는 다음 메시지를 계속하고 처리합니다. 옵션이 true인 경우 소비자는 오류가 발생한 메시지의 오프셋을 다시 찾은 다음 이 메시지를 처리하기 위해 다시 시도합니다. 그러나 이로 인해 동일한 메시지가 무한한 처리로 이어질 수 있습니다. 그 바인딩이 실패할 때마다 실패할 수 있습니다. 따라서 Camel의 오류 처리기를 사용하여 이러한 문제를 처리하는 것이 좋습니다.

false

부울

camel.component.kafka.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.kafka.brokers

사용할 Kafka 브로커의 URL입니다. 형식은 host1:port1,host2:port2이며 목록은 브로커의 하위 집합 또는 브로커의 하위 집합을 가리키는 VIP의 하위 집합일 수 있습니다. 이 옵션은 Kafka 설명서에서 bootstrap.servers라고 합니다.

 

문자열

camel.component.kafka.buffer-memory-size

생산자가 서버로 전송되는 대기 중인 레코드를 버퍼링하는 데 사용할 수 있는 총 메모리 바이트입니다. 생산자가 block.on.buffer.full에서 지정한 기본 설정에 따라 서버에 레코드를 더 빠르게 전송하면 생산자가 사용하는 모든 메모리가 버퍼링에 사용되는 것은 아니지만 모든 메모리가 버퍼링에 사용되는 것은 아니기 때문에 프로듀서가 사용하는 기본 설정에 따라 예외를 차단하거나 throw합니다. 이 설정은 프로듀서에서 사용하는 모든 메모리가 버퍼링에 사용되는 것은 아니므로 하드 바인딩은 아닙니다. 일부 추가 메모리는 압축( 압축이 활성화된 경우)과 진행 중인 요청을 유지 관리하는 데 사용됩니다.

33554432

정수

camel.component.kafka.check-crcs

사용된 레코드의 CRC32를 자동으로 확인합니다. 이렇게 하면 메시지의 온-the-wire 또는 온-디스크 손상이 발생하지 않습니다. 이 검사에는 오버헤드가 추가되므로 과도한 성능을 원하는 경우 비활성화될 수 있습니다.

true

부울

camel.component.kafka.client-id

클라이언트 ID는 호출 추적을 돕기 위해 각 요청에 전송된 사용자 지정 문자열입니다. 요청을 수행하는 애플리케이션을 논리적으로 식별해야 합니다.

 

문자열

camel.component.kafka.commit-timeout-ms

코드에서 동기 커밋이 완료될 때까지 대기하는 최대 시간(밀리초)입니다. 옵션은 java.lang.Long 유형입니다.

5000

long

camel.component.kafka.compression-codec

이 매개변수를 사용하면 이 프로듀서에서 생성한 모든 데이터에 대해 압축 코드c를 지정할 수 있습니다. 유효한 값은 none, gzip 및 snappy입니다.

none

문자열

camel.component.kafka.configuration

엔드포인트에서 재사용할 공통 옵션을 사용하여 Kafka 구성 요소를 사전 설정할 수 있습니다. 옵션은 org.apache.camel.component.kafka.KafkaConfiguration 유형입니다.

 

KafkaConfiguration

camel.component.kafka.connection-max-idle-ms

이 구성에서 지정한 시간(밀리초) 후 유휴 연결을 종료합니다.

540000

정수

camel.component.kafka.consumer-request-timeout-ms

구성은 클라이언트가 요청 응답을 기다리는 최대 시간을 제어합니다. 시간 초과가 경과하기 전에 응답이 수신되지 않으면 필요한 경우 클라이언트가 요청을 다시 전송하거나 재시도가 고갈되면 요청이 실패합니다.

40000

정수

camel.component.kafka.consumers-count

kafka 서버에 연결하는 소비자 수입니다. 각 소비자는 들어오는 데이터를 검색하고 처리하는 별도의 스레드에서 실행됩니다.

1

정수

camel.component.kafka.delivery-timeout-ms

send() 호출을 반환한 후 성공 또는 실패를 보고하는 시간에 상한입니다. 이렇게 하면 레코드가 전송 전에 지연되는 총 시간, 브로커의 승인 대기 시간(필요한 경우) 및 재시도 가능한 전송 실패에 허용되는 시간이 제한됩니다.

120000

정수

camel.component.kafka.enable-idempotence

'true'로 설정하면 생산자가 스트림에 각 메시지의 사본을 정확히 1개씩 작성합니다. 'false'인 경우 생산자는 스트림에 재시도된 메시지의 중복을 작성할 수 있습니다. true로 설정하면 max.in.flight.requests.per.connection을 1로 설정하고 재시도할 수 없으며 추가 acks를 'all'로 설정해야 합니다.

false

부울

camel.component.kafka.enabled

kafka 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.kafka.fetch-max-bytes

서버에서 가져오기 요청에 대해 반환해야 하는 최대 데이터 양 This is not an absolute maximum, if the first message in the first message in the first message in the first message in the fetch is larger than this value, 메시지를 계속 반환하여 소비자가 진행할 수 있도록 합니다. 브로커가 승인한 최대 메시지 크기는 message.max.bytes(broker config) 또는 max.message.bytes(topic config)를 통해 정의됩니다. 소비자는 여러 가져오기를 병렬로 수행합니다.

52428800

정수

camel.component.kafka.fetch-min-bytes

가져오기 요청에 대해 서버가 반환해야 하는 최소 데이터 양입니다. 데이터가 충분하지 않으면 요청은 요청에 응답하기 전에 많은 데이터가 누적될 때까지 기다립니다.

1

정수

camel.component.kafka.fetch-wait-max-ms

fetch.min.bytes를 즉시 충족하기에 충분하지 않은 경우 가져오기 요청에 응답하기 전에 서버가 차단하는 최대 시간입니다.

500

정수

camel.component.kafka.group-id

이 소비자가 속하는 소비자 프로세스 그룹을 고유하게 식별하는 문자열입니다. 동일한 그룹 ID를 여러 프로세스를 설정하면 해당 프로세스가 모두 동일한 소비자 그룹의 일부임을 나타냅니다. 이 옵션은 고객에게 필요합니다.

 

문자열

camel.component.kafka.group-instance-id

최종 사용자가 제공하는 소비자 인스턴스의 고유 식별자입니다. 비어 있지 않은 문자열만 허용됩니다. 설정된 경우 소비자는 정적 멤버로 처리되므로 이 ID가 있는 하나의 인스턴스만 언제든지 소비자 그룹에 허용됩니다. 이는 일시적인 비가용성으로 인한 그룹 재조정(예: 프로세스 재시작)으로 인한 그룹 재조정을 방지하기 위해 더 큰 세션 시간 제한과 함께 사용할 수 있습니다. 설정하지 않으면 소비자는 기존 동작인 동적 멤버로 그룹을 조인합니다.

 

문자열

camel.component.kafka.header-deserializer

사용자 지정 KafkaHeaderDeserializer를 사용하여 kafka 헤더 값을 역직렬화합니다. 옵션은 org.apache.camel.component.kafka.serde.KafkaHeaderDeserializer 유형입니다.

 

KafkaHeaderDeserializer

camel.component.kafka.header-filter-strategy

사용자 정의 HeaderFilterStrategy를 사용하여 Camel 메시지 간 헤더를 필터링하려면 다음을 수행합니다. 옵션은 org.apache.camel.spi.HeaderFilterStrategy 유형입니다.

 

HeaderFilterStrategy

camel.component.kafka.header-serializer

사용자 지정 KafkaHeaderSerializer를 사용하여 kafka 헤더 값을 직렬화합니다. 옵션은 org.apache.camel.component.kafka.serde.KafkaHeaderSerializer 유형입니다.

 

KafkaHeaderSerializer

camel.component.kafka.heartbeat-interval-ms

Kafka의 그룹 관리 기능을 사용할 때 소비자 조정자에게 하트비트 간 예상 시간입니다. 하트비트는 소비자의 세션이 활성 상태로 유지되고 새 소비자가 그룹을 참여하거나 나가면 재조정을 용이하게 하는 데 사용됩니다. 값은 session.timeout.ms보다 작아야 하지만 일반적으로 해당 값의 1/3을 넘지 않아야 합니다. 일반 리밸런스에 대해 예상 시간을 제어하도록 더욱 낮게 조정할 수 있습니다.

3000

정수

camel.component.kafka.interceptor-classes

생산자 또는 소비자에 대한 인터셉터를 설정합니다. 생산자 인터셉터는 org.apache.kafka.clients.producer.ProducerInterceptor 인터셉터를 구현하는 클래스여야 합니다. ConsumerInterceptor 인터셉터는 org.apache.kafka.clients.consumer.ConsumerInterceptor를 구현하는 클래스여야 합니다. 소비자에 Producer 인터셉터를 사용하는 경우 런타임에 클래스 캐스트를 발생시킵니다.

 

문자열

camel.component.kafka.kafka-client-factory

org.apache.kafka.clients.consumer.KafkaConsumer 및 org.apache.kafka.clients.producer.KafkaProducer 인스턴스를 생성하는 데 사용할 팩토리입니다. 이를 통해 vanill Kafka 클라이언트를 확장하는 논리를 사용하여 인스턴스를 생성하도록 사용자 지정 팩토리를 구성할 수 있습니다. 옵션은 org.apache.camel.component.kafka.KafkaClientFactory 유형입니다.

 

KafkaClientFactory

camel.component.kafka.kafka-manual-commit-factory

KafkaManualCommit 인스턴스를 생성하는 데 사용할 팩토리입니다. 이를 통해 사용자 지정 팩토리를 플러그인하여 사용자 지정 KafkaManualCommit 인스턴스를 생성할 수 있습니다. 이 경우 박스에서 제공되는 기본 구현에서 벗어난 수동 커밋을 수행할 때 특수 논리가 필요합니다. 옵션은 org.apache.camel.component.kafka.KafkaManualCommitFactory 유형입니다.

 

KafkaManualCommitFactory

camel.component.kafka.kerberos-before-relogin-min-time

새로 고침 시도 사이에 로그인 스레드 절전 시간.

60000

정수

camel.component.kafka.kerberos-init-cmd

Kerberos kinit 명령 경로입니다. 기본값은 /usr/bin/kinit입니다.

/usr/bin/kinit

문자열

camel.component.kafka.kerberos-principal-to-local-rules

보안 주체 이름에서 짧은 이름(일반적으로 운영 체제 사용자 이름)으로 매핑하는 규칙 목록입니다. 규칙은 순서대로 평가되고 주체 이름과 일치하는 첫 번째 규칙은 짧은 이름에 매핑하는 데 사용됩니다. 목록의 이후 규칙은 무시됩니다. 기본적으로 {username}/{hostname}{REALM} 형식의 주체 이름은 {username}에 매핑됩니다. 형식에 대한 자세한 내용은 보안 권한 및 acls 문서를 참조하십시오. 여러 값을 쉼표로 구분할 수 있습니다.

DEFAULT

문자열

camel.component.kafka.kerberos-renew-jitter

임의의 지터의 백분율이 갱신 시간에 추가되었습니다.

 

double

camel.component.kafka.kerberos-renew-window-factor

로그인 스레드는 마지막 새로 고침에서 티켓 만료까지 지정된 창 요인에 도달할 때까지 유휴 상태가 됩니다. 이 때 티켓을 갱신하려고 합니다.

 

double

camel.component.kafka.key

레코드 키(키가 지정되지 않은 경우 null)입니다. 이 옵션이 구성된 경우 헤더 KafkaConstants#KEY보다 우선합니다.

 

문자열

camel.component.kafka.key-deserializer

Deserializer 인터페이스를 구현하는 키에 대한 Deserializer 클래스입니다.

org.apache.kafka.common.serialization.StringDeserializer

문자열

camel.component.kafka.key-serializer

키의 serializer 클래스(제공되지 않은 경우 메시지의 기본값과 동일).

org.apache.kafka.common.serialization.StringSerializer

문자열

camel.component.kafka.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.kafka.linger-ms

생산자는 단일 배치된 요청으로의 요청 전송 사이에 들어오는 모든 레코드를 그룹화합니다. 일반적으로 이는 전송 가능한 것보다 레코드가 더 빨리 도달할 때 로드 중에만 발생합니다. 그러나 경우에 따라 클라이언트는 중간 수준의 부하에서도 요청 수를 줄일 수 있습니다. 이 설정은 약간의 인공 지연을 추가하여 즉, 생산자가 즉시 레코드를 보내는 대신 지정된 지연까지 대기하여 전송이 함께 배치될 수 있도록 다른 레코드를 보낼 수 있도록 합니다. 이는 TCP의 Nagle 알고리즘과 유사합니다. 이 설정은 일괄 처리 지연에 대한 상한을 제공합니다. 이 설정에 관계없이 파티션의 batch.size 가치가 있는 경우 즉시 전송되지만 이 파티션에 누적된 바이트 수보다 적으면 더 많은 레코드가 표시되도록 지정된 시간에 대해 '어링er'합니다. 이 설정 기본값은 0입니다(예: no delay). 예를 들어 linger.ms=5를 설정하면 전송된 요청 수를 줄이는 효과가 있지만 로드 중에 전송된 레코드에 최대 5ms의 대기 시간을 더할 수 있습니다.

0

정수

camel.component.kafka.max-block-ms

구성에서는 kafka로 보내는 기간을 제어합니다. 이러한 방법은 여러 가지 이유로 차단될 수 있습니다. 예를 들어 버퍼 전체 메타데이터를 사용할 수 없습니다. 이 구성은 메타데이터 가져오기에 소비된 총 시간, 키 및 값의 직렬화, send()를 수행할 때 버퍼 메모리의 파티셔닝 및 할당에 최대 제한을 적용합니다. partitionsFor()의 경우 이 구성은 메타데이터 대기 시 최대 시간 임계값을 적용합니다.

60000

정수

camel.component.kafka.max-in-flight-request

인증되지 않은 최대 요청 수에 따라 클라이언트가 차단하기 전에 단일 연결을 통해 전송할 수 있습니다. 이 설정이 1보다 크고 전송에 실패한 경우 재시도로 인해 메시지 재순환 위험이 있습니다(예: 재시도가 활성화된 경우).

5

정수

camel.component.kafka.max-partition-fetch-bytes

서버가 반환할 파티션당 최대 데이터 양입니다. 요청에 사용된 최대 총 메모리는 #partitions max.partition.fetch.bytes입니다. 이 크기는 서버에서 허용하는 최대 메시지 크기 이상이어야 합니다. 그러지 않으면 생산자가 소비자가 가져올 수 있는 것보다 큰 메시지를 보낼 수 있습니다. 이러한 경우 소비자는 특정 파티션에서 큰 메시지를 가져오려고 할 수 있습니다.

1048576

정수

camel.component.kafka.max-poll-interval-ms

소비자 그룹 관리를 사용할 때 poll() 호출 간 최대 지연입니다. 이렇게 하면 더 많은 레코드를 가져오기 전에 소비자가 유휴 상태가 될 수 있는 시간에 바인딩된 상한이 배치됩니다. poll()가 이 시간 만료 전에 호출되지 않은 경우 소비자는 실패한 것으로 간주되고 그룹이 파티션을 다른 멤버에 다시 할당하기 위해 재조정됩니다. 옵션은 java.lang.Long 유형입니다.

 

long

camel.component.kafka.max-poll-records

poll()에 대한 단일 호출에서 반환된 최대 레코드 수입니다.

500

정수

camel.component.kafka.max-request-size

요청의 최대 크기입니다. 이는 또한 실질적으로 최대 레코드 크기에 대한 제한입니다. 서버에는 이와 다를 수 있는 레코드 크기에 대한 자체 제한이 있습니다. 이 설정은 생산자가 대규모 요청을 보내지 않도록 단일 요청으로 전송할 레코드 배치 수를 제한합니다.

1048576

정수

camel.component.kafka.metadata-max-age-ms

이 기간(밀리초) 후 새 브로커 또는 파티션을 사전에 검색하기 위해 파티션 리더십 변경을 보지 못하더라도 메타데이터를 강제로 새로 고침합니다.

300000

정수

camel.component.kafka.metric-reporters

메트릭 보고자로 사용할 클래스 목록입니다. MetricReporter 인터페이스를 구현하면 새 지표 생성에 대한 알림을 받을 클래스를 연결할 수 있습니다. JmxReporter는 항상 통계를 등록하기 위해 포함됩니다.

 

문자열

camel.component.kafka.metrics-sample-window-ms

메트릭으로 유지 관리되는 샘플 수입니다.

30000

정수

camel.component.kafka.no-of-metrics-sample

메트릭으로 유지 관리되는 샘플 수입니다.

2

정수

camel.component.kafka.offset-repository

주제의 각 파티션의 오프셋을 로컬로 저장하기 위해 사용할 오프셋 리포지토리입니다. 하나를 정의하면 자동 커밋이 비활성화됩니다. 옵션은 org.apache.camel.spi.StateRepository<java.lang.String, java.lang.String> 유형입니다.

 

StateRepository

camel.component.kafka.partition-assignor

클라이언트가 그룹 관리를 사용할 때 클라이언트가 파티션 소유권을 배포하는 데 사용할 파티션 할당 전략의 클래스 이름입니다.

org.apache.kafka.clients.consumer.RangeAssignor

문자열

camel.component.kafka.partition-key

레코드가 전송되는 파티션(또는 파티션이 지정되지 않은 경우 null)입니다. 이 옵션이 구성된 경우 헤더 KafkaConstants#PARTITION_KEY보다 우선합니다.

 

정수

camel.component.kafka.partitioner

하위 주제 간에 메시지를 분할하는 partitioner 클래스입니다. 기본 partitioner는 키의 해시를 기반으로 합니다.

org.apache.kafka.clients.producer.internals.DefaultPartitioner

문자열

camel.component.kafka.poll-exception-strategy

소비자와 사용자 정의 전략을 사용하여 메시지를 풀링하는 동안 Kafka 브로커에서 발생하는 예외를 처리하는 방법을 제어합니다. 옵션은 org.apache.camel.component.kafka.PollExceptionStrategy 유형입니다.

 

PollExceptionStrategy

camel.component.kafka.poll-on-error

kafka가 새 메시지를 폴링하는 동안 예외를 제한하면 어떻게 해야 합니까. 은 엔드포인트 수준에서 명시적 값을 구성하지 않는 한 기본적으로 구성 요소 구성의 값을 사용합니다. DISCARD는 메시지를 삭제하고 다음 메시지를 계속 폴링합니다. ERROR_HANDLER는 Camel의 오류 처리기를 사용하여 예외를 처리하고 나중에 다음 메시지를 계속 폴링합니다. RECONNECT는 소비자를 다시 연결하고 메시지를 다시 폴링하려고 시도하면 동일한 메시지를 다시 폴링하면 소비자 재시도에서 소비자를 다시 중지시킬 수 있습니다(고객이 메시지를 다시 사용할 수 있어야 하는 경우 수동으로 시작/다시 시작됨).

 

PollOnError

camel.component.kafka.poll-timeout-ms

KafkaConsumer를 폴링할 때 사용되는 제한 시간입니다. 옵션은 java.lang.Long 유형입니다.

5000

long

camel.component.kafka.producer-batch-size

생산자는 여러 레코드가 동일한 파티션에 전송될 때마다 레코드를 더 적은 수의 요청으로 함께 배치하려고 합니다. 이렇게 하면 클라이언트와 서버 모두에서 성능이 향상됩니다. 이 구성은 기본 배치 크기(바이트)를 제어합니다. 이 크기보다 큰 배치 레코드는 없습니다. 브로커에 전송된 요청에는 여러 일괄 처리가 포함됩니다. 하나는 전송 가능한 데이터가 있는 각 파티션에 대해 일괄 처리를 덜 일반화하고 처리량을 줄일 수 있습니다(0의 배치 크기는 완전히 비활성화됨). 배치 크기가 매우 큰 경우 추가 레코드를 예상할 때 항상 지정된 일괄 처리 크기의 버퍼를 할당하므로 메모리를 약간 더 불편하게 사용할 수 있습니다.

16384

정수

camel.component.kafka.queue-buffering-max-messages

생산자를 차단하거나 데이터를 삭제하기 전에 async 모드를 사용할 때 프로듀서에서 대기할 수 있는 최대 무의식 메시지 수입니다.

10000

정수

camel.component.kafka.receive-buffer-bytes

데이터를 읽을 때 사용할 TCP 수신 버퍼(SO_RCVBUF)의 크기입니다.

65536

정수

camel.component.kafka.reconnect-backoff-max-ms

브로커에 다시 연결할 때 대기하는 최대 시간(밀리초)입니다. 제공되는 경우 호스트당 백오프는 연속된 연결 실패마다 최대 최대 기하급수적으로 증가합니다. 백오프 증가를 계산한 후 연결 문제가 발생하지 않도록 20 % 임의 지터가 추가됩니다.

1000

정수

camel.component.kafka.reconnect-backoff-ms

지정된 호스트에 다시 연결하기 전에 대기하는 시간입니다. 이렇게 하면 엄격한 루프에서 호스트에 반복적으로 연결하는 것을 방지할 수 있습니다. 이 백오프는 소비자가 브로커로 보낸 모든 요청에 적용됩니다.

50

정수

camel.component.kafka.record-metadata

생산자가 Kafka로 전송한 RecordMetadata 결과를 저장해야 하는지 여부입니다. 결과는 RecordMetadata 메타데이터가 포함된 목록에 저장됩니다. 목록은 KafkaConstants#KAFKA_RECORDMETA 키가 있는 헤더에 저장됩니다.

true

부울

camel.component.kafka.request-required-acks

생산자가 승인한 승인의 수에 따라 요청이 완료된 것을 고려하기 전에 리더를 수령해야 합니다. 이렇게 하면 전송되는 레코드의 중요도가 제어됩니다. acks=0로 설정하면 생산자가 서버의 승인을 전혀 기다리지 않습니다. 레코드는 소켓 버퍼에 즉시 추가되고 전송된 것으로 간주합니다. 이 경우 서버가 레코드를 수신했음을 보장할 수 없으며 재시도 구성은 적용되지 않습니다(클라이언트는 일반적으로 오류를 알 수 없기 때문에). 각 레코드에 대해 주어진 오프셋은 항상 -1로 설정됩니다. acks=1 이는 리더가 해당 로컬 로그에 레코드를 작성하지만 모든 팔로워의 완전한 승인을 기다리지 않고 응답한다는 것을 의미합니다. 이 경우 레코드 확인 후 바로 리더가 실패하지만, 팔로워가 복제되기 전에 해당 레코드가 손실됩니다. acks=all이 발생하면 비동기(in-sync) 복제본의 전체 세트를 확인하여 레코드를 승인할 수 있습니다. 이렇게 하면 하나 이상의 동기화 복제본이 활성 상태로 유지되는 한 레코드가 손실되지 않습니다. 이는 사용 가능한 보증입니다.

1

문자열

camel.component.kafka.request-timeout-ms

브로커가 클라이언트에 오류를 보내기 전에 request.required.acks 요구 사항을 충족하기 위해 대기하는 시간입니다.

30000

정수

camel.component.kafka.resume-strategy

이 옵션을 사용하면 사용자 정의 재개 전략을 설정할 수 있습니다. resume 전략은 파티션이 할당될 때(예: 연결 또는 다시 연결할 때) 실행됩니다. 구현이 작업을 재개하는 방법을 사용자 지정하고 seekTo 및 offsetRepository 메커니즘에 대한 보다 유연한 대안으로 사용할 수 있습니다. 구현 세부 사항은 KafkaConsumerResumeStrategy를 참조하십시오. 이 옵션은 자동 커밋 설정에 영향을 미치지 않습니다. 이 설정을 사용하는 구현에서는 이와 함께 수동 커밋 옵션을 사용하여 평가할 수도 있습니다. 옵션은 org.apache.camel.component.kafka.consumer.support.KafkaConsumerResumeStrategy 유형입니다.

 

KafkaConsumerResumeStrategy

camel.component.kafka.retries

값을 0보다 크게 설정하면 클라이언트가 전송이 잠재적으로 일시적인 오류와 함께 실패하는 모든 레코드를 다시 보냅니다. 이 재시도는 클라이언트가 오류를 수신할 때 레코드를 재지정하는 경우와 다르지 않습니다. 재시도를 허용하면 두 개의 레코드가 단일 파티션에 전송되고 첫 번째 레코드가 실패하고 다시 시도되지만 두 번째 레코드가 먼저 표시될 수 있기 때문에 레코드 순서가 변경될 수 있습니다.

0

정수

camel.component.kafka.retry-backoff-ms

각 재시도 전에 생산자는 관련 주제의 메타데이터를 새로 고침하여 새 리더가 선택되었는지 확인합니다. 리더 선택에는 시간이 걸리므로 이 속성은 메타데이터를 새로 고치기 전에 프로듀서가 대기하는 시간을 지정합니다.

100

정수

camel.component.kafka.sasl-jaas-config

kafka sasl.jaas.config 매개변수 예제: org.apache.kafka.common.security.plain.PlainLoginModule 필수 username=USERNAME password=PASSWORD;를 노출합니다.

 

문자열

camel.component.kafka.sasl-kerberos-service-name

Kafka가 실행되는 Kerberos 사용자 이름입니다. Kafka의 10.0.0.1 구성 또는 Kafka 구성에서 정의할 수 있습니다.

 

문자열

camel.component.kafka.sasl-mechanism

SASL(Simple Authentication and Security Layer) 메커니즘이 사용되었습니다. 유효한 값은 의 내용을 참조하십시오.

GSSAPI

문자열

camel.component.kafka.schema-registry-u-r-l

사용할 Confluent Platform 스키마 레지스트리 서버의 URL입니다. 형식은 host1:port1,host2:port2입니다. 이를 Confluent Platform 문서에서 schema.registry.url이라고 합니다. 이 옵션은 Confluent Platform (표준 Apache Kafka)에서만 사용할 수 있습니다.

 

문자열

camel.component.kafka.security-protocol

브로커와 통신하는 데 사용되는 프로토콜입니다. SASL_PLAINTEXT, PLAINTEXT 및 SSL이 지원됩니다.

PLAINTEXT

문자열

camel.component.kafka.seek-to

KafkaConsumer가 시작시 시작 또는 종료 시부터 읽는 경우 설정 : 처음부터 읽기 : 마지막부터 읽기 This is replacing the earlier property seekToBeginning.

 

문자열

camel.component.kafka.send-buffer-bytes

소켓 쓰기 버퍼 크기.

131072

정수

camel.component.kafka.session-timeout-ms

Kafka의 그룹 관리 기능을 사용할 때 오류를 감지하는 데 사용되는 시간 초과입니다.

10000

정수

camel.component.kafka.shutdown-timeout

소비자 또는 생산자가 작업자 스레드를 종료하고 종료할 때까지 정상적으로 대기하는 시간(밀리초)입니다.

30000

정수

camel.component.kafka.specific-avro-reader

이를 통해 Confluent Platform 스키마 레지스트리 및 io.confluent.kafka.serializers.KafkaAvroDeserializer와 함께 사용할 수 있습니다. 이 옵션은 Confluent Platform (표준 Apache Kafka)에서만 사용할 수 있습니다.

false

부울

camel.component.kafka.ssl-cipher-suites

암호화 제품군 목록입니다. 이는 TLS 또는 SSL 네트워크 프로토콜을 사용하여 네트워크 연결의 보안 설정을 협상하는 데 사용되는 인증, 암호화, MAC 및 키 교환 알고리즘의 이름 지정 조합입니다. 기본적으로 사용 가능한 모든 암호화 제품군이 지원됩니다.

 

문자열

camel.component.kafka.ssl-context-parameters

Camel SSLContextParameters 오브젝트를 사용한 SSL 구성입니다. 구성된 경우 다른 SSL 끝점 매개변수보다 먼저 적용됩니다. 참고: Kafka는 파일 위치의 키 저장소 로드만 지원하므로 KeyStoreParameters.resource 옵션에서 file:의 위치를 접두사로 지정합니다. 옵션은 org.apache.camel.support.jsse.SSLContextParameters 유형입니다.

 

SSLContextParameters

camel.component.kafka.ssl-enabled-protocols

SSL 연결에 활성화된 프로토콜 목록입니다. TLSv1.2, TLSv1.1 및 TLSv1은 기본적으로 활성화되어 있습니다.

 

문자열

camel.component.kafka.ssl-endpoint-algorithm

서버 인증서를 사용하여 서버 호스트 이름을 검증하는 끝점 식별 알고리즘입니다.

https

문자열

camel.component.kafka.ssl-key-password

키 저장소 파일에 있는 개인 키의 암호입니다. 이는 클라이언트의 경우 선택 사항입니다.

 

문자열

camel.component.kafka.ssl-keymanager-algorithm

SSL 연결에 대해 키 관리자 팩토리에서 사용하는 알고리즘입니다. 기본값은 Java 가상 머신에 대해 구성된 키 관리자 팩토리 알고리즘입니다.

SunX509

문자열

camel.component.kafka.ssl-keystore-location

키 저장소 파일의 위치입니다. 이는 클라이언트의 경우 선택 사항이며 클라이언트의 양방향 인증에 사용할 수 있습니다.

 

문자열

camel.component.kafka.ssl-keystore-password

키 저장소 파일의 저장소 암호입니다. 클라이언트의 경우 선택 사항이며 ssl.keystore.location이 구성된 경우에만 필요합니다.

 

문자열

camel.component.kafka.ssl-keystore-type

키 저장소 파일의 파일 형식입니다. 이는 클라이언트의 경우 선택 사항입니다. 기본값은 JKS입니다.

JKS

문자열

camel.component.kafka.ssl-protocol

SSLContext를 생성하는 데 사용되는 SSL 프로토콜입니다. 기본 설정은 TLS이며 대부분의 경우 적합합니다. 최근 JVM에서 허용되는 값은 TLS, TLSv1.1 및 TLSv1.2입니다. SSL, SSLv2 및 SSLv3은 이전 JVM에서 지원될 수 있지만 알려진 보안 취약점으로 인해 해당 사용이 권장되지 않습니다.

 

문자열

camel.component.kafka.ssl-provider

SSL 연결에 사용되는 보안 공급자의 이름입니다. 기본값은 JVM의 기본 보안 공급자입니다.

 

문자열

camel.component.kafka.ssl-trustmanager-algorithm

신뢰 관리자 팩토리에서 SSL 연결에 사용하는 알고리즘입니다. 기본값은 Java 가상 머신에 대해 구성된 신뢰 관리자 팩토리 알고리즘입니다.

PKIX

문자열

camel.component.kafka.ssl-truststore-location

신뢰 저장소 파일의 위치입니다.

 

문자열

camel.component.kafka.ssl-truststore-password

신뢰 저장소 파일의 암호입니다.

 

문자열

camel.component.kafka.ssl-truststore-type

신뢰 저장소 파일의 파일 형식입니다. 기본값은 JKS입니다.

JKS

문자열

camel.component.kafka.synchronous

동기 처리를 엄격하게 사용해야 하는지 여부를 설정합니다.

false

부울

camel.component.kafka.topic-is-pattern

주제가 패턴(regular expression)인지 여부. 이를 사용하여 패턴과 일치하는 동적 주제 수를 서브스크립션할 수 있습니다.

false

부울

camel.component.kafka.use-global-ssl-context-parameters

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

부울

camel.component.kafka.value-deserializer

Deserializer 인터페이스를 구현하는 값에 대한 Deserializer 클래스입니다.

org.apache.kafka.common.serialization.StringDeserializer

문자열

camel.component.kafka.value-serializer

메시지에 대한 serializer 클래스입니다.

org.apache.kafka.common.serialization.StringSerializer

문자열

camel.component.kafka.worker-pool

kafka 서버 이후에 Exchange를 계속 라우팅하는 데 사용자 지정 작업자 풀을 사용하려면 비동기 비차단 처리를 사용하여 KafkaProducer에서 전송된 메시지를 인식합니다. 이 옵션을 사용하는 경우 더 이상 필요하지 않은 경우 풀을 종료하려면 스레드 풀의 라이프사이클을 처리해야 합니다. 옵션은 java.util.concurrent.ExecutorService 유형입니다.

 

ExecutorService

camel.component.kafka.worker-pool-core-size

kafka 서버 이후에 Exchange를 계속 라우팅하기 위한 작업자 풀의 코어 스레드 수는 비동기 비차단 처리를 사용하여 KafkaProducer에서 전송된 메시지를 인식합니다.

10

정수

camel.component.kafka.worker-pool-max-size

kafka 서버 후에 Exchange를 계속 라우팅하기 위한 작업자 풀의 최대 스레드 수는 비동기 비차단 처리를 사용하여 KafkaProducer에서 전송된 메시지를 승인합니다.

20

정수

28장. Kamelet

생산자 및 소비자 모두 지원

Kamelet 구성 요소는 엔드 포인트 의미 체계를 사용하여 Camel 경로 템플릿 엔진과 상호 작용을 지원합니다.

28.1. URI 형식

kamelet:templateId/routeId[?options]

28.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

28.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

28.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

28.3. 구성 요소 옵션

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

이름설명Default유형

위치 (공용)

파일 시스템의 Kamelets 위치. 여러 위치를 쉼표로 구분하여 설정할 수 있습니다.

classpath:/kamelets

문자열

routeProperties (공용)

경로 로컬 매개변수를 설정합니다.

 

map

templateProperties (공용)

템플릿 로컬 매개 변수를 설정합니다.

 

map

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

블록 (producer)

활성 소비자가 없는 kamelet 엔드포인트에 메시지를 보내는 경우 생산자에 차단하고 소비자가 활성화될 때까지 기다릴 수 있습니다.

true

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

시간 초과 (producer)

블록이 활성화된 경우 사용할 시간 초과 값입니다.

30000

long

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

routeTemplateLoaderListener (고급)

Autowired Kamelet 구성 요소가 외부 리소스에서 Kamelet을 로드할 때 사용자 지정 리스너를 플러그인합니다.

 

RouteTemplateLoaderListener

28.4. 끝점 옵션

Kamelet 끝점은 URI 구문을 사용하여 구성됩니다.

kamelet:templateId/routeId

다음과 같은 경로 및 쿼리 매개변수 사용:

28.4.1. 경로 매개변수(2 매개변수)

이름설명Default유형

templateId (공용)

경로 템플릿 ID가 필요합니다.

 

문자열

routeId (공용)

경로 ID입니다. 기본값 notice: 제공되지 않는 경우 ID가 자동으로 생성됩니다.

 

문자열

28.4.2. 쿼리 매개변수 (8 매개변수)

이름설명Default유형

위치 (공용)

파일 시스템, 클래스 경로 등의 리소스로 지정할 수 있는 Kamelet의 위치입니다. 위치는 와일드카드를 사용할 수 없으며 확장자를 포함한 파일을 참조해야 합니다(예: file:/etc/foo-kamelet.xml).

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

블록 (producer)

활성 소비자가 없는 직접 끝점으로 메시지를 보내는 경우 생산자에게 차단하고 소비자가 활성 상태가 될 때까지 기다릴 수 있습니다.

true

boolean

failIfNoConsumers (producer)

프로듀서가 활성 소비자 없이 kamelet 끝점으로 보낼 때 예외를 throw하여 실패해야 하는지 여부입니다.

true

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

시간 초과 (producer)

블록이 활성화된 경우 사용할 시간 초과 값입니다.

30000

long

참고

kamelet 끝점은 lenient 입니다. 즉, 끝점이 엔진에 전달되고 경로 구체화 시 사용되는 추가 매개변수를 허용합니다.

28.5. 검색

경로 템플릿을 찾을 수 없는 경우 kamelet 엔드포인트는 파일 시스템에서 관련 kamelet 정의를 로드합니다(기본값 :/kamelets). 기본 해결 메커니즘에서는 kamelet 파일에 .kamelet.yaml 확장자가 있을 것으로 예상합니다.

28.6. 샘플

Kamelets는 표준 Camel 구성 요소인 것처럼 사용할 수 있습니다. 예를 들어 다음과 같이 경로 템플릿을 생성했다고 가정합니다.

routeTemplate("setMyBody")
    .templateParameter("bodyValue")
    .from("kamelet:source")
        .setBody().constant("{{bodyValue}}");
참고

Kamelet 구성 요소가 호출 프로세서에 구체화된 경로를 연결하도록 하려면 경로의 입력 및 출력 끝점을 식별할 수 있어야 하며 kamele:source 를 사용하여 출력 끝점에 kamelet:sink 를 사용하여 수행합니다.

그런 다음 템플릿을 인스턴스화하고 다음과 같이 호출할 수 있습니다.

from("direct:setMyBody")
    .to("kamelet:setMyBody?bodyValue=myKamelet");

백그라운드에서 Kamelet 구성 요소는 다음과 같은 작업을 수행합니다.

  1. 지정된 templateId 경로 매개변수로 식별되는 경로 템플릿에서 경로를 인스턴스화합니다(이 경우 setBody).
  2. 직접 구성 요소처럼 작동하고 현재 경로를 구체화된 경로에 연결합니다.

프로그래밍 방식으로 수행해야 하는 경우 다음과 같은 작업이 될 것입니다.

routeTemplate("setMyBody")
    .templateParameter("bodyValue")
    .from("direct:{{foo}}")
        .setBody().constant("{{bodyValue}}");

TemplatedRouteBuilder.builder(context, "setMyBody")
    .parameter("foo", "bar")
    .parameter("bodyValue", "myKamelet")
    .add();

from("direct:template")
    .to("direct:bar");

28.7. Spring Boot Auto-Configuration

Spring Boot와 함께 kamelet을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-kamelet-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.kamelet.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.kamelet.block

활성 소비자가 없는 kamelet 엔드포인트에 메시지를 보내는 경우 생산자에 차단하고 소비자가 활성화될 때까지 기다릴 수 있습니다.

true

부울

camel.component.kamelet.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.kamelet.enabled

kamelet 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.kamelet.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.kamelet.location

파일 시스템의 Kamelets 위치. 여러 위치를 쉼표로 구분하여 설정할 수 있습니다.

classpath:/kamelets

문자열

camel.component.kamelet.route-properties

경로 로컬 매개변수를 설정합니다.

 

map

camel.component.kamelet.route-template-loader-listener

Kamelet 구성 요소가 외부 리소스에서 Kamelets를 로드할 때 사용자 정의 리스너를 플러그인합니다. 옵션은 org.apache.camel.spi.RouteTemplateLoaderListener 유형입니다.

 

RouteTemplateLoaderListener

camel.component.kamelet.template-properties

템플릿 로컬 매개 변수를 설정합니다.

 

map

camel.component.kamelet.timeout

블록이 활성화된 경우 사용할 시간 초과 값입니다.

30000

long

29장. 언어

프로듀서만 지원됩니다.

Language 구성 요소를 사용하면 Camel에서 지원되는 언어로 스크립트를 실행하는 엔드포인트로 교환을 보낼 수 있습니다. 언어 스크립트를 실행하는 구성 요소가 있으면 더 동적 라우팅 기능을 사용할 수 있습니다. 예를 들어 Routing Slip 또는 Dynamic Router EIP를 사용하면 스크립트가 동적인 언어 끝점에 메시지를 보낼 수 있습니다.

이 구성 요소는 camel-core로 제공되는 구성 요소이므로 추가 JAR이 필요하지 않습니다. Groovy 또는 JavaScript 언어 사용과 같이 선택한 언어로 필요한 경우에만 Camel 구성 요소를 추가해야 합니다.

29.1. URI 형식

language://languageName[:script][?options]

Camel의 다른 언어에서 지원하는 것과 동일한 표기법을 사용하여 스크립트의 외부 리소스를 참조할 수 있습니다.

language://languageName:resource:scheme:location][?options]

29.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

29.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

29.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

29.3. 구성 요소 옵션

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

이름설명Default유형

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

29.4. 끝점 옵션

Language 엔드포인트는 URI 구문을 사용하여 구성됩니다.

language:languageName:resourceUri

다음과 같은 경로 및 쿼리 매개변수 사용:

29.4.1. 경로 매개변수(2 매개변수)

이름설명Default유형

languageName (producer)

사용할 언어의 이름을 설정합니다.

CloudEvent 값:

  • console
  • 상수
  • exchangeProperty
  • file
  • Groovy
  • header
  • javascript
  • jsonpath
  • MVEL
  • ognl
  • Ref
  • simple
  • SPEL
  • sql
  • terterer
  • tokenize
  • CloudEvent
  • xquery
  • xtokenize
 

문자열

resourceUri (producer)

리소스의 경로 또는 레지스트리로 빈을 조회하는 참조로, 리소스로 사용할 수 있습니다.

 

문자열

29.4.2. 쿼리 매개변수 (7 매개변수)

이름설명Default유형

allowContextMapAll (producer)

컨텍스트 맵에서 모든 세부 정보에 대한 액세스를 허용할지 여부를 설정합니다. 기본적으로 메시지 본문과 헤더만 액세스할 수 있습니다. 이 옵션은 현재 Exchange 및 CamelContext에 대한 전체 액세스에 대해 활성화할 수 있습니다. 이렇게 하면 CamelContext API의 모든 기능에 액세스할 수 있으므로 잠재적인 보안 위험이 적용됩니다.

false

boolean

바이너리 (producer)

스크립트가 바이너리 콘텐츠인지 또는 텍스트 콘텐츠인지 여부. 기본적으로 스크립트는 텍스트 콘텐츠(예: java.lang.String)로 읽습니다.

false

boolean

cacheScript (producer)

컴파일된 스크립트를 캐시하고 스크립트를 다시 사용할지 여부는 하나의 Camel org.apache.camel.Exchange를 처리하여 다음 org.apache.camel.Exchange로 부작용이 발생할 수 있습니다.

false

boolean

contentCache (producer)

리소스 콘텐츠 캐시 사용 여부를 설정합니다.

true

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

스크립트 (producer)

실행할 스크립트를 설정합니다.

 

문자열

변환 (producer)

스크립트의 결과를 메시지 본문으로 사용해야 하는지 여부입니다. 이 옵션은 기본값 true입니다.

true

boolean

29.5. 메시지 헤더

다음 메시지 헤더를 사용하여 구성 요소의 동작에 영향을 미칠 수 있습니다.

header설명

CamelLanguageScript

헤더에 제공된 실행 스크립트입니다. 끝점에 구성된 스크립트보다 우선합니다.

29.6. 예

예를 들어 메시지 메시지로 간단한 언어를 사용할 수 있습니다.

아래와 같이 스크립트를 헤더로 제공할 수도 있습니다. 여기서 <foo> 태그에서 텍스트를 추출하려면 here we use theECDHE language to extract the text from the <foo> tag.

Object out = producer.requestBodyAndHeader("language:xpath", "<foo>Hello World</foo>", Exchange.LANGUAGE_SCRIPT, "/foo/text()");
assertEquals("Hello World", out);

29.7. 리소스에서 스크립트 로드

끝점 uri 또는 Exchange.LANGUAGE_SCRIPT 헤더에 로드할 스크립트를 지정할 수 있습니다.You can specify a resource uri for a script to load in either the endpoint uri, or in the Exchange.LANGUAGE_SCRIPT header. uri는 file:, classpath: 또는 http의 구성 요소 중 하나로 시작해야 합니다.

기본적으로 스크립트는 한 번 로드되고 캐시됩니다. 그러나 contentCache 옵션을 비활성화하고 각 평가에 스크립트를 로드할 수 있습니다. 예를 들어 myscript.txt 파일이 디스크에서 변경되면 업데이트된 스크립트가 사용됩니다.

아래와 같이 "resource:"를 접두사로 지정하여 Camel의 다른 언어와 유사한 리소스를 참조할 수 있습니다.

29.8. Spring Boot Auto-Configuration

Spring Boot에서 언어를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-language-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.language.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.language.enabled

언어 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.language.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

30장. log

프로듀서만 지원됩니다.

로그 구성 요소는 기본 로깅 메커니즘으로 메시지를 교환합니다.

Camel은 gRPCF4J 를 사용하여 특히 다음을 통해 로깅을 구성할 수 있습니다.

  • Log4j
  • logback
  • Java Util Logging

30.1. URI 형식

log:loggingCategory[?options]

여기서 loggingCategory 는 사용할 로깅 카테고리의 이름입니다. 다음 형식의 URI에 쿼리 옵션을 추가할 수 있습니다.

?option=value&option=value&…​

참고

레지스트리
에서 Logger 인스턴스를 사용하는
경우, 레지스트리에 org.slf4j.Logger 의 단일 인스턴스가 있는 경우 loggingCategory 가 더 이상 로거 인스턴스를 생성하는 데 사용되지 않습니다. 등록된 인스턴스가 대신 사용됩니다. 또한 ?logger=#my Logger URI 매개변수를 사용하여 특정 Logger 인스턴스를 참조할 수 있습니다. 결국 등록된 및 URI 로거 매개변수가 없으면 로거 인스턴스는 loggingCategory 를 사용하여 생성됩니다.

예를 들어 로그 끝점은 일반적으로 다음과 같이 level 옵션을 사용하여 로깅 수준을 지정합니다.

log:org.apache.camel.example?level=DEBUG

기본 로거는 모든 교환(일반 로깅)을 기록합니다. 하지만 Camel은 또한 group Size 옵션이 지정될 때마다 사용되는 처리량 측정 로거와 함께 제공됩니다.

참고

또한 DSL에 로그인
DSL
에 직접 로그 도 있지만 다른 용도가 있습니다. 이는 경량 및 사람 로그를 위한 것입니다. LogEIP에서 자세한 내용을 참조하십시오.

30.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

30.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

30.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

30.3. 구성 요소 옵션

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

이름설명Default유형

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

exchangeFormatter (advanced)

자동 연결 ( Autowired ) Sets a custom ExchangeFormatter to convert the Exchange to a String suitable for logging. 지정하지 않으면 DefaultExchangeFormatter로 기본 설정됩니다.

 

ExchangeFormatter

30.4. 끝점 옵션

로그 끝점은 URI 구문을 사용하여 구성됩니다.

log:loggerName

다음과 같은 경로 및 쿼리 매개변수 사용:

30.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

loggerName (producer)

사용할 로깅 카테고리의 이름입니다.

 

문자열

30.4.2. 쿼리 매개변수(27 매개변수)

이름설명Default유형

GroupActiveOnly (producer)

true인 경우, 은 메시지 트래픽에 관계없이 시간 간격 동안 새 메시지가 수신되면(false) 통계가 숨겨집니다.

true

부울

groupDelay (producer)

통계(밀리)에 대한 초기 지연을 설정합니다.

 

long

GroupInterval (producer)

지정된 경우 메시지 통계를 이 시간 간격(밀리에 있음)으로 그룹화합니다.

 

long

groupSize (producer)

처리량 로깅을 위한 그룹 크기를 지정하는 정수입니다.

 

정수

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

레벨 (producer)

사용할 로깅 수준입니다. 기본값은 INFO입니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

INFO

문자열

logMask (producer)

true인 경우 로그에 암호 또는 암호와 같은 민감한 정보를 마스크하십시오.

 

부울

마커 (producer)

사용할 선택적 마커 이름입니다.

 

문자열

exchangeFormatter (advanced)

사용자 지정 교환 포맷터를 사용하려면 다음을 수행합니다.

 

ExchangeFormatter

maxChars (formatting)

행당 기록된 문자 수를 제한합니다.

10000

int

멀티 라인 (formatting)

활성화하면 각 정보가 줄 바꿈으로 출력됩니다.

false

boolean

모두 표시 (포메팅)

모든 옵션을 켜기 위한 빠른 옵션. (multiline, maxChars must be manually set if to be used).

false

boolean

showAllProperties (포메팅)

모든 교환 속성(내부 및 사용자 지정)을 표시합니다.

false

boolean

showBody (포메팅)

메시지 본문을 표시합니다.

true

boolean

showBodyType (formatting)

본문 Java 유형을 표시합니다.

true

boolean

showCaughtException (formatting)

교환에 catch 예외가 있는 경우 예외 메시지(stack trace 없음)를 표시합니다. catch된 예외는 (예: org.apache.camel.Exchange#EXCEPTION_CAUGHT)의 속성으로 저장되고, 예를 들어 doCatch가 예외를 catch할 수 있습니다.

false

boolean

showException (formatting)

교환에 예외가 있는 경우 예외 메시지(stacktrace 없음)를 표시합니다.

false

boolean

showExchangeId (formatting)

고유한 교환 ID를 표시합니다.

false

boolean

showExchangePattern (formatting)

메시지 교환 패턴(간단한 경우 MEP)을 표시합니다.

true

boolean

showFiles (formatting)

활성화된 Camel이 파일을 출력합니다.

false

boolean

showFuture (formatting)

Camel이 enabled인 경우 hieradata 오브젝트에서 페이로드가 기록될 때까지 기다립니다.

false

boolean

showHeaders (formatting)

메시지 헤더를 표시합니다.

false

boolean

showProperties (formatting)

교환 속성(사용자 지정만)을 표시합니다. showAllProperties를 사용하여 내부 및 사용자 지정 속성을 모두 표시합니다.

false

boolean

showStackTrace (formatting)

교환에 예외가 있는 경우 스택 추적을 표시합니다. showAll, showException 또는 showCaughtException 중 하나가 활성화된 경우에만 적용됩니다.

false

boolean

showStreams (formatting)

Camel이 스트림 본문을 표시해야 하는지 여부(예: java.io.InputStream). 이 옵션을 활성화하면 나중에 이 로거에서 스트림을 읽은 것처럼 메시지 본문에 액세스하지 못할 수 있습니다. 이 문제를 해결하려면 Stream Caching을 사용해야합니다.

false

boolean

skipBodyLineSeparator (formatting)

메시지 본문을 기록할 때 줄 구분 기호를 건너뛸지 여부입니다. 이렇게 하면 메시지 본문을 한 줄에 로깅할 수 있으며, 이 옵션을 false로 설정하면 본문에서 모든 줄 구분 기호가 유지되므로 본문은 본문에 그대로 기록됩니다.

true

boolean

스타일 (formatting)

사용할 출력 스타일을 설정합니다.

CloudEvent 값:

  • Default
  • 수정됨

Default

OutputStyle

30.5. 일반 로거 샘플

아래 경로에서 주문이 처리되기 전에 DEBUG 수준에서 들어오는 주문을 기록합니다.

from("activemq:orders").to("log:com.mycompany.order?level=DEBUG").to("bean:processOrder");

또는 Spring XML을 사용하여 경로를 정의합니다.

<route>
  <from uri="activemq:orders"/>
  <to uri="log:com.mycompany.order?level=DEBUG"/>
  <to uri="bean:processOrder"/>
</route>

30.6. 포맷터 샘플이 있는 일반 로거

아래 경로에서는 주문이 처리되기 전에 INFO 수준에서 들어오는 주문을 기록합니다.

from("activemq:orders").
    to("log:com.mycompany.order?showAll=true&multiline=true").to("bean:processOrder");

30.7. groupSize 샘플이 있는 처리량 로거

아래 경로에서는 10개의 메시지로 그룹화된 DEBUG 수준에서 들어오는 주문의 처리량을 기록합니다.

from("activemq:orders").
    to("log:com.mycompany.order?level=DEBUG&groupSize=10").to("bean:processOrder");

30.8. groupInterval 샘플이 있는 처리량 로거

이 경로를 사용하면 10s마다 메시지 통계가 기록되고 초기 60s 지연이 표시되고 메시지 트래픽이 없는 경우에도 통계가 표시되어야 합니다.

from("activemq:orders").
    to("log:com.mycompany.order?level=DEBUG&groupInterval=10000&groupDelay=60000&groupActiveOnly=false").to("bean:processOrder");

다음과 같은 사항이 기록됩니다.

"Received: 1000 new messages, with total 2000 so far. Last group took: 10000 millis which is: 100 messages per second. average: 100"

30.9. 암호와 같은 민감한 정보 검색

logMask 플래그를 true 로 설정하여 로깅에 대한 보안 마스킹을 활성화할 수 있습니다. 이 옵션은 로그 EIP에도 영향을 미칩니다.

CamelContext 수준에서 Java DSL에서 마스크를 활성화하려면 다음을 수행합니다.

camelContext.setLogMask(true);

XML에서 다음을 수행합니다.

<camelContext logMask="true">

끝점 수준에서|오프할 수도 있습니다. 엔드포인트 수준에서 Java DSL에서 마스크를 활성화하려면 로그 끝점에 대한 URI에 logMask=true 옵션을 추가합니다.

from("direct:start").to("log:foo?logMask=true");

XML에서 다음을 수행합니다.

<route>
  <from uri="direct:foo"/>
  <to uri="log:foo?logMask=true"/>
</route>

org.apache.camel.support.processor.DefaultMaskingFormatter 는 기본적으로 마스킹에 사용됩니다. 사용자 지정 마스킹 포맷터를 사용하려면 CamelCustomLogMask 라는 이름으로 레지스트리에 배치하십시오. 마스킹 포맷터는 org.apache.camel.spi.MaskingFormatter 를 구현해야 합니다.

30.10. 로깅 출력의 전체 사용자 정의

섹션에 설명된 옵션을 사용하면 로거 출력의 많은 부분을 제어할 수 있습니다. 그러나 로그 행은 항상 다음 구조를 따릅니다.

Exchange[Id:ID-machine-local-50656-1234567901234-1-2, ExchangePattern:InOut,
Properties:{CamelToEndpoint=log://org.apache.camel.component.log.TEST?showAll=true,
CamelCreatedTimestamp=Thu Mar 28 00:00:00 WET 2013},
Headers:{breadcrumbId=ID-machine-local-50656-1234567901234-1-1}, BodyType:String, Body:Hello World, Out: null]

경우에 따라 이 형식이 적합하지 않을 수 있습니다.

  • 표시되는 헤더와 속성을 필터링하여 통찰력과 상세 정보 표시 사이의 균형을 유지합니다.
  • 로그 메시지를 가장 읽을 수 있는 것으로 조정하십시오.
  • 로그 광업 시스템(예: Splunk)별 다이제스트에 대한 로그 메시지를 사용자 정의합니다.
  • 특정 본문 유형을 다르게 인쇄합니다.

절대 사용자 정의가 필요할 때마다 인터페이스를 구현하는 클래스를 만들 수 있습니다. format(Exchange) 메서드에서 전체 교환에 액세스할 수 있으므로 필요한 정확한 정보를 선택하고 추출하고 사용자 지정 방식으로 포맷한 후 이를 반환할 수 있습니다. 반환 값은 최종 로그 메시지가 됩니다.

Log 구성 요소는 다음 두 가지 방법 중 하나로 사용자 지정 ExchangeFormatter 를 선택하도록 할 수 있습니다.

레지스트리에서 LogComponent를 명시적으로 인스턴스화합니다.

<bean name="log" class="org.apache.camel.component.log.LogComponent">
   <property name="exchangeFormatter" ref="myCustomFormatter" />
</bean>

30.10.1. 구성을 통한 ovs over configuration

단순히 logFormatter 라는 이름으로 빈을 등록하면 됩니다. Log Component는 자동으로 선택할 수 있을 만큼 지능적입니다.

<bean name="logFormatter" class="com.xyz.MyCustomExchangeFormatter" />
참고

ExchangeFormatter해당 Camel 컨텍스트 내의 모든 로그 끝점에 적용됩니다. 다양한 엔드포인트에 서로 다른 ExchangeFormatter가 필요한 경우 LogComponent를 필요한 만큼 인스턴스화하고 관련 빈 이름을 끝점 접두사로 사용합니다.

사용자 지정 로그 포멧터를 사용하는 경우 사용자 정의 로그 포맷터에 구성된 로그 uri에서 매개변수를 지정할 수 있습니다. "logFormatter"를type scoped로 정의해야 하지만 다른 매개변수(예:)가 있는 경우 공유되지 않도록 합니다.

<bean name="logFormatter" class="com.xyz.MyCustomExchangeFormatter" scope="prototype"/>

그러면 다양한 옵션이 있는 로그 배를 사용하여 Camel 경로를 지정할 수 있습니다.

<to uri="log:foo?param1=foo&amp;param2=100"/>

<to uri="log:bar?param1=bar&amp;param2=200"/>

30.11. Spring Boot Auto-Configuration

Spring Boot로 로그를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-log-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.log.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.log.enabled

로그 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.log.exchange-formatter

Exchange를 로깅에 적합한 문자열로 변환하는 사용자 지정 ExchangeFormatter를 설정합니다. 지정하지 않으면 DefaultExchangeFormatter로 기본 설정됩니다. 옵션은 org.apache.camel.spi.ExchangeFormatter 유형입니다.

 

ExchangeFormatter

camel.component.log.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

31장. mail

생산자 및 소비자 모두 지원

mail 구성 요소는 Spring의 mail 지원 및 기본 Java>-< 시스템을 통해 이메일에 대한 액세스를 제공합니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-mail</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>
참고

POP3 또는 Bookinfo
POP3에는 몇 가지 제한 사항이 있으며 최종 사용자는 가능한 경우 CloudEvent를 사용하는 것이 좋습니다.

참고


테스트를 위해 mock-mail을 사용하면 단위 테스트에 mock 프레임워크를 사용할 수 있으므로 실제 메일 서버가 필요하지 않고 테스트할 수 있습니다. 그러나 실제 메일 서버로 이메일을 보내야 하는 프로덕션 환경 또는 기타 환경으로 이동할 때 mock-mail을 포함하지 않아야 합니다. classpath에 mock-javamail.jar가 존재하면 이메일을 보내는 것을 방지할 수 있습니다.

31.1. URI 형식

메일 끝점은 다음 URI 형식 중 하나를 가질 수 있습니다(프로토그래프, SMTP, POP3 또는 ScanSetting의 경우 각각).

smtp://[username@]host[:port][?options]
pop3://[username@]host[:port][?options]
imap://[username@]host[:port][?options]

또한, 메일 구성 요소는 SSL을 통해 계층화된 이러한 프로토콜의 안전한 변형을 지원합니다. 스키마에 s 를 추가하여 보안 프로토콜을 활성화할 수 있습니다.

smtps://[username@]host[:port][?options]
pop3s://[username@]host[:port][?options]
imaps://[username@]host[:port][?options]

31.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

31.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

31.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

31.3. 구성 요소 옵션

mail 구성 요소는 아래에 나열된 43 옵션을 지원합니다.

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

closeFolder (consumer)

사용자가 폴링 후 폴더를 종료해야 하는지 여부입니다. 이 옵션을 false로 설정하고 disconnect=false를 갖는 경우에도 소비자는 폴더를 폴링 간에 열린 상태로 유지합니다.

true

boolean

copyTo (consumer)

메일 메시지를 처리한 후 지정된 이름을 가진 메일 폴더에 복사할 수 있습니다. 키 copyTo가 있는 헤더를 사용하여 이 구성 값을 재정의할 수 있으므로 런타임에 구성된 폴더 이름에 메시지를 복사할 수 있습니다.

 

문자열

decodeFilename (consumer)

true로 설정하면 MimeUtility.decodeImagePrepare 메서드를 사용하여 파일 이름을 디코딩합니다. 이는 JVM 시스템 속성 mail.mime.encodefilename을 설정하는 것과 유사합니다.

false

boolean

삭제 (consumer)

메시지가 처리된 후 삭제됩니다. 이 작업은 메일 메시지에 DELETED 플래그를 설정하여 수행됩니다. false인 경우 SEEN 플래그가 대신 설정됩니다. Camel 2.10부터 키 삭제로 헤더를 설정하여 메일이 삭제해야 하는지 여부를 확인하여 이 구성 옵션을 덮어쓸 수 있습니다.

false

boolean

연결 해제 (consumer)

폴링 후 소비자의 연결을 끊을지 여부입니다. 이 기능을 활성화하면 Camel이 각 폴링에 연결됩니다.

false

boolean

handleFailedMessage (consumer)

메일 소비자가 지정된 메일 메시지를 검색할 수 없는 경우 이 옵션을 사용하면 소비자의 오류 처리기에 의해 발생한 예외를 처리할 수 있습니다. 소비자에서 브리지 오류 처리기를 활성화하면 Camel 라우팅 오류 처리기가 대신 예외를 처리할 수 있습니다. 기본 동작은 소비자가 예외가 발생하며 일괄 처리의 메일이 Camel에 의해 라우팅되지 않는 것입니다.

false

boolean

mimeDecodeHeaders (consumer)

이 옵션을 사용하면 메시지 헤더에 대해 투명한 MIME 디코딩 및 언로드를 사용할 수 있습니다.

false

boolean

moveto (consumer)

메일 메시지를 처리한 후 지정된 이름을 가진 메일 폴더로 이동할 수 있습니다. moveTo 키가 있는 헤더를 사용하여 이 구성 값을 재정의하여 런타임에 구성된 폴더 이름으로 메시지를 이동할 수 있습니다.

 

문자열

peek (consumer)

는 메일 메시지를 처리하기 전에 javax.mail.Message를 peeked로 표시합니다. 이는 gRPCMessage 메시지 유형에만 적용됩니다. Peek를 사용하면 메일 서버에서 SEEN으로 빠르게 표시되지 않으므로 Camel에 오류 처리가 있는 경우 메일 메시지를 롤백할 수 있습니다.

true

boolean

skipFailedMessage (consumer)

메일 소비자가 지정된 메일 메시지를 검색할 수 없는 경우 이 옵션을 사용하면 메시지를 건너뛰고 다음 메일 메시지를 검색할 수 있습니다. 기본 동작은 소비자가 예외가 발생하며 일괄 처리의 메일이 Camel에 의해 라우팅되지 않는 것입니다.

false

boolean

보이지 않음(Consumer)

보이지 않는 이메일만 제한할지 여부입니다.

true

boolean

fetchSize (consumer (advanced))

폴링 중에 사용할 최대 메시지 수를 설정합니다. 이 명령을 사용하면 메일 서버 과부하를 방지할 수 있습니다. 이 폴더에는 message가 많이 포함된 경우 copy server를 사용할 수 있습니다. 기본값 -1은 가져오기 크기가 없고 모든 메시지가 소비됨을 의미합니다. 값을 0으로 설정하는 것은 특별한 코너 케이스입니다. 여기서 Camel은 메시지를 전혀 사용하지 않습니다.

-1

int

folderName (consumer(advanced))

폴링할 폴더입니다.

INBOX

문자열

mapServiceVersionMessage (상세)

Camel이 수신된 메일 메시지를 Camel body/headers/attachments에 매핑할지 여부를 지정합니다. true로 설정하면 메일 메시지 본문이 Camel IN 메시지 본문에 매핑되고, 메일 헤더가 IN 헤더에 매핑되고 Camel IN 첨부 파일에 첨부됩니다. 이 옵션이 false로 설정되면 IN 메시지에 원시 javax.mail.Message가 포함됩니다. exchange.getIn().getBody(javax.mail.Message.class)를 호출하여 원시 메시지를 검색할 수 있습니다.

true

boolean

bcc (producer)

BCC 이메일 주소를 설정합니다. 여러 이메일 주소를 쉼표로 분리합니다.

 

문자열

CC (producer)

CC 이메일 주소를 설정합니다. 여러 이메일 주소를 쉼표로 분리합니다.

 

문자열

from (producer)

이메일 주소에서.

camel@localhost

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

replyTo (producer)

Reply-To 수신자(응답 이메일의 수신자). 여러 이메일 주소를 쉼표로 분리합니다.

 

문자열

제목 (producer)

전송 중인 메시지의 주체입니다. 참고: 헤더의 제목 설정이 이 옵션보다 우선합니다.

 

문자열

(producer)

대상 이메일 주소를 설정합니다. 여러 이메일 주소를 쉼표로 분리합니다.

 

문자열

javaECDHESender (제조업체 (고급))

사용자 지정 org.apache.camel.component.mail.Java>-<Sender를 사용하여 이메일을 보냅니다.

 

JavaMailSender

추가Java>-<Properties (advanced)

다른 모든 옵션에 따라 설정된 기본 속성을 추가/구독하는 추가 Java 메일 속성을 설정합니다. 이 기능은 몇 가지 특수 옵션을 추가해야 하지만 다른 옵션을 그대로 유지하려는 경우에 유용합니다.

 

속성

alternativeBodyHeader (advanced)

대체 이메일 본문이 포함된 IN 메시지 헤더에 키를 지정합니다. 예를 들어 텍스트/html 형식으로 이메일을 보내고 HTML이 아닌 이메일 클라이언트에 대한 대체 메일 본문을 제공하려는 경우 이 키를 헤더로 사용하는 대체 메일 본문을 설정합니다.

CamelMailAlternativeBody

문자열

attachmentsContentTransferEncodingResolver (advanced)

사용자 지정 AttachmentsContentTransferEncodingResolver를 사용하여 첨부 파일에 사용할 콘텐츠 유형 인코딩을 해결하려면 다음을 수행합니다.

 

AttachmentsContentTransferEncodingResolver

Authenticator (advanced)

로그인을 위한 인증자입니다. 설정되면 암호와 사용자 이름이 무시됩니다. 만료될 수 있는 토큰에 사용할 수 있으므로 동적으로 읽을 수 있습니다.

 

MailAuthenticator

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

구성 (고급)

mail 구성을 설정합니다.

 

MailConfiguration

connectionTimeout (advanced)

연결 제한 시간(밀리초)입니다.

30000

int

contentType (advanced)

메일 메시지 콘텐츠 유형입니다. HTML 메일에 텍스트/html을 사용합니다.

text/plain

문자열

contentTypeResolver (advanced)

파일 첨부에 대한 Content-Type을 결정합니다.

 

ContentTypeResolver

debugMode (advanced)

기본 메일 프레임워크에서 디버그 모드를 활성화합니다. SUN mail 프레임워크는 기본적으로 디버그 메시지를 System.out에 기록합니다.

false

boolean

ignoreUnsupportedCharset (advanced)

Camel이 이메일을 보낼 때 로컬 JVM에서 지원되지 않는 줄임표를 무시하도록 하는 옵션입니다. 줄임셋이 지원되지 않는 경우, tlsset=XXX(여기서 XXX는 지원되지 않는Charset를 나타내는)가 콘텐츠 유형에서 제거되고 대신 플랫폼 기본값에 따라 달라집니다.

false

boolean

ignoreUriScheme (advanced)

Camel이 이메일을 보낼 때 로컬 JVM에서 지원되지 않는 줄임표를 무시하도록 하는 옵션입니다. 줄임셋이 지원되지 않는 경우, tlsset=XXX(여기서 XXX는 지원되지 않는Charset를 나타내는)가 콘텐츠 유형에서 제거되고 대신 플랫폼 기본값에 따라 달라집니다.

false

boolean

java>-<Properties (advanced)

Java mail 옵션을 설정합니다. 모든 기본 속성을 지우고 이 메서드에 제공된 속성만 사용합니다.

 

속성

세션 (고급)

camel이 모든 메일 상호 작용에 사용해야 하는 메일 세션을 지정합니다. mail session이 created and managed by some other resource(예: CloudEvent 컨테이너)에서 생성 및 관리되는 시나리오에서 유용합니다. 사용자 지정 메일 세션을 사용하는 경우 메일 세션의 호스트 이름과 포트가 사용됩니다(세션에 구성된 경우).

 

세션

UseInlineAttachments (advanced)

disposition inline 또는 attachment을 사용할 지 여부입니다.

false

boolean

headerFilterStrategy (filter)

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지와 헤더를 필터링합니다.

 

HeaderFilterStrategy

암호 (보안)

로그인의 암호입니다. setAuthenticator(knativeAuthenticator)도 참조하십시오.

 

문자열

sslContextParameters (보안)

SSLContextParameters를 사용하여 보안을 구성하려면 다음을 수행합니다.

 

SSLContextParameters

useGlobalSslContextParameters (security)

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

boolean

사용자 이름 (보안)

로그인의 사용자 이름입니다. setAuthenticator(knativeAuthenticator)도 참조하십시오.

 

문자열

31.4. 끝점 옵션

mail 끝점은 URI 구문을 사용하여 구성됩니다.

imap:host:port

다음과 같은 경로 및 쿼리 매개변수 사용:

31.4.1. 경로 매개변수(2 매개변수)

이름설명Default유형

호스트 (공용)

필수 메일 서버 호스트 이름입니다.

 

문자열

포트 (공용)

메일 서버의 포트 번호입니다.

 

int

31.4.2. 쿼리 매개변수(66 매개변수)

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

closeFolder (consumer)

사용자가 폴링 후 폴더를 종료해야 하는지 여부입니다. 이 옵션을 false로 설정하고 disconnect=false를 갖는 경우에도 소비자는 폴더를 폴링 간에 열린 상태로 유지합니다.

true

boolean

copyTo (consumer)

메일 메시지를 처리한 후 지정된 이름을 가진 메일 폴더에 복사할 수 있습니다. 키 copyTo가 있는 헤더를 사용하여 이 구성 값을 재정의할 수 있으므로 런타임에 구성된 폴더 이름에 메시지를 복사할 수 있습니다.

 

문자열

decodeFilename (consumer)

true로 설정하면 MimeUtility.decodeImagePrepare 메서드를 사용하여 파일 이름을 디코딩합니다. 이는 JVM 시스템 속성 mail.mime.encodefilename을 설정하는 것과 유사합니다.

false

boolean

삭제 (consumer)

메시지가 처리된 후 삭제됩니다. 이 작업은 메일 메시지에 DELETED 플래그를 설정하여 수행됩니다. false인 경우 SEEN 플래그가 대신 설정됩니다. Camel 2.10부터 키 삭제로 헤더를 설정하여 메일이 삭제해야 하는지 여부를 확인하여 이 구성 옵션을 덮어쓸 수 있습니다.

false

boolean

연결 해제 (consumer)

폴링 후 소비자의 연결을 끊을지 여부입니다. 이 기능을 활성화하면 Camel이 각 폴링에 연결됩니다.

false

boolean

handleFailedMessage (consumer)

메일 소비자가 지정된 메일 메시지를 검색할 수 없는 경우 이 옵션을 사용하면 소비자의 오류 처리기에 의해 발생한 예외를 처리할 수 있습니다. 소비자에서 브리지 오류 처리기를 활성화하면 Camel 라우팅 오류 처리기가 대신 예외를 처리할 수 있습니다. 기본 동작은 소비자가 예외가 발생하며 일괄 처리의 메일이 Camel에 의해 라우팅되지 않는 것입니다.

false

boolean

maxMessagesPerPoll (consumer)

폴링당 수집할 최대 메시지 수를 지정합니다. 기본적으로 최대값은 설정되어 있지 않습니다. 예를 들어 서버가 시작될 때 수천 개의 파일을 다운로드하지 않도록 제한 1000을 설정하는 데 사용할 수 있습니다. 이 옵션을 비활성화하려면 0 또는 negative 값을 설정합니다.

 

int

mimeDecodeHeaders (consumer)

이 옵션을 사용하면 메시지 헤더에 대해 투명한 MIME 디코딩 및 언로드를 사용할 수 있습니다.

false

boolean

moveto (consumer)

메일 메시지를 처리한 후 지정된 이름을 가진 메일 폴더로 이동할 수 있습니다. moveTo 키가 있는 헤더를 사용하여 이 구성 값을 재정의하여 런타임에 구성된 폴더 이름으로 메시지를 이동할 수 있습니다.

 

문자열

peek (consumer)

는 메일 메시지를 처리하기 전에 javax.mail.Message를 peeked로 표시합니다. 이는 gRPCMessage 메시지 유형에만 적용됩니다. Peek를 사용하면 메일 서버에서 SEEN으로 빠르게 표시되지 않으므로 Camel에 오류 처리가 있는 경우 메일 메시지를 롤백할 수 있습니다.

true

boolean

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

skipFailedMessage (consumer)

메일 소비자가 지정된 메일 메시지를 검색할 수 없는 경우 이 옵션을 사용하면 메시지를 건너뛰고 다음 메일 메시지를 검색할 수 있습니다. 기본 동작은 소비자가 예외가 발생하며 일괄 처리의 메일이 Camel에 의해 라우팅되지 않는 것입니다.

false

boolean

보이지 않음(Consumer)

보이지 않는 이메일만 제한할지 여부입니다.

true

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

fetchSize (consumer (advanced))

폴링 중에 사용할 최대 메시지 수를 설정합니다. 이 명령을 사용하면 메일 서버 과부하를 방지할 수 있습니다. 이 폴더에는 message가 많이 포함된 경우 copy server를 사용할 수 있습니다. 기본값 -1은 가져오기 크기가 없고 모든 메시지가 소비됨을 의미합니다. 값을 0으로 설정하는 것은 특별한 코너 케이스입니다. 여기서 Camel은 메시지를 전혀 사용하지 않습니다.

-1

int

folderName (consumer(advanced))

폴링할 폴더입니다.

INBOX

문자열

mailUidGenerator (consumer (advanced))

사용자 지정 논리를 사용하여 메일 메시지의 UUID를 생성할 수 있는 플러그형 mailUidGenerator입니다.

 

MailUidGenerator

mapServiceVersionMessage (상세)

Camel이 수신된 메일 메시지를 Camel body/headers/attachments에 매핑할지 여부를 지정합니다. true로 설정하면 메일 메시지 본문이 Camel IN 메시지 본문에 매핑되고, 메일 헤더가 IN 헤더에 매핑되고 Camel IN 첨부 파일에 첨부됩니다. 이 옵션이 false로 설정되면 IN 메시지에 원시 javax.mail.Message가 포함됩니다. exchange.getIn().getBody(javax.mail.Message.class)를 호출하여 원시 메시지를 검색할 수 있습니다.

true

boolean

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

PostProcessAction (consumer (advanced))

일반 처리가 종료되면box에서 게시 처리 작업을 수행하기 위한 mailBoxPostProcessAction을 나타냅니다.

 

MailBoxPostProcessAction

bcc (producer)

BCC 이메일 주소를 설정합니다. 여러 이메일 주소를 쉼표로 분리합니다.

 

문자열

CC (producer)

CC 이메일 주소를 설정합니다. 여러 이메일 주소를 쉼표로 분리합니다.

 

문자열

from (producer)

이메일 주소에서.

camel@localhost

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

replyTo (producer)

Reply-To 수신자(응답 이메일의 수신자). 여러 이메일 주소를 쉼표로 분리합니다.

 

문자열

제목 (producer)

전송 중인 메시지의 주체입니다. 참고: 헤더의 제목 설정이 이 옵션보다 우선합니다.

 

문자열

(producer)

대상 이메일 주소를 설정합니다. 여러 이메일 주소를 쉼표로 분리합니다.

 

문자열

javaECDHESender (제조업체 (고급))

사용자 지정 org.apache.camel.component.mail.Java>-<Sender를 사용하여 이메일을 보냅니다.

 

JavaMailSender

추가Java>-<Properties (advanced)

다른 모든 옵션에 따라 설정된 기본 속성을 추가/구독하는 추가 Java 메일 속성을 설정합니다. 이 기능은 몇 가지 특수 옵션을 추가해야 하지만 다른 옵션을 그대로 유지하려는 경우에 유용합니다.

 

속성

alternativeBodyHeader (advanced)

대체 이메일 본문이 포함된 IN 메시지 헤더에 키를 지정합니다. 예를 들어 텍스트/html 형식으로 이메일을 보내고 HTML이 아닌 이메일 클라이언트에 대한 대체 메일 본문을 제공하려는 경우 이 키를 헤더로 사용하는 대체 메일 본문을 설정합니다.

CamelMailAlternativeBody

문자열

attachmentsContentTransferEncodingResolver (advanced)

사용자 지정 AttachmentsContentTransferEncodingResolver를 사용하여 첨부 파일에 사용할 콘텐츠 유형 인코딩을 해결하려면 다음을 수행합니다.

 

AttachmentsContentTransferEncodingResolver

Authenticator (advanced)

로그인을 위한 인증자입니다. 설정되면 암호와 사용자 이름이 무시됩니다. 만료될 수 있는 토큰에 사용할 수 있으므로 동적으로 읽을 수 있습니다.

 

MailAuthenticator

바인딩 (advanced)

Camel 메시지에서 mail 메시지로 변환하거나 발송하는 데 사용되는 바인딩을 설정합니다.

 

MailBinding

connectionTimeout (advanced)

연결 제한 시간(밀리초)입니다.

30000

int

contentType (advanced)

메일 메시지 콘텐츠 유형입니다. HTML 메일에 텍스트/html을 사용합니다.

text/plain

문자열

contentTypeResolver (advanced)

파일 첨부에 대한 Content-Type을 결정합니다.

 

ContentTypeResolver

debugMode (advanced)

기본 메일 프레임워크에서 디버그 모드를 활성화합니다. SUN mail 프레임워크는 기본적으로 디버그 메시지를 System.out에 기록합니다.

false

boolean

headerFilterStrategy (advanced)

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 헤더를 필터링하려면 다음을 수행합니다.

 

HeaderFilterStrategy

ignoreUnsupportedCharset (advanced)

Camel이 이메일을 보낼 때 로컬 JVM에서 지원되지 않는 줄임표를 무시하도록 하는 옵션입니다. 줄임셋이 지원되지 않는 경우, tlsset=XXX(여기서 XXX는 지원되지 않는Charset를 나타내는)가 콘텐츠 유형에서 제거되고 대신 플랫폼 기본값에 따라 달라집니다.

false

boolean

ignoreUriScheme (advanced)

Camel이 이메일을 보낼 때 로컬 JVM에서 지원되지 않는 줄임표를 무시하도록 하는 옵션입니다. 줄임셋이 지원되지 않는 경우, tlsset=XXX(여기서 XXX는 지원되지 않는Charset를 나타내는)가 콘텐츠 유형에서 제거되고 대신 플랫폼 기본값에 따라 달라집니다.

false

boolean

java>-<Properties (advanced)

Java mail 옵션을 설정합니다. 모든 기본 속성을 지우고 이 메서드에 제공된 속성만 사용합니다.

 

속성

세션 (고급)

camel이 모든 메일 상호 작용에 사용해야 하는 메일 세션을 지정합니다. mail session이 created and managed by some other resource(예: CloudEvent 컨테이너)에서 생성 및 관리되는 시나리오에서 유용합니다. 사용자 지정 메일 세션을 사용하는 경우 메일 세션의 호스트 이름과 포트가 사용됩니다(세션에 구성된 경우).

 

세션

UseInlineAttachments (advanced)

disposition inline 또는 attachment을 사용할 지 여부입니다.

false

boolean

idempotentRepository (필터)

연결 가능한 리포지토리 org.apache.camel.spi.IdempotentRepository를 통해 동일한 HSM에서 사용하는 클러스터를 허용하고 리포지토리에서 메일 메시지가 소비자가 처리하는 데 유효한지 여부를 조정할 수 있습니다. 기본적으로 리포지토리는 사용되지 않습니다.

 

IdempotentRepository

idempotentRepositoryRemoveOnCommit (filter)

idempotent 리포지토리를 사용하는 경우 메일 메시지가 성공적으로 처리되고 커밋되면 id가 idempotent 리포지토리(기본값)에서 제거되거나 리포지토리에 보관되어야 합니다. 기본적으로 메시지 id는 고유하며 리포지토리에 보관할 값이 없는 것으로 가정합니다. 메일 메시지가 다시 사용되지 않도록 표시/제거 또는 삭제되기 때문입니다. 따라서 idempotent 리포지토리에 저장된 메시지 id는 값이 거의 없습니다. 그러나 이 옵션을 사용하면 어떤 이유로든 메시지 ID를 저장할 수 있습니다.

true

boolean

SearchTerm (필터)

제목, 본문, from, 특정 날짜 등을 보낸 검색 기준을 기반으로 우편을 필터링할 수 있는 javax.mail.search.SearchTerm을 나타냅니다.

 

SearchTerm

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

60000

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

암호 (보안)

로그인의 암호입니다. setAuthenticator(knativeAuthenticator)도 참조하십시오.

 

문자열

sslContextParameters (보안)

SSLContextParameters를 사용하여 보안을 구성하려면 다음을 수행합니다.

 

SSLContextParameters

사용자 이름 (보안)

로그인의 사용자 이름입니다. setAuthenticator(knativeAuthenticator)도 참조하십시오.

 

문자열

sortTerm (sort)

메시지의 정렬 순서입니다. base는 기본적으로 supported이 됩니다. POP3을 사용하거나 CloudEvent 서버에 SORT 기능이 없는 경우 어느 정도 에 에뮬레이션됩니다.

 

SortTerm[]

31.4.3. 샘플 끝점

일반적으로 다음과 같이 로그인 인증 정보를 사용하여 URI를 지정합니다(예: SMTP 생성).

smtp://[username@]host[:port][?password=somepwd]

또는 사용자 이름과 암호를 쿼리 옵션으로 지정할 수 있습니다.

smtp://host[:port]?password=somepwd&username=someuser

예를 들면 다음과 같습니다.

smtp://mycompany.mailserver:30?password=tiger&username=scott

31.4.4. 구성 요소 별칭 이름

  • IMAP
  • IMAPs
  • POP3s
  • SMTP
  • SMTPs

31.4.5. 기본 포트

기본 포트 번호가 지원됩니다. 포트 번호를 생략하면 Camel에서 프로토콜에 따라 사용할 포트 번호를 결정합니다.

프로토콜기본 포트 번호

SMTP

25

SMTPS

465

POP3

110

POP3S

995

IMAP

143

IMAPS

993

31.5. SSL 지원

기본 메일 프레임워크는 SSL 지원을 제공합니다. 필요한 Java mail API 구성 옵션을 완전히 지정하여 SSL/TLS 지원을 구성하거나 구성 요소 또는 끝점 구성을 통해 구성된 SSLContextParameters를 제공할 수 있습니다.

31.5.1. JSSE 설정 utility 사용

메일 구성 요소는 Camel JSSE 구성 utility 를 통해 SSL/TLS 구성을 지원합니다. 이 유틸리티를 사용하면 작성하는데 필요한 구성 요소별 코드의 양이 크게 감소하고 끝점 및 구성 요소 수준에서 구성할 수 있습니다. 다음 예제에서는 메일 구성 요소와 함께 유틸리티를 사용하는 방법을 보여줍니다.

끝점의 프로그래밍 방식 구성

KeyStoreParameters ksp = new KeyStoreParameters();
ksp.setResource("/users/home/server/truststore.jks");
ksp.setPassword("keystorePassword");
TrustManagersParameters tmp = new TrustManagersParameters();
tmp.setKeyStore(ksp);
SSLContextParameters scp = new SSLContextParameters();
scp.setTrustManagers(tmp);
Registry registry = ...
registry.bind("sslContextParameters", scp);
...
from(...)
    .to("smtps://smtp.google.com?username=user@gmail.com&password=password&sslContextParameters=#sslContextParameters");

끝점의 Spring DSL 기반 구성

...
<camel:sslContextParameters id="sslContextParameters">
  <camel:trustManagers>
    <camel:keyStore resource="/users/home/server/truststore.jks" password="keystorePassword"/>
  </camel:trustManagers>
</camel:sslContextParameters>...
...
<to uri="smtps://smtp.google.com?username=user@gmail.com&password=password&sslContextParameters=#sslContextParameters"/>...

31.5.2. Java>-< 직접 설정

Camel은 잘 알려진 인증 기관(기본 JVM 신뢰 구성)에서 발행한 인증서만 신뢰하는 Jakarta Java>-<를 사용합니다. 자체 인증서를 발급한 경우 CA 인증서를 JVM의 Java 신뢰/키 저장소 파일로 가져와서 기본 JVM 신뢰/키 저장 파일을 재정의해야 합니다(자세한 내용은 Java NOTES.txt에서 SSLNOTES.txt 를 참조하십시오).

31.6. mail Message 내용

Camel은 메시지 교환의 IN 본문을 MimeMessage 텍스트 콘텐츠로 사용합니다. 본문은 String.class로 변환됩니다.

Camel은 교환의 모든 IN 헤더를 MimeMessage 헤더에 복사합니다.

MimeMessage 의 주체는 IN 메시지의 헤더 속성을 사용하여 구성할 수 있습니다. 아래 코드는 이를 보여줍니다.

수신자와 같은 기타 MimeMessage 헤더에도 동일하게 적용되므로 다음과 같이 헤더 속성을 사용할 수 있습니다.

mailProducer를 사용하여 이메일을 서버로 보내는 경우 Camel 메시지 헤더에서 Camel>-<MessageId 키가 있는 MimeMessage 의 메시지 id를 가져올 수 있습니다.

31.7. 헤더가 사전 구성된 수신자보다 우선합니다.

메시지 헤더에 지정된 수신자는 항상 끝점 URI에서 사전 구성된 수신자보다 우선합니다. 문제는 메시지 헤더에 수신자를 제공하면 얻을 수 있다는 것입니다. 엔드포인트 URI에서 사전 구성된 수신자는 폴백으로 처리됩니다.

아래 샘플 코드에서 이메일 메시지는 davsclaus@apache.org 로 전송됩니다. 이는 사전 구성된 수신자인 info@mycompany.com 보다 우선하기 때문입니다. 끝점 URI의 CCBCC 설정도 무시되며 해당 수신자는 어떠한 메일도 받지 않습니다. 헤더와 사전 구성된 설정 중에서 선택하는 것은 전부이거나 아무것도 아닙니다. 메일 구성 요소는 헤더에서 독점적으로 또는 사전 구성된 설정에서만 수신자를 사용합니다. 헤더와 사전 구성된 설정을 혼합할 수 없습니다.

Map<String, Object> headers = new HashMap<String, Object>();
headers.put("to", "davsclaus@apache.org");

template.sendBodyAndHeaders("smtp://admin@localhost?to=info@mycompany.com", "Hello World", headers);

31.8. 더 쉬운 구성을 위한 여러 수신자

쉼표로 구분된 목록 또는 comma로 구분된 목록을 사용하여 여러 수신자를 설정할 수 있습니다. 이는 헤더 설정 및 끝점 URI의 설정에 모두 적용됩니다. 예를 들면 다음과 같습니다.

Map<String, Object> headers = new HashMap<String, Object>();
headers.put("to", "davsclaus@apache.org ; jstrachan@apache.org ; ningjiang@apache.org");

앞의 예에서는 separator를 사용합니다. ; 을 구분 기호 문자로 사용합니다.

31.9. 발신자 이름 및 이메일 설정

수신자의 이름과 이메일 주소를 모두 포함하도록 형식인 name <email >을 지정할 수 있습니다.

예를 들어 Message에 다음 헤더를 정의합니다.

Map headers = new HashMap();
map.put("To", "Claus Ibsen <davsclaus@apache.org>");
map.put("From", "James Strachan <jstrachan@apache.org>");
map.put("Subject", "Camel is cool");

31.10. Java>-< API (예: SUN Java>-<)

Java>-< API는 우편 을 소비 및 생성하기 위해 매도에 사용됩니다. Red Hat은 최종 사용자가 POP3 또는 ScanSetting 프로토콜을 사용할 때 이러한 참조를 참조하도록 권장합니다. 특히 POP3에는 10.0.0.1보다 훨씬 제한된 기능 세트가 있습니다.

31.11. 샘플

JMS 대기열에서 수신한 메시지를 이메일로 전송하는 간단한 경로에서 시작합니다. 이메일 계정은 mymailserver.comadmin 계정입니다.

from("jms://queue:subscription").to("smtp://admin@mymailserver.com?password=secret");

다음 샘플에서는 1분마다 한 번 새 이메일에 대한 Webhook를 폴링합니다.

from("imap://admin@mymailserver.com?password=secret&unseen=true&delay=60000")
    .to("seda://mails");

31.12. 첨부 파일 샘플을 사용하여 이메일 전송

참고

첨부 파일은 모든 Camel 구성 요소에서 지원되지 않습니다
첨부 API 는 Java 활성화 프레임워크를 기반으로 하며 일반적으로 mail API에서만 사용됩니다. 다른 Camel 구성 요소 대부분은 첨부 파일을 지원하지 않으므로 경로를 통해 전파할 때 첨부 파일이 손실될 수 있습니다. 따라서 엄지된 규칙은 메시지를 메일 엔드포인트에 보내기 직전에 첨부 파일을 추가하는 것입니다.

mail 구성 요소는 첨부 파일을 지원합니다. 아래 샘플에서는 로고 파일 첨부가 포함된 일반 텍스트 메시지가 포함된 메일 메시지를 보냅니다.

31.13. SSL 샘플

이 샘플에서는 Google 메일 수신함에서 우편으로 발송하려고 합니다. 이메일을 로컬 메일 클라이언트에 다운로드하려면 Google mail을 사용하려면 SSL을 활성화하고 구성해야 합니다. 이 작업은 Google 메일 계정에 로그인하고 10.0.0.1 액세스를 허용하도록 설정을 변경하여 수행됩니다. Google은 이를 수행하는 방법에 대한 광범위한 문서를 보유하고 있습니다.

from("imaps://imap.gmail.com?username=YOUR_USERNAME@gmail.com&password=YOUR_PASSWORD"
    + "&delete=false&unseen=true&delay=60000").to("log:newmail");

이전 경로는 1분마다 새 메일에 대해 Google 메일 받은 편지함을 폴링하고 수신된 메시지를 newmail 로거 카테고리에 기록합니다.
DEBUG 로깅이 활성화된 샘플을 실행하면 로그의 진행 상황을 모니터링할 수 있습니다.

2008-05-08 06:32:09,640 DEBUG MailConsumer - Connecting to MailStore imaps//imap.gmail.com:993 (SSL enabled), folder=INBOX
2008-05-08 06:32:11,203 DEBUG MailConsumer - Polling mailfolder: imaps//imap.gmail.com:993 (SSL enabled), folder=INBOX
2008-05-08 06:32:11,640 DEBUG MailConsumer - Fetching 1 messages. Total 1 messages.
2008-05-08 06:32:12,171 DEBUG MailConsumer - Processing message: messageNumber=[332], from=[James Bond <007@mi5.co.uk>], to=YOUR_USERNAME@gmail.com], subject=[...
2008-05-08 06:32:12,187 INFO  newmail - Exchange[MailMessage: messageNumber=[332], from=[James Bond <007@mi5.co.uk>], to=YOUR_USERNAME@gmail.com], subject=[...

31.14. 첨부 파일 샘플이 포함된 메일 사용

이 샘플에서는 kdump를 폴링하고 메일의 모든 첨부 파일을 파일로 저장합니다. 먼저box를 폴링하는 경로를 정의합니다. 이 샘플은 Google 우편을 기반으로 하므로 SSL 샘플과 동일한 경로를 사용합니다.

from("imaps://imap.gmail.com?username=YOUR_USERNAME@gmail.com&password=YOUR_PASSWORD"
    + "&delete=false&unseen=true&delay=60000").process(new MyMailProcessor());

이메일을 기록하는 대신 Java 코드에서 우편을 처리할 수 있는 프로세서를 사용합니다.

public void process(Exchange exchange) throws Exception {
    // the API is a bit clunky so we need to loop
    AttachmentMessage attachmentMessage = exchange.getMessage(AttachmentMessage.class);
    Map<String, DataHandler> attachments = attachmentMessage.getAttachments();
    if (attachments.size() > 0) {
        for (String name : attachments.keySet()) {
            DataHandler dh = attachments.get(name);
            // get the file name
            String filename = dh.getName();

            // get the content and convert it to byte[]
            byte[] data = exchange.getContext().getTypeConverter()
                              .convertTo(byte[].class, dh.getInputStream());

            // write the data to a file
            FileOutputStream out = new FileOutputStream(filename);
            out.write(data);
            out.flush();
            out.close();
        }
    }
}

첨부 파일을 처리하는 API를 볼 수 있듯이 약간의 문제가 발생하지만, 표준 API를 사용하여 첨부 파일을 처리할 수 있도록 javax.activation.DataHandler 를 얻을 수 있습니다.

31.15. 첨부 파일로 메일 메시지를 분할하는 방법

이 예제에서는 여러 첨부 파일이 있을 수 있는 메일 메시지를 사용합니다. 개별 첨부 파일당 Splitter EIP를 사용하여 첨부 파일을 별도로 처리하려고 합니다. 예를 들어 메일 메시지에 5개의 첨부 파일이 있는 경우 Splitter에서 각각 하나의 첨부 파일을 갖는 메시지를 5개 처리하려고 합니다. 이렇게 하려면 단일 첨부 파일과 함께 5개의 메시지가 포함된 List<Message>를 제공하는 Splitter에 사용자 지정 표현식을 제공해야 합니다.

코드는 camel-mail 구성 요소에서 Camel 2.10 이후의 상자에서 제공됩니다. 코드는 여기에 있는 소스 코드에서 찾을 수 있는 org.apache.camel.component.mail.mail.>-<AttachmentsExpression 클래스에 있습니다.

Camel 경로에서 이 표현식을 다음과 같이 경로에서 사용해야 합니다.

XML DSL을 사용하는 경우 아래와 같이 Splitter에서 메서드 호출 표현식을 선언해야 합니다.

<split>
  <method beanType="org.apache.camel.component.mail.SplitAttachmentsExpression"/>
  <to uri="mock:split"/>
</split>

메시지 본문으로 저장되는 첨부 파일을 byte[]로 분할할 수도 있습니다. 부울 true로 식을 생성하여 이 작업을 수행합니다.

SplitAttachmentsExpression split = SplitAttachmentsExpression(true);

그런 다음 이 표현식을 splitter EIP와 함께 사용합니다.

31.16. 사용자 정의 SearchTerm 사용

원하지 않는 이메일을 필터링할 수 있는 mailEndpoint 에서 searchTerm 을 구성할 수 있습니다.

예를 들어 Subject 또는 text에 Camel을 포함하도록 이메일을 필터링하려면 다음과 같이 수행할 수 있습니다.

<route>
  <from uri="imaps://mymailseerver?username=foo&password=secret&searchTerm.subjectOrBody=Camel"/>
  <to uri="bean:myBean"/>
</route>

"searchTerm.subjectOrBody" 를 매개변수 키로 사용하여 이메일 제목 또는 본문에서 "Camel"이라는 단어가 포함되어 있음을 나타냅니다.
org.apache.camel.component.mail.SimpleSearchTerm 클래스에는 구성할 수 있는 여러 옵션이 있습니다.

또는 24시간 전으로 보이지 않는 새로운 이메일을 얻을 수 있습니다. "now-24h" 구문을 확인합니다. 자세한 내용은 아래 표를 참조하십시오.

<route>
  <from uri="imaps://mymailseerver?username=foo&password=secret&searchTerm.fromSentDate=now-24h"/>
  <to uri="bean:myBean"/>
</route>

끝점 uri 구성에 여러 searchTerm을 사용할 수 있습니다. 그런 다음 AND 연산자를 사용하여 결합되므로 두 조건이 모두 일치해야 합니다. 예를 들어 이메일 제목 Camel이 있는 24시간 동안 보이지 않는 마지막 이메일을 얻으려면 다음을 수행할 수 있습니다.

<route>
  <from uri="imaps://mymailseerver?username=foo&password=secret&searchTerm.subject=Camel&searchTerm.fromSentDate=now-24h"/>
  <to uri="bean:myBean"/>
</route>

SimpleSearchTerm 은 gRPC에서 쉽게 구성할 수 있도록 설계되었으므로 XML에서 <ECDHE> 스타일을 사용하여 구성할 수도 있습니다.

<bean id="mySearchTerm" class="org.apache.camel.component.mail.SimpleSearchTerm">
  <property name="subject" value="Order"/>
  <property name="to" value="acme-order@acme.com"/>
  <property name="fromSentDate" value="now"/>
 </bean>

그런 다음 다음과 같이 Camel 경로에서 #ovnId를 사용하여 이 template을 참조할 수 있습니다.

<route>
  <from uri="imaps://mymailseerver?username=foo&password=secret&searchTerm=#mySearchTerm"/>
  <to uri="bean:myBean"/>
</route>

Java에는 org.apache.camel.component.mail.SearchTermBuilder 클래스를 사용하여 복합 SearchTerms 를 빌드할 수 있는 빌더 클래스가 있습니다. 이렇게 하면 다음과 같은 복잡한 용어를 빌드할 수 있습니다.

// we just want the unseen mails which is not spam
SearchTermBuilder builder = new SearchTermBuilder();

builder.unseen().body(Op.not, "Spam").subject(Op.not, "Spam")
  // which was sent from either foo or bar
  .from("foo@somewhere.com").from(Op.or, "bar@somewhere.com");
  // .. and we could continue building the terms

SearchTerm term = builder.build();

31.17. 폴링 최적화

maxMessagePerPoll 및 fetchSize 매개변수를 사용하면 각 폴링에 대해 처리해야 하는 숫자 메시지를 제한할 수 있습니다. 이러한 매개 변수는 많은 메시지가 포함된 폴더로 작업할 때 잘못된 성능을 방지하는 데 도움이 됩니다. 이전 버전에서는 이러한 매개 변수가 너무 늦게 평가되어 큰 속성으로 인해 성능이 저하될 수 있습니다. Camel 3.1을 사용하면 이러한 매개 변수는 폴링 중에 이전에 평가되어 이러한 문제를 방지할 수 있습니다.

31.18. 추가 Java mail Sender 속성이 포함된 헤더 사용

이메일을 보낼 때 교환에서 Java3-4 Sender에 대한 동적 Java 메일 속성을 java.smtp. 로 시작하는 키가 있는 메시지 헤더로 제공할 수 있습니다.

Java mail 설명서에서 찾을 수 있는 모든 java.smtp 속성을 설정할 수 있습니다.

예를 들어 java.smtp.from (SMTP MAIL 명령)에 동적 uuid를 제공하는 경우입니다.

    .setHeader("from", constant("reply2me@foo.com"));
    .setHeader("java.smtp.from", method(UUID.class, "randomUUID"));
    .to("smtp://mymailserver:1234");
참고

이는 사용자 정의 Java>-<Sender 를 사용하지 않는 경우에만 지원됩니다.

31.19. Spring Boot Auto-Configuration

Spring Boot와 함께 imap을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-mail-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.mail.additional-java-mail-properties

다른 모든 옵션에 따라 설정된 기본 속성을 추가/구독하는 추가 Java 메일 속성을 설정합니다. 이 기능은 몇 가지 특수 옵션을 추가해야 하지만 다른 옵션을 그대로 유지하려는 경우에 유용합니다. 옵션은 java.util.Properties 유형입니다.

 

속성

camel.component.mail.alternative-body-header

대체 이메일 본문이 포함된 IN 메시지 헤더에 키를 지정합니다. 예를 들어 텍스트/html 형식으로 이메일을 보내고 HTML이 아닌 이메일 클라이언트에 대한 대체 메일 본문을 제공하려는 경우 이 키를 헤더로 사용하는 대체 메일 본문을 설정합니다.

CamelMailAlternativeBody

문자열

camel.component.mail.attachments-content-transfer-encoding-resolver

사용자 지정 AttachmentsContentTransferEncodingResolver를 사용하여 첨부 파일에 사용할 콘텐츠 유형 인코딩을 해결하려면 다음을 수행합니다. 옵션은 org.apache.camel.component.mail.AttachmentsContentTransferEncodingResolver 유형입니다.

 

AttachmentsContentTransferEncodingResolver

camel.component.mail.authenticator

로그인을 위한 인증자입니다. 설정되면 암호와 사용자 이름이 무시됩니다. 만료될 수 있는 토큰에 사용할 수 있으므로 동적으로 읽을 수 있습니다. 옵션은 org.apache.camel.component.mail.>-<Authenticator 유형입니다.

 

MailAuthenticator

camel.component.mail.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.mail.bcc

BCC 이메일 주소를 설정합니다. 여러 이메일 주소를 쉼표로 분리합니다.

 

문자열

camel.component.mail.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.mail.cc

CC 이메일 주소를 설정합니다. 여러 이메일 주소를 쉼표로 분리합니다.

 

문자열

camel.component.mail.close-folder

사용자가 폴링 후 폴더를 종료해야 하는지 여부입니다. 이 옵션을 false로 설정하고 disconnect=false를 갖는 경우에도 소비자는 폴더를 폴링 간에 열린 상태로 유지합니다.

true

부울

camel.component.mail.configuration

mail 구성을 설정합니다. 옵션은 org.apache.camel.component.mail.>-<Configuration 유형입니다.

 

MailConfiguration

camel.component.mail.connection-timeout

연결 제한 시간(밀리초)입니다.

30000

정수

camel.component.mail.content-type

메일 메시지 콘텐츠 유형입니다. HTML 메일에 텍스트/html을 사용합니다.

text/plain

문자열

camel.component.mail.content-type-resolver

파일 첨부에 대한 Content-Type을 결정합니다. 옵션은 org.apache.camel.component.mail.ContentTypeResolver 유형입니다.

 

ContentTypeResolver

camel.component.mail.copy-to

메일 메시지를 처리한 후 지정된 이름을 가진 메일 폴더에 복사할 수 있습니다. 키 copyTo가 있는 헤더를 사용하여 이 구성 값을 재정의할 수 있으므로 런타임에 구성된 폴더 이름에 메시지를 복사할 수 있습니다.

 

문자열

camel.component.mail.debug-mode

기본 메일 프레임워크에서 디버그 모드를 활성화합니다. SUN mail 프레임워크는 기본적으로 디버그 메시지를 System.out에 기록합니다.

false

부울

camel.component.mail.decode-filename

true로 설정하면 MimeUtility.decodeImagePrepare 메서드를 사용하여 파일 이름을 디코딩합니다. 이는 JVM 시스템 속성 mail.mime.encodefilename을 설정하는 것과 유사합니다.

false

부울

camel.component.mail.delete

메시지가 처리된 후 삭제됩니다. 이 작업은 메일 메시지에 DELETED 플래그를 설정하여 수행됩니다. false인 경우 SEEN 플래그가 대신 설정됩니다. Camel 2.10부터 키 삭제로 헤더를 설정하여 메일이 삭제해야 하는지 여부를 확인하여 이 구성 옵션을 덮어쓸 수 있습니다.

false

부울

camel.component.mail.disconnect

폴링 후 소비자의 연결을 끊을지 여부입니다. 이 기능을 활성화하면 Camel이 각 폴링에 연결됩니다.

false

부울

camel.component.mail.enabled

메일 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.mail.fetch-size

폴링 중에 사용할 최대 메시지 수를 설정합니다. 이 명령을 사용하면 메일 서버 과부하를 방지할 수 있습니다. 이 폴더에는 message가 많이 포함된 경우 copy server를 사용할 수 있습니다. 기본값 -1은 가져오기 크기가 없고 모든 메시지가 소비됨을 의미합니다. 값을 0으로 설정하는 것은 특별한 코너 케이스입니다. 여기서 Camel은 메시지를 전혀 사용하지 않습니다.

-1

정수

camel.component.mail.folder-name

폴링할 폴더입니다.

INBOX

문자열

camel.component.mail.from

이메일 주소에서.

camel@localhost

문자열

camel.component.mail.handle-failed-message

메일 소비자가 지정된 메일 메시지를 검색할 수 없는 경우 이 옵션을 사용하면 소비자의 오류 처리기에 의해 발생한 예외를 처리할 수 있습니다. 소비자에서 브리지 오류 처리기를 활성화하면 Camel 라우팅 오류 처리기가 대신 예외를 처리할 수 있습니다. 기본 동작은 소비자가 예외가 발생하며 일괄 처리의 메일이 Camel에 의해 라우팅되지 않는 것입니다.

false

부울

camel.component.mail.header-filter-strategy

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지와 헤더를 필터링합니다. 옵션은 org.apache.camel.spi.HeaderFilterStrategy 유형입니다.

 

HeaderFilterStrategy

camel.component.mail.ignore-unsupported-charset

Camel이 이메일을 보낼 때 로컬 JVM에서 지원되지 않는 줄임표를 무시하도록 하는 옵션입니다. 줄임셋이 지원되지 않는 경우, tlsset=XXX(여기서 XXX는 지원되지 않는Charset를 나타내는)가 콘텐츠 유형에서 제거되고 대신 플랫폼 기본값에 따라 달라집니다.

false

부울

camel.component.mail.ignore-uri-scheme

Camel이 이메일을 보낼 때 로컬 JVM에서 지원되지 않는 줄임표를 무시하도록 하는 옵션입니다. 줄임셋이 지원되지 않는 경우, tlsset=XXX(여기서 XXX는 지원되지 않는Charset를 나타내는)가 콘텐츠 유형에서 제거되고 대신 플랫폼 기본값에 따라 달라집니다.

false

부울

camel.component.mail.java-mail-properties

Java mail 옵션을 설정합니다. 모든 기본 속성을 지우고 이 메서드에 제공된 속성만 사용합니다. 옵션은 java.util.Properties 유형입니다.

 

속성

camel.component.mail.java-mail-sender

사용자 지정 org.apache.camel.component.mail.Java>-<Sender를 사용하여 이메일을 보냅니다. 옵션은 org.apache.camel.component.mail.Java>-<Sender 유형입니다.

 

JavaMailSender

camel.component.mail.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.mail.map-mail-message

Camel이 수신된 메일 메시지를 Camel body/headers/attachments에 매핑할지 여부를 지정합니다. true로 설정하면 메일 메시지 본문이 Camel IN 메시지 본문에 매핑되고, 메일 헤더가 IN 헤더에 매핑되고 Camel IN 첨부 파일에 첨부됩니다. 이 옵션이 false로 설정되면 IN 메시지에 원시 javax.mail.Message가 포함됩니다. exchange.getIn().getBody(javax.mail.Message.class)를 호출하여 원시 메시지를 검색할 수 있습니다.

true

부울

camel.component.mail.mime-decode-headers

이 옵션을 사용하면 메시지 헤더에 대해 투명한 MIME 디코딩 및 언로드를 사용할 수 있습니다.

false

부울

camel.component.mail.move-to

메일 메시지를 처리한 후 지정된 이름을 가진 메일 폴더로 이동할 수 있습니다. moveTo 키가 있는 헤더를 사용하여 이 구성 값을 재정의하여 런타임에 구성된 폴더 이름으로 메시지를 이동할 수 있습니다.

 

문자열

camel.component.mail.password

로그인의 암호입니다. setAuthenticator(knativeAuthenticator)도 참조하십시오.

 

문자열

camel.component.mail.peek

는 메일 메시지를 처리하기 전에 javax.mail.Message를 peeked로 표시합니다. 이는 gRPCMessage 메시지 유형에만 적용됩니다. Peek를 사용하면 메일 서버에서 SEEN으로 빠르게 표시되지 않으므로 Camel에 오류 처리가 있는 경우 메일 메시지를 롤백할 수 있습니다.

true

부울

camel.component.mail.reply-to

Reply-To 수신자(응답 이메일의 수신자). 여러 이메일 주소를 쉼표로 분리합니다.

 

문자열

camel.component.mail.session

camel이 모든 메일 상호 작용에 사용해야 하는 메일 세션을 지정합니다. mail session이 created and managed by some other resource(예: CloudEvent 컨테이너)에서 생성 및 관리되는 시나리오에서 유용합니다. 사용자 지정 메일 세션을 사용하는 경우 메일 세션의 호스트 이름과 포트가 사용됩니다(세션에 구성된 경우). 옵션은 javax.mail.Session 유형입니다.

 

세션

camel.component.mail.skip-failed-message

메일 소비자가 지정된 메일 메시지를 검색할 수 없는 경우 이 옵션을 사용하면 메시지를 건너뛰고 다음 메일 메시지를 검색할 수 있습니다. 기본 동작은 소비자가 예외가 발생하며 일괄 처리의 메일이 Camel에 의해 라우팅되지 않는 것입니다.

false

부울

camel.component.mail.ssl-context-parameters

SSLContextParameters를 사용하여 보안을 구성하려면 다음을 수행합니다. 옵션은 org.apache.camel.support.jsse.SSLContextParameters 유형입니다.

 

SSLContextParameters

camel.component.mail.subject

전송 중인 메시지의 주체입니다. 참고: 헤더의 제목 설정이 이 옵션보다 우선합니다.

 

문자열

camel.component.mail.to

대상 이메일 주소를 설정합니다. 여러 이메일 주소를 쉼표로 분리합니다.

 

문자열

camel.component.mail.unseen

보이지 않는 이메일만 제한할지 여부입니다.

true

부울

camel.component.mail.use-global-ssl-context-parameters

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

부울

camel.component.mail.use-inline-attachments

disposition inline 또는 attachment을 사용할 지 여부입니다.

false

부울

camel.component.mail.username

로그인의 사용자 이름입니다. setAuthenticator(knativeAuthenticator)도 참조하십시오.

 

문자열

camel.dataformat.mime-multipart.binary-content

MIME multipart의 바이너리 부분 콘텐츠가 바이너리(true) 또는 Base-64 인코딩(false) Default인지 여부를 정의합니다.

false

부울

camel.dataformat.mime-multipart.enabled

mime-multipart 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.mime-multipart.headers-inline

MIME-Multipart 헤더가 메시지 본문(true)의 일부인지 또는 Camel 헤더(false)로 설정되는지 여부를 정의합니다. 기본값은 false입니다.

false

부울

camel.dataformat.mime-multipart.include-headers

MIME 멀티 파트에 MIME 헤더로 포함된 Camel 헤더를 정의하는 regex입니다. headersInline이 true로 설정된 경우에만 작동합니다. 기본값은 헤더를 포함하지 않는 것입니다.

 

문자열

camel.dataformat.mime-multipart.multipart-sub-type

MIME Multipart의 하위 유형을 지정합니다. 기본값은 혼합되어 있습니다.

혼합

문자열

camel.dataformat.mime-multipart.multipart-without-attachment

첨부 파일이 없는 메시지도 MIME Multipart로 마샬링되는지 여부를 정의합니다(한 본문 부분만 포함). 기본값은 false입니다.

false

부울

32장. Master

소비자만 지원됩니다.

Camel-master 엔드포인트는 해당 JVM이 중단된 경우 자동 장애 조치를 통해 클러스터의 단일 소비자만 지정된 끝점에서 소비하도록 하는 방법을 제공합니다.

동시 사용을 지원하지 않거나 상용 또는 안정성 이유로 인해 언제든지 단일 연결만 사용할 수 있는 레거시 백엔드에서 소비해야 하는 경우 매우 유용할 수 있습니다.

32.1. 마스터 끝점 사용

master:someName 을 사용하여 camel 엔드포인트를 접두사로 접두사합니다. 여기서 someName 은 논리 이름이고 마스터 잠금을 취득하는 데 사용됩니다.

from("master:cheese:jms:foo").to("activemq:wine");

이 예에서는 마스터 구성 요소에서 경로가 클러스터의 지정된 시간에 하나의 노드에서만 활성화되도록 합니다. 따라서 클러스터에 8개의 노드가 있는 경우 마스터 구성 요소는 리더가 될 하나의 경로를 선택하고 이 경로만 활성 상태가되므로 이 경로만 jms:foo 의 메시지를 사용합니다. 이 경로가 중지되거나 예기치 않은 종료된 경우 마스터 구성 요소는 이 값을 감지하고 다른 노드가 활성 상태가 되도록 다시 지정합니다. 그러면 활성 상태가 되고 jms:foo 에서 메시지 사용을 시작합니다.

참고

Apache ActiveMQ 5.x에는 Exclusive Consumers 라고 하는 이러한 기능이 있습니다.

32.2. URI 형식

master:namespace:endpoint[?options]

여기서 엔드포인트는 마스터/슬레이브 모드에서 실행하려는 Camel 끝점입니다.

32.3. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

32.3.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

32.3.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

32.4. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

서비스 (고급)

사용할 서비스를 삽입합니다.

 

CamelClusterService

serviceSelector (advanced)

사용할 CamelClusterService를 조회하는 데 사용되는 서비스 선택기를 주입합니다.

 

선택기

32.5. 끝점 옵션

Master 엔드포인트는 URI 구문을 사용하여 구성됩니다.

master:namespace:delegateUri

다음과 같은 경로 및 쿼리 매개변수 사용:

32.5.1. 경로 매개변수(2 매개변수)

이름설명Default유형

네임스페이스 (consumer)

사용할 클러스터 네임스페이스의 이름입니다.

 

문자열

delegateUri (consumer)

마스터/슬레이브 모드에서 사용할 끝점 오브젝트입니다.

 

문자열

32.5.2. 쿼리 매개변수 (3 매개변수)

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

32.6. 예제

클러스터형 Camel 애플리케이션을 하나의 활성 노드에서만 사용하도록 보호할 수 있습니다.

// the file endpoint we want to consume from
String url = "file:target/inbox?delete=true";

// use the camel master component in the clustered group named myGroup
// to run a master/slave mode in the following Camel url
from("master:myGroup:" + url)
    .log(name + " - Received file: ${file:name}")
    .delay(delay)
    .log(name + " - Done file:     ${file:name}")
    .to("file:target/outbox");

마스터 구성 요소는 사용하여 구성할 수 있는 CamelClusterService를 활용합니다.

  • Java

    ZooKeeperClusterService service = new ZooKeeperClusterService();
    service.setId("camel-node-1");
    service.setNodes("myzk:2181");
    service.setBasePath("/camel/cluster");
    
    context.addService(service)
  • XML (Spring/Blueprint)

    <beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
         http://www.springframework.org/schema/beans
         http://www.springframework.org/schema/beans/spring-beans.xsd
         http://camel.apache.org/schema/spring
         http://camel.apache.org/schema/spring/camel-spring.xsd">
    
    
      <bean id="cluster" class="org.apache.camel.component.zookeeper.cluster.ZooKeeperClusterService">
        <property name="id" value="camel-node-1"/>
        <property name="basePath" value="/camel/cluster"/>
        <property name="nodes" value="myzk:2181"/>
      </bean>
    
      <camelContext xmlns="http://camel.apache.org/schema/spring" autoStartup="false">
        ...
      </camelContext>
    
    </beans>
  • Spring boot

    camel.component.zookeeper.cluster.service.enabled   = true
    camel.component.zookeeper.cluster.service.id        = camel-node-1
    camel.component.zookeeper.cluster.service.base-path = /camel/cluster
    camel.component.zookeeper.cluster.service.nodes     = myzk:2181

32.7. 구현

Camel은 다음과 같은 ClusterService 구현을 제공합니다.

  • camel-consul
  • Camel-file
  • camel-infinispan
  • camel-jgroups-raft
  • camel-jgroups
  • camel-kubernetes
  • camel-zookeeper

32.8. Spring Boot Auto-Configuration

Spring Boot와 함께 master를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-master-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.master.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.master.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.master.enabled

마스터 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.master.service

사용할 서비스를 삽입합니다. 옵션은 org.apache.camel.cluster.CamelClusterService 유형입니다.

 

CamelClusterService

camel.component.master.service-selector

사용할 CamelClusterService를 조회하는 데 사용되는 서비스 선택기를 주입합니다. 옵션은 org.apache.camel.cluster.CamelClusterService.Selector 유형입니다.

 

CamelClusterService$Selector

33장. MLLP

생산자 및 소비자 모두 지원

MLLP 구성 요소는 MLLP 프로토콜의 미묘함을 처리하고 MLLP 프로토콜을 사용하여 다른 시스템과 통신하는 데 필요한 기능을 제공하도록 특별히 고안되어 있습니다.

MLLP 구성 요소는 간단한 구성 URI, 자동화된 HL7 승인 생성 및 자동 승인 확인을 제공합니다.

MLLP 프로토콜은 일반적으로 다수의 동시 TCP 연결을 사용하지 않습니다 - 단일 활성 TCP 연결은 정상적인 경우입니다. 따라서 MLLP 구성 요소는 표준 Java 소켓을 기반으로 간단한 스레드당 연결 모델을 사용합니다. 이를 통해 구현을 간소화하고 Camel 자체에만 종속되는 것을 방지할 수 있습니다.

구성 요소는 다음을 지원합니다.

  • TCP 서버를 사용하는 Camel 소비자
  • TCP 클라이언트를 사용하는 Camel 프로듀서

MLLP 구성 요소는 byte[] 페이로드를 사용하며 Camel 유형 변환을 사용하여 byte[] 를 다른 유형으로 변환합니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-mllp</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

33.1. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

33.1.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

33.1.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

33.2. 구성 요소 옵션

MLLP 구성 요소는 아래에 나열된 30 옵션을 지원합니다.

이름설명Default유형

autoAck (common)

MLLP Acknowledgement MLLP 소비자만 자동 생성을 활성화/비활성화합니다.

true

boolean

triggersetName (common)

사용할 기본 ownerset를 설정합니다.

 

문자열

구성 (공용)

MLLP 엔드포인트를 생성할 때 사용할 기본 구성을 설정합니다.

 

MllpConfiguration

& gt;-<7Headers (common)

HL7 Message MLLP 소비자에서만 메시지 헤더 자동 생성을 활성화/비활성화합니다.

true

boolean

requireEndOfData (common)

MLLP 표준을 엄격한 준수를 활성화/비활성화합니다. MLLP 표준은 ScanSetting_OF_BLOCK>-<7 payloadEND_OF_BLOCKEND_OF_DATA를 지정하지만 일부 시스템은 최종 END_OF_DATA 바이트를 전송하지 않습니다. 이 설정은 최종 END_OF_DATA 바이트가 필요한지 여부를 제어합니다.

true

boolean

stringPayload (common)

페이로드를 String으로 변환/비활성화합니다. 활성화된 경우 외부 시스템에서 수신된 HL7 Payloads의 유효성을 검사하면 String으로 변환됩니다. CharsetName 속성이 설정된 경우 해당 문자 집합이 변환에 사용됩니다. tlssetName 속성이 설정되지 않은 경우 MSH-18 값은 적절한 문자 세트를 결정하는 데 사용됩니다. MSH-18이 설정되지 않은 경우 기본 ISO-8859-1 문자 세트가 사용됩니다.

true

boolean

validatePayload (common)

HL7 Payloads의 유효성을 활성화/비활성화하면 외부 시스템에서 수신된 HL7 Payloads의 유효성이 검증됩니다(Validation에 대한 자세한 내용은 Hl7Util.generateInvalidPayloadExceptionMessage 참조). 및 유효하지 않은 페이로드가 감지되면 MllpInvalidMessageException(고객용) 또는 MllpInvalidAcknowledgementException이 발생합니다.

false

boolean

acceptTimeout (consumer)

TCP 연결 TCP 서버만 기다리는 동안 시간 초과(밀리초)입니다.

60000

int

backlog (consumer)

들어오는 연결 표시 요청(연결에 대한 요청)의 최대 대기열 길이가 backlog 매개변수로 설정됩니다. 큐가 가득 찼을 때 연결 표시가 도착하면 연결이 거부됩니다.

5

정수

bindRetryInterval (consumer)

TCP 서버만 - 바인딩 시도 사이에 대기하는 시간(밀리초)입니다.

5000

int

bindTimeout (consumer)

TCP 서버만 - 서버 포트에 대한 바인딩을 재시도하는 시간(밀리초)입니다.

30000

int

bridgeErrorHandler (consumer)

소비자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지를 수신하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 비활성화된 경우 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅하여 예외를 처리하고 무시합니다.

true

boolean

lenientBind (consumer)

TCP Server만 - TCP ServerSocket가 바인딩되기 전에 끝점이 시작될 수 있습니다. 일부 환경에서는 TCP ServerSocket이 바인딩되기 전에 끝점이 시작되도록 허용하는 것이 바람직할 수 있습니다.

false

boolean

maxConcurrentConsumers (consumer)

허용되는 최대 MLLP 소비자 연결 수입니다. 새 연결이 수신되고 최대값이 이미 설정된 경우 새 연결은 즉시 재설정됩니다.

5

int

reuseAddress (consumer)

SO_REUSEADDR 소켓 옵션을 활성화/비활성화합니다.

false

부울

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut

InOut

ExchangePattern

ConnectTimeout (producer)

TCP 연결 TCP 클라이언트에만 설정하는 시간 초과(밀리초)입니다.

30000

int

idleTimeoutStrategy (producer)

유휴 상태의 타임아웃이 발생할 때 수행할 작업을 결정합니다. 가능한 값은 RESET: SO_LINGER를 0으로 설정하고 소켓 CLOSE를 재설정합니다. 소켓을 정상적으로 닫는 기본값은 RESET입니다.

CloudEvent 값:

  • RESET
  • CLOSE

RESET

MllpIdleTimeoutStrategy

keepalive ( producer)

SO_KEEPALIVE 소켓 옵션을 활성화/비활성화합니다.

true

부울

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

tcpNoDelay (producer)

TCP_NODELAY 소켓 옵션을 활성화/비활성화합니다.

true

부울

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

defaultCharset (advanced)

바이트에서/from String 변환에 사용할 기본 문자 집합을 설정합니다.

ISO-8859-1

문자열

logPhi (advanced)

PHI를 기록할지 여부입니다.

true

부울

logPhiMaxBytes (advanced)

로그 항목에 로그인할 PHI의 최대 바이트 수를 설정합니다.

5120

정수

ReadTimeout (advanced)

MLLP 프레임 시작 후 사용된 SO_TIMEOUT 값(밀리초)이 수신되었습니다.

5000

int

receiveBufferSize (advanced)

SO_RCVBUF 옵션을 지정된 값(바이트)으로 설정합니다.

8192

정수

receiveTimeout (advanced)

MLLP 프레임 시작을 기다릴 때 사용되는 SO_TIMEOUT 값(밀리초)입니다.

15000

int

sendBufferSize (advanced)

SO_SNDBUF 옵션을 지정된 값(바이트)으로 설정합니다.

8192

정수

IdleTimeout (tcp)

클라이언트 TCP 연결이 재설정되기 전에 허용되는 대략적인 유휴 시간입니다. null 값 또는 값이 0 이하이면 유휴 타임아웃이 비활성화됩니다.

 

정수

33.3. 끝점 옵션

MLLP 엔드포인트는 URI 구문을 사용하여 구성됩니다.

mllp:hostname:port

다음과 같은 경로 및 쿼리 매개변수 사용:

33.3.1. 경로 매개변수(2 매개변수)

이름설명Default유형

호스트 이름 (common)

TCP 연결의 연결에 필요한 호스트 이름 또는 IP입니다. 기본값은 모든 로컬 IP 주소를 나타내는 null입니다.

 

문자열

포트 (공용)

TCP 연결에 필요한 포트 번호입니다.

 

int

33.3.2. 쿼리 매개변수(26 매개변수)

이름설명Default유형

autoAck (common)

MLLP Acknowledgement MLLP 소비자만 자동 생성을 활성화/비활성화합니다.

true

boolean

triggersetName (common)

사용할 기본 ownerset를 설정합니다.

 

문자열

& gt;-<7Headers (common)

HL7 Message MLLP 소비자에서만 메시지 헤더 자동 생성을 활성화/비활성화합니다.

true

boolean

requireEndOfData (common)

MLLP 표준을 엄격한 준수를 활성화/비활성화합니다. MLLP 표준은 ScanSetting_OF_BLOCK>-<7 payloadEND_OF_BLOCKEND_OF_DATA를 지정하지만 일부 시스템은 최종 END_OF_DATA 바이트를 전송하지 않습니다. 이 설정은 최종 END_OF_DATA 바이트가 필요한지 여부를 제어합니다.

true

boolean

stringPayload (common)

페이로드를 String으로 변환/비활성화합니다. 활성화된 경우 외부 시스템에서 수신된 HL7 Payloads의 유효성을 검사하면 String으로 변환됩니다. CharsetName 속성이 설정된 경우 해당 문자 집합이 변환에 사용됩니다. tlssetName 속성이 설정되지 않은 경우 MSH-18 값은 적절한 문자 세트를 결정하는 데 사용됩니다. MSH-18이 설정되지 않은 경우 기본 ISO-8859-1 문자 세트가 사용됩니다.

true

boolean

validatePayload (common)

HL7 Payloads의 유효성을 활성화/비활성화하면 외부 시스템에서 수신된 HL7 Payloads의 유효성이 검증됩니다(Validation에 대한 자세한 내용은 Hl7Util.generateInvalidPayloadExceptionMessage 참조). 및 유효하지 않은 페이로드가 감지되면 MllpInvalidMessageException(고객용) 또는 MllpInvalidAcknowledgementException이 발생합니다.

false

boolean

acceptTimeout (consumer)

TCP 연결 TCP 서버만 기다리는 동안 시간 초과(밀리초)입니다.

60000

int

backlog (consumer)

들어오는 연결 표시 요청(연결에 대한 요청)의 최대 대기열 길이가 backlog 매개변수로 설정됩니다. 큐가 가득 찼을 때 연결 표시가 도착하면 연결이 거부됩니다.

5

정수

bindRetryInterval (consumer)

TCP 서버만 - 바인딩 시도 사이에 대기하는 시간(밀리초)입니다.

5000

int

bindTimeout (consumer)

TCP 서버만 - 서버 포트에 대한 바인딩을 재시도하는 시간(밀리초)입니다.

30000

int

bridgeErrorHandler (consumer)

소비자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지를 수신하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 비활성화된 경우 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅하여 예외를 처리하고 무시합니다.

true

boolean

lenientBind (consumer)

TCP Server만 - TCP ServerSocket가 바인딩되기 전에 끝점이 시작될 수 있습니다. 일부 환경에서는 TCP ServerSocket이 바인딩되기 전에 끝점이 시작되도록 허용하는 것이 바람직할 수 있습니다.

false

boolean

maxConcurrentConsumers (consumer)

허용되는 최대 MLLP 소비자 연결 수입니다. 새 연결이 수신되고 최대값이 이미 설정된 경우 새 연결은 즉시 재설정됩니다.

5

int

reuseAddress (consumer)

SO_REUSEADDR 소켓 옵션을 활성화/비활성화합니다.

false

부울

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut

InOut

ExchangePattern

ConnectTimeout (producer)

TCP 연결 TCP 클라이언트에만 설정하는 시간 초과(밀리초)입니다.

30000

int

idleTimeoutStrategy (producer)

유휴 상태의 타임아웃이 발생할 때 수행할 작업을 결정합니다. 가능한 값은 RESET: SO_LINGER를 0으로 설정하고 소켓 CLOSE를 재설정합니다. 소켓을 정상적으로 닫는 기본값은 RESET입니다.

CloudEvent 값:

  • RESET
  • CLOSE

RESET

MllpIdleTimeoutStrategy

keepalive ( producer)

SO_KEEPALIVE 소켓 옵션을 활성화/비활성화합니다.

true

부울

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

tcpNoDelay (producer)

TCP_NODELAY 소켓 옵션을 활성화/비활성화합니다.

true

부울

ReadTimeout (advanced)

MLLP 프레임 시작 후 사용된 SO_TIMEOUT 값(밀리초)이 수신되었습니다.

5000

int

receiveBufferSize (advanced)

SO_RCVBUF 옵션을 지정된 값(바이트)으로 설정합니다.

8192

정수

receiveTimeout (advanced)

MLLP 프레임 시작을 기다릴 때 사용되는 SO_TIMEOUT 값(밀리초)입니다.

15000

int

sendBufferSize (advanced)

SO_SNDBUF 옵션을 지정된 값(바이트)으로 설정합니다.

8192

정수

IdleTimeout (tcp)

클라이언트 TCP 연결이 재설정되기 전에 허용되는 대략적인 유휴 시간입니다. null 값 또는 값이 0 이하이면 유휴 타임아웃이 비활성화됩니다.

 

정수

33.4. MLLP Consumer

MLLP 소비자는 MLLP 프레임 메시지 수신 및 HL7 승인을 지원합니다. MLLP 소비자는 HL7 Acknowledgement (HL7 Application Acknowledgements only - AA, AE 및 AR)를 자동으로 생성하거나 CamelMllpAcknowledgement 교환 속성을 사용하여 승인을 지정할 수 있습니다. 또한 CamelMllpAcknowledgementType 교환 속성을 설정하여 생성되는 승인 유형을 제어할 수 있습니다. 자동 승인이 비활성화되고 교환 패턴이 InOnly인 경우 MLLP 소비자는 HL7 Acknowledgement를 전송하지 않고 메시지를 읽을 수 있습니다.

33.4.1. 메시지 헤더

MLLP 소비자는 Camel 메시지에 이러한 헤더를 추가합니다.

설명

CamelMllpLocalAddress

소켓의 로컬 TCP 주소

CamelMllpRemoteAddress

소켓의 로컬 TCP 주소

CamelMllpSendingApplication

MSH-3 값

CamelMllpSendingFacility

MSH-4 값

CamelMllpReceivingApplication

MSH-5 값

CamelMllpReceivingFacility

MSH-6 값

CamelMllpTimestamp

MSH-7 값

CamelMllpSecurity

MSH-8 값

CamelMllpMessageType

MSH-9 값

CamelMllpEventType

MSH-9-1 값

CamelMllpTriggerEvent

MSH-9-2 값

CamelMllpMessageControlId

MSH-10 값

CamelMllpProcessingId

MSH-11 값

CamelMllpVersionId

MSH-12 값

CamelMllpCharset

MSH-18 값

모든 헤더는 문자열 유형입니다. 헤더 값이 없는 경우 해당 값은 null입니다.

33.4.2. 교환 속성

MLLP Consumer가 생성 및 TCP 소켓 상태를 승인하는 유형은 Camel 교환의 이러한 속성에서 제어할 수 있습니다.

유형설명

CamelMllpAcknowledgement

byte[]

해당하는 경우 이 속성은 클라이언트에 MLLP Acknowledgement로 전송됩니다.

CamelMllpAcknowledgementString

문자열

현재 및 CamelMllpAcknowledgement가 없는 경우 이 속성은 클라이언트에 MLLP Acknowledgement로 전송됩니다.

CamelMllpAcknowledgementMsaText

문자열

CamelMllpAcknowledgement 또는 CamelMllpAckedgementString이 모두 있고 autoAck가 true인 경우 이 속성을 사용하여 생성된 HL7 승인에서 MSA-3 내용을 지정할 수 있습니다.

CamelMllpAcknowledgementType

문자열

CamelMllpAcknowledgement 또는 CamelMllpAckedgementString이 모두 있고 autoAck가 true인 경우 이 속성을 사용하여 HL7 승인 유형(예: AA, AE, AR)을 지정할 수 있습니다.

CamelMllpAutoAcknowledge

부울

autoAck 쿼리 매개변수를 덮어씁니다.

CamelMllpCloseConnectionBeforeSend

부울

true인 경우 데이터를 보내기 전에 소켓이 닫힙니다.

CamelMllpResetConnectionBeforeSend

부울

true인 경우 데이터를 보내기 전에 소켓이 재설정됩니다.

CamelMllpCloseConnectionAfterSend

부울

true인 경우 데이터를 보낸 직후 소켓이 닫힙니다.

CamelMllpResetConnectionAfterSend

부울

true인 경우 소켓은 데이터를 보낸 직후 재설정됩니다.

33.5. MLLP Producer

MLLP Producer는 MLLP 프레임 메시지 전송 및 HL7 승인을 지원합니다. MLLP Producer는 HL7 승인에 대해 질문하고 부정적인 승인을 받으면 예외를 발생시킵니다. 수신 된 승인이 교차되고 부정적인 승인이 발생하는 경우 예외가 발생합니다. MLLP Producer는 InOnly 교환 패턴으로 구성된 경우 승인을 무시할 수 있습니다.

33.5.1. 메시지 헤더

MLLP Producer는 Camel 메시지에 이러한 헤더를 추가합니다.

설명

CamelMllpLocalAddress

소켓의 로컬 TCP 주소

CamelMllpRemoteAddress

소켓의 원격 TCP 주소

CamelMllpAcknowledgement

HL7 승인 byte[] 수신

CamelMllpAcknowledgementString

HL7 승인이 접수되었으며 String으로 변환되었습니다.

33.5.2. 교환 속성

TCP 소켓의 상태는 Camel 교환의 다음 속성으로 제어할 수 있습니다.

유형설명

CamelMllpCloseConnectionBeforeSend

부울

true인 경우 데이터를 보내기 전에 소켓이 닫힙니다.

CamelMllpResetConnectionBeforeSend

부울

true인 경우 데이터를 보내기 전에 소켓이 재설정됩니다.

CamelMllpCloseConnectionAfterSend

부울

true인 경우 데이터를 보낸 직후 소켓이 닫힙니다.

CamelMllpResetConnectionAfterSend

부울

true인 경우 소켓은 데이터를 보낸 직후 재설정됩니다.

33.6. Spring Boot Auto-Configuration

Spring Boot와 함께 mllp를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-mllp-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.mllp.accept-timeout

TCP 연결 TCP 서버만 기다리는 동안 시간 초과(밀리초)입니다.

60000

정수

camel.component.mllp.auto-ack

MLLP Acknowledgement MLLP 소비자만 자동 생성을 활성화/비활성화합니다.

true

부울

camel.component.mllp.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.mllp.backlog

들어오는 연결 표시 요청(연결에 대한 요청)의 최대 대기열 길이가 backlog 매개변수로 설정됩니다. 큐가 가득 찼을 때 연결 표시가 도착하면 연결이 거부됩니다.

5

정수

camel.component.mllp.bind-retry-interval

TCP 서버만 - 바인딩 시도 사이에 대기하는 시간(밀리초)입니다.

5000

정수

camel.component.mllp.bind-timeout

TCP 서버만 - 서버 포트에 대한 바인딩을 재시도하는 시간(밀리초)입니다.

30000

정수

camel.component.mllp.bridge-error-handler

소비자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지를 수신하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 비활성화된 경우 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅하여 예외를 처리하고 무시합니다.

true

부울

camel.component.mllp.charset-name

사용할 기본 ownerset를 설정합니다.

 

문자열

camel.component.mllp.configuration

MLLP 엔드포인트를 생성할 때 사용할 기본 구성을 설정합니다. 옵션은 org.apache.camel.component.mllp.MllpConfiguration 유형입니다.

 

MllpConfiguration

camel.component.mllp.connect-timeout

TCP 연결 TCP 클라이언트에만 설정하는 시간 초과(밀리초)입니다.

30000

정수

camel.component.mllp.default-charset

바이트에서/from String 변환에 사용할 기본 문자 집합을 설정합니다.

ISO-8859-1

문자열

camel.component.mllp.enabled

Mllp 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.mllp.exchange-pattern

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

 

ExchangePattern

camel.component.mllp.hl7-headers

HL7 Message MLLP 소비자에서만 메시지 헤더 자동 생성을 활성화/비활성화합니다.

true

부울

camel.component.mllp.idle-timeout

클라이언트 TCP 연결이 재설정되기 전에 허용되는 대략적인 유휴 시간입니다. null 값 또는 값이 0 이하이면 유휴 타임아웃이 비활성화됩니다.

 

정수

camel.component.mllp.idle-timeout-strategy

유휴 상태의 타임아웃이 발생할 때 수행할 작업을 결정합니다. 가능한 값은 RESET: SO_LINGER를 0으로 설정하고 소켓 CLOSE를 재설정합니다. 소켓을 정상적으로 닫는 기본값은 RESET입니다.

 

MllpIdleTimeoutStrategy

camel.component.mllp.keep-alive

SO_KEEPALIVE 소켓 옵션을 활성화/비활성화합니다.

true

부울

camel.component.mllp.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.mllp.lenient-bind

TCP Server만 - TCP ServerSocket가 바인딩되기 전에 끝점이 시작될 수 있습니다. 일부 환경에서는 TCP ServerSocket이 바인딩되기 전에 끝점이 시작되도록 허용하는 것이 바람직할 수 있습니다.

false

부울

camel.component.mllp.log-phi

PHI를 기록할지 여부입니다.

true

부울

camel.component.mllp.log-phi-max-bytes

로그 항목에 로그인할 PHI의 최대 바이트 수를 설정합니다.

5120

정수

camel.component.mllp.max-concurrent-consumers

허용되는 최대 MLLP 소비자 연결 수입니다. 새 연결이 수신되고 최대값이 이미 설정된 경우 새 연결은 즉시 재설정됩니다.

5

정수

camel.component.mllp.read-timeout

MLLP 프레임 시작 후 사용된 SO_TIMEOUT 값(밀리초)이 수신되었습니다.

5000

정수

camel.component.mllp.receive-buffer-size

SO_RCVBUF 옵션을 지정된 값(바이트)으로 설정합니다.

8192

정수

camel.component.mllp.receive-timeout

MLLP 프레임 시작을 기다릴 때 사용되는 SO_TIMEOUT 값(밀리초)입니다.

15000

정수

camel.component.mllp.require-end-of-data

MLLP 표준을 엄격한 준수를 활성화/비활성화합니다. MLLP 표준은 ScanSetting_OF_BLOCK>-<7 payloadEND_OF_BLOCKEND_OF_DATA를 지정하지만 일부 시스템은 최종 END_OF_DATA 바이트를 전송하지 않습니다. 이 설정은 최종 END_OF_DATA 바이트가 필요한지 여부를 제어합니다.

true

부울

camel.component.mllp.reuse-address

SO_REUSEADDR 소켓 옵션을 활성화/비활성화합니다.

false

부울

camel.component.mllp.send-buffer-size

SO_SNDBUF 옵션을 지정된 값(바이트)으로 설정합니다.

8192

정수

camel.component.mllp.string-payload

페이로드를 String으로 변환/비활성화합니다. 활성화된 경우 외부 시스템에서 수신된 HL7 Payloads의 유효성을 검사하면 String으로 변환됩니다. CharsetName 속성이 설정된 경우 해당 문자 집합이 변환에 사용됩니다. tlssetName 속성이 설정되지 않은 경우 MSH-18 값은 적절한 문자 세트를 결정하는 데 사용됩니다. MSH-18이 설정되지 않은 경우 기본 ISO-8859-1 문자 세트가 사용됩니다.

true

부울

camel.component.mllp.tcp-no-delay

TCP_NODELAY 소켓 옵션을 활성화/비활성화합니다.

true

부울

camel.component.mllp.validate-payload

HL7 Payloads의 유효성을 활성화/비활성화하면 외부 시스템에서 수신된 HL7 Payloads의 유효성이 검증됩니다(Validation에 대한 자세한 내용은 Hl7Util.generateInvalidPayloadExceptionMessage 참조). 및 유효하지 않은 페이로드가 감지되면 MllpInvalidMessageException(고객용) 또는 MllpInvalidAcknowledgementException이 발생합니다.

false

부울

34장. mock

프로듀서만 지원됩니다.

분산 및 비동기 처리 테스트는 크게 어렵습니다. MockTestDataset 엔드포인트는 Camel 테스트 프레임워크와 함께 강력한 Integration Patterns 와 Camel의 다양한 구성 요소와 함께 장치 및 통합 테스트를 단순화합니다.

Mock 구성 요소는 테스트를 시작하기 전에 모든 Mock 끝점에서 선언적 기대치를 만들 수 있다는 점에서 jMock 과 유사한 강력한 선언적 테스트 메커니즘을 제공합니다. 그러면 테스트가 실행되어 일반적으로 하나 이상의 엔드포인트에 메시지를 실행하며 마지막으로 테스트 케이스에서 예상을 어설션하여 시스템이 예상대로 작동하는지 확인할 수 있습니다.

이렇게 하면 다음과 같은 다양한 테스트를 수행할 수 있습니다.

참고

Test 끝점은 Mock 끝점 이지만 두 번째 끝점을 사용하여 예상 메시지 본문 목록을 제공하고 Mock 끝점 어설션을 자동으로 설정합니다. 즉, 파일 또는 데이터베이스 의 일부 샘플 메시지에서 어설션을 자동으로 설정하는 Mock 끝점입니다.

참고

모크 끝점은 메모리에서 수신되는 교환을 무기한 유지합니다.
Mock은 테스트를 위해 설계되었습니다. 경로에 Mock 끝점을 추가하면 명시적으로 재설정하거나 JVM이 다시 시작될 때까지 끝점으로 전송된 각 Exchange가 메모리에 저장됩니다. 대량 및/또는 큰 메시지를 보내는 경우 과도한 메모리 사용이 발생할 수 있습니다. 배포 가능한 경로를 인라인으로 테스트하는 것이 목표인 경우 Mock 엔드포인트를 직접 경로에 추가하는 대신 NotifyBuilder 또는 AdviceWith를 테스트에서 사용하는 것이 좋습니다. 새로운 옵션은 두 가지이며, Mock 끝점이 메모리에 유지하는 메시지 수를 제한하는 데 사용할 수 있는 retainLast와 retainLast가 있습니다.

34.1. URI 형식

mock:someName[?options]

여기서 someName 은 끝점을 고유하게 식별하는 문자열일 수 있습니다.

34.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

34.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

34.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

34.3. 구성 요소 옵션

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

이름설명Default유형

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

로그 (producer)

mock에서 수신되는 메시지를 수신할 때 로깅을 켜려면 다음을 수행합니다. 이렇게 하면 들어오는 메시지에 대해 INFO 수준에서 한 번만 로깅됩니다. 보다 자세한 로깅을 위해 로거를 org.apache.camel.component.mock.MockEndpoint 클래스의 DEBUG 수준으로 설정합니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

exchangeFormatter (advanced)

자동 연결 ( Autowired ) Sets a custom ExchangeFormatter to convert the Exchange to a String suitable for logging. 지정하지 않으면 DefaultExchangeFormatter로 기본 설정됩니다.

 

ExchangeFormatter

34.4. 끝점 옵션

Mock 끝점은 URI 구문을 사용하여 구성됩니다.

mock:name

다음과 같은 경로 및 쿼리 매개변수 사용:

34.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

이름 (producer)

mock 끝점의 이름입니다.

 

문자열

34.4.2. 쿼리 매개변수 (12 매개변수)

이름설명Default유형

assertPeriod (producer)

임시 어설션이 계속 유효한지 확인하기 위해 모의 엔드포인트가 다시 평가되는 유예 기간을 설정합니다. 예를 들어, 이 값을 사용하여 정확히 여러 메시지가 수신되도록 어설션합니다. 예를 들어 expectedMessageCount(int)가 5로 설정된 경우 5개 이상의 메시지가 도달하면 어설션이 충족됩니다. 정확히 5 개의 메시지가 표시되도록하려면 추가 메시지가 도착하지 않도록 잠시 기다려야합니다. 이 방법을 사용할 수 있는 방법은 다음과 같습니다. 기본적으로 이 기간은 비활성화되어 있습니다.

 

long

expectedCount (producer)

이 끝점에서 수신해야 하는 예상되는 메시지 교환 수를 지정합니다. 참고: 0 개의 메시지를 예상하려면 테스트가 시작될 때 0과 일치하여 추가 주의를 기울이십시오. 따라서 테스트 실행을 위해 잠시 동안 테스트 실행 시간을 설정해야합니다. 메시지가 여전히 도착하지 않도록하려면 setAssertPeriod(long)를 사용합니다. 대안으로 NotifyBuilder를 사용하고 mocks에서 assertIsSatisfied() 메서드를 호출하기 전에 Camel이 일부 메시지를 라우팅할 시기를 알 수 있습니다. 이를 통해 테스트 시간을 단축하기 위해 고정된 어설션 기간을 사용하지 않을 수 있습니다. 정확히 n'th 메시지가 이 mock 끝점에 도달하는 것을 어설션하려면 자세한 내용은 setAssertPeriod(long) 메서드를 참조하십시오.

-1

int

failFast (producer)

"Assatisatisfied()"가 첫 번째 탐지된 실패 기대치에서 빠르게 실패해야 하는지 여부를 설정하지만, 기대치 확인을 수행하기 전에 예상되는 모든 메시지가 도달할 때까지 기다릴 수 있습니다. 기본적으로 true입니다. Camel 2.x에서와 같이 동작을 사용하려면 false로 설정합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

로그 (producer)

mock에서 수신되는 메시지를 수신할 때 로깅을 켜려면 다음을 수행합니다. 이렇게 하면 들어오는 메시지에 대해 INFO 수준에서 한 번만 로깅됩니다. 보다 자세한 로깅을 위해 로거를 org.apache.camel.component.mock.MockEndpoint 클래스의 DEBUG 수준으로 설정합니다.

false

boolean

reportGroup (producer)

크기 그룹을 기반으로 처리량 로깅을 설정하는 데 사용되는 번호입니다.

 

int

resultMinimumWaitTime (producer)

millis의 예상 최소 시간(밀리초)을 설정합니다. assertIsSatisfied()가 충족될 때까지 래치에서 대기합니다.

 

long

ResultWaitTime (producer)

최대 시간(밀리초)을 설정합니다. assertIsSatisfied()가 충족될 때까지 래치에서 대기합니다.

 

long

retainFirst (producer)

수신한 첫 번째 n'th Exchange 수만 유지하도록 지정합니다. 이는 모든 Exchange의 복사본을 저장하지 않고 메모리 소비를 줄이기 위해 큰 데이터로 테스트할 때 이 모크 끝점이 수신합니다. 중요: 이 제한을 사용하면 getReceivedCounter()는 실제 수신된 Exchange 수를 반환합니다. 예를 들어 처음 10개의 교환만 보유하도록 구성된 경우 getReceivedCounter()는 여전히 5000을 반환하지만 getExchanges() 및 getReceivedExchanges() 메서드의 처음 10개 교환만 존재합니다. 이 방법을 사용할 때 다른 예상 방법 중 일부는 지원되지 않습니다. 예를 들어 expectedBodiesReceived(Object…​)는 수신된 첫 번째 수에 대한 기대치를 설정합니다. setRetainFirst(int) 및 setRetainLast(int) 메서드를 구성하여 첫 번째 수신한과 마지막을 모두 제한할 수 있습니다.

-1

int

retainLast (producer)

수신 된 마지막 n'th의 수만 유지하도록 지정합니다. 이는 모든 Exchange의 복사본을 저장하지 않고 메모리 소비를 줄이기 위해 큰 데이터로 테스트할 때 이 모크 끝점이 수신합니다. 중요: 이 제한을 사용하면 getReceivedCounter()는 실제 수신된 Exchange 수를 반환합니다. 예를 들어, 최근 20개의 교환만 보유하도록 구성된 경우 getReceivedCounter()는 여전히 5000을 반환하지만 getExchanges() 및 getReceivedExchanges() 메서드에는 마지막 20개 교환만 존재합니다. 이 방법을 사용할 때 다른 예상 방법 중 일부는 지원되지 않습니다. 예를 들어 expectedBodiesReceived(Object…​)는 수신된 첫 번째 수에 대한 기대치를 설정합니다. setRetainFirst(int) 및 setRetainLast(int) 메서드를 구성하여 첫 번째 수신한과 마지막을 모두 제한할 수 있습니다.

-1

int

sleepForEmptyTest (producer)

이 엔드포인트가 실제로 0으로 호출될 때 expectedMessageCount(int)가 비어 있는지 확인하기 위해 대기하도록 sleep을 지정할 수 있습니다.

 

long

copyOnExchange (생성자(고급))

이 mock 끝점에서 수신될 때 들어오는 교환의 깊은 사본을 만들지 여부를 설정합니다. 기본적으로 true입니다.

true

boolean

34.5. 간단한 예

다음은 사용 중인 Mock 끝점의 간단한 예입니다. 먼저 컨텍스트에서 끝점이 확인됩니다. 그런 다음 테스트가 실행된 후 우리의 기대가 충족되었다고 주장합니다.

MockEndpoint resultEndpoint = context.getEndpoint("mock:foo", MockEndpoint.class);

// set expectations
resultEndpoint.expectedMessageCount(2);

// send some messages

// now lets assert that the mock:foo endpoint received 2 messages
resultEndpoint.assertIsSatisfied();

일반적으로 테스트를 실행한 후 예상이 충족되었는지 테스트하는 메서드를 항상 호출합니다.

Camel은 assertIsSatisfied() 가 호출될 때 기본적으로 10초 동안 기다립니다. setResultWaitTime(millis) 메서드를 설정하여 구성할 수 있습니다.

34.6. assertPeriod 사용

어설션이 충족되면 Camel은 대기를 중지하고 assertIsSatisfied 방법을 계속 진행합니다. 즉, 약간 나중에 새로운 메시지가 모크 끝점에 도달하면 도착은 주장의 결과에 영향을 미치지 않습니다. 그 후 일정 기간 후에 새 메시지가 도착하지 않도록 테스트하려는 경우 setAssertPeriod 메서드를 설정하여 이를 수행할 수 있습니다. 예를 들면 다음과 같습니다.

MockEndpoint resultEndpoint = context.getEndpoint("mock:foo", MockEndpoint.class);
resultEndpoint.setAssertPeriod(5000);
resultEndpoint.expectedMessageCount(2);

// send some messages

// now lets assert that the mock:foo endpoint received 2 messages
resultEndpoint.assertIsSatisfied();

34.7. 예상 설정

이제 MockEndpoint 의 Javadoc에서 기대치를 설정하는 데 사용할 수 있는 다양한 도우미 방법을 확인할 수 있습니다. 주요 방법은 다음과 같습니다.

방법설명

expectedMessageCount(int)

끝점에서 예상되는 메시지 수를 정의하려면 다음을 수행합니다.

expectedMinimumMessageCount(int)

끝점에서 최소 예상 메시지 수를 정의하려면 다음을 수행합니다.

expectedBodiesReceived(…​)

수신해야 하는 예상되는 본문을 정의하려면 다음을 수행합니다.

expectedHeaderReceived(…​)

수신해야 하는 예상 헤더를 정의하려면 다음을 수행합니다.

expectsAscending(Expression)

지정된 표현식을 사용하여 메시지를 순서대로 비교하면 메시지가 수신될 것으로 예상합니다.

expectDescending(Expression)

지정된 표현식을 사용하여 메시지를 순서대로 비교하면 메시지가 수신될 것으로 예상합니다.

expectsNoDuplicates(Expression)

중복 메시지가 수신되지 않을 것으로 예상하려면 표현식을 사용하여 각 메시지의 고유 식별자를 계산합니다. JMS를 사용하는 경우 JMS 또는 메시지 내의 고유한 참조 번호와 같은 것일 수 있습니다.

또 다른 예는 다음과 같습니다.

resultEndpoint.expectedBodiesReceived("firstMessageBody", "secondMessageBody", "thirdMessageBody");

34.8. 특정 메시지에 기대치 추가

또한 message(int messageIndex) 메서드를 사용하여 수신되는 특정 메시지에 대한 어설션을 추가할 수 있습니다.

예를 들어 첫 번째 메시지의 헤더 또는 본문에 대한 기대치를 추가하려면(Java .util.List와 같은 제로 기반 인덱싱을 사용하여) 다음 코드를 사용할 수 있습니다.

resultEndpoint.message(0).header("foo").isEqualTo("bar");

camel-core 프로세서 테스트에서 사용되는 Mock 끝점의 몇 가지 예가 있습니다.

34.9. 기존 끝점 검색

Camel을 사용하면 Camel 경로의 기존 엔드포인트를 자동으로 사용할 수 있습니다.

참고

어떻게 작동하는지
엔드 포인트가 여전히 작동 중입니다. 다르게 발생하는 것은 Mock 끝점이 삽입되고 메시지를 먼저 수신한 다음 메시지를 대상 끝점에 위임하는 것입니다. 이를 일종의 인터셉트 및 위임 또는 끝점 리스너로 볼 수 있습니다.

아래 지정된 경로가 있다고 가정합니다.

경로

    @Override
    protected RouteBuilder createRouteBuilder() throws Exception {
        return new RouteBuilder() {
            @Override
            public void configure() throws Exception {
                from("direct:start").routeId("start")
                        .to("direct:foo").to("log:foo").to("mock:result");

                from("direct:foo").routeId("foo")
                        .transform(constant("Bye World"));
            }
        };
    }

그런 다음 Camel의 adviceWith 기능을 사용하여 다음과 같이 단위 테스트에서 지정된 경로에 있는 모든 엔드포인트를 모를 수 있습니다.

모든 엔드 포인트를 조작할 때 advicewith mocking

    @Test
    public void testAdvisedMockEndpoints() throws Exception {
        // advice the start route using the inlined AdviceWith lambda style route builder
        // which has extended capabilities than the regular route builder
        AdviceWith.adviceWith(context, "start", a ->
        // mock all endpoints
        a.mockEndpoints());

        getMockEndpoint("mock:direct:start").expectedBodiesReceived("Hello World");
        getMockEndpoint("mock:direct:foo").expectedBodiesReceived("Hello World");
        getMockEndpoint("mock:log:foo").expectedBodiesReceived("Bye World");
        getMockEndpoint("mock:result").expectedBodiesReceived("Bye World");

        template.sendBody("direct:start", "Hello World");

        assertMockEndpointsSatisfied();

        // additional test to ensure correct endpoints in registry
        assertNotNull(context.hasEndpoint("direct:start"));
        assertNotNull(context.hasEndpoint("direct:foo"));
        assertNotNull(context.hasEndpoint("log:foo"));
        assertNotNull(context.hasEndpoint("mock:result"));
        // all the endpoints was mocked
        assertNotNull(context.hasEndpoint("mock:direct:start"));
        assertNotNull(context.hasEndpoint("mock:direct:foo"));
        assertNotNull(context.hasEndpoint("mock:log:foo"));
    }

mock 끝점에는 URI mock:<endpoint >가 지정됩니다(예: mock:direct:foo ). INFO 의 Camel 로그는 변조되는 끝점의 수준입니다.

INFO  Adviced endpoint [direct://foo] with mock endpoint [mock:direct:foo]
참고

모의 끝점에는 매개 변수가 없는
엔드 포인트의 매개 변수가 제거됩니다. 예를 들어 끝점 log:foo?showAll=true 는 다음 끝점 mock:log:foo 로 호출됩니다. 매개 변수가 제거되었습니다.

또한 패턴을 사용하여 특정 끝점을 변조할 수도 있습니다. 예를 들어 다음과 같이 수행하는 모든 로그 끝점을 추출하려면 다음을 수행합니다.

adviceWith mocking 패턴을 사용하여 끝점만 기록

    @Test
    public void testAdvisedMockEndpointsWithPattern() throws Exception {
        // advice the start route using the inlined AdviceWith lambda style route builder
        // which has extended capabilities than the regular route builder
        AdviceWith.adviceWith(context, "start", a ->
        // mock only log endpoints
        a.mockEndpoints("log*"));

        // now we can refer to log:foo as a mock and set our expectations
        getMockEndpoint("mock:log:foo").expectedBodiesReceived("Bye World");

        getMockEndpoint("mock:result").expectedBodiesReceived("Bye World");

        template.sendBody("direct:start", "Hello World");

        assertMockEndpointsSatisfied();

        // additional test to ensure correct endpoints in registry
        assertNotNull(context.hasEndpoint("direct:start"));
        assertNotNull(context.hasEndpoint("direct:foo"));
        assertNotNull(context.hasEndpoint("log:foo"));
        assertNotNull(context.hasEndpoint("mock:result"));
        // only the log:foo endpoint was mocked
        assertNotNull(context.hasEndpoint("mock:log:foo"));
        assertNull(context.hasEndpoint("mock:direct:start"));
        assertNull(context.hasEndpoint("mock:direct:foo"));
    }

지원되는 패턴은 와일드카드 또는 정규식일 수 있습니다. Camel에서 사용하는 것과 동일한 일치 기능으로 Intercept에 대한 자세한 내용은 Intercept에서 참조하십시오.

참고

mocking 끝점은 mock에 도달하면 메시지가 복사되도록 합니다.
따라서 Camel이 더 많은 메모리를 사용하게 됩니다. 이 방법은 많은 메시지를 보낼 때 적합하지 않을 수 있습니다.

34.10. camel-test 구성 요소를 사용하여 기존 끝점 병합

Camel에 mock 엔드포인트에 지시하는 것이 아니라 camel-test Test Kit를 사용할 때 이러한 동작을 쉽게 활성화할 수 있습니다.

동일한 경로를 다음과 같이 테스트할 수 있습니다. isMockEndpoints 메서드에서 "*" 를 반환하는데, 이는 Camel이 모든 엔드포인트를 모스크하도록 지시합니다.

모든 로그 끝점을 모방하려면 대신 " log *" 를 반환할 수 있습니다.

isMockEndpoints using camel-test Kit

public class IsMockEndpointsJUnit4Test extends CamelTestSupport {

    @Override
    public String isMockEndpoints() {
        // override this method and return the pattern for which endpoints to mock.
        // use * to indicate all
        return "*";
    }

    @Test
    public void testMockAllEndpoints() throws Exception {
        // notice we have automatic mocked all endpoints and the name of the endpoints is "mock:uri"
        getMockEndpoint("mock:direct:start").expectedBodiesReceived("Hello World");
        getMockEndpoint("mock:direct:foo").expectedBodiesReceived("Hello World");
        getMockEndpoint("mock:log:foo").expectedBodiesReceived("Bye World");
        getMockEndpoint("mock:result").expectedBodiesReceived("Bye World");

        template.sendBody("direct:start", "Hello World");

        assertMockEndpointsSatisfied();

        // additional test to ensure correct endpoints in registry
        assertNotNull(context.hasEndpoint("direct:start"));
        assertNotNull(context.hasEndpoint("direct:foo"));
        assertNotNull(context.hasEndpoint("log:foo"));
        assertNotNull(context.hasEndpoint("mock:result"));
        // all the endpoints was mocked
        assertNotNull(context.hasEndpoint("mock:direct:start"));
        assertNotNull(context.hasEndpoint("mock:direct:foo"));
        assertNotNull(context.hasEndpoint("mock:log:foo"));
    }

    @Override
    protected RouteBuilder createRouteBuilder() throws Exception {
        return new RouteBuilder() {
            @Override
            public void configure() throws Exception {
                from("direct:start").to("direct:foo").to("log:foo").to("mock:result");

                from("direct:foo").transform(constant("Bye World"));
            }
        };
    }
}

34.11. XML DSL을 사용하여 기존 끝점 처리

위에 표시된 대로 unit testing에 camel-test 구성 요소를 사용하지 않는 경우 경로에 XML 파일을 사용할 때 다른 접근 방식을 사용할 수 있습니다.
솔루션은 단위 테스트에서 사용하는 새 XML 파일을 만든 다음 테스트할 경로가 있는 XML 파일을 포함하는 것입니다.

camel-route.xml 파일에 경로가 있다고 가정합니다.

camel-route.xml

    <!-- this camel route is in the camel-route.xml file -->
    <camelContext xmlns="http://camel.apache.org/schema/spring">

        <route>
            <from uri="direct:start"/>
            <to uri="direct:foo"/>
            <to uri="log:foo"/>
            <to uri="mock:result"/>
        </route>

        <route>
            <from uri="direct:foo"/>
            <transform>
                <constant>Bye World</constant>
            </transform>
        </route>

    </camelContext>

그런 다음 새 XML 파일을 다음과 같이 생성합니다. 여기에는 camel-route.xml 파일을 포함하고 org.apache.camel.impl.InterceptSendSendToMockEndpointStrategy 클래스를 사용하여 Spring space를 정의하는 다음과 같이 새 XML 파일을 생성합니다.

test-camel-route.xml

    <!-- the Camel route is defined in another XML file -->
    <import resource="camel-route.xml"/>

    <!-- bean which enables mocking all endpoints -->
    <bean id="mockAllEndpoints" class="org.apache.camel.component.mock.InterceptSendToMockEndpointStrategy"/>

그러면 단위 테스트에서 camel-route.xml 대신 새 XML 파일(test-camel-route.xml)을 로드합니다.

모든 Log 엔드포인트만 모방하려면 console의 생성자에 패턴을 정의할 수 있습니다.

<bean id="mockAllEndpoints" class="org.apache.camel.impl.InterceptSendToMockEndpointStrategy">
    <constructor-arg index="0" value="log*"/>
</bean>

34.12. 끝점을 변조하고 원래 끝점으로 전송을 건너뜁니다.

경우에 따라 쉽게 모크를 사용하고 특정 끝점으로 전송을 건너 뛰기를 원할 수 있습니다. 따라서 이 메시지는 추론되어 mock 엔드포인트에만 전송됩니다. 이제 AdviceWith를 사용하여 mockEndpointsAndSkip 방법을 사용할 수 있습니다. 아래 예제는 두 끝점 "direct:foo""direct:bar" 로 전송을 건너뜁니다.

adviceWith mock 및 끝점으로 전송을 건너뜁니다.

    @Test
    public void testAdvisedMockEndpointsWithSkip() throws Exception {
        // advice the first route using the inlined AdviceWith route builder
        // which has extended capabilities than the regular route builder
        AdviceWith.adviceWith(context.getRouteDefinitions().get(0), context, new AdviceWithRouteBuilder() {
            @Override
            public void configure() throws Exception {
                // mock sending to direct:foo and direct:bar and skip send to it
                mockEndpointsAndSkip("direct:foo", "direct:bar");
            }
        });

        getMockEndpoint("mock:result").expectedBodiesReceived("Hello World");
        getMockEndpoint("mock:direct:foo").expectedMessageCount(1);
        getMockEndpoint("mock:direct:bar").expectedMessageCount(1);

        template.sendBody("direct:start", "Hello World");

        assertMockEndpointsSatisfied();

        // the message was not send to the direct:foo route and thus not sent to
        // the seda endpoint
        SedaEndpoint seda = context.getEndpoint("seda:foo", SedaEndpoint.class);
        assertEquals(0, seda.getCurrentQueueSize());
    }

테스트 키트를 사용하는 동일한 예

isMockEndpointsAndSkip using camel-test kit

public class IsMockEndpointsAndSkipJUnit4Test extends CamelTestSupport {

    @Override
    public String isMockEndpointsAndSkip() {
        // override this method and return the pattern for which endpoints to mock,
        // and skip sending to the original endpoint.
        return "direct:foo";
    }

    @Test
    public void testMockEndpointAndSkip() throws Exception {
        // notice we have automatic mocked the direct:foo endpoints and the name of the endpoints is "mock:uri"
        getMockEndpoint("mock:result").expectedBodiesReceived("Hello World");
        getMockEndpoint("mock:direct:foo").expectedMessageCount(1);

        template.sendBody("direct:start", "Hello World");

        assertMockEndpointsSatisfied();

        // the message was not send to the direct:foo route and thus not sent to the seda endpoint
        SedaEndpoint seda = context.getEndpoint("seda:foo", SedaEndpoint.class);
        assertEquals(0, seda.getCurrentQueueSize());
    }

    @Override
    protected RouteBuilder createRouteBuilder() throws Exception {
        return new RouteBuilder() {
            @Override
            public void configure() throws Exception {
                from("direct:start").to("direct:foo").to("mock:result");

                from("direct:foo").transform(constant("Bye World")).to("seda:foo");
            }
        };
    }
}

34.13. 유지할 메시지 수 제한

기본적으로 Mock 끝점은 수신한 모든 Exchange 사본을 보관합니다. 따라서 많은 메시지로 테스트하면 메모리를 사용합니다.
첫 번째 및/또는 마지막 교환의 N'th만 유지하도록 지정하는 데 사용할 수 있는FirstretainLast 두 가지 옵션을 도입했습니다.

예를 들어 아래 코드에서 첫 번째 5 및 마지막 5 교환의 복사본만 유지하려고 합니다.For example, in the code below, we only want to retain a copy of the first 5 and last 5 Exchanges.

  MockEndpoint mock = getMockEndpoint("mock:data");
  mock.setRetainFirst(5);
  mock.setRetainLast(5);
  mock.expectedMessageCount(2000);

  mock.assertIsSatisfied();

이를 사용하는 데는 몇 가지 제한 사항이 있습니다. MockEndpointgetExchanges()getReceivedExchanges() 메서드는 교환의 보존 복사본만 반환합니다. 따라서 위의 예에서 목록에는 10 개의 교환; 첫 번째 5 개 및 마지막 5 개의 교환이 포함됩니다.
retainFirstretainLast 옵션에서도 사용할 수 있는 예상 방법에 제한이 있습니다. 예를 들어 메시지 본문, 헤더 등에 적용되는 expectedXXX 방법은 보존 메시지에서만 작동합니다. 위의 예에서는 10개의 보존 메시지에 대한 기대치만 테스트할 수 있습니다.

34.14. 도착 시간 테스트

Mock 끝점은 메시지의 도착 시간을 교환에 속성으로 저장합니다.

Date time = exchange.getProperty(Exchange.RECEIVED_TIMESTAMP, Date.class);

이 정보를 사용하여 메시지가 모크에 도달한 시기를 알 수 있습니다. 또한 이전 메시지와 다음 메시지가 모크에 도달한 시간 간격을 알 수 있는 기반을 제공합니다. 이를 사용하여 Mock 끝점에서 도착 DSL을 사용하여 기대치를 설정할 수 있습니다.

예를 들어 첫 번째 메시지는 다음에 수행할 수 있을 때까지 0-2초 사이에 도달해야 합니다.

mock.message(0).arrives().noLaterThan(2).seconds().beforeNext();

이를 2차 메시지(0 인덱스 기반)로 정의하면 이전 메시지로부터 0-2초를 넘지 않아야 합니다.

mock.message(1).arrives().noLaterThan(2).seconds().afterPrevious();

둘 사이를 사용하여 하한값을 설정할 수도 있습니다. 예를 들어, 1-4초 사이여야 한다고 가정합니다.

mock.message(1).arrives().between(1, 4).seconds().afterPrevious();

또한 모든 메시지에 대한 기대치를 설정할 수 있습니다. 예를 들어, 이러한 메시지 간의 간격이 최대 1초여야 함을 나타낼 수 있습니다.

mock.allMessages().arrives().noLaterThan(1).seconds().beforeNext();
참고

위의 예에서는 시간 단위로 를 사용하지만 Camel은 밀리초분도 제공합니다.

34.15. Spring Boot Auto-Configuration

Spring Boot와 함께 mock을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-mock-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.mock.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.mock.enabled

mock 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.mock.exchange-formatter

Exchange를 로깅에 적합한 문자열로 변환하는 사용자 지정 ExchangeFormatter를 설정합니다. 지정하지 않으면 DefaultExchangeFormatter로 기본 설정됩니다. 옵션은 org.apache.camel.spi.ExchangeFormatter 유형입니다.

 

ExchangeFormatter

camel.component.mock.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.mock.log

mock에서 수신되는 메시지를 수신할 때 로깅을 켜려면 다음을 수행합니다. 이렇게 하면 들어오는 메시지에 대해 INFO 수준에서 한 번만 로깅됩니다. 보다 자세한 로깅을 위해 로거를 org.apache.camel.component.mock.MockEndpoint 클래스의 DEBUG 수준으로 설정합니다.

false

부울

35장. MongoDB

생산자 및 소비자 모두 지원

WWW에 따르면: "NoSQL은 긴 관계 데이터베이스 및 ACID 보장과 함께 중단되는 비관계형 데이터 저장소 클래스를 촉진하는 이동입니다." NoSQL 솔루션은 지난 몇 년 동안 발전해 왔습니다. 그리고 매우 많이 사용되는 주요 사이트 및 서비스는 이를 광범위하게 사용하여 확장성과 민첩성을 달성하는 것으로 알려져 있습니다.

기본적으로 NoSQL 솔루션은 기존 RDBMS (Relational Database Management Systems)와 다릅니다. 쿼리 언어로 SQL을 사용하지 않고 일반적으로 ACID와 같은 트랜잭션 동작 또는 관계 데이터를 제공하지 않습니다. 대신 유연한 데이터 구조 및 스키마(정확한 스키마가 있는 데이터베이스 테이블의 기존 개념이 삭제됨)라는 개념에 따라 설계되며 상용 하드웨어 및 초고속 처리에서 극단적인 확장성을 제공합니다.

MongoDB는 매우 인기 있는 NoSQL 솔루션이며 camel-mongodb 구성 요소는 Camel과 MongoDB와 통합되어, MongoDB 컬렉션에서 생산자(컬렉션 운영 수행)로 MongoDB 컬렉션과 상호 작용할 수 있습니다.

MongoDB는 문서의 개념을 중심으로 진행되지만 (직접 문서뿐만 아니라 JSON/BSON에서 정의 된 계층적 데이터) 및 컬렉션을 중심으로합니다. 이 구성 요소 페이지에서는 해당 구성 요소 페이지에 대해 잘 알고 있다고 가정합니다. 그렇지 않으면 http://www.mongodb.org/ 을 방문하십시오.

참고

MongoDB Camel 구성 요소는 Mongo Java Driver 4.x를 사용합니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-mongodb</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

35.1. URI 형식

mongodb:connectionBean?database=databaseName&collection=collectionName&operation=operationName[&moreOptions...]

35.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

35.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

35.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

35.3. 구성 요소 옵션

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

이름설명Default유형

mongoConnection (common)

연결에 사용되는 자동 유선 공유 클라이언트입니다. 구성 요소에서 생성된 모든 끝점은 이 연결 클라이언트를 공유합니다.

 

MongoClient

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

35.4. 끝점 옵션

MongoDB 엔드포인트는 URI 구문을 사용하여 구성됩니다.

mongodb:connectionBean

다음과 같은 경로 및 쿼리 매개변수 사용:

35.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

connectionBean (common)

필수 데이터베이스 연결에 필요한 클라이언트를 조회하는 데 사용되는 연결 빈 참조를 설정합니다.

 

문자열

35.4.2. 쿼리 매개변수(27 매개변수)

이름설명Default유형

컬렉션 (common)

이 엔드포인트에 바인딩할 MongoDB 컬렉션의 이름을 설정합니다.

 

문자열

collectionIndex (common)

컬렉션 인덱스(JSON FORMAT : \\{ field1 : order1, field2 : order2})를 설정합니다.

 

문자열

CreateServiceVersion (common)

초기화 중 컬렉션이 없는 경우 컬렉션을 생성합니다. 기본값은 true입니다.

true

boolean

데이터베이스 (공용)

MongoDB 데이터베이스의 이름을 target으로 설정합니다.

 

문자열

호스트 (공용)

host:port 형식의 mongodb 서버의 호스트 주소입니다. 또한 호스트 host1:port1,host2:port2의 쉼표로 구분된 목록으로 두 개 이상의 주소를 사용할 수 있습니다. hosts 매개변수를 지정하면 지정된 connectionBean이 무시됩니다.

 

문자열

mongoConnection (common)

데이터베이스에 연결하기 위해 클라이언트로 사용되는 연결 빈을 설정합니다.

 

MongoClient

작업 (공용)

이 끝점이 MongoDB에 대해 실행할 작업을 설정합니다.

CloudEvent 값:

  • findById
  • findOneByQuery
  • findAll
  • findDistinct
  • insert
  • 저장
  • 업데이트
  • remove
  • bulkWrite
  • 집계
  • getDbStats
  • getColStats
  • count
  • command
 

MongoDbOperation

OutputType (common)

프로듀서의 출력을 선택한 종류 : DocumentList Document 또는 MongoIterable 유형으로 변환합니다. DocumentList 또는 MongoIterable은 findAll 및 집계에 적용됩니다. 문서는 다른 모든 작업에 적용됩니다.

CloudEvent 값:

  • DocumentList
  • 문서
  • Mongocurerable
 

MongoDbOutputType

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

consumerType (consumer)

소비자 유형.

 

문자열

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

cursorRegenerationDelay (advanced)

MongoDB 테일러 커서는 새 데이터가 도달할 때까지 차단됩니다. 새 데이터가 삽입되지 않으면 잠시 후에 MongoDB 서버에서 커서가 자동으로 해제되고 닫힙니다. 필요한 경우 클라이언트가 커서를 다시 생성해야 합니다. 이 값은 새 커서를 가져오기 전에 대기할 시간을 지정하고 시도가 실패하는 경우 다음 시도 전의 기간을 지정합니다. 기본값은 1000ms입니다.

1000

long

dynamicity (advanced)

이 끝점이 들어오는 Exchange 속성에서 대상 데이터베이스 및 컬렉션을 동적으로 해석할지 여부를 설정합니다. 정적 끝점 URI에 지정된 런타임에 데이터베이스 및 컬렉션을 재정의하는 데 사용할 수 있습니다. 성능을 높이기 위해 기본적으로 비활성화되어 있습니다. 이를 활성화하면 최소 성능 저하가 수행됩니다.

false

boolean

ReadPreference (advanced)

MongoDB 클라이언트가 읽기 작업을 복제본 세트 멤버에게 라우팅하는 방법을 구성합니다. 가능한 값은 PRIECDHE, PRIECDHE_PREFERRED,SECONDARY,SECOND_PREFERRED 또는 NECDHEEST입니다.

CloudEvent 값:

  • PRIMARY
  • PRIMARY_PREFERRED
  • 보조
  • SECONDARY_PREFERRED
  • 가장 가까운

PRIMARY

문자열

writeConcern (advanced)

독립 실행형 mongod, replicaset 또는 클러스터에 쓰기 작업을 위해 MongoDB에서 요청된 승인 수준을 사용하여 연결 console을 구성합니다. 가능한 값은 ACKNOWLEDGED, W1, W2, W3, UNACKNOWLEDGED, JOURNALED 또는 MAJORITY입니다.

CloudEvent 값:

  • ACKNOWLEDGED
  • W1
  • W2
  • W3
  • 확인되지 않음
  • 저널링
  • MAJORITY

ACKNOWLEDGED

문자열

writeResultAsHeader (advanced)

쓰기 작업에서는 OUT 메시지 본문으로 WriteResult를 반환하는 대신 IN 메시지를 OUT로 전송하고 WriteResult를 헤더로 연결합니다.

false

boolean

streamFilter (changeStream)

변경 스트림 소비자에 대한 필터 조건입니다.

 

문자열

암호 (보안)

mongodb 연결에 대한 사용자 암호입니다.

 

문자열

사용자 이름 (보안)

mongodb 연결의 사용자 이름입니다.

 

문자열

persistentId (tail)

하나의 테일 추적 컬렉션은 여러 테일러를 위해 여러 추적기를 호스팅할 수 있습니다. 이를 분리하려면 각 추적기마다 고유한 persistentId가 있어야 합니다.

 

문자열

persistentTail>- <ing (tail)

시스템을 다시 시작해도 마지막으로 소비된 메시지를 추적할 수 있는 메커니즘인 영구 테일 추적을 활성화합니다. 다음에 시스템이 가동되면 엔드포인트가 마지막으로 중지된 레코드에서 커서를 복구합니다.

false

boolean

tail 10.0.0.1 (tail)

테일 추적 정보가 유지되는 위치 수집. 지정하지 않으면 MongoDbTail>-<ingConfig#DEFAULT_COLLECTION이 기본적으로 사용됩니다.

 

문자열

tail#177Db (tail)

테일 추적 메커니즘이 유지할 데이터베이스를 나타냅니다. 지정하지 않으면 현재 데이터베이스가 기본적으로 선택됩니다. 동적ity는 활성화된 경우에도 고려되지 않습니다(예: tail tracking 데이터베이스는 이전 엔드포인트 초기화에 따라 달라지지 않습니다.

 

문자열

tail>-<Field (tail)

마지막으로 추적된 값이 배치되는 필드입니다. 지정하지 않으면 MongoDbTail>-<ingConfig#DEFAULT_FIELD가 기본적으로 사용됩니다.

 

문자열

tail>-<IncreasingField (tail)

들어오는 레코드의 상관 관계 필드는 특성을 증가시키고 생성될 때마다 테일링 커서를 배치하는 데 사용됩니다. 커서는 유형 쿼리를 사용하여 생성됨: tail>-<IncreasingField가 lastValue보다 큽니다(지속적 테이크 추적에서 발생할 수 있음). Integer, Date, String 등일 수 있습니다. 참고: 현재 시점에서 점 표기법을 지원하지 않으므로 필드가 문서의 최상위 수준에 있어야 합니다.

 

문자열

35.5. Spring XML에서 데이터베이스 구성

다음 Spring XML에서는 MongoDB 인스턴스에 대한 연결을 정의하는 빈을 생성합니다.

mongo java 드라이버 3부터 WriteConcern 및 readPreference 옵션은 동적으로 수정할 수 없습니다. mongoClient 오브젝트에 정의되어 있습니다.

<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mongo="http://www.springframework.org/schema/data/mongo"
xsi:schemaLocation="http://www.springframework.org/schema/context
      http://www.springframework.org/schema/context/spring-context.xsd
      http://www.springframework.org/schema/data/mongo
      http://www.springframework.org/schema/data/mongo/spring-mongo.xsd
      http://www.springframework.org/schema/beans
      http://www.springframework.org/schema/beans/spring-beans.xsd">

  <mongo:mongo-client id="mongoBean" host="${mongo.url}" port="${mongo.port}" credentials="${mongo.user}:${mongo.pass}@${mongo.dbname}">
    <mongo:client-options write-concern="NORMAL" />
  </mongo:mongo-client>
</beans>

35.6. 샘플 경로

Spring XML에 정의된 다음 경로는 컬렉션에서 getDbStats 작업을 실행합니다.

지정된 컬렉션에 대한 DB 통계 가져오기

<route>
  <from uri="direct:start" />
  <!-- using bean 'mongoBean' defined above -->
  <to uri="mongodb:mongoBean?database=${mongodb.database}&amp;collection=${mongodb.collection}&amp;operation=getDbStats" />
  <to uri="direct:result" />
</route>

35.7. MongoDB 작업 - 생산자 끝점

35.7.1. 쿼리 작업

35.7.1.1. findById

이 작업은 _id 필드가 IN 메시지 본문의 콘텐츠와 일치하는 컬렉션에서 하나의 요소만 검색합니다. 들어오는 오브젝트는 Bson 유형과 동등한 모든 개체일 수 있습니다. http://bsonspec.org/spec.htmlhttp://www.mongodb.org/display/DOCS/Java+Types 를 참조하십시오.

from("direct:findById")
    .to("mongodb:myDb?database=flights&collection=tickets&operation=findById")
    .to("mock:resultFindById");

기본 _id는 Mongo에서 및 ObjectId 유형으로 처리되므로 적절하게 변환해야 할 수 있습니다.

from("direct:findById")
    .convertBodyTo(ObjectId.class)
    .to("mongodb:myDb?database=flights&collection=tickets&operation=findById")
    .to("mock:resultFindById");
참고

선택적 매개 변수를 지원합니다
이 작업은 프로젝션 연산자를 지원합니다. 필드 필터 지정 (프로젝트)을 참조하십시오.

35.7.1.2. findOneByQuery

MongoDB 쿼리 선택기와 일치하는 컬렉션에서 첫 번째 요소를 검색합니다. CamelMongoDbCriteria 헤더가 설정된 경우 해당 값은 쿼리 선택기로 사용됩니다. CamelMongoDbCriteria 헤더가 null 인 경우 IN 메시지 본문이 쿼리 선택기로 사용됩니다. 두 경우 모두 쿼리 선택기는 Bson 또는 Bson (예: JSON 문자열 또는 HashMap) 형식으로 변환 할 수 있어야합니다. 자세한 내용은 유형 변환에서 참조하십시오.

MongoDB 드라이버에서 제공하는 필터를 사용하여 쿼리 선택기를 생성합니다.

35.7.1.3. 쿼리 선택기가 없는 예(컬렉션에서 첫 번째 문서 반환)

from("direct:findOneByQuery")
    .to("mongodb:myDb?database=flights&collection=tickets&operation=findOneByQuery")
    .to("mock:resultFindOneByQuery");

35.7.1.4. 쿼리 선택기가 있는 예(컬렉션에서 첫 번째 일치 문서 반환):

from("direct:findOneByQuery")
    .setHeader(MongoDbConstants.CRITERIA, constant(Filters.eq("name", "Raul Kripalani")))
    .to("mongodb:myDb?database=flights&collection=tickets&operation=findOneByQuery")
    .to("mock:resultFindOneByQuery");
참고

선택적 매개 변수
이 작업은 프로젝션 연산자 및 정렬 절을 지원합니다. sort 절 지정, 필드 필터 지정(프로젝트) 을 참조하십시오.

35.7.1.5. findAll

findAll 작업은 쿼리와 일치하는 모든 문서 또는 전혀 없는 문서를 반환합니다. 이 경우 컬렉션에 포함된 모든 문서가 반환됩니다. 쿼리 오브젝트는 추출된 CamelMongoDbCriteria 헤더 입니다. CamelMongoDbCriteria 헤더가 null인 경우 쿼리 오브젝트가 추출된 메시지 본문입니다. 즉, Bson 유형 Bson 또는 Bson으로 변환할 수 있어야 합니다. JSON 문자열 또는 Hashmap이 될 수 있습니다. 자세한 내용은 유형 변환에서 참조하십시오.

35.7.1.5.1. 쿼리 선택기가 없는 예(컬렉션의 모든 문서 반환)
from("direct:findAll")
    .to("mongodb:myDb?database=flights&collection=tickets&operation=findAll")
    .to("mock:resultFindAll");
35.7.1.5.2. 쿼리 선택기의 예 (컬렉션에서 일치하는 모든 문서 반환)
from("direct:findAll")
    .setHeader(MongoDbConstants.CRITERIA, Filters.eq("name", "Raul Kripalani"))
    .to("mongodb:myDb?database=flights&collection=tickets&operation=findAll")
    .to("mock:resultFindAll");

페이징 및 효율적인 검색은 다음 헤더를 통해 지원됩니다.

헤더 키빠른 상수설명 (MongoDB API doc에서 추출)예상 유형

CamelMongoDbNumToSkip

MongoDbConstants.NUM_TO_SKIP

커서가 시작될 때 지정된 수의 요소를 삭제합니다.

int/Integer

CamelMongoDbLimit

MongoDbConstants.LIMIT

반환된 요소 수를 제한합니다.

int/Integer

CamelMongoDbBatchSize

MongoDbConstants.BATCH_SIZE

하나의 일괄 처리에서 반환된 요소 수를 제한합니다. 일반적으로 커서는 결과 오브젝트의 일괄을 가져와서 로컬에 저장합니다. batchSize가 양수인 경우 검색된 오브젝트의 각 배치 크기를 나타냅니다. 성능을 최적화하고 데이터 전송을 제한하도록 조정할 수 있습니다. batchSize가 음수이면 최대 일괄 처리 크기 제한(일반적으로 4MB) 내에 반환되는 수 오브젝트를 제한하고 커서가 종료됩니다. 예를 들어 batchSize가 -10인 경우 서버는 최대 10개의 문서를 반환하고 4MB에 들어갈 수 있는 문서 수를 반환한 다음 커서를 종료합니다. 이 기능은 문서의 limit()이 최대 크기 내에 들어 있어야 하며 커서 서버 측을 종료하기 위해 요청을 보낼 필요가 없다는 점에 유의하십시오. 커서를 반복한 후 배치 크기를 변경할 수 있으며, 이 경우 다음 배치 검색에 설정이 적용됩니다.

int/Integer

CamelMongoDbAllowDiskUse

MongoDbConstants.ALLOW_DISK_USE

allowDiskUse MongoDB 플래그를 설정합니다. MongoDB Server 4.3.1부터 지원됩니다. 이전 MongoDB Server 버전과 함께 이 헤더를 사용하면 쿼리가 실패할 수 있습니다.

부울/부울

35.7.1.5.3. 옵션 outputType=MongoIterable 및 배치 크기의 예
from("direct:findAll")
    .setHeader(MongoDbConstants.BATCH_SIZE).constant(10)
    .setHeader(MongoDbConstants.CRITERIA, constant(Filters.eq("name", "Raul Kripalani")))
    .to("mongodb:myDb?database=flights&collection=tickets&operation=findAll&outputType=MongoIterable")
    .to("mock:resultFindAll");

또한 findAll 작업은 페이징을 사용하는 경우 결과 페이지를 반복할 수 있도록 다음 OUT 헤더를 반환합니다.

헤더 키빠른 상수설명 (MongoDB API doc에서 추출)데이터 유형

CamelMongoDbResultTotalSize

MongoDbConstants.RESULT_TOTAL_SIZE

쿼리와 일치하는 오브젝트 수입니다. 이 경우 limit/skip이 고려되지 않습니다.

int/Integer

CamelMongoDbResultPageSize

MongoDbConstants.RESULT_PAGE_SIZE

쿼리와 일치하는 오브젝트 수입니다. 이 경우 limit/skip이 고려되지 않습니다.

int/Integer

참고

선택적 매개 변수
이 작업은 프로젝션 연산자 및 정렬 절을 지원합니다. sort 절 지정, 필드 필터 지정(프로젝트) 을 참조하십시오.

35.7.1.6. count

컬렉션의 총 오브젝트 수를 반환하고 OUT 메시지 본문으로 Long을 반환합니다.
다음 예제에서는 "dynamicImagePrepareName" 컬렉션의 레코드 수를 계산합니다. dynamicity가 활성화되는 방식을 확인하고 그 결과 "notableScientists" collection에 대해 작업이 실행되지 않지만 "dynamic>-<Name" 컬렉션에 대해 실행됩니다.

// from("direct:count").to("mongodb:myDb?database=tickets&collection=flights&operation=count&dynamicity=true");
Long result = template.requestBodyAndHeader("direct:count", "irrelevantBody", MongoDbConstants.COLLECTION, "dynamicCollectionName");
assertTrue("Result is not of type Long", result instanceof Long);

쿼리 오브젝트를 제공할 수 있으며, 쿼리 오브젝트가 추출된 CamelMongoDbCriteria 헤더 인 경우 CamelMongoDbCriteria 헤더가 null인 메시지 본문입니다. 즉, Bson 유형 또는 Bson..로 변환 가능해야 하며, 작업은 이 조건과 일치하는 문서 양을 반환합니다.

Document query = ...
Long count = template.requestBodyAndHeader("direct:count", query, MongoDbConstants.COLLECTION, "dynamicCollectionName");

35.7.1.7. 필드 필터 지정(프로젝트)

쿼리 작업은 기본적으로 일치하는 오브젝트 전체(모든 필드 포함)를 반환합니다. 문서가 크고 필드의 하위 집합만 검색해야 하는 경우, 모든 쿼리 작업에서 필드 필터를 지정해야 합니다. 단순히 관련 Bson (또는 유형 convertible을 Bson 으로 설정(예: JSON String, Map 등)으로 설정할 수 있습니다(예: CamelMongoDbFieldsProjection 헤더: MongoDbConstants.FIELDS_PROJECTION ).

다음은 MongoDB 의 프로젝션 을 사용하여 Bson 생성을 단순화하는 예입니다. _id 및 modern Field를 제외한 모든 필드를 검색합니다.

// route: from("direct:findAll").to("mongodb:myDb?database=flights&collection=tickets&operation=findAll")
Bson fieldProjection = Projection.exclude("_id", "boringField");
Object result = template.requestBodyAndHeader("direct:findAll", ObjectUtils.NULL, MongoDbConstants.FIELDS_PROJECTION, fieldProjection);

다음은 MongoDB 의 프로젝션 을 사용하여 Bson 생성을 단순화하는 예입니다. _id 및 modern Field를 제외한 모든 필드를 검색합니다.

// route: from("direct:findAll").to("mongodb:myDb?database=flights&collection=tickets&operation=findAll")
Bson fieldProjection = Projection.exclude("_id", "boringField");
Object result = template.requestBodyAndHeader("direct:findAll", ObjectUtils.NULL, MongoDbConstants.FIELDS_PROJECTION, fieldProjection);

35.7.1.8. sort 절 지정

MongoDB의 정렬을 사용하여 Bson 생성을 단순화하는 특정 필드를 기준으로 컬렉션에서 min/max 레코드를 가져와야 하는 경우가 많습니다. _id 및 modern Field를 제외한 모든 필드를 검색합니다.

// route: from("direct:findAll").to("mongodb:myDb?database=flights&collection=tickets&operation=findAll")
Bson sorts = Sorts.descending("_id");
Object result = template.requestBodyAndHeader("direct:findAll", ObjectUtils.NULL, MongoDbConstants.SORT_BY, sorts);

Camel 경로에서 SORT_BY 헤더는 findOneByQuery 작업과 함께 사용하여 동일한 결과를 얻을 수 있습니다. FIELDS_PROJECTION 헤더도 지정된 경우 작업은 다른 구성 요소로 직접 전달할 수 있는 단일 필드/값 쌍을 반환합니다(예: 매개 변수화된 MyBatisLoadBalancer 쿼리). 이 예제에서는 컬렉션에서 일시적인 최신 문서를 가져와서 documentTimestamp 필드를 기반으로 결과를 단일 필드로 줄이는 방법을 보여줍니다.

.from("direct:someTriggeringEvent")
.setHeader(MongoDbConstants.SORT_BY).constant(Sorts.descending("documentTimestamp"))
.setHeader(MongoDbConstants.FIELDS_PROJECTION).constant(Projection.include("documentTimestamp"))
.setBody().constant("{}")
.to("mongodb:myDb?database=local&collection=myDemoCollection&operation=findOneByQuery")
.to("direct:aMyBatisParameterizedSelect");

35.7.2. create/update 작업

35.7.2.1. insert

IN 메시지 본문에서 가져온 MongoDB 컬렉션에 새 오브젝트를 삽입합니다. 유형 변환은 문서 또는 목록으로 변환하려고 합니다.
두 가지 모드가 지원됩니다. 단일 삽입과 여러 삽입이 지원됩니다. 여러 삽입의 경우 끝점은 모든 유형의 개체 목록, 배열 또는 컬렉션을 예상할 수 있으며 문서 형식으로 변환할 수 있습니다.For multiple insert, the endpoint will expect a List, Array or Collections of objects of any type, as long as they are - or can be converted to - Document. 예제:

from("direct:insert")
    .to("mongodb:myDb?database=flights&collection=tickets&operation=insert");

이 작업은 WriteResult를 반환하고 WriteConcern 또는 invokeGetLastError 옵션의 값에 따라 getLastError() 가 이미 호출되었거나 없는 것입니다. 쓰기 작업의 최종 결과에 액세스하려면 WriteResult 에서 getLastError() 또는 getCachedLastError() 를 호출하여 CommandResult 를 검색해야 합니다. 그러면 CommandResult.ok(), CommandResult.getErrorMessage() 및/또는 CommandResult.getException() 을 호출하여 결과를 확인할 수 있습니다.

새 개체의 _id 는 컬렉션에서 고유해야 합니다. 값을 지정하지 않으면 MongoDB에서 자동으로 값을 생성합니다. 그러나 지정하지 않고 고유하지 않으면 삽입 작업이 실패합니다(및 Camel에서 알아두려면 invokeGetLastError를 활성화하거나 쓰기 결과를 기다리는 WriteConcern을 설정해야 합니다).

이는 구성 요소의 제한 사항은 아니지만 더 높은 처리량을 위해 MongoDB에서 작동하는 방법입니다. 사용자 지정 _id 를 사용하는 경우 애플리케이션 수준에서 고유한 애플리케이션 수준을 확인해야 합니다.

삽입된 레코드의 OID는 CamelMongoOid 키(MongoDbConstants.OID 상수) 아래의 메시지 헤더에 저장됩니다. 저장된 값은 단일 삽입의 경우 org.bson.types.ObjectId 로, 여러 레코드가 삽입된 경우 java.util.List<org.bson.types.ObjectId >입니다.

MongoDB Java Driver 3.x에서 insertOne 및 insertMany 작업 반환 void입니다. Camel 삽입 작업에서는 문서 또는 문서 목록 삽입을 반환합니다. 필요한 경우 각 문서가 새 OID에 의해 업데이트됩니다.

35.7.2.2. 저장

저장 작업은 upsert (UPdate, inSERT) 작업과 동일합니다. 여기서 레코드가 업데이트되고 존재하지 않으면 단일 원자 작업으로 삽입됩니다. MongoDB는 _id 필드를 기반으로 일치를 수행합니다.

업데이트의 경우 오브젝트가 전체적으로 교체되고 MongoDB의 $modifiers 사용은 허용되지 않습니다. 따라서 개체가 이미 존재하는 경우 다음 두 가지 옵션이 있습니다.

  1. 쿼리를 수행하여 모든 필드(효율적이지 않을 수 없음)와 함께 전체 오브젝트를 검색하고 Camel 내부에서 변경한 후 저장합니다.
  2. 대신 서버 측에서 업데이트를 실행할 $modifiers 와 함께 업데이트 작업을 사용합니다. upsert 플래그를 활성화할 수 있습니다. 이 경우 삽입이 필요한 경우 MongoDB는 $modifiers를 filter 쿼리 오브젝트에 적용하여 결과를 삽입합니다.

저장할 문서에 _id 속성이 포함되어 있지 않으면 작업이 삽입되고 생성된 새 _idCamelMongoOid 헤더에 배치됩니다.

예를 들면 다음과 같습니다.

from("direct:insert")
    .to("mongodb:myDb?database=flights&collection=tickets&operation=save");
// route: from("direct:insert").to("mongodb:myDb?database=flights&collection=tickets&operation=save");
org.bson.Document docForSave = new org.bson.Document();
docForSave.put("key", "value");
Object result = template.requestBody("direct:insert", docForSave);

35.7.2.3. 업데이트

컬렉션에서 하나 이상의 레코드를 업데이트합니다. 필터 쿼리 및 업데이트 규칙이 필요합니다.

MongoDBConstants.CRITERIA 헤더를 사용하여 필터를 Bson 으로 정의하고 update 규칙을 body에서 Bson 으로 정의할 수 있습니다.

참고

업데이트를 수행하기 전에 MongoDBConstants.CRITERIA 헤더를 Bson 으로 사용하여 필터를 정의한 후업데이트하기 전에 집계 패턴을 사용한 다음 mongodb 업데이트를 적용하는 경우 집계 중에 결과 camel 교환에서 제거해야 합니다.
mongodb 생산자 엔드포인트에 카밀리를 보내기 전에 통합 및/또는 MongoDBConstants.CRITERIA 헤더를 집계 중 이 헤더를 제거하지 않으면 mongodb를 업데이트하는 동안 camel exchange payload를 사용할 수 있습니다.

두 번째 방법은 List<Bson>을 정확히 2개의 요소를 포함하는 IN 메시지 본문으로 필요합니다.

  • 요소 1(index 0) ECDHE 필터 쿼리 ECDHE 필터 쿼리는 일반적인 쿼리 오브젝트와 같이 영향을 받을 오브젝트를 결정합니다.
  • 요소 2(인덱스는 1) 일치하는 오브젝트가 업데이트되는 방식을 업데이트합니다. MongoDB의 모든 수정자 작업이 지원됩니다.
참고

Multiupdates
기본적으로, MongoDB는 여러 오브젝트가 필터 쿼리와 일치하는 경우에도 하나의 오브젝트만 업데이트합니다. MongoDB에서 일치하는 모든 레코드를 업데이트하도록 지정하려면 CamelMongoDbMultiUpdate IN 메시지 헤더를 true 로 설정합니다.

CamelMongoDbRecordsAffected 키가 있는 헤더가 반환됩니다(MongoDbConstants.RECORDS_AFFECTED ) 레코드 수가 업데이트됨( WriteResult.getN()에서 복사됨).

다음 IN 메시지 헤더를 지원합니다.

헤더 키빠른 상수설명 (MongoDB API doc에서 추출)예상 유형

CamelMongoDbMultiUpdate

MongoDbConstants.MULTIUPDATE

업데이트가 일치하는 모든 오브젝트에 적용해야 하는 경우 http://www.mongodb.org/display/DOCS/Atomic+Operations을 참조하십시오.

부울/부울

CamelMongoDbUpsert

MongoDbConstants.UPSERT

데이터베이스가 존재하지 않는 경우 해당 요소를 생성해야 하는 경우

부울/부울

예를 들어, 다음에서는 "scientist" 필드의 값을 "Darwin"으로 설정하여 filterField 필드가 true인 모든 레코드를 업데이트합니다.

// route: from("direct:update").to("mongodb:myDb?database=science&collection=notableScientists&operation=update");
List<Bson> body = new ArrayList<>();
Bson filterField = Filters.eq("filterField", true);
body.add(filterField);
BsonDocument updateObj = new BsonDocument().append("$set", new BsonDocument("scientist", new BsonString("Darwin")));
body.add(updateObj);
Object result = template.requestBodyAndHeader("direct:update", body, MongoDbConstants.MULTIUPDATE, true);
// route: from("direct:update").to("mongodb:myDb?database=science&collection=notableScientists&operation=update");
Maps<String, Object> headers = new HashMap<>(2);
headers.add(MongoDbConstants.MULTIUPDATE, true);
headers.add(MongoDbConstants.FIELDS_FILTER, Filters.eq("filterField", true));
String updateObj = Updates.set("scientist", "Darwin");;
Object result = template.requestBodyAndHeaders("direct:update", updateObj, headers);
// route: from("direct:update").to("mongodb:myDb?database=science&collection=notableScientists&operation=update");
String updateObj = "[{\"filterField\": true}, {\"$set\", {\"scientist\", \"Darwin\"}}]";
Object result = template.requestBodyAndHeader("direct:update", updateObj, MongoDbConstants.MULTIUPDATE, true);

35.7.3. 삭제 작업

35.7.3.1. remove

컬렉션에서 일치하는 레코드를 제거합니다. IN 메시지 본문은 제거 필터 쿼리 역할을 하며 DBObject 유형 또는 변환 가능한 유형이 될 것으로 예상됩니다.
다음 예제에서는 과학 데이터베이스, notableScientists 컬렉션에서 필드 'conditionField'가 true인 모든 개체를 제거합니다.

// route: from("direct:remove").to("mongodb:myDb?database=science&collection=notableScientists&operation=remove");
Bson conditionField = Filters.eq("conditionField", true);
Object result = template.requestBody("direct:remove", conditionField);

CamelMongoDbRecordsAffected 키가 있는 헤더가 반환됨(MongoDbConstants.RECORDS_AFFECTED 상수) 유형 int. 여기에는 삭제된 레코드 수가 포함됩니다( WriteResult.getN()).

35.7.4. 대규모 쓰기 작업

35.7.4.1. bulkWrite

실행 순서에 대한 제어와 함께 쓰기 작업을 대규모로 수행합니다. List<WriteModel<Document >를 삽입, 업데이트 및 삭제 작업을 위한 명령이 포함된 IN 메시지 본문으로 필요합니다.

다음 예제에서는 "scientist" 필드의 값을 "Marie Curie"로 설정하고 ID "3"로 레코드가 삭제되어 ID "5"로 새ers "Pierre Curie"를 추가합니다.

// route: from("direct:bulkWrite").to("mongodb:myDb?database=science&collection=notableScientists&operation=bulkWrite");
List<WriteModel<Document>> bulkOperations = Arrays.asList(
            new InsertOneModel<>(new Document("scientist", "Pierre Curie")),
            new UpdateOneModel<>(new Document("_id", "5"),
                                 new Document("$set", new Document("scientist", "Marie Curie"))),
            new DeleteOneModel<>(new Document("_id", "3")));

BulkWriteResult result = template.requestBody("direct:bulkWrite", bulkOperations, BulkWriteResult.class);

기본적으로 작업은 순서대로 실행되며 목록의 나머지 쓰기 작업을 처리하지 않고 첫 번째 쓰기 오류에서 중단됩니다. MongoDB에서 목록의 나머지 쓰기 작업을 계속 처리하도록 지정하려면 CamelMongoDbBulkOrdered IN 메시지 헤더를 false 로 설정합니다. 정렬되지 않은 작업은 병렬로 실행되며 이 동작은 보장되지 않습니다.

헤더 키빠른 상수설명 (MongoDB API doc에서 추출)예상 유형

CamelMongoDbBulkOrdered

MongoDbConstants.BULK_ORDERED

순서가 지정된 작업 또는 순서가 지정되지 않은 작업을 실행합니다. 기본값은 true입니다.

부울/부울

35.7.5. 기타 작업

35.7.5.1. 집계

본문에 포함된 지정된 파이프라인을 사용하여 집계를 수행합니다. 집계는 길고 긴 작업이 될 수 있습니다. 주의해서 사용하십시오.

// route: from("direct:aggregate").to("mongodb:myDb?database=science&collection=notableScientists&operation=aggregate");
List<Bson> aggregate = Arrays.asList(match(or(eq("scientist", "Darwin"), eq("scientist",
        group("$scientist", sum("count", 1)));
from("direct:aggregate")
    .setBody().constant(aggregate)
    .to("mongodb:myDb?database=science&collection=notableScientists&operation=aggregate")
    .to("mock:resultAggregate");

다음 IN 메시지 헤더를 지원합니다.

헤더 키빠른 상수설명 (MongoDB API doc에서 추출)예상 유형

CamelMongoDbBatchSize

MongoDbConstants.BATCH_SIZE

일괄 처리당 반환할 문서 수를 설정합니다.

int/Integer

CamelMongoDbAllowDiskUse

MongoDbConstants.ALLOW_DISK_USE

집계 파이프라인 단계를 사용하여 임시 파일에 데이터를 작성할 수 있습니다.

부울/부울

기본적으로 모든 결과의 목록이 반환됩니다. 결과 크기에 따라 메모리가 많을 수 있습니다. 더 안전한 대안은 outputType=MongoIterable을 설정하는 것입니다. 다음 프로세서는 메시지 본문에 반복 가능한 항목을 볼 수 있으므로 결과를 하나씩 진행할 수 있습니다. 따라서 배치 크기를 설정하고 iterable을 반환하면 결과를 효율적으로 검색하고 처리할 수 있습니다.

예를 들면 다음과 같습니다.

List<Bson> aggregate = Arrays.asList(match(or(eq("scientist", "Darwin"), eq("scientist",
        group("$scientist", sum("count", 1)));
from("direct:aggregate")
    .setHeader(MongoDbConstants.BATCH_SIZE).constant(10)
    .setBody().constant(aggregate)
    .to("mongodb:myDb?database=science&collection=notableScientists&operation=aggregate&outputType=MongoIterable")
    .split(body())
    .streaming()
    .to("mock:resultAggregate");

.split(body()) 을 호출하면 경로 아래로 항목을 하나씩 보내는 데 충분하지만 모든 항목을 메모리에 먼저 로드합니다. 따라서 .streaming() 을 호출하면 일괄 처리로 데이터를 메모리에 로드해야 합니다.

35.7.5.2. getDbStats

MongoDB 쉘에서 db.stats() 명령을 실행하는 것과 동일하며 데이터베이스에 대한 유용한 통계 수치를 표시합니다.
예를 들면 다음과 같습니다.

> db.stats();
{
    "db" : "test",
    "collections" : 7,
    "objects" : 719,
    "avgObjSize" : 59.73296244784423,
    "dataSize" : 42948,
    "storageSize" : 1000058880,
    "numExtents" : 9,
    "indexes" : 4,
    "indexSize" : 32704,
    "fileSize" : 1275068416,
    "nsSizeMB" : 16,
    "ok" : 1
}

사용법 예:

// from("direct:getDbStats").to("mongodb:myDb?database=flights&collection=tickets&operation=getDbStats");
Object result = template.requestBody("direct:getDbStats", "irrelevantBody");
assertTrue("Result is not of type Document", result instanceof Document);

이 작업은 OUT 메시지 본문에 있는 문서 형태로 쉘에 표시된 것과 유사한 데이터 구조를 반환합니다.

35.7.5.3. getColStats

MongoDB 쉘에서 db.collection.stats() 명령을 실행하는 것과 동일하며 컬렉션에 대한 유용한 통계 수를 표시합니다.
예를 들면 다음과 같습니다.

> db.camelTest.stats();
{
    "ns" : "test.camelTest",
    "count" : 100,
    "size" : 5792,
    "avgObjSize" : 57.92,
    "storageSize" : 20480,
    "numExtents" : 2,
    "nindexes" : 1,
    "lastExtentSize" : 16384,
    "paddingFactor" : 1,
    "flags" : 1,
    "totalIndexSize" : 8176,
    "indexSizes" : {
        "_id_" : 8176
    },
    "ok" : 1
}

사용법 예:

// from("direct:getColStats").to("mongodb:myDb?database=flights&collection=tickets&operation=getColStats");
Object result = template.requestBody("direct:getColStats", "irrelevantBody");
assertTrue("Result is not of type Document", result instanceof Document);

이 작업은 OUT 메시지 본문에 있는 문서 형태로 쉘에 표시된 것과 유사한 데이터 구조를 반환합니다.

35.7.5.4. command

데이터베이스에서 명령으로 본문을 실행합니다. 관리자 작업에 호스트 정보, 복제 또는 샤딩 상태를 가져오는 데 유용합니다.

Collection 매개변수는 이 작업에 사용되지 않습니다.

// route: from("command").to("mongodb:myDb?database=science&operation=command");
DBObject commandBody = new BasicDBObject("hostInfo", "1");
Object result = template.requestBody("direct:command", commandBody);

35.7.6. 동적 작업

Exchange는 MongoDbConstants.OPERATION_HEADER 상수로 정의된 CamelMongoDbOperation 헤더를 설정하여 끝점의 고정 작업을 덮어쓸 수 있습니다.
지원되는 값은 MongoDbOperationForwarded에 의해 결정되며 엔드포인트 URI에서 작업 매개 변수에 대해 허용되는 값과 일치합니다.

예를 들면 다음과 같습니다.

// from("direct:insert").to("mongodb:myDb?database=flights&collection=tickets&operation=insert");
Object result = template.requestBodyAndHeader("direct:insert", "irrelevantBody", MongoDbConstants.OPERATION_HEADER, "count");
assertTrue("Result is not of type Long", result instanceof Long);

35.8. Consumer

다음과 같은 여러 유형의 사용자가 있습니다.

  1. Tailable Cursor Consumer
  2. 스트림 소비자 변경

35.8.1. Tailable Cursor Consumer

MongoDB는 *nix 시스템의 tail -f 명령과 마찬가지로 커서를 열어 두어 컬렉션에서 진행되는 데이터를 즉시 사용할 수 있는 메커니즘을 제공합니다. 이 메커니즘은 서버가 새 데이터를 사용 가능하게 되면 클라이언트에 푸시하는 대신 새 데이터를 예약된 간격으로 다시 ping하여 새 데이터를 가져오기 때문에 예약된 폴링보다 훨씬 효율적입니다. 또한 다른 중복 네트워크 트래픽도 줄일 수 있습니다.

테일러 커서를 사용하는 데 필요한 것은 하나만 있습니다. 즉, 컬렉션은 "케이프된 컬렉션"이어야 합니다. 즉, N 오브젝트만 보유하고 있고 제한에 도달하면 원래 삽입한 순서와 동일한 순서로 MongoDB 플러시를 수행합니다. 자세한 내용은 http://www.mongodb.org/display/DOCS/Tailable+Cursors 에서 참조하십시오.

Camel MongoDB 구성 요소는 테일링 가능한 커서 소비자를 구현하여 Camel 경로에서 이 기능을 사용할 수 있도록 합니다. 새로운 오브젝트가 삽입되면 MongoDB가 문서 로서 문서로 푸시합니다. 이 사용자는 이를 교환으로 변환하고 라우팅 논리를 트리거할 수 있습니다.

35.9. 테일러 커서 소비자의 작동 방식

커서를 테일링 가능 커서로 전환하려면 먼저 커서를 생성할 때 몇 가지 특수 플래그가 MongoDB에 신호를 보낼 수 있습니다. 생성된 후 커서는 열린 상태로 유지되며 새 데이터가 도달할 때까지 MongoCursor.next() 메서드를 호출할 때 차단됩니다. 그러나 MongoDB 서버는 결정되지 않은 기간 후에 새 데이터가 표시되지 않는 경우 커서를 종료할 수 있는 권리를 보유합니다. 새 데이터를 계속 사용하고자 하는 경우 커서를 다시 생성해야 합니다. 그리고 그렇게하기 위해, 당신은 당신이 떠난 위치 또는 다른 곳에서 다시 소비하기 시작해야 할 것입니다.

Camel MongoDB 테일링 가능 커서 소비자는 이러한 모든 작업을 처리합니다. 증가하는 특성의 데이터에서 일부 필드에 키를 제공해야 합니다. 이 키는 다시 생성할 때마다 커서를 배치하기 위한 마커 역할을 합니다(예: 타임스탬프, 순차 ID 등). MongoDB에서 지원하는 모든 데이터 유형일 수 있습니다. 날짜, 문자열 및 정수는 제대로 작동하는 것으로 확인됩니다. 이 구성 요소의 컨텍스트에서 이 메커니즘을 "테일 추적"이라고 합니다.

소비자는 이 필드의 마지막 값을 기억하고 커서를 다시 생성할 때마다 increasingField > lastValue 와 같은 필터를 사용하여 쿼리를 실행하여 읽지 않은 데이터만 소비합니다.

필드 증가 설정: 엔드포인트 URI tail>-<ingIncreasingField 옵션에서 증가하는 필드의 키를 설정합니다. Camel 2.10에서 이 필드에 대한 중첩된 탐색은 아직 지원되지 않으므로 데이터의 최상위 필드여야 합니다. 즉, "timestamp" 필드는 훌륭하지만 "nested.timestamp"는 작동하지 않습니다. 중첩된 증가하는 필드에 대한 지원이 필요한 경우 Camel JIRA에서 티켓을 엽니 다.

커서 재개발 지연: 초기 조정 시 새 데이터를 사용할 수 없는 경우 MongoDB에서 커서를 즉시 강제 종료합니다. 이 경우 서버를 덮어쓸 필요가 없으므로 cursorRegenerationDelay 옵션이 도입되었습니다(기본값: 1000ms).

예를 들면 다음과 같습니다.

from("mongodb:myDb?database=flights&collection=cancellations&tailTrackIncreasingField=departureTime")
    .id("tailableCursorConsumer1")
    .autoStartup(false)
    .to("mock:test");

위의 경로는 "flights.cancellations" capped 컬렉션에서 "departureTime"을 증가하는 필드로 사용하며 기본 재생 커서가 1000ms입니다.

35.10. 영구 테일 추적

표준 테일 추적은 변동성이며 마지막 값은 메모리에만 유지됩니다. 그러나 실제로는 언제든지 Camel 컨테이너를 다시 시작해야 하지만 마지막 값이 손실되고 테일러 커서 사용자가 맨 위에서 다시 소비하기 시작하여 중복 레코드를 경로로 보낼 가능성이 높습니다.

이러한 상황을 해결하기 위해 지속적인 테일 추적 기능을 활성화하여 MongoDB 데이터베이스 내의 특수 컬렉션에서 마지막으로 소비된 증가 값을 추적할 수 있습니다. 소비자가 다시 초기화되면 마지막 추적 값을 복원하고 아무 일도 발생하지 않은 것처럼 계속합니다.

마지막 읽기 값은 두 가지 경우에 유지됩니다. 커서가 다시 생성될 때마다 사용자가 종료될 때입니다. 수요가 있는 경우 강력한 기능을 추가하기 위해 향후 정기적으로(5초마다 플러시)를 유지할 수 있습니다. 이 기능을 요청하려면 Camel JIRA에서 티켓을 엽니 다.

35.11. 지속적인 테일 추적 활성화

이 기능을 활성화하려면 끝점 URI에서 다음 옵션을 설정합니다.

  • truepersistentTail&gt;-<ing 옵션
  • 많은 소비자 간에 동일한 컬렉션을 재사용할 수 있도록 이 소비자의 고유 식별자에 대한 persistentId 옵션

또한 tail>-<Db,tail ECDHE 및 tail>-<Field 옵션을 설정하여 런타임 정보가 저장되는 위치를 사용자 지정할 수 있습니다. 각 옵션에 대한 설명은 이 페이지 상단에 있는 끝점 옵션 표를 참조하십시오.

예를 들어 다음 경로는 "flights.cancellations" 제한 컬렉션에서 사용합니다. "departureTime"을 증가 필드로 사용하고, 1000ms의 기본 재생 커서 지연과 함께, 지속적 tail 추적이 설정되어 있으며 "flights.camelTail#177ing"의 "cancellations#177er" ID에 따라 유지됩니다. 마지막으로 처리된 값을 "last>-<ingValue" 필드에 저장합니다(camelTail >-<ing 및 lastECDHEingValue 는 기본값입니다).

from("mongodb:myDb?database=flights&collection=cancellations&tailTrackIncreasingField=departureTime&persistentTailTracking=true" +
     "&persistentId=cancellationsTracker")
    .id("tailableCursorConsumer2")
    .autoStartup(false)
    .to("mock:test");

다음은 위의 것과 동일한 또 다른 예제이지만 영구 테일 추적 런타임 정보는 "trackers.camel>-<ers" 컬렉션에 "lastProcessedDepartureTime" 필드에 저장됩니다.

from("mongodb:myDb?database=flights&collection=cancellations&tailTrackIncreasingField=departureTime&persistentTailTracking=true" +
     "&persistentId=cancellationsTracker&tailTrackDb=trackers&tailTrackCollection=camelTrackers" +
     "&tailTrackField=lastProcessedDepartureTime")
    .id("tailableCursorConsumer3")
    .autoStartup(false)
    .to("mock:test");

35.11.1. 스트림 소비자 변경

Change Streams를 사용하면 MongoDB oplog를 추적할 수 있는 복잡성과 위험 없이 애플리케이션에서 실시간 데이터 변경에 액세스할 수 있습니다. 애플리케이션에서는 변경 스트림을 사용하여 컬렉션의 모든 데이터 변경 사항을 구독하고 즉시 응답할 수 있습니다. 변경 스트림은 집계 프레임워크를 사용하므로 애플리케이션에서 특정 변경 사항을 필터링하거나 필요에 따라 알림을 변환할 수도 있습니다. 교환 기관은 모든 변경에 대한 전체 문서를 포함합니다.

Change Streams Consumer를 구성하려면 consumerType,database,collection 및 선택적 JSON 속성 streamFilter 를 지정하여 이벤트를 필터링해야 합니다. 이 JSON 속성은 표준 MongoDB $match 집계입니다. XML DSL 구성을 사용하여 쉽게 지정할 수 있습니다.

<route id="filterConsumer">
    <from uri="mongodb:myDb?consumerType=changeStreams&amp;database=flights&amp;collection=tickets&amp;streamFilter={ '$match':{'$or':[{'fullDocument.stringValue': 'specificValue'}]} }"/>
    <to uri="mock:test"/>
</route>

Java 구성:

from("mongodb:myDb?consumerType=changeStreams&database=flights&collection=tickets&streamFilter={ '$match':{'$or':[{'fullDocument.stringValue': 'specificValue'}]} }")
    .to("mock:test");
참고

streamFilter 값을 속성 자리 표시자로 외부화하여 끝점 URI 매개변수를 더 깨끗하고 읽기 쉽도록 할 수 있습니다.

changeStreams 소비자 유형에서도 다음과 같은 OUT 헤더를 반환합니다.

헤더 키빠른 상수설명 (MongoDB API doc에서 추출)데이터 유형

CamelMongoDbStreamOperationType

MongoDbConstants.STREAM_OPERATION_TYPE

발생한 작업의 유형입니다. 다음 값 중 하나일 수 있습니다. insert, delete, replace, update, drop, rename, dropDatabase, invalidate.

문자열

_id

MongoDbConstants.MONGO_ID

삽입, 교체, 삭제, 업데이트 작업(예: CRUD 작업)에 의해 생성되거나 수정된 문서의 _id가 포함된 문서입니다. 분할된 컬렉션의 경우 문서의 전체 shard 키도 표시됩니다. _id 필드는 이미 shard 키의 일부이면 반복되지 않습니다.

ObjectId

35.12. 유형 변환

camel-mongodb 구성 요소에 포함된 MongoDbBasicConverters 유형 변환기는 다음과 같은 변환을 제공합니다.

이름유형에서유형어떻게 해야 합니까?

fromMapToDocument

map

문서

Document (Map m) 생성자를 통해 새 문서를 구성합니다.

fromDocumentToMap

문서

map

문서는 이미 Map 을 사용하고 있습니다.

fromStringToDocument

문자열

문서

com.mongodb.Document.parse(String s) 를 사용합니다.

fromStringToObjectId

문자열

ObjectId

ObjectId 를 통해 새 ObjectId를 구성합니다.

fromFileToDocument

파일

문서

정기 아래 InputStreamToDocument 사용

fromInputStreamToDocument

InputStream

문서

입력 스트림 바이트를 문서로변환

fromStringToList

문자열

List<Bson>

org.bson.codecs.configuration.CodecRegistries 를 사용하여 BsonArray로 변환한 다음 List<Bson>으로 변환합니다.

이 형식 변환기는 자동 검색되므로 수동으로 구성할 필요가 없습니다.

35.13. Spring Boot Auto-Configuration

Spring Boot와 함께 mongodb를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-mongodb-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.mongodb.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.mongodb.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.mongodb.enabled

mongodb 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.mongodb.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.mongodb.mongo-connection

연결에 사용되는 공유 클라이언트입니다. 구성 요소에서 생성된 모든 끝점은 이 연결 클라이언트를 공유합니다. 옵션은 com.mongodb.client.MongoClient 유형입니다.

 

MongoClient

36장. Netty

생산자 및 소비자 모두 지원

Camel의 Netty 구성 요소는 Netty 프로젝트 버전 4를 기반으로 하는 소켓 통신 구성 요소입니다.
Netty는 프로토콜 서버 및 클라이언트와 같은 networkServer>-<rFactory 애플리케이션을 빠르고 쉽게 개발할 수 있도록 지원하는 NIO 클라이언트 서버 프레임워크입니다.
Netty는 TCP 및 UDP 소켓 서버와 같은 네트워크 프로그래밍을 크게 간소화하고 간소화합니다.

이 camel 구성 요소는 생산자 및 소비자 끝점을 모두 지원합니다.

Netty 구성 요소에는 여러 옵션이 있으며 여러 TCP/UDP 통신 매개변수(버퍼 크기, keepAlives, tcpNoDelay 등)를 세밀하게 제어하고 Camel 경로에서 In-Only 및 In-Out 통신을 용이하게 합니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-netty</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

36.1. URI 형식

netty 구성 요소의 URI 스키마는 다음과 같습니다.

netty:tcp://0.0.0.0:99999[?options]
netty:udp://remotehost:99999/[?options]

이 구성 요소는 TCP 및 UDP 모두에 대해 생산자 및 소비자 끝점을 지원합니다.

36.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

36.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

36.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형 의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

36.3. 구성 요소 옵션

Netty 구성 요소는 아래에 나열된 73 옵션을 지원합니다.

이름설명Default유형

구성 (공용)

엔드포인트를 생성할 때 NettyConfiguration을 구성으로 사용하려면 다음을 수행하십시오.

 

NettyConfiguration

연결 해제 (공용)

사용 후 Netty Channel에서 연결을 해제할지 여부입니다. 소비자 및 생산자 모두에 사용할 수 있습니다.

false

boolean

keepalive ( common)

비활성으로 인해 소켓이 닫히지 않도록 설정

true

boolean

reuseAddress (common)

소켓 멀티플렉싱을 용이하게 하려면 를 설정합니다.

true

boolean

reuseChannel (common)

이 옵션을 사용하면 생산자와 소비자(클라이언트 모드에서)가 교환 처리 라이프사이클에 대해 동일한 Netty 채널을 재사용할 수 있습니다. 이 기능은 Camel 경로에서 서버를 여러 번 호출하고 동일한 네트워크 연결을 사용하려는 경우에 유용합니다. 이 기능을 사용하면 채널이 Exchange가 완료될 때까지 연결 풀로 반환되지 않으며, 연결 해제 옵션이 true로 설정된 경우 연결이 해제되지 않습니다. 재사용된 채널은 라우팅 중에 채널을 가져와서 사용할 수 있는 NettyConstants#NETTY_CHANNEL 키가 있는 교환 속성으로 교환에 저장됩니다.

false

boolean

동기화 (공용)

끝점을 단방향 또는 요청-응답으로 설정.

true

boolean

tcpNoDelay (common)

TCP 프로토콜 성능을 개선하기 위해 를 설정합니다.

true

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

broadcast (consumer)

를 설정하여 UDP를 통한 멀티 캐스트를 선택합니다.

false

boolean

clientMode (consumer)

clientMode가 true인 경우 netty 소비자는 주소를 TCP 클라이언트로 연결합니다.

false

boolean

다시 연결 (consumer)

소비자의 clientMode에만 사용되는 소비자는 이 기능이 활성화된 경우 연결 해제 시 다시 연결을 시도합니다.

true

boolean

Re reconnectInterval (consumer)

reconnect 및 clientMode가 활성화된 경우 사용합니다. 재연결을 시도하는 간격(밀리초)입니다.

10000

int

backlog (advanced)

netty consumer(server)에 대한 백로그를 구성할 수 있습니다. 백로그는 OS에 따라 최선의 노력일 뿐입니다. 이 옵션을 200, 500 또는 1000과 같은 값으로 설정하면 이 옵션이 구성되지 않은 경우 TCP 스택에 허용 큐가 될 수 있는 시간을 알려주며 백로그는 OS 설정에 따라 달라집니다.

 

int

haderCount (advanced)

netty가 nio 모드에서 작동할 때, Netty의 기본 rateCount 매개 변수를 사용합니다. 사용자는 이 옵션을 사용하여 Netty에서 기본gerCount를 재정의할 수 있습니다.

1

int

haderGroup (advanced)

NettyEndpoint에서 서버 측의 새 연결을 처리하는 데 사용할 수 있는 BossGroup을 설정합니다.

 

EventLoopGroup

disconnectOnNoReply (consumer (advanced))

동기화가 활성화되면 이 옵션은 다시 보낼 응답이 없는 위치에서 연결을 해제해야 하는 경우 NettyConsumer를 지시합니다.

true

boolean

executorService (consumer (advanced))

지정된 EventExecutorGroup을 사용합니다.

 

EventExecutorGroup

maximumPoolSize (consumer (advanced))

netty 소비자 순서가 지정된 스레드 풀에 대한 최대 스레드 풀 크기를 설정합니다. 기본 크기는 2 x cpu_core + 1입니다. 이 값을 eg 10으로 설정하면 2 x cpu_core + 1이 더 높은 값인 경우를 제외하고 10개의 스레드가 사용됩니다. 예를 들어 8개의 코어가 있는 경우 소비자 스레드 풀은 17이 됩니다. 이 스레드 풀은 Camel로 Netty에서 수신한 메시지를 라우팅하는 데 사용됩니다. 별도의 스레드 풀을 사용하여 메시지 순서를 정하고 일부 메시지가 차단되는 경우에도 nettys 작업자 스레드(event loop)가 영향을 받습니다.

 

int

nettyServerBootstrapFactory (consumer (advanced))

사용자 정의 NettyServerBootstrapFactory를 사용하려면 다음을 수행합니다.

 

NettyServerBootstrapFactory

NetworkInterface (advanced)

UDP를 사용하는 경우 이 옵션을 사용하여 멀티 캐스트 그룹에 가입하기 위해 eth0과 같은 네트워크 인터페이스를 이름으로 지정할 수 있습니다.

 

문자열

noReplyLogLevel (consumer (advanced))

동기화가 활성화된 경우 이 옵션을 사용하면 NettyConsumer가 로깅할 때 사용할 로깅 수준을 지정할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

WARN

LoggingLevel

ServerECDHEdChannelExceptionCaughtLogLevel (consumer (advanced))

서버(NettyConsumer)가 java.nio.channels.ECDHEdChannelException을 캡처하면 이 로깅 수준을 사용하여 기록됩니다. 클라이언트가 갑자기 연결을 끊은 다음 Netty 서버에서 폐쇄된 예외의 플러드를 일으킬 수 있으므로 폐쇄된 채널 예외를 기록하지 않도록 하는 데 사용됩니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

DEBUG

LoggingLevel

serverExceptionCaughtLogLevel (consumer (advanced))

서버(NettyConsumer)가 예외를 발견하면 이 로깅 수준을 사용하여 기록됩니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

WARN

LoggingLevel

serverInitializerFactory (consumer (advanced))

사용자 정의 Server>-<rFactory를 사용하려면 다음을 수행합니다.

 

ServerInitializerFactory

usingExecutorService (consumer (advanced))

순서가 지정된 스레드 풀을 사용하여 이벤트가 동일한 채널에서 순서대로 처리되도록 합니다.

true

boolean

ConnectTimeout (producer)

소켓 연결을 사용할 수 있을 때까지 대기하는 시간입니다. 값은 밀리초 단위입니다.

10000

int

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

requestTimeout (producer)

원격 서버를 호출할 때 Netty 생산자에 대한 타임아웃을 사용할 수 있습니다. 기본적으로 제한 시간은 사용되지 않습니다. 값은 밀리 초이므로, 30000은 30초입니다. requestTimeout은 Netty의 ReadTimeoutHandler를 사용하여 시간 초과를 트리거합니다.

 

long

client>-<rFactory (producer (advanced))

사용자 정의 Client>-<rFactory를 사용하려면 다음을 수행합니다.

 

ClientInitializerFactory

correlationManager (producer (advanced))

사용자 정의 상관 관계 관리자를 사용하여 request/reply를 netty 생산자와 함께 사용할 때 요청 및 응답 메시지를 매핑하는 방법을 관리합니다. 요청 및 응답 메시지에 상관 관계가 있는 경우와 같은 응답과 함께 요청을 매핑할 수 있는 방법이 있는 경우에만 사용해야 합니다. 이는 netty의 동일한 채널(연결)에서 여러 동시 메시지를 멀티x로 사용하려는 경우 사용할 수 있습니다. 이 작업을 수행할 때 요청 및 응답 메시지의 상관 관계를 유지하는 방법이 있어야 하므로 진행 중인 Camel Exchange에 올바른 응답을 저장할 수 있습니다. 사용자 정의 상관 관리자 빌드 시 TimeoutCorrelationManagerSupport를 확장하는 것이 좋습니다. 이는 구현에 필요한 시간 초과 및 기타 복잡성도 지원합니다. 자세한 내용은 producerPoolEnabled 옵션도 참조하십시오.

 

NettyCamelStateCorrelationManager

lazyChannelCreation (producer) (advanced)

Camel 프로듀서가 시작될 때 원격 서버가 가동되지 않고 실행되지 않는 경우 예외 없이 채널을 생성할 수 있습니다.

true

boolean

producerPoolEnabled (producer (advanced))

생산자 풀이 활성화되었는지 여부입니다. 중요: 이 기능을 해제하면 프로듀서에 단일 공유 연결이 사용되며 요청/응답을 수행하는 경우에도 마찬가지입니다. 즉, 응답이 다시 정렬되지 않으면 인터리브된 응답과 관련된 잠재적 문제가 있습니다. 따라서 요청 및 응답 메시지 모두에 상관관계 ID가 있어야 Camel에서 메시지 처리를 계속 수행하는 Camel 콜백에 대한 응답의 상관 관계가 적절히 연관될 수 있습니다. 이렇게 하려면 NettyCamelStateCorrelationManager를 상관 관리자로 구현하고 correlationManager 옵션을 통해 구성해야 합니다. 자세한 내용은 correlationManager 옵션을 참조하십시오.

true

boolean

producerPoolMaxIdle (producer (advanced))

풀의 유휴 인스턴스 수에 대한 제한을 설정합니다.

100

int

producerPoolMaxTotal (producer (advanced))

지정된 시간에 풀에서 할당할 수 있는 오브젝트 수(클라이언트로 확인, 또는 유휴 상태로 대기 중) 수를 설정합니다. 제한 없이 음수 값을 사용합니다.

-1

int

producerPoolMinEvictableIdle (producer)

개체가 유휴 상태 오브젝트 evictor에 의해 제거되기 전에 개체가 풀에 유휴 상태에 있을 수 있는 최소 시간(밀로 값)을 설정합니다.

300000

long

producerPoolMinIdle (producer (advanced))

Evictor 스레드(활성인 경우)가 새 오브젝트를 생성하기 전에 생산자 풀에 허용되는 최소 인스턴스 수를 설정합니다.

 

int

udpConnectionlessSending (producer)

이 옵션은 실제 불과 잊어 버린 연결 less udp 전송을 지원합니다. 연결된 udp send은 수신 포트에서 수신 대기 중 없는 경우 PortUnreachableException을 수신합니다.

false

boolean

useByteBuf (producer (advanced))

useByteBuf가 true인 경우 netty 생산자는 메시지를 보내기 전에 메시지 본문을 10.0.0.1Buf로 전환합니다.

false

boolean

hostnameVerification (보안)

SSLEngine에서 호스트 이름 확인을 활성화/비활성화하려면 다음을 수행합니다.

false

boolean

allowSerializedHeaders (advanced)

transferExchange가 true인 경우에만 TCP에 사용됩니다. true로 설정하면 헤더 및 속성의 직렬화 가능 개체가 교환에 추가됩니다. 그렇지 않으면 Camel이 비합리화 가능한 오브젝트를 제외하고 WARN 수준에서 기록합니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

channelGroup (advanced)

명시적 ChannelGroup을 사용하려면 다음을 수행합니다.

 

ChannelGroup

NativeTransport (advanced)

NIO 대신 기본 전송을 사용할지 여부입니다. 네이티브 전송은 호스트 운영 체제를 사용하며 일부 플랫폼에서만 지원됩니다. 사용 중인 호스트 운영 체제에 netty JAR을 추가해야 합니다. 자세한 내용은 다음에서 참조하십시오.

false

boolean

옵션 (고급)

option.을 접두사로 사용하여 추가 netty 옵션을 구성할 수 있습니다. 예를 들어, netty 옵션 child.keepAlive=false를 설정하려면 option.child.keepAlive=false를 설정합니다. 사용할 수 있는 가능한 옵션은 Netty 설명서를 참조하십시오.

 

map

receiveBufferSize (advanced)

인바운드 통신 중에 사용할 TCP/UDP 버퍼 크기입니다. 크기는 바이트입니다.

65536

int

receiveBufferSizePredictor (advanced)

버퍼 크기 예측기를 구성합니다. 자세한 내용은 이 메일 스레드 및 문서 문서를 참조하십시오.

 

int

sendBufferSize (advanced)

아웃바운드 통신 중에 사용할 TCP/UDP 버퍼 크기입니다. 크기는 바이트입니다.

65536

int

transfer exchange (advanced)

TCP에만 사용됩니다. 바디가 아닌 전선으로 교환을 전송할 수 있습니다. 본문, Out body, fault body, In headers, Out headers, fault headers, fault headers, fault headers, exchange properties, exchange exception. 이를 위해 오브젝트를 직렬화할 수 있어야 합니다. Camel은 비합리화 가능한 오브젝트를 제외하고 WARN 수준에서 기록합니다.

false

boolean

udpByteArrayCodec (advanced)

UDP의 경우에만 해당합니다. If enabled using byte array codec instead of Java serialization protocol.

false

boolean

workercount (advanced)

netty가 nio 모드에서 작동하면 Netty의 기본 workerCount 매개변수( cpu_core_threads x 2)를 사용합니다. 이 옵션을 사용하여 Netty에서 기본 workerCount를 재정의할 수 있습니다.

 

int

workerGroup (advanced)

명시적인 EventLoopGroup을 사장 풀로 사용하려면 다음을 수행합니다. 예를 들어 여러 소비자 또는 생산자와 스레드 풀을 공유하는 경우입니다. 기본적으로 각 소비자 또는 프로듀서에는 2 x cpu count 코어 스레드가 있는 자체 작업자 풀이 있습니다.

 

EventLoopGroup

allowDefaultCodec (codec)

netty 구성 요소는 둘 다 인코더/디코더가 null이고 텍스트 줄은 false인 경우 기본 codec를 설치합니다. allowDefaultCodec를 false로 설정하면 netty 구성 요소가 필터 체인의 첫 번째 요소로 기본 codec를 설치할 수 없습니다.

true

boolean

autoAppendDelimiter (codec)

textline codec를 사용하여 보낼 때 누락된 끝 구분 기호를 자동 첨부할지 여부입니다.

true

boolean

디코더MaxLineLength (codec)

textline codec에 사용할 최대 행 길이입니다.

1024

int

디코더 (codec)

사용할 디코더 목록입니다. 쉼표로 구분된 값이 있는 문자열을 사용하여 레지스트리에서 값을 조회할 수 있습니다. # 값을 접두사로 붙여서 Camel이 조회해야 함을 알고 있습니다.

 

list

구분자 (codec)

텍스트 코드c에 사용할 구분 기호입니다. 가능한 값은 LINE 및 NULL입니다.

CloudEvent 값:

  • LINE
  • NULL

LINE

TextLineDelimiter

유니코드 (codec)

사용할 인코더 목록입니다. 쉼표로 구분된 값이 있는 문자열을 사용하여 레지스트리에서 값을 조회할 수 있습니다. # 값을 접두사로 붙여서 Camel이 조회해야 함을 알고 있습니다.

 

list

인코딩 (codec)

textline codec에 사용할 인코딩(Charset 이름)입니다. 제공되지 않는 경우 Camel은 JVM 기본값 collectdset을 사용합니다.

 

문자열

텍스트 줄 (codec)

TCP에만 사용됩니다. codec가 지정되지 않은 경우 이 플래그를 사용하여 텍스트 줄 기반 코드c를 나타낼 수 있습니다. 지정하지 않거나 값이 false인 경우 오브젝트 Serialization은 TCP를 초과한다고 가정하지만 문자열만 기본적으로 직렬화할 수 있습니다.

false

boolean

enabledProtocols (security)

SSL을 사용할 때 활성화할 프로토콜입니다.

TLSv1,TLSv1.1,TLSv1.2

문자열

keyStoreFile (보안)

암호화에 사용할 클라이언트 측 인증서 키 저장소입니다.

 

파일

keyStoreFormat (보안)

페이로드 암호화에 사용되는 키 저장소 형식입니다. 설정되지 않은 경우 기본값은 JKS입니다.

 

문자열

keyStoreResource (보안)

암호화에 사용할 클라이언트 측 인증서 키 저장소입니다. classpath에서 기본적으로 로드되지만 classpath:, file: 또는 http: 접두사를 추가하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

NeedClientAuth (보안)

SSL을 사용할 때 서버에 클라이언트 인증이 필요한지 여부를 설정합니다.

false

boolean

암호 (보안)

SSH를 사용하여 전송된 페이로드를 암호화/암호 해독하기 위해 사용할 암호 설정입니다.

 

문자열

SecurityProvider (보안)

페이로드 암호화에 사용할 보안 공급자입니다. 설정되지 않은 경우 기본값은 SunX509입니다.

 

문자열

SSL (보안)

SSL 암호화가 이 끝점에 적용되는지 여부를 지정하는 설정입니다.

false

boolean

sslClientCertHeaders (보안)

SSL 모드에서 활성화되면 Netty 소비자는 주체 이름, 발행자 이름, 일련 번호, 유효한 날짜 범위와 같은 클라이언트 인증서에 대한 정보가 있는 헤더로 Camel Message를 보강합니다.

false

boolean

sslContextParameters (보안)

SSLContextParameters를 사용하여 보안을 구성하려면 다음을 수행합니다.

 

SSLContextParameters

sslHandler (security)

SSL 처리기를 반환하는 데 사용할 수 있는 클래스에 대한 참조입니다.

 

SslHandler

trustStoreFile (보안)

암호화에 사용할 서버 측 인증서 키 저장소입니다.

 

파일

trustStoreResource (security)

암호화에 사용할 서버 측 인증서 키 저장소입니다. classpath에서 기본적으로 로드되지만 classpath:, file: 또는 http: 접두사를 추가하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

useGlobalSslContextParameters (security)

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

boolean

36.4. 끝점 옵션

Netty 끝점은 URI 구문을 사용하여 구성됩니다.

netty:protocol://host:port

다음과 같은 경로 및 쿼리 매개변수 사용:

36.4.1. 경로 매개변수 (3 매개변수)

이름설명Default유형

프로토콜 (common)

tcp 또는 udp일 수 있는 프로토콜이 필요합니다.

CloudEvent 값:

  • tcp
  • udp
 

문자열

호스트 (공용)

필수 호스트 이름입니다. 소비자의 경우 호스트 이름은 localhost 또는 0.0.0.0입니다. 생산자의 경우 호스트 이름은 연결할 원격 호스트입니다.

 

문자열

포트 (공용)

호스트 포트 번호입니다.

 

int

36.4.2. 쿼리 매개변수 (71 매개변수)

이름설명Default유형

연결 해제 (공용)

사용 후 Netty Channel에서 연결을 해제할지 여부입니다. 소비자 및 생산자 모두에 사용할 수 있습니다.

false

boolean

keepalive ( common)

비활성으로 인해 소켓이 닫히지 않도록 설정

true

boolean

reuseAddress (common)

소켓 멀티플렉싱을 용이하게 하려면 를 설정합니다.

true

boolean

reuseChannel (common)

이 옵션을 사용하면 생산자와 소비자(클라이언트 모드에서)가 교환 처리 라이프사이클에 대해 동일한 Netty 채널을 재사용할 수 있습니다. 이 기능은 Camel 경로에서 서버를 여러 번 호출하고 동일한 네트워크 연결을 사용하려는 경우에 유용합니다. 이 기능을 사용하면 채널이 Exchange가 완료될 때까지 연결 풀로 반환되지 않으며, 연결 해제 옵션이 true로 설정된 경우 연결이 해제되지 않습니다. 재사용된 채널은 라우팅 중에 채널을 가져와서 사용할 수 있는 NettyConstants#NETTY_CHANNEL 키가 있는 교환 속성으로 교환에 저장됩니다.

false

boolean

동기화 (공용)

끝점을 단방향 또는 요청-응답으로 설정.

true

boolean

tcpNoDelay (common)

TCP 프로토콜 성능을 개선하기 위해 를 설정합니다.

true

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

broadcast (consumer)

를 설정하여 UDP를 통한 멀티 캐스트를 선택합니다.

false

boolean

clientMode (consumer)

clientMode가 true인 경우 netty 소비자는 주소를 TCP 클라이언트로 연결합니다.

false

boolean

다시 연결 (consumer)

소비자의 clientMode에만 사용되는 소비자는 이 기능이 활성화된 경우 연결 해제 시 다시 연결을 시도합니다.

true

boolean

Re reconnectInterval (consumer)

reconnect 및 clientMode가 활성화된 경우 사용합니다. 재연결을 시도하는 간격(밀리초)입니다.

10000

int

backlog (advanced)

netty consumer(server)에 대한 백로그를 구성할 수 있습니다. 백로그는 OS에 따라 최선의 노력일 뿐입니다. 이 옵션을 200, 500 또는 1000과 같은 값으로 설정하면 이 옵션이 구성되지 않은 경우 TCP 스택에 허용 큐가 될 수 있는 시간을 알려주며 백로그는 OS 설정에 따라 달라집니다.

 

int

haderCount (advanced)

netty가 nio 모드에서 작동할 때, Netty의 기본 rateCount 매개 변수를 사용합니다. 사용자는 이 옵션을 사용하여 Netty에서 기본gerCount를 재정의할 수 있습니다.

1

int

haderGroup (advanced)

NettyEndpoint에서 서버 측의 새 연결을 처리하는 데 사용할 수 있는 BossGroup을 설정합니다.

 

EventLoopGroup

disconnectOnNoReply (consumer (advanced))

동기화가 활성화되면 이 옵션은 다시 보낼 응답이 없는 위치에서 연결을 해제해야 하는 경우 NettyConsumer를 지시합니다.

true

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

nettyServerBootstrapFactory (consumer (advanced))

사용자 정의 NettyServerBootstrapFactory를 사용하려면 다음을 수행합니다.

 

NettyServerBootstrapFactory

NetworkInterface (advanced)

UDP를 사용하는 경우 이 옵션을 사용하여 멀티 캐스트 그룹에 가입하기 위해 eth0과 같은 네트워크 인터페이스를 이름으로 지정할 수 있습니다.

 

문자열

noReplyLogLevel (consumer (advanced))

동기화가 활성화된 경우 이 옵션을 사용하면 NettyConsumer가 로깅할 때 사용할 로깅 수준을 지정할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

WARN

LoggingLevel

ServerECDHEdChannelExceptionCaughtLogLevel (consumer (advanced))

서버(NettyConsumer)가 java.nio.channels.ECDHEdChannelException을 캡처하면 이 로깅 수준을 사용하여 기록됩니다. 클라이언트가 갑자기 연결을 끊은 다음 Netty 서버에서 폐쇄된 예외의 플러드를 일으킬 수 있으므로 폐쇄된 채널 예외를 기록하지 않도록 하는 데 사용됩니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

DEBUG

LoggingLevel

serverExceptionCaughtLogLevel (consumer (advanced))

서버(NettyConsumer)가 예외를 발견하면 이 로깅 수준을 사용하여 기록됩니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

WARN

LoggingLevel

serverInitializerFactory (consumer (advanced))

사용자 정의 Server>-<rFactory를 사용하려면 다음을 수행합니다.

 

ServerInitializerFactory

usingExecutorService (consumer (advanced))

순서가 지정된 스레드 풀을 사용하여 이벤트가 동일한 채널에서 순서대로 처리되도록 합니다.

true

boolean

ConnectTimeout (producer)

소켓 연결을 사용할 수 있을 때까지 대기하는 시간입니다. 값은 밀리초 단위입니다.

10000

int

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

requestTimeout (producer)

원격 서버를 호출할 때 Netty 생산자에 대한 타임아웃을 사용할 수 있습니다. 기본적으로 제한 시간은 사용되지 않습니다. 값은 밀리 초이므로, 30000은 30초입니다. requestTimeout은 Netty의 ReadTimeoutHandler를 사용하여 시간 초과를 트리거합니다.

 

long

client>-<rFactory (producer (advanced))

사용자 정의 Client>-<rFactory를 사용하려면 다음을 수행합니다.

 

ClientInitializerFactory

correlationManager (producer (advanced))

사용자 정의 상관 관계 관리자를 사용하여 request/reply를 netty 생산자와 함께 사용할 때 요청 및 응답 메시지를 매핑하는 방법을 관리합니다. 요청 및 응답 메시지에 상관 관계가 있는 경우와 같은 응답과 함께 요청을 매핑할 수 있는 방법이 있는 경우에만 사용해야 합니다. 이는 netty의 동일한 채널(연결)에서 여러 동시 메시지를 멀티x로 사용하려는 경우 사용할 수 있습니다. 이 작업을 수행할 때 요청 및 응답 메시지의 상관 관계를 유지하는 방법이 있어야 하므로 진행 중인 Camel Exchange에 올바른 응답을 저장할 수 있습니다. 사용자 정의 상관 관리자 빌드 시 TimeoutCorrelationManagerSupport를 확장하는 것이 좋습니다. 이는 구현에 필요한 시간 초과 및 기타 복잡성도 지원합니다. 자세한 내용은 producerPoolEnabled 옵션도 참조하십시오.

 

NettyCamelStateCorrelationManager

lazyChannelCreation (producer) (advanced)

Camel 프로듀서가 시작될 때 원격 서버가 가동되지 않고 실행되지 않는 경우 예외 없이 채널을 생성할 수 있습니다.

true

boolean

producerPoolEnabled (producer (advanced))

생산자 풀이 활성화되었는지 여부입니다. 중요: 이 기능을 해제하면 프로듀서에 단일 공유 연결이 사용되며 요청/응답을 수행하는 경우에도 마찬가지입니다. 즉, 응답이 다시 정렬되지 않으면 인터리브된 응답과 관련된 잠재적 문제가 있습니다. 따라서 요청 및 응답 메시지 모두에 상관관계 ID가 있어야 Camel에서 메시지 처리를 계속 수행하는 Camel 콜백에 대한 응답의 상관 관계가 적절히 연관될 수 있습니다. 이렇게 하려면 NettyCamelStateCorrelationManager를 상관 관리자로 구현하고 correlationManager 옵션을 통해 구성해야 합니다. 자세한 내용은 correlationManager 옵션을 참조하십시오.

true

boolean

producerPoolMaxIdle (producer (advanced))

풀의 유휴 인스턴스 수에 대한 제한을 설정합니다.

100

int

producerPoolMaxTotal (producer (advanced))

지정된 시간에 풀에서 할당할 수 있는 오브젝트 수(클라이언트로 확인, 또는 유휴 상태로 대기 중) 수를 설정합니다. 제한 없이 음수 값을 사용합니다.

-1

int

producerPoolMinEvictableIdle (producer)

개체가 유휴 상태 오브젝트 evictor에 의해 제거되기 전에 개체가 풀에 유휴 상태에 있을 수 있는 최소 시간(밀로 값)을 설정합니다.

300000

long

producerPoolMinIdle (producer (advanced))

Evictor 스레드(활성인 경우)가 새 오브젝트를 생성하기 전에 생산자 풀에 허용되는 최소 인스턴스 수를 설정합니다.

 

int

udpConnectionlessSending (producer)

이 옵션은 실제 불과 잊어 버린 연결 less udp 전송을 지원합니다. 연결된 udp send은 수신 포트에서 수신 대기 중 없는 경우 PortUnreachableException을 수신합니다.

false

boolean

useByteBuf (producer (advanced))

useByteBuf가 true인 경우 netty 생산자는 메시지를 보내기 전에 메시지 본문을 10.0.0.1Buf로 전환합니다.

false

boolean

hostnameVerification (보안)

SSLEngine에서 호스트 이름 확인을 활성화/비활성화하려면 다음을 수행합니다.

false

boolean

allowSerializedHeaders (advanced)

transferExchange가 true인 경우에만 TCP에 사용됩니다. true로 설정하면 헤더 및 속성의 직렬화 가능 개체가 교환에 추가됩니다. 그렇지 않으면 Camel이 비합리화 가능한 오브젝트를 제외하고 WARN 수준에서 기록합니다.

false

boolean

channelGroup (advanced)

명시적 ChannelGroup을 사용하려면 다음을 수행합니다.

 

ChannelGroup

NativeTransport (advanced)

NIO 대신 기본 전송을 사용할지 여부입니다. 네이티브 전송은 호스트 운영 체제를 사용하며 일부 플랫폼에서만 지원됩니다. 사용 중인 호스트 운영 체제에 netty JAR을 추가해야 합니다. 자세한 내용은 다음에서 참조하십시오.

false

boolean

옵션 (고급)

option.을 접두사로 사용하여 추가 netty 옵션을 구성할 수 있습니다. 예를 들어, netty 옵션 child.keepAlive=false를 설정하려면 option.child.keepAlive=false를 설정합니다. 사용할 수 있는 가능한 옵션은 Netty 설명서를 참조하십시오.

 

map

receiveBufferSize (advanced)

인바운드 통신 중에 사용할 TCP/UDP 버퍼 크기입니다. 크기는 바이트입니다.

65536

int

receiveBufferSizePredictor (advanced)

버퍼 크기 예측기를 구성합니다. 자세한 내용은 이 메일 스레드 및 문서 문서를 참조하십시오.

 

int

sendBufferSize (advanced)

아웃바운드 통신 중에 사용할 TCP/UDP 버퍼 크기입니다. 크기는 바이트입니다.

65536

int

동기 (고급)

동기 처리를 엄격하게 사용해야 하는지 여부를 설정합니다.

false

boolean

transfer exchange (advanced)

TCP에만 사용됩니다. 바디가 아닌 전선으로 교환을 전송할 수 있습니다. 본문, Out body, fault body, In headers, Out headers, fault headers, fault headers, fault headers, exchange properties, exchange exception. 이를 위해 오브젝트를 직렬화할 수 있어야 합니다. Camel은 비합리화 가능한 오브젝트를 제외하고 WARN 수준에서 기록합니다.

false

boolean

udpByteArrayCodec (advanced)

UDP의 경우에만 해당합니다. If enabled using byte array codec instead of Java serialization protocol.

false

boolean

workercount (advanced)

netty가 nio 모드에서 작동하면 Netty의 기본 workerCount 매개변수( cpu_core_threads x 2)를 사용합니다. 이 옵션을 사용하여 Netty에서 기본 workerCount를 재정의할 수 있습니다.

 

int

workerGroup (advanced)

명시적인 EventLoopGroup을 사장 풀로 사용하려면 다음을 수행합니다. 예를 들어 여러 소비자 또는 생산자와 스레드 풀을 공유하는 경우입니다. 기본적으로 각 소비자 또는 프로듀서에는 2 x cpu count 코어 스레드가 있는 자체 작업자 풀이 있습니다.

 

EventLoopGroup

allowDefaultCodec (codec)

netty 구성 요소는 둘 다 인코더/디코더가 null이고 텍스트 줄은 false인 경우 기본 codec를 설치합니다. allowDefaultCodec를 false로 설정하면 netty 구성 요소가 필터 체인의 첫 번째 요소로 기본 codec를 설치할 수 없습니다.

true

boolean

autoAppendDelimiter (codec)

textline codec를 사용하여 보낼 때 누락된 끝 구분 기호를 자동 첨부할지 여부입니다.

true

boolean

디코더MaxLineLength (codec)

textline codec에 사용할 최대 행 길이입니다.

1024

int

디코더 (codec)

사용할 디코더 목록입니다. 쉼표로 구분된 값이 있는 문자열을 사용하여 레지스트리에서 값을 조회할 수 있습니다. # 값을 접두사로 붙여서 Camel이 조회해야 함을 알고 있습니다.

 

list

구분자 (codec)

텍스트 코드c에 사용할 구분 기호입니다. 가능한 값은 LINE 및 NULL입니다.

CloudEvent 값:

  • LINE
  • NULL

LINE

TextLineDelimiter

유니코드 (codec)

사용할 인코더 목록입니다. 쉼표로 구분된 값이 있는 문자열을 사용하여 레지스트리에서 값을 조회할 수 있습니다. # 값을 접두사로 붙여서 Camel이 조회해야 함을 알고 있습니다.

 

list

인코딩 (codec)

textline codec에 사용할 인코딩(Charset 이름)입니다. 제공되지 않는 경우 Camel은 JVM 기본값 collectdset을 사용합니다.

 

문자열

텍스트 줄 (codec)

TCP에만 사용됩니다. codec가 지정되지 않은 경우 이 플래그를 사용하여 텍스트 줄 기반 코드c를 나타낼 수 있습니다. 지정하지 않거나 값이 false인 경우 오브젝트 Serialization은 TCP를 초과한다고 가정하지만 문자열만 기본적으로 직렬화할 수 있습니다.

false

boolean

enabledProtocols (security)

SSL을 사용할 때 활성화할 프로토콜입니다.

TLSv1,TLSv1.1,TLSv1.2

문자열

keyStoreFile (보안)

암호화에 사용할 클라이언트 측 인증서 키 저장소입니다.

 

파일

keyStoreFormat (보안)

페이로드 암호화에 사용되는 키 저장소 형식입니다. 설정되지 않은 경우 기본값은 JKS입니다.

 

문자열

keyStoreResource (보안)

암호화에 사용할 클라이언트 측 인증서 키 저장소입니다. classpath에서 기본적으로 로드되지만 classpath:, file: 또는 http: 접두사를 추가하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

NeedClientAuth (보안)

SSL을 사용할 때 서버에 클라이언트 인증이 필요한지 여부를 설정합니다.

false

boolean

암호 (보안)

SSH를 사용하여 전송된 페이로드를 암호화/암호 해독하기 위해 사용할 암호 설정입니다.

 

문자열

SecurityProvider (보안)

페이로드 암호화에 사용할 보안 공급자입니다. 설정되지 않은 경우 기본값은 SunX509입니다.

 

문자열

SSL (보안)

SSL 암호화가 이 끝점에 적용되는지 여부를 지정하는 설정입니다.

false

boolean

sslClientCertHeaders (보안)

SSL 모드에서 활성화되면 Netty 소비자는 주체 이름, 발행자 이름, 일련 번호, 유효한 날짜 범위와 같은 클라이언트 인증서에 대한 정보가 있는 헤더로 Camel Message를 보강합니다.

false

boolean

sslContextParameters (보안)

SSLContextParameters를 사용하여 보안을 구성하려면 다음을 수행합니다.

 

SSLContextParameters

sslHandler (security)

SSL 처리기를 반환하는 데 사용할 수 있는 클래스에 대한 참조입니다.

 

SslHandler

trustStoreFile (보안)

암호화에 사용할 서버 측 인증서 키 저장소입니다.

 

파일

trustStoreResource (security)

암호화에 사용할 서버 측 인증서 키 저장소입니다. classpath에서 기본적으로 로드되지만 classpath:, file: 또는 http: 접두사를 추가하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

36.5. 레지스트리 기반 옵션

codec 처리기 및 SSL 키 저장소는 Spring XML 파일과 같이 레지스트리에 등록할 수 있습니다. 전달할 수 있는 값은 다음과 같습니다.

이름설명

passphrase

SSH를 사용하여 전송된 페이로드를 암호화/암호화하기 위해 사용할 암호 설정

keyStoreFormat

페이로드 암호화에 사용되는 키 저장소 형식입니다. 설정되지 않은 경우 기본값은 "JKS"입니다.

securityProvider

페이로드 암호화에 사용할 보안 공급자입니다. 설정되지 않은 경우 기본값은 "SunX509"입니다.

keyStoreFile

더 이상 사용되지 않음: 암호화에 사용할 클라이언트 측 인증서 키 저장소

trustStoreFile

더 이상 사용되지 않음: 암호화에 사용되는 서버 측 인증서 키 저장소

keyStoreResource

암호화에 사용할 클라이언트 측 인증서 키 저장소입니다. 기본적으로 classpath에서 로드되지만 "classpath:", "file:" 또는 "http:" 를 추가하여 다른 시스템에서 리소스를 로드할 수 있습니다.

trustStoreResource

암호화에 사용할 서버 측 인증서 키 저장소입니다. 기본적으로 classpath에서 로드되지만 "classpath:", "file:" 또는 "http:" 를 추가하여 다른 시스템에서 리소스를 로드할 수 있습니다.

sslHandler

SSL Handler를 반환하는 데 사용할 수 있는 클래스에 대한 참조

encoder

아웃바운드 페이로드의 특수 마샬링을 수행하는 데 사용할 수 있는 사용자 지정 ChannelHandler 클래스입니다. io.netty.channel.ChannelInboundHandlerAdapter를 덮어써야 합니다.

인코더

사용할 인코더 목록입니다. 쉼표로 구분된 값이 있는 문자열을 사용하여 레지스트리에서 값을 조회할 수 있습니다. # 값을 접두사로 붙여서 Camel이 조회해야 함을 알고 있습니다.

디코더

인바운드 페이로드의 특수 마샬링을 수행하는 데 사용할 수 있는 사용자 지정 ChannelHandler 클래스입니다. io.netty.channel.ChannelOutboundHandlerAdapter를 덮어써야 합니다.

디코더

사용할 디코더 목록입니다. 쉼표로 구분된 값이 있는 문자열을 사용하여 레지스트리에서 값을 조회할 수 있습니다. # 값을 접두사로 붙여서 Camel이 조회해야 함을 알고 있습니다.

참고

공유할 수 없는 인코더/디코더 사용 방법에 대해 아래에서 읽어 보십시오.

36.5.1. 공유할 수 없는 인코더 또는 디코더 사용

인코더 또는 디코더를 공유할 수 없는 경우(예: @Shareable 클래스 주석이 없음) 인코더/디코더가 org.apache.camel.component.netty.ChannelHandlerFactory 인터페이스를 구현하고 새 ChannelHandler 메서드에서 새 인스턴스를 반환해야 합니다. 이는 인코더/디코더를 안전하게 사용할 수 있도록 하기 위한 것입니다. 그렇지 않은 경우 엔드포인트가 생성되면 Netty 구성 요소가 WARN을 기록합니다.

Netty 구성 요소는 일반적으로 사용되는 여러 가지 방법이 있는 org.apache.camel.component.netty.ChannelHandlerFactories 클래스를 제공합니다.

36.6. Netty 끝점으로/에서 메시지 전송

36.6.1. Netty Producer

Producer 모드에서 구성 요소는 TCP 또는 UDP 프로토콜 (선택 사항 SSL 지원)을 사용하여 소켓 끝점에 페이로드를 보내는 기능을 제공합니다.

생산자 모드는 단방향 및 요청 응답 기반 작업을 모두 지원합니다.

36.6.2. Netty Consumer

소비자 모드에서 구성 요소는 다음을 수행할 수 있는 기능을 제공합니다.

  • TCP 또는 UDP 프로토콜을 사용하여 지정된 소켓에서 청취 (선택 사항 SSL 지원)
  • text/xml, 바이너리 및 직렬화된 오브젝트 기반 페이로드를 사용하여 소켓에 대한 요청을 수신합니다.
  • 경로에 메시지 교환으로 이를 전송합니다.

소비자 모드는 단방향 및 요청 응답 기반 작업을 모두 지원합니다.

36.7. 예

36.7.1. Request-Reply 및 직렬화된 오브젝트 페이로드를 사용하는 UDP Netty 끝점

개체 직렬화는 기본적으로 허용되지 않으므로 디코더를 구성해야 합니다.

@BindToRegistry("decoder")
public ChannelHandler getDecoder() throws Exception {
    return new DefaultChannelHandlerFactory() {
        @Override
        public ChannelHandler newChannelHandler() {
            return new DatagramPacketObjectDecoder(ClassResolvers.weakCachingResolver(null));
        }
    };
}

RouteBuilder builder = new RouteBuilder() {
  public void configure() {
    from("netty:udp://0.0.0.0:5155?sync=true&decoders=#decoder")
      .process(new Processor() {
         public void process(Exchange exchange) throws Exception {
           Poetry poetry = (Poetry) exchange.getIn().getBody();
           // Process poetry in some way
           exchange.getOut().setBody("Message received);
         }
       }
    }
};

36.7.2. 단방향 통신을 사용하는 TCP 기반 Netty 소비자 끝점

RouteBuilder builder = new RouteBuilder() {
  public void configure() {
       from("netty:tcp://0.0.0.0:5150")
           .to("mock:result");
  }
};

36.7.3. Request-Reply 통신을 사용하는 SSL/TCP 기반 Netty 소비자 끝점

JSSE 설정 utility 사용

Netty 구성 요소는 Camel JSSE 구성 utility 를 통해 SSL/TLS 구성을 지원합니다. 이 유틸리티를 사용하면 작성하는데 필요한 구성 요소별 코드의 양이 크게 감소하고 끝점 및 구성 요소 수준에서 구성할 수 있습니다. 다음 예제에서는 Netty 구성 요소에서 유틸리티를 사용하는 방법을 보여줍니다.

구성 요소의 프로그래밍 방식 구성

KeyStoreParameters ksp = new KeyStoreParameters();
ksp.setResource("/users/home/server/keystore.jks");
ksp.setPassword("keystorePassword");

KeyManagersParameters kmp = new KeyManagersParameters();
kmp.setKeyStore(ksp);
kmp.setKeyPassword("keyPassword");

SSLContextParameters scp = new SSLContextParameters();
scp.setKeyManagers(kmp);

NettyComponent nettyComponent = getContext().getComponent("netty", NettyComponent.class);
nettyComponent.setSslContextParameters(scp);

끝점의 Spring DSL 기반 구성

...
  <camel:sslContextParameters
      id="sslContextParameters">
    <camel:keyManagers
        keyPassword="keyPassword">
      <camel:keyStore
          resource="/users/home/server/keystore.jks"
          password="keystorePassword"/>
    </camel:keyManagers>
  </camel:sslContextParameters>...
...
  <to uri="netty:tcp://0.0.0.0:5150?sync=true&ssl=true&sslContextParameters=#sslContextParameters"/>
...

>-<ty Component에서 기본 SSL/TLS 구성 사용

Registry registry = context.getRegistry();
registry.bind("password", "changeit");
registry.bind("ksf", new File("src/test/resources/keystore.jks"));
registry.bind("tsf", new File("src/test/resources/keystore.jks"));

context.addRoutes(new RouteBuilder() {
  public void configure() {
      String netty_ssl_endpoint =
         "netty:tcp://0.0.0.0:5150?sync=true&ssl=true&passphrase=#password"
         + "&keyStoreFile=#ksf&trustStoreFile=#tsf";
      String return_string =
         "When You Go Home, Tell Them Of Us And Say,"
         + "For Your Tomorrow, We Gave Our Today.";

      from(netty_ssl_endpoint)
       .process(new Processor() {
          public void process(Exchange exchange) throws Exception {
            exchange.getOut().setBody(return_string);
          }
       }
  }
});

SSLSession 및 클라이언트 인증서에 대한 액세스 권한 얻기

클라이언트 인증서에 대한 세부 정보를 가져와야 하는 경우 javax.net.ssl.SSLSession 에 액세스할 수 있습니다. ssl=true 인 경우 Netty 구성 요소는 다음과 같이 Camel Message에 헤더로 SSLSession 을 저장합니다.

SSLSession session = exchange.getIn().getHeader(NettyConstants.NETTY_SSL_SESSION, SSLSession.class);
// get the first certificate which is client certificate
javax.security.cert.X509Certificate cert = session.getPeerCertificateChain()[0];
Principal principal = cert.getSubjectDN();

클라이언트를 인증하기 위해 needClientAuth=true 를 설정해야 합니다. SSLSession 는 클라이언트 인증서에 대한 정보에 액세스할 수 없으며 예외 javax.net.ssl.SSLPeerUnverifiedException: peer not authenticated. 클라이언트 인증서가 만료되었거나 유효하지 않은 경우 예외가 발생할 수 있습니다.

참고

sslClientCertHeaders 옵션을 true 로 설정하면 클라이언트 인증서에 대한 세부 정보가 있는 헤더로 Camel Message를 보강할 수 있습니다. 예를 들어 제목 이름은 CamelNettySSLClientCertSubjectName 헤더에서 쉽게 사용할 수 있습니다.

36.7.4. 다중 코드 사용

어떤 경우에는 인코더 및 디코더의 체인을 netty 파이프라인에 추가해야 할 수도 있습니다. camel netty 엔드포인트에 multpile codecs를 추가하려면 'encoders' 및 'decoders' uri 매개변수를 사용해야 합니다. 'encoder' 및 'decoder' 매개변수는 파이프라인에 추가해야 하는 참조(채널Up스트림 처리기 및 ChannelDownstreamHandler 목록)를 제공하는 데 사용됩니다. 인코더가 지정된 경우 디코더 및 디코더 매개 변수에 대해 인코더 매개 변수가 무시됩니다.

참고

공유할 수 없는 인코더/디코더 사용에 대해 자세히 알아보십시오.

엔드포인트가 생성될 때 해결될 수 있도록 Camel의 레지스트리에 codecs 목록을 추가해야 합니다.

ChannelHandlerFactory lengthDecoder = ChannelHandlerFactories.newLengthFieldBasedFrameDecoder(1048576, 0, 4, 0, 4);

StringDecoder stringDecoder = new StringDecoder();
registry.bind("length-decoder", lengthDecoder);
registry.bind("string-decoder", stringDecoder);

LengthFieldPrepender lengthEncoder = new LengthFieldPrepender(4);
StringEncoder stringEncoder = new StringEncoder();
registry.bind("length-encoder", lengthEncoder);
registry.bind("string-encoder", stringEncoder);

List<ChannelHandler> decoders = new ArrayList<ChannelHandler>();
decoders.add(lengthDecoder);
decoders.add(stringDecoder);

List<ChannelHandler> encoders = new ArrayList<ChannelHandler>();
encoders.add(lengthEncoder);
encoders.add(stringEncoder);

registry.bind("encoders", encoders);
registry.bind("decoders", decoders);

Spring의 네이티브 컬렉션 지원을 사용하여 애플리케이션 컨텍스트에서 codec 목록을 지정할 수 있습니다.

<util:list id="decoders" list-class="java.util.LinkedList">
        <bean class="org.apache.camel.component.netty.ChannelHandlerFactories" factory-method="newLengthFieldBasedFrameDecoder">
            <constructor-arg value="1048576"/>
            <constructor-arg value="0"/>
            <constructor-arg value="4"/>
            <constructor-arg value="0"/>
            <constructor-arg value="4"/>
        </bean>
        <bean class="io.netty.handler.codec.string.StringDecoder"/>
    </util:list>

    <util:list id="encoders" list-class="java.util.LinkedList">
        <bean class="io.netty.handler.codec.LengthFieldPrepender">
            <constructor-arg value="4"/>
        </bean>
        <bean class="io.netty.handler.codec.string.StringEncoder"/>
    </util:list>

    <bean id="length-encoder" class="io.netty.handler.codec.LengthFieldPrepender">
        <constructor-arg value="4"/>
    </bean>
    <bean id="string-encoder" class="io.netty.handler.codec.string.StringEncoder"/>

    <bean id="length-decoder" class="org.apache.camel.component.netty.ChannelHandlerFactories" factory-method="newLengthFieldBasedFrameDecoder">
        <constructor-arg value="1048576"/>
        <constructor-arg value="0"/>
        <constructor-arg value="4"/>
        <constructor-arg value="0"/>
        <constructor-arg value="4"/>
    </bean>
    <bean id="string-decoder" class="io.netty.handler.codec.string.StringDecoder"/>

그런 다음 빈 이름을 쉼표로 구분된 목록으로 지정하거나 목록에 포함된 순 엔드포인트 정의에 사용할 수 있습니다.

 from("direct:multiple-codec").to("netty:tcp://0.0.0.0:{{port}}?encoders=#encoders&sync=false");

 from("netty:tcp://0.0.0.0:{{port}}?decoders=#length-decoder,#string-decoder&sync=false").to("mock:multiple-codec");

또는 XML을 통해

<camelContext id="multiple-netty-codecs-context" xmlns="http://camel.apache.org/schema/spring">
    <route>
        <from uri="direct:multiple-codec"/>
        <to uri="netty:tcp://0.0.0.0:5150?encoders=#encoders&amp;sync=false"/>
    </route>
    <route>
        <from uri="netty:tcp://0.0.0.0:5150?decoders=#length-decoder,#string-decoder&amp;sync=false"/>
        <to uri="mock:multiple-codec"/>
    </route>
</camelContext>

36.8. 종료 후 채널 종료

서버 역할을 할 때 예를 들어 클라이언트 변환이 완료되면 채널을 종료하려는 경우가 있습니다.
끝점 옵션 disconnect=true 를 설정하여 이 작업을 수행할 수 있습니다.

그러나 다음과 같이 Camel에 메시지별로 지시할 수도 있습니다.
Camel이 채널을 종료하도록 지시하려면 CamelNetty CloudEventChannel>-<Complete 키가 있는 헤더를 부울 true 값으로 추가해야 합니다.
예를 들어 아래 예제에서는 bye 메시지를 클라이언트에 다시 작성한 후 채널을 종료합니다.

from("netty:tcp://0.0.0.0:8080").process(new Processor() {
    public void process(Exchange exchange) throws Exception {
        String body = exchange.getIn().getBody(String.class);
        exchange.getOut().setBody("Bye " + body);
        // some condition which determines if we should close
        if (close) {
            exchange.getOut().setHeader(NettyConstants.NETTY_CLOSE_CHANNEL_WHEN_COMPLETE, true);
        }
    }
});

생성된 파이프라인에 대한 완전한 제어를 얻기 위해 사용자 정의 채널 파이프라인 팩토리 추가

36.9. 사용자 정의 파이프라인

사용자 정의 채널 파이프라인은 매우 간단한 방법으로 Netty Endpoint URL에 지정하지 않고도 사용자 정의 처리기(s), 인코더 및 디코더를 삽입하여 처리기/차단 체인에 완전한 제어를 제공합니다.

사용자 지정 파이프라인을 추가하려면 컨텍스트 레지스트리(Registry 또는 camel-spring ApplicationContextRegistry 등)를 통해 컨텍스트로 사용자 정의 채널 파이프라인 팩토리를 생성하고 등록해야 합니다.

사용자 정의 파이프라인 팩토리는 다음과 같이 구성되어야 합니다.

  • Producer 연결 채널 파이프라인 팩토리에서 추상 클래스 ClientPipelineFactory 를 확장해야 합니다.
  • 소비자 연결 채널 파이프라인 팩토리에서 추상 클래스 Server>-<rFactory 를 확장해야 합니다.
  • 클래스는 사용자 정의 처리기, 인코더 및 디코더를 삽입하기 위해 initChannel() 메서드를 재정의해야 합니다. initChannel() 메서드를 재정의하지 않으면 파이프라인에 연결된 처리기, 인코더 또는 디코더 없이 파이프라인이 생성됩니다.

아래 예제에서는 Server>-<rFactory 팩토리를 만드는 방법을 보여줍니다.

36.9.1. 사용자 정의 파이프라인 팩토리 사용

public class SampleServerInitializerFactory extends ServerInitializerFactory {
    private int maxLineSize = 1024;

    protected void initChannel(Channel ch) throws Exception {
        ChannelPipeline channelPipeline = ch.pipeline();

        channelPipeline.addLast("encoder-SD", new StringEncoder(CharsetUtil.UTF_8));
        channelPipeline.addLast("decoder-DELIM", new DelimiterBasedFrameDecoder(maxLineSize, true, Delimiters.lineDelimiter()));
        channelPipeline.addLast("decoder-SD", new StringDecoder(CharsetUtil.UTF_8));
        // here we add the default Camel ServerChannelHandler for the consumer, to allow Camel to route the message etc.
        channelPipeline.addLast("handler", new ServerChannelHandler(consumer));
    }
}

그런 다음 사용자 정의 채널 파이프라인 팩토리를 레지스트리에 추가하고 다음과 같은 방식으로 camel 경로에서 인스턴스화/사용할 수 있습니다.

Registry registry = camelContext.getRegistry();
ServerInitializerFactory factory = new TestServerInitializerFactory();
registry.bind("spf", factory);
context.addRoutes(new RouteBuilder() {
  public void configure() {
      String netty_ssl_endpoint =
         "netty:tcp://0.0.0.0:5150?serverInitializerFactory=#spf"
      String return_string =
         "When You Go Home, Tell Them Of Us And Say,"
         + "For Your Tomorrow, We Gave Our Today.";

      from(netty_ssl_endpoint)
       .process(new Processor() {
          public void process(Exchange exchange) throws Exception {
            exchange.getOut().setBody(return_string);
          }
       }
  }
});

36.10. Netty 사장 및 작업자 스레드 풀 재사용

Netty에는 두 종류의 스레드 풀이 있습니다: 사장과 작업자. 기본적으로 각 Netty 소비자 및 생산자에는 개인 스레드 풀이 있습니다. 여러 소비자 또는 생산자 간에 이러한 스레드 풀을 재사용하려면 레지스트리에서 스레드 풀을 생성하고 등록해야 합니다.

예를 들어 Spring XML을 사용하여 다음과 같이 두 개의 작업자 스레드가 있는 NettyWorkerPoolBuilder 를 사용하여 공유 작업자 스레드 풀을 생성할 수 있습니다.

<!-- use the worker pool builder to help create the shared thread pool -->
<bean id="poolBuilder" class="org.apache.camel.component.netty.NettyWorkerPoolBuilder">
  <property name="workerCount" value="2"/>
</bean>

<!-- the shared worker thread pool -->
<bean id="sharedPool" class="org.jboss.netty.channel.socket.nio.WorkerPool"
      factory-bean="poolBuilder" factory-method="build" destroy-method="shutdown">
</bean>
참고

사장 스레드 풀의 경우 Netty consumers를 위한 org.apache.camel.component.netty.netty.nettyServerBossPoolBuilder 빌더와 Netty 생산자의 org.apache.camel.component.nettyClientBossPoolBuilder 가 있습니다.

그런 다음 Camel 경로에서 다음과 같이 URI에 workerPool 옵션을 구성하여 이 작업자 풀을 참조할 수 있습니다.

<route>
  <from uri="netty:tcp://0.0.0.0:5021?textline=true&amp;sync=true&amp;workerPool=#sharedPool&amp;usingExecutorService=false"/>
  <to uri="log:result"/>
  ...
</route>

그리고 다른 경로가 있으면 공유 작업자 풀을 참조할 수 있습니다.

<route>
  <from uri="netty:tcp://0.0.0.0:5022?textline=true&amp;sync=true&amp;workerPool=#sharedPool&amp;usingExecutorService=false"/>
  <to uri="log:result"/>
  ...
</route>

기타 등등.

36.11. request/reply와 단일 연결을 통해 동시 메시지 멀티플렉싱

netty 생산자를 통한 요청/응답 메시징에 Netty를 사용하는 경우 기본적으로 각 메시지는 비공유 연결(풀됨)을 통해 전송됩니다. 이렇게 하면 응답이 Camel에서 추가 라우팅을 위해 올바른 요청 스레드에 자동으로 매핑할 수 있습니다. 즉, 요청/응답 메시지 간의 상관관계는 응답이 요청을 보내는 데 사용된 것과 동일한 연결로 반환되기 때문에 즉시 사용되므로 이 연결은 다른 메시지와 공유되지 않습니다. 응답이 다시 제공되면 연결은 다른 사용자가 재사용할 수 있는 연결 풀로 다시 반환됩니다.

그러나 단일 공유 연결에서 동시 요청/응답을 멀티x하려면 producerPoolEnabled=false 를 설정하여 연결 풀링을 해제해야 합니다. 이제 응답이 다시 정렬되지 않으면 인터리브된 응답과 관련된 잠재적 문제가 있음을 의미합니다. 따라서 요청 및 응답 메시지 모두에 상관관계 ID가 있어야 Camel에서 메시지 처리를 계속 수행하는 Camel 콜백에 대한 응답의 상관 관계가 적절히 연관될 수 있습니다. 이렇게 하려면 NettyCamelStateCorrelationManager 를 상관 관리자로 구현하고 correlationManager=#myManager 옵션을 통해 구성해야 합니다.

참고

사용자 정의 상관 관리자 빌드 시 TimeoutCorrelationManagerSupport 를 확장하는 것이 좋습니다. 이는 구현에 필요한 시간 초과 및 기타 복잡성도 지원합니다.

Apache Camel 소스 코드가 camel-example-netty-custom-correlation 디렉터리의 예제 디렉터리에 있는 예를 찾을 수 있습니다.

36.12. Spring Boot Auto-Configuration

Spring Boot와 함께 netty를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-netty-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.netty.allow-default-codec

netty 구성 요소는 둘 다 인코더/디코더가 null이고 텍스트 줄은 false인 경우 기본 codec를 설치합니다. allowDefaultCodec를 false로 설정하면 netty 구성 요소가 필터 체인의 첫 번째 요소로 기본 codec를 설치할 수 없습니다.

true

부울

camel.component.netty.allow-serialized-headers

transferExchange가 true인 경우에만 TCP에 사용됩니다. true로 설정하면 헤더 및 속성의 직렬화 가능 개체가 교환에 추가됩니다. 그렇지 않으면 Camel이 비합리화 가능한 오브젝트를 제외하고 WARN 수준에서 기록합니다.

false

부울

camel.component.netty.auto-append-delimiter

textline codec를 사용하여 보낼 때 누락된 끝 구분 기호를 자동 첨부할지 여부입니다.

true

부울

camel.component.netty.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.netty.backlog

netty consumer(server)에 대한 백로그를 구성할 수 있습니다. 백로그는 OS에 따라 최선의 노력일 뿐입니다. 이 옵션을 200, 500 또는 1000과 같은 값으로 설정하면 이 옵션이 구성되지 않은 경우 TCP 스택에 허용 큐가 될 수 있는 시간을 알려주며 백로그는 OS 설정에 따라 달라집니다.

 

정수

camel.component.netty.boss-count

netty가 nio 모드에서 작동할 때, Netty의 기본 rateCount 매개 변수를 사용합니다. 사용자는 이 옵션을 사용하여 Netty에서 기본gerCount를 재정의할 수 있습니다.

1

정수

camel.component.netty.boss-group

NettyEndpoint에서 서버 측의 새 연결을 처리하는 데 사용할 수 있는 BossGroup을 설정합니다. 옵션은 io.netty.channel.EventLoopGroup 유형입니다.

 

EventLoopGroup

camel.component.netty.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.netty.broadcast

를 설정하여 UDP를 통한 멀티 캐스트를 선택합니다.

false

부울

camel.component.netty.channel-group

명시적 ChannelGroup을 사용하려면 다음을 수행합니다. 옵션은 io.netty.channel.group.ChannelGroup 유형입니다.

 

ChannelGroup

camel.component.netty.client-initializer-factory

사용자 정의 Client>-<rFactory를 사용하려면 다음을 수행합니다. 옵션은 org.apache.camel.component.netty.Client>-<rFactory 유형입니다.

 

ClientInitializerFactory

camel.component.netty.client-mode

clientMode가 true인 경우 netty 소비자는 주소를 TCP 클라이언트로 연결합니다.

false

부울

camel.component.netty.configuration

엔드포인트를 생성할 때 NettyConfiguration을 구성으로 사용하려면 다음을 수행하십시오. 옵션은 org.apache.camel.component.netty.NettyConfiguration 유형입니다.

 

NettyConfiguration

camel.component.netty.connect-timeout

소켓 연결을 사용할 수 있을 때까지 대기하는 시간입니다. 값은 밀리초 단위입니다.

10000

정수

camel.component.netty.correlation-manager

사용자 정의 상관 관계 관리자를 사용하여 request/reply를 netty 생산자와 함께 사용할 때 요청 및 응답 메시지를 매핑하는 방법을 관리합니다. 요청 및 응답 메시지에 상관 관계가 있는 경우와 같은 응답과 함께 요청을 매핑할 수 있는 방법이 있는 경우에만 사용해야 합니다. 이는 netty의 동일한 채널(연결)에서 여러 동시 메시지를 멀티x로 사용하려는 경우 사용할 수 있습니다. 이 작업을 수행할 때 요청 및 응답 메시지의 상관 관계를 유지하는 방법이 있어야 하므로 진행 중인 Camel Exchange에 올바른 응답을 저장할 수 있습니다. 사용자 정의 상관 관리자 빌드 시 TimeoutCorrelationManagerSupport를 확장하는 것이 좋습니다. 이는 구현에 필요한 시간 초과 및 기타 복잡성도 지원합니다. 자세한 내용은 producerPoolEnabled 옵션도 참조하십시오. 옵션은 org.apache.camel.component.netty.NettyCamelStateCorrelationManager 유형입니다.

 

NettyCamelStateCorrelationManager

camel.component.netty.decoder-max-line-length

textline codec에 사용할 최대 행 길이입니다.

1024

정수

camel.component.netty.decoders

사용할 디코더 목록입니다. 쉼표로 구분된 값이 있는 문자열을 사용하여 레지스트리에서 값을 조회할 수 있습니다. # 값을 접두사로 붙여서 Camel이 조회해야 함을 알고 있습니다.

 

문자열

camel.component.netty.delimiter

텍스트 코드c에 사용할 구분 기호입니다. 가능한 값은 LINE 및 NULL입니다.

 

TextLineDelimiter

camel.component.netty.disconnect

사용 후 Netty Channel에서 연결을 해제할지 여부입니다. 소비자 및 생산자 모두에 사용할 수 있습니다.

false

부울

camel.component.netty.disconnect-on-no-reply

동기화가 활성화되면 이 옵션은 다시 보낼 응답이 없는 위치에서 연결을 해제해야 하는 경우 NettyConsumer를 지시합니다.

true

부울

camel.component.netty.enabled

netty 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.netty.enabled-protocols

SSL을 사용할 때 활성화할 프로토콜입니다.

TLSv1,TLSv1.1,TLSv1.2

문자열

camel.component.netty.encoders

사용할 인코더 목록입니다. 쉼표로 구분된 값이 있는 문자열을 사용하여 레지스트리에서 값을 조회할 수 있습니다. # 값을 접두사로 붙여서 Camel이 조회해야 함을 알고 있습니다.

 

문자열

camel.component.netty.encoding

textline codec에 사용할 인코딩(Charset 이름)입니다. 제공되지 않는 경우 Camel은 JVM 기본값 collectdset을 사용합니다.

 

문자열

camel.component.netty.executor-service

지정된 EventExecutorGroup을 사용합니다. 옵션은 io.netty.util.concurrent.EventExecutorGroup 유형입니다.

 

EventExecutorGroup

camel.component.netty.hostname-verification

SSLEngine에서 호스트 이름 확인을 활성화/비활성화하려면 다음을 수행합니다.

false

부울

camel.component.netty.keep-alive

비활성으로 인해 소켓이 닫히지 않도록 설정

true

부울

camel.component.netty.key-store-file

암호화에 사용할 클라이언트 측 인증서 키 저장소입니다.

 

파일

camel.component.netty.key-store-format

페이로드 암호화에 사용되는 키 저장소 형식입니다. 설정되지 않은 경우 기본값은 JKS입니다.

 

문자열

camel.component.netty.key-store-resource

암호화에 사용할 클라이언트 측 인증서 키 저장소입니다. classpath에서 기본적으로 로드되지만 classpath:, file: 또는 http: 접두사를 추가하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

camel.component.netty.lazy-channel-creation

Camel 프로듀서가 시작될 때 원격 서버가 가동되지 않고 실행되지 않는 경우 예외 없이 채널을 생성할 수 있습니다.

true

부울

camel.component.netty.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.netty.maximum-pool-size

netty 소비자 순서가 지정된 스레드 풀에 대한 최대 스레드 풀 크기를 설정합니다. 기본 크기는 2 x cpu_core + 1입니다. 이 값을 eg 10으로 설정하면 2 x cpu_core + 1이 더 높은 값인 경우를 제외하고 10개의 스레드가 사용됩니다. 예를 들어 8개의 코어가 있는 경우 소비자 스레드 풀은 17이 됩니다. 이 스레드 풀은 Camel로 Netty에서 수신한 메시지를 라우팅하는 데 사용됩니다. 별도의 스레드 풀을 사용하여 메시지 순서를 정하고 일부 메시지가 차단되는 경우에도 nettys 작업자 스레드(event loop)가 영향을 받습니다.

 

정수

camel.component.netty.native-transport

NIO 대신 기본 전송을 사용할지 여부입니다. 네이티브 전송은 호스트 운영 체제를 사용하며 일부 플랫폼에서만 지원됩니다. 사용 중인 호스트 운영 체제에 netty JAR을 추가해야 합니다. 자세한 내용은 다음에서 참조하십시오.

false

부울

camel.component.netty.need-client-auth

SSL을 사용할 때 서버에 클라이언트 인증이 필요한지 여부를 설정합니다.

false

부울

camel.component.netty.netty-server-bootstrap-factory

사용자 정의 NettyServerBootstrapFactory를 사용하려면 다음을 수행합니다. 옵션은 org.apache.camel.component.netty.NettyServerBootstrapFactory 유형입니다.

 

NettyServerBootstrapFactory

camel.component.netty.network-interface

UDP를 사용하는 경우 이 옵션을 사용하여 멀티 캐스트 그룹에 가입하기 위해 eth0과 같은 네트워크 인터페이스를 이름으로 지정할 수 있습니다.

 

문자열

camel.component.netty.no-reply-log-level

동기화가 활성화된 경우 이 옵션을 사용하면 NettyConsumer가 로깅할 때 사용할 로깅 수준을 지정할 수 있습니다.

 

LoggingLevel

camel.component.netty.options

option.을 접두사로 사용하여 추가 netty 옵션을 구성할 수 있습니다. 예를 들어, netty 옵션 child.keepAlive=false를 설정하려면 option.child.keepAlive=false를 설정합니다. 사용할 수 있는 가능한 옵션은 Netty 설명서를 참조하십시오.

 

map

camel.component.netty.passphrase

SSH를 사용하여 전송된 페이로드를 암호화/암호 해독하기 위해 사용할 암호 설정입니다.

 

문자열

camel.component.netty.producer-pool-enabled

생산자 풀이 활성화되었는지 여부입니다. 중요: 이 기능을 해제하면 프로듀서에 단일 공유 연결이 사용되며 요청/응답을 수행하는 경우에도 마찬가지입니다. 즉, 응답이 다시 정렬되지 않으면 인터리브된 응답과 관련된 잠재적 문제가 있습니다. 따라서 요청 및 응답 메시지 모두에 상관관계 ID가 있어야 Camel에서 메시지 처리를 계속 수행하는 Camel 콜백에 대한 응답의 상관 관계가 적절히 연관될 수 있습니다. 이렇게 하려면 NettyCamelStateCorrelationManager를 상관 관리자로 구현하고 correlationManager 옵션을 통해 구성해야 합니다. 자세한 내용은 correlationManager 옵션을 참조하십시오.

true

부울

camel.component.netty.producer-pool-max-idle

풀의 유휴 인스턴스 수에 대한 제한을 설정합니다.

100

정수

camel.component.netty.producer-pool-max-total

지정된 시간에 풀에서 할당할 수 있는 오브젝트 수(클라이언트로 확인, 또는 유휴 상태로 대기 중) 수를 설정합니다. 제한 없이 음수 값을 사용합니다.

-1

정수

camel.component.netty.producer-pool-min-evictable-idle

개체가 유휴 상태 오브젝트 evictor에 의해 제거되기 전에 개체가 풀에 유휴 상태에 있을 수 있는 최소 시간(밀로 값)을 설정합니다.

300000

long

camel.component.netty.producer-pool-min-idle

Evictor 스레드(활성인 경우)가 새 오브젝트를 생성하기 전에 생산자 풀에 허용되는 최소 인스턴스 수를 설정합니다.

 

정수

camel.component.netty.receive-buffer-size

인바운드 통신 중에 사용할 TCP/UDP 버퍼 크기입니다. 크기는 바이트입니다.

65536

정수

camel.component.netty.receive-buffer-size-predictor

버퍼 크기 예측기를 구성합니다. 자세한 내용은 이 메일 스레드 및 문서 문서를 참조하십시오.

 

정수

camel.component.netty.reconnect

소비자의 clientMode에만 사용되는 소비자는 이 기능이 활성화된 경우 연결 해제 시 다시 연결을 시도합니다.

true

부울

camel.component.netty.reconnect-interval

reconnect 및 clientMode가 활성화된 경우 사용합니다. 재연결을 시도하는 간격(밀리초)입니다.

10000

정수

camel.component.netty.request-timeout

원격 서버를 호출할 때 Netty 생산자에 대한 타임아웃을 사용할 수 있습니다. 기본적으로 제한 시간은 사용되지 않습니다. 값은 밀리 초이므로, 30000은 30초입니다. requestTimeout은 Netty의 ReadTimeoutHandler를 사용하여 시간 초과를 트리거합니다.

 

long

camel.component.netty.reuse-address

소켓 멀티플렉싱을 용이하게 하려면 를 설정합니다.

true

부울

camel.component.netty.reuse-channel

이 옵션을 사용하면 생산자와 소비자(클라이언트 모드에서)가 교환 처리 라이프사이클에 대해 동일한 Netty 채널을 재사용할 수 있습니다. 이 기능은 Camel 경로에서 서버를 여러 번 호출하고 동일한 네트워크 연결을 사용하려는 경우에 유용합니다. 이 기능을 사용하면 채널이 Exchange가 완료될 때까지 연결 풀로 반환되지 않으며, 연결 해제 옵션이 true로 설정된 경우 연결이 해제되지 않습니다. 재사용된 채널은 라우팅 중에 채널을 가져와서 사용할 수 있는 NettyConstants#NETTY_CHANNEL 키가 있는 교환 속성으로 교환에 저장됩니다.

false

부울

camel.component.netty.security-provider

페이로드 암호화에 사용할 보안 공급자입니다. 설정되지 않은 경우 기본값은 SunX509입니다.

 

문자열

camel.component.netty.send-buffer-size

아웃바운드 통신 중에 사용할 TCP/UDP 버퍼 크기입니다. 크기는 바이트입니다.

65536

정수

camel.component.netty.server-closed-channel-exception-caught-log-level

서버(NettyConsumer)가 java.nio.channels.ECDHEdChannelException을 캡처하면 이 로깅 수준을 사용하여 기록됩니다. 클라이언트가 갑자기 연결을 끊은 다음 Netty 서버에서 폐쇄된 예외의 플러드를 일으킬 수 있으므로 폐쇄된 채널 예외를 기록하지 않도록 하는 데 사용됩니다.

 

LoggingLevel

camel.component.netty.server-exception-caught-log-level

서버(NettyConsumer)가 예외를 발견하면 이 로깅 수준을 사용하여 기록됩니다.

 

LoggingLevel

camel.component.netty.server-initializer-factory

사용자 정의 Server>-<rFactory를 사용하려면 다음을 수행합니다. 옵션은 org.apache.camel.component.netty.Server>-<rFactory 유형입니다.

 

ServerInitializerFactory

camel.component.netty.ssl

SSL 암호화가 이 끝점에 적용되는지 여부를 지정하는 설정입니다.

false

부울

camel.component.netty.ssl-client-cert-headers

SSL 모드에서 활성화되면 Netty 소비자는 주체 이름, 발행자 이름, 일련 번호, 유효한 날짜 범위와 같은 클라이언트 인증서에 대한 정보가 있는 헤더로 Camel Message를 보강합니다.

false

부울

camel.component.netty.ssl-context-parameters

SSLContextParameters를 사용하여 보안을 구성하려면 다음을 수행합니다. 옵션은 org.apache.camel.support.jsse.SSLContextParameters 유형입니다.

 

SSLContextParameters

camel.component.netty.ssl-handler

SSL 처리기를 반환하는 데 사용할 수 있는 클래스에 대한 참조입니다. 옵션은 io.netty.handler.ssl.SslHandler 유형입니다.

 

SslHandler

camel.component.netty.sync

끝점을 단방향 또는 요청-응답으로 설정.

true

부울

camel.component.netty.tcp-no-delay

TCP 프로토콜 성능을 개선하기 위해 를 설정합니다.

true

부울

camel.component.netty.textline

TCP에만 사용됩니다. codec가 지정되지 않은 경우 이 플래그를 사용하여 텍스트 줄 기반 코드c를 나타낼 수 있습니다. 지정하지 않거나 값이 false인 경우 오브젝트 Serialization은 TCP를 초과한다고 가정하지만 문자열만 기본적으로 직렬화할 수 있습니다.

false

부울

camel.component.netty.transfer-exchange

TCP에만 사용됩니다. 바디가 아닌 전선으로 교환을 전송할 수 있습니다. 본문, Out body, fault body, In headers, Out headers, fault headers, fault headers, fault headers, exchange properties, exchange exception. 이를 위해 오브젝트를 직렬화할 수 있어야 합니다. Camel은 비합리화 가능한 오브젝트를 제외하고 WARN 수준에서 기록합니다.

false

부울

camel.component.netty.trust-store-file

암호화에 사용할 서버 측 인증서 키 저장소입니다.

 

파일

camel.component.netty.trust-store-resource

암호화에 사용할 서버 측 인증서 키 저장소입니다. classpath에서 기본적으로 로드되지만 classpath:, file: 또는 http: 접두사를 추가하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

camel.component.netty.udp-byte-array-codec

UDP의 경우에만 해당합니다. If enabled using byte array codec instead of Java serialization protocol.

false

부울

camel.component.netty.udp-connectionless-sending

이 옵션은 실제 불과 잊어 버린 연결 less udp 전송을 지원합니다. 연결된 udp send은 수신 포트에서 수신 대기 중 없는 경우 PortUnreachableException을 수신합니다.

false

부울

camel.component.netty.use-byte-buf

useByteBuf가 true인 경우 netty 생산자는 메시지를 보내기 전에 메시지 본문을 10.0.0.1Buf로 전환합니다.

false

부울

camel.component.netty.use-global-ssl-context-parameters

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

부울

camel.component.netty.using-executor-service

순서가 지정된 스레드 풀을 사용하여 이벤트가 동일한 채널에서 순서대로 처리되도록 합니다.

true

부울

camel.component.netty.worker-count

netty가 nio 모드에서 작동하면 Netty의 기본 workerCount 매개변수( cpu_core_threads x 2)를 사용합니다. 이 옵션을 사용하여 Netty에서 기본 workerCount를 재정의할 수 있습니다.

 

정수

camel.component.netty.worker-group

명시적인 EventLoopGroup을 사장 풀로 사용하려면 다음을 수행합니다. 예를 들어 여러 소비자 또는 생산자와 스레드 풀을 공유하는 경우입니다. 기본적으로 각 소비자 또는 프로듀서에는 2 x cpu count 코어 스레드가 있는 자체 작업자 풀이 있습니다. 옵션은 io.netty.channel.EventLoopGroup 유형입니다.

 

EventLoopGroup

37장. PAHO

생산자 및 소비자 모두 지원

PAHO 구성 요소는 Eclipse Paho 라이브러리를 사용하여 MQTT 메시징 프로토콜용 커넥터를 제공합니다. PAHO는 가장 인기있는 MQTT 라이브러리 중 하나이므로 Java 프로젝트와 통합하려는 경우 Camel Paho 커넥터가 이동할 수 있습니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-paho</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

37.1. URI 형식

paho:topic[?options]

여기서 topic 은 주제의 이름입니다.

37.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

37.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

37.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다.

즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

37.3. 구성 요소 옵션

Paho 구성 요소는 아래에 나열된 31 옵션을 지원합니다.

이름설명Default유형

automaticReconnect (common)

연결이 손실되는 경우 클라이언트가 서버에 자동으로 다시 연결할지 여부를 설정합니다. false로 설정하면 연결이 손실되는 경우 클라이언트는 서버에 자동으로 다시 연결하지 않습니다. true로 설정하면 연결이 손실되면 클라이언트가 서버에 다시 연결을 시도합니다. 처음에 다시 연결하려고 시도하기 전에 1 초를 기다릴 것입니다. 모든 다시 연결 시도에 대해 지연은 2 분 동안 지연이 2 분 동안 유지됩니다.

true

boolean

brokerUrl (common)

MQTT 브로커의 URL입니다.

tcp://localhost:1883

문자열

cleanSession (공용)

다시 시작 및 다시 연결 시 클라이언트 및 서버가 상태를 확인해야 하는지 여부를 설정합니다. false로 설정하면 클라이언트 및 서버가 클라이언트, 서버 및 연결을 다시 시작하면 상태가 유지됩니다. 상태가 유지 관리되면 메시지 전달은 클라이언트, 서버 또는 연결이 재시작되는 경우에도 지정된 QOS를 안정적으로 충족시킵니다. 서버는 서브스크립션을 고집된 것으로 처리합니다. true로 설정하면 클라이언트와 서버가 클라이언트, 서버 또는 연결을 다시 시작하면 상태가 유지되지 않습니다. 즉 클라이언트, 서버 또는 연결이 다시 시작되면 지정된 QOS에 대한 메시지 전달을 유지할 수 없습니다. 즉, 서버에서 서브스크립션을 취소할 수 없음으로 처리합니다.

true

boolean

ClientID (common)

MQTT 클라이언트 식별자 식별자는 고유해야 합니다.

 

문자열

구성 (공용)

공유된 Paho 구성을 사용합니다.

 

PahoConfiguration

connectionTimeout (common)

연결 시간 초과 값을 설정합니다. 이 값은 클라이언트가 MQTT 서버에 대한 네트워크 연결이 설정될 때까지 클라이언트가 대기하는 최대 시간 간격을 정의합니다. 기본 제한 시간은 30초입니다. 값이 0이면 시간 초과 처리가 비활성화됩니다. 즉, 클라이언트는 네트워크 연결이 성공적으로 수행되거나 실패할 때까지 기다립니다.

30

int

FilePersistenceDirectory (common)

파일 지속성에 사용되는 기본 디렉터리입니다. 기본적으로 사용자 디렉터리를 사용합니다.

 

문자열

keepAliveInterval (common)

keep live interval을 설정합니다. 이 값은 전송 또는 수신한 메시지 간 최대 시간 간격을 초 단위로 측정합니다. 이를 통해 클라이언트는 TCP/IP 시간 초과를 기다릴 필요 없이 서버를 더 이상 사용할 수 없는지 여부를 감지할 수 있습니다. 고객은 각 기간 내에 하나 이상의 메시지가 네트워크를 통해 이동되도록 합니다. 기간 동안 데이터 관련 메시지가 없으면 클라이언트는 서버가 승인할 매우 작은 ping 메시지를 보냅니다. 값이 0이면 클라이언트에서 keepalive 처리를 비활성화합니다. 기본값은 60초입니다.

60

int

maxInflight (일반적으로)

max inflight을 설정합니다. 높은 트래픽 환경에서 이 값을 늘리십시오. 기본값은 10입니다.

10

int

maxReconnectDelay (common)

다시 연결할 때까지 대기하려면 최대 시간(밀리)을 가져옵니다.

128000

int

mqttVersion (common)

MQTT 버전을 설정합니다. 기본 조치는 버전 3.1.1과 연결하고 실패하는 경우 3.1로 대체되는 것입니다. 3.1.1 버전 또는 3.1은 MQTT_VERSION_3_1_1 또는 MQTT_VERSION_3_1 옵션을 각각 사용하여 대체 없이 선택할 수 있습니다.

 

int

지속성 (공용)

사용할 클라이언트 지속성(메모리 또는 파일)

CloudEvent 값:

  • FILE
  • MEMORY

MEMORY

PahoPersistence

QoS( 공용)

클라이언트 서비스 품질 (0-2).

2

int

유지 됨(공용)

유지 옵션.

false

boolean

serverURI (common)

클라이언트가 연결할 수 있는 하나 이상의 serverURI 목록을 설정합니다. 여러 서버를 쉼표로 분리할 수 있습니다. 각 serverURI는 클라이언트가 연결할 수 있는 서버의 주소를 지정합니다. TCP 연결에 대해 tcp://와 SSL/TLS에서 보호하는 TCP 연결의 경우 ssl:// 두 가지 연결 유형이 지원됩니다. 예: tcp://localhost:1883 ssl://localhost:8883 포트가 지정되지 않은 경우 기본적으로 tcp:// URI의 경우 1883, ssl:// URI의 경우 8883입니다. serverURI가 설정되면 MQTT 클라이언트의 생성자에서 전달된 serverURI 매개변수를 덮어씁니다. 연결 시도가 시작되면 클라이언트는 목록에서 첫 번째 serverURI로 시작하고 서버와의 연결이 설정될 때까지 목록을 처리합니다. 서버에 연결할 수 없는 경우 연결 시도가 실패합니다. 클라이언트가 연결할 수 있는 서버 목록을 지정하는 경우 고가용성 및 안정적인 메시지 전달인 Some MQTT 서버는 두 개 이상의 동일한 MQTT 서버 상태가 있는 고가용성 기능을 지원합니다. MQTT 클라이언트는 동일한 서버에 연결할 수 있으며, 클라이언트가 연결하는 서버에 관계없이 메시지가 안정적으로 전달되고 불안정한 서브스크립션이 유지되도록 보장해야 합니다. stable subscriptions 및/또는 신뢰할 수 있는 메시지 전달이 필요한 경우 cleansession 플래그를 false로 설정해야 합니다. (고가용성 옵션에서와 같이) 같지 않은 서버 집합을 지정할 수 있습니다. 신뢰할 수 있는 메시지 전달 및 미완성 구독을 통해 상태를 공유하지 않으므로 사용할 수 없습니다.As no state is shared across the servers reliable message delivery and granularity subscriptions are not valid. 기록 목록 모드가 사용되는 경우 cleansession 플래그를 true로 설정해야 합니다.

 

문자열

WillPayload (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지를 보관해야 하는지 여부입니다.

 

문자열

willQos (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지를 보관해야 하는지 여부입니다.

 

int

willRetained (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지를 보관해야 하는지 여부입니다.

false

boolean

willTopic (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지를 보관해야 하는지 여부입니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

클라이언트 (고급)

공유된 Paho 클라이언트를 사용합니다.

 

MqttClient

customWebSocketHeaders (advanced)

WebSocket 연결의 Custom WebSocket 헤더를 설정합니다.

 

속성

executorServiceTimeout (advanced)

executor 서비스가 강제 종료되기 전에 종료할 때 대기하는 시간(초)을 설정합니다. 이 값을 변경할 것을 권장하지 않는 한, 반드시 필요한 값을 변경할 필요가 있습니다.

1

int

httpsHostnameVerificationEnabled (보안)

SSL HostnameVerifier가 활성화되어 있는지 여부. 기본값은 true입니다.

true

boolean

암호 (보안)

MQTT 브로커에 대한 인증에 사용할 암호입니다.

 

문자열

socketFactory (보안)

사용할 SocketFactory를 설정합니다. 이를 통해 애플리케이션은 네트워크 소켓 생성에 대해 자체 정책을 적용할 수 있습니다. SSL 연결을 사용하는 경우 SSLSocketFactory를 사용하여 애플리케이션별 보안 설정을 제공할 수 있습니다.

 

SocketFactory

sslClientProps (security)

연결의 SSL 속성을 설정합니다. 이러한 속성은JSSE(Java Secure Socket Extensions) 구현을 사용할 수 있는 경우에만 유효합니다. 이러한 속성은 사용자 지정 SocketFactory가 설정된 경우 사용되지 않습니다. 다음 속성을 사용할 수 있습니다. com.ibm.ssl.protocol One of: SSL, SSLv3, TLS, TLSv1, SSL_TLS.com.ibm.ssl.contextProvider Underlying JSSE 공급자. 예를 들어 IBMJSSE2 또는 SunJSSE com.ibm.ssl.keyStore는 KeyManager에서 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. 예를 들어 /mydir/etc/key.p12 com.ibm.ssl.keyStorePassword는 KeyManager에서 사용할 KeyStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있을 수 있으며 정적 메서드(com.ibm.micro.security.Password.obfuscate(char password)를 사용하여 난독할 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독 처리합니다. 이는 일반 텍스트 암호를 난독하는 간단한 스크램블러입니다. 키 저장소의 com.ibm.ssl.keyStoreType 유형(예: PKCS12, JKS 또는 JCEKS. com.ibm.ssl.keyStoreProvider 키 저장소 공급자(예: IBMJCE 또는 IBMJCEFIPS)입니다. com.ibm.ssl.trustStore - TrustManager에서 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. com.ibm.ssl.trustStorePassword를 사용하여 TrustManager에서 사용하려는 TrustStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있을 수 있으며 정적 메서드(com.ibm.micro.security.Password.obfuscate(char password)를 사용하여 난독할 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독 처리합니다. 이는 일반 텍스트 암호를 난독하는 간단한 스크램블러입니다. com.ibm.ssl.trustStoreType 기본 TrustManager에서 사용할 KeyStore 오브젝트 유형입니다. keyStoreType. com.ibm.ssl.trustStoreProvider 신뢰 저장소 공급자와 동일한 값(예: IBMJCE 또는 IBMJCEFIPS. com.ibm.ssl.enabledCipherSuites A list of which ciphers are enabled) 값은 공급자에 따라 달라집니다. 예를 들어 SSL_RSA_WITH_AES_128_CBC_SHA;SSL_RSA_WITH_3DES_EDE_CBC_SHA.com.ibm.ssl.keyManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 KeyManagerFactory 개체를 인스턴스화하는 데 사용되는 알고리즘을 설정합니다. 예제 값: IbmX509 또는 IBMJ9X509. com.ibm.ssl.trustManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 TrustManagerFactory 개체를 인스턴스화하는 데 사용할 알고리즘을 설정합니다. 값 예: PKIX 또는 IBMJ9X509.

 

속성

sslHostnameVerifier (security)

SSL 연결에 대한 HostnameVerifier를 설정합니다. 연결을 핸드셰이크한 후 사용되며, hostname이 확인되면 직접 작업을 수행해야 합니다. 기본 HostnameVerifier가 없습니다.

 

HostnameVerifier

사용자 이름 (보안)

MQTT 브로커에 대한 인증에 사용할 사용자 이름입니다.

 

문자열

37.4. 끝점 옵션

Paho 엔드포인트는 URI 구문을 사용하여 구성됩니다.

paho:topic

다음과 같은 경로 및 쿼리 매개변수 사용:

37.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

주제 (공용)

항목의 이름입니다.Is the name of the topic.

 

문자열

37.4.2. 쿼리 매개변수(31 매개변수)

이름설명Default유형

automaticReconnect (common)

연결이 손실되는 경우 클라이언트가 서버에 자동으로 다시 연결할지 여부를 설정합니다. false로 설정하면 연결이 손실되는 경우 클라이언트는 서버에 자동으로 다시 연결하지 않습니다. true로 설정하면 연결이 손실되면 클라이언트가 서버에 다시 연결을 시도합니다. 처음에 다시 연결하려고 시도하기 전에 1 초를 기다릴 것입니다. 모든 다시 연결 시도에 대해 지연은 2 분 동안 지연이 2 분 동안 유지됩니다.

true

boolean

brokerUrl (common)

MQTT 브로커의 URL입니다.

tcp://localhost:1883

문자열

cleanSession (공용)

다시 시작 및 다시 연결 시 클라이언트 및 서버가 상태를 확인해야 하는지 여부를 설정합니다. false로 설정하면 클라이언트 및 서버가 클라이언트, 서버 및 연결을 다시 시작하면 상태가 유지됩니다. 상태가 유지 관리되면 메시지 전달은 클라이언트, 서버 또는 연결이 재시작되는 경우에도 지정된 QOS를 안정적으로 충족시킵니다. 서버는 서브스크립션을 고집된 것으로 처리합니다. true로 설정하면 클라이언트와 서버가 클라이언트, 서버 또는 연결을 다시 시작하면 상태가 유지되지 않습니다. 즉 클라이언트, 서버 또는 연결이 다시 시작되면 지정된 QOS에 대한 메시지 전달을 유지할 수 없습니다. 즉, 서버에서 서브스크립션을 취소할 수 없음으로 처리합니다.

true

boolean

ClientID (common)

MQTT 클라이언트 식별자 식별자는 고유해야 합니다.

 

문자열

connectionTimeout (common)

연결 시간 초과 값을 설정합니다. 이 값은 클라이언트가 MQTT 서버에 대한 네트워크 연결이 설정될 때까지 클라이언트가 대기하는 최대 시간 간격을 정의합니다. 기본 제한 시간은 30초입니다. 값이 0이면 시간 초과 처리가 비활성화됩니다. 즉, 클라이언트는 네트워크 연결이 성공적으로 수행되거나 실패할 때까지 기다립니다.

30

int

FilePersistenceDirectory (common)

파일 지속성에 사용되는 기본 디렉터리입니다. 기본적으로 사용자 디렉터리를 사용합니다.

 

문자열

keepAliveInterval (common)

keep live interval을 설정합니다. 이 값은 전송 또는 수신한 메시지 간 최대 시간 간격을 초 단위로 측정합니다. 이를 통해 클라이언트는 TCP/IP 시간 초과를 기다릴 필요 없이 서버를 더 이상 사용할 수 없는지 여부를 감지할 수 있습니다. 고객은 각 기간 내에 하나 이상의 메시지가 네트워크를 통해 이동되도록 합니다. 기간 동안 데이터 관련 메시지가 없으면 클라이언트는 서버가 승인할 매우 작은 ping 메시지를 보냅니다. 값이 0이면 클라이언트에서 keepalive 처리를 비활성화합니다. 기본값은 60초입니다.

60

int

maxInflight (일반적으로)

max inflight을 설정합니다. 높은 트래픽 환경에서 이 값을 늘리십시오. 기본값은 10입니다.

10

int

maxReconnectDelay (common)

다시 연결할 때까지 대기하려면 최대 시간(밀리)을 가져옵니다.

128000

int

mqttVersion (common)

MQTT 버전을 설정합니다. 기본 조치는 버전 3.1.1과 연결하고 실패하는 경우 3.1로 대체되는 것입니다. 3.1.1 버전 또는 3.1은 MQTT_VERSION_3_1_1 또는 MQTT_VERSION_3_1 옵션을 각각 사용하여 대체 없이 선택할 수 있습니다.

 

int

지속성 (공용)

사용할 클라이언트 지속성(메모리 또는 파일)

CloudEvent 값:

  • FILE
  • MEMORY

MEMORY

PahoPersistence

QoS( 공용)

클라이언트 서비스 품질 (0-2).

2

int

유지 됨(공용)

유지 옵션.

false

boolean

serverURI (common)

클라이언트가 연결할 수 있는 하나 이상의 serverURI 목록을 설정합니다. 여러 서버를 쉼표로 분리할 수 있습니다. 각 serverURI는 클라이언트가 연결할 수 있는 서버의 주소를 지정합니다. TCP 연결에 대해 tcp://와 SSL/TLS에서 보호하는 TCP 연결의 경우 ssl:// 두 가지 연결 유형이 지원됩니다. 예: tcp://localhost:1883 ssl://localhost:8883 포트가 지정되지 않은 경우 기본적으로 tcp:// URI의 경우 1883, ssl:// URI의 경우 8883입니다. serverURI가 설정되면 MQTT 클라이언트의 생성자에서 전달된 serverURI 매개변수를 덮어씁니다. 연결 시도가 시작되면 클라이언트는 목록에서 첫 번째 serverURI로 시작하고 서버와의 연결이 설정될 때까지 목록을 처리합니다. 서버에 연결할 수 없는 경우 연결 시도가 실패합니다. 클라이언트가 연결할 수 있는 서버 목록을 지정하는 경우 고가용성 및 안정적인 메시지 전달인 Some MQTT 서버는 두 개 이상의 동일한 MQTT 서버 상태가 있는 고가용성 기능을 지원합니다. MQTT 클라이언트는 동일한 서버에 연결할 수 있으며, 클라이언트가 연결하는 서버에 관계없이 메시지가 안정적으로 전달되고 불안정한 서브스크립션이 유지되도록 보장해야 합니다. stable subscriptions 및/또는 신뢰할 수 있는 메시지 전달이 필요한 경우 cleansession 플래그를 false로 설정해야 합니다. (고가용성 옵션에서와 같이) 같지 않은 서버 집합을 지정할 수 있습니다. 신뢰할 수 있는 메시지 전달 및 미완성 구독을 통해 상태를 공유하지 않으므로 사용할 수 없습니다.As no state is shared across the servers reliable message delivery and granularity subscriptions are not valid. 기록 목록 모드가 사용되는 경우 cleansession 플래그를 true로 설정해야 합니다.

 

문자열

WillPayload (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지를 보관해야 하는지 여부입니다.

 

문자열

willQos (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지를 보관해야 하는지 여부입니다.

 

int

willRetained (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지를 보관해야 하는지 여부입니다.

false

boolean

willTopic (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지를 보관해야 하는지 여부입니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

클라이언트 (고급)

기존 mqtt 클라이언트를 사용하려면 다음을 수행합니다.

 

MqttClient

customWebSocketHeaders (advanced)

WebSocket 연결의 Custom WebSocket 헤더를 설정합니다.

 

속성

executorServiceTimeout (advanced)

executor 서비스가 강제 종료되기 전에 종료할 때 대기하는 시간(초)을 설정합니다. 이 값을 변경할 것을 권장하지 않는 한, 반드시 필요한 값을 변경할 필요가 있습니다.

1

int

httpsHostnameVerificationEnabled (보안)

SSL HostnameVerifier가 활성화되어 있는지 여부. 기본값은 true입니다.

true

boolean

암호 (보안)

MQTT 브로커에 대한 인증에 사용할 암호입니다.

 

문자열

socketFactory (보안)

사용할 SocketFactory를 설정합니다. 이를 통해 애플리케이션은 네트워크 소켓 생성에 대해 자체 정책을 적용할 수 있습니다. SSL 연결을 사용하는 경우 SSLSocketFactory를 사용하여 애플리케이션별 보안 설정을 제공할 수 있습니다.

 

SocketFactory

sslClientProps (security)

연결의 SSL 속성을 설정합니다. 이러한 속성은JSSE(Java Secure Socket Extensions) 구현을 사용할 수 있는 경우에만 유효합니다. 이러한 속성은 사용자 지정 SocketFactory가 설정된 경우 사용되지 않습니다. 다음 속성을 사용할 수 있습니다. com.ibm.ssl.protocol One of: SSL, SSLv3, TLS, TLSv1, SSL_TLS.com.ibm.ssl.contextProvider Underlying JSSE 공급자. 예를 들어 IBMJSSE2 또는 SunJSSE com.ibm.ssl.keyStore는 KeyManager에서 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. 예를 들어 /mydir/etc/key.p12 com.ibm.ssl.keyStorePassword는 KeyManager에서 사용할 KeyStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있을 수 있으며 정적 메서드(com.ibm.micro.security.Password.obfuscate(char password)를 사용하여 난독할 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독 처리합니다. 이는 일반 텍스트 암호를 난독하는 간단한 스크램블러입니다. 키 저장소의 com.ibm.ssl.keyStoreType 유형(예: PKCS12, JKS 또는 JCEKS. com.ibm.ssl.keyStoreProvider 키 저장소 공급자(예: IBMJCE 또는 IBMJCEFIPS)입니다. com.ibm.ssl.trustStore - TrustManager에서 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. com.ibm.ssl.trustStorePassword를 사용하여 TrustManager에서 사용하려는 TrustStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있을 수 있으며 정적 메서드(com.ibm.micro.security.Password.obfuscate(char password)를 사용하여 난독할 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독 처리합니다. 이는 일반 텍스트 암호를 난독하는 간단한 스크램블러입니다. com.ibm.ssl.trustStoreType 기본 TrustManager에서 사용할 KeyStore 오브젝트 유형입니다. keyStoreType. com.ibm.ssl.trustStoreProvider 신뢰 저장소 공급자와 동일한 값(예: IBMJCE 또는 IBMJCEFIPS. com.ibm.ssl.enabledCipherSuites A list of which ciphers are enabled) 값은 공급자에 따라 달라집니다. 예를 들어 SSL_RSA_WITH_AES_128_CBC_SHA;SSL_RSA_WITH_3DES_EDE_CBC_SHA.com.ibm.ssl.keyManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 KeyManagerFactory 개체를 인스턴스화하는 데 사용되는 알고리즘을 설정합니다. 예제 값: IbmX509 또는 IBMJ9X509. com.ibm.ssl.trustManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 TrustManagerFactory 개체를 인스턴스화하는 데 사용할 알고리즘을 설정합니다. 값 예: PKIX 또는 IBMJ9X509.

 

속성

sslHostnameVerifier (security)

SSL 연결에 대한 HostnameVerifier를 설정합니다. 연결을 핸드셰이크한 후 사용되며, hostname이 확인되면 직접 작업을 수행해야 합니다. 기본 HostnameVerifier가 없습니다.

 

HostnameVerifier

사용자 이름 (보안)

MQTT 브로커에 대한 인증에 사용할 사용자 이름입니다.

 

문자열

37.5. headers

다음 헤더는 Paho 구성 요소에서 인식합니다.

headerJava 상수끝점 유형값 유형설명

CamelMqttTopic

PahoConstants.MQTT_TOPIC

소비자

문자열

주제의 이름

CamelMqttQoS

PahoConstants.MQTT_QOS

소비자

정수

들어오는 메시지의 QualityOfService

CamelPahoOverrideTopic

PahoConstants.CAMEL_PAHO_OVERRIDE_TOPIC

프로듀서

문자열

끝점에 지정된 주제 대신 재정의하고 보낼 주제의 이름

37.6. 기본 페이로드 유형

기본적으로 Camel Paho 구성 요소는 MQTT 메시지에서 추출된 바이너리 페이로드에서 작동합니다.

// Receive payload
byte[] payload = (byte[]) consumerTemplate.receiveBody("paho:topic");

// Send payload
byte[] payload = "message".getBytes();
producerTemplate.sendBody("paho:topic", payload);

물론 Camel 빌드 유형 변환 API 는 사용자를 위해 자동 데이터 유형 변환을 수행할 수 있습니다. 아래 예에서 Camel은 바이너리 페이로드를 문자열 (및 반대로)으로 자동 변환합니다.

// Receive payload
String payload = consumerTemplate.receiveBody("paho:topic", String.class);

// Send payload
String payload = "message";
producerTemplate.sendBody("paho:topic", payload);

37.7. 샘플

예를 들어 다음 스니펫은 Camel 라우터와 동일한 호스트에 설치된 MQTT 브로커의 메시지를 읽습니다.

from("paho:some/queue")
    .to("mock:test");

아래 스니펫은 MQTT 브로커에 메시지를 전송하는 동안:

from("direct:test")
    .to("paho:some/target/queue");

예를 들어 원격 MQTT 브로커에서 메시지를 읽는 방법은 다음과 같습니다.

from("paho:some/queue?brokerUrl=tcp://iot.eclipse.org:1883")
    .to("mock:test");

기본 주제를 재정의하고 동적 주제로 설정합니다.

from("direct:test")
    .setHeader(PahoConstants.CAMEL_PAHO_OVERRIDE_TOPIC, simple("${header.customerId}"))
    .to("paho:some/target/queue");

37.8. Spring Boot Auto-Configuration

Spring Boot와 함께 paho를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-paho-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

구성 요소는 아래에 나열된 32개의 옵션을 지원합니다.

이름설명Default유형

camel.component.paho.automatic-reconnect

연결이 손실되는 경우 클라이언트가 서버에 자동으로 다시 연결할지 여부를 설정합니다. false로 설정하면 연결이 손실되는 경우 클라이언트는 서버에 자동으로 다시 연결하지 않습니다. true로 설정하면 연결이 손실되면 클라이언트가 서버에 다시 연결을 시도합니다. 처음에 다시 연결하려고 시도하기 전에 1 초를 기다릴 것입니다. 모든 다시 연결 시도에 대해 지연은 2 분 동안 지연이 2 분 동안 유지됩니다.

true

부울

camel.component.paho.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.paho.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.paho.broker-url

MQTT 브로커의 URL입니다.

tcp://localhost:1883

문자열

camel.component.paho.clean-session

다시 시작 및 다시 연결 시 클라이언트 및 서버가 상태를 확인해야 하는지 여부를 설정합니다. false로 설정하면 클라이언트 및 서버가 클라이언트, 서버 및 연결을 다시 시작하면 상태가 유지됩니다. 상태가 유지 관리되면 메시지 전달은 클라이언트, 서버 또는 연결이 재시작되는 경우에도 지정된 QOS를 안정적으로 충족시킵니다. 서버는 서브스크립션을 고집된 것으로 처리합니다. true로 설정하면 클라이언트와 서버가 클라이언트, 서버 또는 연결을 다시 시작하면 상태가 유지되지 않습니다. 즉 클라이언트, 서버 또는 연결이 다시 시작되면 지정된 QOS에 대한 메시지 전달을 유지할 수 없습니다. 즉, 서버에서 서브스크립션을 취소할 수 없음으로 처리합니다.

true

부울

camel.component.paho.client

공유된 Paho 클라이언트를 사용합니다. 옵션은 org.eclipse.paho.client.mqttv3.MqttClient 유형입니다.

 

MqttClient

camel.component.paho.client-id

MQTT 클라이언트 식별자 식별자는 고유해야 합니다.

 

문자열

camel.component.paho.configuration

공유된 Paho 구성을 사용합니다. 옵션은 org.apache.camel.component.paho.PahoConfiguration 유형입니다.

 

PahoConfiguration

camel.component.paho.connection-timeout

연결 시간 초과 값을 설정합니다. 이 값은 클라이언트가 MQTT 서버에 대한 네트워크 연결이 설정될 때까지 클라이언트가 대기하는 최대 시간 간격을 정의합니다. 기본 제한 시간은 30초입니다. 값이 0이면 시간 초과 처리가 비활성화됩니다. 즉, 클라이언트는 네트워크 연결이 성공적으로 수행되거나 실패할 때까지 기다립니다.

30

정수

camel.component.paho.custom-web-socket-headers

WebSocket 연결의 Custom WebSocket 헤더를 설정합니다. 옵션은 java.util.Properties 유형입니다.

 

속성

camel.component.paho.enabled

paho 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.paho.executor-service-timeout

executor 서비스가 강제 종료되기 전에 종료할 때 대기하는 시간(초)을 설정합니다. 이 값을 변경할 것을 권장하지 않는 한, 반드시 필요한 값을 변경할 필요가 있습니다.

1

정수

camel.component.paho.file-persistence-directory

파일 지속성에 사용되는 기본 디렉터리입니다. 기본적으로 사용자 디렉터리를 사용합니다.

 

문자열

camel.component.paho.https-hostname-verification-enabled

SSL HostnameVerifier가 활성화되어 있는지 여부. 기본값은 true입니다.

true

부울

camel.component.paho.keep-alive-interval

keep live interval을 설정합니다. 이 값은 전송 또는 수신한 메시지 간 최대 시간 간격을 초 단위로 측정합니다. 이를 통해 클라이언트는 TCP/IP 시간 초과를 기다릴 필요 없이 서버를 더 이상 사용할 수 없는지 여부를 감지할 수 있습니다. 고객은 각 기간 내에 하나 이상의 메시지가 네트워크를 통해 이동되도록 합니다. 기간 동안 데이터 관련 메시지가 없으면 클라이언트는 서버가 승인할 매우 작은 ping 메시지를 보냅니다. 값이 0이면 클라이언트에서 keepalive 처리를 비활성화합니다. 기본값은 60초입니다.

60

정수

camel.component.paho.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.paho.max-inflight

max inflight을 설정합니다. 높은 트래픽 환경에서 이 값을 늘리십시오. 기본값은 10입니다.

10

정수

camel.component.paho.max-reconnect-delay

다시 연결할 때까지 대기하려면 최대 시간(밀리)을 가져옵니다.

128000

정수

camel.component.paho.mqtt-version

MQTT 버전을 설정합니다. 기본 조치는 버전 3.1.1과 연결하고 실패하는 경우 3.1로 대체되는 것입니다. 3.1.1 버전 또는 3.1은 MQTT_VERSION_3_1_1 또는 MQTT_VERSION_3_1 옵션을 각각 사용하여 대체 없이 선택할 수 있습니다.

 

정수

camel.component.paho.password

MQTT 브로커에 대한 인증에 사용할 암호입니다.

 

문자열

camel.component.paho.persistence

사용할 클라이언트 지속성(메모리 또는 파일)

 

PahoPersistence

camel.component.paho.qos

클라이언트 서비스 품질 (0-2).

2

정수

camel.component.paho.retained

유지 옵션.

false

부울

camel.component.paho.server-u-r-is

클라이언트가 연결할 수 있는 하나 이상의 serverURI 목록을 설정합니다. 여러 서버를 쉼표로 분리할 수 있습니다. 각 serverURI는 클라이언트가 연결할 수 있는 서버의 주소를 지정합니다. TCP 연결에 대해 tcp://와 SSL/TLS에서 보호하는 TCP 연결의 경우 ssl:// 두 가지 연결 유형이 지원됩니다. 예: tcp://localhost:1883 ssl://localhost:8883 포트가 지정되지 않은 경우 기본적으로 tcp:// URI의 경우 1883, ssl:// URI의 경우 8883입니다. serverURI가 설정되면 MQTT 클라이언트의 생성자에서 전달된 serverURI 매개변수를 덮어씁니다. 연결 시도가 시작되면 클라이언트는 목록에서 첫 번째 serverURI로 시작하고 서버와의 연결이 설정될 때까지 목록을 처리합니다. 서버에 연결할 수 없는 경우 연결 시도가 실패합니다. 클라이언트가 연결할 수 있는 서버 목록을 지정하는 경우 고가용성 및 안정적인 메시지 전달인 Some MQTT 서버는 두 개 이상의 동일한 MQTT 서버 상태가 있는 고가용성 기능을 지원합니다. MQTT 클라이언트는 동일한 서버에 연결할 수 있으며, 클라이언트가 연결하는 서버에 관계없이 메시지가 안정적으로 전달되고 불안정한 서브스크립션이 유지되도록 보장해야 합니다. stable subscriptions 및/또는 신뢰할 수 있는 메시지 전달이 필요한 경우 cleansession 플래그를 false로 설정해야 합니다. (고가용성 옵션에서와 같이) 같지 않은 서버 집합을 지정할 수 있습니다. 신뢰할 수 있는 메시지 전달 및 미완성 구독을 통해 상태를 공유하지 않으므로 사용할 수 없습니다.As no state is shared across the servers reliable message delivery and granularity subscriptions are not valid. 기록 목록 모드가 사용되는 경우 cleansession 플래그를 true로 설정해야 합니다.

 

문자열

camel.component.paho.socket-factory

사용할 SocketFactory를 설정합니다. 이를 통해 애플리케이션은 네트워크 소켓 생성에 대해 자체 정책을 적용할 수 있습니다. SSL 연결을 사용하는 경우 SSLSocketFactory를 사용하여 애플리케이션별 보안 설정을 제공할 수 있습니다. 옵션은 javax.net.SocketFactory 유형입니다.

 

SocketFactory

camel.component.paho.ssl-client-props

연결의 SSL 속성을 설정합니다. 이러한 속성은JSSE(Java Secure Socket Extensions) 구현을 사용할 수 있는 경우에만 유효합니다. 이러한 속성은 사용자 지정 SocketFactory가 설정된 경우 사용되지 않습니다. 다음 속성을 사용할 수 있습니다. com.ibm.ssl.protocol One of: SSL, SSLv3, TLS, TLSv1, SSL_TLS.com.ibm.ssl.contextProvider Underlying JSSE 공급자. 예를 들어 IBMJSSE2 또는 SunJSSE com.ibm.ssl.keyStore는 KeyManager에서 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. 예를 들어 /mydir/etc/key.p12 com.ibm.ssl.keyStorePassword는 KeyManager에서 사용할 KeyStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있을 수 있으며 정적 메서드(com.ibm.micro.security.Password.obfuscate(char password)를 사용하여 난독할 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독 처리합니다. 이는 일반 텍스트 암호를 난독하는 간단한 스크램블러입니다. 키 저장소의 com.ibm.ssl.keyStoreType 유형(예: PKCS12, JKS 또는 JCEKS. com.ibm.ssl.keyStoreProvider 키 저장소 공급자(예: IBMJCE 또는 IBMJCEFIPS)입니다. com.ibm.ssl.trustStore - TrustManager에서 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. com.ibm.ssl.trustStorePassword를 사용하여 TrustManager에서 사용하려는 TrustStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있을 수 있으며 정적 메서드(com.ibm.micro.security.Password.obfuscate(char password)를 사용하여 난독할 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독 처리합니다. 이는 일반 텍스트 암호를 난독하는 간단한 스크램블러입니다. com.ibm.ssl.trustStoreType 기본 TrustManager에서 사용할 KeyStore 오브젝트 유형입니다. keyStoreType. com.ibm.ssl.trustStoreProvider 신뢰 저장소 공급자와 동일한 값(예: IBMJCE 또는 IBMJCEFIPS. com.ibm.ssl.enabledCipherSuites A list of which ciphers are enabled) 값은 공급자에 따라 달라집니다. 예를 들어 SSL_RSA_WITH_AES_128_CBC_SHA;SSL_RSA_WITH_3DES_EDE_CBC_SHA.com.ibm.ssl.keyManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 KeyManagerFactory 개체를 인스턴스화하는 데 사용되는 알고리즘을 설정합니다. 예제 값: IbmX509 또는 IBMJ9X509. com.ibm.ssl.trustManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 TrustManagerFactory 개체를 인스턴스화하는 데 사용할 알고리즘을 설정합니다. 값 예: PKIX 또는 IBMJ9X509. 옵션은 java.util.Properties 유형입니다.

 

속성

camel.component.paho.ssl-hostname-verifier

SSL 연결에 대한 HostnameVerifier를 설정합니다. 연결을 핸드셰이크한 후 사용되며, hostname이 확인되면 직접 작업을 수행해야 합니다. 기본 HostnameVerifier가 없습니다. 옵션은 javax.net.ssl.HostnameVerifier 유형입니다.

 

HostnameVerifier

camel.component.paho.user-name

MQTT 브로커에 대한 인증에 사용할 사용자 이름입니다.

 

문자열

camel.component.paho.will-payload

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지를 보관해야 하는지 여부입니다.

 

문자열

camel.component.paho.will-qos

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지를 보관해야 하는지 여부입니다.

 

정수

camel.component.paho.will-retained

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지를 보관해야 하는지 여부입니다.

false

부울

camel.component.paho.will-topic

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지를 보관해야 하는지 여부입니다.

 

문자열

38장. Paho MQTT 5

생산자 및 소비자 모두 지원

PAHO MQTT5 구성 요소는 MQTT v5와 함께 Eclipse Paho 라이브러리를 사용하여 MQTT 메시징 프로토콜용 커넥터를 제공합니다. PAHO는 가장 인기있는 MQTT 라이브러리 중 하나이므로 Java 프로젝트와 통합하려는 경우 Camel Paho 커넥터가 이동할 수 있습니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-paho-mqtt5</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

38.1. URI 형식

paho-mqtt5:topic[?options]

여기서 topic 은 주제의 이름입니다.

38.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

38.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

38.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

38.3. 구성 요소 옵션

Paho MQTT 5 구성 요소는 아래에 나열된 32 옵션을 지원합니다.

이름설명Default유형

automaticReconnect (common)

연결이 손실되는 경우 클라이언트가 서버에 자동으로 다시 연결할지 여부를 설정합니다. false로 설정하면 연결이 손실되는 경우 클라이언트는 서버에 자동으로 다시 연결하지 않습니다. true로 설정하면 연결이 손실되면 클라이언트가 서버에 다시 연결을 시도합니다. 처음에 다시 연결하려고 시도하기 전에 1 초를 기다릴 것입니다. 모든 다시 연결 시도에 대해 지연은 2 분 동안 지연이 2 분 동안 유지됩니다.

true

boolean

brokerUrl (common)

MQTT 브로커의 URL입니다.

tcp://localhost:1883

문자열

cleanStart (공용)

다시 시작 및 다시 연결 시 클라이언트 및 서버가 상태를 확인해야 하는지 여부를 설정합니다. false로 설정하면 클라이언트 및 서버가 클라이언트, 서버 및 연결을 다시 시작하면 상태가 유지됩니다. 상태가 유지 관리되면 메시지 전달은 클라이언트, 서버 또는 연결이 재시작되는 경우에도 지정된 QOS를 안정적으로 충족시킵니다. 서버는 서브스크립션을 고집된 것으로 처리합니다. true로 설정하면 클라이언트와 서버가 클라이언트, 서버 또는 연결을 다시 시작하면 상태가 유지되지 않습니다. 즉 클라이언트, 서버 또는 연결이 다시 시작되면 지정된 QOS에 대한 메시지 전달을 유지할 수 없습니다. 즉, 서버에서 서브스크립션을 취소할 수 없음으로 처리합니다.

true

boolean

ClientID (common)

MQTT 클라이언트 식별자 식별자는 고유해야 합니다.

 

문자열

구성 (공용)

공유된 Paho 구성을 사용합니다.

 

PahoMqtt5Configuration

connectionTimeout (common)

연결 시간 초과 값을 설정합니다. 이 값은 클라이언트가 MQTT 서버에 대한 네트워크 연결이 설정될 때까지 클라이언트가 대기하는 최대 시간 간격을 정의합니다. 기본 제한 시간은 30초입니다. 값이 0이면 시간 초과 처리가 비활성화됩니다. 즉, 클라이언트는 네트워크 연결이 성공적으로 수행되거나 실패할 때까지 기다립니다.

30

int

FilePersistenceDirectory (common)

파일 지속성에 사용되는 기본 디렉터리입니다. 기본적으로 사용자 디렉터리를 사용합니다.

 

문자열

keepAliveInterval (common)

keep live interval을 설정합니다. 이 값은 전송 또는 수신한 메시지 간 최대 시간 간격을 초 단위로 측정합니다. 이를 통해 클라이언트는 TCP/IP 시간 초과를 기다릴 필요 없이 서버를 더 이상 사용할 수 없는지 여부를 감지할 수 있습니다. 고객은 각 기간 내에 하나 이상의 메시지가 네트워크를 통해 이동되도록 합니다. 기간 동안 데이터 관련 메시지가 없으면 클라이언트는 서버가 승인할 매우 작은 ping 메시지를 보냅니다. 값이 0이면 클라이언트에서 keepalive 처리를 비활성화합니다. 기본값은 60초입니다.

60

int

maxReconnectDelay (common)

다시 연결할 때까지 대기하려면 최대 시간(밀리)을 가져옵니다.

128000

int

지속성 (공용)

사용할 클라이언트 지속성(메모리 또는 파일)

CloudEvent 값:

  • FILE
  • MEMORY

MEMORY

PahoMqtt5Persistence

QoS( 공용)

클라이언트 서비스 품질 (0-2).

2

int

receiveMaximum (common)

최대 값을 설정합니다. 이 값은 클라이언트가 동시에 처리하려는 QoS 1 및 QoS 2 게시의 제한을 나타냅니다. 서버에서 보낼 수 있는 QoS 0 게시 수를 제한하는 메커니즘은 없습니다. 기본값은 65535입니다.

65535

int

유지 됨(공용)

유지 옵션.

false

boolean

serverURI (common)

클라이언트가 연결할 수 있는 하나 이상의 serverURI 목록을 설정합니다. 여러 서버를 쉼표로 분리할 수 있습니다. 각 serverURI는 클라이언트가 연결할 수 있는 서버의 주소를 지정합니다. TCP 연결에 대해 tcp://와 SSL/TLS에서 보호하는 TCP 연결의 경우 ssl:// 두 가지 연결 유형이 지원됩니다. 예: tcp://localhost:1883 ssl://localhost:8883 포트가 지정되지 않은 경우 기본적으로 tcp:// URI의 경우 1883, ssl:// URI의 경우 8883입니다. serverURI가 설정되면 MQTT 클라이언트의 생성자에서 전달된 serverURI 매개변수를 덮어씁니다. 연결 시도가 시작되면 클라이언트는 목록에서 첫 번째 serverURI로 시작하고 서버와의 연결이 설정될 때까지 목록을 처리합니다. 서버에 연결할 수 없는 경우 연결 시도가 실패합니다. 클라이언트가 연결할 수 있는 서버 목록을 지정하는 경우 고가용성 및 안정적인 메시지 전달인 Some MQTT 서버는 두 개 이상의 동일한 MQTT 서버 상태가 있는 고가용성 기능을 지원합니다. MQTT 클라이언트는 동일한 서버에 연결할 수 있으며, 클라이언트가 연결하는 서버에 관계없이 메시지가 안정적으로 전달되고 불안정한 서브스크립션이 유지되도록 보장해야 합니다. stable subscriptions 및/또는 신뢰할 수 있는 메시지 전달이 필요한 경우 cleansession 플래그를 false로 설정해야 합니다. (고가용성 옵션에서와 같이) 같지 않은 서버 집합을 지정할 수 있습니다. 신뢰할 수 있는 메시지 전달 및 미완성 구독을 통해 상태를 공유하지 않으므로 사용할 수 없습니다.As no state is shared across the servers reliable message delivery and granularity subscriptions are not valid. 기록 목록 모드가 사용되는 경우 cleansession 플래그를 true로 설정해야 합니다.

 

문자열

sessionExpiryInterval (common)

세션 만료 간격을 설정합니다. 이 값은 클라이언트의 연결이 끊어지면 브로커가 세션을 유지 관리하는 최대 시간을 정의합니다. 클라이언트는 나중에 특정 시점에서 서버에 연결하려는 경우 긴 세션 만료 간격과만 연결해야 합니다. 기본적으로 이 값은 -1이므로 전송되지 않으므로 세션이 만료되지 않습니다. 0이 전송되면 네트워크 연결이 종료되면 세션이 즉시 종료됩니다. 클라이언트가 더 이상 세션에 대해 사용하지 않는 것으로 확인되면 Session Expiry Interval을 0으로 설정해야 합니다.

-1

long

WillMqttProperties (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지에 대해 설정된 MQTT 속성입니다.

 

MqttProperties

WillPayload (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드입니다.

 

문자열

willQos (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다.

1

int

willRetained (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지를 보관해야 하는지 여부입니다.

false

boolean

willTopic (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 게시할 주제입니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

클라이언트 (고급)

공유된 Paho 클라이언트를 사용합니다.

 

MqttClient

customWebSocketHeaders (advanced)

WebSocket 연결의 Custom WebSocket 헤더를 설정합니다.

 

map

executorServiceTimeout (advanced)

executor 서비스가 강제 종료되기 전에 종료할 때 대기하는 시간(초)을 설정합니다. 이 값을 변경할 것을 권장하지 않는 한, 반드시 필요한 값을 변경할 필요가 있습니다.

1

int

httpsHostnameVerificationEnabled (보안)

SSL HostnameVerifier가 활성화되어 있는지 여부. 기본값은 true입니다.

true

boolean

암호 (보안)

MQTT 브로커에 대한 인증에 사용할 암호입니다.

 

문자열

socketFactory (보안)

사용할 SocketFactory를 설정합니다. 이를 통해 애플리케이션은 네트워크 소켓 생성에 대해 자체 정책을 적용할 수 있습니다. SSL 연결을 사용하는 경우 SSLSocketFactory를 사용하여 애플리케이션별 보안 설정을 제공할 수 있습니다.

 

SocketFactory

sslClientProps (security)

연결의 SSL 속성을 설정합니다. 이러한 속성은JSSE(Java Secure Socket Extensions) 구현을 사용할 수 있는 경우에만 유효합니다. 이러한 속성은 사용자 지정 SocketFactory가 설정된 경우 사용되지 않습니다. 다음 속성을 사용할 수 있습니다. com.ibm.ssl.protocol One of: SSL, SSLv3, TLS, TLSv1, SSL_TLS.com.ibm.ssl.contextProvider Underlying JSSE 공급자. 예를 들어 IBMJSSE2 또는 SunJSSE com.ibm.ssl.keyStore는 KeyManager에서 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. 예를 들어 /mydir/etc/key.p12 com.ibm.ssl.keyStorePassword는 KeyManager에서 사용할 KeyStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있을 수 있으며 정적 메서드(com.ibm.micro.security.Password.obfuscate(char password)를 사용하여 난독할 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독 처리합니다. 이는 일반 텍스트 암호를 난독하는 간단한 스크램블러입니다. 키 저장소의 com.ibm.ssl.keyStoreType 유형(예: PKCS12, JKS 또는 JCEKS. com.ibm.ssl.keyStoreProvider 키 저장소 공급자(예: IBMJCE 또는 IBMJCEFIPS)입니다. com.ibm.ssl.trustStore - TrustManager에서 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. com.ibm.ssl.trustStorePassword를 사용하여 TrustManager에서 사용하려는 TrustStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있을 수 있으며 정적 메서드(com.ibm.micro.security.Password.obfuscate(char password)를 사용하여 난독할 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독 처리합니다. 이는 일반 텍스트 암호를 난독하는 간단한 스크램블러입니다. com.ibm.ssl.trustStoreType 기본 TrustManager에서 사용할 KeyStore 오브젝트 유형입니다. keyStoreType. com.ibm.ssl.trustStoreProvider 신뢰 저장소 공급자와 동일한 값(예: IBMJCE 또는 IBMJCEFIPS. com.ibm.ssl.enabledCipherSuites A list of which ciphers are enabled) 값은 공급자에 따라 달라집니다. 예를 들어 SSL_RSA_WITH_AES_128_CBC_SHA;SSL_RSA_WITH_3DES_EDE_CBC_SHA.com.ibm.ssl.keyManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 KeyManagerFactory 개체를 인스턴스화하는 데 사용되는 알고리즘을 설정합니다. 예제 값: IbmX509 또는 IBMJ9X509. com.ibm.ssl.trustManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 TrustManagerFactory 개체를 인스턴스화하는 데 사용할 알고리즘을 설정합니다. 값 예: PKIX 또는 IBMJ9X509.

 

속성

sslHostnameVerifier (security)

SSL 연결에 대한 HostnameVerifier를 설정합니다. 연결을 핸드셰이크한 후 사용되며, hostname이 확인되면 직접 작업을 수행해야 합니다. 기본 HostnameVerifier가 없습니다.

 

HostnameVerifier

사용자 이름 (보안)

MQTT 브로커에 대한 인증에 사용할 사용자 이름입니다.

 

문자열

38.4. 끝점 옵션

Paho MQTT 5 끝점은 URI 구문을 사용하여 구성됩니다.

paho-mqtt5:topic

다음과 같은 경로 및 쿼리 매개변수 사용:

38.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

주제 (공용)

항목의 이름입니다.Is the name of the topic.

 

문자열

38.4.2. 쿼리 매개변수(32 매개변수)

이름설명Default유형

automaticReconnect (common)

연결이 손실되는 경우 클라이언트가 서버에 자동으로 다시 연결할지 여부를 설정합니다. false로 설정하면 연결이 손실되는 경우 클라이언트는 서버에 자동으로 다시 연결하지 않습니다. true로 설정하면 연결이 손실되면 클라이언트가 서버에 다시 연결을 시도합니다. 처음에 다시 연결하려고 시도하기 전에 1 초를 기다릴 것입니다. 모든 다시 연결 시도에 대해 지연은 2 분 동안 지연이 2 분 동안 유지됩니다.

true

boolean

brokerUrl (common)

MQTT 브로커의 URL입니다.

tcp://localhost:1883

문자열

cleanStart (공용)

다시 시작 및 다시 연결 시 클라이언트 및 서버가 상태를 확인해야 하는지 여부를 설정합니다. false로 설정하면 클라이언트 및 서버가 클라이언트, 서버 및 연결을 다시 시작하면 상태가 유지됩니다. 상태가 유지 관리되면 메시지 전달은 클라이언트, 서버 또는 연결이 재시작되는 경우에도 지정된 QOS를 안정적으로 충족시킵니다. 서버는 서브스크립션을 고집된 것으로 처리합니다. true로 설정하면 클라이언트와 서버가 클라이언트, 서버 또는 연결을 다시 시작하면 상태가 유지되지 않습니다. 즉 클라이언트, 서버 또는 연결이 다시 시작되면 지정된 QOS에 대한 메시지 전달을 유지할 수 없습니다. 즉, 서버에서 서브스크립션을 취소할 수 없음으로 처리합니다.

true

boolean

ClientID (common)

MQTT 클라이언트 식별자 식별자는 고유해야 합니다.

 

문자열

connectionTimeout (common)

연결 시간 초과 값을 설정합니다. 이 값은 클라이언트가 MQTT 서버에 대한 네트워크 연결이 설정될 때까지 클라이언트가 대기하는 최대 시간 간격을 정의합니다. 기본 제한 시간은 30초입니다. 값이 0이면 시간 초과 처리가 비활성화됩니다. 즉, 클라이언트는 네트워크 연결이 성공적으로 수행되거나 실패할 때까지 기다립니다.

30

int

FilePersistenceDirectory (common)

파일 지속성에 사용되는 기본 디렉터리입니다. 기본적으로 사용자 디렉터리를 사용합니다.

 

문자열

keepAliveInterval (common)

keep live interval을 설정합니다. 이 값은 전송 또는 수신한 메시지 간 최대 시간 간격을 초 단위로 측정합니다. 이를 통해 클라이언트는 TCP/IP 시간 초과를 기다릴 필요 없이 서버를 더 이상 사용할 수 없는지 여부를 감지할 수 있습니다. 고객은 각 기간 내에 하나 이상의 메시지가 네트워크를 통해 이동되도록 합니다. 기간 동안 데이터 관련 메시지가 없으면 클라이언트는 서버가 승인할 매우 작은 ping 메시지를 보냅니다. 값이 0이면 클라이언트에서 keepalive 처리를 비활성화합니다. 기본값은 60초입니다.

60

int

maxReconnectDelay (common)

다시 연결할 때까지 대기하려면 최대 시간(밀리)을 가져옵니다.

128000

int

지속성 (공용)

사용할 클라이언트 지속성(메모리 또는 파일)

CloudEvent 값:

  • FILE
  • MEMORY

MEMORY

PahoMqtt5Persistence

QoS( 공용)

클라이언트 서비스 품질 (0-2).

2

int

receiveMaximum (common)

최대 값을 설정합니다. 이 값은 클라이언트가 동시에 처리하려는 QoS 1 및 QoS 2 게시의 제한을 나타냅니다. 서버에서 보낼 수 있는 QoS 0 게시 수를 제한하는 메커니즘은 없습니다. 기본값은 65535입니다.

65535

int

유지 됨(공용)

유지 옵션.

false

boolean

serverURI (common)

클라이언트가 연결할 수 있는 하나 이상의 serverURI 목록을 설정합니다. 여러 서버를 쉼표로 분리할 수 있습니다. 각 serverURI는 클라이언트가 연결할 수 있는 서버의 주소를 지정합니다. TCP 연결에 대해 tcp://와 SSL/TLS에서 보호하는 TCP 연결의 경우 ssl:// 두 가지 연결 유형이 지원됩니다. 예: tcp://localhost:1883 ssl://localhost:8883 포트가 지정되지 않은 경우 기본적으로 tcp:// URI의 경우 1883, ssl:// URI의 경우 8883입니다. serverURI가 설정되면 MQTT 클라이언트의 생성자에서 전달된 serverURI 매개변수를 덮어씁니다. 연결 시도가 시작되면 클라이언트는 목록에서 첫 번째 serverURI로 시작하고 서버와의 연결이 설정될 때까지 목록을 처리합니다. 서버에 연결할 수 없는 경우 연결 시도가 실패합니다. 클라이언트가 연결할 수 있는 서버 목록을 지정하는 경우 고가용성 및 안정적인 메시지 전달인 Some MQTT 서버는 두 개 이상의 동일한 MQTT 서버 상태가 있는 고가용성 기능을 지원합니다. MQTT 클라이언트는 동일한 서버에 연결할 수 있으며, 클라이언트가 연결하는 서버에 관계없이 메시지가 안정적으로 전달되고 불안정한 서브스크립션이 유지되도록 보장해야 합니다. stable subscriptions 및/또는 신뢰할 수 있는 메시지 전달이 필요한 경우 cleansession 플래그를 false로 설정해야 합니다. (고가용성 옵션에서와 같이) 같지 않은 서버 집합을 지정할 수 있습니다. 신뢰할 수 있는 메시지 전달 및 미완성 구독을 통해 상태를 공유하지 않으므로 사용할 수 없습니다.As no state is shared across the servers reliable message delivery and granularity subscriptions are not valid. 기록 목록 모드가 사용되는 경우 cleansession 플래그를 true로 설정해야 합니다.

 

문자열

sessionExpiryInterval (common)

세션 만료 간격을 설정합니다. 이 값은 클라이언트의 연결이 끊어지면 브로커가 세션을 유지 관리하는 최대 시간을 정의합니다. 클라이언트는 나중에 특정 시점에서 서버에 연결하려는 경우 긴 세션 만료 간격과만 연결해야 합니다. 기본적으로 이 값은 -1이므로 전송되지 않으므로 세션이 만료되지 않습니다. 0이 전송되면 네트워크 연결이 종료되면 세션이 즉시 종료됩니다. 클라이언트가 더 이상 세션에 대해 사용하지 않는 것으로 확인되면 Session Expiry Interval을 0으로 설정해야 합니다.

-1

long

WillMqttProperties (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지에 대해 설정된 MQTT 속성입니다.

 

MqttProperties

WillPayload (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드입니다.

 

문자열

willQos (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다.

1

int

willRetained (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지를 보관해야 하는지 여부입니다.

false

boolean

willTopic (common)

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 게시할 주제입니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

클라이언트 (고급)

기존 mqtt 클라이언트를 사용하려면 다음을 수행합니다.

 

MqttClient

customWebSocketHeaders (advanced)

WebSocket 연결의 Custom WebSocket 헤더를 설정합니다.

 

map

executorServiceTimeout (advanced)

executor 서비스가 강제 종료되기 전에 종료할 때 대기하는 시간(초)을 설정합니다. 이 값을 변경할 것을 권장하지 않는 한, 반드시 필요한 값을 변경할 필요가 있습니다.

1

int

httpsHostnameVerificationEnabled (보안)

SSL HostnameVerifier가 활성화되어 있는지 여부. 기본값은 true입니다.

true

boolean

암호 (보안)

MQTT 브로커에 대한 인증에 사용할 암호입니다.

 

문자열

socketFactory (보안)

사용할 SocketFactory를 설정합니다. 이를 통해 애플리케이션은 네트워크 소켓 생성에 대해 자체 정책을 적용할 수 있습니다. SSL 연결을 사용하는 경우 SSLSocketFactory를 사용하여 애플리케이션별 보안 설정을 제공할 수 있습니다.

 

SocketFactory

sslClientProps (security)

연결의 SSL 속성을 설정합니다. 이러한 속성은JSSE(Java Secure Socket Extensions) 구현을 사용할 수 있는 경우에만 유효합니다. 이러한 속성은 사용자 지정 SocketFactory가 설정된 경우 사용되지 않습니다. 다음 속성을 사용할 수 있습니다. com.ibm.ssl.protocol One of: SSL, SSLv3, TLS, TLSv1, SSL_TLS.com.ibm.ssl.contextProvider Underlying JSSE 공급자. 예를 들어 IBMJSSE2 또는 SunJSSE com.ibm.ssl.keyStore는 KeyManager에서 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. 예를 들어 /mydir/etc/key.p12 com.ibm.ssl.keyStorePassword는 KeyManager에서 사용할 KeyStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있을 수 있으며 정적 메서드(com.ibm.micro.security.Password.obfuscate(char password)를 사용하여 난독할 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독 처리합니다. 이는 일반 텍스트 암호를 난독하는 간단한 스크램블러입니다. 키 저장소의 com.ibm.ssl.keyStoreType 유형(예: PKCS12, JKS 또는 JCEKS. com.ibm.ssl.keyStoreProvider 키 저장소 공급자(예: IBMJCE 또는 IBMJCEFIPS)입니다. com.ibm.ssl.trustStore - TrustManager에서 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. com.ibm.ssl.trustStorePassword를 사용하여 TrustManager에서 사용하려는 TrustStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있을 수 있으며 정적 메서드(com.ibm.micro.security.Password.obfuscate(char password)를 사용하여 난독할 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독 처리합니다. 이는 일반 텍스트 암호를 난독하는 간단한 스크램블러입니다. com.ibm.ssl.trustStoreType 기본 TrustManager에서 사용할 KeyStore 오브젝트 유형입니다. keyStoreType. com.ibm.ssl.trustStoreProvider 신뢰 저장소 공급자와 동일한 값(예: IBMJCE 또는 IBMJCEFIPS. com.ibm.ssl.enabledCipherSuites A list of which ciphers are enabled) 값은 공급자에 따라 달라집니다. 예를 들어 SSL_RSA_WITH_AES_128_CBC_SHA;SSL_RSA_WITH_3DES_EDE_CBC_SHA.com.ibm.ssl.keyManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 KeyManagerFactory 개체를 인스턴스화하는 데 사용되는 알고리즘을 설정합니다. 예제 값: IbmX509 또는 IBMJ9X509. com.ibm.ssl.trustManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 TrustManagerFactory 개체를 인스턴스화하는 데 사용할 알고리즘을 설정합니다. 값 예: PKIX 또는 IBMJ9X509.

 

속성

sslHostnameVerifier (security)

SSL 연결에 대한 HostnameVerifier를 설정합니다. 연결을 핸드셰이크한 후 사용되며, hostname이 확인되면 직접 작업을 수행해야 합니다. 기본 HostnameVerifier가 없습니다.

 

HostnameVerifier

사용자 이름 (보안)

MQTT 브로커에 대한 인증에 사용할 사용자 이름입니다.

 

문자열

38.5. headers

다음 헤더는 Paho 구성 요소에서 인식합니다.

headerJava 상수끝점 유형값 유형설명

CamelMqttTopic

PahoConstants.MQTT_TOPIC

소비자

문자열

주제의 이름

CamelMqttQoS

PahoConstants.MQTT_QOS

소비자

정수

들어오는 메시지의 QualityOfService

CamelPahoOverrideTopic

PahoConstants.CAMEL_PAHO_OVERRIDE_TOPIC

프로듀서

문자열

끝점에 지정된 주제 대신 재정의하고 보낼 주제의 이름

38.6. 기본 페이로드 유형

기본적으로 Camel Paho 구성 요소는 MQTT 메시지에서 추출된 바이너리 페이로드에서 작동합니다.

// Receive payload
byte[] payload = (byte[]) consumerTemplate.receiveBody("paho:topic");

// Send payload
byte[] payload = "message".getBytes();
producerTemplate.sendBody("paho:topic", payload);

물론 Camel 빌드 유형 변환 API 는 사용자를 위해 자동 데이터 유형 변환을 수행할 수 있습니다. 아래 예에서 Camel은 바이너리 페이로드를 문자열 (및 반대로)으로 자동 변환합니다.

// Receive payload
String payload = consumerTemplate.receiveBody("paho:topic", String.class);

// Send payload
String payload = "message";
producerTemplate.sendBody("paho:topic", payload);

38.7. 샘플

예를 들어 다음 스니펫은 Camel 라우터와 동일한 호스트에 설치된 MQTT 브로커의 메시지를 읽습니다.

from("paho:some/queue")
    .to("mock:test");

아래 스니펫은 MQTT 브로커에 메시지를 전송하는 동안:

from("direct:test")
    .to("paho:some/target/queue");

예를 들어 원격 MQTT 브로커에서 메시지를 읽는 방법은 다음과 같습니다.

from("paho:some/queue?brokerUrl=tcp://iot.eclipse.org:1883")
    .to("mock:test");

기본 주제를 재정의하고 동적 주제로 설정합니다.

from("direct:test")
    .setHeader(PahoConstants.CAMEL_PAHO_OVERRIDE_TOPIC, simple("${header.customerId}"))
    .to("paho:some/target/queue");

38.8. Spring Boot Auto-Configuration

Spring Boot와 함께 paho-mqtt5를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-paho-mqtt5-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.paho-mqtt5.automatic-reconnect

연결이 손실되는 경우 클라이언트가 서버에 자동으로 다시 연결할지 여부를 설정합니다. false로 설정하면 연결이 손실되는 경우 클라이언트는 서버에 자동으로 다시 연결하지 않습니다. true로 설정하면 연결이 손실되면 클라이언트가 서버에 다시 연결을 시도합니다. 처음에 다시 연결하려고 시도하기 전에 1 초를 기다릴 것입니다. 모든 다시 연결 시도에 대해 지연은 2 분 동안 지연이 2 분 동안 유지됩니다.

true

부울

camel.component.paho-mqtt5.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.paho-mqtt5.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.paho-mqtt5.broker-url

MQTT 브로커의 URL입니다.

tcp://localhost:1883

문자열

camel.component.paho-mqtt5.clean-start

다시 시작 및 다시 연결 시 클라이언트 및 서버가 상태를 확인해야 하는지 여부를 설정합니다. false로 설정하면 클라이언트 및 서버가 클라이언트, 서버 및 연결을 다시 시작하면 상태가 유지됩니다. 상태가 유지 관리되면 메시지 전달은 클라이언트, 서버 또는 연결이 재시작되는 경우에도 지정된 QOS를 안정적으로 충족시킵니다. 서버는 서브스크립션을 고집된 것으로 처리합니다. true로 설정하면 클라이언트와 서버가 클라이언트, 서버 또는 연결을 다시 시작하면 상태가 유지되지 않습니다. 즉 클라이언트, 서버 또는 연결이 다시 시작되면 지정된 QOS에 대한 메시지 전달을 유지할 수 없습니다. 즉, 서버에서 서브스크립션을 취소할 수 없음으로 처리합니다.

true

부울

camel.component.paho-mqtt5.client

공유된 Paho 클라이언트를 사용합니다. 옵션은 org.eclipse.paho.mqttv5.client.MqttClient 유형입니다.

 

MqttClient

camel.component.paho-mqtt5.client-id

MQTT 클라이언트 식별자 식별자는 고유해야 합니다.

 

문자열

camel.component.paho-mqtt5.configuration

공유된 Paho 구성을 사용합니다. 옵션은 org.apache.camel.component.paho.mqtt5.PahoMqtt5Configuration 유형입니다.

 

PahoMqtt5Configuration

camel.component.paho-mqtt5.connection-timeout

연결 시간 초과 값을 설정합니다. 이 값은 클라이언트가 MQTT 서버에 대한 네트워크 연결이 설정될 때까지 클라이언트가 대기하는 최대 시간 간격을 정의합니다. 기본 제한 시간은 30초입니다. 값이 0이면 시간 초과 처리가 비활성화됩니다. 즉, 클라이언트는 네트워크 연결이 성공적으로 수행되거나 실패할 때까지 기다립니다.

30

정수

camel.component.paho-mqtt5.custom-web-socket-headers

WebSocket 연결의 Custom WebSocket 헤더를 설정합니다.

 

map

camel.component.paho-mqtt5.enabled

paho-mqtt5 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.paho-mqtt5.executor-service-timeout

executor 서비스가 강제 종료되기 전에 종료할 때 대기하는 시간(초)을 설정합니다. 이 값을 변경할 것을 권장하지 않는 한, 반드시 필요한 값을 변경할 필요가 있습니다.

1

정수

camel.component.paho-mqtt5.file-persistence-directory

파일 지속성에 사용되는 기본 디렉터리입니다. 기본적으로 사용자 디렉터리를 사용합니다.

 

문자열

camel.component.paho-mqtt5.https-hostname-verification-enabled

SSL HostnameVerifier가 활성화되어 있는지 여부. 기본값은 true입니다.

true

부울

camel.component.paho-mqtt5.keep-alive-interval

keep live interval을 설정합니다. 이 값은 전송 또는 수신한 메시지 간 최대 시간 간격을 초 단위로 측정합니다. 이를 통해 클라이언트는 TCP/IP 시간 초과를 기다릴 필요 없이 서버를 더 이상 사용할 수 없는지 여부를 감지할 수 있습니다. 고객은 각 기간 내에 하나 이상의 메시지가 네트워크를 통해 이동되도록 합니다. 기간 동안 데이터 관련 메시지가 없으면 클라이언트는 서버가 승인할 매우 작은 ping 메시지를 보냅니다. 값이 0이면 클라이언트에서 keepalive 처리를 비활성화합니다. 기본값은 60초입니다.

60

정수

camel.component.paho-mqtt5.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.paho-mqtt5.max-reconnect-delay

다시 연결할 때까지 대기하려면 최대 시간(밀리)을 가져옵니다.

128000

정수

camel.component.paho-mqtt5.password

MQTT 브로커에 대한 인증에 사용할 암호입니다.

 

문자열

camel.component.paho-mqtt5.persistence

사용할 클라이언트 지속성(메모리 또는 파일)

 

PahoMqtt5Persistence

camel.component.paho-mqtt5.qos

클라이언트 서비스 품질 (0-2).

2

정수

camel.component.paho-mqtt5.receive-maximum

최대 값을 설정합니다. 이 값은 클라이언트가 동시에 처리하려는 QoS 1 및 QoS 2 게시의 제한을 나타냅니다. 서버에서 보낼 수 있는 QoS 0 게시 수를 제한하는 메커니즘은 없습니다. 기본값은 65535입니다.

65535

정수

camel.component.paho-mqtt5.retained

유지 옵션.

false

부울

camel.component.paho-mqtt5.server-u-r-is

클라이언트가 연결할 수 있는 하나 이상의 serverURI 목록을 설정합니다. 여러 서버를 쉼표로 분리할 수 있습니다. 각 serverURI는 클라이언트가 연결할 수 있는 서버의 주소를 지정합니다. TCP 연결에 대해 tcp://와 SSL/TLS에서 보호하는 TCP 연결의 경우 ssl:// 두 가지 연결 유형이 지원됩니다. 예: tcp://localhost:1883 ssl://localhost:8883 포트가 지정되지 않은 경우 기본적으로 tcp:// URI의 경우 1883, ssl:// URI의 경우 8883입니다. serverURI가 설정되면 MQTT 클라이언트의 생성자에서 전달된 serverURI 매개변수를 덮어씁니다. 연결 시도가 시작되면 클라이언트는 목록에서 첫 번째 serverURI로 시작하고 서버와의 연결이 설정될 때까지 목록을 처리합니다. 서버에 연결할 수 없는 경우 연결 시도가 실패합니다. 클라이언트가 연결할 수 있는 서버 목록을 지정하는 경우 고가용성 및 안정적인 메시지 전달인 Some MQTT 서버는 두 개 이상의 동일한 MQTT 서버 상태가 있는 고가용성 기능을 지원합니다. MQTT 클라이언트는 동일한 서버에 연결할 수 있으며, 클라이언트가 연결하는 서버에 관계없이 메시지가 안정적으로 전달되고 불안정한 서브스크립션이 유지되도록 보장해야 합니다. stable subscriptions 및/또는 신뢰할 수 있는 메시지 전달이 필요한 경우 cleansession 플래그를 false로 설정해야 합니다. (고가용성 옵션에서와 같이) 같지 않은 서버 집합을 지정할 수 있습니다. 신뢰할 수 있는 메시지 전달 및 미완성 구독을 통해 상태를 공유하지 않으므로 사용할 수 없습니다.As no state is shared across the servers reliable message delivery and granularity subscriptions are not valid. 기록 목록 모드가 사용되는 경우 cleansession 플래그를 true로 설정해야 합니다.

 

문자열

camel.component.paho-mqtt5.session-expiry-interval

세션 만료 간격을 설정합니다. 이 값은 클라이언트의 연결이 끊어지면 브로커가 세션을 유지 관리하는 최대 시간을 정의합니다. 클라이언트는 나중에 특정 시점에서 서버에 연결하려는 경우 긴 세션 만료 간격과만 연결해야 합니다. 기본적으로 이 값은 -1이므로 전송되지 않으므로 세션이 만료되지 않습니다. 0이 전송되면 네트워크 연결이 종료되면 세션이 즉시 종료됩니다. 클라이언트가 더 이상 세션에 대해 사용하지 않는 것으로 확인되면 Session Expiry Interval을 0으로 설정해야 합니다.

-1

long

camel.component.paho-mqtt5.socket-factory

사용할 SocketFactory를 설정합니다. 이를 통해 애플리케이션은 네트워크 소켓 생성에 대해 자체 정책을 적용할 수 있습니다. SSL 연결을 사용하는 경우 SSLSocketFactory를 사용하여 애플리케이션별 보안 설정을 제공할 수 있습니다. 옵션은 javax.net.SocketFactory 유형입니다.

 

SocketFactory

camel.component.paho-mqtt5.ssl-client-props

연결의 SSL 속성을 설정합니다. 이러한 속성은JSSE(Java Secure Socket Extensions) 구현을 사용할 수 있는 경우에만 유효합니다. 이러한 속성은 사용자 지정 SocketFactory가 설정된 경우 사용되지 않습니다. 다음 속성을 사용할 수 있습니다. com.ibm.ssl.protocol One of: SSL, SSLv3, TLS, TLSv1, SSL_TLS.com.ibm.ssl.contextProvider Underlying JSSE 공급자. 예를 들어 IBMJSSE2 또는 SunJSSE com.ibm.ssl.keyStore는 KeyManager에서 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. 예를 들어 /mydir/etc/key.p12 com.ibm.ssl.keyStorePassword는 KeyManager에서 사용할 KeyStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있을 수 있으며 정적 메서드(com.ibm.micro.security.Password.obfuscate(char password)를 사용하여 난독할 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독 처리합니다. 이는 일반 텍스트 암호를 난독하는 간단한 스크램블러입니다. 키 저장소의 com.ibm.ssl.keyStoreType 유형(예: PKCS12, JKS 또는 JCEKS. com.ibm.ssl.keyStoreProvider 키 저장소 공급자(예: IBMJCE 또는 IBMJCEFIPS)입니다. com.ibm.ssl.trustStore - TrustManager에서 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. com.ibm.ssl.trustStorePassword를 사용하여 TrustManager에서 사용하려는 TrustStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있을 수 있으며 정적 메서드(com.ibm.micro.security.Password.obfuscate(char password)를 사용하여 난독할 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독 처리합니다. 이는 일반 텍스트 암호를 난독하는 간단한 스크램블러입니다. com.ibm.ssl.trustStoreType 기본 TrustManager에서 사용할 KeyStore 오브젝트 유형입니다. keyStoreType. com.ibm.ssl.trustStoreProvider 신뢰 저장소 공급자와 동일한 값(예: IBMJCE 또는 IBMJCEFIPS. com.ibm.ssl.enabledCipherSuites A list of which ciphers are enabled) 값은 공급자에 따라 달라집니다. 예를 들어 SSL_RSA_WITH_AES_128_CBC_SHA;SSL_RSA_WITH_3DES_EDE_CBC_SHA.com.ibm.ssl.keyManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 KeyManagerFactory 개체를 인스턴스화하는 데 사용되는 알고리즘을 설정합니다. 예제 값: IbmX509 또는 IBMJ9X509. com.ibm.ssl.trustManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 TrustManagerFactory 개체를 인스턴스화하는 데 사용할 알고리즘을 설정합니다. 값 예: PKIX 또는 IBMJ9X509. 옵션은 java.util.Properties 유형입니다.

 

속성

camel.component.paho-mqtt5.ssl-hostname-verifier

SSL 연결에 대한 HostnameVerifier를 설정합니다. 연결을 핸드셰이크한 후 사용되며, hostname이 확인되면 직접 작업을 수행해야 합니다. 기본 HostnameVerifier가 없습니다. 옵션은 javax.net.ssl.HostnameVerifier 유형입니다.

 

HostnameVerifier

camel.component.paho-mqtt5.user-name

MQTT 브로커에 대한 인증에 사용할 사용자 이름입니다.

 

문자열

camel.component.paho-mqtt5.will-mqtt-properties

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지에 대해 설정된 MQTT 속성입니다. 옵션은 org.eclipse.paho.mqttv5.common.packet.MqttProperties 유형입니다.

 

MqttProperties

camel.component.paho-mqtt5.will-payload

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지의 바이트 페이로드입니다.

 

문자열

camel.component.paho-mqtt5.will-qos

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다.

1

정수

camel.component.paho-mqtt5.will-retained

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 메시지를 보관해야 하는지 여부입니다.

false

부울

camel.component.paho-mqtt5.will-topic

연결에 대한 Last Will and Testament (LWT)를 설정합니다. 이 클라이언트가 예기치 않게 서버에 대한 연결이 끊어지면 서버는 제공된 세부 정보를 사용하여 자체적으로 메시지를 게시합니다. 게시할 주제입니다.

 

문자열

39장. Quartz

소비자만 지원됩니다.

Quartz 구성 요소는 Quartz Scheduler 2.x 를 사용하여 예약된 메시지 전달을 제공합니다. 각 끝점은 다른 타이머(쿼츠 용어, Trigger 및 JobDetail)를 나타냅니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-quartz</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

39.1. URI 형식

quartz://timerName?options
quartz://groupName/timerName?options
quartz://groupName/timerName?cron=expression
quartz://timerName?cron=expression

구성 요소는 CronTrigger 또는 SimpleTrigger 를 사용합니다. cron 표현식을 제공하지 않으면 구성 요소는 간단한 트리거를 사용합니다. groupName 을 제공하지 않으면 quartz 구성 요소는 Camel 그룹 이름을 사용합니다.

39.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

39.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

39.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

39.3. 구성 요소 옵션

Quartz 구성 요소는 아래에 나열된 13 옵션을 지원합니다.

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

enableJmx (consumer)

Quartz scheduler를 사용할 수 있는 Quartz Scheduler를 활성화할지 여부입니다. 이 옵션은 기본값 true입니다.

true

boolean

prefixInstanceName (consumer)

CamelContext 이름을 사용하여 Quartz Scheduler 인스턴스 이름 앞에 접두사를 지정할지 여부입니다. 이는 기본적으로 각 CamelContext에서 자체 Quartz 스케줄러 인스턴스를 사용하도록 하려면 기본적으로 활성화되어 있습니다. 여러 CamelContext에서 Quartz 스케줄러 인스턴스를 재사용하려면 이 옵션을 false로 설정할 수 있습니다.

true

boolean

prefixJobNameWithEndpointId (consumer)

quartz 작업의 접두사를 끝점 ID로 지정할지 여부입니다. 이 옵션은 기본값 false입니다.

false

boolean

속성 (consumer)

Quartz 스케줄러를 구성하는 속성입니다.

 

map

propertiesFile (consumer)

classpath에서 로드할 속성의 파일 이름입니다.

 

문자열

propertiesRef (consumer)

quartz 구성에 사용할 레지스트리에서 조회할 기존 속성 또는 맵에 대한 참조입니다.

 

문자열

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

스케줄러 (고급)

새 스케줄러를 생성하는 대신 사용자 지정 구성된 Quartz 스케줄러를 사용하려면 다음을 수행합니다.

 

scheduler

schedulerFactory (advanced)

Scheduler를 만드는 데 사용되는 사용자 지정 SchedulerFactory를 사용하려면 다음을 수행합니다.

 

SchedulerFactory

autoStartScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다. 이 옵션은 기본값 true입니다.

true

boolean

interruptJobsOnShutdown (scheduler)

스케줄러가 더 빨리 종료되고 실행 중인 작업을 중단하려고 하는 종료 시 작업을 중단할지 여부입니다. 이 기능이 활성화되면 중단되어 실행 중인 모든 작업이 실패할 수 있습니다. 작업이 중단되면 Camel은 교환에서 계속 라우팅을 중지하고 예외 발생으로 java.util.concurrent.RejectedExecutionException을 설정합니다. 따라서 Camel 작업이 정상적으로 완료 및 종료되도록 하려면 주의해야 합니다.

false

boolean

startDelayedSeconds (scheduler)

quartz 스케줄러를 시작하기 전에 대기하는 시간(초)입니다.

 

int

39.4. 끝점 옵션

Quartz 엔드포인트는 URI 구문을 사용하여 구성됩니다.

quartz:groupName/triggerName

다음과 같은 경로 및 쿼리 매개변수 사용:

39.4.1. 경로 매개변수(2 매개변수)

이름설명Default유형

groupName (consumer)

사용할 quartz 그룹 이름입니다. 그룹 이름과 트리거 이름의 조합은 고유해야 합니다.

Camel

문자열

triggerName (consumer)

사용할 quartz 트리거 이름입니다. 그룹 이름과 트리거 이름의 조합은 고유해야 합니다.

 

문자열

39.4.2. 쿼리 매개변수 (17 매개변수)

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

cron (consumer)

트리거 시기를 정의할 cron 표현식을 지정합니다.

 

문자열

deleteJob (consumer)

true로 설정하면 경로가 중지될 때 트리거가 자동으로 삭제됩니다. false로 설정하면 스케줄러에 남아 있습니다. false로 설정하면 사용자가 camel Uri를 사용하여 사전 구성된 트리거를 재사용할 수 있음을 의미합니다. 이름이 일치하는지 확인하십시오. deleteJob 및 pauseJob을 모두 true로 설정할 수 없습니다.

true

boolean

fluentdJob (consumer)

작업이 고립된 후 저장되도록 해야 하는지 여부( triggers가 이를 가리키지 않음).

false

boolean

pauseJob (consumer)

true로 설정하면 경로가 중지될 때 트리거가 자동으로 일시 정지됩니다. false로 설정하면 스케줄러에 남아 있습니다. false로 설정하면 사용자가 camel Uri를 사용하여 사전 구성된 트리거를 재사용할 수 있음을 의미합니다. 이름이 일치하는지 확인하십시오. deleteJob 및 pauseJob을 모두 true로 설정할 수 없습니다.

false

boolean

복구 가능Job (consumer)

'recovery' 또는 'fail-over' 상태가 발생하는 경우 작업을 다시 실행해야 하는지의 여부를 스케줄러에 지시합니다.

false

boolean

스테이트풀 (consumer)

기본 작업 대신 Quartz PersistJobDataAfterExecution 및 DisallowConcurrentExecution을 사용합니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

사용자 정의 ScanSetting (advanced)

특정 날짜 범위를 피하기 위해 사용자 지정 일정을 지정합니다.

 

일정

jobParameters (advanced)

작업에 추가 옵션을 구성하려면 다음을 수행합니다.

 

map

prefixJobNameWithEndpointId (advanced)

작업 이름 앞에 끝점 ID를 붙여야 하는지 여부입니다.

false

boolean

triggerParameters (advanced)

트리거에 추가 옵션을 구성하려면 다음을 수행합니다.

 

map

usingFixedCamelContextName (advanced)

true인 경우 JobDataMap은 CamelContext 이름을 직접 사용하여 CamelContext를 참조합니다. 즉, false인 경우 JobDataMap은 배포 시간 동안 변경할 수 있는 CamelContext 관리 이름을 사용합니다.

false

boolean

autoStartScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

startDelayedSeconds (scheduler)

quartz 스케줄러를 시작하기 전에 대기하는 시간(초)입니다.

 

int

triggerStartDelay (scheduler)

스케줄러가 이미 시작된 경우 작업이 시작되기 전에 끝점이 완전히 시작되었는지 확인하기 위해 현재 시간 후에 트리거가 약간 시작되기를 바랍니다. 음수 값은 과거의 트리거 시작 시간을 변경합니다.

500

long

39.4.3. quartz.properties 파일 구성

기본적으로 Quartz는 classpath의 org/quartz 디렉토리에서 quartz.properties 파일을 찾습니다. WAR 배포를 사용 중인 경우, 이 경우, 자세한 내용은 -INF/classes/org/quartz 에서 quartz.properties를 삭제합니다.

그러나 Camel Quartz 구성 요소에서도 속성을 구성할 수 있습니다.

매개변수Default유형설명

속성

null

속성

java.util.Properties 인스턴스를 구성할 수 있습니다.

propertiesFile

null

문자열

classpath에서 로드할 속성의 파일 이름

이를 위해 Spring XML에서 다음과 같이 구성할 수 있습니다.

<bean id="quartz" class="org.apache.camel.component.quartz.QuartzComponent">
    <property name="propertiesFile" value="com/mycompany/myquartz.properties"/>
</bean>

39.5. 10.0.0.1에서 Quartz 스케줄러 활성화

quartz 스케줄러 속성을 구성하여 활성화해야합니다.
일반적으로 "org.quartz.scheduler.jmx.export" 옵션을 구성 파일의 true 값으로 설정합니다.

명시적으로 비활성화하지 않는 한 이 옵션은 기본적으로 true로 설정됩니다.

39.6. Quartz 스케줄러 시작

Quartz 구성 요소는 Quartz 스케줄러를 지연하거나 자동 시작되지 않도록 하는 옵션을 제공합니다.

예를 들면 다음과 같습니다.

<bean id="quartz" class="org.apache.camel.component.quartz.QuartzComponent">
    <property name="startDelayedSeconds" value="5"/>
</bean>

39.7. 클러스터링

클러스터형 모드에서 Quartz를 사용하는 경우(예: JobStore )가 클러스터됩니다. 그런 다음 노드가 중지되거나 종료되는 경우 Quartz 구성 요소가 일시 중지/제거되지 않습니다. 이를 통해 트리거는 클러스터의 다른 노드에서 계속 실행할 수 있습니다.

참고

클러스터형 노드에서 실행하는 경우 끝점에 고유한 작업 이름/그룹을 확인하는 검사가 수행되지 않습니다.

39.8. 메시지 헤더

Camel은 Quartz 실행 컨텍스트에서 getter를 헤더 값으로 추가합니다. 다음 헤더가 추가되었습니다.
calendar,fireTime,jobDetail,jobInstance,jobRuntTime,mergedJobDataMap,nextFireTime,previousFireTime,refireCount,result,scheduledFireTime,scheduler,trigger Name,triggerGroup.

fireTime 헤더에는 교환이 실행된 시점의 java.util.Date 가 포함되어 있습니다.

39.9. Cron Trigger 사용

Quartz는 조정 가능한 형식으로 타이머를 지정하기 위해 Cron과 유사한 표현식 을 지원합니다. 이러한 표현식은 cron URI 매개변수에서 사용할 수 있습니다. 하지만 유효한 URI 인코딩을 유지하기 위해 공백 대신 + 를 사용할 수 있습니다.

예를 들어, 다음 주일 오전 12시 (noon)부터 오후 6시까지 5분마다 메시지를 실행합니다.

from("quartz://myGroup/myTimerName?cron=0+0/5+12-18+?+*+MON-FRI")
    .to("activemq:Totally.Rocks");

cron 표현식을 사용하는 것과 동일한 경우

0 0/5 12-18 ? * MON-FRI

다음 표는 유효한 URI 구문을 유지하는 데 사용하는 URI 문자 인코딩을 보여줍니다.

URI 문자Cron 문자

+

공간

39.10. 시간대 지정

Quartz Scheduler를 사용하면 트리거당 시간대를 구성할 수 있습니다. 예를 들어 국가의 시간대를 사용하려면 다음과 같이 할 수 있습니다.

quartz://groupName/timerName?cron=0+0/5+12-18+?+*+MON-FRI&trigger.timeZone=Europe/Stockholm

timeZone 값은 java.util.TimeZone 에서 허용하는 값입니다.

39.11. 잘못된 명령 설정

quartz 스케줄러는 트리거의 잘못된 상황을 처리하기 위해 잘못된 명령으로 구성할 수 있습니다. 사용 중인 구체적인 트리거 유형은 이 속성의 값으로 설정할 수 있는 추가MiS FIRE_INSTRUCTION_XXX 상수 세트를 정의합니다.

예를 들어 misfire 명령 4를 사용하도록 간단한 트리거를 구성하려면 다음을 수행합니다.

quartz://myGroup/myTimerName?trigger.repeatInterval=2000&trigger.misfireInstruction=4

마찬가지로 잘못된 명령 중 하나로 cron 트리거를 구성할 수 있습니다.

quartz://myGroup/myTimerName?cron=0/2+*+*+*+*+?&trigger.misfireInstruction=2

간단한 및 cron 트리거에는 다음과 같은 잘못된 명령 담당자가 있습니다.

39.11.1. SimpleTrigger.MISFIRE_INSTRUCTION_FIRE_NOW = 1 (default)

스케줄러에 잘못된 문제가 있을 때 스케줄러에서 SimpleTrigger가 지금 실행하려고 한다고 지시합니다.

일반적으로 이 명령은 'one-shot'(repeating이 아닌) 트리거에만 사용해야 합니다. 반복 횟수 > 0이 있는 트리거에서 사용되는 경우, 이 명령은 =SFIRE_INSTRUTION_RESCHEDULE_NOW_WITH_REMAINING_REPEAT_COUNT 명령과 동일합니다.

39.11.2. SimpleTrigger.MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_EXISTING_REPEAT_COUNT = 2

스케줄러에 잘못된 상황이 있을 때 SimpleTrigger가 'now'로 다시 예약되도록 지시합니다.(관련 calendar이 'now'를 제외하더라도) 반복 횟수가 그대로 남아 있게 됩니다. 그러나 트리거 종료 시간을 준수하므로 '현재'가 종료 후 트리거가 다시 실행되지 않습니다.

이 명령을 사용하면 트리거가 처음 설정되었던 시작 시간 및 반복 횟수를 사용하도록 합니다. (이 이유는 나중에 원본 값이 무엇인지 말할 수 있을 때 문제일 뿐입니다).

39.11.3. SimpleTrigger.MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_REMAINING_REPEAT_COUNT = 3

잘못된 상황이 있을 때 SimpleTrigger가 다시 스케줄링되기를 원하는 경우, 실행을 놓치지 않은 경우, 반복 횟수를 사용하여 '현재'로 다시 예약하려고 합니다. 그러나 트리거 종료 시간을 준수하므로 '현재'가 종료 후 트리거가 다시 실행되지 않습니다.

이 명령을 사용하면 트리거가 시작 시간 및 원래 설정된 반복 횟수를 'forget'으로 설정합니다. 대신 트리거의 반복 횟수는 나머지 반복 수에 관계없이 변경됩니다. (어떤 이유로 인해 원래 값이 무엇인지 알 수 있는 경우에만 문제가 발생합니다).

이 명령을 수행하면 모든 반복-fire-times가 누락된 경우 'now' 실행 후 Trigger가 'COMPLETE' 상태로 이동할 수 있습니다.

39.11.4. SimpleTrigger.MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_REMAINING_COUNT = 4

잘못된 상황에서 SimpleTrigger가 ' now' 이후 다음 예정된 시간으로 다시 예약되도록 스케줄러에 지시합니다. 현재 관련 calendar를 고려하여 반복 횟수를 계산하여 실행을 놓치지 않은 경우 반복 횟수를 설정합니다.

참고

이 명령을 실행하면 트리거가 누락된 모든 API 타임으로 직접 'COMPLETE' 상태로 이동할 수 있었습니다.

39.11.5. SimpleTrigger.MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_EXISTING_COUNT = 5

스케줄러에 잘못된 상황이 발생할 경우 SimpleTrigger가 'now' 이후 다음 예정된 시간으로 다시 예약하려고 합니다. - 연결된 calendar를 고려하여 반복 횟수는 변경되지 않은 상태로 유지됩니다.

참고

트리거의 종료 시간이 도달한 경우 Trigger가 'COMPLETE' 상태로 직접 이동할 수 있습니다.

39.11.6. CronTrigger.MISFIRE_INSTRUCTION_FIRE_ONCE_NOW = 1 (기본)

스케줄러에 잘못된 상황이 있을 때 CronTrigger가 스케줄러에 의해 실행되기를 원하는 것을 지시합니다.

39.11.7. CronTrigger.MISFIRE_INSTRUCTION_DO_NOTHING = 2

잘못된 상황에서 CronTrigger가 현재 시간 이후 일정의 다음 시간으로 업데이트되도록 스케줄러에 지시합니다(관련된 calendar를 고려하지만 지금 실행하려고 하지는 않습니다.

39.12. QuartzScheduledPollConsumerScheduler 사용

Quartz 구성 요소는 파일 및 FTP 소비자와 같은 소비자에 cron 기반 스케줄링을 사용할 수 있는 폴링 소비자 스케줄러를 제공합니다.

예를 들어 cron 기반 표현식을 사용하여 2초마다 파일을 폴링하려면 Camel 경로를 다음과 같이 정의할 수 있습니다.

    from("file:inbox?scheduler=quartz&scheduler.cron=0/2+*+*+*+*+?")
       .to("bean:process");

Camel에 Quartz 기반 스케줄러를 사용하도록 scheduler=quartz 를 정의합니다. 그런 다음 scheduler.xxx 옵션을 사용하여 스케줄러를 구성합니다. Quartz 스케줄러를 사용하려면 cron 옵션을 설정해야 합니다.

지원되는 옵션은 다음과 같습니다.

매개변수Default유형설명

quartzScheduler

null

org.quartz.Scheduler

사용자 지정 Quartz 스케줄러를 사용하려면 다음을 수행합니다. 구성 요소를 구성하지 않으면 구성 요소의 공유 스케줄러가 사용됩니다.

cron

null

문자열

mandatory: 폴링을 트리거하기 위한 cron 표현식을 정의합니다.

triggerId

null

문자열

트리거 ID를 지정하려면 다음을 수행합니다. 제공되지 않으면 UUID가 생성되어 사용됩니다.

triggerGroup

QuartzScheduledPollConsumerScheduler

문자열

트리거 그룹을 지정하려면 다음을 수행합니다.

timeZone

Default

timezone

CRON 트리거에 사용할 시간대입니다.

중요

끝점 URI에서 이러한 옵션을 설정하는 것은 스케줄러 를 접두사로 지정해야 합니다.

예를 들어 트리거 ID 및 그룹을 구성하려면 다음을 수행합니다.

    from("file:inbox?scheduler=quartz&scheduler.cron=0/2+*+*+*+*+?&scheduler.triggerId=myId&scheduler.triggerGroup=myGroup")
       .to("bean:process");

Spring에는 CRON 스케줄러도 있으므로 다음을 사용할 수도 있습니다.

    from("file:inbox?scheduler=spring&scheduler.cron=0/2+*+*+*+*+?")
       .to("bean:process");

39.13. Cron 구성 요소 지원

Quartz 구성 요소를 Camel Cron 구성 요소의 구현으로 사용할 수 있습니다.

Maven 사용자는 pom.xml 에 다음과 같은 추가 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-cron</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

그러면 사용자는 다음 경로와 같이 quartz 구성 요소 대신 cron 구성 요소를 사용할 수 있습니다.

    from("cron://name?schedule=0+0/5+12-18+?+*+MON-FRI")
    .to("activemq:Totally.Rocks");

39.14. Spring Boot Auto-Configuration

Spring Boot와 함께 quartz를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-quartz-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.quartz.auto-start-scheduler

스케줄러를 자동으로 시작할지 여부입니다. 이 옵션은 기본값 true입니다.

true

부울

camel.component.quartz.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.quartz.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.quartz.enable-jmx

Quartz scheduler를 사용할 수 있는 Quartz Scheduler를 활성화할지 여부입니다. 이 옵션은 기본값 true입니다.

true

부울

camel.component.quartz.enabled

quartz 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.quartz.interrupt-jobs-on-shutdown

스케줄러가 더 빨리 종료되고 실행 중인 작업을 중단하려고 하는 종료 시 작업을 중단할지 여부입니다. 이 기능이 활성화되면 중단되어 실행 중인 모든 작업이 실패할 수 있습니다. 작업이 중단되면 Camel은 교환에서 계속 라우팅을 중지하고 예외 발생으로 java.util.concurrent.RejectedExecutionException을 설정합니다. 따라서 Camel 작업이 정상적으로 완료 및 종료되도록 하려면 주의해야 합니다.

false

부울

camel.component.quartz.prefix-instance-name

CamelContext 이름을 사용하여 Quartz Scheduler 인스턴스 이름 앞에 접두사를 지정할지 여부입니다. 이는 기본적으로 각 CamelContext에서 자체 Quartz 스케줄러 인스턴스를 사용하도록 하려면 기본적으로 활성화되어 있습니다. 여러 CamelContext에서 Quartz 스케줄러 인스턴스를 재사용하려면 이 옵션을 false로 설정할 수 있습니다.

true

부울

camel.component.quartz.prefix-job-name-with-endpoint-id

quartz 작업의 접두사를 끝점 ID로 지정할지 여부입니다. 이 옵션은 기본값 false입니다.

false

부울

camel.component.quartz.properties

Quartz 스케줄러를 구성하는 속성입니다.

 

map

camel.component.quartz.properties-file

classpath에서 로드할 속성의 파일 이름입니다.

 

문자열

camel.component.quartz.properties-ref

quartz 구성에 사용할 레지스트리에서 조회할 기존 속성 또는 맵에 대한 참조입니다.

 

문자열

camel.component.quartz.scheduler

새 스케줄러를 생성하는 대신 사용자 지정 구성된 Quartz 스케줄러를 사용하려면 다음을 수행합니다. 옵션은 org.quartz.Scheduler 유형입니다.

 

scheduler

camel.component.quartz.scheduler-factory

Scheduler를 만드는 데 사용되는 사용자 지정 SchedulerFactory를 사용하려면 다음을 수행합니다. 옵션은 org.quartz.SchedulerFactory 유형입니다.

 

SchedulerFactory

camel.component.quartz.start-delayed-seconds

quartz 스케줄러를 시작하기 전에 대기하는 시간(초)입니다.

 

정수

40장. Ref

생산자 및 소비자 모두 지원

Ref 구성 요소는 레지스트리에 바인딩된 기존 끝점을 조회하는 데 사용됩니다.

40.1. URI 형식

ref:someName[?options]

여기서 someName 은 레지스트리의 끝점 이름입니다(일반적으로 스프링 레지스트리는 아닙니다). Spring 레지스트리를 사용하는 경우 someName 은 Spring 레지스트리에 있는 엔드포인트의 빈 ID입니다.

40.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

40.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

40.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

40.3. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

40.4. 끝점 옵션

Ref 끝점은 URI 구문을 사용하여 구성됩니다.

ref:name

다음과 같은 경로 및 쿼리 매개변수 사용:

40.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

이름 (common)

레지스트리에서 조회할 끝점의 이름입니다.

 

문자열

40.4.2. 쿼리 매개변수 (4 매개변수)

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

40.5. runtime lookup

이 구성 요소는 런타임에 URI를 계산할 수 있는 레지스트리에서 끝점을 동적으로 검색할 때 사용할 수 있습니다. 다음 코드를 사용하여 끝점을 조회할 수 있습니다.

// lookup the endpoint
String myEndpointRef = "bigspenderOrder";
Endpoint endpoint = context.getEndpoint("ref:" + myEndpointRef);

Producer producer = endpoint.createProducer();
Exchange exchange = producer.createExchange();
exchange.getIn().setBody(payloadToSend);
// send the exchange
producer.process(exchange);

다음과 같이 레지스트리에 끝점 목록이 정의되어 있을 수 있습니다.

<camelContext id="camel" xmlns="http://activemq.apache.org/camel/schema/spring">
    <endpoint id="normalOrder" uri="activemq:order.slow"/>
    <endpoint id="bigspenderOrder" uri="activemq:order.high"/>
</camelContext>

40.6. sample

아래 샘플에서 ref: 를 사용하여 URI에서 Spring ID, endpoint2 로 끝점을 참조합니다.

대신 ref 특성을 사용할 수 있습니다.

<to uri="ref:endpoint2"/>

가장 일반적인 방법은 이를 작성하는 것입니다.

40.7. Spring Boot Auto-Configuration

Spring Boot와 함께 ref를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-ref-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.ref.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.ref.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.ref.enabled

ref 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.ref.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

41장. REST

생산자 및 소비자 모두 지원

REST 구성 요소를 사용하면 REST 전송로 Rest DSL 및 플러그인을 사용하여 REST 엔드포인트(소유자)를 정의할 수 있습니다.

나머지 구성 요소는 REST 서비스를 호출하기 위해 클라이언트(proder)로 사용할 수도 있습니다.

41.1. URI 형식

rest://method:path[:uriTemplate]?[options]

41.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

41.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

41.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

41.3. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

consumerComponentName (consumer)

jetty, 서블릿, undertow와 같이 REST 전송에 사용할 Camel Rest 구성 요소. 명시적으로 구성된 구성 요소가 없는 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestConsumerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

apiDoc (producer)

사용할 swagger api doc 리소스입니다. 리소스는 기본적으로 classpath에서 로드되며 JSON 형식이어야 합니다.

 

문자열

componentName (producer)

더 이상 사용되지 않는 Camel Rest 구성 요소는 http, undertow와 같은 REST 전송에 사용할 (producer)입니다. 구성 요소가 명시적으로 구성되지 않은 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestProducerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

호스트 (producer)

사용할 HTTP 서비스의 호스트 및 포트(swagger 스키마의 호스트 제외).

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

producerComponentName (producer)

http, undertow와 같은 REST 전송에 사용할 Camel Rest 구성 요소. 구성 요소가 명시적으로 구성되지 않은 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestProducerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

41.4. 끝점 옵션

REST 엔드포인트는 URI 구문을 사용하여 구성됩니다.

rest:method:path:uriTemplate

다음과 같은 경로 및 쿼리 매개변수 사용:

41.4.1. 경로 매개변수 (3 매개변수)

이름설명Default유형

방법 (공용)

사용하려면 필수 HTTP 메서드입니다.

CloudEvent 값:

  • get
  • post
  • put
  • 삭제
  • patch
  • head
  • Trace
  • 연결
  • options
 

문자열

경로 (공용)

기본 경로가 필요합니다.

 

문자열

UriTemplate (common)

uri 템플릿입니다.

 

문자열

41.4.2. 쿼리 매개변수 (16 매개변수)

이름설명Default유형

사용 (공용)

'text/xml' 또는 'application/json'과 같은 미디어 유형에서는 이 REST 서비스에서 허용합니다. 기본적으로 모든 유형을 허용합니다.

 

문자열

intype (common)

들어오는 gRPC 바인딩 유형을 FQN 클래스 이름으로 선언하려면 다음을 수행합니다.

 

문자열

outtype (공용)

발신 hieradata 바인딩 유형을 FQN 클래스 이름으로 선언하려면 다음을 수행합니다.

 

문자열

생성 (공용)

'text/xml' 또는 'application/json'과 같은 미디어 유형에서는 이 REST 서비스가 반환됩니다.

 

문자열

routeId (공용)

이 REST 서비스에서 생성하는 경로의 이름입니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

consumerComponentName (consumer)

jetty, 서블릿, undertow와 같이 REST 전송에 사용할 Camel Rest 구성 요소. 명시적으로 구성된 구성 요소가 없는 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestConsumerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

설명 (consumer)

이 REST 서비스를 문서화하기 위한 man 설명입니다.

 

문자열

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

apiDoc (producer)

사용할 openapi api doc 리소스입니다. 리소스는 기본적으로 classpath에서 로드되며 JSON 형식이어야 합니다.

 

문자열

bindingMode (producer)

생산자의 바인딩 모드를 구성합니다. 'off' 이외의 값으로 설정하면 생산자는 inType에서 json 또는 xml로 들어오는 메시지의 본문을 json 또는 xml로 변환하려고 합니다.

CloudEvent 값:

  • auto
  • off
  • json
  • xml
  • json_xml
 

RestBindingMode

호스트 (producer)

사용할 HTTP 서비스의 호스트 및 포트(Openapi 스키마의 중복 호스트).

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

producerComponentName (producer)

http, undertow와 같은 REST 전송에 사용할 Camel Rest 구성 요소. 구성 요소가 명시적으로 구성되지 않은 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestProducerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

queryParameters (producer)

호출할 HTTP 서비스의 매개변수를 쿼리합니다. 쿼리 매개변수는 foo=123&bar=456과 같이 Ampersand로 구분된 여러 매개변수를 포함할 수 있습니다.

 

문자열

41.5. 지원되는 나머지 구성 요소

다음 구성 요소는 나머지 소비자(Rest DSL)를 지원합니다.

  • camel-servlet

다음 구성 요소는 나머지 생산자를 지원합니다.

  • camel-http

41.6. 경로 및 uriTemplate 구문

path 및 uriTemplate 옵션은 매개 변수 지원을 사용하여 REST 컨텍스트 경로를 정의하는 REST 구문을 사용하여 정의됩니다.

참고

uriTemplate이 구성되지 않은 경우 경로 옵션이 동일한 방식으로 작동합니다. 경로만 구성하거나 두 옵션을 모두 구성하는 경우에는 중요하지 않습니다. 경로 및 uriTemplate을 모두 구성하는 것은 REST를 사용하여 보다 일반적인 관행입니다.

다음은 경로를 사용하는 Camel 경로입니다.

from("rest:get:hello")
  .transform().constant("Bye World");

다음 경로는 "me" 키를 사용하여 Camel 헤더에 매핑되는 매개변수를 사용합니다.

from("rest:get:hello/{me}")
  .transform().simple("Bye ${header.me}");

다음 예제에서는 기본 경로를 "hello"로 구성한 다음 uriTemplates를 사용하여 두 개의 REST 서비스를 구성합니다.

from("rest:get:hello:/{me}")
  .transform().simple("Hi ${header.me}");

from("rest:get:hello:/french/{me}")
  .transform().simple("Bonjour ${header.me}");

41.7. 나머지 프로듀서 예제

나머지 구성 요소를 사용하여 다른 Camel 구성 요소와 마찬가지로 REST 서비스에 호출할 수 있습니다.

예를 들어 hello/{me} 를 사용하여 에서 REST 서비스를 호출하려면 다음을 수행할 수 있습니다.

from("direct:start")
  .to("rest:get:hello/{me}");

동적 값 {me} 는 동일한 이름으로 Camel 메시지에 매핑됩니다. 따라서 이 REST 서비스를 호출하려면 다음과 같이 빈 메시지 본문과 헤더를 보낼 수 있습니다.

template.sendBodyAndHeader("direct:start", null, "me", "Donald Duck");

Rest 생산자는 다음과 같이 host 옵션을 사용하여 구성할 수 있는 REST 서비스의 호스트 이름과 포트를 알아야 합니다.

from("direct:start")
  .to("rest:get:hello/{me}?host=myserver:8080/foo");

host 옵션을 사용하는 대신 다음과 같이 restConfiguration 에서 호스트를 구성할 수 있습니다.

restConfiguration().host("myserver:8080/foo");

from("direct:start")
  .to("rest:get:hello/{me}");

producerComponent 를 사용하여 HTTP 클라이언트로 사용할 Camel 구성 요소를 선택할 수 있습니다. 예를 들면 http를 사용할 수 있습니다.

restConfiguration().host("myserver:8080/foo").producerComponent("http");

from("direct:start")
  .to("rest:get:hello/{me}");

41.8. 나머지 프로듀서 바인딩

REST 생산자는 JSon 또는 rest-dsl과 같은 XML을 사용하여 바인딩을 지원합니다.

예를 들어 json 바인딩 모드가 켜진 상태에서 jetty를 사용하려면 나머지 구성에서 이 값을 구성할 수 있습니다.

restConfiguration().component("jetty").host("localhost").port(8080).bindingMode(RestBindingMode.json);

from("direct:start")
  .to("rest:post:user");

그런 다음 rest 생산자를 사용하여 REST 서비스를 호출할 때 REST 서비스를 호출하기 전에 자동으로 json에 대한 바인딩을 수행합니다.

  UserPojo user = new UserPojo();
  user.setId(123);
  user.setName("Donald Duck");

  template.sendBody("direct:start", user);

위의 예제에서는 메시지 본문으로 10.0.0.1 인스턴스 UserPojo 를 보냅니다. 그리고 나머지 구성에서 JSon 바인딩을 사용했기 때문에 REST 서비스를 호출하기 전에 ScanSetting에서 JSon으로 마샬링됩니다.

그러나 응답 메시지에 대한 바인딩도 수행하려는 경우(예: REST 서비스가 응답으로 다시 전송하는) outType 옵션을 구성하여 JSon에서 gRPC로 마칠 수 있도록 CloudEvent의 클래스 이름을 지정해야 합니다.

예를 들어 REST 서비스가 com.foo.MyResponsePojo 에 바인딩하는 JSon 페이로드를 반환하는 경우 다음과 같이 구성할 수 있습니다.

  restConfiguration().component("jetty").host("localhost").port(8080).bindingMode(RestBindingMode.json);

  from("direct:start")
    .to("rest:post:user?outType=com.foo.MyResponsePojo");
참고

REST 서비스 호출에서 수신한 응답 메시지에 대해 10.0.0.1 바인딩이 수행되도록 하려면 outType 옵션을 구성해야 합니다.

41.9. 더 많은 예

더 많은 예제를 제공하는 Rest DSL과 REST DSL을 사용하여 더 좋은 RESTful 방식으로 정의하는 방법을 참조하십시오.

Apache Camel 배포에는 camel-example-servlet-rest-tomcat 예제가 있습니다. 이 예제에서는 SERVLET와 함께 Rest DSL을 Apache Tomcat 또는 유사한 웹 컨테이너에 배포할 수 있는 전송으로 사용하는 방법을 보여줍니다.

41.10. Spring Boot Auto-Configuration

Spring Boot와 함께 rest를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-rest-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.rest-api.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.rest-api.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.rest-api.enabled

rest-api 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.rest.api-doc

사용할 swagger api doc 리소스입니다. 리소스는 기본적으로 classpath에서 로드되며 JSON 형식이어야 합니다.

 

문자열

camel.component.rest.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.rest.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.rest.consumer-component-name

jetty, 서블릿, undertow와 같이 REST 전송에 사용할 Camel Rest 구성 요소. 명시적으로 구성된 구성 요소가 없는 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestConsumerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.component.rest.enabled

나머지 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.rest.host

사용할 HTTP 서비스의 호스트 및 포트(swagger 스키마의 호스트 제외).

 

문자열

camel.component.rest.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.rest.producer-component-name

http, undertow와 같은 REST 전송에 사용할 Camel Rest 구성 요소. 구성 요소가 명시적으로 구성되지 않은 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestProducerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.component.rest.component-name

더 이상 사용되지 않는 Camel Rest 구성 요소는 http, undertow와 같은 REST 전송에 사용할 (producer)입니다. 구성 요소가 명시적으로 구성되지 않은 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestProducerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

42장. Salgo

프로듀서만 지원됩니다.

슬레이드는 EIP를 사용하여 경로 내에서 사용자 지정 작업을 실행할 수 있는 브릿지를 제공합니다.

구성 요소는 completionMode를 MANUAL 로 설정하거나 완료하도록 결정하는 등 고급 작업에 사용해야 합니다.

일반적인 시나리오에서 s evers를 사용하는 방법에 대한 도움말은 S ever EIP 설명서를 참조하십시오.

42.1. URI 형식

saga:action

42.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

42.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

42.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

42.3. 구성 요소 옵션

슬레이드 구성 요소는 아래에 나열된 두 가지 옵션을 지원합니다.

이름설명Default유형

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

42.4. 끝점 옵션

S3-4 끝점은 URI 구문을 사용하여 구성됩니다.

saga:action

다음과 같은 경로 및 쿼리 매개변수 사용:

42.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

작업 (producer)

실행하는데 필요한 작업(완전 또는 보완).

CloudEvent 값:

  • 완료
  • 조정
 

SagaEndpointAction

42.4.2. 쿼리 매개변수(1 매개변수)

이름설명Default유형

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

42.5. Spring Boot Auto-Configuration

Spring Boot와 함께 스릴링을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-saga-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.saga.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.saga.enabled

구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.saga.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

43장. Salesforce

생산자 및 소비자 모두 지원

이 구성 요소는 Java DTO를 사용하여 manufacturer 및 Consumer 엔드 포인트와 통신할 수 있도록 지원합니다.
이러한 DTO를 생성하는 동료 maven 플러그인 Camelvdd Plugin이 있습니다(아래 참조).

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-salesforce</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>
참고

구성 요소에 기여하려는 개발자는 통합 테스트를 실행하기 위한 환경을 시작하고 설정하는 방법에 대한 지침에 대한 README.md 파일을 검토해야 합니다.

43.1. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

43.1.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

43.1.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

43.2. 구성 요소 옵션

CloudEvent 구성 요소는 아래에 나열된 90 옵션을 지원합니다.

이름설명Default유형

apexMethod (common)

APEX 방법 이름입니다.

 

문자열

apexQueryParams (common)

APEX 방법에 대한 쿼리 매개변수입니다.

 

map

apiVersion (common)

CloudEvent API 버전.

53.0

문자열

backoffIncrement (common)

CometD auto-reconnect 이외의 실패에 대한 Streaming 연결 재시작 시도에 대한 백오프 간격 증가

1000

long

batchId (common)

일괄 API 배치 ID입니다.

 

문자열

contentType (공용)

일괄 API 콘텐츠 유형, XML, CSV, ZIP_XML, ZIP_CSV.

CloudEvent 값:

  • XML
  • CSV
  • JSON
  • ZIP_XML
  • ZIP_CSV
  • ZIP_JSON
 

ContentType

defaultReplayId (common)

initialReplayIdMap에 값이 없는 경우 기본 replayId 설정입니다.

-1

long

fallBackReplayId (common)

잘못된 Replay Id 응답 후 돌아가려면 ReplayId입니다.

-1

long

형식 (공용)

JSON 또는 XML 중 하나인 gRPC API 호출에 사용하는 페이로드 형식은 기본적으로 JSON입니다. Camel 3.12부터 이 옵션은 Raw 작업에만 적용됩니다.

CloudEvent 값:

  • JSON
  • XML
 

PayloadFormat

10.0.0.1Client (common)

export에 연결하는 데 사용할 사용자 정의anchor Client입니다.

 

SalesforceHttpClient

httpClientConnectionTimeout (common)

10.0.0.1 서버에 연결할 때 10.0.0.1Client에서 사용하는 연결 시간 초과입니다.

60000

long

httpClientIdleTimeout (common)

10.0.0.1 서버의 응답을 대기할 때 10.0.0.1Client에서 사용하는 시간 초과입니다.

10000

long

httpMaxContentLength (common)

HTTP 응답의 최대 콘텐츠 길이입니다.

 

정수

httpRequestBufferSize (common)

HTTP 요청 버퍼 크기. 대규모 SOQL 쿼리를 위해서는 늘려야 할 수도 있습니다.

8192

정수

include Details (common)

10.0.0.11 분석 보고서에 세부 정보를 포함하면 기본값은 false입니다.

 

부울

initialReplayIdMap (common)

채널 이름별로 시작하는 ID를 재생합니다.

 

map

InstanceID (공용)

CloudEvent1 분석에서는 실행 인스턴스 ID를 보고합니다.

 

문자열

jobId (공용)

대규모 API 작업 ID.

 

문자열

제한 (공용)

반환된 레코드 수를 제한합니다. 일부 API에 적용 가능한 경우 CloudEvent 설명서를 확인하십시오.

 

정수

locator (common)

Query 작업에 대한 결과를 가져오는 데 사용할 수 있도록 salesforce Bulk 2.0 API에서 제공하는 locator입니다.

 

문자열

maxBackoff (공용)

CometD auto-reconnect 이외의 실패 시도에 대한 스트리밍 연결 재시작 시도의 최대 백오프 간격입니다.

30000

long

maxRecords (common)

Bulk 2.0 쿼리에 대한 결과 집합별로 검색할 최대 레코드 수입니다. 요청에 따라 크기가 제한됩니다. 매우 많은 수의 쿼리 결과로 작업 중인 경우 CloudEvent에서 모든 데이터를 수신하기 전에 시간 초과가 발생할 수 있습니다. 시간 초과를 방지하려면 클라이언트가 maxRecords 매개변수에서 수신할 최대 레코드 수를 지정합니다. 이렇게 하면 결과를 최대 크기로 사용하여 결과를 더 작은 세트로 분할합니다.

 

정수

notFoundBehaviour (common)

10.0.0.1 API에서 수신한 404 not found status의 동작을 설정합니다. 본문이 NULL NotFoundBehaviour#NULL로 설정되어야 하는 경우 또는 예외가 알림 NotFoundBehaviour#EXCEPTION - 기본값입니다.

CloudEvent 값:

  • 예외
  • NULL

예외

NotFoundBehaviour

notifyForFields (common)

필드, 옵션에 대한 알림은 ALL, REFERENCED, Select,>-<, 10.0.0.1입니다.

CloudEvent 값:

  • ALL
  • 참조됨
  • SELECT
  • WHERE
 

NotifyForFieldsEnum

notifyForOperationCreate (common)

생성 작업에 대한 알림, 기본값은 false(API 버전 = 29.0)입니다.

 

부울

notifyForOperationDelete (common)

삭제 작업에 대한 알림, 기본값은 false(API 버전 = 29.0)입니다.

 

부울

notifyForOperations (common)

알림 작업, 옵션은 ALL, CREATE, EXTENDED, UPDATE(API 버전 29.0)입니다.

CloudEvent 값:

  • ALL
  • CREATE
  • 확장
  • UPDATE
 

NotifyForOperationsEnum

notifyForOperationUndelete (common)

삭제 해제 작업을 요청하고 기본값은 false(API 버전 = 29.0)입니다.

 

부울

notifyForOperationUpdate (common)

업데이트 작업에 대한 알림, 기본값은 false(API 버전 = 29.0)입니다.

 

부울

ObjectMapper (common)

Custom Jackson ObjectMapper는 CloudEvent 오브젝트를 직렬화/deserializing할 때 사용할 수 있습니다.

 

ObjectMapper

패키지 (공용)

생성된 DTO 클래스는 어떤 패키지가 있습니까. 일반적으로 클래스는 camel-salesforce-maven-plugin을 사용하여 생성됩니다. 생성된 DTO를 사용하여 parameters/header 값에 짧은 SObject 이름을 사용할 수 있는 이점을 얻는 경우 이를 설정합니다. 여러 패키지를 쉼표로 구분할 수 있습니다.

 

문자열

pkChunking (common)

PK Chunking을 사용하십시오. 원래 Bulk API에서만 사용됩니다. 대량 2.0 API는 필요한 경우 PK 청크를 자동으로 수행합니다.

 

부울

pkChunkingChunkSize (common)

PK 청크와 함께 사용할 청크 크기입니다. 지정되지 않은 경우 Salesforce 기본값은 10,000입니다. 최대 크기는 250,000입니다.

 

정수

pkChunkingParent (common)

개체 공유에 대한 쿼리를 PK 청크를 활성화할 때 상위 오브젝트를 지정합니다. 청크는 공유 오브젝트의 레코드가 아닌 상위 오브젝트의 레코드를 기반으로 합니다. 예를 들어 AccountShare를 쿼리할 때 Account를 상위 오브젝트로 지정합니다. 상위 오브젝트가 지원되는 경우 PK 청크가 오브젝트 공유용으로 지원됩니다.

 

문자열

pkChunkingStartRow (common)

첫 번째 청크의 하위 경계로 사용할 15자 또는 18자 레코드 ID를 지정합니다. 이 매개변수를 사용하여 배치 간에 실패한 작업을 다시 시작할 때 시작 ID를 지정합니다.

 

문자열

queryLocator (common)

쿼리 결과 단일 호출에서 검색할 수 있는 것보다 더 많은 레코드를 생성할 때 사용하기 위해 salesforce에서 제공하는 쿼리 로케이터입니다. 후속 호출에서 이 값을 사용하여 추가 레코드를 검색합니다.

 

문자열

rawPayload (common)

요청 및 응답에 원시 페이로드 문자열(형식에 따라 JSON 또는 XML)을 사용합니다. 기본적으로 DTO는 false입니다.

false

boolean

reportId (공용)

CloudEvent1 분석 보고서 Id.

 

문자열

reportMetadata (common)

필터링을 위한 CloudEvent1 분석 메타데이터를 보고합니다.

 

ReportMetadata

resultId (공용)

일괄 API Result ID입니다.

 

문자열

sObjectBlobFieldName (common)

SObject blob 필드 이름입니다.

 

문자열

sObjectClass (common)

일반적으로 camel-salesforce-maven-plugin을 사용하여 생성된 정규화된 SObject 클래스 이름입니다.

 

문자열

sObjectFields (common)

검색할 SObject 필드입니다.

 

문자열

sObjectId (common)

API에 필요한 경우 SObject ID입니다.

 

문자열

sObjectIdName (common)

SObject external ID 필드 이름입니다.

 

문자열

sObjectIdValue (common)

SObject external ID 필드 값.

 

문자열

sObjectName (common)

API에서 필요하거나 지원하는 경우 SObject 이름입니다.

 

문자열

sObjectQuery (공용)

CloudEvent SOQL 쿼리 문자열.

 

문자열

sObjectSearch (common)

CloudEvent SOSL 검색 문자열

 

문자열

updateTopic (common)

스트리밍 API를 사용할 때 기존 Push Topic을 업데이트할지 여부이며 기본값은 false입니다.

false

boolean

config (advanced)

글로벌 끝점 구성 - 모든 끝점에 공통된 값을 설정하는 데 사용합니다.

 

SalesforceEndpointConfig

httpClientProperties (공용 (advanced))

기본 HTTP 클라이언트에서 구성할 수 있는 모든 속성을 설정하는 데 사용됩니다. 사용 가능한 모든 옵션에 대해 10.0.0.1HttpClient의 속성과>-<ty>-<Client의 속성을 살펴보십시오.

 

map

longPollingTransportProperties (common (advanced))

streaming API에서 사용하는 TaluxClient(CometD)에서 사용하는 LongPollingTransport에서 구성할 수 있는 모든 속성을 설정하는 데 사용됩니다.

 

map

workerPoolMaxSize (일반적으로 (advanced))

HTTP 응답을 처리하는 데 사용되는 스레드 풀의 최대 크기입니다.

20

int

workerPoolSize (공용 (advanced))

HTTP 응답을 처리하는 데 사용되는 스레드 풀의 크기입니다.

10

int

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

All OrNone (producer)

성공하지 못한 경우 모든 레코드를 롤백하도록 지시하는 복합 API 옵션.

false

boolean

apexUrl (producer)

APEX 방법 URL.

 

문자열

compositeMethod (producer)

복합(raw) 방법.

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

rawHttpHeaders (producer)

Raw 작업의 HTTP 매개변수로 포함할 메시지 헤더의 쉼표로 구분된 목록입니다.

 

문자열

rawMethod (producer)

Raw 작업에 사용할 HTTP 방법입니다.

 

문자열

rawPath (producer)

도메인 이름 뒤에 있는 끝점 URL의 일부입니다. E.g., '/services/data/v52.0/sobjects/Account/'.

 

문자열

rawQueryParameters (producer)

Raw 작업에 대한 쿼리 매개변수로 포함할 메시지 헤더의 쉼표로 구분된 목록입니다. 이 작업이 자동으로 수행되므로 URL 인코딩 값을 지정하지 마십시오.

 

문자열

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

httpProxyExcludedAddresses (proxy)

HTTP 프록시 서버를 사용하지 않아야 하는 주소 목록입니다.

 

Set

httpProxyHost (proxy)

사용할 HTTP 프록시 서버의 호스트 이름입니다.

 

문자열

httpProxyIncludedAddresses (proxy)

HTTP 프록시 서버를 사용해야 하는 주소 목록입니다.

 

Set

httpProxyPort (proxy)

사용할 HTTP 프록시 서버의 포트 번호입니다.

 

정수

httpProxySocks4 (proxy)

true로 설정하는 경우 는 10.0.0.1KS4 프록시로 사용하도록 HTTP 프록시를 구성합니다.

false

boolean

AuthenticationType (security)

사용할 명시적 인증 방법, USERNAME_PASSWORD, REFRESH_TOKEN 또는 JWT 중 하나입니다. CloudEvent 구성 요소는 속성 세트에서 사용할 인증 방법을 자동으로 확인하고 모호성을 제거하도록 이 속성을 설정할 수 있습니다.

CloudEvent 값:

  • USERNAME_PASSWORD
  • REFRESH_TOKEN
  • JWT
 

AuthenticationType

ClientID (보안)

CloudEvent 인스턴스 설정에 구성된 연결된 앱의 OAuth 소비자 키입니다. 일반적으로 연결된 앱을 구성해야 하지만 패키지를 설치하여 제공할 수 있습니다.

 

문자열

clientSecret (보안)

CloudEvent 인스턴스 설정에 구성된 연결된 앱의 OAuth 소비자 시크릿입니다.

 

문자열

httpProxyAuthUri (보안)

HTTP 프록시 서버에 대한 인증에 사용되는 httpProxyUsername 및 httpProxyPassword를 인증에 사용하려면 프록시 서버의 URI와 일치해야 합니다.

 

문자열

httpProxyPassword (security)

HTTP 프록시 서버에 인증하는 데 사용할 암호입니다.

 

문자열

httpProxyRealm (security)

HTTP 프록시 서버에 대한 선점 기본/Digest 인증 방법에 사용되는 프록시 서버의 영역입니다.

 

문자열

httpProxySecure (security)

false로 설정하면 HTTP 프록시에 액세스할 때 TLS 사용을 비활성화합니다.

true

boolean

httpProxyUseDigestAuth (보안)

HTTP 프록시로 인증할 때 true 다이제스트 인증으로 설정된 경우, 그렇지 않으면 기본 권한 부여 방법이 사용됩니다.

false

boolean

httpProxyUsername (security)

HTTP 프록시 서버에 인증하는 데 사용할 사용자 이름입니다.

 

문자열

instanceUrl (보안)

인증 후 사용되는 Sales 인스턴스의 URL입니다. 기본적으로 인증이 완료되면 CloudEvent에서 수신됩니다.

 

문자열

jwtAudience (보안)

OAuth JWT 흐름을 사용할 때 CloudEvent 클레임(aud)에 사용할 값입니다. 설정되지 않은 경우 로그인 URL이 사용되며 대부분의 경우 적절합니다.

 

문자열

키 저장소 (보안)

OAuth JWT 흐름에서 사용할 키 저장소 매개변수입니다. KeyStore에는 개인 키 및 인증서가 있는 항목이 하나만 포함되어야 합니다. CloudEvent는 인증서 체인을 확인하지 않으므로 자체 서명된 인증서가 쉽게 될 수 있습니다. 연결된 앱에 인증서를 업로드했는지 확인합니다.

 

KeyStoreParameters

lazyLogin (보안)

true로 설정하면 구성 요소가 구성 요소가 시작된 상태로 10.0.0.1으로 인증되지 않습니다. 일반적으로 이 값을 (기본값) false로 설정하고 초기에 인증하고 모든 인증 문제를 즉시 인식합니다.

false

boolean

loginConfig (보안)

하나의 중첩된 빈에 있는 모든 인증 구성, 구성 요소에 직접 설정된 모든 속성은 구성 요소에 직접 설정할 수 있습니다.

 

SalesforceLoginConfig

loginURL (보안)

인증에 사용되는 Sales 인스턴스의 필수 URL입니다. 기본적으로 https://login.salesforce.com 로 설정됩니다.

https://login.salesforce.com

문자열

암호 (보안)

토큰에 액세스하기 위해 OAuth 흐름에 사용하는 암호입니다. 암호 OAuth 흐름을 쉽게 시작할 수 있지만 일반적으로 다른 흐름보다 안전하지 않은 것으로 간주되므로 일반적으로 사용하지 않아야 합니다. 암호를 사용하는 경우 보안 토큰을 암호 끝에 추가해야 합니다.

 

문자열

refreshToken (보안)

새로 고침 토큰 OAuth 흐름에 토큰 새로 고침이 이미 있습니다. 웹 애플리케이션을 설정하고 새로 고침 토큰을 수신하도록 콜백 URL을 구성하거나 https://login.salesforce.com/services/oauth2/success 또는 https://test.salesforce.com/services/oauth2/success 에서 내장 콜백을 사용한 다음 흐름 끝에 URL에서 refresh_token을 다시 시도해야 합니다. 개발 조직의 10.0.0.1에서는 localhost에서 콜백 웹 애플리케이션을 호스팅할 수 있습니다.

 

문자열

sslContextParameters (보안)

사용할 SSL 매개변수는 사용 가능한 모든 옵션에 대한 SSLContextParameters 클래스를 참조하십시오.

 

SSLContextParameters

useGlobalSslContextParameters (security)

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

boolean

사용자 이름 (보안)

토큰에 액세스하기 위해 OAuth 흐름에 사용하는 사용자 이름입니다. 암호 OAuth 흐름을 쉽게 시작할 수 있지만 일반적으로 다른 흐름보다 안전하지 않은 것으로 간주되므로 일반적으로 사용하지 않아야 합니다.

 

문자열

43.3. 끝점 옵션

CloudEvent 끝점은 URI 구문을 사용하여 구성됩니다.

salesforce:operationName:topicName

다음과 같은 경로 및 쿼리 매개변수 사용:

43.3.1. 경로 매개변수(2 매개변수)

이름설명Default유형

operationName (producer)

사용할 작업입니다.

CloudEvent 값:

  • getVersions
  • getResources
  • getGlobalObjects
  • getBasicInfo
  • getDescription
  • getSObject
  • createSObject
  • updateSObject
  • deleteSObject
  • getSObjectWithId
  • upsertSObject
  • deleteSObjectWithId
  • getBlobField
  • query
  • queryMore
  • queryAll
  • search
  • apexCall
  • recent
  • createJob
  • getJob
  • closeJob
  • abortJob
  • createBatch
  • getBatch
  • getAllBatches
  • getRequest
  • getResults
  • createBatchQuery
  • getQueryResultIds
  • getQueryResult
  • getRecentReports
  • getReportDescription
  • executeSyncReport
  • executeAsyncReport
  • getReportInstances
  • getReportResults
  • limits
  • 승인
  • 승인
  • composite-tree
  • 복합 배치
  • composite
  • compositeRetrieveSObjectCollections
  • compositeCreateSObjectCollections
  • compositeUpdateSObjectCollections
  • compositeUpsertSObjectCollections
  • compositeDeleteSObjectCollections
  • bulk2GetAllJobs
  • bulk2CreateJob
  • bulk2GetJob
  • bulk2CreateBatch
  • bulk2CloseJob
  • bulk2AbortJob
  • bulk2DeleteJob
  • bulk2GetSuccessfulResults
  • bulk2GetFailedResults
  • bulk2GetUnprocessedRecords
  • bulk2CreateQueryJob
  • bulk2GetQueryJob
  • bulk2GetAllQueryJobs
  • bulk2GetQueryJobResults
  • bulk2AbortQueryJob
  • bulk2DeleteQueryJob
  • Raw
 

OperationName

topicName (consumer)

사용할 주제/채널의 이름입니다.

 

문자열

43.3.2. 쿼리 매개변수(57 매개변수)

이름설명Default유형

apexMethod (common)

APEX 방법 이름입니다.

 

문자열

apexQueryParams (common)

APEX 방법에 대한 쿼리 매개변수입니다.

 

map

apiVersion (common)

CloudEvent API 버전.

53.0

문자열

backoffIncrement (common)

CometD auto-reconnect 이외의 실패에 대한 Streaming 연결 재시작 시도에 대한 백오프 간격 증가

1000

long

batchId (common)

일괄 API 배치 ID입니다.

 

문자열

contentType (공용)

일괄 API 콘텐츠 유형, XML, CSV, ZIP_XML, ZIP_CSV.

CloudEvent 값:

  • XML
  • CSV
  • JSON
  • ZIP_XML
  • ZIP_CSV
  • ZIP_JSON
 

ContentType

defaultReplayId (common)

initialReplayIdMap에 값이 없는 경우 기본 replayId 설정입니다.

-1

long

fallBackReplayId (common)

잘못된 Replay Id 응답 후 돌아가려면 ReplayId입니다.

-1

long

형식 (공용)

JSON 또는 XML 중 하나인 gRPC API 호출에 사용하는 페이로드 형식은 기본적으로 JSON입니다. Camel 3.12부터 이 옵션은 Raw 작업에만 적용됩니다.

CloudEvent 값:

  • JSON
  • XML
 

PayloadFormat

10.0.0.1Client (common)

export에 연결하는 데 사용할 사용자 정의anchor Client입니다.

 

SalesforceHttpClient

include Details (common)

10.0.0.11 분석 보고서에 세부 정보를 포함하면 기본값은 false입니다.

 

부울

initialReplayIdMap (common)

채널 이름별로 시작하는 ID를 재생합니다.

 

map

InstanceID (공용)

CloudEvent1 분석에서는 실행 인스턴스 ID를 보고합니다.

 

문자열

jobId (공용)

대규모 API 작업 ID.

 

문자열

제한 (공용)

반환된 레코드 수를 제한합니다. 일부 API에 적용 가능한 경우 CloudEvent 설명서를 확인하십시오.

 

정수

locator (common)

Query 작업에 대한 결과를 가져오는 데 사용할 수 있도록 salesforce Bulk 2.0 API에서 제공하는 locator입니다.

 

문자열

maxBackoff (공용)

CometD auto-reconnect 이외의 실패 시도에 대한 스트리밍 연결 재시작 시도의 최대 백오프 간격입니다.

30000

long

maxRecords (common)

Bulk 2.0 쿼리에 대한 결과 집합별로 검색할 최대 레코드 수입니다. 요청에 따라 크기가 제한됩니다. 매우 많은 수의 쿼리 결과로 작업 중인 경우 CloudEvent에서 모든 데이터를 수신하기 전에 시간 초과가 발생할 수 있습니다. 시간 초과를 방지하려면 클라이언트가 maxRecords 매개변수에서 수신할 최대 레코드 수를 지정합니다. 이렇게 하면 결과를 최대 크기로 사용하여 결과를 더 작은 세트로 분할합니다.

 

정수

notFoundBehaviour (common)

10.0.0.1 API에서 수신한 404 not found status의 동작을 설정합니다. 본문이 NULL NotFoundBehaviour#NULL로 설정되어야 하는 경우 또는 예외가 알림 NotFoundBehaviour#EXCEPTION - 기본값입니다.

CloudEvent 값:

  • 예외
  • NULL

예외

NotFoundBehaviour

notifyForFields (common)

필드, 옵션에 대한 알림은 ALL, REFERENCED, Select,>-<, 10.0.0.1입니다.

CloudEvent 값:

  • ALL
  • 참조됨
  • SELECT
  • WHERE
 

NotifyForFieldsEnum

notifyForOperationCreate (common)

생성 작업에 대한 알림, 기본값은 false(API 버전 = 29.0)입니다.

 

부울

notifyForOperationDelete (common)

삭제 작업에 대한 알림, 기본값은 false(API 버전 = 29.0)입니다.

 

부울

notifyForOperations (common)

알림 작업, 옵션은 ALL, CREATE, EXTENDED, UPDATE(API 버전 29.0)입니다.

CloudEvent 값:

  • ALL
  • CREATE
  • 확장
  • UPDATE
 

NotifyForOperationsEnum

notifyForOperationUndelete (common)

삭제 해제 작업을 요청하고 기본값은 false(API 버전 = 29.0)입니다.

 

부울

notifyForOperationUpdate (common)

업데이트 작업에 대한 알림, 기본값은 false(API 버전 = 29.0)입니다.

 

부울

ObjectMapper (common)

Custom Jackson ObjectMapper는 CloudEvent 오브젝트를 직렬화/deserializing할 때 사용할 수 있습니다.

 

ObjectMapper

pkChunking (common)

PK Chunking을 사용하십시오. 원래 Bulk API에서만 사용됩니다. 대량 2.0 API는 필요한 경우 PK 청크를 자동으로 수행합니다.

 

부울

pkChunkingChunkSize (common)

PK 청크와 함께 사용할 청크 크기입니다. 지정되지 않은 경우 Salesforce 기본값은 10,000입니다. 최대 크기는 250,000입니다.

 

정수

pkChunkingParent (common)

개체 공유에 대한 쿼리를 PK 청크를 활성화할 때 상위 오브젝트를 지정합니다. 청크는 공유 오브젝트의 레코드가 아닌 상위 오브젝트의 레코드를 기반으로 합니다. 예를 들어 AccountShare를 쿼리할 때 Account를 상위 오브젝트로 지정합니다. 상위 오브젝트가 지원되는 경우 PK 청크가 오브젝트 공유용으로 지원됩니다.

 

문자열

pkChunkingStartRow (common)

첫 번째 청크의 하위 경계로 사용할 15자 또는 18자 레코드 ID를 지정합니다. 이 매개변수를 사용하여 배치 간에 실패한 작업을 다시 시작할 때 시작 ID를 지정합니다.

 

문자열

queryLocator (common)

쿼리 결과 단일 호출에서 검색할 수 있는 것보다 더 많은 레코드를 생성할 때 사용하기 위해 salesforce에서 제공하는 쿼리 로케이터입니다. 후속 호출에서 이 값을 사용하여 추가 레코드를 검색합니다.

 

문자열

rawPayload (common)

요청 및 응답에 원시 페이로드 문자열(형식에 따라 JSON 또는 XML)을 사용합니다. 기본적으로 DTO는 false입니다.

false

boolean

reportId (공용)

CloudEvent1 분석 보고서 Id.

 

문자열

reportMetadata (common)

필터링을 위한 CloudEvent1 분석 메타데이터를 보고합니다.

 

ReportMetadata

resultId (공용)

일괄 API Result ID입니다.

 

문자열

sObjectBlobFieldName (common)

SObject blob 필드 이름입니다.

 

문자열

sObjectClass (common)

일반적으로 camel-salesforce-maven-plugin을 사용하여 생성된 정규화된 SObject 클래스 이름입니다.

 

문자열

sObjectFields (common)

검색할 SObject 필드입니다.

 

문자열

sObjectId (common)

API에 필요한 경우 SObject ID입니다.

 

문자열

sObjectIdName (common)

SObject external ID 필드 이름입니다.

 

문자열

sObjectIdValue (common)

SObject external ID 필드 값.

 

문자열

sObjectName (common)

API에서 필요하거나 지원하는 경우 SObject 이름입니다.

 

문자열

sObjectQuery (공용)

CloudEvent SOQL 쿼리 문자열.

 

문자열

sObjectSearch (common)

CloudEvent SOSL 검색 문자열

 

문자열

updateTopic (common)

스트리밍 API를 사용할 때 기존 Push Topic을 업데이트할지 여부이며 기본값은 false입니다.

false

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

replayId (consumer)

구독할 때 사용할 replayId 값입니다.

 

long

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

All OrNone (producer)

성공하지 못한 경우 모든 레코드를 롤백하도록 지시하는 복합 API 옵션.

false

boolean

apexUrl (producer)

APEX 방법 URL.

 

문자열

compositeMethod (producer)

복합(raw) 방법.

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

rawHttpHeaders (producer)

Raw 작업의 HTTP 매개변수로 포함할 메시지 헤더의 쉼표로 구분된 목록입니다.

 

문자열

rawMethod (producer)

Raw 작업에 사용할 HTTP 방법입니다.

 

문자열

rawPath (producer)

도메인 이름 뒤에 있는 끝점 URL의 일부입니다. E.g., '/services/data/v52.0/sobjects/Account/'.

 

문자열

rawQueryParameters (producer)

Raw 작업에 대한 쿼리 매개변수로 포함할 메시지 헤더의 쉼표로 구분된 목록입니다. 이 작업이 자동으로 수행되므로 URL 인코딩 값을 지정하지 마십시오.

 

문자열

43.4. CloudEvent에 대한 인증

이 구성 요소는 세 가지 OAuth 인증 흐름을 지원합니다.

각 흐름에 대해 다른 속성 집합을 설정해야 합니다.

표 43.1. 표 1. 각 인증 흐름에 설정할 속성

속성CloudEvent에서 찾을 수 있는 위치flow

clientId

연결 앱, 소비자 키

모든 흐름

clientSecret

Connected App, Consumer Secret

username-Password, 새로 고침 토큰

userName

CloudEvent 사용자 사용자 이름

username-Password, JWT 베어러 토큰

암호

CloudEvent 사용자 암호

username-Password

refreshToken

OAuth 흐름 콜백

토큰 새로 고침

keystore

연결된 앱, 디지털 인증서

JWT 전달자 토큰

구성 요소 auto는 구성하려는 흐름을 결정하여 ambiguity를 제거하기 위해 authenticationType 속성을 설정합니다.

참고

프로덕션에 Username-Password Flow를 사용하는 것은 권장되지 않습니다.

참고

JWT 베어러 토큰 흐름에 사용되는 인증서는 자체 서명된 인증서일 수 있습니다. 인증서와 개인 키를 보유하는 KeyStore에는 단일 인증서-개인 키 항목만 포함되어야 합니다.

43.5. URI 형식

스트리밍 이벤트를 수신하는 소비자로 사용할 때 URI 스키마는 다음과 같습니다.

salesforce:topic?options

Sales REST API를 프로듀서로 사용하는 경우 URI 체계는 다음과 같습니다.

salesforce:operationName?options

43.6. CloudEvent 헤더에서 전달 및 CloudEvent 응답 헤더 가져오기

인바운드 메시지 헤더 를 통해 hieradata 헤더를 전달할 수 있으며, Camel 메시지에서 Sforce 또는 x-sfdc 로 시작하는 헤더 이름은 요청에서 전달되며, Sforce 로 시작하는 응답 헤더는 아웃바운드 메시지 헤더에 표시됩니다.

예를 들어 API 제한을 가져오려면 다음을 지정할 수 있습니다.

// in your Camel route set the header before Salesforce endpoint
//...
  .setHeader("Sforce-Limit-Info", constant("api-usage"))
  .to("salesforce:getGlobalObjects")
  .to(myProcessor);

// myProcessor will receive `Sforce-Limit-Info` header on the outbound
// message
class MyProcessor implements Processor {
    public void process(Exchange exchange) throws Exception {
        Message in = exchange.getIn();
        String apiLimits = in.getHeader("Sforce-Limit-Info", String.class);
   }
}

또한 HTTP 응답 상태 코드와 텍스트는 Exchange.HTTP_RESPONSE_CODEExchange.HTTP_RESPONSE_TEXT.

43.7. 지원되는 iPXE API

구성 요소에서 다음과 같은 iPXE API를 지원합니다.

생산자 엔드포인트는 다음 API를 사용할 수 있습니다. 대부분의 API는 한 번에 하나의 레코드를 처리하며 쿼리 API는 여러 레코드를 검색할 수 있습니다.

43.7.1. rest API

다음과 같이 operationName 을 사용할 수 있습니다.

  • getVersions - 지원되는 10.0.0.1 REST API 버전 가져오기
  • GetResources - 사용 가능한 10.0.0.1 REST 리소스 끝점을 가져옵니다.
  • getGlobalObjects - 사용 가능한 모든 SObject 유형에 대한 메타데이터를 가져옵니다.
  • getBasicInfo - 특정 SObject 유형의 기본 메타데이터를 가져옵니다.
  • GetDescription - 특정 SObject 유형에 대한 포괄적인 메타데이터를 가져옵니다.
  • getSObject - gRPC Id를 사용하여 SObject를 가져옵니다.
  • createSObject - SObject를 생성
  • updateSObject - Id를 사용하여 SObject 업데이트
  • DeleteSObject - Id를 사용하여 SObject 삭제
  • getSObjectWithId - 외부(사용자 정의) id 필드를 사용하여 SObject를 가져옵니다.
  • upsertSObject - 외부 ID를 사용하여 SObject를 업데이트하거나 삽입합니다.
  • DeleteSObjectWithId - 외부 ID를 사용하여 SObject 삭제
  • 쿼리 - CloudEvent SOQL 쿼리 실행
  • query>-< - 'query' API에서 반환된 결과 링크를 사용하여 더 많은 결과(결과가 많은 경우)
  • Search - Sales SOSL 쿼리 실행
  • 제한 - 조직 API 사용 제한 가져오기
  • 최근 - 최근 항목 가져오기
  • 승인 - 승인 프로세스를 위해 레코드 또는 레코드(배치) 제출
  • 승인 - 모든 승인 프로세스 목록 가져오기
  • 복합 - 최대 25개의 관련 REST 요청을 제출하고 개별 응답을 수신합니다. 제한 없이 "raw" composite을 사용할 수도 있습니다.
  • composite-tree - 한 번에 상위-하위 관계(최대 5개 수준)를 사용하여 최대 200개의 레코드를 만듭니다.
  • composite-batch - 일괄 처리로 요청 구성 제출
  • composite>-<SObject>-<s - 동일한 개체 유형의 하나 이상의 레코드입니다.
  • compositeCreateSObject>-<s - 최대 200개의 레코드를 추가하고 SaveSObjectResult 오브젝트 목록을 반환합니다.
  • compositeUpdateSObject>-<s - 최대 200개의 레코드를 업데이트하여 SaveSObjectResult 오브젝트 목록을 반환합니다.
  • compositeUpsertSObject>-<s - 외부 ID 필드를 기반으로 하는 최대 200개의 레코드의 생성 또는 업데이트(upsert)입니다. UpsertSObjectResult 개체 목록을 반환합니다.
  • compositeDeleteSObject>-<s - 최대 200개의 레코드를 삭제하여 SaveSObjectResult 오브젝트 목록을 반환합니다.
  • queryAll - SOQL 쿼리를 실행합니다. 병합으로 인해 삭제된 결과를 반환하고(최대 3개의 레코드를 레코드 중 하나에 병합, 다른 레코드를 삭제한 후 관련 레코드의 상위 순위를 지정) 또는 삭제합니다. 또한 보관된 Task 및 이벤트 레코드에 대한 정보를 반환합니다.
  • getBlobField - 개별 레코드에서 지정된 Blob 필드를 확인합니다.
  • apex>-< - 사용자 정의 APEX REST API 호출을 실행합니다.
  • Raw - Salesforce에 요청을 전송하고 끝점, 매개변수, 본문 등에 대한 완전한 원시 제어 권한을 갖습니다.

예를 들어 다음 생산자 끝점에서는 upsertSObject API를 사용하며 sObjectIdName 매개변수는 'Name'을 외부 id 필드로 지정합니다. 요청 메시지 본문은 maven 플러그인을 사용하여 생성된 SObject DTO여야 합니다. 응답 메시지는 기존 레코드가 업데이트된 경우 null 이거나 새 레코드의 ID가 있는 CreateSObjectResult 또는 새 오브젝트를 생성하는 동안 오류 목록이 됩니다.

...to("salesforce:upsertSObject?sObjectIdName=Name")...

43.7.2. 대규모 2.0 API

Bulk 2.0 API는 원래 Bulk API를 통해 단순화된 모델을 제공합니다. 이를 사용하여 대량의 데이터를 salesforce에 빠르게 로드하거나 많은 양의 Salesforce 데이터를 쿼리할 수 있습니다. 데이터는 CSV 형식으로 제공해야 합니다. Bulk 2.0의 최소 API 버전은 v41.0입니다. Bulk Queries의 최소 API 버전은 v47.0입니다. 아래에 언급된 DTO 클래스는 org.apache.camel.component.salesforce.api.dto.bulkv2 패키지에서 가져온 것입니다. 지원되는 작업은 다음과 같습니다.

  • bulk2CreateJob - 대규모 작업 생성. 메시지 본문에 Job 인스턴스를 제공합니다.
  • bulk2GetJob - 기존 작업을 가져옵니다. jobId 매개변수가 필요합니다.
  • bulk2CreateBatch - 작업에 CSV 레코드 배치를 추가합니다. 메시지 본문에 CSV 데이터를 제공합니다. 첫 번째 행에는 헤더가 포함되어야 합니다. jobId 매개변수가 필요합니다.
  • bulk2ECDHEJob - 작업을 종료합니다. 작업을 처리하거나 중단/삭제하려면 작업을 종료해야 합니다. jobId 매개변수가 필요합니다.
  • bulk2AbortJob - 작업을 제거합니다. jobId 매개변수가 필요합니다.
  • bulk2DeleteJob - 작업 삭제. jobId 매개변수가 필요합니다.
  • bulk2GetSuccessfulResults - 작업에 대한 성공 결과를 가져옵니다. 반환된 메시지 본문에는 CSV 데이터의 InputStream이 포함됩니다. jobId 매개변수가 필요합니다.
  • bulk2GetFailedResults - 작업에 실패한 결과를 가져옵니다. 반환된 메시지 본문에는 CSV 데이터의 InputStream이 포함됩니다. jobId 매개변수가 필요합니다.
  • bulk2GetUnprocessedRecords - 작업에 대해 처리되지 않은 레코드를 가져옵니다. 반환된 메시지 본문에는 CSV 데이터의 InputStream이 포함됩니다. jobId 매개변수가 필요합니다.
  • bulk2GetAllJobs - 모든 작업을 가져옵니다. 응답 본문은 작업 인스턴스입니다. done 속성이 false인 경우 가져올 추가 페이지가 있고 nextRecordsUrl 속성에는 후속 호출에 대한 queryLocator 매개변수에 설정할 값이 포함되어 있습니다.
  • bulk2CreateQueryJob - 대규모 쿼리 작업을 생성합니다. 메시지 본문에 QueryJob 인스턴스를 제공합니다.
  • bulk2GetQueryJob - 대규모 쿼리 작업 가져오기. jobId 매개변수가 필요합니다.
  • bulk2GetQueryJobResults - 대규모 쿼리 작업 결과 가져오기. jobId 매개변수가 필요합니다. maxRecordslocator 매개변수를 허용합니다. 응답 메시지 헤더에는 Sforce-NumberOfRecordsSforce-Locator 헤더가 포함됩니다. Sforce-Locator 의 값은 locator 매개변수를 통해 후속 호출로 전달될 수 있습니다.
  • bulk2AbortQueryJob - 대규모 쿼리 작업 중단 jobId 매개변수가 필요합니다.
  • bulk2DeleteQueryJob - 대규모 쿼리 작업 삭제. jobId 매개변수가 필요합니다.
  • bulk2GetAllQueryJobs - 모든 작업을 가져옵니다. 응답 본문은 QueryJobs 의 인스턴스입니다. done 속성이 false인 경우 가져올 추가 페이지가 있고 nextRecordsUrl 속성에는 후속 호출에 대한 queryLocator 매개변수에 설정할 값이 포함되어 있습니다.

43.7.3. rest Bulk(original) API

생산자 엔드포인트는 다음 API를 사용할 수 있습니다. 모든 작업 데이터 형식, 즉 xml, csv, zip/xml 및 zip/csv가 지원됩니다.
요청과 응답은 경로에 의해 마샬링/해결되어야 합니다. 일반적으로 요청은 CSV 파일과 같은 일부 스트림 소스이며
응답이 요청과 관련이 있을 수 있도록 파일에 저장할 수도 있습니다.

다음과 같이 operationName 을 사용할 수 있습니다.

  • createJob - CloudEvent Bulk 작업을 생성합니다. 본문에 JobInfo 인스턴스를 제공해야 합니다. PK Chunking은 pkChunking* 옵션을 통해 지원됩니다. 여기에 대한 설명을 참조하십시오.
  • getJob - gRPC Id를 사용하여 작업을 가져옵니다.
  • Close Job - 작업을 종료합니다.
  • abortJob - 작업 중단
  • createBatch - Bulk 작업 내에서 배치 제출
  • getBatch - Id를 사용하여 Batch를 가져옵니다.
  • getAllBatches - Bulk Job Id에 대한 모든 배치를 가져옵니다.
  • getRequest - 배치에 대한 요청 데이터(XML/CSV)를 가져옵니다.
  • getResults - 완료될 때 배치의 결과를 가져옵니다.
  • createBatchQuery - SOQL 쿼리에서 배치를 생성
  • getQueryResultIds - 배치 쿼리에 대한 Result Ids 목록을 가져옵니다.
  • getQueryResult - Result Id의 결과를 가져옵니다.
  • getRecentReports - 보고서 목록 리소스로 GET 요청을 보내 가장 최근에 본 보고서의 최대 200을 가져옵니다.
  • getReportDescription - 테이블 형식 또는 요약 또는 매트릭스 형식으로 보고서의 보고서, 보고서 유형 및 관련 메타데이터를 확인합니다.
  • executeSyncReport - 필터를 변경하거나 변경하지 않고 보고서를 동기식으로 실행하고 최신 요약 데이터를 반환합니다.
  • executeAsyncReport - 필터를 사용하거나 사용하지 않고 보고서의 인스턴스를 비동기식으로 실행하고 세부 정보를 사용하거나 사용하지 않고 요약 데이터를 반환합니다.
  • getReportInstances - 비동기적으로 실행되도록 요청한 보고서에 대한 인스턴스 목록을 반환합니다. 목록의 각 항목은 보고서의 개별 인스턴스로 처리됩니다.
  • getReportResults: 보고서 실행 결과가 포함되어 있습니다.

예를 들어 다음 생산자 엔드포인트는 createBatch API를 사용하여 작업 배치를 생성합니다. 메시지에는 입력Stream(일반적으로 파일에서 UTF-8 CSV 또는 XML 콘텐츠 등)으로 변환할 수 있는 본문과 XML, CSV, ZIP_XML 또는 ZIP_CSV일 수 있는 Job 콘텐츠 유형의 경우 'contentType' 헤더 필드 'jobId'가 포함되어야 합니다. 배치 메시지 본문에는 BatchInfo 가 성공적으로 포함되거나 오류 발생 시 ScanSettingException 이 발생합니다.

...to("salesforce:createBatch")..

43.7.4. rest Streaming API

소비자 끝점은 스트리밍 엔드 포인트에서 다음 구문을 사용하여 생성/업데이트에서 10.0.0.1 알림을 수신할 수 있습니다.

주제를 만들고 구독하려면 다음을 수행합니다.

from("salesforce:CamelTestTopic?notifyForFields=ALL&notifyForOperations=ALL&sObjectName=Merchandise__c&updateTopic=true&sObjectQuery=SELECT Id, Name FROM Merchandise__c")...

기존 주제를 구독하려면 다음을 수행합니다.

from("salesforce:CamelTestTopic&sObjectName=Merchandise__c")...

43.7.5. 플랫폼 이벤트

플랫폼 이벤트를 보내려면 createSObject 작업을 사용합니다. 그리고 메시지 본문을 JSON 문자열 또는 키-값 data가 있는 InputStream으로 설정할 수 있습니다. 이 경우 sObjectName 은 이벤트의 API 이름 또는 이벤트에 대한 적절한 클래스 이름을 사용하여 AbstractDTOBase에서 확장되는 클래스로 설정해야 합니다.

예를 들어 DTO 사용:

class Order_Event__e extends AbstractDTOBase {
  @JsonProperty("OrderNumber")
  private String orderNumber;
  // ... other properties and getters/setters
}

from("timer:tick")
    .process(exchange -> {
        final Message in = exchange.getIn();
        String orderNumber = "ORD" + exchange.getProperty(Exchange.TIMER_COUNTER);
        Order_Event__e event = new Order_Event__e();
        event.setOrderNumber(orderNumber);
        in.setBody(event);
    })
    .to("salesforce:createSObject");

또는 JSON 이벤트 데이터 사용:

from("timer:tick")
    .process(exchange -> {
        final Message in = exchange.getIn();
        String orderNumber = "ORD" + exchange.getProperty(Exchange.TIMER_COUNTER);
        in.setBody("{\"OrderNumber\":\"" + orderNumber + "\"}");
    })
    .to("salesforce:createSObject?sObjectName=Order_Event__e");

플랫폼 이벤트를 수신하려면 이벤트/(또는 / event/ ) 접두사가 붙은 플랫폼 이벤트의 API 이름이 있는 소비자 끝점을 사용합니다(예: salesforce:events/Order_Event__e ). 해당 끝점에서 사용하는 프로세서는 각각 org.apache.camel.component.salesforce.api.dto.PlatformEvent 오브젝트 또는 org.cometd.bayeux.Message 를 수신합니다.

예를 들어 가장 간단한 양식에서는 하나의 이벤트를 사용합니다.

PlatformEvent event = consumer.receiveBody("salesforce:event/Order_Event__e", PlatformEvent.class);

43.7.6. 변경 데이터 캡처 이벤트

한 쪽에서 select 오브젝트의 레코드 변경 사항에 대한 알림을 발송하도록 CloudEvent를 구성할 수 있습니다. 반면 Camel 10.0.0.1 구성 요소는 이러한 알림에 반응하여 이러한 변경 사항을 외부 시스템에 동기화 할 수 있습니다.

관심 알림은 서브스크립션 채널을 통해 Camel 경로의 from("salesforce:XXX") 절에 지정할 수 있습니다. 예를 들면 다음과 같습니다.

from("salesforce:data/ChangeEvents?replayId=-1").log("being notified of all change events")
from("salesforce:data/AccountChangeEvent?replayId=-1").log("being notified of change events for Account records")
from("salesforce:data/Employee__ChangeEvent?replayId=-1").log("being notified of change events for Employee__c custom object")

수신된 메시지에는 각각 false 또는 truerawPayload 에 따라 본문에 java.util.Map<String,Object > 또는 org.cometd.bayeux.Message 가 포함되어 있습니다. CamelSalesforceChangeType 헤더는 CREATE,UPDATE,DELETE 또는 UNDELETE 중 하나로 평가할 수 있었습니다.

Camel 10.0.0.1 구성 요소 변경 데이터 캡처 기능을 사용하는 방법에 대한 자세한 내용은 ChangeEventsConsumer dotnetTest 에서 확인할 수 있습니다.

CloudEvent 개발자 안내서 는 변경 데이터 캡처 통합 애플리케이션을 구현하는 데 있어 미묘한 내용을 더 잘 알기에 적합합니다. 변경 이벤트 본문 필드의 동적 특성, 높은 수준의 복제 단계 및 보안 고려 사항은 관심을 가질 수 있습니다.

43.8. 예

43.8.1. ContentWorkspace에 문서 업로드

Processor 인스턴스를 사용하여 Java에서 ContentVersion을 생성합니다.

public class ContentProcessor implements Processor {
    public void process(Exchange exchange) throws Exception {
        Message message = exchange.getIn();

        ContentVersion cv = new ContentVersion();
        ContentWorkspace cw = getWorkspace(exchange);
        cv.setFirstPublishLocationId(cw.getId());
        cv.setTitle("test document");
        cv.setPathOnClient("test_doc.html");
        byte[] document = message.getBody(byte[].class);
        ObjectMapper mapper = new ObjectMapper();
        String enc = mapper.convertValue(document, String.class);
        cv.setVersionDataUrl(enc);
        message.setBody(cv);
    }

    protected ContentWorkspace getWorkSpace(Exchange exchange) {
        // Look up the content workspace somehow, maybe use enrich() to add it to a
        // header that can be extracted here
        ----
    }
}

프로세서에서 10.0.0.1 구성 요소로의 출력을 제공합니다.

from("file:///home/camel/library")
    .to(new ContentProcessor())     // convert bytes from the file into a ContentVersion SObject
                                    // for the salesforce component
    .to("salesforce:createSObject");

43.9. CloudEvent 제한 API 사용

salesforce:limits 작업을 사용하면 CloudEvent에서 API 제한을 가져온 다음 해당 데이터를 처리할 수 있습니다. salesforce:limits 작업의 결과는 org.apache.camel.component.salesforce.api.dto.Limits 클래스에 매핑되며 사용자 지정 프로세서 또는 표현식에서 사용할 수 있습니다.

예를 들어, 다른 경로에 대해 일별 API 요청의 10%가 남아 있도록 CloudEvent의 API 사용을 제한해야 한다고 가정합니다. 출력 메시지 본문에는 쿼리 수행 시기를 선택할 수 있는 org.apache.camel.component.salesforce.api.dto.Limits 오브젝트의 인스턴스가 콘텐츠 기반 라우터 및 콘텐츠 기반 라우터 및 SpEL(Content Based Router and Spring Expression Language) 과 함께 사용할 수 있습니다.

1.0body.dailyApiRequests.remaining 에 보유하고 있는 정수 값으로 곱하는 방식은 표현식을 부동 소수점 연산과 함께 만드는 것입니다. 0 (사용되는 일부 API 제한) 또는 1 (사용된 API 제한 없음)으로 인한 통합적인 분할은 결국 불가능합니다.

from("direct:querySalesforce")
    .to("salesforce:limits")
    .choice()
    .when(spel("#{1.0 * body.dailyApiRequests.remaining / body.dailyApiRequests.max < 0.1}"))
        .to("salesforce:query?...")
    .otherwise()
        .setBody(constant("Used up Salesforce API limits, leaving 10% for critical routes"))
    .endChoice()

43.10. 승인 작업

모든 속성의 이름은 10.0.0.1 REST API 앞에 있는 승인이 붙은 것과 정확히 동일하게 지정됩니다. Endpoint의 approval.PropertyName 을 설정하여 승인 속성을 설정할 수 있습니다. 이러한 값은 본문 또는 헤더에 없는 모든 속성이 Endpoint 구성에서 가져온 templatetutorial-kubeletmeaning으로 사용됩니다. 또는 레지스트리의 빈에 대한 참조에 승인 속성을 할당하여 끝점에서 승인 템플릿을 설정할 수 있습니다.

수신 메시지 헤더에 동일한 approval.PropertyName 을 사용하여 헤더 값을 제공할 수도 있습니다.

마지막으로 본문은 일괄 처리로 처리할 하나의 AprovalRequest 또는 ApprovalRequest 오브젝트를 포함할 있습니다.

알아야 할 중요한 사항은 다음 세 가지 메커니즘에 지정된 값의 우선 순위입니다.

  1. 본문의 값이 다른 값보다 우선합니다.
  2. 템플릿 값보다 먼저 메시지 헤더의 값이 우선합니다.
  3. 헤더 또는 본문에 다른 값이 지정되지 않은 경우 template의 값이 설정됩니다.

예를 들어 헤더의 값을 사용하여 승인을 위해 하나의 레코드를 보내려면 다음을 사용합니다.

경로가 지정된 경우:

from("direct:example1")//
        .setHeader("approval.ContextId", simple("${body['contextId']}"))
        .setHeader("approval.NextApproverIds", simple("${body['nextApproverIds']}"))
        .to("salesforce:approval?"//
            + "approval.actionType=Submit"//
            + "&approval.comments=this is a test"//
            + "&approval.processDefinitionNameOrId=Test_Account_Process"//
            + "&approval.skipEntryCriteria=true");

다음을 사용하여 승인을 위해 레코드를 보낼 수 있습니다.

final Map<String, String> body = new HashMap<>();
body.put("contextId", accountIds.iterator().next());
body.put("nextApproverIds", userId);

final ApprovalResult result = template.requestBody("direct:example1", body, ApprovalResult.class);

43.11. Chrony Recent Items API 사용

최근 항목을 가져오려면 salesforce:recent 작업을 사용합니다. 이 작업은 org.apache.camel.component.salesforce.api.dto.RecentItem 개체(List<RecentItem> )의 java.util.List 를 반환하고, 그 결과 Id,NameAttributes ( 유형URL 속성 포함)가 포함됩니다. 반환할 최대 레코드 수로 설정된 limit 매개변수를 지정하여 반환된 항목의 수를 제한할 수 있습니다. 예를 들면 다음과 같습니다.

from("direct:fetchRecentItems")
    to("salesforce:recent")
        .split().body()
            .log("${body.name} at ${body.attributes.url}");

43.12. CloudEvent Composite API를 사용하여 SObject 트리 제출

부모-하위 관계를 포함하여 최대 200개의 레코드를 생성하려면 salesforce:composite-tree 작업을 사용합니다. 이렇게 하려면 입력 메시지에 org.apache.camel.component.salesforce.api.dto.composite.SObjectTree 의 인스턴스가 필요하며 출력 메시지에 동일한 오브젝트 트리를 반환합니다. 트리 내의 org.apache.camel.component.salesforce.api.dto.AbstractSObjectBase 인스턴스가 ID 값 (Id 속성) 또는 해당 org.apache.camel.component.api.salesforce.composite.SObjectNode 는 실패 오류로 채워집니다.

일부 레코드 작업의 경우 성공할 수 있으며 일부의 경우 수동으로 오류를 확인해야 합니다.

이 기능을 사용하는 가장 쉬운 방법은 camel-salesforce-maven-plugin 에서 생성된 DTO를 사용하는 것입니다만, 트리의 각 오브젝트를 식별하는 참조(예: 데이터베이스의 기본 키)를 사용자 정의하는 옵션도 있습니다.

예를 살펴보겠습니다.

Account account = ...
Contact president = ...
Contact marketing = ...

Account anotherAccount = ...
Contact sales = ...
Asset someAsset = ...

// build the tree
SObjectTree request = new SObjectTree();
request.addObject(account).addChildren(president, marketing);
request.addObject(anotherAccount).addChild(sales).addChild(someAsset);

final SObjectTree response = template.requestBody("salesforce:composite-tree", tree, SObjectTree.class);
final Map<Boolean, List<SObjectNode>> result = response.allNodes()
                                                   .collect(Collectors.groupingBy(SObjectNode::hasErrors));

final List<SObjectNode> withErrors = result.get(true);
final List<SObjectNode> succeeded = result.get(false);

final String firstId = succeeded.get(0).getId();

43.13. CloudEvent Composite API를 사용하여 일괄 처리로 여러 요청 제출

Composite API 배치 작업(composite-batch)을 사용하면 여러 요청을 일괄 처리로 누적한 다음 한 번에 제출하여 여러 개별 요청의 왕복 비용을 절감할 수 있습니다. 그런 다음 각 응답은 보존된 순서가 있는 응답 목록으로 수신되므로 n번째 요청 응답이 응답의 n번째 위치에 있습니다.

참고

결과는 API마다 다를 수 있으므로 요청 결과가 java.lang.Object 로 제공됩니다. 대부분의 경우 결과는 문자열 키와 값이 있는 java.util.Map 이거나 값으로 기타 java.util.Map 입니다. 요청은 JSON 형식으로 이루어지며 일부 유형 정보(예: 문자열 값 및 숫자 값)를 보유합니다.

예를 살펴보겠습니다.

final String acountId = ...
final SObjectBatch batch = new SObjectBatch("38.0");

final Account updates = new Account();
updates.setName("NewName");
batch.addUpdate("Account", accountId, updates);

final Account newAccount = new Account();
newAccount.setName("Account created from Composite batch API");
batch.addCreate(newAccount);

batch.addGet("Account", accountId, "Name", "BillingPostalCode");

batch.addDelete("Account", accountId);

final SObjectBatchResponse response = template.requestBody("salesforce:composite-batch", batch, SObjectBatchResponse.class);

boolean hasErrors = response.hasErrors(); // if any of the requests has resulted in either 4xx or 5xx HTTP status
final List<SObjectBatchResult> results = response.getResults(); // results of three operations sent in batch

final SObjectBatchResult updateResult = results.get(0); // update result
final int updateStatus = updateResult.getStatusCode(); // probably 204
final Object updateResultData = updateResult.getResult(); // probably null

final SObjectBatchResult createResult = results.get(1); // create result
@SuppressWarnings("unchecked")
final Map<String, Object> createData = (Map<String, Object>) createResult.getResult();
final String newAccountId = createData.get("id"); // id of the new account, this is for JSON, for XML it would be createData.get("Result").get("id")

final SObjectBatchResult retrieveResult = results.get(2); // retrieve result
@SuppressWarnings("unchecked")
final Map<String, Object> retrieveData = (Map<String, Object>) retrieveResult.getResult();
final String accountName = retrieveData.get("Name"); // Name of the retrieved account, this is for JSON, for XML it would be createData.get("Account").get("Name")
final String accountBillingPostalCode = retrieveData.get("BillingPostalCode"); // Name of the retrieved account, this is for JSON, for XML it would be createData.get("Account").get("BillingPostalCode")

final SObjectBatchResult deleteResult = results.get(3); // delete result
final int updateStatus = deleteResult.getStatusCode(); // probably 204
final Object updateResultData = deleteResult.getResult(); // probably null

43.14. CloudEvent Composite API를 사용하여 여러 체인 요청 제출

복합 작업을 사용하면 이전 요청에서 생성된 인스턴스 식별자에 대해 함께 연결할 수 있는 최대 25개의 요청을 제출할 수 있습니다. 개별 요청 및 응답은 제공된 참조 와 연결되어 있습니다.

참고

복합 API는 JSON 페이로드만 지원합니다.

참고

일괄 API와 마찬가지로 결과는 API마다 다를 수 있으므로 요청 결과가 java.lang.Object 로 제공됩니다. 대부분의 경우 결과는 문자열 키와 값이 있는 java.util.Map 이거나 값으로 기타 java.util.Map 입니다. JSON 형식으로 요청은 일부 유형 정보(예: 문자열 및 숫자 값인지 여부)를 보유합니다.

예를 살펴보겠습니다.

SObjectComposite composite = new SObjectComposite("38.0", true);

// first insert operation via an external id
final Account updateAccount = new TestAccount();
updateAccount.setName("Salesforce");
updateAccount.setBillingStreet("Landmark @ 1 Market Street");
updateAccount.setBillingCity("San Francisco");
updateAccount.setBillingState("California");
updateAccount.setIndustry(Account_IndustryEnum.TECHNOLOGY);
composite.addUpdate("Account", "001xx000003DIpcAAG", updateAccount, "UpdatedAccount");

final Contact newContact = new TestContact();
newContact.setLastName("John Doe");
newContact.setPhone("1234567890");
composite.addCreate(newContact, "NewContact");

final AccountContactJunction__c junction = new AccountContactJunction__c();
junction.setAccount__c("001xx000003DIpcAAG");
junction.setContactId__c("@{NewContact.id}");
composite.addCreate(junction, "JunctionRecord");

final SObjectCompositeResponse response = template.requestBody("salesforce:composite", composite, SObjectCompositeResponse.class);
final List<SObjectCompositeResult> results = response.getCompositeResponse();

final SObjectCompositeResult accountUpdateResult = results.stream().filter(r -> "UpdatedAccount".equals(r.getReferenceId())).findFirst().get()
final int statusCode = accountUpdateResult.getHttpStatusCode(); // should be 200
final Map<String, ?> accountUpdateBody = accountUpdateResult.getBody();

final SObjectCompositeResult contactCreationResult = results.stream().filter(r -> "JunctionRecord".equals(r.getReferenceId())).findFirst().get()

43.15. "raw"octavia composite 사용

rawPayload 옵션을 사용하여 경로에서 CloudEvent JSON 요청을 준비하여 CloudEvent composite을 직접 호출할 수 있습니다.

예를 들어 다음과 같은 경로가 있을 수 있습니다.

from("timer:fire?period=2000").setBody(constant("{\n" +
     " \"allOrNone\" : true,\n" +
     " \"records\" : [ { \n" +
     "   \"attributes\" : {\"type\" : \"FOO\"},\n" +
     "   \"Name\" : \"123456789\",\n" +
     "   \"FOO\" : \"XXXX\",\n" +
     "   \"ACCOUNT\" : 2100.0\n" +
     "   \"ExternalID\" : \"EXTERNAL\"\n"
     " }]\n" +
     "}")
   .to("salesforce:composite?rawPayload=true")
   .log("${body}");

경로는 JSON으로 본문을 직접 생성하고 rawPayload=true 옵션을 사용하여 salesforce 끝점에 직접 제출합니다.

이 방법을 사용하면 10.0.0.1 요청을 완전히 제어할 수 있습니다.

POST 는 Salesforce에 원시 Composite 요청을 보내는 데 사용되는 기본 HTTP 메서드입니다. compositeMethod 옵션을 사용하여 다른 지원되는 값인 GET 으로 재정의하여 사용 가능한 다른 복합 리소스 목록을 반환합니다.

43.16. 원시 작업 사용

호출의 모든 측면을 완전히 원시 제어하여 salesforce에 HTTP 요청을 보냅니다. 요청 및 응답 본문의 직렬화 또는 역직렬화는 경로에서 수행해야 합니다. Content-Type HTTP 헤더는 format 옵션에 따라 자동으로 설정되지만 rawHttpHeaders 옵션을 사용하여 재정의할 수 있습니다.

매개변수유형설명Default필수 항목

요청 본문

문자열 또는 InputStream

HTTP 요청 본문

  

rawPath

문자열

도메인 이름 뒤에 있는 끝점 URL의 부분(예: '/services/data/v51.0/sobjects/Account/')

 

x

rawMethod

문자열

HTTP 메서드

 

x

rawQueryParameters

문자열

쿼리 매개변수로 포함할 메시지 헤더의 쉼표로 구분된 목록입니다. 이 작업이 자동으로 수행되므로 URL 인코딩 값을 지정하지 마십시오.

  

rawHttpHeaders

문자열

HTTP 헤더로 포함할 메시지 헤더의 쉼표로 구분된 목록

  

43.16.1. 쿼리 예

이 예제에서는 REST API에 쿼리를 보냅니다. 쿼리는 "q"라는 URL 매개 변수로 전달되어야 하므로 q라는 메시지 헤더를 생성하고 해당 메시지 헤더를 URL 매개변수로 포함하도록 원시 작업에 지시합니다.

from("direct:queryExample")
  .setHeader("q", "SELECT Id, LastName FROM Contact")
  .to("salesforce:raw?format=JSON&rawMethod=GET&rawQueryParameters=q&rawPath=/services/data/v51.0/query")
  // deserialize JSON results or handle in some other way

43.16.2. SObject 예

이 예제에서는 생성 작업에서 REST API 연락처를 전달합니다. 원시 작업이 직렬화를 수행하지 않으므로 메시지 본문에서 XML을 전달해야 합니다.

from("direct:createAContact")
  .setBody(constant("<Contact><LastName>TestLast</LastName></Contact>"))
  .to("salesforce:raw?format=XML&rawMethod=POST&rawPath=/services/data/v51.0/sobjects/Contact")

응답은 다음과 같습니다.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result>
    <id>0034x00000RnV6zAAF</id>
    <success>true</success>
</Result>

43.17. Composite SObject Collections 사용

SObject Collections API는 하나의 요청에서 여러 레코드에서 작업을 실행합니다. sObject Collections를 사용하여 클라이언트와 서버 간의 왕복 수를 줄입니다. 전체 요청은 API 제한에 대한 단일 호출로 계산됩니다. 이 리소스는 API 버전 42.0 이상에서 사용할 수 있습니다. 이러한 작업에 제공된 SObject 레코드(DTO)는 AbstractDescribedSObjectBase 의 하위 클래스 인스턴스여야 합니다. 이러한 DTO 클래스 생성에 대한 자세한 내용은 Maven 플러그인 섹션을 참조하십시오. 이러한 작업은 직렬화에서 DTO를 JSON에 제공했습니다.

43.17.1. compositeRetrieveSObjectCollections

동일한 오브젝트 유형의 레코드를 하나 이상 검색합니다.

매개변수유형설명Default필수 항목

ID

문자열 또는 쉼표로 구분된 문자열 목록

반환할 오브젝트의 하나 이상의 ID 목록입니다. 모든 ID는 동일한 오브젝트 유형에 속해야 합니다.

 

x

필드

문자열 또는 쉼표로 구분된 문자열 목록

응답에 포함할 필드 목록입니다. 지정한 필드 이름이 유효해야 하며 각 필드에 대한 읽기 수준 권한이 있어야 합니다.

 

x

sObjectName

문자열

SObject 유형(예: Account)

 

x

sObjectClass

문자열

응답을 역직렬화하는 데 사용할 DTO 클래스의 정규화된 클래스 이름입니다.

 

sObjectName 매개변수가 패키지 옵션에 지정된 패키지에 존재하는 클래스를 확인하지 않는 경우 필수입니다.

43.17.2. compositeCreateSObjectCollections

최대 200개의 레코드를 추가하고 SaveSObjectResult 오브젝트 목록을 반환합니다. 혼합 SObject 유형이 지원됩니다.

매개변수유형설명Default필수 항목

요청 본문

SObject목록

생성할 SObject 목록

 

x

allOrNone

boolean

오브젝트 생성이 실패할 때 전체 요청을 롤백할지(true) 요청에서 다른 오브젝트를 독립적으로 생성할지 여부를 나타냅니다.

false

 

43.17.3. compositeUpdateSObjectCollections

최대 200개의 레코드를 업데이트하여 SaveSObjectResult 오브젝트 목록을 반환합니다. 혼합 SObject 유형이 지원됩니다.

매개변수유형설명Default필수 항목

요청 본문

SObject목록

업데이트할 SObject 목록

 

x

allOrNone

boolean

오브젝트 업데이트가 실패할 때 전체 요청을 롤백할지(true) 요청에서 다른 오브젝트의 독립적인 업데이트를 계속할지 여부를 나타냅니다.

false

 

43.17.4. compositeUpsertSObjectCollections

외부 ID 필드를 기반으로 최대 200개의 레코드를 생성하거나 업데이트하여 UpsertSObjectResult 오브젝트 목록을 반환합니다. 혼합 SObject 유형은 지원되지 않습니다.

매개변수유형설명Default필수 항목

요청 본문

SObject목록

upsert 까지의 SObject 목록

 

x

allOrNone

boolean

개체의 upsert가 실패할 때 전체 요청을 롤백할지(true) 요청에서 다른 오브젝트의 독립 upsert를 계속할지 여부를 나타냅니다.

false

 

sObjectName

문자열

SObject 유형(예: Account)

 

x

sObjectIdName

문자열

외부 ID 필드의 이름

 

x

43.17.5. compositeDeleteSObjectCollections

최대 200개의 레코드를 삭제하여 DeleteSObjectResult 오브젝트 목록을 반환합니다. 혼합 SObject 유형이 지원됩니다.

매개변수유형설명Default필수 항목

sObjectIds 또는 요청 본문

문자열 또는 쉼표로 구분된 문자열 목록

삭제할 오브젝트 ID 최대 200개의 ID 목록입니다.

 

x

allOrNone

boolean

오브젝트 삭제가 실패할 때 전체 요청을 롤백할지(true) 요청에서 다른 오브젝트의 독립적인 삭제 여부를 나타냅니다.

false

 

43.18. salesforce에 null 값 전송

기본적으로 값이 null인 SObject 필드는 salesforce로 전송되지 않습니다. salesforce에 null 값을 보내려면 다음과 같이 fieldToNull 속성을 사용합니다.

accountSObject.getFieldsToNull().add("Site");

43.19. SOQL 쿼리 문자열 생성

org.apache.camel.component.salesforce.api.utils.QueryECDHEer 에는 SOQL 쿼리를 생성하는 도우미 방법이 포함되어 있습니다. 예를 들어 계정 SObject에서 모든 사용자 지정 필드를 가져오려면 다음을 호출하여 SOQL Select를 생성할 수 있습니다.

String allCustomFieldsQuery = QueryHelper.queryToFetchFilteredFieldsOf(new Account(), SObjectField::isCustom);

43.20. Camel Salesforce Maven Plugin

이 Maven 플러그인은 Camel에 대한 DTO를 생성합니다.

보안상의 이유로 clientId, clientSecret, userName 및 password 필드를 pom.xml에 설정하지 않는 것이 좋습니다. 플러그인은 나머지 속성에 맞게 구성해야 하며 다음 명령을 사용하여 실행할 수 있습니다.

mvn camel-salesforce:generate -DcamelSalesforce.clientId=<clientid> -DcamelSalesforce.clientSecret=<clientsecret> \
    -DcamelSalesforce.userName=<username> -DcamelSalesforce.password=<password>

생성된 DTO는 Jackson 주석을 사용합니다. 모든 CloudEvent 필드 유형이 지원됩니다. 날짜 및 시간 필드는 기본적으로 java.time.ZonedDateTime 에 매핑되며 picklist 필드는 생성된 Java Enumerations에 매핑됩니다.

DTO를 생성하는 방법에 대한 자세한 내용은 README.md 를 참조하십시오.

43.21. Spring Boot Auto-Configuration

Spring Boot와 함께 salesforce를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-salesforce-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.salesforce.all-or-none

성공하지 못한 경우 모든 레코드를 롤백하도록 지시하는 복합 API 옵션.

false

부울

camel.component.salesforce.apex-method

APEX 방법 이름입니다.

 

문자열

camel.component.salesforce.apex-query-params

APEX 방법에 대한 쿼리 매개변수입니다.

 

map

camel.component.salesforce.apex-url

APEX 방법 URL.

 

문자열

camel.component.salesforce.api-version

CloudEvent API 버전.

53.0

문자열

camel.component.salesforce.authentication-type

사용할 명시적 인증 방법, USERNAME_PASSWORD, REFRESH_TOKEN 또는 JWT 중 하나입니다. CloudEvent 구성 요소는 속성 세트에서 사용할 인증 방법을 자동으로 확인하고 모호성을 제거하도록 이 속성을 설정할 수 있습니다.

 

AuthenticationType

camel.component.salesforce.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.salesforce.backoff-increment

CometD auto-reconnect 이외의 실패에 대한 Streaming 연결 재시작 시도에 대한 백오프 간격 증가 옵션은 긴 유형입니다.

1000

long

camel.component.salesforce.batch-id

일괄 API 배치 ID입니다.

 

문자열

camel.component.salesforce.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.salesforce.client-id

postgresql 인스턴스 설정에 구성된 연결된 앱의 OAuth 소비자 키입니다. 일반적으로 연결된 앱을 구성해야 하지만 패키지를 설치하여 제공할 수 있습니다.

 

문자열

camel.component.salesforce.client-secret

CloudEvent 인스턴스 설정에 구성된 연결된 앱의 OAuth 소비자 시크릿입니다.

 

문자열

camel.component.salesforce.composite-method

복합(raw) 방법.

 

문자열

camel.component.salesforce.config

글로벌 끝점 구성 - 모든 끝점에 공통된 값을 설정하는 데 사용합니다. 옵션은 org.apache.camel.component.salesforce.SalesforceEndpointConfig 유형입니다.

 

SalesforceEndpointConfig

camel.component.salesforce.content-type

일괄 API 콘텐츠 유형, XML, CSV, ZIP_XML, ZIP_CSV.

 

ContentType

camel.component.salesforce.default-replay-id

initialReplayIdMap에 값이 없는 경우 기본 replayId 설정입니다.

-1

long

camel.component.salesforce.enabled

salesforce 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.salesforce.fall-back-replay-id

잘못된 Replay Id 응답 후 돌아가려면 ReplayId입니다.

-1

long

camel.component.salesforce.format

JSON 또는 XML 중 하나인 gRPC API 호출에 사용하는 페이로드 형식은 기본적으로 JSON입니다. Camel 3.12부터 이 옵션은 Raw 작업에만 적용됩니다.

 

PayloadFormat

camel.component.salesforce.http-client

export에 연결하는 데 사용할 사용자 정의anchor Client입니다. 옵션은 org.apache.camel.component.salesforce.SalesforceHttpClient 유형입니다.

 

SalesforceHttpClient

camel.component.salesforce.http-client-connection-timeout

10.0.0.1 서버에 연결할 때 10.0.0.1Client에서 사용하는 연결 시간 초과입니다.

60000

long

camel.component.salesforce.http-client-idle-timeout

10.0.0.1 서버의 응답을 대기할 때 10.0.0.1Client에서 사용하는 시간 초과입니다.

10000

long

camel.component.salesforce.http-client-properties

기본 HTTP 클라이언트에서 구성할 수 있는 모든 속성을 설정하는 데 사용됩니다. 사용 가능한 모든 옵션에 대해 10.0.0.1HttpClient의 속성과>-<ty>-<Client의 속성을 살펴보십시오.

 

map

camel.component.salesforce.http-max-content-length

HTTP 응답의 최대 콘텐츠 길이입니다.

 

정수

camel.component.salesforce.http-proxy-auth-uri

HTTP 프록시 서버에 대한 인증에 사용되는 httpProxyUsername 및 httpProxyPassword를 인증에 사용하려면 프록시 서버의 URI와 일치해야 합니다.

 

문자열

camel.component.salesforce.http-proxy-excluded-addresses

HTTP 프록시 서버를 사용하지 않아야 하는 주소 목록입니다.

 

Set

camel.component.salesforce.http-proxy-host

사용할 HTTP 프록시 서버의 호스트 이름입니다.

 

문자열

camel.component.salesforce.http-proxy-included-addresses

HTTP 프록시 서버를 사용해야 하는 주소 목록입니다.

 

Set

camel.component.salesforce.http-proxy-password

HTTP 프록시 서버에 인증하는 데 사용할 암호입니다.

 

문자열

camel.component.salesforce.http-proxy-port

사용할 HTTP 프록시 서버의 포트 번호입니다.

 

정수

camel.component.salesforce.http-proxy-realm

HTTP 프록시 서버에 대한 선점 기본/Digest 인증 방법에 사용되는 프록시 서버의 영역입니다.

 

문자열

camel.component.salesforce.http-proxy-secure

false로 설정하면 HTTP 프록시에 액세스할 때 TLS 사용을 비활성화합니다.

true

부울

camel.component.salesforce.http-proxy-socks4

true로 설정하는 경우 는 10.0.0.1KS4 프록시로 사용하도록 HTTP 프록시를 구성합니다.

false

부울

camel.component.salesforce.http-proxy-use-digest-auth

HTTP 프록시로 인증할 때 true 다이제스트 인증으로 설정된 경우, 그렇지 않으면 기본 권한 부여 방법이 사용됩니다.

false

부울

camel.component.salesforce.http-proxy-username

HTTP 프록시 서버에 인증하는 데 사용할 사용자 이름입니다.

 

문자열

camel.component.salesforce.http-request-buffer-size

HTTP 요청 버퍼 크기. 대규모 SOQL 쿼리를 위해서는 늘려야 할 수도 있습니다.

8192

정수

camel.component.salesforce.include-details

10.0.0.11 분석 보고서에 세부 정보를 포함하면 기본값은 false입니다.

 

부울

camel.component.salesforce.initial-replay-id-map

채널 이름별로 시작하는 ID를 재생합니다.

 

map

camel.component.salesforce.instance-id

CloudEvent1 분석에서는 실행 인스턴스 ID를 보고합니다.

 

문자열

camel.component.salesforce.instance-url

인증 후 사용되는 Sales 인스턴스의 URL입니다. 기본적으로 인증이 완료되면 CloudEvent에서 수신됩니다.

 

문자열

camel.component.salesforce.job-id

대규모 API 작업 ID.

 

문자열

camel.component.salesforce.jwt-audience

OAuth JWT 흐름을 사용할 때 CloudEvent 클레임(aud)에 사용할 값입니다. 설정되지 않은 경우 로그인 URL이 사용되며 대부분의 경우 적절합니다.

 

문자열

camel.component.salesforce.keystore

OAuth JWT 흐름에서 사용할 키 저장소 매개변수입니다. KeyStore에는 개인 키 및 인증서가 있는 항목이 하나만 포함되어야 합니다. CloudEvent는 인증서 체인을 확인하지 않으므로 자체 서명된 인증서가 쉽게 될 수 있습니다. 연결된 앱에 인증서를 업로드했는지 확인합니다. 옵션은 org.apache.camel.support.jsse.KeyStoreParameters 유형입니다.

 

KeyStoreParameters

camel.component.salesforce.lazy-login

true로 설정하면 구성 요소가 구성 요소가 시작된 상태로 10.0.0.1으로 인증되지 않습니다. 일반적으로 이 값을 (기본값) false로 설정하고 초기에 인증하고 모든 인증 문제를 즉시 인식합니다.

false

부울

camel.component.salesforce.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.salesforce.limit

반환된 레코드 수를 제한합니다. 일부 API에 적용 가능한 경우 CloudEvent 설명서를 확인하십시오.

 

정수

camel.component.salesforce.locator

Query 작업에 대한 결과를 가져오는 데 사용할 수 있도록 salesforce Bulk 2.0 API에서 제공하는 locator입니다.

 

문자열

camel.component.salesforce.login-config

하나의 중첩된 빈에 있는 모든 인증 구성, 구성 요소에 직접 설정된 모든 속성은 구성 요소에 직접 설정할 수 있습니다. 옵션은 org.apache.camel.component.salesforce.SalesforceLoginConfig 유형입니다.

 

SalesforceLoginConfig

camel.component.salesforce.login-url

인증에 사용되는 gRPC 인스턴스의 URL입니다. 기본적으로 로 설정됩니다.

 

문자열

camel.component.salesforce.long-polling-transport-properties

streaming API에서 사용하는 TaluxClient(CometD)에서 사용하는 LongPollingTransport에서 구성할 수 있는 모든 속성을 설정하는 데 사용됩니다.

 

map

camel.component.salesforce.max-backoff

CometD auto-reconnect 이외의 실패 시도에 대한 스트리밍 연결 재시작 시도의 최대 백오프 간격입니다. 옵션은 긴 유형입니다.

30000

long

camel.component.salesforce.max-records

Bulk 2.0 쿼리에 대한 결과 집합별로 검색할 최대 레코드 수입니다. 요청에 따라 크기가 제한됩니다. 매우 많은 수의 쿼리 결과로 작업 중인 경우 CloudEvent에서 모든 데이터를 수신하기 전에 시간 초과가 발생할 수 있습니다. 시간 초과를 방지하려면 클라이언트가 maxRecords 매개변수에서 수신할 최대 레코드 수를 지정합니다. 이렇게 하면 결과를 최대 크기로 사용하여 결과를 더 작은 세트로 분할합니다.

 

정수

camel.component.salesforce.not-found-behaviour

10.0.0.1 API에서 수신한 404 not found status의 동작을 설정합니다. 본문이 NULL NotFoundBehaviour#NULL로 설정되어야 하는 경우 또는 예외가 알림 NotFoundBehaviour#EXCEPTION - 기본값입니다.

 

NotFoundBehaviour

camel.component.salesforce.notify-for-fields

필드, 옵션에 대한 알림은 ALL, REFERENCED, Select,>-<, 10.0.0.1입니다.

 

NotifyForFieldsEnum

camel.component.salesforce.notify-for-operation-create

생성 작업에 대한 알림, 기본값은 false(API 버전 = 29.0)입니다.

 

부울

camel.component.salesforce.notify-for-operation-delete

삭제 작업에 대한 알림, 기본값은 false(API 버전 = 29.0)입니다.

 

부울

camel.component.salesforce.notify-for-operation-undelete

삭제 해제 작업을 요청하고 기본값은 false(API 버전 = 29.0)입니다.

 

부울

camel.component.salesforce.notify-for-operation-update

업데이트 작업에 대한 알림, 기본값은 false(API 버전 = 29.0)입니다.

 

부울

camel.component.salesforce.notify-for-operations

알림 작업, 옵션은 ALL, CREATE, EXTENDED, UPDATE(API 버전 29.0)입니다.

 

NotifyForOperationsEnum

camel.component.salesforce.object-mapper

Custom Jackson ObjectMapper는 CloudEvent 오브젝트를 직렬화/deserializing할 때 사용할 수 있습니다. 옵션은 com.fasterxml.jackson.databind.ObjectMapper 유형입니다.

 

ObjectMapper

camel.component.salesforce.packages

생성된 DTO 클래스는 어떤 패키지가 있습니까. 일반적으로 클래스는 camel-salesforce-maven-plugin을 사용하여 생성됩니다. 생성된 DTO를 사용하여 parameters/header 값에 짧은 SObject 이름을 사용할 수 있는 이점을 얻는 경우 이를 설정합니다. 여러 패키지를 쉼표로 구분할 수 있습니다.

 

문자열

camel.component.salesforce.password

토큰에 액세스하기 위해 OAuth 흐름에 사용하는 암호입니다. 암호 OAuth 흐름을 쉽게 시작할 수 있지만 일반적으로 다른 흐름보다 안전하지 않은 것으로 간주되므로 일반적으로 사용하지 않아야 합니다. 암호를 사용하는 경우 보안 토큰을 암호 끝에 추가해야 합니다.

 

문자열

camel.component.salesforce.pk-chunking

PK Chunking을 사용하십시오. 원래 Bulk API에서만 사용됩니다. 대량 2.0 API는 필요한 경우 PK 청크를 자동으로 수행합니다.

 

부울

camel.component.salesforce.pk-chunking-chunk-size

PK 청크와 함께 사용할 청크 크기입니다. 지정되지 않은 경우 Salesforce 기본값은 10,000입니다. 최대 크기는 250,000입니다.

 

정수

camel.component.salesforce.pk-chunking-parent

개체 공유에 대한 쿼리를 PK 청크를 활성화할 때 상위 오브젝트를 지정합니다. 청크는 공유 오브젝트의 레코드가 아닌 상위 오브젝트의 레코드를 기반으로 합니다. 예를 들어 AccountShare를 쿼리할 때 Account를 상위 오브젝트로 지정합니다. 상위 오브젝트가 지원되는 경우 PK 청크가 오브젝트 공유용으로 지원됩니다.

 

문자열

camel.component.salesforce.pk-chunking-start-row

첫 번째 청크의 하위 경계로 사용할 15자 또는 18자 레코드 ID를 지정합니다. 이 매개변수를 사용하여 배치 간에 실패한 작업을 다시 시작할 때 시작 ID를 지정합니다.

 

문자열

camel.component.salesforce.query-locator

쿼리 결과 단일 호출에서 검색할 수 있는 것보다 더 많은 레코드를 생성할 때 사용하기 위해 salesforce에서 제공하는 쿼리 로케이터입니다. 후속 호출에서 이 값을 사용하여 추가 레코드를 검색합니다.

 

문자열

camel.component.salesforce.raw-http-headers

Raw 작업의 HTTP 매개변수로 포함할 메시지 헤더의 쉼표로 구분된 목록입니다.

 

문자열

camel.component.salesforce.raw-method

Raw 작업에 사용할 HTTP 방법입니다.

 

문자열

camel.component.salesforce.raw-path

도메인 이름 뒤에 있는 끝점 URL의 일부입니다. E.g., '/services/data/v52.0/sobjects/Account/'.

 

문자열

camel.component.salesforce.raw-payload

요청 및 응답에 원시 페이로드 문자열(형식에 따라 JSON 또는 XML)을 사용합니다. 기본적으로 DTO는 false입니다.

false

부울

camel.component.salesforce.raw-query-parameters

Raw 작업에 대한 쿼리 매개변수로 포함할 메시지 헤더의 쉼표로 구분된 목록입니다. 이 작업이 자동으로 수행되므로 URL 인코딩 값을 지정하지 마십시오.

 

문자열

camel.component.salesforce.refresh-token

새로 고침 토큰 OAuth 흐름에 토큰 새로 고침이 이미 있습니다. 웹 애플리케이션을 설정하고 새로 고침 토큰을 수신하도록 콜백 URL을 구성하거나 에서 기본 콜백을 사용하여 흐름 끝에 있는 URL에서 refresh_token을 다시 시도해야 합니다. 개발 조직의 10.0.0.1에서는 localhost에서 콜백 웹 애플리케이션을 호스팅할 수 있습니다.

 

문자열

camel.component.salesforce.report-id

CloudEvent1 분석 보고서 Id.

 

문자열

camel.component.salesforce.report-metadata

필터링을 위한 CloudEvent1 분석 메타데이터를 보고합니다. 옵션은 org.apache.camel.component.salesforce.api.dto.analyistic.reports.ReportMetadata 유형입니다.

 

ReportMetadata

camel.component.salesforce.result-id

일괄 API Result ID입니다.

 

문자열

camel.component.salesforce.s-object-blob-field-name

SObject blob 필드 이름입니다.

 

문자열

camel.component.salesforce.s-object-class

일반적으로 camel-salesforce-maven-plugin을 사용하여 생성된 정규화된 SObject 클래스 이름입니다.

 

문자열

camel.component.salesforce.s-object-fields

검색할 SObject 필드입니다.

 

문자열

camel.component.salesforce.s-object-id

API에 필요한 경우 SObject ID입니다.

 

문자열

camel.component.salesforce.s-object-id-name

SObject external ID 필드 이름입니다.

 

문자열

camel.component.salesforce.s-object-id-value

SObject external ID 필드 값.

 

문자열

camel.component.salesforce.s-object-name

API에서 필요하거나 지원하는 경우 SObject 이름입니다.

 

문자열

camel.component.salesforce.s-object-query

CloudEvent SOQL 쿼리 문자열.

 

문자열

camel.component.salesforce.s-object-search

CloudEvent SOSL 검색 문자열

 

문자열

camel.component.salesforce.ssl-context-parameters

사용할 SSL 매개변수는 사용 가능한 모든 옵션에 대한 SSLContextParameters 클래스를 참조하십시오. 옵션은 org.apache.camel.support.jsse.SSLContextParameters 유형입니다.

 

SSLContextParameters

camel.component.salesforce.update-topic

스트리밍 API를 사용할 때 기존 Push Topic을 업데이트할지 여부이며 기본값은 false입니다.

false

부울

camel.component.salesforce.use-global-ssl-context-parameters

글로벌 SSL 컨텍스트 매개변수 사용을 활성화합니다.

false

부울

camel.component.salesforce.user-name

토큰에 액세스하기 위해 OAuth 흐름에 사용하는 사용자 이름입니다. 암호 OAuth 흐름을 쉽게 시작할 수 있지만 일반적으로 다른 흐름보다 안전하지 않은 것으로 간주되므로 일반적으로 사용하지 않아야 합니다.

 

문자열

camel.component.salesforce.worker-pool-max-size

HTTP 응답을 처리하는 데 사용되는 스레드 풀의 최대 크기입니다.

20

정수

camel.component.salesforce.worker-pool-size

HTTP 응답을 처리하는 데 사용되는 스레드 풀의 크기입니다.

10

정수

44장. scheduler

소비자만 지원됩니다.

Scheduler 구성 요소는 스케줄러가 실행될 때 메시지 교환을 생성하는 데 사용됩니다. 이 구성 요소는 Timer 구성 요소와 유사하지만 스케줄링 측면에서 더 많은 기능을 제공합니다. 또한 이 구성 요소는 JDK ScheduledExecutorService 를 사용합니다. 여기서 타이머는 JDK Timer 를 사용합니다.

이 끝점의 이벤트만 사용할 수 있습니다.

44.1. URI 형식

scheduler:name[?options]

여기서 name 은 끝점 간에 생성되고 공유되는 스케줄러의 이름입니다. 따라서 모든 스케줄러 끝점에 동일한 이름을 사용하는 경우 하나의 스케줄러 스레드 풀과 스레드만 사용되지만 더 많은 동시 스레드를 허용하도록 스레드 풀을 구성할 수 있습니다.

참고

생성된 교환의 IN 본문은 null 입니다. So exchange.getIn().getBody() returns null.

44.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

44.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

44.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

44.3. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

PoolSize (scheduler)

스케줄링 스레드 풀에서 사용하는 스레드 풀의 코어 스레드 수입니다. 기본적으로 단일 스레드를 사용합니다.

1

int

44.4. 끝점 옵션

Scheduler 끝점은 URI 구문을 사용하여 구성됩니다.

scheduler:name

다음과 같은 경로 및 쿼리 매개변수 사용:

44.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

이름 (consumer)

스케줄러 이름이 필요합니다.

 

문자열

44.4.2. 쿼리 매개변수(21 매개변수)

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

동기 (고급)

동기 처리를 엄격하게 사용해야 하는지 여부를 설정합니다.

false

boolean

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

PoolSize (scheduler)

스케줄링 스레드 풀에서 사용하는 스레드 풀의 코어 스레드 수입니다. 기본적으로 단일 스레드를 사용합니다.

1

int

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

44.5. 더 알아보기

이 구성 요소는 스케줄러 Polling Consumer 이며 위의 옵션에 대한 자세한 내용과 예시는 Polling Consumer 페이지에서 확인할 수 있습니다.

44.6. 교환 속성

타이머가 실행되면 다음 정보를 교환에 속성으로 추가합니다.

이름유형설명

Exchange.TIMER_NAME

문자열

name 옵션의 값입니다.

Exchange.TIMER_FIRED_TIME

날짜

고객이 퇴사했을 때입니다.

44.7. sample

60초마다 이벤트를 생성하는 경로를 설정하려면 다음을 수행합니다.

from("scheduler://foo?delay=60000").to("bean:myBean?method=someMethodName");

위의 경로는 이벤트를 생성한 다음 JNDI 또는 Spring과 같은 레지스트리의 myBean 이라는 빈에서 someMethodName 메서드를 호출합니다.

Spring DSL의 경로:

<route>
  <from uri="scheduler://foo?delay=60000"/>
  <to uri="bean:myBean?method=someMethodName"/>
</route>

44.8. 완료되면 스케줄러가 즉시 트리거되도록 강제 적용

이전 작업이 완료되면 스케줄러가 트리거되도록 하려면 greedy=true 옵션을 설정할 수 있습니다. 그러나 스케줄러는 항상 실행을 계속할 것입니다. 따라서 이 방법을 신중하게 사용하십시오.

44.9. 스케줄러를 유휴 상태로 전환하도록 강제 적용

스케줄러를 트리거하고 추측할 수 있도록 하려는 사용 사례가 있을 수 있습니다. 그러나 경우에 따라 폴링할 작업이 없는 스케줄러를 "Tell the scheduler"하여 백오프 옵션을 사용하여 스케줄러가 유휴 모드로 변경될 수 있습니다. 이렇게 하려면 키 Exchange.SCHEDULER_POLLED_MESSAGES 를 false 값으로 교환하는 속성을 설정해야 합니다. 이로 인해 소비자가 폴링된 메시지가 없음을 나타냅니다.

그렇지 않으면 소비자가 교환 처리를 완료할 때마다 기본적으로 스케줄러에 폴링된 1 메시지를 반환해야 합니다.

44.10. Spring Boot Auto-Configuration

Spring Boot와 함께 스케줄러를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-scheduler-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.scheduler.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.scheduler.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.scheduler.enabled

스케줄러 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.scheduler.pool-size

스케줄링 스레드 풀에서 사용하는 스레드 풀의 코어 스레드 수입니다. 기본적으로 단일 스레드를 사용합니다.

1

정수

45장. SEDA

생산자 및 소비자 모두 지원

SEDA 구성 요소는 비동기 SEDA 동작을 제공하므로 메시지가 BlockingQueue 에서 교환되고 소비자는 생산자와 별도의 스레드에서 호출됩니다.

대기열은 단일 CamelContext 내에서만 표시됩니다. CamelContext 인스턴스(예: 웹 애플리케이션 간 통신) 간에 통신하려면 구성 요소를 참조하십시오.

이 구성 요소는 메시지를 아직 처리하지 못하는 동안 VM이 종료되는 경우 모든 종류의 지속성 또는 복구를 구현하지 않습니다. 지속성, 신뢰성 또는 분산 SEDA가 필요한 경우 JMS 또는 ActiveMQ를 사용해 보십시오.

참고

동기
직접 구성 요소는 생산자가 메시지 교환을 보낼 때 모든 소비자의 동기 호출을 제공합니다.

45.1. URI 형식

seda:someName[?options]

여기서 someName 은 현재 CamelContext 내에서 엔드포인트를 고유하게 식별하는 문자열일 수 있습니다.

45.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

45.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

45.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

45.3. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

concurrentConsumers (consumer)

기본 동시 스레드 처리 수를 설정합니다.

1

int

defaultPollTimeout (consumer (advanced))

폴링 시 사용되는 타임아웃(밀리초)입니다. 시간 초과가 발생하면 소비자는 계속 실행할 수 있는지 여부를 확인할 수 있습니다. 값을 낮게 설정하면 사용자가 종료 시 더 신속하게 대응할 수 있습니다.

1000

int

defaultBlockIfFull (producer)

메시지를 전체 SEDA 큐로 보내는 스레드는 큐의 용량이 더 이상 소진되지 않을 때까지 차단됩니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 호출 스레드가 대신 차단되고 메시지가 수락될 때까지 기다립니다.

false

boolean

기본Discard IfFull (producer)

메시지를 전체 SEDA 큐로 보내는 스레드가 삭제되는지의 여부입니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 호출 스레드가 전송 및 계속되므로 메시지가 SEDA 큐로 전송되지 않았습니다.

false

boolean

defaultOfferTimeout (producer)

메시지를 전체 SEDA 큐로 보내는 스레드는 큐의 용량이 더 이상 소진되지 않을 때까지 차단됩니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 구성된 시간 초과를 블록 케이스에 추가할 수 있습니다. Java 대기열의 .offer(timeout) 메서드를 사용합니다.

 

long

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

defaultQueueFactory (advanced)

기본 대기열 팩토리를 설정합니다.

 

BlockingQueueFactory

queueSize (advanced)

SEDA 대기열의 기본 최대 용량(즉, 보유할 수 있는 메시지 수)을 설정합니다.

1000

int

45.4. 끝점 옵션

SEDA 끝점은 URI 구문을 사용하여 구성됩니다.

seda:name

다음과 같은 경로 및 쿼리 매개변수 사용:

45.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

이름 (common)

대기열 의 이름입니다.

 

문자열

45.4.2. 쿼리 매개변수(18 매개변수)

이름설명Default유형

크기 (공용)

SEDA 대기열의 최대 용량(즉, 보유할 수 있는 메시지 수) 기본적으로 SEDA 구성 요소에 설정된 defaultSize를 사용합니다.

1000

int

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

concurrentConsumers (consumer)

동시 스레드 처리 교환 수입니다.

1

int

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

limitConcurrentConsumers (consumer (advanced))

concurrentConsumers 수를 최대 500개로 제한할지 여부입니다. 끝점이 더 큰 숫자로 구성된 경우 기본적으로 예외가 발생합니다. 이 옵션을 끄면 해당 검사를 비활성화할 수 있습니다.

true

boolean

multipleConsumers (advanced)

여러 사용자가 허용되는지 여부를 지정합니다. 활성화된 경우 게시-서브스크립션 메시징에 SEDA를 사용할 수 있습니다. 즉, 메시지를 SEDA 큐에 보내고 각 소비자가 메시지 사본을 수신하도록 할 수 있습니다. 이 옵션을 활성화하면 모든 소비자 끝점에 지정해야 합니다.

false

boolean

pollTimeout (consumer(advanced))

폴링 시 사용되는 타임아웃(밀리초)입니다. 시간 초과가 발생하면 소비자는 계속 실행할 수 있는지 여부를 확인할 수 있습니다. 값을 낮게 설정하면 사용자가 종료 시 더 신속하게 대응할 수 있습니다.

1000

int

purgetimeStopping (consumer (advanced))

소비자/라우트를 중지할 때 작업 큐를 제거할지 여부입니다. 이렇게 하면 큐의 보류 중인 메시지가 모두 삭제되므로 더 빨리 중지할 수 있습니다.

false

boolean

blockIfFull (producer)

메시지를 전체 SEDA 큐로 보내는 스레드는 큐의 용량이 더 이상 소진되지 않을 때까지 차단됩니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 호출 스레드가 대신 차단되고 메시지가 수락될 때까지 기다립니다.

false

boolean

discardIfNoConsumers (producer)

생산자가 메시지를 삭제하든(메시지를 큐에 추가하지 않음) 활성 소비자가 없는 큐로 보낼 때입니다. 동시에 discardIfNoConsumers 및 failIfNoConsumers 옵션 중 하나만 활성화할 수 있습니다.

false

boolean

discardtimeFull (producer)

메시지를 전체 SEDA 큐로 보내는 스레드가 삭제되는지의 여부입니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 호출 스레드가 전송 및 계속되므로 메시지가 SEDA 큐로 전송되지 않았습니다.

false

boolean

failIfNoConsumers (producer)

활성 소비자가 없는 큐로 보낼 때 생산자가 예외를 throw하여 실패해야 하는지 여부입니다. 동시에 discardIfNoConsumers 및 failIfNoConsumers 옵션 중 하나만 활성화할 수 있습니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

offerTimeout (producer)

제안 시간 초과(밀리초)는 큐가 가득 찼을 때 블록 케이스에 추가할 수 있습니다. 0 또는 음수 값을 사용하여 타임아웃을 비활성화할 수 있습니다.

 

long

시간 초과 (producer)

SEDA 생산자가 비동기 작업이 완료될 때까지 대기 시간을 중지하기 전의 타임아웃(밀리초)입니다. 0 또는 음수 값을 사용하여 타임아웃을 비활성화할 수 있습니다.

30000

long

waitForTaskToComplete (producer)

호출자가 계속하기 전에 async 작업이 완료될 때까지 기다려야 하는지 여부를 지정하는 옵션입니다. 다음 세 가지 옵션이 지원됩니다. Always, Never 또는 IfReplyExpected. 처음 두 값은 자체 설명입니다. 마지막 값인 IfReplyExpected는 메시지가 Reply 기반 요청인 경우에만 대기합니다. 기본 옵션은 IfReplyExpected입니다.

CloudEvent 값:

  • Never
  • IfReplyExpected
  • Always

IfReplyExpected

WaitForTaskToComplete

대기열 (고급)

끝점에서 사용할 큐 인스턴스를 정의합니다.

 

BlockingQueue

45.5. BlockingQueue 구현 선택

기본적으로 SEDA 구성 요소는 항상 LinkedBlockingQueue를 intantiates but you can use different implementation, you can reference your own BlockingQueue implementation, in this case the size option is not used

<bean id="arrayQueue" class="java.util.ArrayBlockingQueue">
  <constructor-arg index="0" value="10" ><!-- size -->
  <constructor-arg index="1" value="true" ><!-- fairness -->
</bean>

<!-- ... and later -->
<from>seda:array?queue=#arrayQueue</from>

또는 BlockingQueueFactory 구현을 참조할 수 있습니다. 3 구현은 LinkedBlockingQueueFactory, ArrayBlockingQueueFactory 및 PriorityBlockingQueueFactory가 제공됩니다.

<bean id="priorityQueueFactory" class="org.apache.camel.component.seda.PriorityBlockingQueueFactory">
  <property name="comparator">
    <bean class="org.apache.camel.demo.MyExchangeComparator" />
  </property>
</bean>

<!-- ... and later -->
<from>seda:priority?queueFactory=#priorityQueueFactory&size=100</from>

45.6. 요청 응답의 사용

SEDA 구성 요소는 호출자가 Async 경로가 완료될 때까지 대기하는 Reply 요청 사용을 지원합니다. 예를 들면 다음과 같습니다.

from("mina:tcp://0.0.0.0:9876?textline=true&sync=true").to("seda:input");

from("seda:input").to("bean:processInput").to("bean:createResponse");

위의 경로에서 포트 9876에 들어오는 요청을 수락하는 TCP 리스너가 있습니다. 요청은 seda:input 대기열로 라우팅됩니다. 요청 응답 메시지이므로 응답을 기다립니다. seda:input 대기열의 소비자가 완료되면 응답을 원래 메시지 응답에 복사합니다.

45.7. 동시 소비자

기본적으로 SEDA 끝점은 단일 소비자 스레드를 사용하지만 동시 소비자 스레드를 사용하도록 구성할 수 있습니다. 따라서 스레드 풀 대신 다음을 사용할 수 있습니다.

from("seda:stageName?concurrentConsumers=5").process(...)

이 둘의 차이와 마찬가지로 스레드 풀은 부하에 따라 런타임 시 동적으로 증가/축소할 수 있는 반면 동시 소비자 수는 항상 고정되어 있습니다.

45.8. 스레드 풀

다음과 같은 작업을 수행하여 SEDA 끝점에 스레드 풀을 추가합니다.

from("seda:stageName").thread(5).process(...)

두 개의 BlockQueues 로 상승할 수 있습니다 : SEDA 끝점에서 하나, 스레드 풀의 작업 대기열에서 하나씩 원하는 것이 아닐 수 있습니다. 대신 메시지를 동기 및 비동기적으로 처리할 수 있는 스레드 풀로 Direct 끝점을 구성할 수 있습니다. 예를 들면 다음과 같습니다.

from("direct:stageName").thread(5).process(...)

concurrentConsumers 옵션을 사용하여 SEDA 끝점에서 메시지를 처리하는 스레드 수를 직접 구성할 수도 있습니다.

45.9. sample

아래 경로에서 SEDA 대기열을 사용하여 다른 스레드에서 추가 처리를 위한 fire-and-forget 메시지를 전송하고 이 스레드의 상수 응답을 원래 호출자에게 반환할 수 있도록 이 async 큐에 요청을 보냅니다.

Hello World 메시지를 보내고 응답이 정상이 될 것으로 예상됩니다.

    @Test
    public void testSendAsync() throws Exception {
        MockEndpoint mock = getMockEndpoint("mock:result");
        mock.expectedBodiesReceived("Hello World");

        // START SNIPPET: e2
        Object out = template.requestBody("direct:start", "Hello World");
        assertEquals("OK", out);
        // END SNIPPET: e2

        assertMockEndpointsSatisfied();
    }

    @Override
    protected RouteBuilder createRouteBuilder() throws Exception {
        return new RouteBuilder() {
            // START SNIPPET: e1
            public void configure() throws Exception {
                from("direct:start")
                    // send it to the seda queue that is async
                    .to("seda:next")
                    // return a constant response
                    .transform(constant("OK"));

                from("seda:next").to("mock:result");
            }
            // END SNIPPET: e1
        };
    }

"Hello World" 메시지는 추가 처리를 위해 다른 스레드의 SEDA 대기열에서 사용됩니다. 이는 단위 테스트에서 수행되므로 단위 테스트에서 어설션을 수행할 수 있는 크 엔드포인트로 전송됩니다.

45.10. multipleConsumers 사용

이 예제에서는 두 명의 소비자를 정의했습니다.

    @Test
    public void testSameOptionsProducerStillOkay() throws Exception {
        getMockEndpoint("mock:foo").expectedBodiesReceived("Hello World");
        getMockEndpoint("mock:bar").expectedBodiesReceived("Hello World");

        template.sendBody("seda:foo", "Hello World");

        assertMockEndpointsSatisfied();
    }

    @Override
    protected RouteBuilder createRouteBuilder() throws Exception {
        return new RouteBuilder() {
            @Override
            public void configure() throws Exception {
                from("seda:foo?multipleConsumers=true").routeId("foo").to("mock:foo");
                from("seda:foo?multipleConsumers=true").routeId("bar").to("mock:bar");
            }
        };
    }

seda foo 엔드 포인트에서 여러Consumers=true 를 지정했기 때문에 이 두 소비자는 메시지의 고유한 사본을 일종의 piece-sub 스타일 메시지로 받을 수 있습니다.

빈은 단위 테스트의 일부이므로 mock 끝점으로 메시지를 보냅니다.

45.11. 대기열 정보 추출

필요한 경우 큐 크기 등과 같은 정보는 다음과 같은 방식으로 ScanSetting을 사용하지 않고도 얻을 수 있습니다.

SedaEndpoint seda = context.getEndpoint("seda:xxxx");
int size = seda.getExchanges().size();

45.12. Spring Boot Auto-Configuration

Spring Boot와 함께 seda를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-seda-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.seda.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.seda.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.seda.concurrent-consumers

기본 동시 스레드 처리 수를 설정합니다.

1

정수

camel.component.seda.default-block-when-full

메시지를 전체 SEDA 큐로 보내는 스레드는 큐의 용량이 더 이상 소진되지 않을 때까지 차단됩니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 호출 스레드가 대신 차단되고 메시지가 수락될 때까지 기다립니다.

false

부울

camel.component.seda.default-discard-when-full

메시지를 전체 SEDA 큐로 보내는 스레드가 삭제되는지의 여부입니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 호출 스레드가 전송 및 계속되므로 메시지가 SEDA 큐로 전송되지 않았습니다.

false

부울

camel.component.seda.default-offer-timeout

메시지를 전체 SEDA 큐로 보내는 스레드는 큐의 용량이 더 이상 소진되지 않을 때까지 차단됩니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 구성된 시간 초과를 블록 케이스에 추가할 수 있습니다. Java 대기열의 .offer(timeout) 메서드를 사용합니다.

 

long

camel.component.seda.default-poll-timeout

폴링 시 사용되는 타임아웃(밀리초)입니다. 시간 초과가 발생하면 소비자는 계속 실행할 수 있는지 여부를 확인할 수 있습니다. 값을 낮게 설정하면 사용자가 종료 시 더 신속하게 대응할 수 있습니다.

1000

정수

camel.component.seda.default-queue-factory

기본 대기열 팩토리를 설정합니다. 옵션은 org.apache.camel.component.seda.BlockingQueueFactory<org.apache.camel.Exchange> 유형입니다.

 

BlockingQueueFactory

camel.component.seda.enabled

seda 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.seda.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.seda.queue-size

SEDA 대기열의 기본 최대 용량(즉, 보유할 수 있는 메시지 수)을 설정합니다.

1000

정수

46장. Servlet

소비자만 지원됩니다.

Servlet 구성 요소는 게시된 Servlet에 바인딩된 HTTP 끝점에 도달하는 HTTP 요청을 사용하기 위한 HTTP 기반 끝점을 제공합니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-servlet</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>
참고

stream

서블릿은 스트림을 기반으로 하므로 수신하는 입력이 Camel에 스트림으로 제출됩니다. 즉, 스트림의 내용을 한 번만 읽을 수 있습니다. 메시지 본문이 비어 있는 것으로 표시되는 상황을 발견하거나 데이터에 여러 번 액세스해야 하는 경우(예: 멀티 캐스트를 수행하거나 오류 처리 수행) Stream 캐싱을 사용하거나 메시지 본문을 여러 번 읽을 수 있는 안전한 String 으로 변환해야 합니다.

46.1. URI 형식

servlet://relative_path[?options]

46.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

46.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 사용되는 사전 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

46.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형 의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

46.3. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 즉, 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생했음을 의미합니다. 그러면 이제 라우팅 오류 처리기에서 메시지로 처리하고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

muteException (consumer)

사용 가능한 경우 소비자 측에서 Exchange 실패 처리로 응답의 본문에는 예외의 스택 추적이 포함되지 않습니다.

false

boolean

servletName (consumer)

사용할 서블릿의 기본 이름입니다. 기본 이름은 CamelServlet입니다.

CamelServlet

문자열

attachmentMultipartBinding (consumer(advanced))

다중 파트/form-data를 Camel Exchange의 첨부 파일로 자동으로 바인딩할지 여부입니다. attachmentMultipartBinding=true 및 disableStreamCache=false 옵션은 함께 작동할 수 없습니다. disableStreamCache를 제거하여 AttachmentMultipartBinding을 사용합니다. 이 값은 기본적으로 꺼져 있습니다. 이 경우 Servlets를 사용할 때 이를 활성화하기 위해 서블릿 특정 구성이 필요할 수 있습니다.

false

boolean

fileNameExtWhitelist (consumer (advanced))

업로드된 파일을 수락하기 위해 허용된 파일 이름 확장의 허용 목록입니다. 여러 확장은 txt,xml과 같이 쉼표로 구분할 수 있습니다.

 

문자열

httpRegistry (consumer (advanced))

사용자 지정 org.apache.camel.component.servlet.HttpRegistry를 사용하려면 다음을 수행합니다.

 

HttpRegistry

allowJavaSerializedObject (advanced)

요청이 context-type=application/x-java-serialized-object를 사용할 때 Java 직렬화를 허용할지 여부입니다. 이는 기본적으로 해제되어 있습니다. 이를 활성화하면 Java가 요청에서 Java로 들어오는 데이터를 역직렬화하고 잠재적 보안 위험이 될 수 있음을 알고 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

httpBinding (advanced)

사용자 지정>-<Binding을 사용하여 Camel 메시지와 10.0.0.1Client 간 매핑을 제어하려면 다음을 수행합니다.

 

HttpBinding

httpConfiguration (advanced)

공유 10.0.0.1Configuration을 기본 구성으로 사용하려면 다음을 수행합니다.

 

HttpConfiguration

headerFilterStrategy (filter)

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지와 헤더를 필터링합니다.

 

HeaderFilterStrategy

46.4. 끝점 옵션

Servlet 끝점은 URI 구문을 사용하여 구성됩니다.

servlet:contextPath

다음과 같은 경로 및 쿼리 매개변수 사용:

46.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

contextPath (consumer)

사용할 context-path가 필요합니다.

 

문자열

46.4.2. 쿼리 매개변수 (22 매개변수)

이름설명Default유형

청크 (consumer)

이 옵션이 false이면 Servlet은 HTTP 스트리밍을 비활성화하고 응답에서 콘텐츠 길이 헤더를 설정합니다.

true

boolean

disableStreamCache (common)

Servlet의 원시 입력 스트림이 캐시되는지 여부를 결정합니다(Camel은 파일, 스트림 캐싱) 캐시의 memory/overflow에 스트림을 읽습니다. 기본적으로 Camel은 Servlet 입력 스트림을 캐시하여 여러 번 읽기를 지원하여 Camel이 스트림에서 모든 데이터를 검색할 수 있도록 합니다. 그러나 예를 들어 파일 또는 기타 영구 저장소로 직접 스트리밍하는 것과 같은 원시 스트림에 액세스해야 하는 경우 이 옵션을 true로 설정할 수 있습니다. DefaultHttpBinding은 요청 입력 스트림 스트림을 스트림 캐시에 복사하여 스트림 읽기를 여러 번 지원하기 위해 이 옵션이 false인 경우 메시지 본문에 저장합니다. Servlet을 사용하여 끝점을 브리지/proxy하는 경우 메시지 페이로드를 여러 번 읽을 필요가 없는 경우 이 옵션을 활성화하여 성능을 개선하는 것이 좋습니다. http 생산자는 기본적으로 응답 본문 스트림을 캐시합니다. 이 옵션을 true로 설정하면 생산자는 응답 본문 스트림을 캐시하지 않고 응답 스트림을 메시지 본문으로 사용합니다.

false

boolean

headerFilterStrategy (common)

사용자 정의 HeaderFilterStrategy를 사용하여 Camel 메시지 간 헤더를 필터링하려면 다음을 수행합니다.

 

HeaderFilterStrategy

httpBinding (공용 (advanced))

사용자 지정>-<Binding을 사용하여 Camel 메시지와 10.0.0.1Client 간 매핑을 제어하려면 다음을 수행합니다.

 

HttpBinding

async (consumer)

async 모드에서 작동하도록 소비자를 구성합니다.

false

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 즉, 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생했음을 의미합니다. 그러면 이제 라우팅 오류 처리기에서 메시지로 처리하고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

httpMethodRestrict (consumer)

GET/ECDHE/PUT 등과 같은 10.0.0.1Method가 일치하는 경우에만 사용을 허용하는 데 사용됩니다. 여러 방법을 쉼표로 구분하여 지정할 수 있습니다.

 

문자열

matchOnUriPrefix (consumer)

소비자가 정확히 일치하지 않는 경우 URI 접두사를 일치시켜 대상 소비자를 찾아야 하는지 여부입니다.

false

boolean

muteException (consumer)

사용 가능한 경우 소비자 측에서 Exchange 실패 처리로 응답의 본문에는 예외의 스택 추적이 포함되지 않습니다.

false

boolean

responseBufferSize (consumer)

javax.servlet.ServletResponse에서 사용자 정의 버퍼 크기를 사용합니다.

 

정수

servletName (consumer)

사용할 서블릿의 이름입니다.

CamelServlet

문자열

transferException (consumer)

소비자 측에서 활성화되어 있고 Exchange에 실패한 처리가 있고 발생된 Exception이 응답에서 application/x-java-serialized-object 콘텐츠 유형으로 직렬화된 경우. 프로듀서 측에서 예외는 역직렬화되어 있는 그대로 throw되며, 10.0.0.1OperationFailedException 대신 그대로 throw됩니다. 발생한 예외를 직렬화해야 합니다. 이는 기본적으로 해제되어 있습니다. 이를 활성화하면 Java가 요청에서 Java로 들어오는 데이터를 역직렬화하고 잠재적 보안 위험이 될 수 있음을 알고 있습니다.

false

boolean

attachmentMultipartBinding (consumer(advanced))

다중 파트/form-data를 Camel Exchange의 첨부 파일로 자동으로 바인딩할지 여부입니다. attachmentMultipartBinding=true 및 disableStreamCache=false 옵션은 함께 작동할 수 없습니다. disableStreamCache를 제거하여 AttachmentMultipartBinding을 사용합니다. 이 값은 기본적으로 꺼져 있습니다. 이 경우 Servlets를 사용할 때 이를 활성화하기 위해 서블릿 특정 구성이 필요할 수 있습니다.

false

boolean

eagerCheckContentAvailable (consumer (advanced))

콘텐츠 길이 헤더가 0이거나 존재하지 않는 경우 HTTP 요청에 콘텐츠가 있는지 신속하게 확인합니다. HTTP 클라이언트가 스트리밍된 데이터를 보내지 않는 경우 이 기능을 사용할 수 있습니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

fileNameExtWhitelist (consumer (advanced))

업로드된 파일을 수락하기 위해 허용된 파일 이름 확장의 허용 목록입니다. 여러 확장은 txt,xml과 같이 쉼표로 구분할 수 있습니다.

 

문자열

mapHttpMessageBody (consumer (advanced))

이 옵션이 true이면 교환의 IN exchange will be mapped to HTTP body에 매핑됩니다. 이를 false로 설정하면 HTTP 매핑이 발생하지 않습니다.

true

boolean

mapHttpMessageFormUrlEncodedBody (consumer (advanced))

이 옵션이 true이면 교환의 IN exchange Form Encoded body가 HTTP에 매핑됩니다. 이를 false로 설정하면 HTTP Form Encoded body mapping이 발생하지 않습니다.

true

boolean

mapHttpMessageHeaders (consumer(고급))

이 옵션이 true이면 교환의 IN exchange 헤더가 HTTP 헤더에 매핑됩니다. 이를 false로 설정하면 HTTP 헤더 매핑이 발생하지 않습니다.

true

boolean

optionsEnabled (consumer(advanced))

이 Servlet 소비자에 대해 HTTP OPTIONS를 활성화할지 여부를 지정합니다. 기본적으로 OPTIONS는 해제되어 있습니다.

false

boolean

traceEnabled (consumer (advanced))

이 Servlet Consumer Consumer에 대해 HTTP TRACE를 활성화할지 여부를 지정합니다. 기본적으로 TRACE는 해제되어 있습니다.

false

boolean

46.5. 메시지 헤더

Camel은 HTTP 구성 요소와 동일한 Message Headers를 적용합니다.

Camel은 모든 request.parameterrequest.headers 를 채웁니다. 예를 들어 클라이언트 요청에 URL인 http://myserver/myserver?orderid=123 가 있는 경우 교환에 값이 10.0.0.1인 orderid 라는 헤더가 포함됩니다.

46.6. 사용법

Servlet 구성 요소에서 생성된 끝점에서만 사용할 수 있습니다. 따라서 Camel 경로에 대한 입력으로만 사용해야 합니다. 다른 HTTP 끝점에 대해 HTTP 요청을 실행하려면 HTTP 구성 요소를 사용하십시오.

46.7. Spring Boot Auto-Configuration

Spring Boot와 함께 서블릿을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-servlet-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

구성 요소는 아래에 나열된 15개의 옵션을 지원합니다.

이름설명Default유형

camel.component.servlet.allow-java-serialized-object

요청이 context-type=application/x-java-serialized-object를 사용할 때 Java 직렬화를 허용할지 여부입니다. 이는 기본적으로 해제되어 있습니다. 이를 활성화하면 Java가 요청에서 Java로 들어오는 데이터를 역직렬화하고 잠재적 보안 위험이 될 수 있음을 알고 있습니다.

false

부울

camel.component.servlet.attachment-multipart-binding

다중 파트/form-data를 Camel Exchange의 첨부 파일로 자동으로 바인딩할지 여부입니다. attachmentMultipartBinding=true 및 disableStreamCache=false 옵션은 함께 작동할 수 없습니다. disableStreamCache를 제거하여 AttachmentMultipartBinding을 사용합니다. 이 설정은 Servlet을 사용할 때 이를 활성화하기 위해 서블릿 특정 구성이 필요할 수 있으므로 기본적으로 꺼져 있습니다.

false

부울

camel.component.servlet.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.servlet.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 즉, 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생했음을 의미합니다. 그러면 이제 라우팅 오류 처리기에서 메시지로 처리하고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.servlet.enabled

서블릿 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.servlet.file-name-ext-whitelist

업로드된 파일을 수락하기 위해 허용된 파일 이름 확장의 허용 목록입니다. 여러 확장은 txt,xml과 같이 쉼표로 구분할 수 있습니다.

 

문자열

camel.component.servlet.header-filter-strategy

사용자 지정 org.apache.camel.spi.HeaderFilterStrategy를 사용하여 Camel 메시지와 헤더를 필터링합니다. 옵션은 org.apache.camel.spi.HeaderFilterStrategy 유형입니다.

 

HeaderFilterStrategy

camel.component.servlet.http-binding

사용자 지정>-<Binding을 사용하여 Camel 메시지와 10.0.0.1Client 간 매핑을 제어하려면 다음을 수행합니다. 옵션은 org.apache.camel.http.common.HttpBinding 유형입니다.

 

HttpBinding

camel.component.servlet.http-configuration

공유 10.0.0.1Configuration을 기본 구성으로 사용하려면 다음을 수행합니다. 옵션은 org.apache.camel.http.common.HttpConfiguration 유형입니다.

 

HttpConfiguration

camel.component.servlet.http-registry

사용자 지정 org.apache.camel.component.servlet.HttpRegistry를 사용하려면 다음을 수행합니다. 옵션은 org.apache.camel.http.common.HttpRegistry 유형입니다.

 

HttpRegistry

camel.component.servlet.mute-exception

사용 가능한 경우 소비자 측에서 Exchange 실패 처리로 응답의 본문에는 예외의 스택 추적이 포함되지 않습니다.

false

부울

camel.component.servlet.servlet-name

사용할 서블릿의 기본 이름입니다. 기본 이름은 CamelServlet입니다.

CamelServlet

문자열

camel.servlet.mapping.context-path

자동 매핑을 위해 서블릿 구성 요소에서 사용하는 컨텍스트 경로입니다.

/camel/*

문자열

camel.servlet.mapping.enabled

서블릿 구성 요소의 자동 매핑을 Spring 웹 컨텍스트로 활성화합니다.

true

부울

camel.servlet.mapping.servlet-name

Camel 서블릿의 이름입니다.

CamelServlet

문자열

47장. Slack

생산자 및 소비자 모두 지원

Slack 구성 요소를 사용하면 Slack 인스턴스에 연결하고 미리 설정된 Slack 수신 Webhook 를 통해 메시지 본문에 포함된 메시지를 전달할 수 있습니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-slack</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

47.1. URI 형식

채널에 메시지를 보냅니다.

slack:#channel[?options]

슬랙 사용자에게 직접 메시지를 보냅니다.

slack:@userID[?options]

47.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

47.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

47.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

47.3. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

토큰 (token)

사용할 토큰입니다.

 

문자열

webhookUrl (webhook)

들어오는 웹 후크 URL입니다.

 

문자열

47.4. 끝점 옵션

Slack 끝점은 URI 구문을 사용하여 구성됩니다.

slack:channel

다음과 같은 경로 및 쿼리 매개변수 사용:

47.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

채널 (common)

사용자에게 직접 메시지를 보내는 데 필요한 채널 이름(syntax #name) 또는 slackuser(syntax userName)입니다.

 

문자열

47.4.2. 쿼리 매개변수(29 매개변수)

이름설명Default유형

토큰 (공용)

사용할 토큰입니다.

 

문자열

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

conversationType (consumer)

일종의 대화입니다.

CloudEvent 값:

  • PUBLIC_CHANNEL
  • PRIVATE_CHANNEL
  • MPIM
  • IM

PUBLIC_CHANNEL

ConversationType

maxresults (consumer)

폴링의 최대 결과입니다.

10

문자열

naturalOrder (consumer)

자연순으로 교환을 생성 (최신으로 이전) 또는 그렇지 않습니다.

false

boolean

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

serverUrl (consumer)

Slack 인스턴스의 서버 URL입니다.

 

문자열

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

iconEmoji (producer)

더 이상 사용되지 않는 Slack emoji를 avatar로 사용하십시오.

 

문자열

iconUrl (producer)

더 이상 사용되지 않는 구성 요소에서 채널 또는 사용자에게 메시지를 보낼 때 사용할 avatar입니다.

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

사용자 이름 (producer)

이는 채널 또는 사용자에게 메시지를 보낼 때 봇에서 보유할 사용자 이름입니다.

 

문자열

webhookUrl (producer)

들어오는 웹 후크 URL입니다.

 

문자열

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

47.5. skopeo XML에서 구성

XML이 있는 Slack 구성 요소는 들어오는 Webhook URL 또는 통합을 위한 앱 토큰을 매개변수로 포함하는 Spring 또는 Blueprint configuration로 구성해야 합니다.

<bean id="slack" class="org.apache.camel.component.slack.SlackComponent">
    <property name="webhookUrl" value="https://hooks.slack.com/services/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"/>
    <property name="token" value="xoxb-12345678901-1234567890123-xxxxxxxxxxxxxxxxxxxxxxxx"/>
</bean>

Java의 경우 Java 코드를 사용하여 이를 구성할 수 있습니다.

47.6. 예제

청사진을 사용한 CamelContext는 다음과 같습니다.

<?xml version="1.0" encoding="UTF-8"?>
<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" default-activation="lazy">

    <bean id="slack" class="org.apache.camel.component.slack.SlackComponent">
        <property name="webhookUrl" value="https://hooks.slack.com/services/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"/>
    </bean>

    <camelContext xmlns="http://camel.apache.org/schema/blueprint">
        <route>
            <from uri="direct:test"/>
            <to uri="slack:#channel?iconEmoji=:camel:&amp;username=CamelTest"/>
        </route>
    </camelContext>

</blueprint>

47.7. 프로듀서

이제 토큰을 사용하여 WebhookUrl 대신 메시지를 보낼 수 있습니다.

from("direct:test")
    .to("slack:#random?token=RAW(<YOUR_TOKEN>)");

Slack API 모델을 사용하여 블록을 생성할 수 있습니다. 이에 대한 자세한 내용은 https://api.slack.com/block-kit 에서 확인할 수 있습니다.

    public void testSlackAPIModelMessage() {
        Message message = new Message();
        message.setBlocks(Collections.singletonList(SectionBlock
                .builder()
                .text(MarkdownTextObject
                        .builder()
                        .text("*Hello from Camel!*")
                        .build())
                .build()));

        template.sendBody(test, message);
    }

47.8. 소비자

채널의 메시지에 소비자도 사용할 수 있습니다.

from("slack://general?token=RAW(<YOUR_TOKEN>)&maxResults=1")
    .to("mock:result");

이렇게 하면 일반 채널에서 마지막 메시지를 얻을 수 있습니다. 소비자는 소비된 마지막 메시지의 타임 스탬프를 추적하고 다음 폴링에서는 해당 타임스탬프에서 확인합니다.

Slack 앱을 만들고 작업 영역에서 사용해야 합니다.

'Bot User OAuth Access Token'을 소비자 엔드포인트의 토큰으로 사용합니다.

참고

해당 기록(채널:history 또는 groups:history 또는 im:history 또는 im:history)을 추가하고 읽기 (채널:read 또는 groups :read 또는 im:read) 사용자 토큰 범위를 앱에 추가하여 해당 채널의 메시지를 볼 수 있는 권한을 부여합니다. conversationType 옵션을 사용하여도 설정해야합니다 ( ECDHELIC_CHANNEL ,PRIVATE_CHANNEL ,MPIM,IM)

naturalOrder 옵션을 사용하면 가장 오래된 메시지에서 최신 메시지로 메시지를 사용할 수 있습니다. 원래는 최신 정보를 얻을 수 있으며 뒤로 사용(메시지 3 ECDHE 메시지 2 ECDHE 메시지 1)

참고

conversationType 옵션을 사용하여 공개가 아닌 채널에서 기록 및 메시지를 읽을 수 있습니다( ECDHELIC_CHANNEL ,PRIVATE_CHANNEL ,MPIM,IM)

47.9. Spring Boot Auto-Configuration

Spring Boot와 함께 slack을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-slack-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.slack.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.slack.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.slack.enabled

슬랙 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.slack.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.slack.token

사용할 토큰입니다.

 

문자열

camel.component.slack.webhook-url

들어오는 웹 후크 URL입니다.

 

문자열

48장. SQL

생산자 및 소비자 모두 지원

SQL 구성 요소를 사용하면 JDBC 쿼리를 사용하여 데이터베이스를 작업할 수 있습니다. 이 구성 요소와 JDBC 구성 요소의 차이점은 SQL의 경우 쿼리가 끝점의 속성이며 쿼리에 전달된 매개변수로 메시지 페이로드를 사용한다는 것입니다.

이 구성 요소는 실제 SQL 처리를 위해 spring-jdbc 를 사용합니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-sql</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

SQL 구성 요소는 다음과 같은 기능을 지원합니다.

  • Idempotent Consumer EIP 패턴을 위한 JDBC 기반 리포지토리입니다. 아래를 더 참조하십시오.
  • 집계기 EIP 패턴을 위한 JDBC 기반 리포지토리입니다. 아래를 더 참조하십시오.

48.1. URI 형식

참고

이 구성 요소는 Transactional Client 로 사용할 수 있습니다.

SQL 구성 요소는 다음 끝점 URI 표기법을 사용합니다.

sql:select * from table where id=# order by name[?options]

다음과 같이 :'#name_of_the_parameter' 스타일을 사용하여 이름이 지정된 매개변수를 사용할 수 있습니다.

sql:select * from table where id=:#myId order by name[?options]

이름이 지정된 매개변수를 사용하는 경우 Camel은 지정된 우선 순위에서 이름을 조회합니다.

  1. java.util.Map의 경우 메시지 본문에서
  2. 메시지 헤더에서

명명된 매개 변수를 확인할 수 없는 경우 예외가 throw됩니다.

다음과 같이 간단한 표현식을 매개변수로 사용할 수 있습니다.

sql:select * from table where id=:#${exchangeProperty.myId} order by name[?options]

SQL 쿼리에 대한 매개 변수를 나타내는 표준 ? 기호는 끝점에 대한 옵션을 지정하는 데 사용되므로 # 기호로 대체됩니다. 기호 교체는 끝점에 따라 구성할 수 있습니다.

다음과 같이 classpath 또는 파일 시스템의 파일에 SQL 쿼리를 외부화할 수 있습니다.

sql:classpath:sql/myquery.sql[?options]

myquery.sql 파일은 classpath에 있으며 일반 텍스트일 뿐입니다.

-- this is a comment
select *
from table
where
  id = :#${exchangeProperty.myId}
order by
  name

파일에서 여러 줄을 사용하고 원하는 대로 SQL을 포맷할 수 있습니다. 또한 - 대시 행과 같은 주석을 사용합니다.

48.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

48.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

48.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

48.3. 구성 요소 옵션

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

이름설명Default유형

데이터 소스 (공용)

Autowired 는 데이터베이스와 통신하는 데 사용할 DataSource를 설정합니다.

 

DataSource

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

usePlaceholder (advanced)

자리 표시자를 사용하고 모든 자리 표시자 문자를 SQL 쿼리에 로그인할지 여부를 설정합니다.Sets whether to use placeholder and replace all placeholder characters with sign in the SQL queries. 이 옵션은 기본값 true입니다.

true

boolean

48.4. 끝점 옵션

SQL 끝점은 URI 구문을 사용하여 구성됩니다.

sql:query

다음과 같은 경로 및 쿼리 매개변수 사용:

48.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

쿼리 (공용)

수행할 SQL 쿼리를 설정합니다. file: 또는 classpath:를 접두사로 사용하여 쿼리를 외부화하고 파일의 위치를 지정할 수 있습니다.

 

문자열

48.4.2. 쿼리 매개변수(45 매개변수)

이름설명Default유형

allowNamedParameters (common)

쿼리에 이름이 지정된 매개변수를 사용할 수 있도록 허용할지 여부입니다.

true

boolean

데이터 소스 (공용)

엔드포인트 수준에서 데이터베이스와 통신하는 데 사용할 DataSource를 설정합니다.

 

DataSource

outputClass (common)

outputType=SelectOne이 될 때 변환으로 사용할 전체 패키지와 클래스 이름을 지정합니다.

 

문자열

outputHeader (common)

메시지 본문 대신 헤더에 쿼리 결과를 저장합니다. 기본적으로 outputHeader == null 및 쿼리 결과는 메시지 본문에 저장되고 메시지 본문의 기존 콘텐츠가 삭제됩니다. outputHeader가 설정된 경우 값은 쿼리 결과를 저장하기 위해 헤더 이름으로 사용되며 원래 메시지 본문은 보존됩니다.

 

문자열

OutputType (common)

Consumer 또는 producer to SelectList as SelectList as List of Map, or SelectOne as a single Java object in the following way: a) 쿼리에 단일 열만 반환되는 경우 (예: Select Column() FROM PROJECT는 긴 오브젝트를 반환합니다. b) 쿼리에 여러 열이 있는 경우 해당 결과의 맵이 반환됩니다. c) outputClass가 설정된 경우, 그런 다음 열 이름과 일치하는 모든 setter를 호출하여 쿼리 결과를 Java kubeconfig 오브젝트로 변환합니다. 클래스에 인스턴스를 만들 수 있는 기본 생성자가 있다고 가정합니다. d) 쿼리가 두 개 이상의 행을 초래하는 경우 고유하지 않은 결과 예외가 발생합니다. StreamList는 Iterator를 사용하여 쿼리의 결과를 스트리밍합니다. 이는 스트리밍 모드에서 Splitter EIP와 함께 사용하여 스트리밍 방식으로 ResultSet을 처리할 수 있습니다.

CloudEvent 값:

  • SelectOne
  • SelectList
  • StreamList

SelectList

SqlOutputType

구분 기(common)

# 자리 표시자에 삽입하기 위해 메시지 본문(본체가 문자열 유형인 경우)에서 매개 변수 값을 가져올 때 사용할 구분 기호입니다. 이름이 지정된 매개변수를 사용하면 대신 Map 유형이 사용됩니다. 기본값은 쉼표입니다.

,

grafka

breakBatchOnConsumeFail (consumer)

onConsume에 실패한 경우 일괄 처리를 중단할지 여부를 설정합니다.

false

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

expectedUpdateCount (consumer)

onConsume를 사용할 때 유효성을 검사하도록 예상 업데이트 수를 설정합니다.

-1

int

maxMessagesPerPoll (consumer)

폴링할 최대 메시지 수를 설정합니다.

 

int

OnConsume (consumer)

각 행을 처리한 후 Exchange가 성공적으로 처리된 경우 이 쿼리를 실행할 수 있습니다. 예를 들어 행이 처리된 것으로 표시됩니다. 쿼리에 매개 변수가 있을 수 있습니다.

 

문자열

onConsumeBatchComplete (consumer)

전체 일괄 처리를 수행한 후 이 쿼리는 일괄 업데이트 행 등으로 실행될 수 있습니다.After processing the entire batch, this query can be executed to bulk update rows. 쿼리에 매개 변수가 있을 수 없습니다.

 

문자열

onConsumeFailed (consumer)

각 행을 처리한 후 교환이 실패한 경우 이 쿼리를 실행할 수 있습니다(예: 행을 실패로 표시). 쿼리에 매개 변수가 있을 수 있습니다.

 

문자열

routeEmptyResultSet (consumer)

빈 결과 집합을 다음 홉으로 보낼 수 있는지 여부를 설정합니다. 기본값은 false입니다. 따라서 빈 결과가 필터링됩니다.

false

boolean

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

Transacted (consumer)

트랜잭션을 활성화하거나 비활성화합니다. 그런 다음 교환을 처리하는 데 실패한 경우 소비자는 추가 트랜잭션 처리를 중단하여 롤백을 신속하게 수행합니다.

false

boolean

UseIterator (consumer)

결과 집합을 경로로 전달해야 하는 방법을 설정합니다. 전달을 목록 또는 개별 오브젝트로 나타냅니다. 기본값은 true입니다.

true

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

processingStrategy (consumer (advanced))

사용자가 행/배치를 처리할 때 사용자 정의 org.apache.camel.component.sql.SqlProcessingStrategy를 사용하여 쿼리를 실행할 수 있습니다.

 

SqlProcessingStrategy

일괄 (producer)

배치 모드를 활성화하거나 비활성화합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

noop (producer)

설정된 경우 는 SQL 쿼리의 결과를 무시하고 기존 IN 메시지를 처리를 위한 OUT 메시지로 사용합니다.

false

boolean

useMessageBodyForSql (producer)

메시지 본문을 SQL으로 사용할지 여부 및 매개 변수의 헤더입니다. 이 옵션을 사용하면 uri의 SQL이 사용되지 않습니다. 메시지 본문의 쿼리 매개변수는 # 기호 대신 물음표로 표시됩니다.

false

boolean

alwaysPopulateStatement (advanced)

활성화하면 org.apache.camel.component.sql.SqlPrepareStatementStrategy의 populateStatement 메서드가 항상 호출됩니다. 이 값이 false인 경우 1개 이상의 예상 매개변수를 설정할 경우에만 populateStatement가 호출됩니다. 예를 들어 매개 변수가 없는 SQL 쿼리에 대한 메시지 본문/헤더를 읽지 않도록 합니다.

false

boolean

parametersCount (advanced)

0보다 큰 설정으로 인해 Camel은 JDBC 메타데이터 API를 통해 쿼리하지 않고 이 개수 매개 변수 값을 사용합니다. JDBC 공급업체에서 올바른 매개변수 수를 반환할 수 없는 경우 사용자가 대신 재정의할 수 있습니다.

 

int

자리 표시자 (advanced)

SQL 쿼리에서 교체할 문자를 지정합니다. 간단한 String.replaceAll() 작업이며 SQL 구문 분석과 관련이 없습니다(quoted 문자열도 변경됩니다).

#

문자열

prepareStatementStrategy (advanced)

플러그인에서 사용자 지정 org.apache.camel.component.sql.SqlPrepareStatementStrategy를 사용하여 쿼리 및 준비 문의 준비를 제어할 수 있습니다.

 

SqlPrepareStatementStrategy

templateOptions (고급)

맵의 키/값으로 Spring JdbcTemplate을 구성합니다.

 

map

usePlaceholder (advanced)

자리 표시자를 사용하고 모든 자리 표시자 문자를 SQL 쿼리에 로그인할지 여부를 설정합니다.Sets whether to use placeholder and replace all placeholder characters with sign in the SQL queries.

true

boolean

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

48.5. 메시지 본문의 처리

SQL 구성 요소는 메시지 본문을 java.util.Iterator 유형의 개체로 변환한 다음 이 10.0.0.1을 사용하여 쿼리 매개변수를 작성합니다(각 쿼리 매개변수가 끝점 URI에서 # 기호(또는 구성된 자리 표시자)로 표시되는 위치). 메시지 본문이 배열 또는 컬렉션이 아닌 경우 변환은 본문 자체인 하나의 개체(오브젝트)를 반복합니다.

예를 들어 메시지 본문이 java.util.List 의 인스턴스인 경우 목록의 첫 번째 항목이 SQL 쿼리에서 #의 첫 번째 항목으로 대체되고 목록의 두 번째 항목은 #으로 대체됩니다.

batchtrue 로 설정된 경우 인바운드 메시지 본문의 해석은 매개 변수 대신 약간 변경됩니다. 구성 요소는 매개 변수가 포함된 CloudEvent를 예상합니다. 외부의 size는 일괄 처리 크기를 결정합니다.

메시지 본문을 SQL 문으로 사용할 수 있는 useMessageBodyForSql 옵션을 사용할 수 있으며 SQL 매개 변수는 키가 있는 헤더에 제공되어야 합니다.You can use the option useMessageBodyForSql that allows to use the message body as the SQL statement, and then the SQL parameters must be provided in a header with the keyECDHE Constants.SQL_PARAMETERS. 이를 통해 SQL 구성 요소는 메시지 본문에서 SQL 쿼리가 수행되므로 더 동적으로 작업할 수 있습니다. 조건부 처리를 위해 템플릿(예: Velocity,Freemarker)을 사용하여 쿼리 매개변수 존재에 따라 where 절을 포함하거나 제외합니다.

48.6. 쿼리의 결과

선택 작업의 경우 결과는 JdbcTemplate.queryFor List() 메서드에서 반환하는 List<Map<String, Object | type의 인스턴스입니다. 업데이트 작업의 경우 업데이트 작업은 헤더로만 설정되고 본문으로 설정되지 않으므로 NULL 본문이 반환됩니다.

참고

업데이트 작업에 대한 자세한 내용은 헤더 값을 참조하십시오.

기본적으로 결과는 메시지 본문에 배치됩니다. outputHeader 매개변수가 설정되면 결과가 헤더에 배치됩니다. 이는 헤더를 추가하기 위해 전체 메시지 보강 패턴을 사용하는 대안이며, 시퀀스 또는 기타 작은 값을 헤더에 쿼리하기 위한 간결한 구문을 제공합니다. outputHeader와 outputType을 함께 사용하는 것이 편리합니다.

from("jms:order.inbox")
    .to("sql:select order_seq.nextval from dual?outputHeader=OrderId&outputType=SelectOne")
    .to("jms:order.booking");

48.7. StreamList 사용

생산자는 쿼리의 출력을 스트리밍하는 데 10.0.0.1을 사용하는 outputType=StreamList를 지원합니다. 이를 통해 Splitter EIP에서 한 번에 하나씩 각 행을 처리하고 필요에 따라 데이터베이스에서 데이터를 로드하기 위해 Splitter EIP에서 사용할 수 있는 스트리밍 방식으로 데이터를 처리할 수 있습니다.

from("direct:withSplitModel")
        .to("sql:select * from projects order by id?outputType=StreamList&outputClass=org.apache.camel.component.sql.ProjectModel")
        .to("log:stream")
        .split(body()).streaming()
            .to("log:row")
            .to("mock:result")
        .end();

48.8. 헤더 값

업데이트 작업을 수행할 때 SQL Component는 업데이트 수를 다음 메시지 헤더에 저장합니다.

header설명

CamelSqlUpdateCount

Integer 개체로 반환된 업데이트 작업에 대해 업데이트된 행 수입니다. outputType=StreamList를 사용할 때는 이 헤더가 제공되지 않습니다.

CamelSqlRowCount

Integer 개체로 반환되는 select 작업에 대해 반환된 행 수입니다. outputType=StreamList를 사용할 때는 이 헤더가 제공되지 않습니다.

CamelSqlQuery

실행할 쿼리입니다. 이 쿼리는 끝점 URI에 지정된 쿼리보다 우선합니다. 헤더의 쿼리 매개변수 # 기호 대신 ? 로 표시됩니다.

삽입 작업을 수행할 때 SQL Component는 생성된 키와 개수의 다음 메시지 헤더에 이러한 행의 개수가 있는 행을 저장합니다.

header설명

CamelSqlGeneratedKeysRowCount

생성된 키가 포함된 헤더의 행 수입니다.

CamelSqlGeneratedKeyRows

생성된 키(키 맵 목록)를 포함하는 행입니다.

48.9. 생성된 키

SQLECDHE를 사용하여 데이터를 삽입하면 RDBMS에서 자동 생성된 키를 지원할 수 있습니다. SQL 프로듀서에 헤더에서 생성된 키를 반환하도록 지시할 수 있습니다.
이를 위해 CamelSqlverifyGeneratedKeys=true 헤더를 설정합니다. 그러면 생성된 키는 위의 표에 나열된 키가 있는 헤더로 제공됩니다.

검색해야 하는 열을 지정하려면 CamelSqlGenerated 10.0.0.1s 헤더를 String[] 또는 int[] 로 설정하여 열 이름 또는 인덱스를 각각 나타냅니다. 일부 데이터베이스에는 이러한 기능이 필요합니다(예: Oracle). 드라이버에서 매개변수 수를 올바르게 확인할 수 없는 경우 parametersCount 옵션을 사용해야 할 수도 있습니다.

자세한 내용은 이 단원 테스트에서 확인할 수 있습니다.

48.10. DataSource

URI에서 DataSource 에 대한 참조를 직접 설정할 수 있습니다.

sql:select * from table where id=# order by name?dataSource=#myDS

48.11. 이름이 지정된 매개변수 사용

아래 지정된 경로에서 프로젝트 테이블에서 모든 프로젝트를 가져오려고 합니다. SQL 쿼리에 :#lic 및 :#min이라는 두 가지 이름의 매개 변수가 있습니다.
그런 다음 Camel은 메시지 본문 또는 메시지 헤더에서 이러한 매개변수를 조회합니다. 위의 예제에서는 named 매개변수에 대해 constant value
를 사용하여 두 개의 헤더를 설정합니다.

   from("direct:projects")
     .setHeader("lic", constant("ASF"))
     .setHeader("min", constant(123))
     .to("sql:select * from projects where license = :#lic and id > :#min order by id")

메시지 본문이 java.util.Map 이면 named 매개 변수가 본문에서 가져옵니다.

   from("direct:projects")
     .to("sql:select * from projects where license = :#lic and id > :#min order by id")

48.12. 생산자에서 표현식 매개변수 사용

아래 지정된 경로에서 데이터베이스의 모든 프로젝트를 가져오려고 합니다. 교환의 본문을 사용하여 라이센스를 정의하고 속성 값을 두 번째 매개 변수로 사용합니다.

from("direct:projects")
  .setBody(constant("ASF"))
  .setProperty("min", constant(123))
  .to("sql:select * from projects where license = :#${body} and id > :#${exchangeProperty.min} order by id")

48.12.1. 소비자에서 표현식 매개변수 사용

SQL 구성 요소를 소비자로 사용할 때 표현식 매개변수(simple language)를 사용하여 id, date 또는 something을 검색하기 위해 console에서 메서드를 호출하는 것과 같은 동적 쿼리 매개변수를 빌드할 수도 있습니다.

예를 들어 아래 샘플에서는 Velero myIdGenerator에서 nextId 메서드를 호출합니다.

from("sql:select * from projects where id = :#${bean:myIdGenerator.nextId}")
    .to("mock:result");

빈에는 다음과 같은 방법이 있습니다.

public static class MyIdGenerator {

    private int id = 1;

    public int nextId() {
        return id++;
    }

메시지 본문과 헤더가 있는 기존 Exchange 가 없으므로 소비자에서 사용할 수 있는 간단한 표현식은 이 예제와 같이 kubeconfig 메서드를 호출하는 데 가장 많이 사용할 수 있습니다.

48.13. 동적 값이 포함된 IN 쿼리 사용

SQL 생산자를 사용하면 IN 값이 동적 계산되는 IN 문과 함께 SQL 쿼리를 사용할 수 있습니다. 예를 들어 메시지 본문 또는 헤더 등의 경우For example from the message body or a header etc.

IN을 사용하려면 다음이 필요합니다.

  • 매개변수 이름 앞에 in을 접두사로 지정합니다.
  • 매개변수 앞에 ()를 추가합니다.

예를 들어 이 방법을 더 잘 설명합니다. 다음 쿼리가 사용됩니다.

-- this is a comment
select *
from projects
where project in (:#in:names)
order by id

다음 경로에서 다음을 수행합니다.

from("direct:query")
    .to("sql:classpath:sql/selectProjectsIn.sql")
    .to("log:query")
    .to("mock:query");

그런 다음 IN 쿼리는 다음과 같은 동적 값이 있는 키 이름과 함께 헤더를 사용할 수 있습니다.

// use an array
template.requestBodyAndHeader("direct:query", "Hi there!", "names", new String[]{"Camel", "AMQ"});

// use a list
List<String> names = new ArrayList<String>();
names.add("Camel");
names.add("AMQ");

template.requestBodyAndHeader("direct:query", "Hi there!", "names", names);

// use a string separated values with comma
template.requestBodyAndHeader("direct:query", "Hi there!", "names", "Camel,AMQ");

쿼리를 외부화하지 않고 끝점에 지정할 수도 있습니다(외부화하면 SQL 쿼리를 보다 쉽게 유지 관리할 수 있음)

from("direct:query")
    .to("sql:select * from projects where project in (:#in:names) order by id")
    .to("log:query")
    .to("mock:query");

48.14. JDBC 기반 idempotent 리포지토리 사용

이 섹션에서는 JDBC 기반 idempotent 리포지토리를 사용할 것입니다.

참고

추상 클래스
추상 클래스 org.apache.camel.processor.idempotent.jdbc.AbstractJdbcMessageIdRepository 는 사용자 정의 JDBC idempotent 리포지토리를 빌드하도록 확장할 수 있습니다.

먼저 idempotent 리포지토리에서 사용할 데이터베이스 테이블을 만들어야 합니다. 다음 스키마를 사용합니다.

CREATE TABLE CAMEL_MESSAGEPROCESSED ( processorName VARCHAR(255),
messageId VARCHAR(100) )

createdAt 열을 추가했습니다.

CREATE TABLE CAMEL_MESSAGEPROCESSED ( processorName VARCHAR(255),
messageId VARCHAR(100), createdAt TIMESTAMP )
참고

SQL Server TIMESTAMP 유형은 고정 길이의 바이너리 문자열 유형입니다. JDBC 시간 유형, 즉 time ,TIME 또는 TIMESTAMP 에 매핑되지 않습니다.

동시 소비자로 작업할 때는 processorName 및 messageId 열에 대한 고유 제약 조건을 생성하는 것이 중요합니다. 이 제약 조건의 구문이 데이터베이스마다 다르기 때문에 여기에 표시되지 않습니다.Because the syntax for this constraint differs from database to database, we do not show it here.

48.14.1. JDBC idempotency 리포지토리 사용자 정의

필요에 따라 org.apache.camel.processor.idempotent.jdbc.JdbcMessageIdRepository 를 조정할 수 있는 몇 가지 옵션이 있습니다.

매개변수기본값설명

createTableIfNotExists

true

Camel이 존재하지 않는 경우 테이블을 생성해야 하는지 여부를 정의합니다.

tableName

CAMEL_MESSAGEPROCESSED

기본 이름 대신 사용자 지정 테이블 이름을 사용하려면 CAMEL_MESSAGEPROCESSED.

tableExistsString

SELECT 1 FROM CAMEL_MESSAGEPROCESSED WHERE 1 = 0

이 쿼리는 테이블이 이미 있는지 여부를 확인하는 데 사용됩니다. 테이블이 존재하지 않음을 나타내기 위해 예외를 throw해야 합니다.

createString

CREATEForwarded CAMEL_MESSAGEPROCESSED (processorName VARCHAR(255), messageId VARCHAR(100), createdAt TIMESTAMP)

테이블을 만드는 데 사용되는 명령문입니다.

queryString

SELECT COUNT(*) FROM CAMEL_MESSAGEPROCESSED WHERE processorName = ? 및 messageId = ?

메시지가 리포지토리에 이미 존재하는지 여부를 파악하는 데 사용되는 쿼리입니다(결과가 '0'과 같지 않음). 두 개의 매개 변수가 필요합니다. 첫 번째는 프로세서 이름(문자열)이고, 두 번째는 메시지 ID(문자열)입니다.

insertString

CloudEvent INTO CAMEL_MESSAGEPROCEED (processorName, messageId, createdAt) VALUES (?, ?, ?)

테이블에 항목을 추가하는 데 사용되는 명령문입니다. 세 개의 매개 변수가 필요합니다. 첫 번째는 프로세서 이름(문자열)이고, 두 번째는 메시지 id(문자열)이고, 세 번째는 이 항목이 리포지토리에 추가될 때 타임스탬프(Java.sql.Timestamp)입니다.

deleteString

DELETE FROM CAMEL_MESSAGEPROCESSED WHERE processorName = ? 및 messageId = ?

데이터베이스에서 항목을 삭제하는 데 사용되는 명령문입니다. 두 개의 매개 변수를 사용합니다. 첫 번째는 프로세서 이름(문자열)이고, 두 번째는 메시지 ID(문자열)입니다.

옵션 tableName 은 테이블 이름이 다른 기본 SQL 쿼리를 사용하는 데 사용할 수 있습니다. 그러나 SQL 쿼리를 사용자 지정하려는 경우 각 쿼리를 개별적으로 구성할 수 있습니다.

48.14.2. 고립된 잠금 인식 Jdbc IdempotentRepository

org.apache.camel.processor.idempotent.jdbc.JdbcMessageIdRepository 의 제한 중 하나는 JVM 충돌 또는 정상 종료로 인한 고립 잠금을 처리하지 않는다는 것입니다. 이로 인해 처리되지 않은 파일/이 구현이 camel-file, camel-ftp 등과 함께 사용되는 경우, org.apache.camel.processor.idempotent.jdbc.JdbcOrphanLockAwarepotentRepository 를 사용해야 합니다. 이 리포지토리는 애플리케이션 인스턴스에서 보유하는 잠금을 추적합니다. 보관된 각 잠금에 대해 애플리케이션은 keep signals to the lock repository에 대해 createdAt 열을 현재 Timestamp로 업데이트합니다. 애플리케이션 인스턴스가 잠금을 취득하려고 하면 다음과 같은 세 가지 가능성이 있습니다.

  • lock 항목이 존재하지 않는 경우 JdbcMessageIdRepository 의 기본 구현을 사용하여 잠금이 제공됩니다.
  • 잠금이 이미 존재하며 createdAt < System.currentTimeMillis() - lockMaxAgeMillis. 이 경우 활성 인스턴스에 잠금이 있고 잠금을 요청하는 새 인스턴스에 잠금이 제공되지 않는 것으로 가정합니다.
  • 잠금이 이미 존재하며 createdAt > = System.currentTimeMillis() - lockMaxAgeMillis. 이 경우 잠금이 있고 요청하는 인스턴스에 잠금이 제공되는 활성 인스턴스가 있다고 가정합니다. 그 이유는 잠금이 있는 원래 인스턴스인 경우 아직 실행 중인 경우 keepAlive 메커니즘을 사용하여 createdAt에서 Timestamp를 업데이트했기 때문입니다.

이 리포지토리에는 두 가지 추가 구성 매개변수가 있습니다.

매개변수설명

lockMaxAgeMillis

이는 잠금이 고립된 것으로 간주되는 기간을 나타냅니다. 즉, currentTimestamp - createdAt >= lockMaxAgeMillis가 분리되는 경우 잠금이 분리됩니다.

lockKeepAliveIntervalMillis

지속적으로 업데이트되는 빈도는At Timestamp 열에 생성됩니다.

48.14.3. Caching Jdbc IdempotentRepository

일부 SQL 구현은 쿼리별로 빠르지 않습니다. JdbcMessageIdRepository 구현은 SQL 트랜잭션 내에서 idempotent를 개별적으로 확인합니다. 간단한 100개의 키를 확인하는 데 몇 분이 걸릴 수 있습니다. JdbcCachedMessageIdRepository 는 전체 키 목록으로 시작 시 메모리 내 캐시를 미리 로드합니다. 그런 다음 이 캐시는 원래 구현으로 통과하기 전에 먼저 확인합니다.

모든 캐시 구현과 마찬가지로 오래된 데이터 및 특정 사용과 관련하여 고려해야 할 고려 사항이 있습니다.

48.15. JDBC 기반 집계 리포지토리 사용

JdbcAggregationRepository 는 수집 된 메시지를 유지하는 AggregationRepository 입니다. 이렇게 하면 기본 집계자가 메모리에 AggregationRepository 만 사용하므로 메시지가 완화되지 않습니다. JdbcAggregationRepository 를 통해 Camel과 함께 Aggregator에 영구 지원을 제공할 수 있습니다.

Exchange가 성공적으로 처리된 경우에만 확인 메서드가 AggregationRepository 에서 호출될 때 발생하는 완료된 것으로 표시됩니다. 즉, 동일한 교환이 다시 실패하면 성공할 때까지 다시 시도됩니다.

옵션 maximumRedeliveries 를 사용하면 지정된 복구된 교환에 대한 최대 전송 시도 횟수를 제한할 수 있습니다. 또한 Camel이 최대Redeliveries 에 도달했을 때 교환을 보낼 위치를 알 수 있도록 deadLetterUri 옵션을 설정해야 합니다.

camel-sql 단위 테스트에서 몇 가지 예를 볼 수 있습니다(예: JdbcAggregateRecoverDeadLetterChannelTest.java).

48.15.1. 데이터베이스

작동을 위해 각 집계기에서는 집계 및 완료의 두 테이블을 사용합니다. 규칙에 따라 완료된 집계 이름은 "_COMPLETED" 가 접미사로 지정된 집계 이름과 동일합니다. 이름은 RepositoryName 속성을 사용하여 Spring 빈에 구성해야 합니다. 다음 예제 집계가 사용됩니다.

두 테이블의 테이블 구조 정의는 동일합니다: 두 경우 모두 String 값이 키 (id)로 사용 되는 반면 Blob에는 바이트 배열에서 직렬화 된 교환이 포함 되어 있습니다.
그러나 한 가지 차이점이 있어야 합니다. id 필드에는 테이블에 따라 동일한 콘텐츠가 없습니다.
집계 테이블 ID에는 메시지를 집계하기 위해 구성 요소에서 사용하는 상관 관계 Id가 있습니다. 완료된 테이블에서 id 는 해당 Blob 필드에 저장된 교환의 ID를 보유합니다.

다음은 테이블을 만드는 데 사용되는 SQL 쿼리입니다. "aggregation" 을 수집기 리포지토리 이름으로 교체합니다.

CREATE TABLE aggregation (
 id varchar(255) NOT NULL,
 exchange blob NOT NULL,
 version BIGINT NOT NULL,
 constraint aggregation_pk PRIMARY KEY (id)
);
CREATE TABLE aggregation_completed (
 id varchar(255) NOT NULL,
 exchange blob NOT NULL,
 version BIGINT NOT NULL,
 constraint aggregation_completed_pk PRIMARY KEY (id)
);

48.16. 본문과 헤더를 텍스트로 저장

메시지 본문을 저장하고 별도의 열에서 문자열(ed) 헤더를 선택하도록 JdbcAggregationRepository 를 구성할 수 있습니다. 예를 들어 본문을 저장하고 다음 두 개의 헤더 companyNameaccountName 은 다음 SQL을 사용합니다.

CREATE TABLE aggregationRepo3 (
 id varchar(255) NOT NULL,
 exchange blob NOT NULL,
 version BIGINT NOT NULL,
 body varchar(1000),
 companyName varchar(1000),
 accountName varchar(1000),
 constraint aggregationRepo3_pk PRIMARY KEY (id)
);
CREATE TABLE aggregationRepo3_completed (
 id varchar(255) NOT NULL,
 exchange blob NOT NULL,
 version BIGINT NOT NULL,
 body varchar(1000),
 companyName varchar(1000),
 accountName varchar(1000),
 constraint aggregationRepo3_completed_pk PRIMARY KEY (id)
);

그런 다음 아래와 같이 이 동작을 사용하도록 리포지토리를 구성합니다.

<bean id="repo3"
  class="org.apache.camel.processor.aggregate.jdbc.JdbcAggregationRepository">
  <property name="repositoryName" value="aggregationRepo3"/>
  <property name="transactionManager" ref="txManager3"/>
  <property name="dataSource" ref="dataSource3"/>
  <!-- configure to store the message body and following headers as text in the repo -->
  <property name="storeBodyAsText" value="true"/>
  <property name="headersToStoreAsText">
    <list>
      <value>companyName</value>
      <value>accountName</value>
    </list>
  </property>
</bean>

48.16.1. codec (Serialization)

모든 유형의 페이로드를 포함할 수 있으므로 교환은 디자인별로 직렬화할 수 없습니다. 데이터베이스 BLOB 필드에 저장할 바이트 배열로 변환됩니다. 이러한 모든 변환은 JdbcCodec 클래스에서 처리합니다. 코드에 대한 한 가지 세부 사항은 ClassLoadingAwareObjectInputStream 의 주의가 필요합니다.

ClassLoadingAwareObjectInputStreamApache ActiveMQ 프로젝트에서 재사용되었습니다. ObjectInputStream 을 래핑하고 현재Thread 가 아닌 ContextClassLoader 와 함께 사용합니다. 다른 번들에 의해 노출되는 클래스를 로드할 수 있다는 이점이 있습니다. 이를 통해 교환 본문과 헤더에 사용자 정의 유형 오브젝트 참조가 허용됩니다.

48.16.2. 트랜잭션

Spring PlatformTransactionManager 가 트랜잭션을 오케스트레이션해야 합니다.

48.16.2.1. 서비스(Start/Stop)

시작 방법은 데이터베이스의 연결과 필수 테이블이 있는지 확인합니다. 잘못된 것이 있으면 시작하는 동안 실패합니다.

48.16.3. 집계기 구성

대상 환경에 따라 집계기에 약간의 구성이 필요할 수 있습니다. 이미 알고 있듯이 각 집계기에는 자체 리포지토리(데이터베이스에서 생성된 해당 테이블 쌍)와 데이터 소스가 있어야 합니다. 기본 lobHandler가 데이터베이스 시스템에 적용되지 않으면 lobHandler 속성을 사용하여 삽입할 수 있습니다.

Oracle에 대한 선언은 다음과 같습니다.

<bean id="lobHandler" class="org.springframework.jdbc.support.lob.OracleLobHandler">
  <property name="nativeJdbcExtractor" ref="nativeJdbcExtractor"/>
</bean>
<bean id="nativeJdbcExtractor"
  class="org.springframework.jdbc.support.nativejdbc.CommonsDbcpNativeJdbcExtractor"/>
<bean id="repo"
  class="org.apache.camel.processor.aggregate.jdbc.JdbcAggregationRepository">
  <property name="transactionManager" ref="transactionManager"/>
  <property name="repositoryName" value="aggregation"/>
  <property name="dataSource" ref="dataSource"/>
  <!-- Only with Oracle, else use default -->
  <property name="lobHandler" ref="lobHandler"/>
</bean>

48.16.4. 최적의 잠금

여러 Camel 애플리케이션이 집계 리포지토리에 대해 동일한 데이터베이스를 공유하는 클러스터형 환경에서 optimisticLocking 을 켜고 이 JDBC 기반 집계 리포지토리를 사용할 수 있습니다. 경쟁 조건이 있는 경우 JDBC 드라이버는 JdbcAggregationRepository 가 응답할 수 있는 벤더별 예외가 발생합니다. JDBC 드라이버에서 예외가 발생한 것을 알려면 이 작업을 수행할 매퍼가 필요합니다. 따라서 org.apache.camel.processor.aggregate.jdbc.JdbcOptimisticLockingExceptionMapper 를 사용하면 필요한 경우 사용자 지정 논리를 구현할 수 있습니다. 다음과 같이 작동하는 기본 구현 org.apache.camel.processor.aggregate.jdbc.DefaultJdbcOptimisticLockingExceptionMapper 가 있습니다.

다음 검사가 완료되었습니다.

  • 발생한 예외가 SQLException 인 경우 SQLState는 23으로 시작하는 경우 확인됩니다.
  • 발생한 예외가 DataIntegrityViolationException인 경우
  • 발생한 예외 클래스 이름에 "ConstraintViolation"이 이름에 있는 경우.
  • 클래스 이름이 구성된 경우 FQN 클래스 이름에 대한 선택적 검사와 일치합니다.

또한 FQN 클래스 이름을 추가할 수 있으며 발생한 예외(또는 중첩) 중 하나라도 FQN 클래스 이름 중 하나와 같은 경우 optimistick 잠금 오류가 발생합니다.

다음은 JDBC 공급업체에서 2개의 추가 FQN 클래스 이름을 정의하는 예입니다.

<bean id="repo"
class="org.apache.camel.processor.aggregate.jdbc.JdbcAggregationRepository">
  <property name="transactionManager" ref="transactionManager"/>
  <property name="repositoryName" value="aggregation"/>
  <property name="dataSource" ref="dataSource"/>
  <property name="jdbcOptimisticLockingExceptionMapper" ref="myExceptionMapper"/>
</bean>
<!-- use the default mapper with extraFQN class names from our JDBC driver -->
<bean id="myExceptionMapper" class="org.apache.camel.processor.aggregate.jdbc.DefaultJdbcOptimisticLockingExceptionMapper">
  <property name="classNames">
    <util:set>
      <value>com.foo.sql.MyViolationExceptoion</value>
      <value>com.foo.sql.MyOtherViolationExceptoion</value>
    </util:set>
  </property>
</bean>

48.16.5. 전파 동작

JdbcAggregationRepository 는 Spring-TX의 두 가지 별도의 트랜잭션 템플릿을 사용합니다. 하나는 읽기 전용입니다.One is read-only and one is used for read-write operations.

그러나 < transacted / >를 사용하는 경로에 JdbcAggregationRepository 를 사용하고 사용되는 일반적인 PlatformTransactionManager 가 사용되는 경우 JdbcAggregationRepository 내부의 트랜잭션 템플릿에서 사용하는 전파 동작을 구성해야 할 수 있습니다.

이 작업을 수행하는 방법은 다음과 같습니다.

<bean id="repo"
class="org.apache.camel.processor.aggregate.jdbc.JdbcAggregationRepository">
  <property name="propagationBehaviorName" value="PROPAGATION_NESTED" />
</bean>

전파는 org.springframework.ECDHE.TransactionDefinition 인터페이스의 상수로 지정되므로, 전파 는 상수 이름을 사용할 수 있는 편리한 setter입니다.

48.16.6. PostgreSQL 사례

JdbcAggregationRepository 에서 사용하는 optimistic 잠금에 문제가 발생할 수 있는 특수 데이터베이스가 있습니다. PostgreSQL은 데이터 무결성 위반 예외(SQLState 23505)를 사용하는 경우 연결이 유효하지 않은 것으로 표시됩니다. 이로 인해 중첩된 트랜잭션 내에서 연결을 효과적으로 사용할 수 없게 됩니다. 자세한 내용은 문서에서 찾을 수 있습니다.

org.apache.camel.processor.aggregate.jdbc.PostgresAggregationRepositoryJdbcAggregationRepository 를 확장하고 특수 INSERT를 사용합니다. ON CONFLICT .. statement to provide optimistic locking behavior.

이 명령문은 (기본 집계 테이블 정의)입니다.

INSERT INTO aggregation (id, exchange) values (?, ?) ON CONFLICT DO NOTHING

자세한 내용은 PostgreSQL 문서에서 참조하십시오.

이 절을 사용하면 java.sql.PreparedStatement.executeUpdate() 호출이 SQLState=23505로 SQLException을 throw하는 대신 0 을 반환합니다. 추가 처리는 일반 JdbcAggregationRepository 와 정확히 동일하지만 PostgreSQL 연결을 유효하지 않음으로 표시하지 않습니다.

48.17. CamelECDHE Starter

Spring-boot 사용자가 starter 모듈을 사용할 수 있습니다. 시작자를 사용하는 경우 spring-boot 속성을 사용하여 DataSource 를 직접 구성할 수 있습니다.

# Example for a mysql datasource
spring.datasource.url=jdbc:mysql://localhost/test
spring.datasource.username=dbuser
spring.datasource.password=dbpass
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

이 기능을 사용하려면 Spring 부팅 pom.xml 파일에 다음 종속 항목을 추가합니다.

<dependency>
    <groupId>org.apache.camel.springboot</groupId>
    <artifactId>camel-sql-starter</artifactId>
    <version>${camel.version}</version> <!-- use the same version as your Camel core version -->
</dependency>

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jdbc</artifactId>
    <version>${spring-boot-version}</version>
</dependency>

필요한 경우 특정 데이터베이스 드라이버도 포함해야 합니다.

48.18. Spring Boot Auto-Configuration

Spring Boot와 함께 sql을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-sql-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.sql-stored.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.sql-stored.enabled

sql-stored 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.sql-stored.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.sql.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.sql.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.sql.enabled

sql 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.sql.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.sql.use-placeholder

자리 표시자를 사용하고 모든 자리 표시자 문자를 SQL 쿼리에 로그인할지 여부를 설정합니다.Sets whether to use placeholder and replace all placeholder characters with sign in the SQL queries. 이 옵션은 기본값 true입니다.

true

부울

49장. Stub

생산자 및 소비자 모두 지원

Stub 구성 요소는 개발 또는 테스트 중에 물리적 끝점을 스텁하는 간단한 방법을 제공하므로 특정 특정 SMTP 또는 HTTP 끝점에 실제로 연결하지 않고도 경로를 실행할 수 있습니다. 끝점 URI 앞에 stub: 를 추가하여 엔드포인트를 스텁으로 설정합니다.

내부적으로 Stub 구성 요소는 VM 끝점을 생성합니다. Stub와 VM 의 주요 차이점은 VM이 사용자가 제공하는 URI와 매개 변수를 검증한다는 것입니다. 따라서 vm:를 쿼리 인수를 사용하여 일반적인 URI 앞에 배치하면 일반적으로 실패합니다. 스텁은 기본적으로 모든 쿼리 매개변수를 무시하므로 경로의 하나 이상의 엔드포인트를 일시적으로 스텁할 수 있도록 합니다.

49.1. URI 형식

stub:someUri

여기서 someUri 는 쿼리 매개변수를 사용하여 임의의 URI일 수 있습니다.

49.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

49.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

49.2.1.1. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

49.3. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

concurrentConsumers (consumer)

기본 동시 스레드 처리 수를 설정합니다.

1

int

defaultPollTimeout (consumer (advanced))

폴링 시 사용되는 타임아웃(밀리초)입니다. 시간 초과가 발생하면 소비자는 계속 실행할 수 있는지 여부를 확인할 수 있습니다. 값을 낮게 설정하면 사용자가 종료 시 더 신속하게 대응할 수 있습니다.

1000

int

defaultBlockIfFull (producer)

메시지를 전체 SEDA 큐로 보내는 스레드는 큐의 용량이 더 이상 소진되지 않을 때까지 차단됩니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 호출 스레드가 대신 차단되고 메시지가 수락될 때까지 기다립니다.

false

boolean

기본Discard IfFull (producer)

메시지를 전체 SEDA 큐로 보내는 스레드가 삭제되는지의 여부입니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 호출 스레드가 전송 및 계속되므로 메시지가 SEDA 큐로 전송되지 않았습니다.

false

boolean

defaultOfferTimeout (producer)

메시지를 전체 SEDA 큐로 보내는 스레드는 큐의 용량이 더 이상 소진되지 않을 때까지 차단됩니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 구성된 시간 초과를 블록 케이스에 추가할 수 있습니다. Java 대기열의 .offer(timeout) 메서드를 사용합니다.

 

long

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

defaultQueueFactory (advanced)

기본 대기열 팩토리를 설정합니다.

 

BlockingQueueFactory

queueSize (advanced)

SEDA 대기열의 기본 최대 용량(즉, 보유할 수 있는 메시지 수)을 설정합니다.

1000

int

49.4. 끝점 옵션

Stub 끝점은 URI 구문을 사용하여 구성됩니다.

stub:name

다음과 같은 경로 및 쿼리 매개변수 사용:

49.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

이름 (common)

대기열 의 이름입니다.

 

문자열

49.4.2. 쿼리 매개변수(18 매개변수)

이름설명Default유형

크기 (공용)

SEDA 대기열의 최대 용량(즉, 보유할 수 있는 메시지 수) 기본적으로 SEDA 구성 요소에 설정된 defaultSize를 사용합니다.

1000

int

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

concurrentConsumers (consumer)

동시 스레드 처리 교환 수입니다.

1

int

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

limitConcurrentConsumers (consumer (advanced))

concurrentConsumers 수를 최대 500개로 제한할지 여부입니다. 끝점이 더 큰 숫자로 구성된 경우 기본적으로 예외가 발생합니다. 이 옵션을 끄면 해당 검사를 비활성화할 수 있습니다.

true

boolean

multipleConsumers (advanced)

여러 사용자가 허용되는지 여부를 지정합니다. 활성화된 경우 게시-서브스크립션 메시징에 SEDA를 사용할 수 있습니다. 즉, 메시지를 SEDA 큐에 보내고 각 소비자가 메시지 사본을 수신하도록 할 수 있습니다. 이 옵션을 활성화하면 모든 소비자 끝점에 지정해야 합니다.

false

boolean

pollTimeout (consumer(advanced))

폴링 시 사용되는 타임아웃(밀리초)입니다. 시간 초과가 발생하면 소비자는 계속 실행할 수 있는지 여부를 확인할 수 있습니다. 값을 낮게 설정하면 사용자가 종료 시 더 신속하게 대응할 수 있습니다.

1000

int

purgetimeStopping (consumer (advanced))

소비자/라우트를 중지할 때 작업 큐를 제거할지 여부입니다. 이렇게 하면 큐의 보류 중인 메시지가 모두 삭제되므로 더 빨리 중지할 수 있습니다.

false

boolean

blockIfFull (producer)

메시지를 전체 SEDA 큐로 보내는 스레드는 큐의 용량이 더 이상 소진되지 않을 때까지 차단됩니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 호출 스레드가 대신 차단되고 메시지가 수락될 때까지 기다립니다.

false

boolean

discardIfNoConsumers (producer)

생산자가 메시지를 삭제하든(메시지를 큐에 추가하지 않음) 활성 소비자가 없는 큐로 보낼 때입니다. 동시에 discardIfNoConsumers 및 failIfNoConsumers 옵션 중 하나만 활성화할 수 있습니다.

false

boolean

discardtimeFull (producer)

메시지를 전체 SEDA 큐로 보내는 스레드가 삭제되는지의 여부입니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 호출 스레드가 전송 및 계속되므로 메시지가 SEDA 큐로 전송되지 않았습니다.

false

boolean

failIfNoConsumers (producer)

활성 소비자가 없는 큐로 보낼 때 생산자가 예외를 throw하여 실패해야 하는지 여부입니다. 동시에 discardIfNoConsumers 및 failIfNoConsumers 옵션 중 하나만 활성화할 수 있습니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

offerTimeout (producer)

제안 시간 초과(밀리초)는 큐가 가득 찼을 때 블록 케이스에 추가할 수 있습니다. 0 또는 음수 값을 사용하여 타임아웃을 비활성화할 수 있습니다.

 

long

시간 초과 (producer)

SEDA 생산자가 비동기 작업이 완료될 때까지 대기 시간을 중지하기 전의 타임아웃(밀리초)입니다. 0 또는 음수 값을 사용하여 타임아웃을 비활성화할 수 있습니다.

30000

long

waitForTaskToComplete (producer)

호출자가 계속하기 전에 async 작업이 완료될 때까지 기다려야 하는지 여부를 지정하는 옵션입니다. 다음 세 가지 옵션이 지원됩니다. Always, Never 또는 IfReplyExpected. 처음 두 값은 자체 설명입니다. 마지막 값인 IfReplyExpected는 메시지가 Reply 기반 요청인 경우에만 대기합니다. 기본 옵션은 IfReplyExpected입니다.

CloudEvent 값:

  • Never
  • IfReplyExpected
  • Always

IfReplyExpected

WaitForTaskToComplete

대기열 (고급)

끝점에서 사용할 큐 인스턴스를 정의합니다.

 

BlockingQueue

49.5. 예

다음은 스텁 끝점 배리의 몇 가지 샘플입니다.

stub:smtp://somehost.foo.com?user=whatnot&something=else
stub:http://somehost.bar.com/something

49.6. Spring Boot Auto-Configuration

Spring Boot와 함께 stub를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-stub-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.stub.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.stub.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.stub.concurrent-consumers

기본 동시 스레드 처리 수를 설정합니다.

1

정수

camel.component.stub.default-block-when-full

메시지를 전체 SEDA 큐로 보내는 스레드는 큐의 용량이 더 이상 소진되지 않을 때까지 차단됩니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 호출 스레드가 대신 차단되고 메시지가 수락될 때까지 기다립니다.

false

부울

camel.component.stub.default-discard-when-full

메시지를 전체 SEDA 큐로 보내는 스레드가 삭제되는지의 여부입니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 호출 스레드가 전송 및 계속되므로 메시지가 SEDA 큐로 전송되지 않았습니다.

false

부울

camel.component.stub.default-offer-timeout

메시지를 전체 SEDA 큐로 보내는 스레드는 큐의 용량이 더 이상 소진되지 않을 때까지 차단됩니다. 기본적으로 큐가 가득 찼다는 예외는 throw됩니다.By default, an exception is thrown stating that the queue is full. 이 옵션을 활성화하면 구성된 시간 초과를 블록 케이스에 추가할 수 있습니다. Java 대기열의 .offer(timeout) 메서드를 사용합니다.

 

long

camel.component.stub.default-poll-timeout

폴링 시 사용되는 타임아웃(밀리초)입니다. 시간 초과가 발생하면 소비자는 계속 실행할 수 있는지 여부를 확인할 수 있습니다. 값을 낮게 설정하면 사용자가 종료 시 더 신속하게 대응할 수 있습니다.

1000

정수

camel.component.stub.default-queue-factory

기본 대기열 팩토리를 설정합니다. 옵션은 org.apache.camel.component.seda.BlockingQueueFactory<org.apache.camel.Exchange> 유형입니다.

 

BlockingQueueFactory

camel.component.stub.enabled

stub 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.stub.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.stub.queue-size

SEDA 대기열의 기본 최대 용량(즉, 보유할 수 있는 메시지 수)을 설정합니다.

1000

정수

50장. Telegram

생산자 및 소비자 모두 지원

Telegram 구성 요소는 Telegram Bot API 에 대한 액세스를 제공합니다. Camel 기반 애플리케이션에서는 일반 사용자, 개인 및 공용 그룹 또는 채널과 직접 대화함으로써 메시지를 전송 및 수신할 수 있습니다.

이 구성 요소를 사용하기 전에 Telegram Bot를 만들어야 하며 Telegram Bot 개발자 홈의 지침을 따르십시오. 새 Bot가 생성되면 BotFather 는 Bot에 해당하는 권한 부여 토큰 을 제공합니다. 권한 부여 토큰은 camel-telegram 엔드포인트의 필수 매개 변수입니다.

참고

Bot가 그룹 또는 채널('/' 문자로 시작하는 메시지뿐만 아니라)에서 교환된 모든 메시지를 수신하도록 허용하려면 BotFather에 /set privacy 명령을 사용하여 개인 정보 보호 모드를 비활성화 하도록 요청합니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-telegram</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

50.1. URI 형식

telegram:type[?options]

50.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

50.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

50.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

50.3. 구성 요소 옵션

Telegram 구성 요소는 아래에 나열된 7 옵션을 지원합니다.

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

baseUri (advanced)

mock Telegram API에 대해 구성 요소를 테스트하려는 경우와 같이 대체 기본 URI를 설정하는 데 사용할 수 있습니다.

 

문자열

클라이언트 (고급)

사용자 정의 AsyncHttpClient를 사용하려면 다음을 수행합니다.

 

AsyncHttpClient

clientConfig (advanced)

사용자 지정 com.ning.http.client.AsyncHttpClientConfig 인스턴스를 사용하도록 AsyncHttpClient를 구성하려면 다음을 수행합니다.

 

AsyncHttpClientConfig

authorizationToken (security)

엔드포인트에 정보가 제공되지 않을 때 사용할 기본 Telegram 권한 부여 토큰입니다.

 

문자열

50.4. 끝점 옵션

Telegram 엔드포인트는 URI 구문을 사용하여 구성됩니다.

telegram:type

다음과 같은 경로 및 쿼리 매개변수 사용:

50.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

유형 (공용)

필수 끝점 유형입니다. 현재는 'bots' 유형만 지원됩니다.

CloudEvent 값:

  • bots
 

문자열

50.4.2. 쿼리 매개변수(30 매개변수)

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

제한 (consumer)

단일 폴링 요청에서 수신할 수 있는 업데이트 수에 대한 제한입니다.

100

정수

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

시간 초과 (consumer)

폴링 시간(초)입니다. 짧은 폴링 또는 긴 폴링을 위해 더 큰 수를 위해 0을 넣습니다. 긴 폴링을 통해 응답 시간이 단축됩니다.

30

정수

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

chatId (producer)

생성된 메시지를 수신할 채팅의 식별자입니다. 채팅 ID는 먼저 수신 메시지에서 얻을 수 있습니다 (예: Telegram 사용자가 봇과 대화를 시작할 때 클라이언트는 채팅 ID를 포함하는 '/start' 메시지를 자동으로 보냅니다. 채팅 ID는 본문 또는 헤더를 사용하여 각 발신 메시지에 대해 동적으로 설정할 수 있으므로 선택적 매개변수입니다.

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

baseUri (advanced)

mock Telegram API에 대해 구성 요소를 테스트하려는 경우와 같이 대체 기본 URI를 설정하는 데 사용할 수 있습니다.

 

문자열

bufferSize (advanced)

Camel과 AHC 클라이언트 간에 데이터를 전송할 때 사용되는 초기 메모리 내 버퍼 크기입니다.

4096

int

clientConfig (advanced)

사용자 지정 com.ning.http.client.AsyncHttpClientConfig 인스턴스를 사용하도록 AsyncHttpClient를 구성하려면 다음을 수행합니다.

 

AsyncHttpClientConfig

proxyHost (proxy)

메시지를 보낼 때 사용할 수 있는 HTTP 프록시 호스트입니다.

 

문자열

proxyPort (proxy)

메시지를 보낼 때 사용할 수 있는 HTTP 프록시 포트입니다.

 

정수

proxyType (proxy)

메시지를 보낼 때 사용할 수 있는 HTTP 프록시 유형입니다.

CloudEvent 값:

  • HTTP
  • SOCKS4
  • SOCKS5

HTTP

TelegramProxyType

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

authorizationToken (security)

봇을 사용하기 위한 권한 부여 토큰( BotFather 마스크)이 필요합니다.

 

문자열

50.4.3. 메시지 헤더

이름설명

CamelTelegramChatId

이 헤더는 메시지를 수신할 채팅 ID를 해결하기 위해 프로듀서 끝점에서 사용합니다. 수신자 채팅 ID를 메시지 본문, CamelTelegramChatId 헤더 또는 엔드포인트 구성(chatId 옵션)에 배치할 수 있습니다. 이 헤더는 모든 수신되는 메시지에도 존재합니다.

CamelTelegramMediaType

이 헤더는 발신 메시지가 순수 바이너리 데이터로 구성된 경우 미디어 유형을 식별하는 데 사용됩니다. 가능한 값은 org.apache.camel.component.telegram.TelegramTypeAttribute에 속하는 string 또는 10.0.0.1 값입니다.

CamelTelegramMediaTitleCaption

이 헤더는 발신 바이너리 메시지에 대한 title 또는 title을 제공하는 데 사용됩니다.

CamelTelegramParseMode

이 헤더는 HTML 또는 Markdown을 사용하여 텍스트 메시지를 포맷하는 데 사용됩니다 ( org.apache.camel.component.telegram.TelegramParseMode참조).

50.5. 사용법

Telegram 구성 요소는 소비자 및 생산자 엔드 포인트를 모두 지원합니다. 또한 reactive chat-bot 모드에서 사용할 수도 있습니다(사용 후 메시지 생성).

50.6. 생산자 예

다음은 Telegram Bot API를 통해 Telegram 채팅에 메시지를 보내는 방법의 기본적인 예입니다.

in Java DSL

from("direct:start").to("telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere");

Spring XML에서

<route>
    <from uri="direct:start"/>
    <to uri="telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere"/>
<route>

코드 123456789:insertECDHEAuthorizationToken here 은 Bot에 해당하는 권한 부여 토큰 입니다.

채팅 ID 옵션을 지정하지 않고 생산자 끝점을 사용하는 경우 메시지의 본문 또는 헤더에 포함된 정보를 사용하여 대상 채팅을 식별합니다. 다음 메시지 본문에서 생산자 엔드포인트에 대해 허용됩니다(OutgoingXXXMessage 유형의 OutgoingXXXMessage 는 패키지 org.apache.camel.component.telegram.model)

Java Type설명

OutgoingTextMessage

문자 메시지를 채팅으로 보내려면

OutgoingPhotoMessage

How to send a photo (JPG, PNG) to a chat

OutgoingAudioMessage

HAG3에 대해 HAG3를 보내는 방법

OutgoingVideoMessage

채팅에 HSM4 비디오 전송

OutgoingDocumentMessage

파일을 채팅으로 보내려면 (모든 미디어 유형)

OutgoingStickerMessage

브릿지를 채팅에 보내려면 ( IRQP)

OutgoingAnswerInlineQuery

인라인 쿼리에 응답 보내기

EditMessageTextMessage

텍스트 및 게임 메시지를 편집하려면 (editMessageDiscovery)

EditMessageCaptionMessage

메시지의 압축을 편집하려면 (editMessageCaption)

EditMessageMediaMessage

애니메이션, 음성, 문서, 프로필 또는 비디오 메시지를 편집하려면 다음을 수행하십시오. (editMessageMedia)

EditMessageReplyMarkupMessage

메시지의 응답 태그만 편집하려면 (editMessageReplyMarkup)

EditMessageDelete

서비스 메시지를 포함한 메시지를 삭제하려면 다음을 수행합니다. (삭제Message)

SendLocationMessage

위치 보내기 (setSendLocation)

EditMessageLiveLocationMessage

라이브 위치에 변경 사항을 보내려면 (editMessageLiveLocation)

StopMessageLiveLocationMessage

live_period가 만료되기 전에 봇 또는 봇을 통해 전송한 실시간 위치 메시지 업데이트를 중지하려면 (stopMessageLiveLocation)

SendVenueMessage

관련 정보를 보내려면 (sendVenue)

byte[]

지원되는 모든 미디어 유형을 보냅니다. CamelTelegramMediaType 헤더를 적절한 미디어 유형으로 설정해야 합니다.

문자열

메시지를 채팅으로 보냅니다. 이 파일은 자동으로 OutgoingDiscoveryMessage로 변환됩니다.

50.7. 소비자 예

다음은 Telegram 사용자가 구성된 Bot로 보내는 모든 메시지를 수신하는 방법의 기본 예입니다. In Java DSL

from("telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere")
.bean(ProcessorBean.class)

Spring XML에서

<route>
    <from uri="telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere"/>
    <bean ref="myBean" />
<route>

<bean id="myBean" class="com.example.MyBean"/>

MyBean 은 메시지를 수신할 간단한 빈입니다.

public class MyBean {

    public void process(String message) {
        // or Exchange, or org.apache.camel.component.telegram.model.IncomingMessage (or both)

        // do process
    }

}

수신 메시지에 지원되는 유형은 다음과 같습니다.

Java Type설명

IncomingMessage

수신되는 메시지의 전체 오브젝트 표현

문자열

문자 메시지 전용 메시지의 콘텐츠

50.8. reactiveovn-Bot 예제

reactive chat-bot 모드는 Camel 구성 요소를 사용하여 Telegram 사용자가 받은 채팅 메시지에 직접 응답하는 간단한 채팅 봇을 구축하는 간단한 방법입니다.

다음은 Java DSL의 chat-bot의 기본 구성입니다.

from("telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere")
.bean(ChatBotLogic.class)
.to("telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere");

Spring XML에서

<route>
    <from uri="telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere"/>
    <bean ref="chatBotLogic" />
    <to uri="telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere"/>
<route>

<bean id="chatBotLogic" class="com.example.ChatBotLogic"/>

ovn BotLogic 은 일반 String-to-String 메서드를 구현하는 간단한 빈입니다.

public class ChatBotLogic {

    public String chatBotProcess(String message) {
        if( "do-not-reply".equals(message) ) {
            return null; // no response in the chat
        }

        return "echo from the bot: " + message; // echoes the message
    }

}

chatBotProcess 메서드에서 반환한 모든 null 이외의 문자열은 요청을 시작한 채팅으로 자동 라우팅됩니다( CamelTelegramChatId 헤더가 메시지를 라우팅할 때).

50.9. Chrony ID 가져오기

이벤트가 발생할 때 특정 Telegram 채팅에 메시지를 푸시하려면 해당 채팅 ID를 검색해야 합니다. 채팅 ID는 현재 Telegram 클라이언트에 표시되지 않지만 간단한 경로를 사용하여 가져올 수 있습니다.

먼저 메시지를 푸시할 채팅에 봇을 추가한 다음 다음과 같은 경로를 실행합니다.

from("telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere")
.to("log:INFO?showHeaders=true");

봇에서 수신한 모든 메시지는 채팅(CamelTelegramChatId ) 헤더와 함께 로그로 덤프됩니다.

대화 ID가 표시되면 다음 샘플 경로를 사용하여 메시지를 푸시할 수 있습니다.

from("timer:tick")
.setBody().constant("Hello")
to("telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere&chatId=123456")

해당 URI 매개변수는 간단히 chatId 입니다.

50.10. 키보드 사용자 정의

옵션을 작성하도록 요청하는 대신 사용자 키보드를 사용자 지정할 수 있습니다. OutgoingDiscoveryMessage 에는 이러한 작업에 사용할 수 있는 ReplyMarkup 속성이 있습니다.

from("telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere")
    .process(exchange -> {

        OutgoingTextMessage msg = new OutgoingTextMessage();
        msg.setText("Choose one option!");

        InlineKeyboardButton buttonOptionOneI = InlineKeyboardButton.builder()
                .text("Option One - I").build();

        InlineKeyboardButton buttonOptionOneII = InlineKeyboardButton.builder()
                .text("Option One - II").build();

        InlineKeyboardButton buttonOptionTwoI = InlineKeyboardButton.builder()
                .text("Option Two - I").build();

        ReplyKeyboardMarkup replyMarkup = ReplyKeyboardMarkup.builder()
                .keyboard()
                    .addRow(Arrays.asList(buttonOptionOneI, buttonOptionOneII))
                    .addRow(Arrays.asList(buttonOptionTwoI))
                    .close()
                .oneTimeKeyboard(true)
                .build();

        msg.setReplyMarkup(replyMarkup);

        exchange.getIn().setBody(msg);
    })
    .to("telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere");

이 기능을 사용하지 않도록 설정하려면 다음 메시지에는 ReplyKeyboardMarkup 개체에 속성 removeKeyboard 가 설정되어 있어야 합니다.

from("telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere")
    .process(exchange -> {

        OutgoingTextMessage msg = new OutgoingTextMessage();
        msg.setText("Your answer was accepted!");

        ReplyKeyboardMarkup replyMarkup = ReplyKeyboardMarkup.builder()
                .removeKeyboard(true)
                .build();

        msg.setReplyKeyboardMarkup(replyMarkup);

        exchange.getIn().setBody(msg);
    })
    .to("telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere");

50.11. Webhook 모드

Telegram 구성 요소는 camel- webhook 구성 요소를 사용하여 Webhook 모드에서 사용을 지원합니다.

웹 후크 모드를 활성화하려면 먼저 애플리케이션에 REST 구현을 추가해야 합니다. 예를 들어 Maven 사용자는 pom.xml 파일에 netty-http 를 추가할 수 있습니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-netty-http</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

완료되면 사용하려는 telegram URI에 Webhook URI를 추가해야 합니다.

In Java DSL:

from("webhook:telegram:bots?authorizationToken=123456789:insertYourAuthorizationTokenHere").to("log:info");

일부 끝점은 애플리케이션에 의해 노출되며 Telegram은 메시지를 전송하도록 구성됩니다. 서버가 인터넷에 노출되었는지 확인하고 camel.component.webhook.configuration.webhook-external-url 속성의 올바른 값을 전달해야 합니다.

설정하는 방법에 대한 지침은 camel-webhook 구성 요소 설명서를 참조하십시오.

50.12. Spring Boot Auto-Configuration

Spring Boot에서 Telegram을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-telegram-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.telegram.authorization-token

엔드포인트에 정보가 제공되지 않을 때 사용할 기본 Telegram 권한 부여 토큰입니다.

 

문자열

camel.component.telegram.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.telegram.base-uri

mock Telegram API에 대해 구성 요소를 테스트하려는 경우와 같이 대체 기본 URI를 설정하는 데 사용할 수 있습니다.

 

문자열

camel.component.telegram.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.telegram.client

사용자 정의 AsyncHttpClient를 사용하려면 다음을 수행합니다. 옵션은 org.asynchttpclient.AsyncHttpClient 유형입니다.

 

AsyncHttpClient

camel.component.telegram.client-config

사용자 지정 com.ning.http.client.AsyncHttpClientConfig 인스턴스를 사용하도록 AsyncHttpClient를 구성하려면 다음을 수행합니다. 옵션은 org.asynchttpclient.AsyncHttpClientConfig 유형입니다.

 

AsyncHttpClientConfig

camel.component.telegram.enabled

전보 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.telegram.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

51장. timer

소비자만 지원됩니다.

Timer 구성 요소는 타이머가 실행되었을 때 메시지 교환을 생성하는 데 사용됩니다. 이 끝점의 이벤트만 사용할 수 있습니다.

51.1. URI 형식

timer:name[?options]

여기서 name 은 끝점 간에 생성되고 공유되는 Timer 오브젝트의 이름입니다. 따라서 모든 타이머 끝점에 동일한 이름을 사용하는 경우 하나의 Timer 개체 및 스레드만 사용됩니다.

참고

생성된 교환의 IN 본문은 null 입니다. So exchange.getIn().getBody() returns null.

참고

고급 스케줄러
고급 스케줄러 고급 스케줄링을 지원하는 Quartz 구성 요소도 참조하십시오.

51.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

51.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

51.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

51.3. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

51.4. 끝점 옵션

Timer 끝점은 URI 구문을 사용하여 구성됩니다.

timer:timerName

다음과 같은 경로 및 쿼리 매개변수 사용:

51.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

timerName (consumer)

타이머 의 이름이 필요합니다.

 

문자열

51.4.2. 쿼리 매개변수(13 매개변수)

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

delay (consumer)

첫 번째 이벤트가 트리거되기 전에 지연됩니다.

1000

long

fixedRate (consumer)

이벤트는 지정된 기간으로 구분된 대략 정기적으로 수행됩니다.

false

boolean

includeMetadata (consumer)

실행 시간, 타이머 이름, 타이머 수 등과 같은 교환에 메타데이터를 포함할지 여부입니다. 이 정보는 기본적으로 포함되어 있습니다.

true

boolean

기간 (consumer)

0보다 큰 경우 모든 기간마다 정기적인 이벤트를 생성합니다.

1000

long

repeatCount (consumer)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 타이머가 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

 

long

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

데몬 (advanced)

타이머 끝점과 연결된 스레드가 데몬으로 실행되는지 여부를 지정합니다. 기본값은 true입니다.

true

boolean

패턴 (고급)

URI 구문을 사용하여 time 옵션을 설정하는 데 사용할 사용자 지정 날짜 패턴을 지정할 수 있습니다.

 

문자열

동기 (고급)

동기 처리를 엄격하게 사용해야 하는지 여부를 설정합니다.

false

boolean

시간 (advanced)

첫 번째 이벤트가 생성되어야 하는 java.util.Date URI를 사용하는 경우 예상되는 패턴은 yyyy-MM-dd HH:mm:ss 또는 yyyy-MM-dd'THH:mm:ss입니다.

 

날짜

타이머 (고급)

사용자 정의 타이머를 사용합니다.

 

timer

51.5. 교환 속성

타이머가 실행되면 다음 정보를 교환에 속성으로 추가합니다.

이름유형설명

Exchange.TIMER_NAME

문자열

name 옵션의 값입니다.

Exchange.TIMER_TIME

날짜

시간 옵션의 값입니다.

Exchange.TIMER_PERIOD

long

period 옵션의 값입니다.

Exchange.TIMER_FIRED_TIME

날짜

고객이 퇴사했을 때입니다.

Exchange.TIMER_COUNTER

long

현재 API 카운터입니다. 1에서 시작합니다.

51.6. sample

60초마다 이벤트를 생성하는 경로를 설정하려면 다음을 수행합니다.

from("timer://foo?fixedRate=true&period=60000").to("bean:myBean?method=someMethodName");

위의 경로는 이벤트를 생성한 다음 레지스트리의 myBean 이라는 빈에서 someMethodName 메서드를 호출합니다.

Spring DSL의 경로:

<route>
  <from uri="timer://foo?fixedRate=true&amp;period=60000"/>
  <to uri="bean:myBean?method=someMethodName"/>
</route>

51.7. 최대한 빨리 실행

Camel 2.17 이후

부정적인 지연을 사용할 수 있는 한 빨리 Camel 경로에서 메시지를 실행하려고 할 수 있습니다.

<route>
  <from uri="timer://foo?delay=-1"/>
  <to uri="bean:myBean?method=someMethodName"/>
</route>

이 경우 타이머는 즉시 메시지를 실행합니다.

고정된 숫자에 도달한 후 메시지를 중지하기 위해 음수 지연과 함께 repeatCount 매개변수를 지정할 수도 있습니다.

repeatCount를 지정하지 않으면 경로가 중지될 때까지 타이머는 메시지가 계속 실행됩니다.

51.8. 한 번만 실행

경로를 시작할 때와 같이 Camel 경로에서 메시지를 한 번만 실행할 수 있습니다. 이렇게 하려면 다음과 같이 repeatCount 옵션을 사용합니다.

<route>
  <from uri="timer://foo?repeatCount=1"/>
  <to uri="bean:myBean?method=someMethodName"/>
</route>

51.9. Spring Boot Auto-Configuration

Spring Boot와 함께 timer를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-timer-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.timer.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.timer.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.timer.enabled

타이머 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

52장. validator

프로듀서만 지원됩니다.

유효성 검사 구성 요소는>-<P Validation API를 사용하고 지원되는 XML 스키마 언어를 기반으로 메시지 본문의 XML유효성 검사를 수행합니다.

구성 요소는 다음과 같은 유용한 스키마 언어도 지원합니다.

MSV 구성 요소는 RelaxECDHE XML Syntax 도 지원합니다.

52.1. URI 형식

validator:someLocalOrRemoteResource

여기서 someLocalOrRemoteResource 는 classpath의 로컬 리소스에 대한 일부 URL이거나 유효성을 검사할 XSD가 포함된 파일 시스템의 원격 리소스 또는 리소스에 대한 전체 URL입니다. 예를 들면 다음과 같습니다.

  • msv:org/foo/bar.xsd
  • msv:file:../foo/bar.xsd
  • msv:http://acme.com/cheese.xsd
  • validator:com/mypackage/myschema.xsd

유효성 검사 구성 요소는 camel-core에서 직접 제공됩니다.

52.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

52.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

52.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

52.3. 구성 요소 옵션

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

이름설명Default유형

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

resourceResolverFactory (advanced)

동적 엔드포인트 리소스 URI에 따라 달라지는 사용자 지정 LSResourceResolver를 사용합니다.

 

ValidatorResourceResolverFactory

52.4. 끝점 옵션

Validator 끝점은 URI 구문을 사용하여 구성됩니다.

validator:resourceUri

다음과 같은 경로 및 쿼리 매개변수 사용:

52.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

resourceUri (producer)

classpath의 로컬 리소스에 URL 또는 레지스트리의 빈을 조회하는 참조 또는 유효성을 검사할 XSD가 포함된 파일 시스템의 원격 리소스 또는 리소스에 대한 전체 URL이 필요합니다.

 

문자열

52.4.2. 쿼리 매개변수(10 매개변수)

이름설명Default유형

failOnNullBody (producer)

실패가 없으면 본문이 존재하지 않습니다.

true

boolean

failOnNullHeader (producer)

헤더에 대해 유효성을 검사할 때 헤더가 없는 경우 실패 여부입니다.

true

boolean

HeaderName (producer)

메시지 본문 대신 헤더에 대해 유효성을 검사합니다.

 

문자열

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

errorHandler (advanced)

사용자 정의 org.apache.camel.processor.validation.ValidatorErrorHandler를 사용하려면 다음을 수행합니다. 기본 오류 처리기는 오류를 캡처하고 예외를 throw합니다.

 

ValidatorErrorHandler

resourceResolver (advanced)

사용자 지정 LSResourceResolver를 사용합니다. resourceResolverFactory와 함께 사용하지 마십시오.

 

LSResourceResolver

resourceResolverFactory (advanced)

동적 엔드포인트 리소스 URI에 따라 달라지는 사용자 지정 LSResourceResolver를 사용합니다. 기본 리소스 해석기 팩토리에서 클래스 경로 및 파일 시스템에서 파일을 읽을 수 있는 리소스 해결 프로그램을 복구합니다. resourceResolver와 함께 사용하지 마십시오.

 

ValidatorResourceResolverFactory

schemaFactory (advanced)

사용자 정의 javax.xml.validation.SchemaFactory를 사용합니다.

 

SchemaFactory

schema> -< (advanced)

W3C XML 스키마 네임스페이스 URI를 구성합니다.

http://www.w3.org/2001/XMLSchema

문자열

useSharedSchema (advanced)

Schema 인스턴스를 공유할지 여부입니다. 이 옵션은 JDK 1.6.x 버그를 해결하기 위해 도입되었습니다. Xerces는 이 문제가 없어야 합니다.

true

boolean

52.5. 예제

다음 예제에서는 엔드포인트 direct:start 에서 경로를 구성하는 방법을 보여줍니다. 이 끝점은 XML이 지정된 스키마(classpath에 제공됨)와 일치하는지 여부에 따라 mock:valid 또는 mock:invalid 의 두 끝점 중 하나로 이동합니다.

52.6. 고급: way clearCachedSchema

유효성 검사기 끝점의 캐시된 스키마를 지우고 10.0.0.1 작업 clearCachedSchema 를 사용하여 다음 프로세스 호출로 다시 읽을 수 있습니다. 이 방법을 사용하여 캐시를 프로그래밍 방식으로 지울 수도 있습니다. 이 방법은 ValidatorEndpoint 클래스에서 사용할 수 있습니다.

52.7. Spring Boot Auto-Configuration

Spring Boot에서 validator를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-validator-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.validator.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.validator.enabled

유효성 검사기 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.validator.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.validator.resource-resolver-factory

동적 엔드포인트 리소스 URI에 따라 달라지는 사용자 지정 LSResourceResolver를 사용합니다. 옵션은 org.apache.camel.component.validator.ValidatorResourceResolverFactory 유형입니다.

 

ValidatorResourceResolverFactory

53장. Webhook

소비자만 지원됩니다.

Webhook 메타 구성 요소를 사용하면 다른 Camel 구성 요소가 원격 웹 후크 공급자에서 Webhook를 구성하고 수신 대기할 수 있습니다.

현재 다음 구성 요소는 Webhook 끝점을 제공합니다.

  • Telegram

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가할 수 있습니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-webhook</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

일반적으로 Webhook를 지원하는 다른 구성 요소는 이 종속성을 전송하여 제공합니다.

53.1. URI 형식

webhook:endpoint[?options]

53.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

53.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

53.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

53.3. 구성 요소 옵션

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

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

webhookAutoRegister (consumer)

시작 시 Webhook를 자동으로 등록하고 종료 시 등록 취소합니다.

true

boolean

webhookBasePath (consumer)

Webhook가 노출될 첫 번째(base) 경로 요소입니다. 인증되지 않은 당사자가 추측할 수 없도록 임의의 문자열로 설정하는 것이 좋습니다.

 

문자열

webhookComponentName (consumer)

netty-http와 같이 REST 전송에 사용할 Camel Rest 구성 요소입니다.

 

문자열

webhookExternalUrl (consumer)

Webhook 공급자에 표시되는 현재 서비스의 URL입니다.

 

문자열

webhookPath (consumer)

웹 후크 끝점이 노출되는 경로입니다(basePath가 있는 경우 참조).

 

문자열

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

구성 (고급)

웹 후크 메타 구성 요소의 기본 구성을 설정합니다.

 

WebhookConfiguration

53.4. 끝점 옵션

Webhook 끝점은 URI 구문을 사용하여 구성됩니다.

webhook:endpointUri

다음과 같은 경로 및 쿼리 매개변수 사용:

53.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

endpointUri (consumer)

위임장 배지는 필수입니다. Webhook를 지원하는 구성 요소에 속해야 합니다.

 

문자열

53.4.2. 쿼리 매개변수 (8 매개변수)

이름설명Default유형

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

webhookAutoRegister (consumer)

시작 시 Webhook를 자동으로 등록하고 종료 시 등록 취소합니다.

true

boolean

webhookBasePath (consumer)

Webhook가 노출될 첫 번째(base) 경로 요소입니다. 인증되지 않은 당사자가 추측할 수 없도록 임의의 문자열로 설정하는 것이 좋습니다.

 

문자열

webhookComponentName (consumer)

netty-http와 같이 REST 전송에 사용할 Camel Rest 구성 요소입니다.

 

문자열

webhookExternalUrl (consumer)

Webhook 공급자에 표시되는 현재 서비스의 URL입니다.

 

문자열

webhookPath (consumer)

웹 후크 끝점이 노출되는 경로입니다(basePath가 있는 경우 참조).

 

문자열

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

53.5. 예

웹 후크 구성 요소의 예는 이를 지원하는 위임 구성 요소의 설명서에서 제공됩니다.

53.6. Spring Boot Auto-Configuration

Spring Boot와 함께 Webhook를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-webhook-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.component.webhook.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.webhook.bridge-error-handler

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

부울

camel.component.webhook.configuration

웹 후크 메타 구성 요소의 기본 구성을 설정합니다. 옵션은 org.apache.camel.component.webhook.WebhookConfiguration 유형입니다.

 

WebhookConfiguration

camel.component.webhook.enabled

웹 후크 구성 요소에 대한 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.webhook.webhook-auto-register

시작 시 Webhook를 자동으로 등록하고 종료 시 등록 취소합니다.

true

부울

camel.component.webhook.webhook-base-path

Webhook가 노출될 첫 번째(base) 경로 요소입니다. 인증되지 않은 당사자가 추측할 수 없도록 임의의 문자열로 설정하는 것이 좋습니다.

 

문자열

camel.component.webhook.webhook-component-name

netty-http와 같이 REST 전송에 사용할 Camel Rest 구성 요소입니다.

 

문자열

camel.component.webhook.webhook-external-url

Webhook 공급자에 표시되는 현재 서비스의 URL입니다.

 

문자열

camel.component.webhook.webhook-path

웹 후크 끝점이 노출되는 경로입니다(basePath가 있는 경우 참조).

 

문자열

54장. XSLT

프로듀서만 지원됩니다.

XSLT 구성 요소를 사용하면 XSLT 템플릿을 사용하여 메시지를 처리할 수 있습니다. 이는 Templating을 사용하여 요청에 대한 응답을 생성할 때 이상적입니다.

54.1. URI 형식

xslt:templateName[?options]

URI 형식에는 다음 중 하나일 수 있는 templateName 이 포함됩니다.

  • 호출할 템플릿의 classpath-local URI
  • 원격 템플릿의 전체 URL입니다.

다음 형식의 URI에 쿼리 옵션을 추가할 수 있습니다.

?option=value&option=value&…​

표 54.1. 표 1. URI 예

URI설명

xslt:com/acme/mytransform.xsl

classpath의 com/acme/mytransform.xsl 파일을 나타냅니다.

xslt:file:///foo/bar.xsl

파일 /foo/bar.xsl을 나타냅니다.

xslt:http://acme.com/cheese/foo.xsl

원격 http 리소스 참조

54.2. 옵션 구성

Camel 구성 요소는 두 가지 수준으로 구성됩니다.

  • 구성 요소 수준
  • 끝점 수준

54.2.1. 구성 요소 옵션 구성

구성 요소 수준은 끝점에서 상속하는 일반 및 공통 구성을 보유한 최상위 수준입니다. 예를 들어, 구성 요소에는 보안 설정, 인증에 대한 자격 증명, 네트워크 연결용 URL 등이 있을 수 있습니다.

일부 구성 요소에는 몇 가지 옵션만 있으며 다른 구성 요소에는 여러 옵션이 있을 수 있습니다. 구성 요소에는 일반적으로 일반적으로 사용되는 미리 구성된 기본값이 있으므로 구성 요소에서 몇 가지 옵션만 구성하거나 전혀 구성하지 않는 경우가 있습니다.

구성 요소 DSL, 구성 파일(application.properties|yaml)을 사용하거나 Java 코드로 직접 구성 요소를 구성하여 수행할 수 있습니다.

54.2.2. 엔드 포인트 옵션 구성

끝점에 가장 많은 옵션이 포함되어 있으므로 끝점에 가장 많은 구성이 있는 경우 끝점에서 수행할 작업을 구성할 수 있습니다. 또한 옵션은 끝점이 소비자(from)로 사용되는지 또는 생산자(to)로 사용되는지 또는 둘 다에 사용되는지로 분류됩니다.

끝점 구성은 대부분 끝점 URI에서 경로 및 쿼리 매개변수로 직접 수행됩니다. 끝점 DSL을 끝점을 안전한 유형의 보안 방법으로 사용할 수도 있습니다.

옵션을 설정할 때는 속성 platformholders를 사용하는 것이 좋습니다.이를 사용하면 URL, 포트 번호, 민감한 정보 및 기타 설정을 하드 코드 할 수 없습니다. 즉 자리 표시자를 사용하면 코드에서 구성을 외부화할 수 있으며 더 많은 유연성과 재사용이 가능합니다.

다음 두 섹션에는 먼저 구성 요소 다음에 대한 모든 옵션이 나열되어 있습니다.

54.3. 구성 요소 옵션

XSLT 구성 요소는 아래에 나열된 7 옵션을 지원합니다.

이름설명Default유형

contentCache (producer)

리소스 콘텐츠가 로드될 때 리소스 콘텐츠(스타일시트 파일)에 대한 캐시입니다. false Camel로 설정하면 각 메시지 처리에 스타일시트 파일이 다시 로드됩니다. 이는 개발에 좋습니다. 캐시된 스타일 워크시트는 clearCachedStylechart 작업을 사용하여 runtime에서 다시 로드하도록 강제할 수 있습니다.

true

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

transformerFactoryClass (advanced)

사용자 지정 XSLT 변환기 팩토리를 사용하려면 FQN 클래스 이름으로 지정됩니다.

 

문자열

transformerFactoryConfigurationStrategy (advanced)

새로 생성된 TransformerFactory 인스턴스에 적용할 구성 전략입니다.

 

TransformerFactoryConfigurationStrategy

URIResolver (advanced)

사용자 정의 UriResolver를 사용합니다. 'uriResolverFactory' 옵션과 함께 사용하면 안 됩니다.

 

URIResolver

uriResolverFactory (advanced)

동적 엔드포인트 리소스 URI에 따라 달라지는 사용자 정의 UriResolver를 사용합니다. 'uriResolver' 옵션과 함께 사용하면 안 됩니다.

 

XsltUriResolverFactory

54.4. 끝점 옵션

XSLT 끝점은 URI 구문을 사용하여 구성됩니다.

xslt:resourceUri

다음과 같은 경로 및 쿼리 매개변수 사용:

54.4.1. 경로 매개변수(1 매개변수)

이름설명Default유형

resourceUri (producer)

템플릿에 필요한 경로입니다. 다음은 기본 URIResolver에서 지원합니다. classpath, file, http, ref, or blank. classpath, file 및 http 접두사를 사용하면 이러한 프로토콜을 사용하여 리소스를 로드할 수 있습니다(classpath는 기본임). ref는 레지스트리의 리소스를 조회합니다.PLAN은 빈에서 리소스를 호출하여 resources로 사용할 수 있습니다. 빈의 경우 dot 뒤에 메서드 이름을 지정할 수 있습니다. eglan:myBean.myMethod.

 

문자열

54.4.2. 쿼리 매개변수(13 매개변수)

이름설명Default유형

contentCache (producer)

리소스 콘텐츠가 로드될 때 리소스 콘텐츠(스타일시트 파일)에 대한 캐시입니다. false Camel로 설정하면 각 메시지 처리에 스타일시트 파일이 다시 로드됩니다. 이는 개발에 좋습니다. 캐시된 스타일 워크시트는 clearCachedStylechart 작업을 사용하여 runtime에서 다시 로드하도록 강제할 수 있습니다.

true

boolean

DeleteOutputFile (producer)

output=file이 있는 경우 이 옵션은 교환이 처리될 때 출력 파일을 삭제해야 하는지 여부를 지정합니다. 예를 들어 출력 파일이 임시 파일이라고 가정하면 사용 후 삭제하는 것이 좋습니다.

false

boolean

failOnNullBody (producer)

입력 본문이 null인 경우 예외를 throw할지 여부입니다.

true

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

출력 (producer)

사용할 출력 유형을 지정하는 옵션입니다. 가능한 값은 string, bytes, 10.0.0.1, file입니다. 처음 세 가지 옵션은 모두 메모리에 기반하며, 여기서 파일은 java.io.File로 직접 스트리밍됩니다. 파일의 경우 IN 헤더에 키 Exchange.XSLT_FILE_NAME을 사용하여 CamelXsltFileName도 지정해야 합니다. 파일 이름으로 이어지는 모든 경로도 사전에 생성해야 합니다. 그렇지 않으면 런타임 시 예외가 발생합니다.

CloudEvent 값:

  • string
  • 바이트
  • DOM
  • file

string

XsltOutput

transformerCacheSize (producer)

Template.newTransformer()에 대한 호출을 피하기 위해 재사용할 수 있도록 캐시된 javax.xml.transformer 오브젝트 수입니다.

0

int

entityResolver (advanced)

javax.xml.transform.s Galaxy.SAXSource에서 사용자 지정 org.xml.s Galaxy.EntityResolver를 사용합니다.

 

EntityResolver

errorListener (advanced)

사용자 지정 javax.xml.transform.ErrorListener를 사용하도록 를 구성할 수 있습니다. 이렇게 하면 오류 또는 치명적인 오류를 캡처하고 속성이 사용되지 않을 때 Exchange에 정보를 저장하는 기본 오류 리스너가 필요합니다. 따라서 이 옵션은 특수 사용 사례에만 사용합니다.

 

ErrorListener

resultHandlerFactory (advanced)

사용자 지정 org.apache.camel.builder.xml.ResultHandlerFactory를 사용하여 사용자 정의 org.apache.camel.builder.xml.ResultHandler 유형을 사용할 수 있습니다.

 

ResultHandlerFactory

transformerFactory (advanced)

사용자 정의 XSLT 변환기 팩토리를 사용합니다.

 

TransformerFactory

transformerFactoryClass (advanced)

사용자 지정 XSLT 변환기 팩토리를 사용하려면 FQN 클래스 이름으로 지정됩니다.

 

문자열

transformerFactoryConfigurationStrategy (advanced)

새로 생성된 TransformerFactory 인스턴스에 적용할 구성 전략입니다.

 

TransformerFactoryConfigurationStrategy

URIResolver (advanced)

사용자 지정 javax.xml.transform.URIResolver를 사용합니다.

 

URIResolver

54.5. XSLT 끝점 사용

다음 형식은 XSLT 템플릿을 사용하여 InOut 메시지 교환에 대한 메시지에 대한 응답을 공식화하는 예입니다(여기서 JMSReplyTo 헤더가 있는 경우).

from("activemq:My.Queue").
  to("xslt:com/acme/mytransform.xsl");

InOnly를 사용하고 메시지를 사용하여 다른 대상으로 보내려면 다음 경로를 사용할 수 있습니다.

from("activemq:My.Queue").
  to("xslt:com/acme/mytransform.xsl").
  to("activemq:Another.Queue");

54.6. XSLT로 사용 가능한 매개변수 가져오기

기본적으로 모든 헤더는 XSLT에서 사용할 수 있는 매개 변수로 추가됩니다.
매개변수를 사용할 수 있도록 하려면 선언해야 합니다.

<setHeader name="myParam"><constant>42</constant></setHeader>
<to uri="xslt:MyTransform.xsl"/>

또한 이 매개변수를 사용할 수 있도록 XSLT의 최상위 수준에 선언해야 합니다.

<xsl: ...... >

   <xsl:param name="myParam"/>

    <xsl:template ...>

54.7. Spring XML 버전

Spring XML에서 위의 예제를 사용하려면 다음 코드와 같이 사용합니다.

  <camelContext xmlns="http://activemq.apache.org/camel/schema/spring">
    <route>
      <from uri="activemq:My.Queue"/>
      <to uri="xslt:org/apache/camel/spring/processor/example.xsl"/>
      <to uri="activemq:Another.Queue"/>
    </route>
  </camelContext>

54.8. xsl:include 사용

Camel은 URIResolver 자체 구현을 제공합니다. 이를 통해 Camel은 classpath에서 포함된 파일을 로드할 수 있습니다.

예를 들어 다음 코드의 include 파일은 시작 끝점과 상대적입니다.

<xsl:include href="staff_template.xsl"/>

즉, Camel이 classpath 에서 org/apache/camel/component/xslt/staff_template.xsl으로 파일을 찾습니다.

classpath: 또는 file: 을 사용하여 classpath 또는 파일 시스템에서 Camel에 조회하도록 지시할 수 있습니다. 접두사를 생략하면 Camel은 엔드포인트 구성의 접두사를 사용합니다. 끝점 구성에 접두사가 지정되지 않은 경우 기본값은 classpath: 입니다.

include 경로에서 뒤로 참조할 수도 있습니다. 다음 예에서 xsl 파일은 org/apache/camel/component 에서 해결됩니다.

    <xsl:include href="../staff_other_template.xsl"/>

54.9. xsl:include 및 기본 접두사 사용

Camel은 엔드포인트 구성의 접두사를 기본 접두사로 사용합니다.

명시적으로 file: 또는 classpath: loading를 지정할 수 있습니다. 필요한 경우 두 로드 유형을 XSLT 스크립트에서 혼합할 수 있습니다.

54.10. 동적 스타일시트

런타임 시 동적 스타일시트를 제공하기 위해 동적 URI를 정의할 수 있습니다. 자세한 내용은 How to use a dynamic URI in to() 를 참조하십시오.

54.11. XSLT ErrorListener에서 경고, 오류 및 fatalErrors 액세스

모든 경고/오류 또는 fatalError는 Exchange.XSLT_ERROR,Exchange.XSLT_FATAL_ERROR 또는 Exchange.XSLT_WARNING 키의 속성으로 현재 교환에 저장되므로 최종 사용자가 변환 중에 발생하는 오류를 유지할 수 있습니다.

예를 들어 아래 스타일시트에서는 직원에 빈 dob 필드가 있는 경우 종료하려고 합니다. xsl:message를 사용하여 사용자 정의 오류 메시지를 포함합니다.

<xsl:template match="/">
  <html>
    <body>
      <xsl:for-each select="staff/programmer">
        <p>Name: <xsl:value-of select="name"/><br />
          <xsl:if test="dob=''">
            <xsl:message terminate="yes">Error: DOB is an empty string!</xsl:message>
          </xsl:if>
        </p>
      </xsl:for-each>
    </body>
  </html>
</xsl:template>

예외는 Exchange.XSLT_WARNING 키의 경고로 교환에 저장됩니다.

54.12. Spring Boot Auto-Configuration

Spring Boot로 xslt를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-xslt-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- use the same version as your Camel core version -->
</dependency>

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

이름설명Default유형

camel.component.xslt.autowired-enabled

autowiring이 활성화되었는지 여부 이 옵션은 일치하는 유형의 단일 인스턴스가 있는지 확인한 다음 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등을 자동으로 구성하는 데 사용할 수 있습니다.

true

부울

camel.component.xslt.content-cache

리소스 콘텐츠가 로드될 때 리소스 콘텐츠(스타일시트 파일)에 대한 캐시입니다. false Camel로 설정하면 각 메시지 처리에 스타일시트 파일이 다시 로드됩니다. 이는 개발에 좋습니다. 캐시된 스타일 워크시트는 clearCachedStylechart 작업을 사용하여 runtime에서 다시 로드하도록 강제할 수 있습니다.

true

부울

camel.component.xslt.enabled

xslt 구성 요소의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.component.xslt.lazy-start-producer

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

부울

camel.component.xslt.transformer-factory-class

사용자 지정 XSLT 변환기 팩토리를 사용하려면 FQN 클래스 이름으로 지정됩니다.

 

문자열

camel.component.xslt.transformer-factory-configuration-strategy

새로 생성된 TransformerFactory 인스턴스에 적용할 구성 전략입니다. 옵션은 org.apache.camel.component.xslt.TransformerFactoryConfigurationStrategy 유형입니다.

 

TransformerFactoryConfigurationStrategy

camel.component.xslt.uri-resolver

사용자 정의 UriResolver를 사용합니다. 'uriResolverFactory' 옵션과 함께 사용하면 안 됩니다. 옵션은 javax.xml.transform.URIResolver 유형입니다.

 

URIResolver

camel.component.xslt.uri-resolver-factory

동적 엔드포인트 리소스 URI에 따라 달라지는 사용자 정의 UriResolver를 사용합니다. 'uriResolver' 옵션과 함께 사용하면 안 됩니다. 옵션은 org.apache.camel.component.xslt.XsltUriResolverFactory 유형입니다.

 

XsltUriResolverFactory

55장. Avro

이 구성 요소는 Apache Avro의 바이너리 데이터 형식을 사용하여 메시지를 직렬화하고 역직렬화할 수 있는 avro에 대한 데이터 형식을 제공합니다. Camel 3.2ECDHE 기능이 별도의 camel-avro-rpc 구성 요소로 이동되었기 때문입니다.

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-avro</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

maven, ant 등을 사용하여 스키마에서 클래스를 쉽게 생성할 수 있습니다. 자세한 내용은 Apache Avro 설명서에서 참조하십시오.

55.1. Avro 데이터 형식 옵션

Avro 데이터 포맷은 아래에 나열된 1가지 옵션을 지원합니다.

이름DefaultJava Type설명

instanceClassName

 

문자열

마샬링 및 마샬링에 사용할 클래스 이름입니다.

55.2. Avro 데이터 형식 사용

avro 데이터 형식을 사용하는 것은 경로에서 마샬링 또는 축소 해제하려는 클래스를 지정하는 것처럼 쉽습니다.

AvroDataFormat format = new AvroDataFormat(Value.SCHEMA$);

from("direct:in").marshal(format).to("direct:marshal");
from("direct:back").unmarshal(format).to("direct:unmarshal");

여기서 Value는 Avro Maven Plugin Generated 클래스입니다.

XML에서

    <camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
        <route>
            <from uri="direct:in"/>
            <marshal>
                <avro instanceClass="org.apache.camel.dataformat.avro.Message"/>
            </marshal>
            <to uri="log:out"/>
        </route>
    </camelContext>

대안으로 컨텍스트 내부의 dataformat을 지정하고 경로에서 참조할 수 있습니다.

    <camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
         <dataFormats>
            <avro id="avro" instanceClass="org.apache.camel.dataformat.avro.Message"/>
        </dataFormats>
        <route>
            <from uri="direct:in"/>
            <marshal><custom ref="avro"/></marshal>
            <to uri="log:out"/>
        </route>
    </camelContext>

같은 방식으로 avro 데이터 형식을 사용하여 압축할 수 있습니다.

55.3. Spring Boot Auto-Configuration

Spring Boot와 함께 avro를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-avro-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.dataformat.avro.enabled

avro 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.avro.instance-class-name

마샬링 및 마샬링에 사용할 클래스 이름입니다.

 

문자열

56장. Avro Jackson

jackson Avro는 Avro 확장자와 함께 Jackson 라이브러리를 사용하여 Avro 페이로드를 요약하거나 Java 객체를 Avro 페이로드로 마샬링하는 데이터 형식입니다.

참고

Jackson에 익숙한 경우 이 Avro 데이터 형식은 JSON 대응과 동일한 방식으로 작동하므로 JSON serialization/deserialization에 대해 주석이 달린 클래스와 함께 사용할 수 있습니다.

from("kafka:topic").
  unmarshal().avro(AvroLibrary.Jackson, JsonNode.class).
  to("log:info");

56.1. SchemaResolver 구성

Avro 직렬화는 스키마 기반이므로 이 데이터 형식을 사용하려면 마샬링/해결되는 각 교환의 스키마를 조회할 수 있는 SchemaResolver 개체를 제공해야 합니다.

단일 SchemaResolver를 레지스트리에 추가할 수 있으며 자동으로 조회됩니다. 또는 사용자 정의 SchemaResolver에 대한 참조를 명시적으로 지정할 수 있습니다.

56.2. Avro Jackson Options

Avro Jackson 데이터 포맷은 아래에 나열된 18 가지 옵션을 지원합니다.

이름DefaultJava Type설명

objectMapper

 

문자열

Jackson을 사용할 때 지정된 ID와 함께 기존 ObjectMapper를 조회하고 사용합니다.

useDefaultObjectMapper

 

부울

레지스트리에서 기본 Jackson ObjectMapper를 조회하고 사용할지 여부입니다.

unmarshalType

 

문자열

요약할 때 사용할 Java 유형의 클래스 이름입니다.

jsonView

 

문자열

ScanSetting을 JSON으로 마샬링할 때 JSON 출력에서 특정 필드를 제외할 수 있습니다. Jackson을 사용하면 JSON 보기를 사용하여 이 작업을 수행할 수 있습니다. 이 옵션은 JsonView 주석이 있는 클래스를 참조하는 것입니다.

include

 

문자열

pojo를 JSON으로 마샬링하려면 pojo에 null 값이 있는 일부 필드가 있습니다. 이러한 null 값을 건너뛰려면 이 옵션을 NON_NULL로 설정할 수 있습니다.

allowJmsType

 

부울

JMS 사용자가 JMS 사양의 JMSType 헤더가 요약을 해제하는 데 사용할 FQN 클래스 이름을 지정할 수 있도록 허용합니다.

collectionType

 

문자열

사용할 레지스트리의 조회할 사용자 정의 컬렉션 유형을 나타냅니다. 이 옵션은 거의 사용되지 않지만 java.util.ECDHE 기반 컬렉션 유형과 다른 컬렉션 유형을 기본값으로 사용할 수 있습니다.

useList

 

부울

Map 목록 또는 Pojo 목록으로 요약할 수 있습니다.

moduleClassNames

 

문자열

사용자 지정 Jackson 모듈 com.fasterxml.jackson.databind.Module을 FQN 클래스 이름으로 String으로 지정합니다. 여러 클래스를 쉼표로 구분할 수 있습니다.

moduleRefs

 

문자열

Camel 레지스트리에서 언급한 사용자 지정 Jackson 모듈을 사용하려면 다음을 수행하십시오. 여러 모듈은 쉼표로 구분할 수 있습니다.

enableFeatures

 

문자열

jackson com.fasterxml.jackson.databind.ObjectMapper에서 활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

disableFeatures

 

문자열

jackson com.fasterxml.jackson.databind.ObjectMapper에서 비활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

allowUnmarshallType

 

부울

활성화하면 Jackson이 축소되지 않는 동안 CamelJacksonUnmarshalType 헤더를 사용할 수 있습니다. 이 기능은 사용하려는 경우에만 활성화해야 합니다.

timezone

 

문자열

설정한 경우 Jackson은 마샬링/해결 시 Timezone을 사용합니다.

autoDiscoverObjectMapper

 

부울

true로 설정하면 Jackson이 objectMapper의 레지스트리를 조회합니다.

contentTypeHeader

 

부울

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

schemaResolver

 

문자열

전송 중인 데이터의 스키마를 조회하는 데 사용되는 선택적 스키마 확인자입니다.

autoDiscoverSchemaResolver

 

부울

비활성화하지 않으면 SchemaResolver가 레지스트리를 조회합니다.

56.3. 사용자 정의 AvroMapper 사용

매핑 구성을 더 많이 제어해야 하는 경우 사용자 정의 AvroMapper 를 사용하도록 jacksonAvroDataFormat 을 구성할 수 있습니다.

레지스트리에서 단일 AvroMapper 를 설정하는 경우 Camel은 자동으로 조회하여 이 AvroMapper 를 사용합니다.

56.4. 종속 항목

camel 경로에서 Avro Jackson을 사용하려면 이 데이터 형식을 구현하는 camel-jackson-avro 에 대한 종속성을 추가해야 합니다.

maven을 사용하는 경우 pom.xml에 다음을 추가하여 최신 & 가장 큰 릴리스 버전 번호를 대체할 수 있습니다 (최신 버전의 다운로드 페이지 참조).

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-jackson-avro</artifactId>
  <version>{CamelSBVersion}</version>
  <!-- use the same version as your Camel core version -->
</dependency>

56.5. Spring Boot Auto-Configuration

Spring Boot와 함께 avro-jackson을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-jackson-avro-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.dataformat.avro-jackson.allow-jms-type

JMS 사용자가 JMS 사양의 JMSType 헤더가 요약을 해제하는 데 사용할 FQN 클래스 이름을 지정할 수 있도록 허용합니다.

false

부울

camel.dataformat.avro-jackson.allow-unmarshall-type

활성화하면 Jackson이 축소되지 않는 동안 CamelJacksonUnmarshalType 헤더를 사용할 수 있습니다. 이 기능은 사용하려는 경우에만 활성화해야 합니다.

false

부울

camel.dataformat.avro-jackson.auto-discover-object-mapper

true로 설정하면 Jackson이 objectMapper의 레지스트리를 조회합니다.

false

부울

camel.dataformat.avro-jackson.auto-discover-schema-resolver

비활성화하지 않으면 SchemaResolver가 레지스트리를 조회합니다.

true

부울

camel.dataformat.avro-jackson.collection-type

사용할 레지스트리의 조회할 사용자 정의 컬렉션 유형을 나타냅니다. 이 옵션은 거의 사용되지 않지만 java.util.ECDHE 기반 컬렉션 유형과 다른 컬렉션 유형을 기본값으로 사용할 수 있습니다.

 

문자열

camel.dataformat.avro-jackson.content-type-header

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

true

부울

camel.dataformat.avro-jackson.disable-features

jackson com.fasterxml.jackson.databind.ObjectMapper에서 비활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

 

문자열

camel.dataformat.avro-jackson.enable-features

jackson com.fasterxml.jackson.databind.ObjectMapper에서 활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

 

문자열

camel.dataformat.avro-jackson.enabled

avro-jackson 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.avro-jackson.include

pojo를 JSON으로 마샬링하려면 pojo에 null 값이 있는 일부 필드가 있습니다. 이러한 null 값을 건너뛰려면 이 옵션을 NON_NULL로 설정할 수 있습니다.

 

문자열

camel.dataformat.avro-jackson.json-view

ScanSetting을 JSON으로 마샬링할 때 JSON 출력에서 특정 필드를 제외할 수 있습니다. Jackson을 사용하면 JSON 보기를 사용하여 이 작업을 수행할 수 있습니다. 이 옵션은 JsonView 주석이 있는 클래스를 참조하는 것입니다.

 

문자열

camel.dataformat.avro-jackson.module-class-names

사용자 지정 Jackson 모듈 com.fasterxml.jackson.databind.Module을 FQN 클래스 이름으로 String으로 지정합니다. 여러 클래스를 쉼표로 구분할 수 있습니다.

 

문자열

camel.dataformat.avro-jackson.module-refs

Camel 레지스트리에서 언급한 사용자 지정 Jackson 모듈을 사용하려면 다음을 수행하십시오. 여러 모듈은 쉼표로 구분할 수 있습니다.

 

문자열

camel.dataformat.avro-jackson.object-mapper

Jackson을 사용할 때 지정된 ID와 함께 기존 ObjectMapper를 조회하고 사용합니다.

 

문자열

camel.dataformat.avro-jackson.schema-resolver

전송 중인 데이터의 스키마를 조회하는 데 사용되는 선택적 스키마 확인자입니다.

 

문자열

camel.dataformat.avro-jackson.timezone

설정한 경우 Jackson은 마샬링/해결 시 Timezone을 사용합니다.

 

문자열

camel.dataformat.avro-jackson.unmarshal-type

요약할 때 사용할 Java 유형의 클래스 이름입니다.

 

문자열

camel.dataformat.avro-jackson.use-default-object-mapper

레지스트리에서 기본 Jackson ObjectMapper를 조회하고 사용할지 여부입니다.

true

부울

camel.dataformat.avro-jackson.use-list

Map 목록 또는 Pojo 목록으로 요약할 수 있습니다.

false

부울

57장. Bindy

이 구성 요소의 목표는 비정형 데이터(또는 더 정확하게 비 XML 데이터)를 주석으로 정의된 바인딩 매핑이 있는 Java CloudEvents로의 구문 분석/바인딩을 허용하는 것입니다. Bindy를 사용하면 다음과 같은 소스의 데이터를 바인딩할 수 있습니다.

  • CSV 레코드,
  • 고정 길이 레코드,
  • 수정 메시지,
  • 거의 모든 비정형 데이터

하나 또는 여러 개의 POJO(Java Object)로 이동합니다. Bindy는 java 속성의 유형에 따라 데이터를 변환합니다. 일부 경우에서 사용 가능한 일대다 관계와 함께 연결할 수 있습니다. 또한 Date,ub, Float, Integer, Short, Long 및 BigDecimal과 같은 데이터 유형의 경우 속성 포맷 중에 적용할 패턴을 제공할 수 있습니다.

BigDecimal 숫자의 경우 정확도와 소수점 또는 그룹화 구분 기호를 정의할 수도 있습니다.

여기에서 = double, Integer, Float, Short, Long

지원되는 형식

이 첫 번째 릴리스에서는 쉼표로 구분된 값 필드와 키 값 쌍 필드만 지원합니다(예: FIX 메시지).

camel-bindy를 사용하려면 먼저 패키지(예: com.acme.model)에서 모델을 정의하고 각 모델 클래스(예: Order, Client,knative, …​)에 필요한 주석을 클래스 또는 필드에 추가해야 합니다.

다중 모델

패키지 이름 대신 클래스 이름을 사용하여 바인딩을 구성할 때 동일한 패키지에 여러 모델을 배치할 수 있습니다.As you configure bindy using class names instead of package names you can put multiple models in the same package.

57.1. 옵션

Bindy dataformat은 아래에 나열된 5가지 옵션을 지원합니다.

이름DefaultJava Type설명

type

 

Enum

Csv, Fixed 또는 KeyValue를 사용할지 여부입니다.

CloudEvent 값:

  • Csv
  • 수정됨
  • KeyValue

classType

 

문자열

사용할 모델 클래스의 이름입니다.

로케일

 

문자열

단위 상태의 경우와 같이 사용할 기본 로케일을 구성하려면 다음을 수행합니다. JVM 플랫폼 기본 로케일을 사용하려면 기본값을 사용합니다.

unwrapSingleInstance

 

부울

요약을 해제하는 경우 단일 인스턴스를 래핑 해제하여 java.util.List로 래핑하는 대신 반환해야 합니다.

allowEmptyStream

 

부울

요약되지 않은 프로세스에서 빈 스트림을 허용할지 여부입니다. true인 경우 레코드가 없는 본문이 제공되면 예외가 발생하지 않습니다.

57.2. 주석

생성된 주석을 통해 모델의 다른 개념을 다음과 같이 매핑할 수 있습니다.

  • 레코드 유형(CSV, 키 값 쌍(예: FIX 메시지), 고정 길이 …​)
  • link(다른 오브젝트의 링크)
  • DataField 및 해당 속성(int, type, …​)
  • KeyValuePairField (FIX 재무 메시지에서와 같은 키 = 값 형식)
  • 섹션(헤더, 본문 및 각자 섹션을 식별할 수 있음)
  • OneToMany,
  • BindyConverter,
  • FormatFactories

이 섹션에서는 이러한 내용을 설명합니다.

57.2.1. 1. CsvRecord

CsvRecord 주석은 모델의 루트 클래스를 식별하는 데 사용됩니다. 레코드 = "csv 파일의 줄"을 나타내며 여러 하위 모델 클래스에 연결할 수 있습니다.

주석 이름레코드 유형level

CsvRecord

CSV

클래스

매개변수 이름유형필수 항목기본값정보

구분기

문자열

 

토큰(필수)에서 레코드를 분할하는 데 사용되는 구분 기호는 ',' 또는 ';' 또는 'anything'일 수 있습니다. 지원되는 유일한 공백 문자는 탭(\t)입니다. 다른 공백 문자(spaces)는 지원되지 않습니다. 이 값은 정규식으로 해석됩니다. 정규 표현식에서 특별한 의미가 있는 기호를 사용하려는 경우, 예를 들어 '|' 기호와 같이 마스크해야 합니다.

allowEmptyStream

boolean

 

false

allowEmptyStream 매개변수를 사용하면 CSV 파일의 실행 불가능한 스트림을 실행할 수 있습니다.

autospanLine

boolean

 

false

마지막 레코드의 나머지 행 (선택 사항) - 활성화하면 마지막 열이 행 끝에 자동으로 확장됩니다(예: 주석인 경우 등) 줄에는 모든 문자, 구분자 줄도 포함될 수 있습니다.

CRLF

문자열

 

WINDOWS

각 레코드(선택 사항) 뒤에 캐리지 반환을 추가하는 데 사용할 문자 - 사용할 캐리지 반환 문자를 정의할 수 있습니다. 이전에 나열된 세 개 이외의 값을 지정하면 입력한 값(사용자)이 CRLF 문자로 사용됩니다. 세 가지 값을 사용할 수 있습니다. ECDHEDOWS, UNIX, MAC 또는 사용자 지정.

endWithLineBreak

boolean

 

true

CSV 파일이 줄 바꿈으로 끝나야 하는 경우 endWithLineBreak 매개변수 플래그(선택 사항)

generateHeaderColumns

boolean

 

false

generateHeader>-<s 매개변수를 사용하면 CSV에 열 이름을 포함하는 헤더가 생성된 것을 추가할 수 있습니다.

isOrdered

boolean

 

false

메시지 출력 순서를 지정해야 하는지 여부를 나타냅니다.

name

문자열

  

레코드를 설명하는 이름 (선택 사항)

quote

문자열

 

"

지정된 인용 문자(선택 사항)를 사용하여 열 마샬링 여부 - CSV가 생성될 때 필드의 인용문을 지정할 수 있습니다. 이 주석은 모델의 루트 클래스와 연결되며 한 번 선언해야 합니다.

인용

boolean

 

false

마샬링 시 값(및 헤더)을 따옴표로 묶어야 하는지 여부를 나타냅니다(선택 사항)

quotingEscaped

boolean

 

false

인용할 때 값을 이스케이프해야 하는지 여부를 나타냅니다(선택 사항)

removeQuotes

boolean

 

true

각 필드의 따옴표를 제거하려고 하는 경우 따옴표 제거 플래그

skipField

boolean

 

false

skipField 매개변수를 사용하면 CSV 파일의 필드를 건너뛸 수 있습니다. 일부 필드가 필요하지 않은 경우 생략할 수 있습니다.

skipFirstLine

boolean

 

false

skipFirstLine 매개변수는 CSV 파일의 첫 번째 줄을 건너뛰거나 생략할 수 없습니다. 이 줄에는 종종 열 정의가 포함됩니다.

case 1 : separator = ','

CSV 레코드의 필드를 구분하는 데 사용되는 구분 기호는 다음과 같습니다.

10, J, Pauline, M, XD12345678, Fortis Dynamic 15/15, 2500, USD, 08-01-2009
@CsvRecord( separator = "," )
public Class Order {

}

case 2 : separator = ';'

이전 케이스와 비교하면 여기 구분자가 ; 대신 ,

10; J; Pauline; M; XD12345678; Fortis Dynamic 15/15; 2500; USD; 08-01-2009
@CsvRecord( separator = ";" )
public Class Order {

}

case 3: separator = '|'

이전 케이스와 비교하여 다음과 같은 구분 기호 다음과 같습니다.

10| J| Pauline| M| XD12345678| Fortis Dynamic 15/15| 2500| USD| 08-01-2009
@CsvRecord( separator = "\\|" )
public Class Order {

}

case 4 : separator = '\",\"'

Camel 2.8.2 이상에 적용

CSV 레코드의 구문 분석할 필드에 . 또는 . 또한 구분자로 사용되는 필드에는 이 경우를 처리하는 방법을 카타릴이 나타내는 다른 전략을 찾아야 합니다. 데이터를 포함하는 필드를 쉼표로 정의하기 위해 구분자(예: '10', 'Street 10, 'USA', 'Street 10, "10', "USA")로 작은 따옴표를 사용합니다.

__

이 경우 한 줄 또는 이중 따옴표인 행의 첫 번째 문자와 마지막 문자는 bindy로 제거됩니다.

"10","J","Pauline"," M","XD12345678","Fortis Dynamic 15,15","2500","USD","08-01-2009"
@CsvRecord( separator = "\",\"" )
public Class Order {

}

Bindy는 레코드가 작은 또는 이중 따옴표로 묶여 있는지 여부를 자동으로 감지하고 CSV에서 Object로 요약하지 않을 때 해당 따옴표를 자동으로 제거합니다. 따라서 구분 기호에 따옴표를 포함하지 말고 아래와 같이 하면 됩니다.

"10","J","Pauline"," M","XD12345678","Fortis Dynamic 15,15","2500","USD","08-01-2009"
@CsvRecord( separator = "," )
public Class Order {

}

Object에서 CSV로 마샬링하고 따옴표를 사용하려면 @CsvRecordquote 속성을 사용하여 사용할 인용문을 지정해야 합니다.

@CsvRecord( separator = ",", quote = "\"" )
public Class Order {

}

케이스 5 : 구분자 & 건너뛰기FirstLine

이 기능은 클라이언트가 파일의 첫 번째 줄에 데이터 필드 이름인 경우 유용합니다.

order id, client id, first name, last name, isin code, instrument name, quantity, currency, date

구문 분석 프로세스 중에 이 첫 번째 줄을 건너뛰어야 함을 바인딩하려면 다음과 같은 특성을 사용합니다.

@CsvRecord(separator = ",", skipFirstLine = true)
public Class Order {

}

케이스 6: generateHeader>-<s

생성된 CSV의 첫 번째 줄에 추가하려면 다음과 같은 주석에서 generateHeader>-<s를 true로 설정해야 합니다.

@CsvRecord( generateHeaderColumns = true )
public Class Order {

}

결과적으로 Bindy during the unmarshaling process will generate CSV like this :

order id, client id, first name, last name, isin code, instrument name, quantity, currency, date
10, J, Pauline, M, XD12345678, Fortis Dynamic 15/15, 2500, USD, 08-01-2009

케이스 7 : 운송 반환

camel-bindy가 실행되는 플랫폼이 Windows가 아닌 Macintosh 또는 Unix가 아닌 경우 다음과 같이 crlf 속성을 변경할 수 있습니다. 세 가지 값을 사용할 수 있습니다 : UNIX 또는 MAC

@CsvRecord(separator = ",", crlf="MAC")
public Class Order {

}

또한 어떤 이유로든 다른 줄 끝 문자를 추가해야 하는 경우 crlf 매개변수를 사용하여 지정할 수 있습니다. 다음 예제에서는 쉼표 뒤에 줄 바꿈 문자를 사용하여 행을 종료할 수 있습니다.

@CsvRecord(separator = ",", crlf=",\n")
public Class Order {

}

케이스 8 : isOrdered

경우에 따라 모델의 CSV 레코드를 생성하는 동안 따라야 하는 순서는 구문 분석 중 사용되는 순서와 다릅니다. 그러면 이 경우 isOrdered = true 를 사용하여 DataField 주석의 속성 위치와 함께 이 속성을 표시할 수 있습니다.

@CsvRecord(isOrdered = true)
public Class Order {

   @DataField(pos = 1, position = 11)
   private int orderNr;

   @DataField(pos = 2, position = 10)
   private String clientNr;

}

__

POS 는 파일 스트림을 구문 분석하는 데 사용되며, 위치는 CSV를 생성하는 데 사용됩니다.

57.2.3. 3. DataField

DataField 주석은 필드의 속성을 정의합니다. 각 datafield는 레코드의 위치, 유형(문자열, int, date, …​) 및 선택적으로 패턴으로 식별됩니다.

주석 이름레코드 유형level

DataField

all

속성

매개변수 이름유형필수 항목기본값정보

POS

int

 

입력 레코드의 데이터 위치는 1(필수)부터 시작해야 합니다. position 매개 변수를 참조하십시오.

align

문자열

 

R

텍스트를 오른쪽 또는 왼쪽으로 정렬합니다. <tt>R</tt> 또는 <tt>L</tt> 값을 사용합니다.

클립

boolean

 

false

고정 길이를 사용할 때 허용되는 길이를 초과하는 경우 필드의 데이터를 잘라내도록 나타냅니다.

columnName

문자열

  

헤더 열의 이름입니다(선택 사항). 속성 이름을 기본값으로 사용합니다. CsvRecord generateHeader>-<s = true인경우에만 적용됩니다.

decimalSeparator

문자열

  

BigDecimal 숫자와 함께 사용할 10진수 분리기

defaultValue

문자열

  

값이 설정되지 않은 경우 필드의 기본값

구분 기호

문자열

  

필드에 가변 길이가 있는 경우 사용할 선택적 구분 기호

groupingSeparator

문자열

  

Grouping Separator to be used with BigDecimal number when we would like to format/parse to number with grouping e.g. 10.0.0.1,456.789

impliedDecimalSeparator

boolean

 

false

지정된 위치에 부동 소수점이 있는지 여부를 나타냅니다.Indicates if there is a decimal point implied at a specified location.

길이

int

 

0

레코드가 고정된 길이로 설정된 경우 데이터 블록의 길이(숫자)

lengthPos

int

 

0

이 필드에 예상 고정된 길이를 정의하는 레코드의 데이터 필드를 식별합니다.Identifies a data field in the record that defines the expected fixed length for this field.

method

문자열

  

DataField에 이러한 사용자 지정을 적용하기 위해 호출할 메서드 이름입니다. datafield 자체의 메서드여야 하며 클래스 메서드의 정적 정규화된 이름을 제공해야 합니다(예: 단위 테스트 org.apache.camel.dataformat.bindy.csv.BindySimpleCsvFunctionWithExternalMethodTest.replaceToanchor).

name

문자열

  

필드의 이름 (선택 사항)

paddingChar

grafka

  

레코드가 고정된 길이로 설정된 경우와 함께 줄임

패턴

문자열

  

Java 포맷터(예별SimpleDateFormat)가 데이터를 변환하는 데 사용하는 패턴(선택 사항)입니다. 패턴을 사용하는 경우 bindy 데이터 형식으로 로케일을 설정하는 것이 좋습니다. "us"와 같은 알려진 로케일로 설정하거나 "default"를 사용하여 플랫폼 기본 로케일을 사용합니다.

위치

int

 

0

생성된 출력 메시지의 필드 위치입니다(1부터 시작). CSV에서 생성된 필드(출력 메시지)의 위치가 입력 위치(pos)와 비교되어야 하는 경우 사용해야 합니다. pos 매개변수를 참조하십시오.

Precision

int

 

0

생성할 \{@link java.math.BigDecimal} 번호의 정밀성

필수 항목

boolean

 

false

필드가 필수인지 여부를 나타냅니다.

반올림

문자열

 

통합

Round mode to be used to be used to be used to be used to be used to round/scale a BigDecimal Values : UP, DOWN, nodejsILING, FLOOR, HALF_UP, HALF_UP,HALF_DOWN, UNNECESEN, UNNECESSARY 예: number = 123456.789, Precision = 2, Rounding = 1, 1234ILING Result : 123456

timezone

문자열

  

사용할 시간대입니다.

Trim

boolean

 

false

값을 트리밍할지 여부를 나타냅니다.Indicates whether the value should be trimmed

케이스 1 : pos

이 매개변수/attribute는 CSV 레코드의 필드 위치를 나타냅니다.

위치

@CsvRecord(separator = ",")
public class Order {

    @DataField(pos = 1)
    private int orderNr;

    @DataField(pos = 5)
    private String isinCode;

}

이 예제에서 위치가 1 에서 시작되지만 클래스 순서의 5 에서 계속됩니다. 2 에서 4 까지의 숫자는 클래스 Client에 정의되어 있습니다(다음 참조).

위치가 다른 모델 클래스에서 계속됩니다.

public class Client {

    @DataField(pos = 2)
    private String clientNr;

    @DataField(pos = 3)
    private String firstName;

    @DataField(pos = 4)
    private String lastName;
}

케이스 2 : 패턴

패턴을 통해 데이터 형식을 강화하거나 검증할 수 있습니다.

패턴

@CsvRecord(separator = ",")
public class Order {

    @DataField(pos = 1)
    private int orderNr;

    @DataField(pos = 5)
    private String isinCode;

    @DataField(name = "Name", pos = 6)
    private String instrumentName;

    @DataField(pos = 7, precision = 2)
    private BigDecimal amount;

    @DataField(pos = 8)
    private String currency;

    // pattern used during parsing or when the date is created
    @DataField(pos = 9, pattern = "dd-MM-yyyy")
    private Date orderDate;
}

케이스 3: 정확도

정확도는 숫자의 10진수 부분을 정의하려는 경우에 유용합니다.

Precision

@CsvRecord(separator = ",")
public class Order {

    @DataField(pos = 1)
    private int orderNr;

    @Link
    private Client client;

    @DataField(pos = 5)
    private String isinCode;

    @DataField(name = "Name", pos = 6)
    private String instrumentName;

    @DataField(pos = 7, precision = 2)
    private BigDecimal amount;

    @DataField(pos = 8)
    private String currency;

    @DataField(pos = 9, pattern = "dd-MM-yyyy")
    private Date orderDate;
}

case 4 : Position은 출력마다 다릅니다.

position 속성은 생성된 CSV 레코드에 필드를 배치하는 방법을 바인딩합니다. 기본적으로 사용되는 위치는 특성 pos 에 정의된 위치에 해당합니다. 위치가 다른 경우 (즉, 미정형에서 마샬링을 비교한다는 것을 의미함) 우리는 위치를 사용하여 이를 나타낼 수 있습니다.

예를 들면 다음과 같습니다.

위치가 출력마다 다릅니다.

@CsvRecord(separator = ",", isOrdered = true)
public class Order {

    // Positions of the fields start from 1 and not from 0

    @DataField(pos = 1, position = 11)
    private int orderNr;

    @DataField(pos = 2, position = 10)
    private String clientNr;

    @DataField(pos = 3, position = 9)
    private String firstName;

    @DataField(pos = 4, position = 8)
    private String lastName;

    @DataField(pos = 5, position = 7)
    private String instrumentCode;

    @DataField(pos = 6, position = 6)
    private String instrumentNumber;
}

주석 @DataField 의 이 속성은 속성과 함께 사용해야 합니다. @CsvRecord 주석의 isOrdered = true 입니다.

케이스 5 : 필요

필드가 필수인 경우, 필요한 특성을 true로 설정하면 됩니다.

필수 항목

@CsvRecord(separator = ",")
public class Order {

    @DataField(pos = 1)
    private int orderNr;

    @DataField(pos = 2, required = true)
    private String clientNr;

    @DataField(pos = 3, required = true)
    private String firstName;

    @DataField(pos = 4, required = true)
    private String lastName;
}

이 필드가 레코드에 없으면 다음 정보와 함께 구문 분석기에 오류가 발생합니다.

Some fields are missing (optional or mandatory), line :

케이스 6: 트리밍

필드에 처리되기 전에 제거해야 하는 선행 및/또는 후행 공백이 있는 경우 trim 을 true로 설정하기만 하면 됩니다.

Trim

@CsvRecord(separator = ",")
public class Order {

    @DataField(pos = 1, trim = true)
    private int orderNr;

    @DataField(pos = 2, trim = true)
    private Integer clientNr;

    @DataField(pos = 3, required = true)
    private String firstName;

    @DataField(pos = 4)
    private String lastName;
}

case 7 : defaultValue

필드를 정의하지 않으면 defaultValue 특성에 표시된 값을 사용합니다.

기본값

@CsvRecord(separator = ",")
public class Order {

    @DataField(pos = 1)
    private int orderNr;

    @DataField(pos = 2)
    private Integer clientNr;

    @DataField(pos = 3, required = true)
    private String firstName;

    @DataField(pos = 4, defaultValue = "Barin")
    private String lastName;
}

케이스 8: columnName

@CsvRecord 에 주석 generateHeader>-<s = true 인 경우에만 속성의 열 이름을 지정합니다.

열 이름

@CsvRecord(separator = ",", generateHeaderColumns = true)
public class Order {

    @DataField(pos = 1)
    private int orderNr;

    @DataField(pos = 5, columnName = "ISIN")
    private String isinCode;

    @DataField(name = "Name", pos = 6)
    private String instrumentName;
}

이 속성은 선택적 필드에만 적용할 수 있습니다.

57.2.4. 4. FixedLengthRecord

FixedLengthRecord 주석은 모델의 루트 클래스를 식별하는 데 사용됩니다. 레코드 = "데이터 고정 길이(자수) 형식이 지정된 파일/메시지를 나타내며 여러 하위 모델 클래스에 연결할 수 있습니다. 이 형식은 필드의 데이터를 오른쪽 또는 왼쪽에 맞게 정렬할 수 있기 때문에 약간 특정적입니다.

데이터 크기가 필드의 길이를 완전히 채우지 않으면 '패드' 문자를 추가할 수 있습니다.

주석 이름레코드 유형level

FixedLengthRecord

수정됨

클래스

매개변수 이름유형필수 항목기본값정보

countGrapheme

boolean

 

false

줄선이 계산되는 방식을 나타냅니다.

CRLF

문자열

 

WINDOWS

각 레코드 다음에 캐리지 리턴을 추가하는 데 사용할 문자(선택 사항) 가능한 값: >-<DOWS, UNIX, MAC 또는 사용자 지정. 이 옵션은 마샬링 중에만 사용되며 unmarshalling은 eol을 사용자 정의하지 않는 한 시스템 기본 JDK 제공 줄 구분 기호를 사용합니다.

EOL

문자열

  

마샬링은 다른 줄 구분 기호 중 하나에만 사용되며, 마샬링은 다른 값을 제공하지 않는 한 시스템 기본 줄 구분 기호(선택 사항 - default: "", 기본 JDK 제공 줄 구분 기호를 사용할 수 있도록 지원) 이후 줄 종료를 처리하는 데 사용할 문자입니다.

footer

클래스

 

void

파일 끝에 이 유형의 레코드가 한 발씩 올 수 있음을 나타냅니다.Indicates that the record(s) of this type may be followed by a single footer record at the end of the file.

header

클래스

 

void

이 유형의 레코드가 파일 시작 시 단일 헤더 레코드 앞에 있을 수 있음을 나타냅니다.

ignoreMissingChars

boolean

 

false

너무 짧은 줄이 무시되는지 여부를 나타냅니다.

ignoreTrailingChars

boolean

 

false

요약 / 구문 분석 시 마지막으로 매핑된 filed 이외의 문자는 무시될 수 있음을 나타냅니다. 이 주석은 모델의 루트 클래스와 연결되며 한 번 선언해야 합니다.

길이

int

 

0

레코드의 고정된 길이(자 수)입니다. 레코드가 항상 \{#paddingChar()}'s로 채워지는 것을 의미합니다.

name

문자열

  

레코드를 설명하는 이름 (선택 사항)

paddingChar

grafka

  

함께 사용할 줄임말입니다.

skipFooter

boolean

 

false

footer 레코드 마샬링 / 마샬링을 건너뛰도록 데이터 형식을 설정합니다. 기본 레코드(예: 헤더 또는 도글러가 아닌)에서 이 매개 변수를 구성합니다.

skipHeader

boolean

 

false

헤더 레코드의 마샬링 / 마샬링을 건너뛰도록 데이터 형식을 구성합니다. 기본 레코드(예: 헤더 또는 도글러가 아닌)에서 이 매개 변수를 구성합니다.

레코드는 헤더/축소 및 기본 고정 길이 레코드가 모두 아닐 수 있습니다.

케이스 1: 간단한 고정 길이 레코드

이 간단한 예제에서는 고정 메시지의 구문 분석/포멧을 사용하도록 모델을 설계하는 방법을 보여줍니다.

10A9PaulineMISINXD12345678BUYShare2500.45USD01-08-2009

고정 간단한

@FixedLengthRecord(length=54, paddingChar=' ')
public static class Order {

    @DataField(pos = 1, length=2)
    private int orderNr;

    @DataField(pos = 3, length=2)
    private String clientNr;

    @DataField(pos = 5, length=7)
    private String firstName;

    @DataField(pos = 12, length=1, align="L")
    private String lastName;

    @DataField(pos = 13, length=4)
    private String instrumentCode;

    @DataField(pos = 17, length=10)
    private String instrumentNumber;

    @DataField(pos = 27, length=3)
    private String orderType;

    @DataField(pos = 30, length=5)
    private String instrumentType;

    @DataField(pos = 35, precision = 2, length=7)
    private BigDecimal amount;

    @DataField(pos = 42, length=3)
    private String currency;

    @DataField(pos = 45, length=10, pattern = "dd-MM-yyyy")
    private Date orderDate;
}

케이스 2 : 정렬 및 패딩을 사용하여 길이 레코드 수정

이 더 세분화된 예제에서는 필드의 맞춤을 정의하는 방법과 ' ''인 패딩 문자를 할당하는 방법을 보여줍니다.

10A9 PaulineM ISINXD12345678BUYShare2500.45USD01-08-2009

Fixed-padding-align

@FixedLengthRecord(length=60, paddingChar=' ')
public static class Order {

    @DataField(pos = 1, length=2)
    private int orderNr;

    @DataField(pos = 3, length=2)
    private String clientNr;

    @DataField(pos = 5, length=9)
    private String firstName;

    @DataField(pos = 14, length=5, align="L")   // align text to the LEFT zone of the block
    private String lastName;

    @DataField(pos = 19, length=4)
    private String instrumentCode;

    @DataField(pos = 23, length=10)
    private String instrumentNumber;

    @DataField(pos = 33, length=3)
    private String orderType;

    @DataField(pos = 36, length=5)
    private String instrumentType;

    @DataField(pos = 41, precision = 2, length=7)
    private BigDecimal amount;

    @DataField(pos = 48, length=3)
    private String currency;

    @DataField(pos = 51, length=10, pattern = "dd-MM-yyyy")
    private Date orderDate;
}

케이스 3: 필드 패딩

경우에 따라 레코드에 정의된 기본 패딩은 필드에 적용되지 않는 경우가 있습니다. ' '' 대신 '0'을 사용하여 '0'을 실행하려는 숫자 형식이 있습니다. 이 경우 모델에서 @DataField 의 속성 패딩Char 을 사용하여 이 값을 설정할 수 있습니다.

10A9 PaulineM ISINXD12345678BUYShare000002500.45USD01-08-2009

Fixed-padding-field

@FixedLengthRecord(length = 65, paddingChar = ' ')
public static class Order {

    @DataField(pos = 1, length = 2)
    private int orderNr;

    @DataField(pos = 3, length = 2)
    private String clientNr;

    @DataField(pos = 5, length = 9)
    private String firstName;

    @DataField(pos = 14, length = 5, align = "L")
    private String lastName;

    @DataField(pos = 19, length = 4)
    private String instrumentCode;

    @DataField(pos = 23, length = 10)
    private String instrumentNumber;

    @DataField(pos = 33, length = 3)
    private String orderType;

    @DataField(pos = 36, length = 5)
    private String instrumentType;

    @DataField(pos = 41, precision = 2, length = 12, paddingChar = '0')
    private BigDecimal amount;

    @DataField(pos = 53, length = 3)
    private String currency;

    @DataField(pos = 56, length = 10, pattern = "dd-MM-yyyy")
    private Date orderDate;
}

케이스 4: 구분자가 포함된 수정 길이 레코드

고정 길이 레코드는 종종 레코드 내에서 구분된 콘텐츠가 있습니다. firstName 및 lastName 필드는 다음 예제에서 ^ 문자로 구분됩니다.

10A9Pauline^M^ISINXD12345678BUYShare000002500.45USD01-08-2009

고정 구분

@FixedLengthRecord
public static class Order {

    @DataField(pos = 1, length = 2)
    private int orderNr;

    @DataField(pos = 2, length = 2)
    private String clientNr;

    @DataField(pos = 3, delimiter = "^")
    private String firstName;

    @DataField(pos = 4, delimiter = "^")
    private String lastName;

    @DataField(pos = 5, length = 4)
    private String instrumentCode;

    @DataField(pos = 6, length = 10)
    private String instrumentNumber;

    @DataField(pos = 7, length = 3)
    private String orderType;

    @DataField(pos = 8, length = 5)
    private String instrumentType;

    @DataField(pos = 9, precision = 2, length = 12, paddingChar = '0')
    private BigDecimal amount;

    @DataField(pos = 10, length = 3)
    private String currency;

    @DataField(pos = 11, length = 10, pattern = "dd-MM-yyyy")
    private Date orderDate;
}

고정 길이 레코드의 pos 값(s)은 정확한 열 번호 대신 서수, 순차적 값을 사용하여 선택적으로 정의할 수 있습니다.

case 5 : 레코드 정의 필드 길이를 사용하여 수정된 길이 레코드

때때로 고정 길이 레코드에는 동일한 레코드 내의 다른 필드의 예상 길이를 정의하는 필드가 포함될 수 있습니다. 다음 예제에서 instrumentNumber 필드 값의 길이는 레코드의 instrumentNumberLen 필드 값으로 정의됩니다.

10A9Pauline^M^ISIN10XD12345678BUYShare000002500.45USD01-08-2009

고정 구분

@FixedLengthRecord
public static class Order {

    @DataField(pos = 1, length = 2)
    private int orderNr;

    @DataField(pos = 2, length = 2)
    private String clientNr;

    @DataField(pos = 3, delimiter = "^")
    private String firstName;

    @DataField(pos = 4, delimiter = "^")
    private String lastName;

    @DataField(pos = 5, length = 4)
    private String instrumentCode;

    @DataField(pos = 6, length = 2, align = "R", paddingChar = '0')
    private int instrumentNumberLen;

    @DataField(pos = 7, lengthPos=6)
    private String instrumentNumber;

    @DataField(pos = 8, length = 3)
    private String orderType;

    @DataField(pos = 9, length = 5)
    private String instrumentType;

    @DataField(pos = 10, precision = 2, length = 12, paddingChar = '0')
    private BigDecimal amount;

    @DataField(pos = 11, length = 3)
    private String currency;

    @DataField(pos = 12, length = 10, pattern = "dd-MM-yyyy")
    private Date orderDate;
}

케이스 6 : 헤더와 각면을 사용하여 길이 레코드 수정

Bindy는 정렬된 클래스가 기본 @FixedLengthRecord 클래스와 동일한 패키지에 있거나 구성된 검사 패키지 중 하나에 있는 경우 모델의 일부로 구성된 고정 길이 헤더 및 푸터 레코드를 검색합니다. 다음 텍스트는 헤더 레코드와 테일러 레코드로 요약된 두 개의 고정 길이 레코드를 보여줍니다.

101-08-2009
10A9 PaulineM ISINXD12345678BUYShare000002500.45USD01-08-2009
10A9 RichN ISINXD12345678BUYShare000002700.45USD01-08-2009
9000000002

fixed-header-and-footer-main-class

@FixedLengthRecord(header = OrderHeader.class, footer = OrderFooter.class)
public class Order {

    @DataField(pos = 1, length = 2)
    private int orderNr;

    @DataField(pos = 2, length = 2)
    private String clientNr;

    @DataField(pos = 3, length = 9)
    private String firstName;

    @DataField(pos = 4, length = 5, align = "L")
    private String lastName;

    @DataField(pos = 5, length = 4)
    private String instrumentCode;

    @DataField(pos = 6, length = 10)
    private String instrumentNumber;

    @DataField(pos = 7, length = 3)
    private String orderType;

    @DataField(pos = 8, length = 5)
    private String instrumentType;

    @DataField(pos = 9, precision = 2, length = 12, paddingChar = '0')
    private BigDecimal amount;

    @DataField(pos = 10, length = 3)
    private String currency;

    @DataField(pos = 11, length = 10, pattern = "dd-MM-yyyy")
    private Date orderDate;
}

@FixedLengthRecord
public  class OrderHeader {
    @DataField(pos = 1, length = 1)
    private int recordType = 1;

    @DataField(pos = 2, length = 10, pattern = "dd-MM-yyyy")
    private Date recordDate;
}

@FixedLengthRecord
public class OrderFooter {

    @DataField(pos = 1, length = 1)
    private int recordType = 9;

    @DataField(pos = 2, length = 9, align = "R", paddingChar = '0')
    private int numberOfRecordsInTheFile;
}

케이스 7 : 고정된 길이 레코드를 구문 분석할 때 콘텐츠 스케이핑

대상 사용 사례에 필요한 것보다 더 많은 정보를 포함하는 고정 길이 레코드를 제공하는 시스템과 통합하는 것이 일반적입니다. 이 경우 필요하지 않은 필드의 선언 및 구문 분석을 생략하는 것이 유용합니다. 이를 위해 Bindy는 다음 선언된 필드의 pos 값이 마지막 구문 분석 필드의 커서 위치를 벗어나는 경우 레코드 내의 다음 매핑된 필드로 건너뜁니다. 관심 필드(보조 값 대신)에 절대 pos 위치를 사용하면 Bindy가 두 필드 간의 콘텐츠를 건너뜁니다.

마찬가지로, 특정 필드 이외의 어떠한 콘텐츠도 관심을 가질 수 없습니다. 이 경우 @FixedLengthRecord 선언에서 ignoreTrailingChars 속성을 설정하여 마지막 매핑 필드 이외의 모든 항목의 분석을 건너뛰도록 바인딩에 지시할 수 있습니다.

@FixedLengthRecord(ignoreTrailingChars = true)
public static class Order {

    @DataField(pos = 1, length = 2)
    private int orderNr;

    @DataField(pos = 3, length = 2)
    private String clientNr;

    // any characters that appear beyond the last mapped field will be ignored

}

57.2.5. 5. 메시지

Message 주석은 키 값 쌍 필드를 포함할 모델의 클래스를 식별하는 데 사용됩니다. 이러한 종류의 형식은 주로 FIX(Fixin Exchange Protocol Messages)에서 사용됩니다. 하지만 이 주석은 데이터가 키로 식별되는 다른 형식에 사용할 수 있습니다. 키 쌍 값은 탭 구분기 (유니코드 표현 : \u0009)와 같은 특수 문자가 될 수있는 구분자로 서로 분리되거나 (유코드 표현 : \u0001)

참고

FIX 메시지로 작업하려면 모델에 Order 클래스일 수 있는 루트 메시지 클래스에 연결된 Header 및 Trailer 클래스가 포함되어야 합니다. 필수는 아니지만 quickFix 프로젝트를 기반으로 한 수정 게이트웨이인 camel-bindy와 함께 camel-bindy를 사용할 때 매우 유용합니다.

주석 이름레코드 유형level

메시지

키 값 쌍

클래스

매개변수 이름유형필수 항목기본값정보

keyValuePairSeparator

문자열

 

키 값 쌍 구분 기호는 키(필수)에서 값을 분할하는 데 사용됩니다. '\u0001', '\u0009', '#' 또는 'anything'일 수 있습니다.

pairSeparator

문자열

 

토큰으로 키 값 쌍을 분할하는 데 사용되는 쌍 구분자(필수)입니다. '=', ';' 또는 'anything'일 수 있습니다.

CRLF

문자열

 

WINDOWS

각 레코드 다음에 캐리지 리턴을 추가하는 데 사용할 문자(선택 사항) 가능한 값 = ECDHEDOWS, UNIX, MAC 또는 사용자 지정. 이전에 나열된 세 개 이외의 값을 지정하면 입력한 값(사용자)이 CRLF 문자로 사용됩니다.

isOrdered

boolean

 

false

메시지 출력 순서를 지정해야 하는지 여부를 나타냅니다. 이 주석은 모델의 메시지 클래스와 연결되며 한 번 선언해야 합니다.

name

문자열

  

메시지 설명의 이름 (선택 사항)

type

문자열

 

FIX

type은 메시지 유형을 정의하는 데 사용됩니다 (예: FIX, EMX, …​) (선택 사항)

버전

문자열

 

4.1

version은 메시지 버전(예: 4.1, …​)을 정의합니다(선택 사항)

case 1 : 구분자 = 'u0001'

FIX 메시지에서 키 값 쌍 필드를 분할하는 데 사용되는 구분자는 ASCII 01 문자 또는 유니코드 형식 \u0001 입니다. 이 문자는 java 런타임 오류를 방지하려면 두 번째 이스케이프해야 합니다. 예를 들면 다음과 같습니다.

8=FIX.4.1 9=20 34=1 35=0 49=INVMGR 56=BRKR 1=BE.CHM.001 11=CHM0001-01 22=4 ...

주석을 사용하는 방법:

수정 - 메시지

@Message(keyValuePairSeparator = "=", pairSeparator = "\u0001", type="FIX", version="4.1")
public class Order {

}

테스트 사례 살펴보기

Tab과 같은 ASCII 문자 …​은 WillKI 페이지에 표시할 수 없습니다. 따라서 FIX 메시지가 (https://github.com/apache/camel/blob/main/components/camel-bindy/src/test/data/fix/fix.txt ) 및 Order, Trailer, Header 클래스(https://github.com/apache/camel/blob/main/components/camel-bindy/src/test/java/org/apache/camel/dataformat/bindy/model/fix/simple/Order.java)와 같은 방식을 정확히 볼 수 있는 camel-bindy 테스트 케이스를 살펴 보십시오.

57.2.6. 6. KeyValuePairField

KeyValuePairField 주석은 키 값 쌍 필드의 속성을 정의합니다. 각 KeyValuePairField는 태그(= 키)와 연결된 값, 유형(문자열, int, date, …​)로 식별되며, 패턴을 선택적으로, 필드가 필요한 경우입니다.

주석 이름레코드 유형level

KeyValuePairField

키 값 쌍 - FIX

속성

매개변수 이름유형필수 항목기본값정보

tag

int

 

메시지에서 필드를 식별하는 태그(필수) - 고유해야 함

impliedDecimalSeparator

boolean

 

false

<B>Camel 2.11:</b> 지정된 위치에 표시된 소수점이 있는지 여부를 나타냅니다.

name

문자열

  

필드의 이름 (선택 사항)

패턴

문자열

  

포맷자가 데이터를 변환하는 데 사용할 패턴 (선택 사항)

위치

int

 

0

생성된 메시지의 필드 위치 - FIX 메시지에서 키/태그 위치가 달라야 하는 경우 사용해야 합니다.

Precision

int

 

0

생성할 BigDecimal 번호의 정확도

필수 항목

boolean

 

false

필드가 필수인지 여부를 나타냅니다.

timezone

문자열

  

사용할 시간대입니다.

케이스 1 : 태그

이 매개변수는 메시지의 필드 키를 나타냅니다.

수정 메시지 - 태그

@Message(keyValuePairSeparator = "=", pairSeparator = "\u0001", type="FIX", version="4.1")
public class Order {

    @Link Header header;

    @Link Trailer trailer;

    @KeyValuePairField(tag = 1) // Client reference
    private String Account;

    @KeyValuePairField(tag = 11) // Order reference
    private String ClOrdId;

    @KeyValuePairField(tag = 22) // Fund ID type (Sedol, ISIN, ...)
    private String IDSource;

    @KeyValuePairField(tag = 48) // Fund code
    private String SecurityId;

    @KeyValuePairField(tag = 54) // Movement type ( 1 = Buy, 2 = sell)
    private String Side;

    @KeyValuePairField(tag = 58) // Free text
    private String Text;
}

case 2 : 출력의 다른 위치

FIX 메시지에 배치할 태그/키를 미리 정의한 순서에 따라 정렬해야 하는 경우 주석 @KeyValuePairField 의 특성 위치를 사용합니다.

수정 메시지 - 태그 - 정렬

@Message(keyValuePairSeparator = "=", pairSeparator = "\\u0001", type = "FIX", version = "4.1", isOrdered = true)
public class Order {

    @Link Header header;

    @Link Trailer trailer;

    @KeyValuePairField(tag = 1, position = 1) // Client reference
    private String account;

    @KeyValuePairField(tag = 11, position = 3) // Order reference
    private String clOrdId;
}

57.2.7. 7. 섹션

고정 길이 레코드의 FIX 메시지에서 일반적으로 information : header, body 및 섹션 표현에 다른 섹션이 있습니다. 주석 @Section 의 목적은 모델의 어떤 클래스가 헤더(= 섹션 1), body(= 섹션 2) 및 footer(= 섹션 3)를 나타내는 바인딩에 대해 알리는 것입니다.

이 주석에는 하나의 속성/parameter만 있습니다.

주석 이름레코드 유형level

섹션

FIX

클래스

매개변수 이름유형필수 항목기본값정보

number

int

 

섹션의 수

케이스 1: 섹션

header 섹션의 정의:

FIX message - section - Header

@Section(number = 1)
public class Header {

    @KeyValuePairField(tag = 8, position = 1) // Message Header
    private String beginString;

    @KeyValuePairField(tag = 9, position = 2) // Checksum
    private int bodyLength;
}

본문 섹션의 정의:

수정 메시지 - 섹션 - body

@Section(number = 2)
@Message(keyValuePairSeparator = "=", pairSeparator = "\\u0001", type = "FIX", version = "4.1", isOrdered = true)
public class Order {

    @Link Header header;

    @Link Trailer trailer;

    @KeyValuePairField(tag = 1, position = 1) // Client reference
    private String account;

    @KeyValuePairField(tag = 11, position = 3) // Order reference
    private String clOrdId;

footer 섹션의 정의:

오류 메시지 - 섹션 -

@Section(number = 3)
public class Trailer {

    @KeyValuePairField(tag = 10, position = 1)
    // CheckSum
    private int checkSum;

    public int getCheckSum() {
        return checkSum;
    }

57.2.8. 8. OneToMany

주석 @OneToMany 의 용도는 List<?& gt; 필드로 정의되는 클래스 또는 반복적인 그룹을 포함하는 레코드에서 작업할 수 있도록 허용하는 것입니다.

참고

OneToMany
에 대한 제한 사항
: 많은 바인딩으로 인해 계층 구조의 여러 수준에 정의된 반복을 처리할 수 없습니다.

다음의 경우 OneToMany ONLY WORKS

  • 반복적인 그룹(= 태그/키 그룹)을 포함하는 FIX 메시지 읽기
  • 반복적인 데이터가 포함된 CSV 생성
주석 이름레코드 유형level

OneToMany

all

속성

매개변수 이름유형필수 항목기본값정보

mappedTo

문자열

  

List<Type of the Class>의 유형과 연관된 클래스 이름

case 1 : 반복적인 데이터로 CSV 생성

원하는 CSV 출력은 다음과 같습니다.

Claus,Ibsen,Camel in Action 1,2010,35
Claus,Ibsen,Camel in Action 2,2012,35
Claus,Ibsen,Camel in Action 3,2013,35
Claus,Ibsen,Camel in Action 4,2014,35
참고

반복적인 데이터는 책 제목과 게시 날짜의 제목과 관련된 반면, 성과 기간이 일반적이며, 이를 모델링하는 데 사용되는 클래스가 있습니다. Author 클래스에는 도서 목록이 포함되어 있습니다.

반복적인 데이터를 사용하여 CSV 생성

@CsvRecord(separator=",")
public class Author {

    @DataField(pos = 1)
    private String firstName;

    @DataField(pos = 2)
    private String lastName;

    @OneToMany
    private List<Book> books;

    @DataField(pos = 5)
    private String Age;
}

public class Book {

    @DataField(pos = 3)
    private String title;

    @DataField(pos = 4)
    private String year;
}

case 2 : 태그/키의 그룹을 포함하는 FIX 메시지 읽기

다음은 이 모델에서 수행하려는 메시지입니다.

8=FIX 4.19=2034=135=049=INVMGR56=BRKR
1=BE.CHM.00111=CHM0001-0158=this is a camel - bindy test
22=448=BE000124567854=1
22=548=BE000987654354=2
22=648=BE000999999954=3
10=220

태그 22, 48 및 54가 반복됩니다.

코드:

태그/키 그룹이 포함된 FIX 메시지 읽기

public class Order {

    @Link Header header;

    @Link Trailer trailer;

    @KeyValuePairField(tag = 1) // Client reference
    private String account;

    @KeyValuePairField(tag = 11) // Order reference
    private String clOrdId;

    @KeyValuePairField(tag = 58) // Free text
    private String text;

    @OneToMany(mappedTo = "org.apache.camel.dataformat.bindy.model.fix.complex.onetomany.Security")
    List<Security> securities;
}

public class Security {

    @KeyValuePairField(tag = 22) // Fund ID type (Sedol, ISIN, ...)
    private String idSource;

    @KeyValuePairField(tag = 48) // Fund code
    private String securityCode;

    @KeyValuePairField(tag = 54) // Movement type ( 1 = Buy, 2 = sell)
    private String side;
}

57.2.9. 9. BindyConverter

주석 @BindyConverter 의 용도는 필드 수준에서 사용할 변환기를 정의합니다. 제공된 클래스는 Format 인터페이스를 구현해야 합니다.

@FixedLengthRecord(length = 10, paddingChar = ' ')
public static class DataModel {
    @DataField(pos =  1, length = 10, trim = true)
    @BindyConverter(CustomConverter.class)
    public String field1;
}

public static class CustomConverter implements Format<String> {
    @Override
    public String format(String object) throws Exception {
        return (new StringBuilder(object)).reverse().toString();
    }

    @Override
    public String parse(String string) throws Exception {
        return (new StringBuilder(string)).reverse().toString();
    }
}

57.2.10. 10. FormatFactories

주석 @FormatFactories 의 목적은 레코드 수준에서 변환기 집합을 정의하는 것입니다. 제공된 클래스는 FormatFactoryInterface 인터페이스를 구현해야 합니다.

@CsvRecord(separator = ",")
@FormatFactories({OrderNumberFormatFactory.class})
public static class Order {

    @DataField(pos = 1)
    private OrderNumber orderNr;

    @DataField(pos = 2)
    private String firstName;
}

public static class OrderNumber {
    private int orderNr;

    public static OrderNumber ofString(String orderNumber) {
        OrderNumber result = new OrderNumber();
        result.orderNr = Integer.valueOf(orderNumber);
        return result;
    }
}

public static class OrderNumberFormatFactory extends AbstractFormatFactory {

    {
        supportedClasses.add(OrderNumber.class);
    }

    @Override
    public Format<?> build(FormattingOptions formattingOptions) {
        return new Format<OrderNumber>() {
            @Override
            public String format(OrderNumber object) throws Exception {
                return String.valueOf(object.orderNr);
            }

            @Override
            public OrderNumber parse(String string) throws Exception {
                return OrderNumber.ofString(string);
            }
        };
    }
}

57.3. 지원되는 데이터 유형

DefaultFormatFactory는 제공된 FormattingOptions를 기반으로 인터페이스 FormatFactoryInterface의 인스턴스를 반환하여 다음과 같은 데이터 유형을 사용할 수 있습니다.

  • BigDecimal
  • BigInteger
  • 부울
  • byte
  • 문자
  • 날짜
  • double
  • Enums
  • float
  • 정수
  • LocalDate
  • LocalDateTime
  • LocalTime
  • long
  • short
  • 문자열

DefaultFormatFactory는 사용 중인 레지스트리(예: spring 또는 JNDI)에서 10.0.0.1Registry 인스턴스를 제공하여 재정의할 수 있습니다.

57.4. Java DSL 사용

다음 단계에서는 이 레코드 유형과 연결된 DataFormat bindy 클래스를 인스턴스화하고 클래스를 매개변수로 제공합니다.

예를 들어 다음에서는 com.acme.model.MyModel.class 로 구성된 BindyCsvDataFormat 클래스(CSV 레코드 유형과 연결된 클래스에 해당)를 사용하여 이 패키지에 구성된 모델 개체를 초기화합니다.

DataFormat bindy = new BindyCsvDataFormat(com.acme.model.MyModel.class);

57.4.1. 로케일 설정

Bindy는 다음과 같은 데이터 형식에 대한 로케일 구성을 지원합니다.

BindyCsvDataFormat bindy = new BindyCsvDataFormat(com.acme.model.MyModel.class);

bindy.setLocale("us");

또는 플랫폼 기본 로케일을 사용하려면 로케일 이름으로 "default"를 사용합니다.

BindyCsvDataFormat bindy = new BindyCsvDataFormat(com.acme.model.MyModel.class);

bindy.setLocale("default");

57.4.2. Unmarshaling

from("file://inbox")
  .unmarshal(bindy)
  .to("direct:handleOrders");

또는 Spring XML 파일과 같이 레지스트리에 정의할 수 있는 데이터 형식에 대한 이름 지정된 참조를 사용할 수 있습니다.

from("file://inbox")
  .unmarshal("myBindyDataFormat")
  .to("direct:handleOrders");

Camel 경로는 inbox 디렉토리의 파일을 정리하고 CSV 레코드를 모델 오브젝트 컬렉션으로 분리하고 collection
handleOrders 에서 참조하는 경로로 보냅니다.

반환된 컬렉션은 Map 오브젝트의 목록입니다. 목록의 각 맵에는 CSV의 각 줄에서 마샬링된 모델 오브젝트가 포함되어 있습니다. 그 이유는 각 라인이 하나 이상의 객체에 대응할 수 있기 때문입니다. 이는 단순히 한 줄당 하나의 오브젝트가 반환될 것으로 예상할 때 혼동될 수 있습니다.

각 오브젝트는 클래스 이름을 사용하여 검색할 수 있습니다.

List<Map<String, Object>> unmarshaledModels = (List<Map<String, Object>>) exchange.getIn().getBody();

int modelCount = 0;
for (Map<String, Object> model : unmarshaledModels) {
  for (String className : model.keySet()) {
     Object obj = model.get(className);
     LOG.info("Count : " + modelCount + ", " + obj.toString());
  }
 modelCount++;
}

LOG.info("Total CSV records received by the csv bean : " + modelCount);

경로에서 처리하기 위해 이 맵에서 단일 Order 오브젝트를 추출하려는 경우 다음에 따라 Splitter와 프로세서의 조합을 사용할 수 있습니다.

from("file://inbox")
    .unmarshal(bindy)
    .split(body())
        .process(new Processor() {
            public void process(Exchange exchange) throws Exception {
                Message in = exchange.getIn();
                Map<String, Object> modelMap = (Map<String, Object>) in.getBody();
                in.setBody(modelMap.get(Order.class.getCanonicalName()));
            }
        })
        .to("direct:handleSingleOrder")
    .end();

Bindy가 Exchange 인터페이스에 정의된 것처럼, Bindy가ECDHESET_NAME 속성 또는ECDHESET_NAME 헤더를 사용하여 무제한 입력 스트림을 수신한 입력 스트림의 문자 집합 변환을 수행합니다. 일부 생산자(예: 파일-엔드 포인트)에서는 문자 세트를 정의할 수 있습니다. 이 프로듀서에서 문자 집합 변환은 이미 수행 될 수 있습니다. 때때로 이 속성이나 헤더를 마진 상태로 보내기 전에 교환에서 이 속성이나 헤더를 제거해야 하는 경우가 있습니다. 이를 제거하지 않으면 변환이 두 번 수행되어 원하지 않는 결과가 발생할 수 있습니다.

from("file://inbox?charset=Cp922")
  .removeProperty(Exchange.CHARSET_NAME)
  .unmarshal("myBindyDataFormat")
  .to("direct:handleOrders");

57.4.3. 마샬링

모델 오브젝트 컬렉션에서 CSV 레코드를 생성하려면 다음 경로를 생성합니다.

from("direct:handleOrders")
   .marshal(bindy)
   .to("file://outbox")

57.5. Spring XML 사용

이 방법은 Spring을 선호하는 DSL 언어로 사용하여 camel-bindy에 사용할 경로를 선언하는 것은 매우 쉽습니다. 다음 예제에서는 첫 번째 경로가 파일에서 레코드를 선택하고 내용을 요약하여 해당 모델에 바인딩하는 두 경로를 보여줍니다. 그 결과, pojo로 보내 특별한 아무것도 하지 않고 큐에 배치합니다.

두 번째 경로는 대기열에서 pojos를 추출하고 콘텐츠를 마샬링하여 CSV 레코드를 포함하는 파일을 생성합니다.

Spring DSL

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="
       http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://camel.apache.org/schema/spring
       http://camel.apache.org/schema/spring/camel-spring.xsd">

    <!-- Queuing engine - ActiveMq - work locally in mode virtual memory -->
    <bean id="activemq" class="org.apache.activemq.camel.component.ActiveMQComponent">
        <property name="brokerURL" value="vm://localhost:61616"/>
    </bean>

    <camelContext xmlns="http://camel.apache.org/schema/spring">
        <dataFormats>
          <bindy id="bindyDataformat" type="Csv" classType="org.apache.camel.bindy.model.Order"/>
        </dataFormats>

        <route>
            <from uri="file://src/data/csv/?noop=true" />
            <unmarshal ref="bindyDataformat" />
            <to uri="bean:csv" />
            <to uri="activemq:queue:in" />
        </route>

        <route>
            <from uri="activemq:queue:in" />
            <marshal ref="bindyDataformat" />
            <to uri="file://src/data/csv/out/" />
        </route>
    </camelContext>
</beans>

참고

대기열 관리자가 오류를 발생시킬 예정이 없는 경우 모델 클래스가 직렬화 가능한지 확인하십시오.

57.6. 종속 항목

camel 경로에서 Bindy를 사용하려면 이 데이터 형식을 구현하는 camel-bindy 에 대한 종속성을 추가해야 합니다.

maven을 사용하는 경우 pom.xml에 다음을 추가하여 최신 & 가장 큰 릴리스 버전 번호를 대체할 수 있습니다 (최신 버전의 다운로드 페이지 참조).

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-bindy</artifactId>
  <version>{CamelSBVersion}</version>
</dependency>

57.7. Spring Boot Auto-Configuration

Spring Boot와 함께 bindy-csv를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-bindy-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.dataformat.bindy-csv.allow-empty-stream

요약되지 않은 프로세스에서 빈 스트림을 허용할지 여부입니다. true인 경우 레코드가 없는 본문이 제공되면 예외가 발생하지 않습니다.

false

부울

camel.dataformat.bindy-csv.class-type

사용할 모델 클래스의 이름입니다.

 

문자열

camel.dataformat.bindy-csv.enabled

bindy-csv 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.bindy-csv.locale

단위 상태의 경우와 같이 사용할 기본 로케일을 구성하려면 다음을 수행합니다. JVM 플랫폼 기본 로케일을 사용하려면 기본값을 사용합니다.

 

문자열

camel.dataformat.bindy-csv.type

Csv, Fixed 또는 KeyValue 사용 여부입니다.

 

문자열

camel.dataformat.bindy-csv.unwrap-single-instance

요약을 해제하는 경우 단일 인스턴스를 래핑 해제하여 java.util.List로 래핑하는 대신 반환해야 합니다.

true

부울

camel.dataformat.bindy-fixed.allow-empty-stream

요약되지 않은 프로세스에서 빈 스트림을 허용할지 여부입니다. true인 경우 레코드가 없는 본문이 제공되면 예외가 발생하지 않습니다.

false

부울

camel.dataformat.bindy-fixed.class-type

사용할 모델 클래스의 이름입니다.

 

문자열

camel.dataformat.bindy-fixed.enabled

bindy-fixed 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.bindy-fixed.locale

단위 상태의 경우와 같이 사용할 기본 로케일을 구성하려면 다음을 수행합니다. JVM 플랫폼 기본 로케일을 사용하려면 기본값을 사용합니다.

 

문자열

camel.dataformat.bindy-fixed.type

Csv, Fixed 또는 KeyValue 사용 여부입니다.

 

문자열

camel.dataformat.bindy-fixed.unwrap-single-instance

요약을 해제하는 경우 단일 인스턴스를 래핑 해제하여 java.util.List로 래핑하는 대신 반환해야 합니다.

true

부울

camel.dataformat.bindy-kvp.allow-empty-stream

요약되지 않은 프로세스에서 빈 스트림을 허용할지 여부입니다. true인 경우 레코드가 없는 본문이 제공되면 예외가 발생하지 않습니다.

false

부울

camel.dataformat.bindy-kvp.class-type

사용할 모델 클래스의 이름입니다.

 

문자열

camel.dataformat.bindy-kvp.enabled

bindy-kvp 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.bindy-kvp.locale

단위 상태의 경우와 같이 사용할 기본 로케일을 구성하려면 다음을 수행합니다. JVM 플랫폼 기본 로케일을 사용하려면 기본값을 사용합니다.

 

문자열

camel.dataformat.bindy-kvp.type

Csv, Fixed 또는 KeyValue 사용 여부입니다.

 

문자열

camel.dataformat.bindy-kvp.unwrap-single-instance

요약을 해제하는 경우 단일 인스턴스를 래핑 해제하여 java.util.List로 래핑하는 대신 반환해야 합니다.

true

부울

58장. HL7

HL7 구성 요소는 HAPI 라이브러리를 사용하여 HL7 MLLP 프로토콜 및 HL7 v2 메시지 작업에 사용됩니다.

이 구성 요소는 다음을 지원합니다.

  • HL7 MLLP codec for Mina
  • Netty에 대한 HL7 MLLP codec
  • 유형 from/to HAPI 및 String
  • HAPI 라이브러리를 사용한 HL7 DataFormat

Maven 사용자는 이 구성 요소에 대해 pom.xml 에 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-hl7</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

58.1. HL7 MLLP 프로토콜

HL7은 텍스트 기반 TCP 소켓 기반 프로토콜인 HL7 MLLP 프로토콜과 함께 자주 사용됩니다. 이 구성 요소에는 MLLP 프로토콜을 준수하는 Mina 및 Netty Codec가 포함되어 있으므로 TCP 전송 계층을 통해 HL7 요청을 수락하는 HL7 리스너를 쉽게 노출할 수 있습니다. HL7 리스너 서비스를 노출하기 위해 camel-mina 또는 link:camel-netty 구성 요소는 HL7MLLPLLPCodec (mina) 또는 HL7MLLPNettyDecoder/HL7MLLPNettyEncoder (NettytytyEncoder)와 함께 사용됩니다.

HL7 MLLP codec는 다음과 같이 구성할 수 있습니다.

이름기본값설명

startByte

0x0b

HL7 페이로드에 전달되는 시작 바이트입니다.

endByte1

0x1c

HL7 페이로드를 포함하는 첫 번째 엔드 바이트입니다.

endByte2

0x0d

두 번째 엔드 바이트는 HL7 페이로드에 걸쳐 있습니다.

charset

JVM 기본값

codec에 사용할 인코딩(Char set 이름)입니다. 제공되지 않는 경우 Camel은 JVM 기본 collectdset를 사용합니다.

produceString

true

true인 경우 codec는 정의된 gRPCset를 사용하여 문자열을 생성합니다. false인 경우 codec는 일반 바이트 배열을 경로로 보내 HL7 데이터 형식이 HL7 메시지 콘텐츠에서 실제 줄임 세트를 결정할 수 있습니다.

convertLFtoCR

false

\n을 \n\r (0x0d, 13 10 진수)로 변환합니다. HL7은 \r 을 세그먼트 종료자로 stipulates \r로 설정합니다. HAPI 라이브러리에서는 \r 을 사용해야 합니다.

58.1.1. Mina를 사용하여 HL7 리스너 노출

Spring XML 파일에서는 포트 8888 에서 TCP를 사용하여 HL7 요청을 수신 대기하도록 mina 엔드포인트를 구성합니다.

<endpoint id="hl7MinaListener" uri="mina:tcp://localhost:8888?sync=true&amp;codec=#hl7codec"/>

sync=true 는 이 리스너가 동기적이므로 호출자에게 HL7 응답을 반환함을 나타냅니다. HL7 코드c는 codec=#>-<7codec를 사용하여 설정됩니다. >-< 7codec 는 Spring console ID이므로 이름이 mygrallycodecfor>-<7 또는 기타 항목으로 지정될 수 있습니다. 코드c는 Spring XML 파일에서도 설정됩니다.

<bean id="hl7codec" class="org.apache.camel.component.hl7.HL7MLLPCodec">
    <property name="charset" value="iso-8859-1"/>
</bean>

다음 엔드포인트 >-<7MinaLlistener 는 다음 Java DSL 예제로 경로에서 소비자로 사용할 수 있습니다.

from("hl7MinaListener")
  .bean("patientLookupService");

이것은 HL7을 청취하고 patientLookupService 라는 서비스로 라우팅하는 매우 간단한 경로입니다. Spring Console ID도 Spring XML에서 다음과 같이 구성됩니다.

<bean id="patientLookupService" class="com.mycompany.healthcare.service.PatientLookupService"/>

비즈니스 로직은 다음과 같이 Camel에 의존하지 않는 gRPC 클래스에서 구현할 수 있습니다.

import ca.uhn.hl7v2.HL7Exception;
import ca.uhn.hl7v2.model.Message;
import ca.uhn.hl7v2.model.v24.segment.QRD;

public class PatientLookupService {
    public Message lookupPatient(Message input) throws HL7Exception {
        QRD qrd = (QRD)input.get("QRD");
        String patientId = qrd.getWhoSubjectFilter(0).getIDNumber().getValue();

        // find patient data based on the patient id and create a HL7 model object with the response
        Message response = ... create and set response data
        return response
    }

58.1.2. Netty를 사용하여 HL7 리스너 노출( Camel 2.15에서 제공)

Spring XML 파일에서는 포트 8888 에서 TCP를 사용하여 HL7 요청을 수신 대기하도록 netty 엔드포인트를 구성합니다.

<endpoint id="hl7NettyListener" uri="netty:tcp://localhost:8888?sync=true&amp;encoders=#hl7encoder&amp;decoders=#hl7decoder"/>

sync=true 는 이 리스너가 동기적이므로 호출자에게 HL7 응답을 반환함을 나타냅니다. HL7 codec는 encoders=#>-<7encoder*and*decoders=#ECDHE7decoder로 설정됩니다. ECDHE 7encoder 및 ECDHE 7decoder 는 빈 ID일 뿐입니다. 따라서 이름이 다르게 지정될 수 있습니다. 빈은 Spring XML 파일에서 설정할 수 있습니다.

<bean id="hl7decoder" class="org.apache.camel.component.hl7.HL7MLLPNettyDecoderFactory"/>
<bean id="hl7encoder" class="org.apache.camel.component.hl7.HL7MLLPNettyEncoderFactory"/>

다음 엔드포인트 >-<7NettyListener 는 이 Java DSL 예제가 표시되어 있는 경로에서 소비자로 사용할 수 있습니다.

from("hl7NettyListener")
  .bean("patientLookupService");

58.2. java.lang.String 또는 byte[]를 사용한 HL7 모델

HL7 MLLP codec는 일반 String을 데이터 형식으로 사용합니다. Camel은 문자열로 변환/from을 HAPI HL7 모델 개체로 변환하는 데 해당 유형의 유형을 사용하지만 원하는 경우 데이터를 직접 구문 분석하려는 경우 일반 문자열 오브젝트를 사용할 수 있습니다.

또한, produceString 속성을 false로 설정하여 Mina 및 Netty codecs가 일반 byte[] 를 데이터 형식으로 사용하도록 할 수도 있습니다. TypeECDHE는 byte[] 를 HAPI HL7 모델 오브젝트로 변환할 수도 있습니다.

58.3. HAPI를 사용하는 HL7v2 모델

HL7v2 모델은 HAPI 라이브러리의 Java 개체를 사용합니다. 이 라이브러리를 사용하면 HL7v2와 대부분 사용되는 EDI 형식(ER7)에서 인코딩 및 디코딩할 수 있습니다.

아래 샘플은 환자 ID가 0101701234 인 환자 조회 요청입니다.

MSH|^~\\&|MYSENDER|MYRECEIVER|MYAPPLICATION||200612211200||QRY^A19|1234|P|2.4
QRD|200612211200|R|I|GetPatient|||1^RD|0101701234|DEM||

HL7 모델을 사용하면 다음과 같이 ca.uhn.>-<7v2.model.Message 개체로 작업하여 환자 ID를 검색할 수 있습니다.

Message msg = exchange.getIn().getBody(Message.class);
QRD qrd = (QRD)msg.get("QRD");
String patientId = qrd.getWhoSubjectFilter(0).getIDNumber().getValue();  // 0101701234

이는 HL7 리스너와 결합할 때 강력합니다. byte[], 문자열 또는 기타 간단한 개체 형식으로 작업할 필요가 없기 때문입니다. HAPI HL7v2 모델 개체만 사용할 수 있습니다. 사전에 메시지 유형을 알고 있는 경우 더 많은 형식이 안전할 수 있습니다.

QRY_A19 msg = exchange.getIn().getBody(QRY_A19.class);
String patientId = msg.getQRD().getWhoSubjectFilter(0).getIDNumber().getValue();

58.4. HL7 DataFormat

camel->-<7 JAR은 HL7 모델 오브젝트를 마샬링하거나 해제하는 데 사용할 수 있는 HL7 데이터 형식과 함께 제공됩니다.

HL7 데이터 포맷은 아래에 나열된 1개의 옵션을 지원합니다.

이름DefaultJava Type설명

검증

 

부울

HL7 메시지의 유효성 검사는 기본적으로 true입니다.

  • Marshal = Message에서 바이트 스트림까지 (HL7 MLLP codec를 사용하여 응답할 때 사용할 수 있음)
  • Unmarshal = 바이트 스트림에서 Message (HL7 MLLP에서 스트리밍된 데이터를 수신할 때 사용할 수 있음)

데이터 형식을 사용하려면 인스턴스를 인스턴스화하고 경로 빌더에서 marshal 또는 Unmarshal 작업을 호출하기만 하면 됩니다.

  DataFormat hl7 = new HL7DataFormat();

  from("direct:hl7in")
    .marshal(hl7)
    .to("jms:queue:hl7out");

위의 샘플에서 HL7은 HAPI Message 오브젝트에서 바이트 스트림으로 마샬링되고 JMS 큐에 배치됩니다.
다음은 그 반대의 예입니다.

  DataFormat hl7 = new HL7DataFormat();

  from("jms:queue:hl7out")
    .unmarshal(hl7)
    .to("patientLookupService");

여기서는 바이트 스트림을 환자 조회 서비스로 전달되는 HAPI Message 오브젝트로 요약합니다.

58.4.1. 세그먼트 구분 기호

Unmarshalling은 \n\r 로 변환하여 더 이상 세그먼트 구분자를 자동으로 수정하지 않습니다. 이 변환이 필요한 경우 org.apache.camel.component.anchor7.HL7#convertLFToCR 은 이러한 목적으로 용인 표현식 을 제공합니다.

58.4.2. grafset

마샬링 및 unmarshalMSH-18 필드에 제공된charset을 평가합니다. 이 필드가 비어 있는 경우 기본적으로 해당 Camel hadset 속성/header에 포함된charset가 가정됩니다. HL7DataFormat 클래스에서 상속할 때 guessCharsetName 메서드를 재정의하여 이 기본 동작을 변경할 수도 있습니다.

Camel에는 일반적으로 사용되는 잘 알려진 데이터 형식에 대한 간단한 구문이 있습니다. 그런 다음 HL7DataFormat 개체의 인스턴스를 만들 필요가 없습니다.

  from("direct:hl7in")
    .marshal().hl7()
    .to("jms:queue:hl7out");

  from("jms:queue:hl7out")
    .unmarshal().hl7()
    .to("patientLookupService");

58.5. 메시지 헤더

무수한 작업에서는 MSH 세그먼트에서 Camel 메시지의 헤더로 이러한 필드를 추가합니다.

MSH 필드예제

CamelHL7SendingApplication

MSH-3

MYSERVER

CamelHL7SendingFacility

MSH-4

MYSERVERAPP

CamelHL7ReceivingApplication

MSH-5

MYCLIENT

CamelHL7ReceivingFacility

MSH-6

MYCLIENTAPP

CamelHL7Timestamp

MSH-7

20071231235900

CamelHL7Security

MSH-8

null

CamelHL7MessageType

MSH-9-1

ADT

CamelHL7TriggerEvent

MSH-9-2

A01

CamelHL7MessageControl

MSH-10

1234

CamelHL7ProcessingId

MSH-11

P

CamelHL7VersionId

MSH-12

2.4

CamelHL7Context

``

메시지를 구문 분석하는 데 사용된 정보를 포함합니다.

CamelHL7Charset

MSH-18

UNICODE UTF-8

CamelHL7Context 를 제외한 모든 헤더는 문자열 유형입니다. 헤더 값이 누락되면 해당 값은 null 입니다.

58.6. 종속 항목

Camel 경로에서 HL7을 사용하려면 위에 나열된 camel-ECDHE7 에 대한 종속성을 추가해야 합니다. 이 데이터 형식을 구현합니다.

HAPI 라이브러리는 기본 라이브러리와 여러 구조 라이브러리로 분할되며 각 HL7v2 메시지 버전에 대해 하나씩 제공됩니다.

기본적으로 camel->-<7 은 HAPI 기본 라이브러리 만 참조합니다. 애플리케이션은 자체 구조 라이브러리를 포함해야 합니다. 예를 들어, 애플리케이션이 HL7v2 메시지 버전 2.4 및 2.5에서 작동하는 경우 다음 종속성을 추가해야 합니다.

<dependency>
    <groupId>ca.uhn.hapi</groupId>
    <artifactId>hapi-structures-v24</artifactId>
    <version>2.2</version>
    <!-- use the same version as your hapi-base version -->
</dependency>
<dependency>
    <groupId>ca.uhn.hapi</groupId>
    <artifactId>hapi-structures-v25</artifactId>
    <version>2.2</version>
    <!-- use the same version as your hapi-base version -->
</dependency>

또는 기본 라이브러리, 모든 구조 라이브러리 및 필요한 종속 항목( 번들 클래스 경로)을 중앙 Maven 리포지토리에서 다운로드할 수 있습니다.

<dependency>
    <groupId>ca.uhn.hapi</groupId>
    <artifactId>hapi-osgi-base</artifactId>
    <version>2.2</version>
</dependency>

58.7. Spring Boot Auto-Configuration

Spring Boot와 함께 >-<7을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-hl7-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.dataformat.hl7.enabled

ECDHE7 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.hl7.validate

HL7 메시지의 유효성 검사는 기본적으로 true입니다.

true

부울

camel.language.hl7terser.enabled

ECDHE7terer 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.hl7terser.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

59장. JacksonXML

jackson XML은 XML 페이로드를 Java 객체로 요약하거나 Java 개체를 XML 페이로드로 마샬링하기 위해 XMLMapper 확장 과 함께 Jackson 라이브러리를 사용하는 데이터 형식입니다. 참고: Jackson에 익숙한 경우 이 XML 데이터 형식은 JSON 대응과 동일한 방식으로 작동하므로 JSON serialization/deserialization에 대해 주석이 달린 클래스와 함께 사용할 수 있습니다.

이 확장은 또한 mimics #177B의 "코드 첫 번째" 접근 방식입니다.

이 데이터 형식은 Woodstox (특히 인쇄와 같은 기능, 빠르고 효율적인 XML 프로세서의 경우)에 의존합니다.

from("activemq:My.Queue").
  unmarshal().jacksonxml().
  to("mqseries:Another.Queue");

59.1. JacksonXML Options

jacksonXML 데이터 포맷은 아래에 나열된 15 가지 옵션을 지원합니다.

이름DefaultJava Type설명

xmlMapper

 

문자열

기존 ECDHEMapper를 조회하고 지정된 ID와 함께 사용합니다.

prettyPrint

false

부울

출력을 완벽하게 포맷할 수 있도록 하려면 다음을 수행하십시오. 기본값은 false입니다.

unmarshalType

 

문자열

요약할 때 사용할 Java 유형의 클래스 이름입니다.

jsonView

 

문자열

ScanSetting을 JSON으로 마샬링할 때 JSON 출력에서 특정 필드를 제외할 수 있습니다. Jackson을 사용하면 JSON 보기를 사용하여 이 작업을 수행할 수 있습니다. 이 옵션은 JsonView 주석이 있는 클래스를 참조하는 것입니다.

include

 

문자열

pojo를 JSON으로 마샬링하려면 pojo에 null 값이 있는 일부 필드가 있습니다. 이러한 null 값을 건너뛰려면 이 옵션을 NON_NULL로 설정할 수 있습니다.

allowJmsType

 

부울

JMS 사용자가 JMS 사양의 JMSType 헤더가 요약을 해제하는 데 사용할 FQN 클래스 이름을 지정할 수 있도록 허용합니다.

collectionType

 

문자열

사용할 레지스트리의 조회할 사용자 정의 컬렉션 유형을 나타냅니다. 이 옵션은 거의 사용되지 않지만 java.util.ECDHE 기반 컬렉션 유형과 다른 컬렉션 유형을 기본값으로 사용할 수 있습니다.

useList

 

부울

Map 목록 또는 Pojo 목록으로 요약할 수 있습니다.

enableJaxbAnnotationModule

 

부울

jackson을 사용할 때>-<B 주석 모듈을 활성화할지 여부입니다. 활성화되면 jackson에서tedB 주석을 사용할 수 있습니다.

moduleClassNames

 

문자열

사용자 지정 Jackson 모듈 com.fasterxml.jackson.databind.Module을 FQN 클래스 이름으로 String으로 지정합니다. 여러 클래스를 쉼표로 구분할 수 있습니다.

moduleRefs

 

문자열

Camel 레지스트리에서 언급한 사용자 지정 Jackson 모듈을 사용하려면 다음을 수행하십시오. 여러 모듈은 쉼표로 구분할 수 있습니다.

enableFeatures

 

문자열

jackson com.fasterxml.jackson.databind.ObjectMapper에서 활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

disableFeatures

 

문자열

jackson com.fasterxml.jackson.databind.ObjectMapper에서 비활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

allowUnmarshallType

 

부울

활성화하면 Jackson이 축소되지 않는 동안 CamelJacksonUnmarshalType 헤더를 사용할 수 있습니다. 이 기능은 사용하려는 경우에만 활성화해야 합니다.

contentTypeHeader

 

부울

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

59.1.1. Spring DSL에서 Jackson XML 사용

Spring DSL에서 데이터 형식을 사용할 때 먼저 데이터 형식을 선언해야 합니다. 이 작업은 DataFormats XML 태그에서 수행됩니다.

        <dataFormats>
            <!-- here we define a Xml data format with the id jack and that it should use the TestPojo as the class type when
                 doing unmarshal. The unmarshalType is optional, if not provided Camel will use a Map as the type -->
            <jacksonxml id="jack" unmarshalType="org.apache.camel.component.jacksonxml.TestPojo"/>
        </dataFormats>

그런 다음 경로에서 이 ID를 참조할 수 있습니다.

       <route>
            <from uri="direct:back"/>
            <unmarshal><custom ref="jack"/></unmarshal>
            <to uri="mock:reverse"/>
        </route>

59.1.2. 마샬링에서 CloudEvent 필드 제외

gRPC를 XML로 마샬링할 때 XML 출력에서 특정 필드를 제외할 수 있습니다. Jackson을 사용하면 JSON 보기 를 사용하여 이 작업을 수행할 수 있습니다. 먼저 하나 이상의 마커 클래스를 생성합니다.

@JsonView 주석과 함께 마커 클래스를 사용하여 특정 필드를 포함/Exclude합니다. 주석은 getter에서도 작동합니다.

마지막으로 Camel JacksonXMLDataFormat 을 사용하여 위의 ScanSetting을 XML로 마샬링합니다.

결과 XML에는 weight 필드가 누락되어 있습니다.

<pojo age="30" weight="70"/>

59.2. 'JacksonXML'DataFormat으로 jsonView 특성을 사용한 포함/Exclude 필드

이 특성을 사용하는 예는 다음과 같습니다.

JacksonXMLDataFormat ageViewFormat = new JacksonXMLDataFormat(TestPojoView.class, Views.Age.class);
from("direct:inPojoAgeView").
  marshal(ageViewFormat);

Java DSL 내에서 JSON 보기 를 다음과 같이 직접 지정합니다.

from("direct:inPojoAgeView").
  marshal().jacksonxml(TestPojoView.class, Views.Age.class);

XML DSL과 동일합니다.

<from uri="direct:inPojoAgeView"/>
  <marshal>
    <jacksonxml unmarshalType="org.apache.camel.component.jacksonxml.TestPojoView" jsonView="org.apache.camel.component.jacksonxml.Views$Age"/>
  </marshal>

59.3. 직렬화 설정에는 옵션이 포함됩니다.

pojo를 XML로 마샬링하려면 pojo에 null 값이 있는 일부 필드가 있습니다. 그리고 이러한 null 값을 건너뛰려면 pojo에 주석을 설정해야 합니다.

@JsonInclude(Include.NON_NULL)
public class MyPojo {
   ...
}

그러나 이를 위해서는 해당 주석을 pojo 소스 코드에 포함해야 합니다. 다음과 같이 Camel JacksonXMLDataFormat을 구성하여 포함 옵션을 설정할 수도 있습니다.

JacksonXMLDataFormat format = new JacksonXMLDataFormat();
format.setInclude("NON_NULL");

또는 XML DSL에서 이 값을 다음과 같이 구성합니다.

    <dataFormats>
      <jacksonxml id="jacksonxml" include="NON_NULL"/>
    </dataFormats>

59.4. 동적 클래스 이름을 사용하여 XML에서 iPXE로 요약 해제

jackson을 사용하여 XML을marshal으로 해제하는 경우 이제 표시할 클래스 이름을 나타내는 헤더를 메시지에 지정할 수 있습니다.
해당 헤더가 메시지에 있는 경우 헤더에 키 CamelJacksonUnmarshalType 이 있는 경우 Jackson은 해당 헤더를 FQN으로 사용하여 XML 페이로드를 로 요약합니다.

 For JMS end users there is the JMSType header from the JMS spec that
indicates that also. To enable support for JMSType you would need to
turn that on, on the jackson data format as shown:
JacksonDataFormat format = new JacksonDataFormat();
format.setAllowJmsType(true);

또는 XML DSL에서 이 값을 다음과 같이 구성합니다.

    <dataFormats>
      <jacksonxml id="jacksonxml" allowJmsType="true"/>
    </dataFormats>

59.5. XML에서 List<Map> 또는 List<pojo>로 요약 해제

Jackson을 사용하여 map/pojo의 목록에 XML을 압축 해제하는 경우 useList="true" 를 설정하거나 org.apache.camel.component.jacksonxml.ListJacksonxml.ListJacksonXMLDataFormat 을 사용하여 이를 지정할 수 있습니다. 예를 들어 Java를 사용하면 다음과 같이 수행할 수 있습니다.

JacksonXMLDataFormat format = new ListJacksonXMLDataFormat();
// or
JacksonXMLDataFormat format = new JacksonXMLDataFormat();
format.useList();
// and you can specify the pojo class type also
format.setUnmarshalType(MyPojo.class);

그리고 XML DSL을 사용하는 경우 아래와 같이 useList 특성을 사용하여 목록을 사용하도록 구성합니다.

    <dataFormats>
      <jacksonxml id="jack" useList="true"/>
    </dataFormats>

또한 pojo 유형을 지정할 수 있습니다.

    <dataFormats>
      <jacksonxml id="jack" useList="true" unmarshalType="com.foo.MyPojo"/>
    </dataFormats>

59.6. 사용자 정의 Jackson 모듈 사용

아래와 같이 moduleClassNames 옵션을 사용하여 사용자 정의 Jackson 모듈을 사용할 수 있습니다.

    <dataFormats>
      <jacksonxml id="jack" useList="true" unmarshalType="com.foo.MyPojo" moduleClassNames="com.foo.MyModule,com.foo.MyOtherModule"/>
    </dataFormats>

moduleClassNames를 사용하는 경우 기본 생성자를 사용하여 생성하고 그대로 사용되는 사용자 정의 jackson 모듈이 구성되지 않습니다. 사용자 지정 모듈에 사용자 지정 구성이 필요한 경우 모듈 인스턴스를 생성하고 구성한 다음 modulesRefs를 사용하여 아래와 같이 모듈을 참조할 수 있습니다.

    <bean id="myJacksonModule" class="com.foo.MyModule">
      ... // configure the module as you want
    </bean>

    <dataFormats>
      <jacksonxml id="jacksonxml" useList="true" unmarshalType="com.foo.MyPojo" moduleRefs="myJacksonModule"/>
    </dataFormats>
 Multiple modules can be specified separated by comma, such as
moduleRefs="myJacksonModule,myOtherModule"

59.7. Jackson을 사용하여 기능 활성화 또는 비활성화

Jackson에는 ObjectMapper가 사용하는 활성화 또는 비활성화할 수 있는 여러 기능이 있습니다. 예를 들어 마샬링 시 알 수 없는 속성에서 실패를 비활성화하려면 disableFoyures를 사용하여 이 값을 구성할 수 있습니다.

 <dataFormats>
      <jacksonxml id="jacksonxml" unmarshalType="com.foo.MyPojo" disableFeatures="FAIL_ON_UNKNOWN_PROPERTIES"/>
 </dataFormats>

쉼표로 값을 분리하여 여러 기능을 비활성화할 수 있습니다. 기능에 대한 값은 다음 CloudEvent 클래스의 Jackson의 CloudEvents 이름이어야 합니다.

  • com.fasterxml.jackson.databind.SerializationFeature
  • com.fasterxml.jackson.databind.DeserializationFeature
  • com.fasterxml.jackson.databind.MapperFeature

기능을 활성화하려면 대신 enableFundures 옵션을 사용합니다.

Java 코드에서 camel-jackson 모듈의 형식 안전 방법을 사용할 수 있습니다.

JacksonDataFormat df = new JacksonDataFormat(MyPojo.class);
df.disableFeature(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
df.disableFeature(DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES);

59.8. jackson을 사용하여 Maps to 10.0.0.1 변환

jackson ObjectMapper 를 사용하여 map을 gRPC 개체로 변환할 수 있습니다. jackson 구성 요소에는 java.util.Map 인스턴스를 문자열이 아닌, 숫자 이외의 개체로 변환하는 데 사용할 수 있는 데이터 변환기가 포함되어 있습니다.

Map<String, Object> invoiceData = new HashMap<String, Object>();
invoiceData.put("netValue", 500);
producerTemplate.sendBody("direct:mapToInvoice", invoiceData);
...
// Later in the processor
Invoice invoice = exchange.getIn().getBody(Invoice.class);

Camel 레지스트리에 사용할 수 있는 단일 ObjectMapper 인스턴스가 있는 경우 변환기에서 변환을 수행하는 데 사용됩니다. 그렇지 않으면 기본 매퍼가 사용됩니다.

59.9. 포맷된 XML 마샬링(pretty-printing)

pretty iPXE 옵션을 사용하면 마샬링하는 동안 잘 포맷된 XML을 출력할 수 있습니다.

 <dataFormats>
      <jacksonxml id="jack" prettyPrint="true"/>
 </dataFormats>

Java DSL의 경우:

from("direct:inPretty").marshal().jacksonxml(true);

5 다른 오버로드된 jacksonxml() DSL 방법이 있습니다. 이 방법은 마진 유형,jsonView 등에 대한 다른 설정과 조합되어 있습니다.

59.10. 종속 항목

camel 경로에서 Jackson XML을 사용하려면 이 데이터 형식을 구현하는 camel-jacksonxml 에 대한 종속성을 추가해야 합니다.

maven을 사용하는 경우 pom.xml에 다음을 추가하여 최신 & 가장 큰 릴리스 버전 번호를 대체할 수 있습니다 (최신 버전의 다운로드 페이지 참조).

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-jacksonxml</artifactId>
  <version>{CamelSBVersion}</version>
  <!-- use the same version as your Camel core version -->
</dependency>

59.11. Spring Boot Auto-Configuration

Spring Boot와 함께 jacksonxml을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-jacksonxml-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.dataformat.jacksonxml.allow-jms-type

JMS 사용자가 JMS 사양의 JMSType 헤더가 요약을 해제하는 데 사용할 FQN 클래스 이름을 지정할 수 있도록 허용합니다.

false

부울

camel.dataformat.jacksonxml.allow-unmarshall-type

활성화하면 Jackson이 축소되지 않는 동안 CamelJacksonUnmarshalType 헤더를 사용할 수 있습니다. 이 기능은 사용하려는 경우에만 활성화해야 합니다.

false

부울

camel.dataformat.jacksonxml.collection-type

사용할 레지스트리의 조회할 사용자 정의 컬렉션 유형을 나타냅니다. 이 옵션은 거의 사용되지 않지만 java.util.ECDHE 기반 컬렉션 유형과 다른 컬렉션 유형을 기본값으로 사용할 수 있습니다.

 

문자열

camel.dataformat.jacksonxml.content-type-header

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

true

부울

camel.dataformat.jacksonxml.disable-features

jackson com.fasterxml.jackson.databind.ObjectMapper에서 비활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

 

문자열

camel.dataformat.jacksonxml.enable-features

jackson com.fasterxml.jackson.databind.ObjectMapper에서 활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

 

문자열

camel.dataformat.jacksonxml.enable-jaxb-annotation-module

jackson을 사용할 때>-<B 주석 모듈을 활성화할지 여부입니다. 활성화되면 jackson에서tedB 주석을 사용할 수 있습니다.

false

부울

camel.dataformat.jacksonxml.enabled

jacksonxml 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.jacksonxml.include

pojo를 JSON으로 마샬링하려면 pojo에 null 값이 있는 일부 필드가 있습니다. 이러한 null 값을 건너뛰려면 이 옵션을 NON_NULL로 설정할 수 있습니다.

 

문자열

camel.dataformat.jacksonxml.json-view

ScanSetting을 JSON으로 마샬링할 때 JSON 출력에서 특정 필드를 제외할 수 있습니다. Jackson을 사용하면 JSON 보기를 사용하여 이 작업을 수행할 수 있습니다. 이 옵션은 JsonView 주석이 있는 클래스를 참조하는 것입니다.

 

문자열

camel.dataformat.jacksonxml.module-class-names

사용자 지정 Jackson 모듈 com.fasterxml.jackson.databind.Module을 FQN 클래스 이름으로 String으로 지정합니다. 여러 클래스를 쉼표로 구분할 수 있습니다.

 

문자열

camel.dataformat.jacksonxml.module-refs

Camel 레지스트리에서 언급한 사용자 지정 Jackson 모듈을 사용하려면 다음을 수행하십시오. 여러 모듈은 쉼표로 구분할 수 있습니다.

 

문자열

camel.dataformat.jacksonxml.pretty-print

출력을 완벽하게 포맷할 수 있도록 하려면 다음을 수행하십시오. 기본값은 false입니다.

false

부울

camel.dataformat.jacksonxml.unmarshal-type

요약할 때 사용할 Java 유형의 클래스 이름입니다.

 

문자열

camel.dataformat.jacksonxml.use-list

Map 목록 또는 Pojo 목록으로 요약할 수 있습니다.

false

부울

camel.dataformat.jacksonxml.xml-mapper

기존 ECDHEMapper를 조회하고 지정된 ID와 함께 사용합니다.

 

문자열

60장. JAXB

CloudEventB는 Java 6에 포함된 CloudEventB2 XML 마샬링 표준을 사용하여 XML 페이로드를 Java 객체로 요약하거나 Java 오브젝트를 XML 페이로드로 마샬링하는 데이터 형식입니다.

60.1. 옵션

#177B 데이터 형식은 아래에 나열된 19 가지 옵션을 지원합니다.

이름DefaultJava Type설명

contextPath

 

문자열

필요한 패키지 이름입니다.B 클래스가 있는 경우 필수 패키지 이름입니다.

contextPathIsClassName

 

부울

이는 contextPath가 패키지 이름이 아니라 classname을 참조하고 있음을 표시하기 위해 true로 설정할 수 있습니다.

schema

 

문자열

기존 스키마에 대해 검증하려면 다음을 수행합니다. classpath:, file: 또는 http 접두사를 사용하여 리소스를 해결하는 방법을 지정할 수 있습니다. ',' 문자를 사용하여 여러 스키마 파일을 분리할 수 있습니다.

schemaSeverityLevel

 

Enum

스키마에 대해 유효성을 검사할 때 사용할 스키마 심각도 수준을 설정합니다. 이 수준은 계속 구문 분석을 중지하도록 CloudEventB를 트리거하는 최소 심각도 오류를 결정합니다. 기본값은 오류(경고, 오류 또는 치명적 오류)가 트리거된 모든 오류(경고, 오류 또는 치명적 오류)가 중지됨을 나타냅니다. 세 가지 수준은 다음과 같습니다. 0=warning, 1=error, 2=fatal error.

CloudEvent 값:

  • 0
  • 1
  • 2

prettyPrint

 

부울

출력을 완벽하게 포맷할 수 있도록 하려면 다음을 수행하십시오. 기본값은 false입니다.

objectFactory

 

부울

ObjectFactory 클래스를 사용하여 마샬링 중 gRPC 클래스를 생성할 수 있는지 여부입니다. 이는 CloudEventB로 주석이 추가되지 않고 jvncb.index 설명자 파일을 제공하는 CloudEvent 클래스에만 적용됩니다.

ignoreJAXBElement

 

부울

무시할지 여부 - 매우 특별한 사용 사례에서만 false로 설정해야합니다.

mustBeJAXBElement

 

부울

Marhsalling이 CloudEventB 주석이 있는 java 오브젝트여야 하는지 여부. 그렇지 않으면 실패합니다. 이 옵션을 false로 설정하여 데이터가 이미 XML 형식으로 되어 있는 경우와 같이 완화할 수 있습니다.

filterNonXmlChars

 

부울

비 xml hadacheters를 무시하고 빈 공간으로 교체하려면 다음을 수행하십시오.

인코딩

 

문자열

특정 인코딩을 덮어쓰고 사용하려면 다음을 수행합니다.

조각

 

부울

XML 조각 트리 마샬링을 설정하려면 다음을 수행하십시오. 기본적으로 B는 지정된 클래스에서 전체 XML 트리에서 작동하도록 ECDHERootECDHE 주석을 찾습니다. 이 기능은 유용하지만 항상 그렇지는 않지만 생성되는 코드에는 ECDHERootECDHE 주석이 없는 경우가 있으며 트리의 일부만 필요한 경우도 있습니다. 이 경우 부분적인 요약을 사용할 수 있습니다. 이 동작을 활성화하려면 속성 partClass를 설정해야 합니다. Camel은 이 클래스를marshaler에 전달합니다.

partClass

 

문자열

조각 구문 분석에 사용되는 클래스의 이름입니다. fragment 옵션에서 자세한 내용을 참조하십시오.

partNamespace

 

문자열

조각 구문 분석에 사용할 XML 네임스페이스입니다. fragment 옵션에서 자세한 내용을 참조하십시오.

namespacePrefixRef

 

문자열

>-<B 또는 iPXE를 사용하여 마샬링할 때,>-<B 구현은 ns2, ns3, ns4 등과 같은 네임스페이스 접두사를 자동으로 할당합니다. Camel은 이 매핑을 제어하기 위해 원하는 매핑을 포함하는 맵을 참조할 수 있습니다.

xmlStreamWriterWrapper

 

문자열

사용자 지정 xml 스트림 작성기를 사용합니다.

schemaLocation

 

문자열

스키마의 위치를 정의하려면 다음을 수행합니다.

noNamespaceSchemaLocation

 

문자열

네임스페이스가 없는 스키마의 위치를 정의하려면 다음을 수행합니다.

jaxbProviderProperties

 

문자열

사용자 지정 java.util.Map과 함께 사용할 사용자 지정 java.util.Map 속성을 포함하는 레지스트리에서 조회할 사용자 지정 java.util.Map을 참조합니다.

contentTypeHeader

 

부울

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

60.2. Java DSL 사용

예를 들어 다음에서는 여러 Java 패키지 이름으로 구성된 jqcow b 라는 이름의 DataFormat을 사용하여 CloudEvent BContext 를 초기화합니다.

DataFormat jaxb = new JaxbDataFormat("com.acme.model");

from("activemq:My.Queue").
  unmarshal(jaxb).
  to("mqseries:Another.Queue");

Spring XML 파일을 통해 레지스트리에 정의할 수 있는 데이터 형식에 대한 이름이 지정된 참조를 사용할 수 있습니다.

from("activemq:My.Queue").
  unmarshal("myJaxbDataType").
  to("mqseries:Another.Queue");

60.3. Spring XML 사용

다음 예제에서는 JaxbDataFormat 을 구성하고 여러 경로에서 사용하는 방법을 보여줍니다.

<beans xmlns="http://www.springframework.org/schema/beans"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
    http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd">

  <bean id="myJaxb" class="org.apache.camel.converter.jaxb.JaxbDataFormat">
    <property name="contextPath" value="org.apache.camel.example"/>
  </bean>

  <camelContext xmlns="http://camel.apache.org/schema/spring">
    <route>
      <from uri="direct:start"/>
      <marshal><custom ref="myJaxb"/></marshal>
      <to uri="direct:marshalled"/>
    </route>
    <route>
      <from uri="direct:marshalled"/>
      <unmarshal><custom ref="myJaxb"/></unmarshal>
      <to uri="mock:result"/>
    </route>
  </camelContext>

</beans>

다중 컨텍스트 경로

둘 이상의 컨텍스트 경로에서 이 데이터 형식을 사용할 수 있습니다. : 을 구분자로 사용하여 컨텍스트 경로를 지정할 수 있습니다(예: com.mycompany:com.mycompany2 ). 이 작업은 CloudEventB 구현에서 처리하며 RI와 다른 공급 업체를 사용하는 경우 변경될 수 있습니다.

60.4. 부분적인 마샬링/해결

gRPCB 2는 마샬링 및 무제한 XML 트리 조각을 지원합니다. 기본적으로 havingb는 지정된 클래스에서 전체 XML 트리에서 작동하도록 @ECDHERoot ECDHE 주석을 찾습니다. 이것은 유용하지만 항상 그런 것은 아닙니다 - 때때로 생성된 코드에 @ECDHERootECDHE 주석이 없는 경우가 있으며, 종종 트리의 일부만 필요합니다.

이 경우 부분적인 요약을 사용할 수 있습니다. 이 동작을 활성화하려면 속성 partClass 를 설정해야 합니다. Camel은 이 클래스를marshaler에 전달합니다. JaxbConstants.JAXB_PART_CLASS 가 헤더 중 하나로 설정된 경우 (partClass 속성이 DataFormat에 설정되어 있어도), DataFormat의 속성을 무시하고 헤더에 있는 하나의 세트가 사용됩니다.

마샬링의 경우 대상 네임스페이스의 QName을 사용하여 partNamespace 특성을 추가해야 합니다. 위에서 찾을 수 있는 Spring DSL의 예.

JaxbConstants.JAXB_PART_NAMESPACE 가 헤더 중 하나로 설정된 경우 (partNamespace 속성이 DataFormat에 설정되어 있어도), DataFormat의 속성을 무시하고 헤더에 있는 하나의 세트가 사용됩니다. JaxbConstants.JAXB_PART_NAMESPACE 를 통해 partNamespace 를 설정하는 동안 해당 값 \{[namespaceUri]}[localPart]을 지정해야 합니다.

   ...
   .setHeader(JaxbConstants.JAXB_PART_NAMESPACE, simple("{http://www.camel.apache.org/jaxb/example/address/1}address"));
   ...

60.5. 조각

JaxbDataFormat에는 ChronyB Marshaller에서 Marshaller.JAXB_FRAGMENT 인코딩 속성을 설정할 수 있는 새로운 속성 조각이 있습니다. >-<B Marshaller가 XML 선언을 생성하는 것을 원하지 않는 경우 이 옵션을 true로 설정할 수 있습니다. 이 속성의 기본값은 false입니다.

60.6. NonXML 문자 무시

JaxbDataFormat은 NonXML Character 를 무시하도록 지원합니다. filterNonECDHEChars 속성을 true로 설정하면 JaxbDataFormat은 NonXML 문자를 " 마샬링 또는 축소 해제하는 경우 "로 대체됩니다. 또한 Exchange 속성 Exchange.FILTER_NON_XML_CHARS 를 설정하여 수행할 수도 있습니다.

 JDK 1.5JDK 1.6+

사용 중인 필터링

staging API 및 구현

없음

사용하지 않는 필터링

staging API만 해당

없음

이 기능은 Woodstox 3.2.9 및 Sun JDK 1.6 StAX 구현에서 테스트되었습니다.

JaxbDataFormat을 사용하면 스트림을 XML로 마샬링하는 데 사용되는 XMLStreamWriter를 사용자 지정할 수 있습니다. 이 구성을 사용하면 자체 스트림 작성기를 추가하여 비xml 문자를 완전히 제거, 이스케이프 또는 교체할 수 있습니다.

   JaxbDataFormat customWriterFormat = new JaxbDataFormat("org.apache.camel.foo.bar");
  customWriterFormat.setXmlStreamWriterWrapper(new TestXmlStreamWriter());

다음 예제에서는 Spring DSL을 사용하고 Camel의 NonXML 필터링 활성화도 보여줍니다.

<bean id="testXmlStreamWriterWrapper" class="org.apache.camel.jaxb.TestXmlStreamWriter"/>
<jaxb filterNonXmlChars="true"  contextPath="org.apache.camel.foo.bar" xmlStreamWriterWrapper="#testXmlStreamWriterWrapper" />

60.7. ObjectFactory 작업

XJC를 사용하여 스키마에서 java 클래스를 생성하는 경우, 사용자가 gRPCB 컨텍스트에 대한 ObjectFactory를 받습니다. ObjectFactory는 schema 및 element 인스턴스 값의 참조를 유지하기 위해, jvncbDataformat은 기본적으로 CloudEventB>-<를 무시하므로, CloudEventBECDHE 개체 대신 요소 인스턴스 값을 가져옵니다.

marshaled 메시지 본문을 만들려면 JaxbDataFormat 개체의 ignoreJAXB>-< 속성을 false로 설정해야 합니다.

60.8. 인코딩 설정

마샬링 시 사용할 인코딩 옵션을 설정할 수 있습니다. skopeoB Marshaller의 Marshaller.JAXB_ENCODING 인코딩 속성입니다.

skopeoB 데이터 형식을 선언할 때 사용할 인코딩을 설정할 수 있습니다. 또한 교환 속성 Exchange.CHARSET_NAME 에서 인코딩을 제공할 수도 있습니다. 이 속성은 192.0.2.B 데이터 형식에 설정된 인코딩을 덮어씁니다.

이 Spring DSL에서는 iso-8859-1 을 인코딩으로 사용하도록 정의했습니다.

60.9. 네임스페이스 접두사 매핑 제어

>-< B 또는 iPXE를 사용하여 마샬링할 때,>-<B 구현은 ns2, ns3, ns4 등과 같은 네임스페이스 접두사를 자동으로 할당합니다. https://access.redhat.com/documentation/en-us/red_hat_integration/2022.q4/html-single/camel_spring_boot_reference_3.14/index#csb-camel-soap-dataformat-starter Camel은 이 매핑을 제어하기 위해 원하는 매핑을 포함하는 맵을 참조할 수 있습니다.

매핑 기능은 지원되는지 여부에 따라 연결 기능에 따라 달라지므로 classpath에>-<B-RI 2.1 이상(SUN에서)이 필요합니다.

예를 들어 Spring XML에서는 매핑을 사용하여 맵을 정의할 수 있습니다. 아래 매핑 파일에서는 soap을 접두사로 사용하도록 매핑합니다. 사용자 지정 네임스페이스 "http://www.mycompany.com/foo/2"는 접두사를 사용하지 않습니다.

  <util:map id="myMap">
    <entry key="http://www.w3.org/2003/05/soap-envelope" value="soap"/>
    <!-- we dont want any prefix for our namespace -->
    <entry key="http://www.mycompany.com/foo/2" value=""/>
  </util:map>

이렇게 하려면 아래와 같이 namespacePrefixRef 특성을 사용하여 이 맵을 참조하십시오. https://access.redhat.com/documentation/en-us/red_hat_integration/2022.q4/html-single/camel_spring_boot_reference_3.14/index#csb-camel-jaxb-dataformat-starter https://access.redhat.com/documentation/en-us/red_hat_integration/2022.q4/html-single/camel_spring_boot_reference_3.14/index#csb-camel-soap-dataformat-starter 그런 다음 Camel은 위에서 정의한 항목인 java.util.Map ID "myMap"을 사용하여 레지스트리에서 조회합니다.

  <marshal>
    <soapjaxb version="1.2" contextPath="com.mycompany.foo" namespacePrefixRef="myMap"/>
  </marshal>

60.10. 스키마 검증

CloudEventB 데이터 형식은 from/to XML을 마샬링 및 마샬링 해제하여 유효성 검사를 지원합니다. classpath:, file: 또는 http 접두사를 사용하여 리소스를 해결하는 방법을 지정할 수 있습니다. ',' 문자를 사용하여 여러 스키마 파일을 분리할 수 있습니다.

Java DSL을 사용하여 다음과 같은 방식으로 구성할 수 있습니다.

JaxbDataFormat jaxbDataFormat = new JaxbDataFormat();
jaxbDataFormat.setContextPath(Person.class.getPackage().getName());
jaxbDataFormat.setSchema("classpath:person.xsd,classpath:address.xsd");

XML DSL을 사용하여 동일한 작업을 수행할 수 있습니다.

<marshal>
    <jaxb id="jaxb" schema="classpath:person.xsd,classpath:address.xsd"/>
</marshal>

Camel은 JDK와 함께 제공되는 SchemaFactory 가 스레드로부터 안전하지 않기 때문에 실행 시 underling SchemaFactory 인스턴스를 생성하고 풀링합니다.
그러나 스레드로부터 안전한 SchemaFactory 구현이 있는 경우 이 형식을 사용하도록 CloudEventB 데이터 형식을 구성할 수 있습니다.

JaxbDataFormat jaxbDataFormat = new JaxbDataFormat();
jaxbDataFormat.setSchemaFactory(thradSafeSchemaFactory);

60.11. 스키마 위치

CloudEventB 데이터 형식은 XML을 마샬링할 때 SchemaLocation을 지정하는 기능을 지원합니다.

Java DSL을 사용하여 다음과 같은 방식으로 구성할 수 있습니다.

JaxbDataFormat jaxbDataFormat = new JaxbDataFormat();
jaxbDataFormat.setContextPath(Person.class.getPackage().getName());
jaxbDataFormat.setSchemaLocation("schema/person.xsd");

XML DSL을 사용하여 동일한 작업을 수행할 수 있습니다.

<marshal>
    <jaxb id="jaxb" schemaLocation="schema/person.xsd"/>
</marshal>

60.12. 이미 XML인 Marshal 데이터

CloudEventB marshaller를 사용하려면 메시지 본문이ECDHEB compatible, eg its a a a a single instance, eg a java instance that has the annotationsB annotations, or extendECDHEBECDHE를 사용해야 합니다. 메시지 본문이 XML에 이미 있는 경우 문자열 유형 eg가 있을 수 있습니다.

이 검사를 완화하기 위해 false로 설정할 수 있는 새로운 옵션 mustBeJAXB 10.0.0.1이 있습니다. 따라서, 이 검사를 완화하기 위해 ScanSettingB marshaller (javax.xml.bind.JAXBIntrospector#isECDHE returns true). 그리고 이러한 상황에서는 마샬러가 메시지 본문을 그대로 마샬링합니다.

60.13. 종속 항목

camel 경로에서 skopeoB를 사용하려면 이 데이터 형식을 구현하는 camel-jaxb 에 대한 종속성을 추가해야 합니다.

maven을 사용하는 경우 pom.xml에 다음을 추가하여 최신 & 가장 큰 릴리스 버전 번호를 대체할 수 있습니다 (최신 버전의 다운로드 페이지 참조).

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-jaxb</artifactId>
  <version>{CamelSBVersion}</version>
</dependency>

60.14. Spring Boot Auto-Configuration

Spring Boot와 함께 jqcowb를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-jaxb-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.dataformat.jaxb.content-type-header

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

true

부울

camel.dataformat.jaxb.context-path

ScanSettingB 클래스가 있는 패키지 이름입니다.

 

문자열

camel.dataformat.jaxb.context-path-is-class-name

이는 contextPath가 패키지 이름이 아니라 classname을 참조하고 있음을 표시하기 위해 true로 설정할 수 있습니다.

false

부울

camel.dataformat.jaxb.enabled

jqcowb 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.jaxb.encoding

특정 인코딩을 덮어쓰고 사용하려면 다음을 수행합니다.

 

문자열

camel.dataformat.jaxb.filter-non-xml-chars

비 xml hadacheters를 무시하고 빈 공간으로 교체하려면 다음을 수행하십시오.

false

부울

camel.dataformat.jaxb.fragment

XML 조각 트리 마샬링을 설정하려면 다음을 수행하십시오. 기본적으로 B는 지정된 클래스에서 전체 XML 트리에서 작동하도록 ECDHERootECDHE 주석을 찾습니다. 이 기능은 유용하지만 항상 그렇지는 않지만 생성되는 코드에는 ECDHERootECDHE 주석이 없는 경우가 있으며 트리의 일부만 필요한 경우도 있습니다. 이 경우 부분적인 요약을 사용할 수 있습니다. 이 동작을 활성화하려면 속성 partClass를 설정해야 합니다. Camel은 이 클래스를marshaler에 전달합니다.

false

부울

camel.dataformat.jaxb.ignore-j-a-x-b-element

무시할지 여부 - 매우 특별한 사용 사례에서만 false로 설정해야합니다.

false

부울

camel.dataformat.jaxb.jaxb-provider-properties

사용자 지정 java.util.Map과 함께 사용할 사용자 지정 java.util.Map 속성을 포함하는 레지스트리에서 조회할 사용자 지정 java.util.Map을 참조합니다.

 

문자열

camel.dataformat.jaxb.must-be-j-a-x-b-element

Marhsalling이 CloudEventB 주석이 있는 java 오브젝트여야 하는지 여부. 그렇지 않으면 실패합니다. 이 옵션을 false로 설정하여 데이터가 이미 XML 형식으로 되어 있는 경우와 같이 완화할 수 있습니다.

false

부울

camel.dataformat.jaxb.namespace-prefix-ref

>-<B 또는 iPXE를 사용하여 마샬링할 때,>-<B 구현은 ns2, ns3, ns4 등과 같은 네임스페이스 접두사를 자동으로 할당합니다. Camel은 이 매핑을 제어하기 위해 원하는 매핑을 포함하는 맵을 참조할 수 있습니다.

 

문자열

camel.dataformat.jaxb.no-namespace-schema-location

네임스페이스가 없는 스키마의 위치를 정의하려면 다음을 수행합니다.

 

문자열

camel.dataformat.jaxb.object-factory

ObjectFactory 클래스를 사용하여 마샬링 중 gRPC 클래스를 생성할 수 있는지 여부입니다. 이는 CloudEventB로 주석이 추가되지 않고 jvncb.index 설명자 파일을 제공하는 CloudEvent 클래스에만 적용됩니다.

false

부울

camel.dataformat.jaxb.part-class

조각 구문 분석에 사용되는 클래스의 이름입니다. fragment 옵션에서 자세한 내용을 참조하십시오.

 

문자열

camel.dataformat.jaxb.part-namespace

조각 구문 분석에 사용할 XML 네임스페이스입니다. fragment 옵션에서 자세한 내용을 참조하십시오.

 

문자열

camel.dataformat.jaxb.pretty-print

출력을 완벽하게 포맷할 수 있도록 하려면 다음을 수행하십시오. 기본값은 false입니다.

false

부울

camel.dataformat.jaxb.schema

기존 스키마에 대해 검증하려면 다음을 수행합니다. classpath:, file: 또는 http 접두사를 사용하여 리소스를 해결하는 방법을 지정할 수 있습니다. ',' 문자를 사용하여 여러 스키마 파일을 분리할 수 있습니다.

 

문자열

camel.dataformat.jaxb.schema-location

스키마의 위치를 정의하려면 다음을 수행합니다.

 

문자열

camel.dataformat.jaxb.schema-severity-level

스키마에 대해 유효성을 검사할 때 사용할 스키마 심각도 수준을 설정합니다. 이 수준은 계속 구문 분석을 중지하도록 CloudEventB를 트리거하는 최소 심각도 오류를 결정합니다. 기본값은 오류(경고, 오류 또는 치명적 오류)가 트리거된 모든 오류(경고, 오류 또는 치명적 오류)가 중지됨을 나타냅니다. 세 가지 수준은 다음과 같습니다. 0=warning, 1=error, 2=fatal error.

0

정수

camel.dataformat.jaxb.xml-stream-writer-wrapper

사용자 지정 xml 스트림 작성기를 사용합니다.

 

문자열

61장. JSON Gson

Gson은 Gson Library 를 사용하는 데이터 형식입니다.

from("activemq:My.Queue").
  marshal().json(JsonLibrary.Gson).
  to("mqseries:Another.Queue");

61.1. Gson Options

JSON Gson 데이터 포맷은 아래에 나열된 세 가지 옵션을 지원합니다.

이름DefaultJava Type설명

prettyPrint

 

부울

출력을 완벽하게 포맷할 수 있도록 하려면 다음을 수행하십시오. 기본값은 false입니다.

unmarshalType

 

문자열

요약할 때 사용할 Java 유형의 클래스 이름입니다.

contentTypeHeader

 

부울

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

61.2. 종속 항목

camel 경로에서 Gson을 사용하려면 이 데이터 형식을 구현하는 camel-gson 에 대한 종속성을 추가해야 합니다.

maven을 사용하는 경우 pom.xml에 다음을 추가하여 최신 & 가장 큰 릴리스 버전 번호를 대체할 수 있습니다 (최신 버전의 다운로드 페이지 참조).

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-gson</artifactId>
  <version>{CamelSBVersion}</version>
  <!-- use the same version as your Camel core version -->
</dependency>

61.3. Spring Boot Auto-Configuration

Spring Boot와 함께 json-gson을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-gson-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.dataformat.json-gson.content-type-header

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

true

부울

camel.dataformat.json-gson.enabled

json-gson 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.json-gson.pretty-print

출력을 완벽하게 포맷할 수 있도록 하려면 다음을 수행하십시오. 기본값은 false입니다.

false

부울

camel.dataformat.json-gson.unmarshal-type

요약할 때 사용할 Java 유형의 클래스 이름입니다.

 

문자열

62장. JSON Jackson

jackson은 Jackson 라이브러리를 사용하는 데이터 형식입니다.

from("activemq:My.Queue").
  marshal().json(JsonLibrary.Jackson).
  to("mqseries:Another.Queue");

62.1. jackson 옵션

JSON Jackson 데이터 형식은 아래에 나열된 20 가지 옵션을 지원합니다.

이름DefaultJava Type설명

objectMapper

 

문자열

Jackson을 사용할 때 지정된 ID와 함께 기존 ObjectMapper를 조회하고 사용합니다.

useDefaultObjectMapper

 

부울

레지스트리에서 기본 Jackson ObjectMapper를 조회하고 사용할지 여부입니다.

prettyPrint

 

부울

출력을 완벽하게 포맷할 수 있도록 하려면 다음을 수행하십시오. 기본값은 false입니다.

unmarshalType

 

문자열

요약할 때 사용할 Java 유형의 클래스 이름입니다.

jsonView

 

문자열

ScanSetting을 JSON으로 마샬링할 때 JSON 출력에서 특정 필드를 제외할 수 있습니다. Jackson을 사용하면 JSON 보기를 사용하여 이 작업을 수행할 수 있습니다. 이 옵션은 JsonView 주석이 있는 클래스를 참조하는 것입니다.

include

 

문자열

pojo를 JSON으로 마샬링하려면 pojo에 null 값이 있는 일부 필드가 있습니다. 이러한 null 값을 건너뛰려면 이 옵션을 NON_NULL로 설정할 수 있습니다.

allowJmsType

 

부울

JMS 사용자가 JMS 사양의 JMSType 헤더가 요약을 해제하는 데 사용할 FQN 클래스 이름을 지정할 수 있도록 허용합니다.

collectionType

 

문자열

사용할 레지스트리의 조회할 사용자 정의 컬렉션 유형을 나타냅니다. 이 옵션은 거의 사용되지 않지만 java.util.ECDHE 기반 컬렉션 유형과 다른 컬렉션 유형을 기본값으로 사용할 수 있습니다.

useList

 

부울

Map 목록 또는 Pojo 목록으로 요약할 수 있습니다.

moduleClassNames

 

문자열

사용자 지정 Jackson 모듈 com.fasterxml.jackson.databind.Module을 FQN 클래스 이름으로 String으로 지정합니다. 여러 클래스를 쉼표로 구분할 수 있습니다.

moduleRefs

 

문자열

Camel 레지스트리에서 언급한 사용자 지정 Jackson 모듈을 사용하려면 다음을 수행하십시오. 여러 모듈은 쉼표로 구분할 수 있습니다.

enableFeatures

 

문자열

jackson com.fasterxml.jackson.databind.ObjectMapper에서 활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

disableFeatures

 

문자열

jackson com.fasterxml.jackson.databind.ObjectMapper에서 비활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

allowUnmarshallType

 

부울

활성화하면 Jackson이 축소되지 않는 동안 CamelJacksonUnmarshalType 헤더를 사용할 수 있습니다. 이 기능은 사용하려는 경우에만 활성화해야 합니다.

timezone

 

문자열

설정한 경우 Jackson은 마샬링/해결 시 Timezone을 사용합니다. 이 옵션은 gson, fastjson 및 xstream과 같은 다른 Json DataFormat에는 영향을 미치지 않습니다.

autoDiscoverObjectMapper

 

부울

true로 설정하면 Jackson이 objectMapper의 레지스트리를 조회합니다.

contentTypeHeader

 

부울

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

schemaResolver

 

문자열

전송 중인 데이터의 스키마를 조회하는 데 사용되는 선택적 스키마 확인자입니다.

autoDiscoverSchemaResolver

 

부울

비활성화하지 않으면 SchemaResolver가 레지스트리를 조회합니다.

namingStrategy

 

문자열

그런 다음 Jackson이 정의된 Property Naming Strategy.Possible 값을 사용하는 경우: LOWER_CAEL_CASE, LOWER_DOT_CASE, LOWER_CASE, KEBAB_CASE, SNAKE_CASE 및 UPPER_CAMEL_CASE.

62.2. 사용자 정의 ObjectMapper 사용

매핑 구성을 더 많이 제어해야 하는 경우 사용자 정의 ObjectMapper 를 사용하도록 jacksonDataFormat 을 구성할 수 있습니다.

레지스트리에서 단일 ObjectMapper 를 설정하는 경우 Camel은 자동으로 조회하여 이 ObjectMapper 를 사용합니다. 예를 들어 Spring Boot를 사용하는 경우 Spring Boot는 SpringECDHE가 활성화된 경우 기본 ObjectMapper 를 제공할 수 있습니다. 또한 Camel은 Spring Boot console 레지스트리에 하나의 ObjectMapper 클래스 유형의 빈이 있음을 탐지한 다음 사용할 수 있습니다. 이 경우 Camel에서 INFO 로깅을 설정해야 합니다.

62.3. 자동 유형 변환에 Jackson 사용

camel-jackson 모듈을 사용하면 Jackson을 유형 developer로 통합할 수 있습니다. 이는 Camel의 유형 변환기와 통합된 CloudEvent B 와 유사한 방식으로 작동합니다.

camel-jackson 을 사용하려면 다음과 같이 CamelContext 전역 옵션에 다음 옵션을 설정하여 수행해야 합니다.

@Bean
CamelContextConfiguration contextConfiguration() {
    return new CamelContextConfiguration() {
        @Override
        public void beforeApplicationStart(CamelContext context) {
        // Enable Jackson JSON type converter.
            context.getGlobalOptions().put(JacksonConstants.ENABLE_TYPE_CONVERTER, "true");
        // Allow Jackson JSON to convert to pojo types also
        // (by default Jackson only converts to String and other simple types)
            getContext().getGlobalOptions().put(JacksonConstants.TYPE_CONVERTER_TO_POJO, "true");
        }

        @Override
        public void afterApplicationStart(CamelContext camelContext) {

        }
    };
}

camel-jackson 유형 컨버터는 CloudEvent B 와 통합되며, 이는 Jackson이 사용할 수 있는 CloudEvent B 주석으로 CloudEvent 클래스에 주석을 달 수 있음을 의미합니다. gRPC 클래스에 Jackson의 자체 주석을 사용할 수도 있습니다.

62.4. 종속 항목

camel 경로에서 Jackson을 사용하려면 이 데이터 형식을 구현하는 camel-jackson 에 대한 종속성을 추가해야 합니다.

maven을 사용하는 경우 pom.xml에 다음을 추가하여 최신 & 가장 큰 릴리스 버전 번호를 대체할 수 있습니다 (최신 버전의 다운로드 페이지 참조).

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-jackson</artifactId>
  <version>{CamelSBVersion}</version>
  <!-- use the same version as your Camel core version -->
</dependency>

62.5. Spring Boot Auto-Configuration

Spring Boot와 함께 json-jackson을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-jackson-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.dataformat.json-jackson.allow-jms-type

JMS 사용자가 JMS 사양의 JMSType 헤더가 요약을 해제하는 데 사용할 FQN 클래스 이름을 지정할 수 있도록 허용합니다.

false

부울

camel.dataformat.json-jackson.allow-unmarshall-type

활성화하면 Jackson이 축소되지 않는 동안 CamelJacksonUnmarshalType 헤더를 사용할 수 있습니다. 이 기능은 사용하려는 경우에만 활성화해야 합니다.

false

부울

camel.dataformat.json-jackson.auto-discover-object-mapper

true로 설정하면 Jackson이 objectMapper의 레지스트리를 조회합니다.

false

부울

camel.dataformat.json-jackson.auto-discover-schema-resolver

비활성화하지 않으면 SchemaResolver가 레지스트리를 조회합니다.

true

부울

camel.dataformat.json-jackson.collection-type

사용할 레지스트리의 조회할 사용자 정의 컬렉션 유형을 나타냅니다. 이 옵션은 거의 사용되지 않지만 java.util.ECDHE 기반 컬렉션 유형과 다른 컬렉션 유형을 기본값으로 사용할 수 있습니다.

 

문자열

camel.dataformat.json-jackson.content-type-header

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

true

부울

camel.dataformat.json-jackson.disable-features

jackson com.fasterxml.jackson.databind.ObjectMapper에서 비활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

 

문자열

camel.dataformat.json-jackson.enable-features

jackson com.fasterxml.jackson.databind.ObjectMapper에서 활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

 

문자열

camel.dataformat.json-jackson.enabled

json-jackson 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.json-jackson.include

pojo를 JSON으로 마샬링하려면 pojo에 null 값이 있는 일부 필드가 있습니다. 이러한 null 값을 건너뛰려면 이 옵션을 NON_NULL로 설정할 수 있습니다.

 

문자열

camel.dataformat.json-jackson.json-view

ScanSetting을 JSON으로 마샬링할 때 JSON 출력에서 특정 필드를 제외할 수 있습니다. Jackson을 사용하면 JSON 보기를 사용하여 이 작업을 수행할 수 있습니다. 이 옵션은 JsonView 주석이 있는 클래스를 참조하는 것입니다.

 

문자열

camel.dataformat.json-jackson.module-class-names

사용자 지정 Jackson 모듈 com.fasterxml.jackson.databind.Module을 FQN 클래스 이름으로 String으로 지정합니다. 여러 클래스를 쉼표로 구분할 수 있습니다.

 

문자열

camel.dataformat.json-jackson.module-refs

Camel 레지스트리에서 언급한 사용자 지정 Jackson 모듈을 사용하려면 다음을 수행하십시오. 여러 모듈은 쉼표로 구분할 수 있습니다.

 

문자열

camel.dataformat.json-jackson.naming-strategy

그런 다음 Jackson이 정의된 Property Naming Strategy.Possible 값을 사용하는 경우: LOWER_CAEL_CASE, LOWER_DOT_CASE, LOWER_CASE, KEBAB_CASE, SNAKE_CASE 및 UPPER_CAMEL_CASE.

 

문자열

camel.dataformat.json-jackson.object-mapper

Jackson을 사용할 때 지정된 ID와 함께 기존 ObjectMapper를 조회하고 사용합니다.

 

문자열

camel.dataformat.json-jackson.pretty-print

출력을 완벽하게 포맷할 수 있도록 하려면 다음을 수행하십시오. 기본값은 false입니다.

false

부울

camel.dataformat.json-jackson.schema-resolver

전송 중인 데이터의 스키마를 조회하는 데 사용되는 선택적 스키마 확인자입니다.

 

문자열

camel.dataformat.json-jackson.timezone

설정한 경우 Jackson은 마샬링/해결 시 Timezone을 사용합니다. 이 옵션은 gson, fastjson 및 xstream과 같은 다른 Json DataFormat에는 영향을 미치지 않습니다.

 

문자열

camel.dataformat.json-jackson.unmarshal-type

요약할 때 사용할 Java 유형의 클래스 이름입니다.

 

문자열

camel.dataformat.json-jackson.use-default-object-mapper

레지스트리에서 기본 Jackson ObjectMapper를 조회하고 사용할지 여부입니다.

true

부울

camel.dataformat.json-jackson.use-list

Map 목록 또는 Pojo 목록으로 요약할 수 있습니다.

false

부울

63장. Protobuf Jackson

jackson Protobuf는 Protobuf 확장과 함께 Jackson 라이브러리를 사용하여 Protobuf 페이로드를 초기화하거나 Java 오브젝트를 Protobuf 페이로드로 마샬링하는 데이터 형식입니다.

참고

Jackson에 익숙한 경우 이 Protobuf 데이터 형식은 JSON 대응과 동일한 방식으로 작동하므로 JSON serialization/deserialization에 대해 주석이 달린 클래스와 함께 사용할 수 있습니다.

from("kafka:topic").
  unmarshal().protobuf(ProtobufLibrary.Jackson, JsonNode.class).
  to("log:info");

63.1. SchemaResolver 구성

Protobuf 직렬화는 스키마 기반이므로 이 데이터 형식을 사용하려면 마샬링/해결되는 각 교환의 스키마를 조회할 수 있는 SchemaResolver 개체를 제공해야 합니다.

단일 SchemaResolver를 레지스트리에 추가할 수 있으며 자동으로 조회됩니다. 또는 사용자 정의 SchemaResolver에 대한 참조를 명시적으로 지정할 수 있습니다.

63.2. Protobuf Jackson 옵션

Protobuf Jackson 데이터 포맷은 아래에 나열된 18 가지 옵션을 지원합니다.

이름DefaultJava Type설명

contentTypeHeader

 

부울

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

objectMapper

 

문자열

Jackson을 사용할 때 지정된 ID와 함께 기존 ObjectMapper를 조회하고 사용합니다.

useDefaultObjectMapper

 

부울

레지스트리에서 기본 Jackson ObjectMapper를 조회하고 사용할지 여부입니다.

unmarshalType

 

문자열

요약할 때 사용할 Java 유형의 클래스 이름입니다.

jsonView

 

문자열

ScanSetting을 JSON으로 마샬링할 때 JSON 출력에서 특정 필드를 제외할 수 있습니다. Jackson을 사용하면 JSON 보기를 사용하여 이 작업을 수행할 수 있습니다. 이 옵션은 JsonView 주석이 있는 클래스를 참조하는 것입니다.

include

 

문자열

pojo를 JSON으로 마샬링하려면 pojo에 null 값이 있는 일부 필드가 있습니다. 이러한 null 값을 건너뛰려면 이 옵션을 NON_NULL로 설정할 수 있습니다.

allowJmsType

 

부울

JMS 사용자가 JMS 사양의 JMSType 헤더가 요약을 해제하는 데 사용할 FQN 클래스 이름을 지정할 수 있도록 허용합니다.

collectionType

 

문자열

사용할 레지스트리의 조회할 사용자 정의 컬렉션 유형을 나타냅니다. 이 옵션은 거의 사용되지 않지만 java.util.ECDHE 기반 컬렉션 유형과 다른 컬렉션 유형을 기본값으로 사용할 수 있습니다.

useList

 

부울

Map 목록 또는 Pojo 목록으로 요약할 수 있습니다.

moduleClassNames

 

문자열

사용자 지정 Jackson 모듈 com.fasterxml.jackson.databind.Module을 FQN 클래스 이름으로 String으로 지정합니다. 여러 클래스를 쉼표로 구분할 수 있습니다.

moduleRefs

 

문자열

Camel 레지스트리에서 언급한 사용자 지정 Jackson 모듈을 사용하려면 다음을 수행하십시오. 여러 모듈은 쉼표로 구분할 수 있습니다.

enableFeatures

 

문자열

jackson com.fasterxml.jackson.databind.ObjectMapper에서 활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

disableFeatures

 

문자열

jackson com.fasterxml.jackson.databind.ObjectMapper에서 비활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

allowUnmarshallType

 

부울

활성화하면 Jackson이 축소되지 않는 동안 CamelJacksonUnmarshalType 헤더를 사용할 수 있습니다. 이 기능은 사용하려는 경우에만 활성화해야 합니다.

timezone

 

문자열

설정한 경우 Jackson은 마샬링/해결 시 Timezone을 사용합니다.

autoDiscoverObjectMapper

 

부울

true로 설정하면 Jackson이 objectMapper의 레지스트리를 조회합니다.

schemaResolver

 

문자열

전송 중인 데이터의 스키마를 조회하는 데 사용되는 선택적 스키마 확인자입니다.

autoDiscoverSchemaResolver

 

부울

비활성화하지 않으면 SchemaResolver가 레지스트리를 조회합니다.

63.3. 사용자 정의 ProtobufMapper 사용

매핑 구성을 더 많이 제어해야 하는 경우 사용자 지정 ProtobufMapper 를 사용하도록 jacksonProtobufDataFormat 을 구성할 수 있습니다.

레지스트리에서 단일 ProtobufMapper 를 설정하는 경우 Camel은 자동으로 조회하여 이 ProtobufMapper 를 사용합니다.

63.4. 종속 항목

camel 경로에서 Protobuf Jackson을 사용하려면 이 데이터 형식을 구현하는 camel-jackson-protobuf 에 대한 종속성을 추가해야 합니다.

maven을 사용하는 경우 pom.xml에 다음을 추가하여 최신 & 가장 큰 릴리스 버전 번호를 대체할 수 있습니다 (최신 버전의 다운로드 페이지 참조).

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-jackson-protobuf</artifactId>
  <version>{CamelSBVersion}</version>
  <!-- use the same version as your Camel core version -->
</dependency>

63.5. Spring Boot Auto-Configuration

Spring Boot와 함께 protobuf-jackson을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-jackson-protobuf-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- use the same version as your Camel core version -->
</dependency>

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

이름설명Default유형

camel.dataformat.protobuf-jackson.allow-jms-type

JMS 사용자가 JMS 사양의 JMSType 헤더가 요약을 해제하는 데 사용할 FQN 클래스 이름을 지정할 수 있도록 허용합니다.

false

부울

camel.dataformat.protobuf-jackson.allow-unmarshall-type

활성화하면 Jackson이 축소되지 않는 동안 CamelJacksonUnmarshalType 헤더를 사용할 수 있습니다. 이 기능은 사용하려는 경우에만 활성화해야 합니다.

false

부울

camel.dataformat.protobuf-jackson.auto-discover-object-mapper

true로 설정하면 Jackson이 objectMapper의 레지스트리를 조회합니다.

false

부울

camel.dataformat.protobuf-jackson.auto-discover-schema-resolver

비활성화하지 않으면 SchemaResolver가 레지스트리를 조회합니다.

true

부울

camel.dataformat.protobuf-jackson.collection-type

사용할 레지스트리의 조회할 사용자 정의 컬렉션 유형을 나타냅니다. 이 옵션은 거의 사용되지 않지만 java.util.ECDHE 기반 컬렉션 유형과 다른 컬렉션 유형을 기본값으로 사용할 수 있습니다.

 

문자열

camel.dataformat.protobuf-jackson.content-type-header

데이터 형식이 데이터 형식의 유형으로 Content-Type 헤더를 설정해야 하는지 여부입니다. 예를 들어 데이터 형식의 application/xml은 XML로 마샬링하거나 데이터 형식의 경우 application/json을 JSON으로 마샬링합니다.

true

부울

camel.dataformat.protobuf-jackson.disable-features

jackson com.fasterxml.jackson.databind.ObjectMapper에서 비활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

 

문자열

camel.dataformat.protobuf-jackson.enable-features

jackson com.fasterxml.jackson.databind.ObjectMapper에서 활성화할 기능 세트. 기능은 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 또는 com.fasterxml.jackson.databind.MapperFeature의 여러 기능에 의해 쉼표로 구분될 수 있는 이름이어야 합니다.

 

문자열

camel.dataformat.protobuf-jackson.enabled

protobuf-jackson 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.protobuf-jackson.include

pojo를 JSON으로 마샬링하려면 pojo에 null 값이 있는 일부 필드가 있습니다. 이러한 null 값을 건너뛰려면 이 옵션을 NON_NULL로 설정할 수 있습니다.

 

문자열

camel.dataformat.protobuf-jackson.json-view

ScanSetting을 JSON으로 마샬링할 때 JSON 출력에서 특정 필드를 제외할 수 있습니다. Jackson을 사용하면 JSON 보기를 사용하여 이 작업을 수행할 수 있습니다. 이 옵션은 JsonView 주석이 있는 클래스를 참조하는 것입니다.

 

문자열

camel.dataformat.protobuf-jackson.module-class-names

사용자 지정 Jackson 모듈 com.fasterxml.jackson.databind.Module을 FQN 클래스 이름으로 String으로 지정합니다. 여러 클래스를 쉼표로 구분할 수 있습니다.

 

문자열

camel.dataformat.protobuf-jackson.module-refs

Camel 레지스트리에서 언급한 사용자 지정 Jackson 모듈을 사용하려면 다음을 수행하십시오. 여러 모듈은 쉼표로 구분할 수 있습니다.

 

문자열

camel.dataformat.protobuf-jackson.object-mapper

Jackson을 사용할 때 지정된 ID와 함께 기존 ObjectMapper를 조회하고 사용합니다.

 

문자열

camel.dataformat.protobuf-jackson.schema-resolver

전송 중인 데이터의 스키마를 조회하는 데 사용되는 선택적 스키마 확인자입니다.

 

문자열

camel.dataformat.protobuf-jackson.timezone

설정한 경우 Jackson은 마샬링/해결 시 Timezone을 사용합니다.

 

문자열

camel.dataformat.protobuf-jackson.unmarshal-type

요약할 때 사용할 Java 유형의 클래스 이름입니다.

 

문자열

camel.dataformat.protobuf-jackson.use-default-object-mapper

레지스트리에서 기본 Jackson ObjectMapper를 조회하고 사용할지 여부입니다.

true

부울

camel.dataformat.protobuf-jackson.use-list

Map 목록 또는 Pojo 목록으로 요약할 수 있습니다.

false

부울

64장. SOAP

CHAP는 data Format으로, CloudEventB2 및ECDHE-WS 주석을 사용하여 페이로드를 마샬링 및 축소 해제하는 것입니다. CXF 스택 없이도 Apache CXF의 기본 기능을 제공합니다.

네임스페이스 접두사 매핑

CHAP 데이터 형식을 사용하여 마샬링할 때 네임스페이스 접두사 매핑을 제어하는 방법은 parameters를 참조하십시오. https://access.redhat.com/documentation/en-us/red_hat_integration/2022.q4/html-single/camel_spring_boot_reference_3.14/index#csb-camel-jaxb-dataformat-starter

64.1. iPXE 옵션

iPXE 데이터 형식은 아래에 나열된 6 가지 옵션을 지원합니다.

이름DefaultJava Type설명

contextPath

 

문자열

필요한 패키지 이름입니다.B 클래스가 있는 경우 필수 패키지 이름입니다.

인코딩

 

문자열

특정 인코딩을 덮어쓰고 사용하려면 다음을 수행합니다.

elementNameStrategyRef

 

문자열

레지스트리에서 조회할 요소 전략을 나타냅니다. 요소 이름 전략은 두 가지 용도로 사용됩니다. 첫 번째는 개체를 iPXE 메시지로 마샬링할 때 지정된 개체 및 soap 작업에 대한 xml 요소 이름을 찾는 것입니다. 두 번째는 지정된 soap fault 이름에 대한 Exception 클래스를 찾는 것입니다. 다음 세 가지 요소 전략 클래스 이름은 상자에서 제공됩니다. QNameStrategy - 인스턴스화 시 구성된 고정 qName을 사용합니다. 예외 조회가 지원되는 TypeNameStrategy - 지정된 유형의 XMLType 주석의 이름과 네임스페이스를 사용합니다. 네임스페이스가 설정되지 않은 경우 package-info가 사용됩니다. 예외 조회는 ServiceInterfaceStrategy가 지원되지 않음 - 웹 서비스 인터페이스의 정보를 사용하여 유형 이름을 결정하고, 세 개의 클래스가 모두 패키지 이름 org.apache.camel.dataformat.soap에 있는 경우 cxf-gencode 또는 유사한 도구를 사용하여 웹 서비스 스텁 코드를 생성한 경우 ServiceInterfaceStrategy를 사용해야 합니다. 주석이 달린 서비스 인터페이스가 없는 경우 QNameStrategy 또는 TypeNameStrategy를 사용해야 합니다.

버전

 

문자열

iPXE 버전은 1.1 또는 1.2여야 합니다. 기본값은 1.1입니다.

namespacePrefixRef

 

문자열

>-<B 또는 iPXE를 사용하여 마샬링할 때,>-<B 구현은 ns2, ns3, ns4 등과 같은 네임스페이스 접두사를 자동으로 할당합니다. Camel은 이 매핑을 제어하기 위해 원하는 매핑을 포함하는 맵을 참조할 수 있습니다.

schema

 

문자열

기존 스키마에 대해 검증하려면 다음을 수행합니다. classpath:, file: 또는 http 접두사를 사용하여 리소스를 해결하는 방법을 지정할 수 있습니다. ',' 문자를 사용하여 여러 스키마 파일을 분리할 수 있습니다.

64.2. ElementNameStrategy

요소 이름 전략은 두 가지 용도로 사용됩니다. 첫 번째는 개체를 iPXE 메시지로 마샬링할 때 지정된 개체 및 soap 작업에 대한 xml 요소 이름을 찾는 것입니다. 두 번째는 지정된 soap fault 이름에 대한 Exception 클래스를 찾는 것입니다.

전략사용법

QNameStrategy

인스턴스화 시 구성된 고정 qName을 사용합니다. 예외 조회가 지원되지 않음

TypeNameStrategy

지정된 유형의 @XMLType 주석의 이름과 네임스페이스를 사용합니다. 네임스페이스가 설정되지 않은 경우 package-info가 사용됩니다. 예외 조회가 지원되지 않음

ServiceInterfaceStrategy

웹 서비스 인터페이스의 정보를 사용하여 유형 이름을 확인하고 iPXE 결함에 대한 예외 클래스를 찾습니다.

cxf-codegen 또는 유사한 도구를 사용하여 웹 서비스 스텁 코드를 생성한 경우 ServiceInterfaceStrategy를 사용할 수 있습니다. 주석이 달린 서비스 인터페이스가 없는 경우 QNameStrategy 또는 TypeNameStrategy를 사용해야 합니다.

64.3. Java DSL 사용

다음 예제에서는 패키지 com.example.customerservice로 구성된 soap 의 named DataFormat을 사용하여 CloudEvent BContext를 초기화합니다. 두 번째 매개변수는 ElementNameStrategy입니다. 이 경로는 일반 오브젝트 및 예외를 마샬링할 수 있습니다. (아래의 내용은 queue에 CHAP Envelope를 보냅니다. 웹 서비스 공급자는 실제로 호출이 수행되기 위해 큐를 수신해야 합니다. 이 경우, 한 가지 방법으로 iPXE 요청이 됩니다. 요청 응답이 필요한 경우 다음 예제를 살펴보십시오.)

SoapJaxbDataFormat soap = new SoapJaxbDataFormat("com.example.customerservice", new ServiceInterfaceStrategy(CustomerService.class));
from("direct:start")
  .marshal(soap)
  .to("jms:myQueue");
참고


dataformat은 여기서 도 대부분의 설정이 적용되는 CloudEventB 데이터 형식의 상속을 참조하십시오.

64.3.1. iPXE 1.2 사용

Camel 2.11 이후

SoapJaxbDataFormat soap = new SoapJaxbDataFormat("com.example.customerservice", new ServiceInterfaceStrategy(CustomerService.class));
soap.setVersion("1.2");
from("direct:start")
  .marshal(soap)
  .to("jms:myQueue");

XML DSL을 사용할 때 <soapjaxb> 요소에서 설정할 수 있는 버전 속성이 있습니다.

    <!-- Defining a ServiceInterfaceStrategy for retrieving the element name when marshalling -->
    <bean id="myNameStrategy" class="org.apache.camel.dataformat.soap.name.ServiceInterfaceStrategy">
        <constructor-arg value="com.example.customerservice.CustomerService"/>
    <constructor-arg value="true"/>
    </bean>

Camel 경로의 경우

<route>
  <from uri="direct:start"/>
  <marshal>
    <soapjaxb contentPath="com.example.customerservice" version="1.2" elementNameStrategyRef="myNameStrategy"/>
  </marshal>
  <to uri="jms:myQueue"/>
</route>

64.4. 다중 파트 메시지

다중 파트 CHAP 메시지는 ServiceInterfaceStrategy에서 지원됩니다. CloudEvent-WS 2.2에 따라 주석이 추가되고 문서 베어 스타일 요구 사항을 충족하는 서비스 인터페이스 정의를 사용하여 ServiceInterfaceStrategy를 초기화해야 합니다. 대상 메서드가 다음 기준을 충족해야 합니다. 1) 이는 헤더가 아닌 매개 변수의 대부분 또는 in /out 이 아닌 매개 변수, 2) in/ out 이 아닌 매개 변수 이외의 반환 유형이 있어야 하는 경우, 2) in/out 또는 out -header 매개 변수가 없는 경우, 3) 반환 유형이 in/out 또는 out-header 매개 변수가 있는 경우, 헤더가 아닌 매개 변수의 반환 유형이 있어야 합니다.

매핑 전략이 요청 매개변수 또는 응답 매개변수에 적용되는지 여부를 나타내는 부울 매개변수를 사용하여 ServiceInterfaceStrategy를 초기화해야 합니다.

ServiceInterfaceStrategy strat =  new ServiceInterfaceStrategy(com.example.customerservice.multipart.MultiPartCustomerService.class, true);
SoapJaxbDataFormat soapDataFormat = new SoapJaxbDataFormat("com.example.customerservice.multipart", strat);

64.4.1. 홀더 오브젝트 매핑

CloudEvent-WS는 In/OutOut 매개변수에 대해 type-parameterized javax.xml.ws.Holder 오브젝트를 사용하도록 지정합니다. 매개 변수 형식의 인스턴스를 직접 사용할 수 있습니다. Holder의 값 클래스에 대한 CloudEventB 매핑에 따라 camel-soap DataFormat marshaler 값을 지정합니다. \'Holder 오브젝트에 대한 매핑은 허용되지 않습니다.

64.5. 예

64.5.1. WebService 클라이언트

다음 경로는 요청 마샬링 및 응답 또는 오류를 축소 해제를 지원합니다.

String WS_URI = "cxf://http://myserver/customerservice?serviceClass=com.example.customerservice&dataFormat=RAW";
SoapJaxbDataFormat soapDF = new SoapJaxbDataFormat("com.example.customerservice", new ServiceInterfaceStrategy(CustomerService.class));
from("direct:customerServiceClient")
  .onException(Exception.class)
    .handled(true)
    .unmarshal(soapDF)
  .end()
  .marshal(soapDF)
  .to(WS_URI)
  .unmarshal(soapDF);

다음 스니펫에서는 서비스 인터페이스에 대한 프록시를 만들고 위의 경로에 대한 iPXE 호출을 만듭니다.

import org.apache.camel.Endpoint;
import org.apache.camel.component.bean.ProxyHelper;
...

Endpoint startEndpoint = context.getEndpoint("direct:customerServiceClient");
ClassLoader classLoader = Thread.currentThread().getContextClassLoader();
// CustomerService below is the service endpoint interface, *not* the javax.xml.ws.Service subclass
CustomerService proxy = ProxyHelper.createProxy(startEndpoint, classLoader, CustomerService.class);
GetCustomersByNameResponse response = proxy.getCustomersByName(new GetCustomersByName());

64.5.2. WebService 서버

다음 경로를 사용하면 jms 대기열 customerServiceQueue에서 수신 대기하는 웹 서비스 서버를 설정하고, CustomerServiceImpl 클래스를 사용하여 요청을 처리합니다. 물론 customerServiceImpl은 CustomerService 인터페이스를 구현해야 합니다. 서버 클래스를 직접 인스턴스화하는 대신 Spring 컨텍스트에서 일반 빈으로 정의할 수 있습니다.

SoapJaxbDataFormat soapDF = new SoapJaxbDataFormat("com.example.customerservice", new ServiceInterfaceStrategy(CustomerService.class));
CustomerService serverBean = new CustomerServiceImpl();
from("jms://queue:customerServiceQueue")
  .onException(Exception.class)
    .handled(true)
    .marshal(soapDF)
  .end()
  .unmarshal(soapDF)
  .bean(serverBean)
  .marshal(soapDF);

64.6. 종속 항목

camel 경로에서 CHAP 데이터 형식을 사용하려면 pom에 다음 종속성을 추가해야 합니다.

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-soap</artifactId>
  <version>{CamelSBVersion}</version>
</dependency>

64.7. Spring Boot Auto-Configuration

Spring Boot와 함께 soapjaxb를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-soap-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.dataformat.soapjaxb.context-path

ScanSettingB 클래스가 있는 패키지 이름입니다.

 

문자열

camel.dataformat.soapjaxb.element-name-strategy-ref

레지스트리에서 조회할 요소 전략을 나타냅니다. 요소 이름 전략은 두 가지 용도로 사용됩니다. 첫 번째는 개체를 iPXE 메시지로 마샬링할 때 지정된 개체 및 soap 작업에 대한 xml 요소 이름을 찾는 것입니다. 두 번째는 지정된 soap fault 이름에 대한 Exception 클래스를 찾는 것입니다. 다음 세 가지 요소 전략 클래스 이름은 상자에서 제공됩니다. QNameStrategy - 인스턴스화 시 구성된 고정 qName을 사용합니다. 예외 조회가 지원되는 TypeNameStrategy - 지정된 유형의 XMLType 주석의 이름과 네임스페이스를 사용합니다. 네임스페이스가 설정되지 않은 경우 package-info가 사용됩니다. 예외 조회는 ServiceInterfaceStrategy가 지원되지 않음 - 웹 서비스 인터페이스의 정보를 사용하여 유형 이름을 결정하고, 세 개의 클래스가 모두 패키지 이름 org.apache.camel.dataformat.soap에 있는 경우 cxf-gencode 또는 유사한 도구를 사용하여 웹 서비스 스텁 코드를 생성한 경우 ServiceInterfaceStrategy를 사용해야 합니다. 주석이 달린 서비스 인터페이스가 없는 경우 QNameStrategy 또는 TypeNameStrategy를 사용해야 합니다.

 

문자열

camel.dataformat.soapjaxb.enabled

soapjaxb 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.soapjaxb.encoding

특정 인코딩을 덮어쓰고 사용하려면 다음을 수행합니다.

 

문자열

camel.dataformat.soapjaxb.namespace-prefix-ref

>-<B 또는 iPXE를 사용하여 마샬링할 때,>-<B 구현은 ns2, ns3, ns4 등과 같은 네임스페이스 접두사를 자동으로 할당합니다. Camel은 이 매핑을 제어하기 위해 원하는 매핑을 포함하는 맵을 참조할 수 있습니다.

 

문자열

camel.dataformat.soapjaxb.schema

기존 스키마에 대해 검증하려면 다음을 수행합니다. classpath:, file: 또는 http 접두사를 사용하여 리소스를 해결하는 방법을 지정할 수 있습니다. ',' 문자를 사용하여 여러 스키마 파일을 분리할 수 있습니다.

 

문자열

camel.dataformat.soapjaxb.version

iPXE 버전은 1.1 또는 1.2여야 합니다. 기본값은 1.1입니다.

1.1

문자열

65장. zip 파일

Zip 파일 데이터 형식은 메시지 압축 및 압축 해제 형식입니다. 메시지는 단일 항목이 포함된 Zip 파일로 마샬링될 수 있으며, 단일 항목이 포함된 Zip 파일을 원래 파일 콘텐츠에 대해 요약을 취소(pressed)할 수 있습니다. 이 데이터 형식은 Java 7 이상이 사용되는 한 ZIP64를 지원합니다.]

65.1. ZipFile 옵션

Zip 파일 데이터 형식은 아래에 나열된 4가지 옵션을 지원합니다.

이름DefaultJava Type설명

usingIterator

 

부울

zip 파일에 하나 이상의 항목이 있는 경우 이 옵션을 true로 설정하면 splitter EIP로 작업할 수 있으며 스트리밍 모드에서 데이터를 사용하여 데이터를 분할할 수 있습니다.

allowEmptyDirectory

 

부울

zip 파일에 하나 이상의 항목이 있는 경우 이 옵션을 true로 설정하면 디렉터리가 비어 있는 경우에도 이 옵션을 true로 설정할 수 있습니다.

preservePathElements

 

부울

파일 이름에 경로 요소가 포함된 경우 이 옵션을 true로 설정하면 zip 파일에서 경로를 유지 관리할 수 있습니다.

maxDecompressedSize

 

정수

zip 파일의 최대 압축 해제된 크기(바이트)를 설정합니다. 지정되지 않은 경우 기본값은 1GB에 해당합니다. 압축 해제된 크기가 이 양을 초과하면 IOException이 발생합니다. 최대 압축 해제된 크기 설정을 비활성화하려면 -1로 설정합니다.

65.2. Marshal

이 예제에서는 Zip 파일 압축을 사용하여 일반 텍스트/ XML 페이로드를 압축된 페이로드로 마샬링하고 MY_QUEUE라는 ActiveMQ 큐로 보냅니다.

from("direct:start")
    .marshal().zipFile()
    .to("activemq:queue:MY_QUEUE");

생성된 Zip 파일 내부의 Zip 항목 이름은 파일 구성 요소에서 사용하는 표준 메시지 헤더인 CamelFileName 메시지 헤더를 기반으로 합니다. 또한 발신 CamelFileName 메시지 헤더는 ".zip" 접미사와 함께 들어오는 CamelFileName 메시지 헤더의 값으로 자동으로 설정됩니다. 예를 들어 다음 경로에서 입력 디렉토리에서 "test.txt"라는 파일을 찾으면 출력은 "test.txt"라는 단일 Zip 항목이 포함된 Zip 파일 "test.txt.zip"이 됩니다.

from("file:input/directory?antInclude=*/.txt")
    .marshal().zipFile()
    .to("file:output/directory");

들어오는 CamelFileName 메시지 헤더(예: 파일 구성 요소가 소비자가 아닌 경우)가 없는 경우 메시지 ID는 기본적으로 사용되며 메시지 ID는 일반적으로 생성된 고유 ID이므로 ID-MACHINENAME-2443-1211718892437-1-0.zip 과 같은 파일 이름이 지정됩니다. 이 동작을 재정의하려면 경로에서 명시적으로 CamelFileName 헤더 값을 설정할 수 있습니다.

from("direct:start")
    .setHeader(Exchange.FILE_NAME, constant("report.txt"))
    .marshal().zipFile()
    .to("file:output/directory");

이 경로를 사용하면 출력 디렉토리에 "report.txt.zip"이라는 Zip 파일이 생성되고 "report.txt"라는 단일 Zip 항목이 포함됩니다.

65.3. 마침 안 됨

이 예제에서는 MY_QUEUE라는 ActiveMQ 대기열에서 Zip 파일 페이로드를 원래 형식으로 분리하고 처리를 위해 UnZippedMessageProcessor 로 전달합니다.

from("activemq:queue:MY_QUEUE")
    .unmarshal().zipFile()
    .process(new UnZippedMessageProcessor());

zip 파일에 하나 이상의 항목이 있는 경우 ZipFileDataFormat의 usingIterator 옵션을 true로 지정하고 splitter를 사용하여 추가 작업을 수행할 수 있습니다.

ZipFileDataFormat zipFile = new ZipFileDataFormat();
zipFile.setUsingIterator(true);

from("file:src/test/resources/org/apache/camel/dataformat/zipfile/?delay=1000&noop=true")
    .unmarshal(zipFile)
    .split(body(Iterator.class)).streaming()
        .process(new UnZippedMessageProcessor())
    .end();

또는 Zip>-<ter를 다음과 같이 스플릿터의 표현식으로 사용할 수 있습니다.

from("file:src/test/resources/org/apache/camel/dataformat/zipfile?delay=1000&noop=true")
    .split(new ZipSplitter()).streaming()
        .process(new UnZippedMessageProcessor())
    .end();

65.3.1. 집계

참고

이 집계 전략을 사용하려면 빠른 완료 검사가 제대로 작동해야 합니다.

이 예제에서는 입력 디렉터리에 있는 모든 텍스트 파일을 출력 디렉터리에 저장된 단일 Zip 파일로 집계합니다.

from("file:input/directory?antInclude=*/.txt")
    .aggregate(constant(true), new ZipAggregationStrategy())
        .completionFromBatchConsumer().eagerCheckCompletion()
        .to("file:output/directory");

발신 CamelFileName 메시지 헤더는 java.io.File.createTempFile을 ".zip" 접미사로 사용하여 생성됩니다. 이 동작을 재정의하려면 경로에서 명시적으로 CamelFileName 헤더 값을 설정할 수 있습니다.

from("file:input/directory?antInclude=*/.txt")
    .aggregate(constant(true), new ZipAggregationStrategy())
        .completionFromBatchConsumer().eagerCheckCompletion()
        .setHeader(Exchange.FILE_NAME, constant("reports.zip"))
        .to("file:output/directory");

65.4. 종속 항목

camel 경로에서 Zip 파일을 사용하려면 이 데이터 형식을 구현하는 camel-zipfile 에 종속성을 추가해야 합니다.

Maven을 사용하는 경우 pom.xml 에 다음을 추가하고 최신 & 가장 큰 릴리스의 버전 번호를 대체할 수 있습니다(최신 버전의 다운로드 페이지 참조).

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-zipfile</artifactId>
  <version>{CamelSBVersion}</version>
  <!-- use the same version as your Camel core version -->
</dependency>

65.5. Spring Boot Auto-Configuration

Spring Boot와 함께 zipfile을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-zipfile-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.dataformat.zipfile.allow-empty-directory

zip 파일에 하나 이상의 항목이 있는 경우 이 옵션을 true로 설정하면 디렉터리가 비어 있는 경우에도 이 옵션을 true로 설정할 수 있습니다.

false

부울

camel.dataformat.zipfile.enabled

zipfile 데이터 형식의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.dataformat.zipfile.max-decompressed-size

zip 파일의 최대 압축 해제된 크기(바이트)를 설정합니다. 지정되지 않은 경우 기본값은 1GB에 해당합니다. 압축 해제된 크기가 이 양을 초과하면 IOException이 발생합니다. 최대 압축 해제된 크기 설정을 비활성화하려면 -1로 설정합니다.

1073741824

long

camel.dataformat.zipfile.preserve-path-elements

파일 이름에 경로 요소가 포함된 경우 이 옵션을 true로 설정하면 zip 파일에서 경로를 유지 관리할 수 있습니다.

false

부울

camel.dataformat.zipfile.using-iterator

zip 파일에 하나 이상의 항목이 있는 경우 이 옵션을 true로 설정하면 splitter EIP로 작업할 수 있으며 스트리밍 모드에서 데이터를 사용하여 데이터를 분할할 수 있습니다.

false

부울

66장. 상수

Constant Expression Language는 상수 값 또는 개체를 사용하는 방법일 뿐입니다.

참고

이는 경로를 시작하는 동안 한 번만 설정된 고정 상수 값(또는 오브젝트)이며 라우팅 중 동적 값을 원하는 경우 이 값을 사용하지 마십시오.

66.1. 상수 옵션

Constant 언어는 아래에 나열된 두 가지 옵션을 지원합니다.

이름DefaultJava Type설명

resultType

 

문자열

상수 형식의 클래스 이름을 설정합니다.Sets the class name of the constant type.

trim

 

부울

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

66.2. 예제

setHeader EIP는 다음과 같은 상수 표현식을 사용할 수 있습니다.

<route>
  <from uri="seda:a"/>
  <setHeader name="theHeader">
    <constant>the value</constant>
  </setHeader>
  <to uri="mock:b"/>
</route>

이 경우 seda:a 끝점에서 제공하는 메시지에는 키가 있는 헤더와 함께 헤더가 해당 값을 값(문자열 유형)으로 설정합니다.

Java DSL을 사용하는 것과 동일한 예:

from("seda:a")
  .setHeader("theHeader", constant("the value"))
  .to("mock:b");

66.2.1. 값 유형 지정

옵션 resultType 을 사용하여 값이 String 값으로 지정되는 경우 XML 또는 YAML DSL을 사용할 때 발생하는 값 유형을 지정할 수 있습니다.

예를 들어 int 유형으로 헤더를 설정하려면 다음을 수행할 수 있습니다.

<route>
  <from uri="seda:a"/>
  <setHeader name="zipCode">
    <constant resultType="int">90210</constant>
  </setHeader>
  <to uri="mock:b"/>
</route>

66.3. 외부 리소스에서 상수 로드

상수를 외부화하고 "classpath:", "file:", "http:" 와 같은 리소스에서 Camel을 로드하도록 할 수 있습니다.
이 작업은 "resource:scheme:location" 구문을 사용하여 수행됩니다. "resource:scheme:location", eg to refer to a file on the classpath you can do:

.setHeader("myHeader").constant("resource:classpath:constant.txt")

66.4. 종속 항목

일관된 언어는 camel-core 의 일부입니다.

66.5. Spring Boot Auto-Configuration

Spring Boot와 함께 상수를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-core-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- use the same version as your Camel core version -->
</dependency>

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

이름설명Default유형

camel.cloud.consul.service-discovery.acl-token

Consul과 함께 사용할 ACL 토큰을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.block-seconds

감시 이벤트를 대기하는 시간(기본값: 10초)입니다.

10

정수

camel.cloud.consul.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.consul.service-discovery.connect-timeout-millis

OkHttpClient에 대한 연결 시간 초과입니다.

 

long

camel.cloud.consul.service-discovery.datacenter

데이터 센터입니다.

 

문자열

camel.cloud.consul.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.consul.service-discovery.password

기본 인증에 사용할 암호를 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.consul.service-discovery.read-timeout-millis

OkHttpClient에 대한 시간 초과를 읽습니다.

 

long

camel.cloud.consul.service-discovery.url

Consul 에이전트 URL입니다.

 

문자열

camel.cloud.consul.service-discovery.user-name

기본 인증에 사용할 사용자 이름을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.write-timeout-millis

OkHttpClient에 대한 쓰기 시간 초과입니다.

 

long

camel.cloud.dns.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.dns.service-discovery.domain

도메인 이름;.

 

문자열

camel.cloud.dns.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.dns.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.dns.service-discovery.proto

원하는 서비스의 전송 프로토콜입니다.

_tcp

문자열

camel.cloud.etcd.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.etcd.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.etcd.service-discovery.password

기본 인증에 사용할 암호입니다.

 

문자열

camel.cloud.etcd.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.etcd.service-discovery.service-path

서비스 검색을 찾는 경로입니다.

/services/

문자열

camel.cloud.etcd.service-discovery.timeout

작업을 완료하는 데 사용할 수 있는 최대 시간을 설정하려면 다음을 수행하십시오.

 

long

camel.cloud.etcd.service-discovery.type

검색 유형을 설정하려면 유효한 값이 온 디맨드 및 감시입니다.

On-demand

문자열

camel.cloud.etcd.service-discovery.uris

클라이언트가 연결할 수 있는 URI입니다.

 

문자열

camel.cloud.etcd.service-discovery.user-name

기본 인증에 사용할 사용자 이름입니다.

 

문자열

camel.cloud.kubernetes.service-discovery.api-version

클라이언트 조회를 사용할 때 API 버전을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-data

클라이언트 조회를 사용할 때 인증 기관 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 Certificate Authority 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-data

클라이언트 조회를 사용할 때 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-algo

클라이언트 조회를 사용할 때 RSA와 같은 Client Keystore 알고리즘을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-data

클라이언트 조회를 사용할 때 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-passphrase

클라이언트 조회를 사용할 때 클라이언트 키 저장소 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.kubernetes.service-discovery.dns-domain

DNS 조회에 사용할 DNS 도메인을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.kubernetes.service-discovery.lookup

서비스 조회를 수행하는 방법 가능한 값: client, dns, environment. 클라이언트를 사용하는 경우 클라이언트는 kubernetes 마스터를 쿼리하여 서비스를 제공하는 활성 Pod 목록을 가져온 다음 Pod를 무작위(또는 라운드 로빈)합니다. dns를 사용하면 서비스 이름이 name.namespace.svc.dnsDomain으로 확인됩니다. dnssrv를 사용하는 경우 . …​svc…​의 SRV 쿼리로 서비스 이름이 확인됩니다 .환경을 사용하는 경우 서비스를 조회하는 데 환경 변수를 사용합니다. 기본적으로 환경이 사용됩니다.

환경

문자열

camel.cloud.kubernetes.service-discovery.master-url

클라이언트 조회를 사용할 때 URL을 마스터로 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.namespace

사용할 네임스페이스를 설정합니다. 기본적으로 ENV 변수 KUBERNETES_MASTER의 네임스페이스를 사용합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.oauth-token

클라이언트 조회를 사용할 때 인증을 위해 OAUTH 토큰(사용자 이름/암호 대신)을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.password

클라이언트 조회를 사용할 때 인증 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-name

DNS/DNSSRV 조회에 사용할 포트 이름을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-protocol

DNS/DNSSRV 조회에 사용할 포트 프로토콜을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.kubernetes.service-discovery.trust-certs

클라이언트 조회를 사용할 때 신뢰 인증서 검사를 설정할지 여부를 설정합니다.

false

부울

camel.cloud.kubernetes.service-discovery.username

클라이언트 조회를 사용할 때 인증에 대한 사용자 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.client-name

Ribbon 클라이언트 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.ribbon.load-balancer.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.ribbon.load-balancer.namespace

네임스페이스입니다.

 

문자열

camel.cloud.ribbon.load-balancer.password

암호입니다.

 

문자열

camel.cloud.ribbon.load-balancer.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.ribbon.load-balancer.username

사용자 이름입니다.

 

문자열

camel.hystrix.allow-maximum-size-to-diverge-from-core-size

최대Size 설정을 적용할 수 있습니다. 그런 다음 해당 값은 coreSize보다 크거나 같을 수 있습니다.

false

부울

camel.hystrix.circuit-breaker-enabled

HystrixCircuitBreaker 사용 여부입니다. false인 경우 회로 차단기 논리가 사용되지 않고 모든 요청이 허용됩니다. 이는 circuitBreakerForceECDHEd()와 유사하지만 메트릭을 계속 추적하고 공개/닫어야 하는지 여부를 알고 있기 때문에 회로 교체를 인스턴스화하지 않습니다.

true

부울

camel.hystrix.circuit-breaker-error-threshold-percentage

오류 백분율 임계값(50과 같은 정수)은 회로 차단기가 열려 있고 요청을 거부합니다. 이는 circuitBreakerSleepWindowInMilliseconds에 정의된 기간 동안 트립을 유지합니다. 오류 비율은 HystrixCommandMetrics.getHealthCounts()와 비교됩니다.

50

정수

camel.hystrix.circuit-breaker-force-closed

true인 경우 HystrixCircuitBreaker#allowRequest()는 HystrixCommandMetrics.getHealthCounts()의 오류 백분율에 관계없이 요청을 허용하도록 항상 true를 반환합니다. circuitBreakerForceOpen() 속성이 우선하므로 true로 설정하면 이 속성이 아무 작업도 수행하지 않습니다.

false

부울

camel.hystrix.circuit-breaker-force-open

true인 경우 HystrixCircuitBreaker.allowRequest()는 항상 false를 반환하므로 회로가 열려 있고 모든 요청을 거부합니다. 이 속성은 circuitBreakerForce 10.0.0.1d()보다 우선합니다.

false

부울

camel.hystrix.circuit-breaker-request-volume-threshold

HystrixCircuitBreaker가 이동하기 전에 존재해야 하는 metricsRollingStatisticalWindowInMilliseconds()의 최소 요청 수입니다. 이 숫자 아래에 있는 경우 회로는 오류 백분율에 관계없이 이동하지 않습니다.

20

정수

camel.hystrix.circuit-breaker-sleep-window-in-milliseconds

HystrixCircuitBreaker 트립션이 열린 후 다시 요청을 시도하기 전에 대기해야 하는 시간(밀리초)입니다.

5000

정수

camel.hystrix.configurations

추가 구성 정의를 정의합니다.

 

map

camel.hystrix.core-pool-size

java.util.concurrent.ThreadPoolExecutor#setCorePoolSize(int)에 전달되는 코어 스레드 풀 크기입니다.

10

정수

camel.hystrix.enabled

구성 요소를 활성화합니다.

true

부울

camel.hystrix.execution-isolation-semaphore-max-concurrent-requests

HystrixCommand.run()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 거부됩니다. 실행IsolationStrategy == SEMAPHORE 경우에만 적용됩니다.

20

정수

camel.hystrix.execution-isolation-strategy

을 사용하여 격리 전략 HystrixCommand.run()를 실행합니다. THREAD가 별도의 스레드에서 실행되고 스레드 풀의 스레드 수에 따라 제한되는 동시 요청이 실행됩니다. SEMAPHORE는 호출 스레드와 세마포 수에 의해 제한되는 동시 요청에서 실행됩니다.

THREAD

문자열

camel.hystrix.execution-isolation-thread-interrupt-on-timeout

스레드가 시간 초과될 때 실행 스레드에서 인터럽트를 시도해야 하는지 여부입니다. whether the execution thread should attempt an interrupt (using an interrupt#cancel ) when a thread times out. executionIsolationStrategy() == THREAD 경우에만 적용됩니다.

true

부울

camel.hystrix.execution-timeout-enabled

이 명령에 시간 초과 메커니즘이 활성화되었는지 여부.

true

부울

camel.hystrix.execution-timeout-in-milliseconds

명령이 시간 초과되고 실행을 중지하는 시간(밀리초)입니다. executionIsolationThreadInterruptOnTimeout == true 및 명령이 thread-isolated인 경우 실행 중인 스레드가 중단됩니다. 명령이 세마포 분리 및 HystrixObservableCommand인 경우 해당 명령은 구독 해제됩니다.

1000

정수

camel.hystrix.fallback-enabled

오류가 발생할 때 HystrixCommand.getFallback()을 시도해야 하는지 여부

true

부울

camel.hystrix.fallback-isolation-semaphore-max-concurrent-requests

HystrixCommand.getFallback()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 빠르게 실패하며 폴백 검색을 시도하지 않습니다.

10

정수

camel.hystrix.group-key

사용할 그룹 키를 설정합니다. 기본값은 CamelHystrix입니다.

CamelHystrix

문자열

camel.hystrix.keep-alive-time

ThreadPoolExecutor#setKeepAliveTime(long,TimeUnit)에 전달되는 Keep-alive 시간(분).

1

정수

camel.hystrix.max-queue-size

HystrixConcurrencyStrategy.getBlockingQueue(int)에서 BlockingQueue에 전달되는 최대 대기열 크기는 스레드 풀의 인스턴스화에만 영향을 미칩니다. 이를 위해 queueSizeRejectionThreshold()를 사용합니다.

-1

정수

camel.hystrix.maximum-size

ThreadPoolExecutor#setMaximumPoolSize(int)에 전달되는 최대 스레드 풀 크기입니다. 이는 HystrixCommands를 거부하지 않고 지원할 수 있는 최대 동시성 양입니다. 이 설정은 allowMaximumSizeToDivergeFromCoreSizeSize도 설정하는 경우에만 적용됩니다.

10

정수

camel.hystrix.metrics-health-snapshot-interval-in-milliseconds

성공 및 오류 백분율을 계산하고 HystrixCircuitBreaker.isOpen() 상태에 영향을 미치는 상태 스냅샷 허용 사이에 대기하는 시간(밀리초)입니다. 양이 많은 경우 오류 백분율의 지속적인 계산이 CPU 집약적이 될 수 있으므로 계산된 빈도를 제어합니다.

500

정수

camel.hystrix.metrics-rolling-percentile-bucket-size

롤링 백분율의 각 버킷에 저장된 최대 값 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-percentile-enabled

HystrixCommandMetrics 내에서 HystrixRollingPercentile을 사용하여 백분율 지표를 캡처해야 하는지 여부입니다.

true

부울

camel.hystrix.metrics-rolling-percentile-window-buckets

롤링 백분위기 창이 분할되는 버킷 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

6

정수

camel.hystrix.metrics-rolling-percentile-window-in-milliseconds

백분율로 구성된 창(밀리초)입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10000

정수

camel.hystrix.metrics-rolling-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 HystrixCommandMetrics 내부의 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-statistical-window-in-milliseconds

이 속성은 통계 롤링 창(밀리초)을 설정합니다. 스레드 풀에 대해 메트릭을 유지하는 방법입니다. 이 창은 버킷으로 나뉘어져 해당 증분으로 롤백됩니다.

10000

정수

camel.hystrix.queue-size-rejection-threshold

큐 크기 거부 임계값은 maxQueueSize에 도달하지 않은 경우에도 거부가 발생하는 인위성 최대 크기입니다. BlockingQueue의 maxQueueSize는 동적으로 변경할 수 없으며 거부에 영향을 미치는 큐 크기의 동적으로 변경을 지원하려고 하므로 수행됩니다. 이는 실행을 위한 스레드를 대기열에 추가할 때 HystrixCommand에서 사용됩니다.

5

정수

camel.hystrix.request-log-enabled

HystrixCommand 실행 및 이벤트를 HystrixRequestLog에 기록해야 하는지 여부입니다.

true

부울

camel.hystrix.thread-pool-key

사용할 스레드 풀 키를 설정합니다. 기본적으로는 groupKey가 사용하도록 구성된 것과 동일한 값을 사용합니다.

CamelHystrix

문자열

camel.hystrix.thread-pool-rolling-number-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.thread-pool-rolling-number-statistical-window-in-milliseconds

통계 롤링 창(밀리초)입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10000

정수

camel.language.constant.enabled

상수 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.constant.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.csimple.enabled

csimple 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.csimple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.exchangeproperty.enabled

exchangeProperty 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.exchangeproperty.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.file.enabled

파일 언어 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.file.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.header.enabled

헤더 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.header.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.ref.enabled

ref 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.ref.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.simple.enabled

간단한 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.simple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.tokenize.enabled

토큰화 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.tokenize.group-delimiter

그룹화할 때 사용할 구분 기호를 설정합니다. 이 값을 설정하지 않으면 토큰은 구분 기호로 사용됩니다.

 

문자열

camel.language.tokenize.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.resilience4j.automatic-transition-from-open-to-half-open-enabled

waitDurationInOpenState가 통과되면 OPEN에서 HALF_OPEN 상태로 자동 전환할 수 있습니다.

false

부울

camel.resilience4j.circuit-breaker-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreaker 인스턴스를 나타냅니다. 이 기능을 사용할 때 다른 회로 차단기 옵션을 사용하지 않습니다.

 

문자열

camel.resilience4j.config-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreakerConfig 인스턴스를 나타냅니다.

 

문자열

camel.resilience4j.configurations

추가 구성 정의를 정의합니다.

 

map

camel.resilience4j.enabled

구성 요소를 활성화합니다.

true

부울

camel.resilience4j.failure-rate-threshold

실패 비율 임계값을 백분율로 구성합니다. 실패 비율이 임계값보다 크거나 같으면 CircuitBreaker가 열기로 전환되고 쇼트 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 50입니다.

 

float

camel.resilience4j.minimum-number-of-calls

CircuitBreaker가 오류 속도를 계산할 수 있기 전에 필요한 최소 호출 수(라이딩 창 기간당)를 구성합니다. 예를 들어, minimumNumberOf>-<s가 10인 경우 실패 비율을 계산하기 전에 최소 10번의 호출을 기록해야 합니다. 9 개의 호출 만 기록 된 경우 CircuitBreaker는 모든 9 번 호출이 실패하더라도 열기 위해 전환되지 않습니다. 기본 minimumNumberOf>-<s는 100입니다.

100

정수

camel.resilience4j.permitted-number-of-calls-in-half-open-state

CircuitBreaker가 절반 열려 있을 때 허용되는 호출 수를 설정합니다. 크기는 0보다 커야 합니다. 기본값은 10입니다.

10

정수

camel.resilience4j.sliding-window-size

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 크기를 설정합니다. slidingWindowSize는 슬라이딩 창 크기를 구성합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 슬라이딩 WindowSize는 0보다 커야 합니다. minimumNumberOf>-<s는 0보다 커야 합니다. slidingWindowType이 COUNT_BASED인 경우 minimumNumberOf>-<s는 slidingWindowSize . 슬라이딩 WindowType이 TIME_BASED인 경우 원하는 항목을 선택할 수 있습니다. 기본 slidingWindowSize는 100입니다.

100

정수

camel.resilience4j.sliding-window-type

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 유형을 설정합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 기본 sliding WindowType은 COUNT_BASED입니다.

COUNT_BASED

문자열

camel.resilience4j.slow-call-duration-threshold

호출이 느리고 느린 호출 비율을 늘리는 기간 임계값(초)을 구성합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.slow-call-rate-threshold

임계값을 백분율로 구성합니다. CircuitBreaker는 호출 기간이 slowECDHEDurationThreshold Duration보다 클 때 호출 속도가 느린 것으로 간주합니다. 느린 호출의 백분율이 임계값 이상인 경우 CircuitBreaker는 열기로 전환되고 단기 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 100 백분율로, 기록된 모든 호출이 slowECDHEDurationThreshold보다 느릴 수 있음을 의미합니다.

 

float

camel.resilience4j.wait-duration-in-open-state

대기 기간(초)을 설정합니다. CircuitBreaker는 반으로 전환되기 전에 열려 있어야 하는 시간을 지정합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.writable-stack-trace-enabled

쓰기 가능한 스택 추적을 활성화합니다. false로 설정하면 Exception.getStackTrace에서 길이 배열을 0개 반환합니다. 예외의 원인이 이미 알려진 대로 회로 차단기가 열려 있을 때 로그 스팸을 줄이는 데 사용할 수 있습니다(회로 차단기는 짧은 호출임).

true

부울

camel.rest.api-component

REST API(예: swagger)로 사용할 Camel 구성 요소의 이름(예: swagger)이 명시적으로 구성되어 있지 않은 경우, REST API 문서를 서비스하고 생성하는 Camel 구성 요소가 있는지 또는 org.apache.camel.camel.spi.RestApiProcessorFactory가 레지스트리에 등록되어 있는 경우 Camel을 조회합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.api-context-path

REST API 서비스가 사용할 선행 API 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다.

 

문자열

camel.rest.api-context-route-id

REST API를 제공하는 경로에 사용할 경로 ID를 설정합니다. 이 경로는 기본적으로 자동 할당된 경로 ID를 사용합니다.

 

문자열

camel.rest.api-host

API 설명서에 특정 호스트 이름(예: swagger)을 사용하려면 생성된 호스트를 이 구성된 호스트 이름으로 덮어쓸 수 있습니다.

 

문자열

camel.rest.api-property

api 설명서(swagger)에 대한 많은 추가 속성을 구성할 수 있습니다. 예를 들어 속성 api.title을 이상적인 제품으로 설정합니다.

 

map

camel.rest.api-vendor-extension

Rest API에서 벤더 확장이 활성화되었는지 여부. 활성화하면 Camel에는 추가 정보(예: 경로 ID, 클래스 이름 등 x로 시작하는 키)로 추가 정보가 포함됩니다. API docs를 가져올 때 모든 타사 API 게이트웨이 및 도구가 vendor-extensions를 지원하는 것은 아닙니다.

false

부울

camel.rest.binding-mode

사용할 바인딩 모드를 설정합니다. 기본값은 OFF입니다.

 

RestBindingMode

camel.rest.client-request-validation

클라이언트 요청의 유효성 검사를 활성화하여 클라이언트의 Content-Type 및 Accept 헤더가 사용/생산 설정의 Rest-DSL 구성에서 지원하는지 여부를 확인합니다. 확인을 위해 이 설정을 사용할 수 있습니다. 유효성 검사 오류의 경우 HTTP 상태 코드 415 또는 406이 반환됩니다. 기본값은 false입니다.

false

부울

camel.rest.component

netty-http, jetty, 서블릿과 같이 REST 전송(consumer)에 사용할 Camel Rest 구성 요소. 명시적으로 구성된 구성 요소가 없는 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestConsumerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.component-property

사용 중인 나머지 구성 요소에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.consumer-property

사용 중인 나머지 소비자에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.context-path

REST 서비스가 사용할 선행 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다. 또는 HTTP 서버를 포함하는 camel-jetty 또는 camel-netty-http와 같은 구성 요소의 경우

 

문자열

camel.rest.cors-headers

사용자 정의 CORS 헤더를 구성할 수 있습니다.

 

map

camel.rest.data-format-property

사용 중인 데이터 형식에 대한 추가 속성 수를 구성할 수 있습니다. 예를 들어 매우 모드에서 json을 출력하려면 속성 pretty 아닌 true로 속성을 설정합니다. 옵션 앞에 있는 속성을 추가하여 JSON 또는 XML과 IN 또는 OUT 중 하나에만 사용할 수 있습니다. 접두사는 json.in. json.out. xml.in. xml.out입니다. 예를 들어 xml.out.mustBeJAXB>-< 값이 있는 키는 나가는 XML 데이터 형식일 뿐입니다. 접두사가 없는 키는 모든 상황에서 공통 키입니다.

 

map

camel.rest.enable-cors

HTTP 응답에서 CORS 헤더를 활성화할지 여부입니다. 기본값은 false입니다.

false

부울

camel.rest.endpoint-property

사용 중인 나머지 엔드포인트에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.host

REST 서비스 노출에 사용할 호스트 이름입니다.

 

문자열

camel.rest.host-name-resolver

호스트 이름이 명시적으로 구성되지 않은 경우 이 확인자는 REST 서비스에서 사용할 호스트 이름을 계산하는 데 사용됩니다.

 

RestHostNameResolver

camel.rest.json-data-format

사용할 특정 json 데이터 형식의 이름입니다. 기본적으로 json-jackson이 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.port

REST 서비스 노출에 사용할 포트 번호입니다. 서블릿 구성 요소를 사용하는 경우 사용 중인 포트 번호가 실제로 적용되는 포트 번호가 적용되지 않습니다. 예를 들어 Apache Tomcat을 사용하는 경우 Apache Karaf를 사용하는 Karaf의 HTTP 서비스는 기본적으로 8181 포트를 사용합니다. 여기에 포트 번호를 설정하는 경우에는 툴링 및 ScanSetting이 포트 번호를 알 수 있으므로 포트 번호를 서블릿 엔진이 사용하는 번호로 설정하는 것이 좋습니다.

 

문자열

camel.rest.producer-api-doc

REST 프로듀서에서 REST uri 및 쿼리 매개변수가 api 문서에 따라 유효한지 확인하는 데 사용할 API 문서(swagger api)의 위치를 설정합니다. 이를 위해서는 classpath에 camel-swagger-java를 추가해야 하며, 누락된 구성으로 인해 Camel이 시작 시 실패하고 오류를 보고할 수 있습니다. 기본적으로 api 문서의 위치는 classpath에서 로드되지만 file: 또는 http:를 사용하여 파일 또는 http URL에서 로드할 리소스를 참조할 수 있습니다.

 

문자열

camel.rest.producer-component

REST 생산자로 사용할 Camel 구성 요소의 이름을 설정합니다.

 

문자열

camel.rest.scheme

REST 서비스를 노출하는 데 사용할 스키마입니다. 일반적으로 http 또는 https가 지원됩니다. 기본값은 http입니다.

 

문자열

camel.rest.skip-binding-on-error-code

사용자 정의 HTTP 오류 코드 헤더가 있는 경우 출력에 바인딩을 건너뛸지 여부입니다. 이렇게 하면 성공 메시지가 그렇지 않으면 json / xml 등에 바인딩되지 않는 사용자 정의 오류 메시지를 빌드할 수 있습니다.

false

부울

camel.rest.use-x-forward-headers

호스트 및 관련 설정에 X-Forward 헤더를 사용할지 여부입니다. 기본값은 true입니다.

true

부울

camel.rest.xml-data-format

사용할 특정 XML 데이터 형식의 이름입니다. 기본적으로 jvncb가 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.api-context-id-pattern

CamelContext id 패턴과 일치하는 CamelContext의 재사용 서비스 API만 허용하도록 CamelContext id 패턴을 설정합니다. 패턴 이름은 현재 CamelContext에서만 일치하는 CamelContext 이름을 나타냅니다. 다른 값의 경우 패턴은 Pattern>-<er#matchPattern(String,String)의 규칙을 사용합니다.

 

문자열

camel.rest.api-context-listing

JVM에서 REST 서비스를 사용하는 사용 가능한 모든 CamelContext의 목록이 활성화되었는지 여부를 더 이상 사용되지 않는 세트입니다. 활성화하면 이러한 컨텍스트를 검색할 수 있는 경우 false인 경우 현재 CamelContext만 사용 중입니다.

false

부울

67장. CSimple

C Simple 언어는 간단한 언어로 컴파일됩니다.

67.1. CSimple과 Simple의 차이가 있습니다.

간단한 언어는 Camel Expressions 또는 Predicates 세트로 런타임 구문 분석되는 동적 표현식 언어입니다.

csimple 언어는 일반 Java 소스 코드로 구문 분석되고 다른 모든 소스 코드와 함께 컴파일되거나 camel-csimple-joor 모듈을 통해 부트스트랩 중에 한 번 컴파일됩니다.

간단한 언어는 일반적으로 매우 가볍고 빠르지만 OGNL 경로를 통해 동적 메서드 호출을 사용하는 일부 사용 사례의 경우 간단한 언어에서는 런타임 인트로스펙션 및 리버전션 호출을 수행합니다. 이는 성능에 대한 오버헤드가 있으며 csimple가 생성된 이유 중 하나였습니다.

csimple 언어는 OGNL 경로를 통해 typesafe이고 메서드 호출을 위해서는 구문 분석 중에 유형을 알아야 합니다. 즉, csimple 언어 표현식에 대해서는 스크립트에 클래스 유형을 제공해야 하는 반면 런타임 시 이를 간단하게 검사해야 합니다.

즉, 간단한 언어는 duck typing 을 사용하고 있습니다 (duck, 및 quacks 처럼 보이는 경우 duck, then it is a duck) 및 csimple는 Java 유형 (typesafety)을 사용합니다. 유형 오류가 있으면 런타임에 이를 보고하며 csimple를 사용하면 Java 컴파일 오류가 발생합니다.

67.1.1. 추가 CSimple 함수

csimple 언어에는 컬렉션, 또는 배열 유형에서 작업하는 일반적인 사용 사례를 지원하는 몇 가지 추가 기능이 포함되어 있습니다. 다음 함수 bodyAsIndex,headerAsIndex, exchangePropertyAsIndex 는 입력 시 이러한 사용 사례에 사용됩니다.

함수유형설명

bodyAsIndex(type, index)

유형

기존 컬렉션, 또는 배열(인덱스로 조회)에서 본문을 수집한 다음 본문을 클래스 이름에 의해 결정된 지정된 형식으로 변환하는 데 사용됩니다. 변환된 본문은 null일 수 있습니다.

mandatoryBodyAsIndex(type, index)

유형

기존 컬렉션, 또는 배열(인덱스로 조회)에서 본문을 수집한 다음 본문을 클래스 이름에 의해 결정된 지정된 형식으로 변환하는 데 사용됩니다. 본문이 null이 아닐 것으로 예상됩니다.

headerAsIndex(key, type, index)

유형

기존 컬렉션, 또는 배열(인덱스로 조회)에서 헤더를 수집한 다음 헤더 값을 클래스 이름에 의해 결정된 지정된 형식으로 변환하는 데 사용됩니다. 변환된 헤더는 null일 수 있습니다.

mandatoryHeaderAsIndex(key, type, index)

유형

기존 컬렉션, 또는 배열(인덱스로 조회)에서 헤더를 수집한 다음 헤더 값을 클래스 이름에 의해 결정된 지정된 형식으로 변환하는 데 사용됩니다. 헤더가 null이 아닐 것으로 예상됩니다.

exchangePropertyAsIndex(key, type, index)

유형

기존 Collection,Map 또는 array(index로 조회)에서 교환 속성을 수집한 다음, 해당 classname에 의해 결정된 지정된 형식으로 교환 속성을 변환하는 데 사용됩니다. 변환된 교환 속성은 null일 수 있습니다.

mandatoryExchangePropertyAsIndex(key, type, index)

유형

기존 Collection,Map 또는 array(index로 조회)에서 교환 속성을 수집한 다음, 해당 classname에 의해 결정된 지정된 형식으로 교환 속성을 변환하는 데 사용됩니다. exchange 속성이 null이 아닐 것으로 예상됩니다.

예를 들어 다음과 같은 간단한 표현식이 제공됩니다.

Hello $\{body[0].name}

이 스크립트는 유형 정보가 없으며 간단한 언어는 메시지 본문을 인트로스펙션하여 런타임 시 이를 해결한 다음, 컬렉션을 기반으로 첫 번째 요소를 조회한 다음 리플렉션을 통해 getName 메서드를 호출합니다.

csimple(ECDHE)에서 이 작업을 미리 컴파일해야 하므로 최종 사용자가 bodyAsIndex 함수와 함께 형식 정보를 제공해야 합니다.

Hello $\{bodyAsIndex(com.foo.MyUser, 0).name}

67.2. 컴파일

csimple 언어는 일반 Java 소스 코드로 구문 분석되어 다른 모든 소스 코드와 함께 컴파일되거나 camel-csimple-joor 모듈을 통해 부트스트랩 중에 한 번 컴파일할 수 있습니다.

csimple을 컴파일하는 방법은 두 가지가 있습니다.

  • 빌드 시 camel-csimple-maven-plugin 을 사용하여 소스 코드를 생성합니다.
  • Camel 부트 스트랩 중에 런타임 in-memory 컴파일을 수행하는 camel-csimple-joor 사용

67.2.1. camel-csimple-maven-plugin 사용

camel-csimple-maven-plugin Maven 플러그인은 소스 코드에서 모든 csimple 스크립트를 검색하는 데 사용되며, 그러면 다른 모든 소스와 함께 컴파일됩니다.

maven 플러그인은 .java.xml 파일(Java 및 XML DSL)의 소스 코드 스캔을 수행합니다. 스캐너는 특정 코드 패턴을 감지하기 위해 제한되며 비정상/레이어 방식으로 사용되는 경우 일부 csimple 스크립트를 검색하지 못할 수 있습니다.

camel-csimple-joor 를 사용한 런타임 컴파일에는 이러한 제한 사항이 없습니다.

이점은 모든 csimple 스크립트가 일반 Java 컴파일러를 사용하여 컴파일되므로 모든 항목이 애플리케이션 JAR 파일의 .class 파일로 포함되어 있으며 런타임에 추가 종속성이 필요하지 않습니다.

camel-csimple-maven-plugin 을 사용하려면 다음과 같이 pom.xml 파일에 추가해야 합니다.

<plugins>
    <!-- generate source code for csimple languages -->
    <plugin>
        <groupId>org.apache.camel</groupId>
        <artifactId>camel-csimple-maven-plugin</artifactId>
        <version>${camel.version}</version>
        <executions>
            <execution>
                <id>generate</id>
                <goals>
                    <goal>generate</goal>
                </goals>
            </execution>
        </executions>
    </plugin>
    <!-- include source code generated to maven sources paths -->
    <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>build-helper-maven-plugin</artifactId>
        <version>3.1.0</version>
        <executions>
            <execution>
                <phase>generate-sources</phase>
                <goals>
                    <goal>add-source</goal>
                    <goal>add-resource</goal>
                </goals>
                <configuration>
                    <sources>
                        <source>src/generated/java</source>
                    </sources>
                    <resources>
                        <resource>
                            <directory>src/generated/resources</directory>
                        </resource>
                    </resources>
                </configuration>
            </execution>
        </executions>
    </plugin>
</plugins>

또한 생성된 소스 코드가 컴파일되고 애플리케이션 JAR 파일에 포함되도록 build-helper-maven-plugin Maven 플러그인을 추가하여 Java 컴파일러의 소스 폴더 목록에 created /generated 를 포함해야 합니다.

maven 플러그인을 사용하는 Camel 예제의 camel-example-csimple 예제 를 참조하십시오.

67.2.2. camel-csimple-joor 사용

jOOR 라이브러리는 Java 컴파일러와 통합되며 Java 코드의 런타임 컴파일을 수행합니다.

camel-simple-joor 를 사용할 때 지원되는 런타임은 Java 독립 실행형, Spring Boot, Camel Quarkus 및 기타 마이크로 서비스 런타임을 대상으로 합니다. OSGi, Camel Karaf 또는 Java Application Server 런타임에서는 지원되지 않습니다.

jOOR은 fat exhaust packaging (https://github.com/jOOQ/jOOR/issues/69)을 사용하는 Spring Boot와의 런타임 컴파일을 지원하지 않으며, 기존 클래스 경로와 함께 작동합니다.

camel-simple-joor 를 사용하려면 classpath에 종속성으로 추가하기만 하면 됩니다.

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-csimple-joor</artifactId>
  <version>{CamelSBProjectVersion}</version>
</dependency>

pom.xml 파일에 Maven 플러그인을 추가할 필요가 없습니다.

jOOR 컴파일러를 사용하는 Camel 예제camel-example-csimple-joor 예제를 참조하십시오.

67.3. CSimple 언어 옵션

CSimple 언어는 아래에 나열된 두 가지 옵션을 지원합니다.

이름DefaultJava Type설명

resultType

 

문자열

결과 형식의 클래스 이름을 설정합니다(출력에서 유형).

trim

 

부울

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

67.4. 제한

현재 csimple 언어는 지원되지 않습니다.

  • 중첩 함수(function 내부에 사용되는 함수)
  • null 안전 연산자(??)입니다.

예를 들어 다음 스크립트는 컴파일할 수 없습니다.

  Hello ${bean:greeter(${body}, ${header.counter})}
  ${bodyAs(MyUser)?.address?.zip} > 10000

67.5. 자동 가져오기

csimple 언어는 다음에서 자동으로 가져옵니다.

import java.util.*;
import java.util.concurrent.*;
import java.util.stream.*;
import org.apache.camel.*;
import org.apache.camel.util.*;

67.6. 구성 파일

루트 classpath에서 로드된 camel-csimple.properties 파일에서 csimple 언어를 구성할 수 있습니다.

예를 들어 다음을 추가하여 camel-csimple.properties 파일에 가져오기를 추가할 수 있습니다.

import com.foo.MyUser;
import com.bar.*;
import static com.foo.MyHelper.*;

별칭이 코드에서 단축 대체로 사용될 별칭(key=value)도 추가할 수 있습니다.

echo()=${bodyAs(String)} ${bodyAs(String)}

다음과 같은 csimple 언어 스크립트에서 echo() 를 사용할 수 있습니다.

from("direct:hello")
    .transform(csimple("Hello echo()"))
    .log("You said ${body}");

echo() 별칭은 값으로 교체되어 스크립트가 다음과 같습니다.

    .transform(csimple("Hello ${bodyAs(String)} ${bodyAs(String)}"))

67.7. 예를 들면 다음과 같습니다.

Simple language as csimple 을 참조하십시오. 간단한 언어와 동일한 함수 집합이 있습니다.

67.8. Spring Boot Auto-Configuration

Spring Boot와 함께 csimple을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-core-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.cloud.consul.service-discovery.acl-token

Consul과 함께 사용할 ACL 토큰을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.block-seconds

감시 이벤트를 대기하는 시간(기본값: 10초)입니다.

10

정수

camel.cloud.consul.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.consul.service-discovery.connect-timeout-millis

OkHttpClient에 대한 연결 시간 초과입니다.

 

long

camel.cloud.consul.service-discovery.datacenter

데이터 센터입니다.

 

문자열

camel.cloud.consul.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.consul.service-discovery.password

기본 인증에 사용할 암호를 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.consul.service-discovery.read-timeout-millis

OkHttpClient에 대한 시간 초과를 읽습니다.

 

long

camel.cloud.consul.service-discovery.url

Consul 에이전트 URL입니다.

 

문자열

camel.cloud.consul.service-discovery.user-name

기본 인증에 사용할 사용자 이름을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.write-timeout-millis

OkHttpClient에 대한 쓰기 시간 초과입니다.

 

long

camel.cloud.dns.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.dns.service-discovery.domain

도메인 이름;.

 

문자열

camel.cloud.dns.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.dns.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.dns.service-discovery.proto

원하는 서비스의 전송 프로토콜입니다.

_tcp

문자열

camel.cloud.etcd.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.etcd.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.etcd.service-discovery.password

기본 인증에 사용할 암호입니다.

 

문자열

camel.cloud.etcd.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.etcd.service-discovery.service-path

서비스 검색을 찾는 경로입니다.

/services/

문자열

camel.cloud.etcd.service-discovery.timeout

작업을 완료하는 데 사용할 수 있는 최대 시간을 설정하려면 다음을 수행하십시오.

 

long

camel.cloud.etcd.service-discovery.type

검색 유형을 설정하려면 유효한 값이 온 디맨드 및 감시입니다.

On-demand

문자열

camel.cloud.etcd.service-discovery.uris

클라이언트가 연결할 수 있는 URI입니다.

 

문자열

camel.cloud.etcd.service-discovery.user-name

기본 인증에 사용할 사용자 이름입니다.

 

문자열

camel.cloud.kubernetes.service-discovery.api-version

클라이언트 조회를 사용할 때 API 버전을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-data

클라이언트 조회를 사용할 때 인증 기관 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 Certificate Authority 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-data

클라이언트 조회를 사용할 때 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-algo

클라이언트 조회를 사용할 때 RSA와 같은 Client Keystore 알고리즘을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-data

클라이언트 조회를 사용할 때 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-passphrase

클라이언트 조회를 사용할 때 클라이언트 키 저장소 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.kubernetes.service-discovery.dns-domain

DNS 조회에 사용할 DNS 도메인을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.kubernetes.service-discovery.lookup

서비스 조회를 수행하는 방법 가능한 값: client, dns, environment. 클라이언트를 사용하는 경우 클라이언트는 kubernetes 마스터를 쿼리하여 서비스를 제공하는 활성 Pod 목록을 가져온 다음 Pod를 무작위(또는 라운드 로빈)합니다. dns를 사용하면 서비스 이름이 name.namespace.svc.dnsDomain으로 확인됩니다. dnssrv를 사용하는 경우 . …​svc…​의 SRV 쿼리로 서비스 이름이 확인됩니다 .환경을 사용하는 경우 서비스를 조회하는 데 환경 변수를 사용합니다. 기본적으로 환경이 사용됩니다.

환경

문자열

camel.cloud.kubernetes.service-discovery.master-url

클라이언트 조회를 사용할 때 URL을 마스터로 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.namespace

사용할 네임스페이스를 설정합니다. 기본적으로 ENV 변수 KUBERNETES_MASTER의 네임스페이스를 사용합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.oauth-token

클라이언트 조회를 사용할 때 인증을 위해 OAUTH 토큰(사용자 이름/암호 대신)을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.password

클라이언트 조회를 사용할 때 인증 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-name

DNS/DNSSRV 조회에 사용할 포트 이름을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-protocol

DNS/DNSSRV 조회에 사용할 포트 프로토콜을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.kubernetes.service-discovery.trust-certs

클라이언트 조회를 사용할 때 신뢰 인증서 검사를 설정할지 여부를 설정합니다.

false

부울

camel.cloud.kubernetes.service-discovery.username

클라이언트 조회를 사용할 때 인증에 대한 사용자 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.client-name

Ribbon 클라이언트 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.ribbon.load-balancer.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.ribbon.load-balancer.namespace

네임스페이스입니다.

 

문자열

camel.cloud.ribbon.load-balancer.password

암호입니다.

 

문자열

camel.cloud.ribbon.load-balancer.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.ribbon.load-balancer.username

사용자 이름입니다.

 

문자열

camel.hystrix.allow-maximum-size-to-diverge-from-core-size

최대Size 설정을 적용할 수 있습니다. 그런 다음 해당 값은 coreSize보다 크거나 같을 수 있습니다.

false

부울

camel.hystrix.circuit-breaker-enabled

HystrixCircuitBreaker 사용 여부입니다. false인 경우 회로 차단기 논리가 사용되지 않고 모든 요청이 허용됩니다. 이는 circuitBreakerForceECDHEd()와 유사하지만 메트릭을 계속 추적하고 공개/닫어야 하는지 여부를 알고 있기 때문에 회로 교체를 인스턴스화하지 않습니다.

true

부울

camel.hystrix.circuit-breaker-error-threshold-percentage

오류 백분율 임계값(50과 같은 정수)은 회로 차단기가 열려 있고 요청을 거부합니다. 이는 circuitBreakerSleepWindowInMilliseconds에 정의된 기간 동안 트립을 유지합니다. 오류 비율은 HystrixCommandMetrics.getHealthCounts()와 비교됩니다.

50

정수

camel.hystrix.circuit-breaker-force-closed

true인 경우 HystrixCircuitBreaker#allowRequest()는 HystrixCommandMetrics.getHealthCounts()의 오류 백분율에 관계없이 요청을 허용하도록 항상 true를 반환합니다. circuitBreakerForceOpen() 속성이 우선하므로 true로 설정하면 이 속성이 아무 작업도 수행하지 않습니다.

false

부울

camel.hystrix.circuit-breaker-force-open

true인 경우 HystrixCircuitBreaker.allowRequest()는 항상 false를 반환하므로 회로가 열려 있고 모든 요청을 거부합니다. 이 속성은 circuitBreakerForce 10.0.0.1d()보다 우선합니다.

false

부울

camel.hystrix.circuit-breaker-request-volume-threshold

HystrixCircuitBreaker가 이동하기 전에 존재해야 하는 metricsRollingStatisticalWindowInMilliseconds()의 최소 요청 수입니다. 이 숫자 아래에 있는 경우 회로는 오류 백분율에 관계없이 이동하지 않습니다.

20

정수

camel.hystrix.circuit-breaker-sleep-window-in-milliseconds

HystrixCircuitBreaker 트립션이 열린 후 다시 요청을 시도하기 전에 대기해야 하는 시간(밀리초)입니다.

5000

정수

camel.hystrix.configurations

추가 구성 정의를 정의합니다.

 

map

camel.hystrix.core-pool-size

java.util.concurrent.ThreadPoolExecutor#setCorePoolSize(int)에 전달되는 코어 스레드 풀 크기입니다.

10

정수

camel.hystrix.enabled

구성 요소를 활성화합니다.

true

부울

camel.hystrix.execution-isolation-semaphore-max-concurrent-requests

HystrixCommand.run()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 거부됩니다. 실행IsolationStrategy == SEMAPHORE 경우에만 적용됩니다.

20

정수

camel.hystrix.execution-isolation-strategy

을 사용하여 격리 전략 HystrixCommand.run()를 실행합니다. THREAD가 별도의 스레드에서 실행되고 스레드 풀의 스레드 수에 따라 제한되는 동시 요청이 실행됩니다. SEMAPHORE는 호출 스레드와 세마포 수에 의해 제한되는 동시 요청에서 실행됩니다.

THREAD

문자열

camel.hystrix.execution-isolation-thread-interrupt-on-timeout

스레드가 시간 초과될 때 실행 스레드에서 인터럽트를 시도해야 하는지 여부입니다. whether the execution thread should attempt an interrupt (using an interrupt#cancel ) when a thread times out. executionIsolationStrategy() == THREAD 경우에만 적용됩니다.

true

부울

camel.hystrix.execution-timeout-enabled

이 명령에 시간 초과 메커니즘이 활성화되었는지 여부.

true

부울

camel.hystrix.execution-timeout-in-milliseconds

명령이 시간 초과되고 실행을 중지하는 시간(밀리초)입니다. executionIsolationThreadInterruptOnTimeout == true 및 명령이 thread-isolated인 경우 실행 중인 스레드가 중단됩니다. 명령이 세마포 분리 및 HystrixObservableCommand인 경우 해당 명령은 구독 해제됩니다.

1000

정수

camel.hystrix.fallback-enabled

오류가 발생할 때 HystrixCommand.getFallback()을 시도해야 하는지 여부

true

부울

camel.hystrix.fallback-isolation-semaphore-max-concurrent-requests

HystrixCommand.getFallback()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 빠르게 실패하며 폴백 검색을 시도하지 않습니다.

10

정수

camel.hystrix.group-key

사용할 그룹 키를 설정합니다. 기본값은 CamelHystrix입니다.

CamelHystrix

문자열

camel.hystrix.keep-alive-time

ThreadPoolExecutor#setKeepAliveTime(long,TimeUnit)에 전달되는 Keep-alive 시간(분).

1

정수

camel.hystrix.max-queue-size

HystrixConcurrencyStrategy.getBlockingQueue(int)에서 BlockingQueue에 전달되는 최대 대기열 크기는 스레드 풀의 인스턴스화에만 영향을 미칩니다. 이를 위해 queueSizeRejectionThreshold()를 사용합니다.

-1

정수

camel.hystrix.maximum-size

ThreadPoolExecutor#setMaximumPoolSize(int)에 전달되는 최대 스레드 풀 크기입니다. 이는 HystrixCommands를 거부하지 않고 지원할 수 있는 최대 동시성 양입니다. 이 설정은 allowMaximumSizeToDivergeFromCoreSizeSize도 설정하는 경우에만 적용됩니다.

10

정수

camel.hystrix.metrics-health-snapshot-interval-in-milliseconds

성공 및 오류 백분율을 계산하고 HystrixCircuitBreaker.isOpen() 상태에 영향을 미치는 상태 스냅샷 허용 사이에 대기하는 시간(밀리초)입니다. 양이 많은 경우 오류 백분율의 지속적인 계산이 CPU 집약적이 될 수 있으므로 계산된 빈도를 제어합니다.

500

정수

camel.hystrix.metrics-rolling-percentile-bucket-size

롤링 백분율의 각 버킷에 저장된 최대 값 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-percentile-enabled

HystrixCommandMetrics 내에서 HystrixRollingPercentile을 사용하여 백분율 지표를 캡처해야 하는지 여부입니다.

true

부울

camel.hystrix.metrics-rolling-percentile-window-buckets

롤링 백분위기 창이 분할되는 버킷 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

6

정수

camel.hystrix.metrics-rolling-percentile-window-in-milliseconds

백분율로 구성된 창(밀리초)입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10000

정수

camel.hystrix.metrics-rolling-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 HystrixCommandMetrics 내부의 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-statistical-window-in-milliseconds

이 속성은 통계 롤링 창(밀리초)을 설정합니다. 스레드 풀에 대해 메트릭을 유지하는 방법입니다. 이 창은 버킷으로 나뉘어져 해당 증분으로 롤백됩니다.

10000

정수

camel.hystrix.queue-size-rejection-threshold

큐 크기 거부 임계값은 maxQueueSize에 도달하지 않은 경우에도 거부가 발생하는 인위성 최대 크기입니다. BlockingQueue의 maxQueueSize는 동적으로 변경할 수 없으며 거부에 영향을 미치는 큐 크기의 동적으로 변경을 지원하려고 하므로 수행됩니다. 이는 실행을 위한 스레드를 대기열에 추가할 때 HystrixCommand에서 사용됩니다.

5

정수

camel.hystrix.request-log-enabled

HystrixCommand 실행 및 이벤트를 HystrixRequestLog에 기록해야 하는지 여부입니다.

true

부울

camel.hystrix.thread-pool-key

사용할 스레드 풀 키를 설정합니다. 기본적으로는 groupKey가 사용하도록 구성된 것과 동일한 값을 사용합니다.

CamelHystrix

문자열

camel.hystrix.thread-pool-rolling-number-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.thread-pool-rolling-number-statistical-window-in-milliseconds

통계 롤링 창(밀리초)입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10000

정수

camel.language.constant.enabled

상수 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.constant.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.csimple.enabled

csimple 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.csimple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.exchangeproperty.enabled

exchangeProperty 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.exchangeproperty.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.file.enabled

파일 언어 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.file.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.header.enabled

헤더 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.header.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.ref.enabled

ref 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.ref.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.simple.enabled

간단한 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.simple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.tokenize.enabled

토큰화 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.tokenize.group-delimiter

그룹화할 때 사용할 구분 기호를 설정합니다. 이 값을 설정하지 않으면 토큰은 구분 기호로 사용됩니다.

 

문자열

camel.language.tokenize.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.resilience4j.automatic-transition-from-open-to-half-open-enabled

waitDurationInOpenState가 통과되면 OPEN에서 HALF_OPEN 상태로 자동 전환할 수 있습니다.

false

부울

camel.resilience4j.circuit-breaker-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreaker 인스턴스를 나타냅니다. 이 기능을 사용할 때 다른 회로 차단기 옵션을 사용하지 않습니다.

 

문자열

camel.resilience4j.config-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreakerConfig 인스턴스를 나타냅니다.

 

문자열

camel.resilience4j.configurations

추가 구성 정의를 정의합니다.

 

map

camel.resilience4j.enabled

구성 요소를 활성화합니다.

true

부울

camel.resilience4j.failure-rate-threshold

실패 비율 임계값을 백분율로 구성합니다. 실패 비율이 임계값보다 크거나 같으면 CircuitBreaker가 열기로 전환되고 쇼트 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 50입니다.

 

float

camel.resilience4j.minimum-number-of-calls

CircuitBreaker가 오류 속도를 계산할 수 있기 전에 필요한 최소 호출 수(라이딩 창 기간당)를 구성합니다. 예를 들어, minimumNumberOf>-<s가 10인 경우 실패 비율을 계산하기 전에 최소 10번의 호출을 기록해야 합니다. 9 개의 호출 만 기록 된 경우 CircuitBreaker는 모든 9 번 호출이 실패하더라도 열기 위해 전환되지 않습니다. 기본 minimumNumberOf>-<s는 100입니다.

100

정수

camel.resilience4j.permitted-number-of-calls-in-half-open-state

CircuitBreaker가 절반 열려 있을 때 허용되는 호출 수를 설정합니다. 크기는 0보다 커야 합니다. 기본값은 10입니다.

10

정수

camel.resilience4j.sliding-window-size

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 크기를 설정합니다. slidingWindowSize는 슬라이딩 창 크기를 구성합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 슬라이딩 WindowSize는 0보다 커야 합니다. minimumNumberOf>-<s는 0보다 커야 합니다. slidingWindowType이 COUNT_BASED인 경우 minimumNumberOf>-<s는 slidingWindowSize . 슬라이딩 WindowType이 TIME_BASED인 경우 원하는 항목을 선택할 수 있습니다. 기본 slidingWindowSize는 100입니다.

100

정수

camel.resilience4j.sliding-window-type

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 유형을 설정합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 기본 sliding WindowType은 COUNT_BASED입니다.

COUNT_BASED

문자열

camel.resilience4j.slow-call-duration-threshold

호출이 느리고 느린 호출 비율을 늘리는 기간 임계값(초)을 구성합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.slow-call-rate-threshold

임계값을 백분율로 구성합니다. CircuitBreaker는 호출 기간이 slowECDHEDurationThreshold Duration보다 클 때 호출 속도가 느린 것으로 간주합니다. 느린 호출의 백분율이 임계값 이상인 경우 CircuitBreaker는 열기로 전환되고 단기 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 100 백분율로, 기록된 모든 호출이 slowECDHEDurationThreshold보다 느릴 수 있음을 의미합니다.

 

float

camel.resilience4j.wait-duration-in-open-state

대기 기간(초)을 설정합니다. CircuitBreaker는 반으로 전환되기 전에 열려 있어야 하는 시간을 지정합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.writable-stack-trace-enabled

쓰기 가능한 스택 추적을 활성화합니다. false로 설정하면 Exception.getStackTrace에서 길이 배열을 0개 반환합니다. 예외의 원인이 이미 알려진 대로 회로 차단기가 열려 있을 때 로그 스팸을 줄이는 데 사용할 수 있습니다(회로 차단기는 짧은 호출임).

true

부울

camel.rest.api-component

REST API(예: swagger)로 사용할 Camel 구성 요소의 이름(예: swagger)이 명시적으로 구성되어 있지 않은 경우, REST API 문서를 서비스하고 생성하는 Camel 구성 요소가 있는지 또는 org.apache.camel.camel.spi.RestApiProcessorFactory가 레지스트리에 등록되어 있는 경우 Camel을 조회합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.api-context-path

REST API 서비스가 사용할 선행 API 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다.

 

문자열

camel.rest.api-context-route-id

REST API를 제공하는 경로에 사용할 경로 ID를 설정합니다. 이 경로는 기본적으로 자동 할당된 경로 ID를 사용합니다.

 

문자열

camel.rest.api-host

API 설명서에 특정 호스트 이름(예: swagger)을 사용하려면 생성된 호스트를 이 구성된 호스트 이름으로 덮어쓸 수 있습니다.

 

문자열

camel.rest.api-property

api 설명서(swagger)에 대한 많은 추가 속성을 구성할 수 있습니다. 예를 들어 속성 api.title을 이상적인 제품으로 설정합니다.

 

map

camel.rest.api-vendor-extension

Rest API에서 벤더 확장이 활성화되었는지 여부. 활성화하면 Camel에는 추가 정보(예: 경로 ID, 클래스 이름 등 x로 시작하는 키)로 추가 정보가 포함됩니다. API docs를 가져올 때 모든 타사 API 게이트웨이 및 도구가 vendor-extensions를 지원하는 것은 아닙니다.

false

부울

camel.rest.binding-mode

사용할 바인딩 모드를 설정합니다. 기본값은 OFF입니다.

 

RestBindingMode

camel.rest.client-request-validation

클라이언트 요청의 유효성 검사를 활성화하여 클라이언트의 Content-Type 및 Accept 헤더가 사용/생산 설정의 Rest-DSL 구성에서 지원하는지 여부를 확인합니다. 확인을 위해 이 설정을 사용할 수 있습니다. 유효성 검사 오류의 경우 HTTP 상태 코드 415 또는 406이 반환됩니다. 기본값은 false입니다.

false

부울

camel.rest.component

netty-http, jetty, 서블릿과 같이 REST 전송(consumer)에 사용할 Camel Rest 구성 요소. 명시적으로 구성된 구성 요소가 없는 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestConsumerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.component-property

사용 중인 나머지 구성 요소에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.consumer-property

사용 중인 나머지 소비자에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.context-path

REST 서비스가 사용할 선행 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다. 또는 HTTP 서버를 포함하는 camel-jetty 또는 camel-netty-http와 같은 구성 요소의 경우

 

문자열

camel.rest.cors-headers

사용자 정의 CORS 헤더를 구성할 수 있습니다.

 

map

camel.rest.data-format-property

사용 중인 데이터 형식에 대한 추가 속성 수를 구성할 수 있습니다. 예를 들어 매우 모드에서 json을 출력하려면 속성 pretty 아닌 true로 속성을 설정합니다. 옵션 앞에 있는 속성을 추가하여 JSON 또는 XML과 IN 또는 OUT 중 하나에만 사용할 수 있습니다. 접두사는 json.in. json.out. xml.in. xml.out입니다. 예를 들어 xml.out.mustBeJAXB>-< 값이 있는 키는 나가는 XML 데이터 형식일 뿐입니다. 접두사가 없는 키는 모든 상황에서 공통 키입니다.

 

map

camel.rest.enable-cors

HTTP 응답에서 CORS 헤더를 활성화할지 여부입니다. 기본값은 false입니다.

false

부울

camel.rest.endpoint-property

사용 중인 나머지 엔드포인트에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.host

REST 서비스 노출에 사용할 호스트 이름입니다.

 

문자열

camel.rest.host-name-resolver

호스트 이름이 명시적으로 구성되지 않은 경우 이 확인자는 REST 서비스에서 사용할 호스트 이름을 계산하는 데 사용됩니다.

 

RestHostNameResolver

camel.rest.json-data-format

사용할 특정 json 데이터 형식의 이름입니다. 기본적으로 json-jackson이 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.port

REST 서비스 노출에 사용할 포트 번호입니다. 서블릿 구성 요소를 사용하는 경우 사용 중인 포트 번호가 실제로 적용되는 포트 번호가 적용되지 않습니다. 예를 들어 Apache Tomcat을 사용하는 경우 Apache Karaf를 사용하는 Karaf의 HTTP 서비스는 기본적으로 8181 포트를 사용합니다. 여기에 포트 번호를 설정하는 경우에는 툴링 및 ScanSetting이 포트 번호를 알 수 있으므로 포트 번호를 서블릿 엔진이 사용하는 번호로 설정하는 것이 좋습니다.

 

문자열

camel.rest.producer-api-doc

REST 프로듀서에서 REST uri 및 쿼리 매개변수가 api 문서에 따라 유효한지 확인하는 데 사용할 API 문서(swagger api)의 위치를 설정합니다. 이를 위해서는 classpath에 camel-swagger-java를 추가해야 하며, 누락된 구성으로 인해 Camel이 시작 시 실패하고 오류를 보고할 수 있습니다. 기본적으로 api 문서의 위치는 classpath에서 로드되지만 file: 또는 http:를 사용하여 파일 또는 http URL에서 로드할 리소스를 참조할 수 있습니다.

 

문자열

camel.rest.producer-component

REST 생산자로 사용할 Camel 구성 요소의 이름을 설정합니다.

 

문자열

camel.rest.scheme

REST 서비스를 노출하는 데 사용할 스키마입니다. 일반적으로 http 또는 https가 지원됩니다. 기본값은 http입니다.

 

문자열

camel.rest.skip-binding-on-error-code

사용자 정의 HTTP 오류 코드 헤더가 있는 경우 출력에 바인딩을 건너뛸지 여부입니다. 이렇게 하면 성공 메시지가 그렇지 않으면 json / xml 등에 바인딩되지 않는 사용자 정의 오류 메시지를 빌드할 수 있습니다.

false

부울

camel.rest.use-x-forward-headers

호스트 및 관련 설정에 X-Forward 헤더를 사용할지 여부입니다. 기본값은 true입니다.

true

부울

camel.rest.xml-data-format

사용할 특정 XML 데이터 형식의 이름입니다. 기본적으로 jvncb가 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.api-context-id-pattern

CamelContext id 패턴과 일치하는 CamelContext의 재사용 서비스 API만 허용하도록 CamelContext id 패턴을 설정합니다. 패턴 이름은 현재 CamelContext에서만 일치하는 CamelContext 이름을 나타냅니다. 다른 값의 경우 패턴은 Pattern>-<er#matchPattern(String,String)의 규칙을 사용합니다.

 

문자열

camel.rest.api-context-listing

JVM에서 REST 서비스를 사용하는 사용 가능한 모든 CamelContext의 목록이 활성화되었는지 여부를 더 이상 사용되지 않는 세트입니다. 활성화하면 이러한 컨텍스트를 검색할 수 있는 경우 false인 경우 현재 CamelContext만 사용 중입니다.

false

부울

68장. ExchangeProperty

ExchangeProperty Expression 언어를 사용하면 이름이 지정된 교환 속성의 값을 추출할 수 있습니다.

68.1. 교환 자산 옵션

ExchangeProperty 언어는 아래에 나열된 1가지 옵션을 지원합니다.

이름DefaultJava Type설명

trim

 

부울

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

68.2. 예제

수신자 목록 EIP는 다음과 같은 exchangeProperty를 사용할 수 있습니다.

<route>
  <from uri="direct:a" />
  <recipientList>
    <exchangeProperty>myProperty</exchangeProperty>
  </recipientList>
</route>

이 경우 수신자 목록은 속성 'myProperty'에 포함됩니다.

Java DSL의 동일한 예:

from("direct:a").recipientList(exchangeProperty("myProperty"));

68.3. 종속 항목

ExchangeProperty 언어는 camel-core 의 일부입니다.

68.4. Spring Boot Auto-Configuration

Spring Boot에서 exchangeProperty를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-core-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.cloud.consul.service-discovery.acl-token

Consul과 함께 사용할 ACL 토큰을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.block-seconds

감시 이벤트를 대기하는 시간(기본값: 10초)입니다.

10

정수

camel.cloud.consul.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.consul.service-discovery.connect-timeout-millis

OkHttpClient에 대한 연결 시간 초과입니다.

 

long

camel.cloud.consul.service-discovery.datacenter

데이터 센터입니다.

 

문자열

camel.cloud.consul.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.consul.service-discovery.password

기본 인증에 사용할 암호를 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.consul.service-discovery.read-timeout-millis

OkHttpClient에 대한 시간 초과를 읽습니다.

 

long

camel.cloud.consul.service-discovery.url

Consul 에이전트 URL입니다.

 

문자열

camel.cloud.consul.service-discovery.user-name

기본 인증에 사용할 사용자 이름을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.write-timeout-millis

OkHttpClient에 대한 쓰기 시간 초과입니다.

 

long

camel.cloud.dns.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.dns.service-discovery.domain

도메인 이름;.

 

문자열

camel.cloud.dns.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.dns.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.dns.service-discovery.proto

원하는 서비스의 전송 프로토콜입니다.

_tcp

문자열

camel.cloud.etcd.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.etcd.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.etcd.service-discovery.password

기본 인증에 사용할 암호입니다.

 

문자열

camel.cloud.etcd.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.etcd.service-discovery.service-path

서비스 검색을 찾는 경로입니다.

/services/

문자열

camel.cloud.etcd.service-discovery.timeout

작업을 완료하는 데 사용할 수 있는 최대 시간을 설정하려면 다음을 수행하십시오.

 

long

camel.cloud.etcd.service-discovery.type

검색 유형을 설정하려면 유효한 값이 온 디맨드 및 감시입니다.

On-demand

문자열

camel.cloud.etcd.service-discovery.uris

클라이언트가 연결할 수 있는 URI입니다.

 

문자열

camel.cloud.etcd.service-discovery.user-name

기본 인증에 사용할 사용자 이름입니다.

 

문자열

camel.cloud.kubernetes.service-discovery.api-version

클라이언트 조회를 사용할 때 API 버전을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-data

클라이언트 조회를 사용할 때 인증 기관 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 Certificate Authority 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-data

클라이언트 조회를 사용할 때 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-algo

클라이언트 조회를 사용할 때 RSA와 같은 Client Keystore 알고리즘을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-data

클라이언트 조회를 사용할 때 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-passphrase

클라이언트 조회를 사용할 때 클라이언트 키 저장소 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.kubernetes.service-discovery.dns-domain

DNS 조회에 사용할 DNS 도메인을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.kubernetes.service-discovery.lookup

서비스 조회를 수행하는 방법 가능한 값: client, dns, environment. 클라이언트를 사용하는 경우 클라이언트는 kubernetes 마스터를 쿼리하여 서비스를 제공하는 활성 Pod 목록을 가져온 다음 Pod를 무작위(또는 라운드 로빈)합니다. dns를 사용하면 서비스 이름이 name.namespace.svc.dnsDomain으로 확인됩니다. dnssrv를 사용하는 경우 . …​svc…​의 SRV 쿼리로 서비스 이름이 확인됩니다 .환경을 사용하는 경우 서비스를 조회하는 데 환경 변수를 사용합니다. 기본적으로 환경이 사용됩니다.

환경

문자열

camel.cloud.kubernetes.service-discovery.master-url

클라이언트 조회를 사용할 때 URL을 마스터로 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.namespace

사용할 네임스페이스를 설정합니다. 기본적으로 ENV 변수 KUBERNETES_MASTER의 네임스페이스를 사용합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.oauth-token

클라이언트 조회를 사용할 때 인증을 위해 OAUTH 토큰(사용자 이름/암호 대신)을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.password

클라이언트 조회를 사용할 때 인증 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-name

DNS/DNSSRV 조회에 사용할 포트 이름을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-protocol

DNS/DNSSRV 조회에 사용할 포트 프로토콜을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.kubernetes.service-discovery.trust-certs

클라이언트 조회를 사용할 때 신뢰 인증서 검사를 설정할지 여부를 설정합니다.

false

부울

camel.cloud.kubernetes.service-discovery.username

클라이언트 조회를 사용할 때 인증에 대한 사용자 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.client-name

Ribbon 클라이언트 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.ribbon.load-balancer.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.ribbon.load-balancer.namespace

네임스페이스입니다.

 

문자열

camel.cloud.ribbon.load-balancer.password

암호입니다.

 

문자열

camel.cloud.ribbon.load-balancer.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.ribbon.load-balancer.username

사용자 이름입니다.

 

문자열

camel.hystrix.allow-maximum-size-to-diverge-from-core-size

최대Size 설정을 적용할 수 있습니다. 그런 다음 해당 값은 coreSize보다 크거나 같을 수 있습니다.

false

부울

camel.hystrix.circuit-breaker-enabled

HystrixCircuitBreaker 사용 여부입니다. false인 경우 회로 차단기 논리가 사용되지 않고 모든 요청이 허용됩니다. 이는 circuitBreakerForceECDHEd()와 유사하지만 메트릭을 계속 추적하고 공개/닫어야 하는지 여부를 알고 있기 때문에 회로 교체를 인스턴스화하지 않습니다.

true

부울

camel.hystrix.circuit-breaker-error-threshold-percentage

오류 백분율 임계값(50과 같은 정수)은 회로 차단기가 열려 있고 요청을 거부합니다. 이는 circuitBreakerSleepWindowInMilliseconds에 정의된 기간 동안 트립을 유지합니다. 오류 비율은 HystrixCommandMetrics.getHealthCounts()와 비교됩니다.

50

정수

camel.hystrix.circuit-breaker-force-closed

true인 경우 HystrixCircuitBreaker#allowRequest()는 HystrixCommandMetrics.getHealthCounts()의 오류 백분율에 관계없이 요청을 허용하도록 항상 true를 반환합니다. circuitBreakerForceOpen() 속성이 우선하므로 true로 설정하면 이 속성이 아무 작업도 수행하지 않습니다.

false

부울

camel.hystrix.circuit-breaker-force-open

true인 경우 HystrixCircuitBreaker.allowRequest()는 항상 false를 반환하므로 회로가 열려 있고 모든 요청을 거부합니다. 이 속성은 circuitBreakerForce 10.0.0.1d()보다 우선합니다.

false

부울

camel.hystrix.circuit-breaker-request-volume-threshold

HystrixCircuitBreaker가 이동하기 전에 존재해야 하는 metricsRollingStatisticalWindowInMilliseconds()의 최소 요청 수입니다. 이 숫자 아래에 있는 경우 회로는 오류 백분율에 관계없이 이동하지 않습니다.

20

정수

camel.hystrix.circuit-breaker-sleep-window-in-milliseconds

HystrixCircuitBreaker 트립션이 열린 후 다시 요청을 시도하기 전에 대기해야 하는 시간(밀리초)입니다.

5000

정수

camel.hystrix.configurations

추가 구성 정의를 정의합니다.

 

map

camel.hystrix.core-pool-size

java.util.concurrent.ThreadPoolExecutor#setCorePoolSize(int)에 전달되는 코어 스레드 풀 크기입니다.

10

정수

camel.hystrix.enabled

구성 요소를 활성화합니다.

true

부울

camel.hystrix.execution-isolation-semaphore-max-concurrent-requests

HystrixCommand.run()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 거부됩니다. 실행IsolationStrategy == SEMAPHORE 경우에만 적용됩니다.

20

정수

camel.hystrix.execution-isolation-strategy

을 사용하여 격리 전략 HystrixCommand.run()를 실행합니다. THREAD가 별도의 스레드에서 실행되고 스레드 풀의 스레드 수에 따라 제한되는 동시 요청이 실행됩니다. SEMAPHORE는 호출 스레드와 세마포 수에 의해 제한되는 동시 요청에서 실행됩니다.

THREAD

문자열

camel.hystrix.execution-isolation-thread-interrupt-on-timeout

스레드가 시간 초과될 때 실행 스레드에서 인터럽트를 시도해야 하는지 여부입니다. whether the execution thread should attempt an interrupt (using an interrupt#cancel ) when a thread times out. executionIsolationStrategy() == THREAD 경우에만 적용됩니다.

true

부울

camel.hystrix.execution-timeout-enabled

이 명령에 시간 초과 메커니즘이 활성화되었는지 여부.

true

부울

camel.hystrix.execution-timeout-in-milliseconds

명령이 시간 초과되고 실행을 중지하는 시간(밀리초)입니다. executionIsolationThreadInterruptOnTimeout == true 및 명령이 thread-isolated인 경우 실행 중인 스레드가 중단됩니다. 명령이 세마포 분리 및 HystrixObservableCommand인 경우 해당 명령은 구독 해제됩니다.

1000

정수

camel.hystrix.fallback-enabled

오류가 발생할 때 HystrixCommand.getFallback()을 시도해야 하는지 여부

true

부울

camel.hystrix.fallback-isolation-semaphore-max-concurrent-requests

HystrixCommand.getFallback()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 빠르게 실패하며 폴백 검색을 시도하지 않습니다.

10

정수

camel.hystrix.group-key

사용할 그룹 키를 설정합니다. 기본값은 CamelHystrix입니다.

CamelHystrix

문자열

camel.hystrix.keep-alive-time

ThreadPoolExecutor#setKeepAliveTime(long,TimeUnit)에 전달되는 Keep-alive 시간(분).

1

정수

camel.hystrix.max-queue-size

HystrixConcurrencyStrategy.getBlockingQueue(int)에서 BlockingQueue에 전달되는 최대 대기열 크기는 스레드 풀의 인스턴스화에만 영향을 미칩니다. 이를 위해 queueSizeRejectionThreshold()를 사용합니다.

-1

정수

camel.hystrix.maximum-size

ThreadPoolExecutor#setMaximumPoolSize(int)에 전달되는 최대 스레드 풀 크기입니다. 이는 HystrixCommands를 거부하지 않고 지원할 수 있는 최대 동시성 양입니다. 이 설정은 allowMaximumSizeToDivergeFromCoreSizeSize도 설정하는 경우에만 적용됩니다.

10

정수

camel.hystrix.metrics-health-snapshot-interval-in-milliseconds

성공 및 오류 백분율을 계산하고 HystrixCircuitBreaker.isOpen() 상태에 영향을 미치는 상태 스냅샷 허용 사이에 대기하는 시간(밀리초)입니다. 양이 많은 경우 오류 백분율의 지속적인 계산이 CPU 집약적이 될 수 있으므로 계산된 빈도를 제어합니다.

500

정수

camel.hystrix.metrics-rolling-percentile-bucket-size

롤링 백분율의 각 버킷에 저장된 최대 값 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-percentile-enabled

HystrixCommandMetrics 내에서 HystrixRollingPercentile을 사용하여 백분율 지표를 캡처해야 하는지 여부입니다.

true

부울

camel.hystrix.metrics-rolling-percentile-window-buckets

롤링 백분위기 창이 분할되는 버킷 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

6

정수

camel.hystrix.metrics-rolling-percentile-window-in-milliseconds

백분율로 구성된 창(밀리초)입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10000

정수

camel.hystrix.metrics-rolling-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 HystrixCommandMetrics 내부의 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-statistical-window-in-milliseconds

이 속성은 통계 롤링 창(밀리초)을 설정합니다. 스레드 풀에 대해 메트릭을 유지하는 방법입니다. 이 창은 버킷으로 나뉘어져 해당 증분으로 롤백됩니다.

10000

정수

camel.hystrix.queue-size-rejection-threshold

큐 크기 거부 임계값은 maxQueueSize에 도달하지 않은 경우에도 거부가 발생하는 인위성 최대 크기입니다. BlockingQueue의 maxQueueSize는 동적으로 변경할 수 없으며 거부에 영향을 미치는 큐 크기의 동적으로 변경을 지원하려고 하므로 수행됩니다. 이는 실행을 위한 스레드를 대기열에 추가할 때 HystrixCommand에서 사용됩니다.

5

정수

camel.hystrix.request-log-enabled

HystrixCommand 실행 및 이벤트를 HystrixRequestLog에 기록해야 하는지 여부입니다.

true

부울

camel.hystrix.thread-pool-key

사용할 스레드 풀 키를 설정합니다. 기본적으로는 groupKey가 사용하도록 구성된 것과 동일한 값을 사용합니다.

CamelHystrix

문자열

camel.hystrix.thread-pool-rolling-number-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.thread-pool-rolling-number-statistical-window-in-milliseconds

통계 롤링 창(밀리초)입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10000

정수

camel.language.constant.enabled

상수 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.constant.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.csimple.enabled

csimple 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.csimple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.exchangeproperty.enabled

exchangeProperty 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.exchangeproperty.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.file.enabled

파일 언어 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.file.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.header.enabled

헤더 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.header.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.ref.enabled

ref 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.ref.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.simple.enabled

간단한 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.simple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.tokenize.enabled

토큰화 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.tokenize.group-delimiter

그룹화할 때 사용할 구분 기호를 설정합니다. 이 값을 설정하지 않으면 토큰은 구분 기호로 사용됩니다.

 

문자열

camel.language.tokenize.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.resilience4j.automatic-transition-from-open-to-half-open-enabled

waitDurationInOpenState가 통과되면 OPEN에서 HALF_OPEN 상태로 자동 전환할 수 있습니다.

false

부울

camel.resilience4j.circuit-breaker-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreaker 인스턴스를 나타냅니다. 이 기능을 사용할 때 다른 회로 차단기 옵션을 사용하지 않습니다.

 

문자열

camel.resilience4j.config-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreakerConfig 인스턴스를 나타냅니다.

 

문자열

camel.resilience4j.configurations

추가 구성 정의를 정의합니다.

 

map

camel.resilience4j.enabled

구성 요소를 활성화합니다.

true

부울

camel.resilience4j.failure-rate-threshold

실패 비율 임계값을 백분율로 구성합니다. 실패 비율이 임계값보다 크거나 같으면 CircuitBreaker가 열기로 전환되고 쇼트 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 50입니다.

 

float

camel.resilience4j.minimum-number-of-calls

CircuitBreaker가 오류 속도를 계산할 수 있기 전에 필요한 최소 호출 수(라이딩 창 기간당)를 구성합니다. 예를 들어, minimumNumberOf>-<s가 10인 경우 실패 비율을 계산하기 전에 최소 10번의 호출을 기록해야 합니다. 9 개의 호출 만 기록 된 경우 CircuitBreaker는 모든 9 번 호출이 실패하더라도 열기 위해 전환되지 않습니다. 기본 minimumNumberOf>-<s는 100입니다.

100

정수

camel.resilience4j.permitted-number-of-calls-in-half-open-state

CircuitBreaker가 절반 열려 있을 때 허용되는 호출 수를 설정합니다. 크기는 0보다 커야 합니다. 기본값은 10입니다.

10

정수

camel.resilience4j.sliding-window-size

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 크기를 설정합니다. slidingWindowSize는 슬라이딩 창 크기를 구성합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 슬라이딩 WindowSize는 0보다 커야 합니다. minimumNumberOf>-<s는 0보다 커야 합니다. slidingWindowType이 COUNT_BASED인 경우 minimumNumberOf>-<s는 slidingWindowSize . 슬라이딩 WindowType이 TIME_BASED인 경우 원하는 항목을 선택할 수 있습니다. 기본 slidingWindowSize는 100입니다.

100

정수

camel.resilience4j.sliding-window-type

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 유형을 설정합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 기본 sliding WindowType은 COUNT_BASED입니다.

COUNT_BASED

문자열

camel.resilience4j.slow-call-duration-threshold

호출이 느리고 느린 호출 비율을 늘리는 기간 임계값(초)을 구성합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.slow-call-rate-threshold

임계값을 백분율로 구성합니다. CircuitBreaker는 호출 기간이 slowECDHEDurationThreshold Duration보다 클 때 호출 속도가 느린 것으로 간주합니다. 느린 호출의 백분율이 임계값 이상인 경우 CircuitBreaker는 열기로 전환되고 단기 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 100 백분율로, 기록된 모든 호출이 slowECDHEDurationThreshold보다 느릴 수 있음을 의미합니다.

 

float

camel.resilience4j.wait-duration-in-open-state

대기 기간(초)을 설정합니다. CircuitBreaker는 반으로 전환되기 전에 열려 있어야 하는 시간을 지정합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.writable-stack-trace-enabled

쓰기 가능한 스택 추적을 활성화합니다. false로 설정하면 Exception.getStackTrace에서 길이 배열을 0개 반환합니다. 예외의 원인이 이미 알려진 대로 회로 차단기가 열려 있을 때 로그 스팸을 줄이는 데 사용할 수 있습니다(회로 차단기는 짧은 호출임).

true

부울

camel.rest.api-component

REST API(예: swagger)로 사용할 Camel 구성 요소의 이름(예: swagger)이 명시적으로 구성되어 있지 않은 경우, REST API 문서를 서비스하고 생성하는 Camel 구성 요소가 있는지 또는 org.apache.camel.camel.spi.RestApiProcessorFactory가 레지스트리에 등록되어 있는 경우 Camel을 조회합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.api-context-path

REST API 서비스가 사용할 선행 API 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다.

 

문자열

camel.rest.api-context-route-id

REST API를 제공하는 경로에 사용할 경로 ID를 설정합니다. 이 경로는 기본적으로 자동 할당된 경로 ID를 사용합니다.

 

문자열

camel.rest.api-host

API 설명서에 특정 호스트 이름(예: swagger)을 사용하려면 생성된 호스트를 이 구성된 호스트 이름으로 덮어쓸 수 있습니다.

 

문자열

camel.rest.api-property

api 설명서(swagger)에 대한 많은 추가 속성을 구성할 수 있습니다. 예를 들어 속성 api.title을 이상적인 제품으로 설정합니다.

 

map

camel.rest.api-vendor-extension

Rest API에서 벤더 확장이 활성화되었는지 여부. 활성화하면 Camel에는 추가 정보(예: 경로 ID, 클래스 이름 등 x로 시작하는 키)로 추가 정보가 포함됩니다. API docs를 가져올 때 모든 타사 API 게이트웨이 및 도구가 vendor-extensions를 지원하는 것은 아닙니다.

false

부울

camel.rest.binding-mode

사용할 바인딩 모드를 설정합니다. 기본값은 OFF입니다.

 

RestBindingMode

camel.rest.client-request-validation

클라이언트 요청의 유효성 검사를 활성화하여 클라이언트의 Content-Type 및 Accept 헤더가 사용/생산 설정의 Rest-DSL 구성에서 지원하는지 여부를 확인합니다. 확인을 위해 이 설정을 사용할 수 있습니다. 유효성 검사 오류의 경우 HTTP 상태 코드 415 또는 406이 반환됩니다. 기본값은 false입니다.

false

부울

camel.rest.component

netty-http, jetty, 서블릿과 같이 REST 전송(consumer)에 사용할 Camel Rest 구성 요소. 명시적으로 구성된 구성 요소가 없는 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestConsumerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.component-property

사용 중인 나머지 구성 요소에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.consumer-property

사용 중인 나머지 소비자에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.context-path

REST 서비스가 사용할 선행 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다. 또는 HTTP 서버를 포함하는 camel-jetty 또는 camel-netty-http와 같은 구성 요소의 경우

 

문자열

camel.rest.cors-headers

사용자 정의 CORS 헤더를 구성할 수 있습니다.

 

map

camel.rest.data-format-property

사용 중인 데이터 형식에 대한 추가 속성 수를 구성할 수 있습니다. 예를 들어 매우 모드에서 json을 출력하려면 속성 pretty 아닌 true로 속성을 설정합니다. 옵션 앞에 있는 속성을 추가하여 JSON 또는 XML과 IN 또는 OUT 중 하나에만 사용할 수 있습니다. 접두사는 json.in. json.out. xml.in. xml.out입니다. 예를 들어 xml.out.mustBeJAXB>-< 값이 있는 키는 나가는 XML 데이터 형식일 뿐입니다. 접두사가 없는 키는 모든 상황에서 공통 키입니다.

 

map

camel.rest.enable-cors

HTTP 응답에서 CORS 헤더를 활성화할지 여부입니다. 기본값은 false입니다.

false

부울

camel.rest.endpoint-property

사용 중인 나머지 엔드포인트에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.host

REST 서비스 노출에 사용할 호스트 이름입니다.

 

문자열

camel.rest.host-name-resolver

호스트 이름이 명시적으로 구성되지 않은 경우 이 확인자는 REST 서비스에서 사용할 호스트 이름을 계산하는 데 사용됩니다.

 

RestHostNameResolver

camel.rest.json-data-format

사용할 특정 json 데이터 형식의 이름입니다. 기본적으로 json-jackson이 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.port

REST 서비스 노출에 사용할 포트 번호입니다. 서블릿 구성 요소를 사용하는 경우 사용 중인 포트 번호가 실제로 적용되는 포트 번호가 적용되지 않습니다. 예를 들어 Apache Tomcat을 사용하는 경우 Apache Karaf를 사용하는 Karaf의 HTTP 서비스는 기본적으로 8181 포트를 사용합니다. 여기에 포트 번호를 설정하는 경우에는 툴링 및 ScanSetting이 포트 번호를 알 수 있으므로 포트 번호를 서블릿 엔진이 사용하는 번호로 설정하는 것이 좋습니다.

 

문자열

camel.rest.producer-api-doc

REST 프로듀서에서 REST uri 및 쿼리 매개변수가 api 문서에 따라 유효한지 확인하는 데 사용할 API 문서(swagger api)의 위치를 설정합니다. 이를 위해서는 classpath에 camel-swagger-java를 추가해야 하며, 누락된 구성으로 인해 Camel이 시작 시 실패하고 오류를 보고할 수 있습니다. 기본적으로 api 문서의 위치는 classpath에서 로드되지만 file: 또는 http:를 사용하여 파일 또는 http URL에서 로드할 리소스를 참조할 수 있습니다.

 

문자열

camel.rest.producer-component

REST 생산자로 사용할 Camel 구성 요소의 이름을 설정합니다.

 

문자열

camel.rest.scheme

REST 서비스를 노출하는 데 사용할 스키마입니다. 일반적으로 http 또는 https가 지원됩니다. 기본값은 http입니다.

 

문자열

camel.rest.skip-binding-on-error-code

사용자 정의 HTTP 오류 코드 헤더가 있는 경우 출력에 바인딩을 건너뛸지 여부입니다. 이렇게 하면 성공 메시지가 그렇지 않으면 json / xml 등에 바인딩되지 않는 사용자 정의 오류 메시지를 빌드할 수 있습니다.

false

부울

camel.rest.use-x-forward-headers

호스트 및 관련 설정에 X-Forward 헤더를 사용할지 여부입니다. 기본값은 true입니다.

true

부울

camel.rest.xml-data-format

사용할 특정 XML 데이터 형식의 이름입니다. 기본적으로 jvncb가 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.api-context-id-pattern

CamelContext id 패턴과 일치하는 CamelContext의 재사용 서비스 API만 허용하도록 CamelContext id 패턴을 설정합니다. 패턴 이름은 현재 CamelContext에서만 일치하는 CamelContext 이름을 나타냅니다. 다른 값의 경우 패턴은 Pattern>-<er#matchPattern(String,String)의 규칙을 사용합니다.

 

문자열

camel.rest.api-context-listing

JVM에서 REST 서비스를 사용하는 사용 가능한 모든 CamelContext의 목록이 활성화되었는지 여부를 더 이상 사용되지 않는 세트입니다. 활성화하면 이러한 컨텍스트를 검색할 수 있는 경우 false인 경우 현재 CamelContext만 사용 중입니다.

false

부울

69장. 파일

File Expression Language는 언어의 확장이며 파일 관련 기능을 추가합니다. 이러한 기능은 파일 경로 및 이름으로 작업하는 일반적인 사용 사례와 관련이 있습니다. 용도는 표현식과 함께 사용할 수 있도록 하는 것입니다.

소비자 및 생산자 모두에 대한 동적 파일 패턴을 설정하는 구성 요소입니다.

참고

파일 언어는 언어와 병합되므로 간단한 언어 내에서 직접 모든 파일 구문을 사용할 수 있습니다.

69.1. 파일 언어 옵션

파일 언어는 아래에 나열된 두 가지 옵션을 지원합니다.

이름DefaultJava Type설명

resultType

 

문자열

결과 형식의 클래스 이름을 설정합니다(출력에서 유형).

trim

 

부울

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

69.2. 구문

이 언어는 언어의 확장 이므로 구문도 적용됩니다. 아래의 표에는 추가 파일 관련 함수만 나열됩니다.

모든 파일 토큰은 java.io.File 오브젝트의 메서드와 동일한 표현식 이름을 사용합니다. 예를 들어 file:absolutejava.io.File.getAbsolute() 메서드를 나타냅니다. 현재 교환에서 일부 표현식을 지원하는 것은 아닙니다. 예를 들어 구성 요소는 일부 옵션을 지원하는 반면 File 구성 요소는 모든 옵션을 지원합니다.

expression유형파일 소비자File ProducerFTP ConsumerFTP Producer설명

file:name

문자열

제공됨

제공되지 않음

제공됨

제공되지 않음

파일 이름을 나타냅니다(시작 디렉토리, 아래 참고 사항 참조)

file:name.ext

문자열

제공됨

제공되지 않음

제공됨

제공되지 않음

파일 확장자만 참조

file:name.ext.single

문자열

제공됨

제공되지 않음

제공됨

제공되지 않음

파일 확장자를 나타냅니다. 파일 확장자에 점이 여러 개 있는 경우 이 표현식 스트라이핑은 마지막 부분만 반환합니다.

file:name.noext

문자열

제공됨

제공되지 않음

제공됨

제공되지 않음

확장자가 없는 파일 이름 참조(시작 디렉토리, 아래 참고 사항 참조)

file:name.noext.single

문자열

제공됨

제공되지 않음

제공됨

제공되지 않음

확장자가 없는 파일 이름을 나타냅니다(시작 디렉토리, 아래 참고 사항 참조). 파일 확장에 점이 여러 개 있는 경우 이 표현식은 마지막 부분만 제거하고 다른 항목을 유지합니다.

file:onlyname

문자열

제공됨

제공되지 않음

제공됨

제공되지 않음

선행 경로가 없는 파일 이름만 나타냅니다.

file:onlyname.noext

문자열

제공됨

제공되지 않음

제공됨

제공되지 않음

확장자가 없고 선행 경로가 없는 파일 이름만 참조합니다.

file:onlyname.noext.single

문자열

제공됨

제공되지 않음

제공됨

제공되지 않음

확장자가 없고 선행 경로가 없는 파일 이름만 참조합니다. 파일 확장에 점이 여러 개 있는 경우 이 표현식은 마지막 부분만 제거하고 다른 항목을 유지합니다.

파일:ext

문자열

제공됨

제공되지 않음

제공됨

제공되지 않음

파일 확장자만 참조

file:parent

문자열

제공됨

제공되지 않음

제공됨

제공되지 않음

파일 상위 참조

file:path

문자열

제공됨

제공되지 않음

제공됨

제공되지 않음

파일 경로를 나타냅니다.

file:absolute

부울

제공됨

제공되지 않음

제공되지 않음

제공되지 않음

파일이 절대인지 상대인지의 여부를 나타냅니다.Indicates whether the file is considered as absolute or relative.

file:absolute.path

문자열

제공됨

제공되지 않음

제공되지 않음

제공되지 않음

절대 파일 경로를 나타냅니다.

file:length

long

제공됨

제공되지 않음

제공됨

제공되지 않음

Long 형식으로 반환되는 파일 길이를 나타냅니다.Indicates the file length returned as a Long type.

파일:size

long

제공됨

제공되지 않음

제공됨

제공되지 않음

Long 형식으로 반환되는 파일 길이를 나타냅니다.Indicates the file length returned as a Long type.

file:modified

날짜

제공됨

제공되지 않음

제공됨

제공되지 않음

마지막으로 수정한 파일을 날짜 유형으로 반환합니다.

date:_command:pattern_

문자열

제공됨

제공됨

제공됨

제공됨

날짜 형식의 경우 java.text.SimpleDateFormat 패턴을 사용합니다. 이는 언어의 확장 입니다. 추가 명령은 파일의 마지막으로 수정된 타임스탬프의 파일 (원만 해당)입니다. 주의: 언어의 모든 명령도 사용할 수 있습니다.

69.3. 파일 토큰 예

69.3.1. 상대 경로

We have a java.io.File handle for the file hello.txt in the following relative directory: .\fileECDHE\test. 그리고 이 시작 디렉터리를 사용하도록 엔드 포인트를 구성합니다. 파일 토큰은 다음과 같이 반환됩니다.

expression반환

file:name

test\hello.txt

file:name.ext

txt

file:name.noext

test\hello

file:onlyname

hello.txt

file:onlyname.noext

hello

파일:ext

txt

file:parent

filelanguage\test

file:path

filelanguage\test\hello.txt

file:absolute

false

file:absolute.path

\workspace\camel\camel-core\target\filelanguage\test\hello.txt

69.3.2. 절대 경로

다음과 같은 절대 디렉토리에 hello.txt 파일에 대한 java.io.File 처리가 있습니다. \workspace\camel\camel-core\target\fileECDHE\test. 또한 절대 시작 디렉토리 \workspace\camel\camel-core\target\fileECDHE를 사용하도록 끝점을 구성합니다. 파일 토큰은 다음과 같이 반환됩니다.

expression반환

file:name

test\hello.txt

file:name.ext

txt

file:name.noext

test\hello

file:onlyname

hello.txt

file:onlyname.noext

hello

파일:ext

txt

file:parent

\workspace\camel\camel-core\target\filelanguage\test

file:path

\workspace\camel\camel-core\target\filelanguage\test\hello.txt

file:absolute

true

file:absolute.path

\workspace\camel\camel-core\target\filelanguage\test\hello.txt

69.4. 샘플

myfile.txt 와 같은 고정 파일 이름을 입력할 수 있습니다.

fileName="myfile.txt"

파일 소비자를 사용하여 파일을 읽고 읽기 파일을 이동하여 현재 날짜가 하위 폴더인 폴더를 백업하려는 경우를 살펴보겠습니다. 이 작업은 다음과 같은 표현식을 사용하여 수행할 수 있습니다.

fileName="backup/${date:now:yyyyMMdd}/${file:name.noext}.bak"

상대 폴더 이름도 지원되므로 백업 폴더가 형제 폴더여야 하고 다음과 같이 추가할 있습니다.

fileName="../backup/${date:now:yyyyMMdd}/${file:name.noext}.bak"

이 언어의 확장 기능이므로 이 언어의 모든 기능에 액세스할 수 있으므로 이 사용 사례에서 동적 표현식에서 in.header.type을 매개변수로 사용하려는 것입니다.

fileName="../backup/${date:now:yyyyMMdd}/type-${in.header.type}/backup-of-${file:name.noext}.bak"

표현식에 사용하려는 사용자 지정 날짜가 있는 경우 Camel은 메시지 헤더에서 날짜 검색을 지원합니다.

fileName="orders/order-${in.header.customerId}-${date:in.header.orderDate:yyyyMMdd}.xml"

또한 빈 표현식을 사용하여 사용할 일부 String 출력(또는 String으로 변환 가능)을 생성하는 CloudEvent 클래스를 호출할 수도 있습니다.

fileName="uniquefile-${bean:myguidgenerator.generateid}.txt"

물론 이 모든 것을 하나의 결합된 표현에서 및 언어를 사용할 수 있는 하나의 표현식으로 결합할 수 있습니다. 이는 일반적인 파일 경로 패턴에 대해 매우 강력합니다.

69.5. 종속 항목

파일 언어는 camel-core 의 일부입니다.

69.6. Spring Boot Auto-Configuration

Spring Boot로 파일을 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-core-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.cloud.consul.service-discovery.acl-token

Consul과 함께 사용할 ACL 토큰을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.block-seconds

감시 이벤트를 대기하는 시간(기본값: 10초)입니다.

10

정수

camel.cloud.consul.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.consul.service-discovery.connect-timeout-millis

OkHttpClient에 대한 연결 시간 초과입니다.

 

long

camel.cloud.consul.service-discovery.datacenter

데이터 센터입니다.

 

문자열

camel.cloud.consul.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.consul.service-discovery.password

기본 인증에 사용할 암호를 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.consul.service-discovery.read-timeout-millis

OkHttpClient에 대한 시간 초과를 읽습니다.

 

long

camel.cloud.consul.service-discovery.url

Consul 에이전트 URL입니다.

 

문자열

camel.cloud.consul.service-discovery.user-name

기본 인증에 사용할 사용자 이름을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.write-timeout-millis

OkHttpClient에 대한 쓰기 시간 초과입니다.

 

long

camel.cloud.dns.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.dns.service-discovery.domain

도메인 이름;.

 

문자열

camel.cloud.dns.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.dns.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.dns.service-discovery.proto

원하는 서비스의 전송 프로토콜입니다.

_tcp

문자열

camel.cloud.etcd.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.etcd.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.etcd.service-discovery.password

기본 인증에 사용할 암호입니다.

 

문자열

camel.cloud.etcd.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.etcd.service-discovery.service-path

서비스 검색을 찾는 경로입니다.

/services/

문자열

camel.cloud.etcd.service-discovery.timeout

작업을 완료하는 데 사용할 수 있는 최대 시간을 설정하려면 다음을 수행하십시오.

 

long

camel.cloud.etcd.service-discovery.type

검색 유형을 설정하려면 유효한 값이 온 디맨드 및 감시입니다.

On-demand

문자열

camel.cloud.etcd.service-discovery.uris

클라이언트가 연결할 수 있는 URI입니다.

 

문자열

camel.cloud.etcd.service-discovery.user-name

기본 인증에 사용할 사용자 이름입니다.

 

문자열

camel.cloud.kubernetes.service-discovery.api-version

클라이언트 조회를 사용할 때 API 버전을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-data

클라이언트 조회를 사용할 때 인증 기관 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 Certificate Authority 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-data

클라이언트 조회를 사용할 때 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-algo

클라이언트 조회를 사용할 때 RSA와 같은 Client Keystore 알고리즘을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-data

클라이언트 조회를 사용할 때 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-passphrase

클라이언트 조회를 사용할 때 클라이언트 키 저장소 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.kubernetes.service-discovery.dns-domain

DNS 조회에 사용할 DNS 도메인을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.kubernetes.service-discovery.lookup

서비스 조회를 수행하는 방법 가능한 값: client, dns, environment. 클라이언트를 사용하는 경우 클라이언트는 kubernetes 마스터를 쿼리하여 서비스를 제공하는 활성 Pod 목록을 가져온 다음 Pod를 무작위(또는 라운드 로빈)합니다. dns를 사용하면 서비스 이름이 name.namespace.svc.dnsDomain으로 확인됩니다. dnssrv를 사용하는 경우 . …​svc…​의 SRV 쿼리로 서비스 이름이 확인됩니다 .환경을 사용하는 경우 서비스를 조회하는 데 환경 변수를 사용합니다. 기본적으로 환경이 사용됩니다.

환경

문자열

camel.cloud.kubernetes.service-discovery.master-url

클라이언트 조회를 사용할 때 URL을 마스터로 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.namespace

사용할 네임스페이스를 설정합니다. 기본적으로 ENV 변수 KUBERNETES_MASTER의 네임스페이스를 사용합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.oauth-token

클라이언트 조회를 사용할 때 인증을 위해 OAUTH 토큰(사용자 이름/암호 대신)을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.password

클라이언트 조회를 사용할 때 인증 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-name

DNS/DNSSRV 조회에 사용할 포트 이름을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-protocol

DNS/DNSSRV 조회에 사용할 포트 프로토콜을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.kubernetes.service-discovery.trust-certs

클라이언트 조회를 사용할 때 신뢰 인증서 검사를 설정할지 여부를 설정합니다.

false

부울

camel.cloud.kubernetes.service-discovery.username

클라이언트 조회를 사용할 때 인증에 대한 사용자 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.client-name

Ribbon 클라이언트 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.ribbon.load-balancer.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.ribbon.load-balancer.namespace

네임스페이스입니다.

 

문자열

camel.cloud.ribbon.load-balancer.password

암호입니다.

 

문자열

camel.cloud.ribbon.load-balancer.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.ribbon.load-balancer.username

사용자 이름입니다.

 

문자열

camel.hystrix.allow-maximum-size-to-diverge-from-core-size

최대Size 설정을 적용할 수 있습니다. 그런 다음 해당 값은 coreSize보다 크거나 같을 수 있습니다.

false

부울

camel.hystrix.circuit-breaker-enabled

HystrixCircuitBreaker 사용 여부입니다. false인 경우 회로 차단기 논리가 사용되지 않고 모든 요청이 허용됩니다. 이는 circuitBreakerForceECDHEd()와 유사하지만 메트릭을 계속 추적하고 공개/닫어야 하는지 여부를 알고 있기 때문에 회로 교체를 인스턴스화하지 않습니다.

true

부울

camel.hystrix.circuit-breaker-error-threshold-percentage

오류 백분율 임계값(50과 같은 정수)은 회로 차단기가 열려 있고 요청을 거부합니다. 이는 circuitBreakerSleepWindowInMilliseconds에 정의된 기간 동안 트립을 유지합니다. 오류 비율은 HystrixCommandMetrics.getHealthCounts()와 비교됩니다.

50

정수

camel.hystrix.circuit-breaker-force-closed

true인 경우 HystrixCircuitBreaker#allowRequest()는 HystrixCommandMetrics.getHealthCounts()의 오류 백분율에 관계없이 요청을 허용하도록 항상 true를 반환합니다. circuitBreakerForceOpen() 속성이 우선하므로 true로 설정하면 이 속성이 아무 작업도 수행하지 않습니다.

false

부울

camel.hystrix.circuit-breaker-force-open

true인 경우 HystrixCircuitBreaker.allowRequest()는 항상 false를 반환하므로 회로가 열려 있고 모든 요청을 거부합니다. 이 속성은 circuitBreakerForce 10.0.0.1d()보다 우선합니다.

false

부울

camel.hystrix.circuit-breaker-request-volume-threshold

HystrixCircuitBreaker가 이동하기 전에 존재해야 하는 metricsRollingStatisticalWindowInMilliseconds()의 최소 요청 수입니다. 이 숫자 아래에 있는 경우 회로는 오류 백분율에 관계없이 이동하지 않습니다.

20

정수

camel.hystrix.circuit-breaker-sleep-window-in-milliseconds

HystrixCircuitBreaker 트립션이 열린 후 다시 요청을 시도하기 전에 대기해야 하는 시간(밀리초)입니다.

5000

정수

camel.hystrix.configurations

추가 구성 정의를 정의합니다.

 

map

camel.hystrix.core-pool-size

java.util.concurrent.ThreadPoolExecutor#setCorePoolSize(int)에 전달되는 코어 스레드 풀 크기입니다.

10

정수

camel.hystrix.enabled

구성 요소를 활성화합니다.

true

부울

camel.hystrix.execution-isolation-semaphore-max-concurrent-requests

HystrixCommand.run()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 거부됩니다. 실행IsolationStrategy == SEMAPHORE 경우에만 적용됩니다.

20

정수

camel.hystrix.execution-isolation-strategy

을 사용하여 격리 전략 HystrixCommand.run()를 실행합니다. THREAD가 별도의 스레드에서 실행되고 스레드 풀의 스레드 수에 따라 제한되는 동시 요청이 실행됩니다. SEMAPHORE는 호출 스레드와 세마포 수에 의해 제한되는 동시 요청에서 실행됩니다.

THREAD

문자열

camel.hystrix.execution-isolation-thread-interrupt-on-timeout

스레드가 시간 초과될 때 실행 스레드에서 인터럽트를 시도해야 하는지 여부입니다. whether the execution thread should attempt an interrupt (using an interrupt#cancel ) when a thread times out. executionIsolationStrategy() == THREAD 경우에만 적용됩니다.

true

부울

camel.hystrix.execution-timeout-enabled

이 명령에 시간 초과 메커니즘이 활성화되었는지 여부.

true

부울

camel.hystrix.execution-timeout-in-milliseconds

명령이 시간 초과되고 실행을 중지하는 시간(밀리초)입니다. executionIsolationThreadInterruptOnTimeout == true 및 명령이 thread-isolated인 경우 실행 중인 스레드가 중단됩니다. 명령이 세마포 분리 및 HystrixObservableCommand인 경우 해당 명령은 구독 해제됩니다.

1000

정수

camel.hystrix.fallback-enabled

오류가 발생할 때 HystrixCommand.getFallback()을 시도해야 하는지 여부

true

부울

camel.hystrix.fallback-isolation-semaphore-max-concurrent-requests

HystrixCommand.getFallback()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 빠르게 실패하며 폴백 검색을 시도하지 않습니다.

10

정수

camel.hystrix.group-key

사용할 그룹 키를 설정합니다. 기본값은 CamelHystrix입니다.

CamelHystrix

문자열

camel.hystrix.keep-alive-time

ThreadPoolExecutor#setKeepAliveTime(long,TimeUnit)에 전달되는 Keep-alive 시간(분).

1

정수

camel.hystrix.max-queue-size

HystrixConcurrencyStrategy.getBlockingQueue(int)에서 BlockingQueue에 전달되는 최대 대기열 크기는 스레드 풀의 인스턴스화에만 영향을 미칩니다. 이를 위해 queueSizeRejectionThreshold()를 사용합니다.

-1

정수

camel.hystrix.maximum-size

ThreadPoolExecutor#setMaximumPoolSize(int)에 전달되는 최대 스레드 풀 크기입니다. 이는 HystrixCommands를 거부하지 않고 지원할 수 있는 최대 동시성 양입니다. 이 설정은 allowMaximumSizeToDivergeFromCoreSizeSize도 설정하는 경우에만 적용됩니다.

10

정수

camel.hystrix.metrics-health-snapshot-interval-in-milliseconds

성공 및 오류 백분율을 계산하고 HystrixCircuitBreaker.isOpen() 상태에 영향을 미치는 상태 스냅샷 허용 사이에 대기하는 시간(밀리초)입니다. 양이 많은 경우 오류 백분율의 지속적인 계산이 CPU 집약적이 될 수 있으므로 계산된 빈도를 제어합니다.

500

정수

camel.hystrix.metrics-rolling-percentile-bucket-size

롤링 백분율의 각 버킷에 저장된 최대 값 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-percentile-enabled

HystrixCommandMetrics 내에서 HystrixRollingPercentile을 사용하여 백분율 지표를 캡처해야 하는지 여부입니다.

true

부울

camel.hystrix.metrics-rolling-percentile-window-buckets

롤링 백분위기 창이 분할되는 버킷 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

6

정수

camel.hystrix.metrics-rolling-percentile-window-in-milliseconds

백분율로 구성된 창(밀리초)입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10000

정수

camel.hystrix.metrics-rolling-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 HystrixCommandMetrics 내부의 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-statistical-window-in-milliseconds

이 속성은 통계 롤링 창(밀리초)을 설정합니다. 스레드 풀에 대해 메트릭을 유지하는 방법입니다. 이 창은 버킷으로 나뉘어져 해당 증분으로 롤백됩니다.

10000

정수

camel.hystrix.queue-size-rejection-threshold

큐 크기 거부 임계값은 maxQueueSize에 도달하지 않은 경우에도 거부가 발생하는 인위성 최대 크기입니다. BlockingQueue의 maxQueueSize는 동적으로 변경할 수 없으며 거부에 영향을 미치는 큐 크기의 동적으로 변경을 지원하려고 하므로 수행됩니다. 이는 실행을 위한 스레드를 대기열에 추가할 때 HystrixCommand에서 사용됩니다.

5

정수

camel.hystrix.request-log-enabled

HystrixCommand 실행 및 이벤트를 HystrixRequestLog에 기록해야 하는지 여부입니다.

true

부울

camel.hystrix.thread-pool-key

사용할 스레드 풀 키를 설정합니다. 기본적으로는 groupKey가 사용하도록 구성된 것과 동일한 값을 사용합니다.

CamelHystrix

문자열

camel.hystrix.thread-pool-rolling-number-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.thread-pool-rolling-number-statistical-window-in-milliseconds

통계 롤링 창(밀리초)입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10000

정수

camel.language.constant.enabled

상수 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.constant.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.csimple.enabled

csimple 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.csimple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.exchangeproperty.enabled

exchangeProperty 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.exchangeproperty.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.file.enabled

파일 언어 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.file.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.header.enabled

헤더 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.header.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.ref.enabled

ref 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.ref.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.simple.enabled

간단한 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.simple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.tokenize.enabled

토큰화 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.tokenize.group-delimiter

그룹화할 때 사용할 구분 기호를 설정합니다. 이 값을 설정하지 않으면 토큰은 구분 기호로 사용됩니다.

 

문자열

camel.language.tokenize.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.resilience4j.automatic-transition-from-open-to-half-open-enabled

waitDurationInOpenState가 통과되면 OPEN에서 HALF_OPEN 상태로 자동 전환할 수 있습니다.

false

부울

camel.resilience4j.circuit-breaker-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreaker 인스턴스를 나타냅니다. 이 기능을 사용할 때 다른 회로 차단기 옵션을 사용하지 않습니다.

 

문자열

camel.resilience4j.config-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreakerConfig 인스턴스를 나타냅니다.

 

문자열

camel.resilience4j.configurations

추가 구성 정의를 정의합니다.

 

map

camel.resilience4j.enabled

구성 요소를 활성화합니다.

true

부울

camel.resilience4j.failure-rate-threshold

실패 비율 임계값을 백분율로 구성합니다. 실패 비율이 임계값보다 크거나 같으면 CircuitBreaker가 열기로 전환되고 쇼트 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 50입니다.

 

float

camel.resilience4j.minimum-number-of-calls

CircuitBreaker가 오류 속도를 계산할 수 있기 전에 필요한 최소 호출 수(라이딩 창 기간당)를 구성합니다. 예를 들어, minimumNumberOf>-<s가 10인 경우 실패 비율을 계산하기 전에 최소 10번의 호출을 기록해야 합니다. 9 개의 호출 만 기록 된 경우 CircuitBreaker는 모든 9 번 호출이 실패하더라도 열기 위해 전환되지 않습니다. 기본 minimumNumberOf>-<s는 100입니다.

100

정수

camel.resilience4j.permitted-number-of-calls-in-half-open-state

CircuitBreaker가 절반 열려 있을 때 허용되는 호출 수를 설정합니다. 크기는 0보다 커야 합니다. 기본값은 10입니다.

10

정수

camel.resilience4j.sliding-window-size

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 크기를 설정합니다. slidingWindowSize는 슬라이딩 창 크기를 구성합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 슬라이딩 WindowSize는 0보다 커야 합니다. minimumNumberOf>-<s는 0보다 커야 합니다. slidingWindowType이 COUNT_BASED인 경우 minimumNumberOf>-<s는 slidingWindowSize . 슬라이딩 WindowType이 TIME_BASED인 경우 원하는 항목을 선택할 수 있습니다. 기본 slidingWindowSize는 100입니다.

100

정수

camel.resilience4j.sliding-window-type

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 유형을 설정합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 기본 sliding WindowType은 COUNT_BASED입니다.

COUNT_BASED

문자열

camel.resilience4j.slow-call-duration-threshold

호출이 느리고 느린 호출 비율을 늘리는 기간 임계값(초)을 구성합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.slow-call-rate-threshold

임계값을 백분율로 구성합니다. CircuitBreaker는 호출 기간이 slowECDHEDurationThreshold Duration보다 클 때 호출 속도가 느린 것으로 간주합니다. 느린 호출의 백분율이 임계값 이상인 경우 CircuitBreaker는 열기로 전환되고 단기 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 100 백분율로, 기록된 모든 호출이 slowECDHEDurationThreshold보다 느릴 수 있음을 의미합니다.

 

float

camel.resilience4j.wait-duration-in-open-state

대기 기간(초)을 설정합니다. CircuitBreaker는 반으로 전환되기 전에 열려 있어야 하는 시간을 지정합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.writable-stack-trace-enabled

쓰기 가능한 스택 추적을 활성화합니다. false로 설정하면 Exception.getStackTrace에서 길이 배열을 0개 반환합니다. 예외의 원인이 이미 알려진 대로 회로 차단기가 열려 있을 때 로그 스팸을 줄이는 데 사용할 수 있습니다(회로 차단기는 짧은 호출임).

true

부울

camel.rest.api-component

REST API(예: swagger)로 사용할 Camel 구성 요소의 이름(예: swagger)이 명시적으로 구성되어 있지 않은 경우, REST API 문서를 서비스하고 생성하는 Camel 구성 요소가 있는지 또는 org.apache.camel.camel.spi.RestApiProcessorFactory가 레지스트리에 등록되어 있는 경우 Camel을 조회합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.api-context-path

REST API 서비스가 사용할 선행 API 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다.

 

문자열

camel.rest.api-context-route-id

REST API를 제공하는 경로에 사용할 경로 ID를 설정합니다. 이 경로는 기본적으로 자동 할당된 경로 ID를 사용합니다.

 

문자열

camel.rest.api-host

API 설명서에 특정 호스트 이름(예: swagger)을 사용하려면 생성된 호스트를 이 구성된 호스트 이름으로 덮어쓸 수 있습니다.

 

문자열

camel.rest.api-property

api 설명서(swagger)에 대한 많은 추가 속성을 구성할 수 있습니다. 예를 들어 속성 api.title을 이상적인 제품으로 설정합니다.

 

map

camel.rest.api-vendor-extension

Rest API에서 벤더 확장이 활성화되었는지 여부. 활성화하면 Camel에는 추가 정보(예: 경로 ID, 클래스 이름 등 x로 시작하는 키)로 추가 정보가 포함됩니다. API docs를 가져올 때 모든 타사 API 게이트웨이 및 도구가 vendor-extensions를 지원하는 것은 아닙니다.

false

부울

camel.rest.binding-mode

사용할 바인딩 모드를 설정합니다. 기본값은 OFF입니다.

 

RestBindingMode

camel.rest.client-request-validation

클라이언트 요청의 유효성 검사를 활성화하여 클라이언트의 Content-Type 및 Accept 헤더가 사용/생산 설정의 Rest-DSL 구성에서 지원하는지 여부를 확인합니다. 확인을 위해 이 설정을 사용할 수 있습니다. 유효성 검사 오류의 경우 HTTP 상태 코드 415 또는 406이 반환됩니다. 기본값은 false입니다.

false

부울

camel.rest.component

netty-http, jetty, 서블릿과 같이 REST 전송(consumer)에 사용할 Camel Rest 구성 요소. 명시적으로 구성된 구성 요소가 없는 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestConsumerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.component-property

사용 중인 나머지 구성 요소에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.consumer-property

사용 중인 나머지 소비자에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.context-path

REST 서비스가 사용할 선행 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다. 또는 HTTP 서버를 포함하는 camel-jetty 또는 camel-netty-http와 같은 구성 요소의 경우

 

문자열

camel.rest.cors-headers

사용자 정의 CORS 헤더를 구성할 수 있습니다.

 

map

camel.rest.data-format-property

사용 중인 데이터 형식에 대한 추가 속성 수를 구성할 수 있습니다. 예를 들어 매우 모드에서 json을 출력하려면 속성 pretty 아닌 true로 속성을 설정합니다. 옵션 앞에 있는 속성을 추가하여 JSON 또는 XML과 IN 또는 OUT 중 하나에만 사용할 수 있습니다. 접두사는 json.in. json.out. xml.in. xml.out입니다. 예를 들어 xml.out.mustBeJAXB>-< 값이 있는 키는 나가는 XML 데이터 형식일 뿐입니다. 접두사가 없는 키는 모든 상황에서 공통 키입니다.

 

map

camel.rest.enable-cors

HTTP 응답에서 CORS 헤더를 활성화할지 여부입니다. 기본값은 false입니다.

false

부울

camel.rest.endpoint-property

사용 중인 나머지 엔드포인트에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.host

REST 서비스 노출에 사용할 호스트 이름입니다.

 

문자열

camel.rest.host-name-resolver

호스트 이름이 명시적으로 구성되지 않은 경우 이 확인자는 REST 서비스에서 사용할 호스트 이름을 계산하는 데 사용됩니다.

 

RestHostNameResolver

camel.rest.json-data-format

사용할 특정 json 데이터 형식의 이름입니다. 기본적으로 json-jackson이 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.port

REST 서비스 노출에 사용할 포트 번호입니다. 서블릿 구성 요소를 사용하는 경우 사용 중인 포트 번호가 실제로 적용되는 포트 번호가 적용되지 않습니다. 예를 들어 Apache Tomcat을 사용하는 경우 Apache Karaf를 사용하는 Karaf의 HTTP 서비스는 기본적으로 8181 포트를 사용합니다. 여기에 포트 번호를 설정하는 경우에는 툴링 및 ScanSetting이 포트 번호를 알 수 있으므로 포트 번호를 서블릿 엔진이 사용하는 번호로 설정하는 것이 좋습니다.

 

문자열

camel.rest.producer-api-doc

REST 프로듀서에서 REST uri 및 쿼리 매개변수가 api 문서에 따라 유효한지 확인하는 데 사용할 API 문서(swagger api)의 위치를 설정합니다. 이를 위해서는 classpath에 camel-swagger-java를 추가해야 하며, 누락된 구성으로 인해 Camel이 시작 시 실패하고 오류를 보고할 수 있습니다. 기본적으로 api 문서의 위치는 classpath에서 로드되지만 file: 또는 http:를 사용하여 파일 또는 http URL에서 로드할 리소스를 참조할 수 있습니다.

 

문자열

camel.rest.producer-component

REST 생산자로 사용할 Camel 구성 요소의 이름을 설정합니다.

 

문자열

camel.rest.scheme

REST 서비스를 노출하는 데 사용할 스키마입니다. 일반적으로 http 또는 https가 지원됩니다. 기본값은 http입니다.

 

문자열

camel.rest.skip-binding-on-error-code

사용자 정의 HTTP 오류 코드 헤더가 있는 경우 출력에 바인딩을 건너뛸지 여부입니다. 이렇게 하면 성공 메시지가 그렇지 않으면 json / xml 등에 바인딩되지 않는 사용자 정의 오류 메시지를 빌드할 수 있습니다.

false

부울

camel.rest.use-x-forward-headers

호스트 및 관련 설정에 X-Forward 헤더를 사용할지 여부입니다. 기본값은 true입니다.

true

부울

camel.rest.xml-data-format

사용할 특정 XML 데이터 형식의 이름입니다. 기본적으로 jvncb가 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.api-context-id-pattern

CamelContext id 패턴과 일치하는 CamelContext의 재사용 서비스 API만 허용하도록 CamelContext id 패턴을 설정합니다. 패턴 이름은 현재 CamelContext에서만 일치하는 CamelContext 이름을 나타냅니다. 다른 값의 경우 패턴은 Pattern>-<er#matchPattern(String,String)의 규칙을 사용합니다.

 

문자열

camel.rest.api-context-listing

JVM에서 REST 서비스를 사용하는 사용 가능한 모든 CamelContext의 목록이 활성화되었는지 여부를 더 이상 사용되지 않는 세트입니다. 활성화하면 이러한 컨텍스트를 검색할 수 있는 경우 false인 경우 현재 CamelContext만 사용 중입니다.

false

부울

70장. header

헤더 표현식 언어를 사용하면 이름이 지정된 헤더의 값을 추출할 수 있습니다.

70.1. 헤더 옵션

헤더 언어는 아래에 나열된 1 옵션을 지원합니다.

이름DefaultJava Type설명

trim

 

부울

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

70.2. 사용 예

수신자 목록 EIP는 헤더를 사용할 수 있습니다.

<route>
  <from uri="direct:a" />
  <recipientList>
    <header>myHeader</header>
  </recipientList>
</route>

이 경우 수신자 목록이 헤더 'myHeader'에 포함됩니다.

Java DSL의 동일한 예:

from("direct:a").recipientList(header("myHeader"));

70.3. 종속 항목

헤더 언어는 camel-core 의 일부입니다.

70.4. Spring Boot Auto-Configuration

Spring Boot와 함께 헤더를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-core-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.cloud.consul.service-discovery.acl-token

Consul과 함께 사용할 ACL 토큰을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.block-seconds

감시 이벤트를 대기하는 시간(기본값: 10초)입니다.

10

정수

camel.cloud.consul.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.consul.service-discovery.connect-timeout-millis

OkHttpClient에 대한 연결 시간 초과입니다.

 

long

camel.cloud.consul.service-discovery.datacenter

데이터 센터입니다.

 

문자열

camel.cloud.consul.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.consul.service-discovery.password

기본 인증에 사용할 암호를 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.consul.service-discovery.read-timeout-millis

OkHttpClient에 대한 시간 초과를 읽습니다.

 

long

camel.cloud.consul.service-discovery.url

Consul 에이전트 URL입니다.

 

문자열

camel.cloud.consul.service-discovery.user-name

기본 인증에 사용할 사용자 이름을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.write-timeout-millis

OkHttpClient에 대한 쓰기 시간 초과입니다.

 

long

camel.cloud.dns.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.dns.service-discovery.domain

도메인 이름;.

 

문자열

camel.cloud.dns.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.dns.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.dns.service-discovery.proto

원하는 서비스의 전송 프로토콜입니다.

_tcp

문자열

camel.cloud.etcd.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.etcd.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.etcd.service-discovery.password

기본 인증에 사용할 암호입니다.

 

문자열

camel.cloud.etcd.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.etcd.service-discovery.service-path

서비스 검색을 찾는 경로입니다.

/services/

문자열

camel.cloud.etcd.service-discovery.timeout

작업을 완료하는 데 사용할 수 있는 최대 시간을 설정하려면 다음을 수행하십시오.

 

long

camel.cloud.etcd.service-discovery.type

검색 유형을 설정하려면 유효한 값이 온 디맨드 및 감시입니다.

On-demand

문자열

camel.cloud.etcd.service-discovery.uris

클라이언트가 연결할 수 있는 URI입니다.

 

문자열

camel.cloud.etcd.service-discovery.user-name

기본 인증에 사용할 사용자 이름입니다.

 

문자열

camel.cloud.kubernetes.service-discovery.api-version

클라이언트 조회를 사용할 때 API 버전을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-data

클라이언트 조회를 사용할 때 인증 기관 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 Certificate Authority 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-data

클라이언트 조회를 사용할 때 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-algo

클라이언트 조회를 사용할 때 RSA와 같은 Client Keystore 알고리즘을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-data

클라이언트 조회를 사용할 때 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-passphrase

클라이언트 조회를 사용할 때 클라이언트 키 저장소 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.kubernetes.service-discovery.dns-domain

DNS 조회에 사용할 DNS 도메인을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.kubernetes.service-discovery.lookup

서비스 조회를 수행하는 방법 가능한 값: client, dns, environment. 클라이언트를 사용하는 경우 클라이언트는 kubernetes 마스터를 쿼리하여 서비스를 제공하는 활성 Pod 목록을 가져온 다음 Pod를 무작위(또는 라운드 로빈)합니다. dns를 사용하면 서비스 이름이 name.namespace.svc.dnsDomain으로 확인됩니다. dnssrv를 사용하는 경우 . …​svc…​의 SRV 쿼리로 서비스 이름이 확인됩니다 .환경을 사용하는 경우 서비스를 조회하는 데 환경 변수를 사용합니다. 기본적으로 환경이 사용됩니다.

환경

문자열

camel.cloud.kubernetes.service-discovery.master-url

클라이언트 조회를 사용할 때 URL을 마스터로 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.namespace

사용할 네임스페이스를 설정합니다. 기본적으로 ENV 변수 KUBERNETES_MASTER의 네임스페이스를 사용합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.oauth-token

클라이언트 조회를 사용할 때 인증을 위해 OAUTH 토큰(사용자 이름/암호 대신)을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.password

클라이언트 조회를 사용할 때 인증 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-name

DNS/DNSSRV 조회에 사용할 포트 이름을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-protocol

DNS/DNSSRV 조회에 사용할 포트 프로토콜을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.kubernetes.service-discovery.trust-certs

클라이언트 조회를 사용할 때 신뢰 인증서 검사를 설정할지 여부를 설정합니다.

false

부울

camel.cloud.kubernetes.service-discovery.username

클라이언트 조회를 사용할 때 인증에 대한 사용자 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.client-name

Ribbon 클라이언트 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.ribbon.load-balancer.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.ribbon.load-balancer.namespace

네임스페이스입니다.

 

문자열

camel.cloud.ribbon.load-balancer.password

암호입니다.

 

문자열

camel.cloud.ribbon.load-balancer.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.ribbon.load-balancer.username

사용자 이름입니다.

 

문자열

camel.hystrix.allow-maximum-size-to-diverge-from-core-size

최대Size 설정을 적용할 수 있습니다. 그런 다음 해당 값은 coreSize보다 크거나 같을 수 있습니다.

false

부울

camel.hystrix.circuit-breaker-enabled

HystrixCircuitBreaker 사용 여부입니다. false인 경우 회로 차단기 논리가 사용되지 않고 모든 요청이 허용됩니다. 이는 circuitBreakerForceECDHEd()와 유사하지만 메트릭을 계속 추적하고 공개/닫어야 하는지 여부를 알고 있기 때문에 회로 교체를 인스턴스화하지 않습니다.

true

부울

camel.hystrix.circuit-breaker-error-threshold-percentage

오류 백분율 임계값(50과 같은 정수)은 회로 차단기가 열려 있고 요청을 거부합니다. 이는 circuitBreakerSleepWindowInMilliseconds에 정의된 기간 동안 트립을 유지합니다. 오류 비율은 HystrixCommandMetrics.getHealthCounts()와 비교됩니다.

50

정수

camel.hystrix.circuit-breaker-force-closed

true인 경우 HystrixCircuitBreaker#allowRequest()는 HystrixCommandMetrics.getHealthCounts()의 오류 백분율에 관계없이 요청을 허용하도록 항상 true를 반환합니다. circuitBreakerForceOpen() 속성이 우선하므로 true로 설정하면 이 속성이 아무 작업도 수행하지 않습니다.

false

부울

camel.hystrix.circuit-breaker-force-open

true인 경우 HystrixCircuitBreaker.allowRequest()는 항상 false를 반환하므로 회로가 열려 있고 모든 요청을 거부합니다. 이 속성은 circuitBreakerForce 10.0.0.1d()보다 우선합니다.

false

부울

camel.hystrix.circuit-breaker-request-volume-threshold

HystrixCircuitBreaker가 이동하기 전에 존재해야 하는 metricsRollingStatisticalWindowInMilliseconds()의 최소 요청 수입니다. 이 숫자 아래에 있는 경우 회로는 오류 백분율에 관계없이 이동하지 않습니다.

20

정수

camel.hystrix.circuit-breaker-sleep-window-in-milliseconds

HystrixCircuitBreaker 트립션이 열린 후 다시 요청을 시도하기 전에 대기해야 하는 시간(밀리초)입니다.

5000

정수

camel.hystrix.configurations

추가 구성 정의를 정의합니다.

 

map

camel.hystrix.core-pool-size

java.util.concurrent.ThreadPoolExecutor#setCorePoolSize(int)에 전달되는 코어 스레드 풀 크기입니다.

10

정수

camel.hystrix.enabled

구성 요소를 활성화합니다.

true

부울

camel.hystrix.execution-isolation-semaphore-max-concurrent-requests

HystrixCommand.run()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 거부됩니다. 실행IsolationStrategy == SEMAPHORE 경우에만 적용됩니다.

20

정수

camel.hystrix.execution-isolation-strategy

을 사용하여 격리 전략 HystrixCommand.run()를 실행합니다. THREAD가 별도의 스레드에서 실행되고 스레드 풀의 스레드 수에 따라 제한되는 동시 요청이 실행됩니다. SEMAPHORE는 호출 스레드와 세마포 수에 의해 제한되는 동시 요청에서 실행됩니다.

THREAD

문자열

camel.hystrix.execution-isolation-thread-interrupt-on-timeout

스레드가 시간 초과될 때 실행 스레드에서 인터럽트를 시도해야 하는지 여부입니다. whether the execution thread should attempt an interrupt (using an interrupt#cancel ) when a thread times out. executionIsolationStrategy() == THREAD 경우에만 적용됩니다.

true

부울

camel.hystrix.execution-timeout-enabled

이 명령에 시간 초과 메커니즘이 활성화되었는지 여부.

true

부울

camel.hystrix.execution-timeout-in-milliseconds

명령이 시간 초과되고 실행을 중지하는 시간(밀리초)입니다. executionIsolationThreadInterruptOnTimeout == true 및 명령이 thread-isolated인 경우 실행 중인 스레드가 중단됩니다. 명령이 세마포 분리 및 HystrixObservableCommand인 경우 해당 명령은 구독 해제됩니다.

1000

정수

camel.hystrix.fallback-enabled

오류가 발생할 때 HystrixCommand.getFallback()을 시도해야 하는지 여부

true

부울

camel.hystrix.fallback-isolation-semaphore-max-concurrent-requests

HystrixCommand.getFallback()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 빠르게 실패하며 폴백 검색을 시도하지 않습니다.

10

정수

camel.hystrix.group-key

사용할 그룹 키를 설정합니다. 기본값은 CamelHystrix입니다.

CamelHystrix

문자열

camel.hystrix.keep-alive-time

ThreadPoolExecutor#setKeepAliveTime(long,TimeUnit)에 전달되는 Keep-alive 시간(분).

1

정수

camel.hystrix.max-queue-size

HystrixConcurrencyStrategy.getBlockingQueue(int)에서 BlockingQueue에 전달되는 최대 대기열 크기는 스레드 풀의 인스턴스화에만 영향을 미칩니다. 이를 위해 queueSizeRejectionThreshold()를 사용합니다.

-1

정수

camel.hystrix.maximum-size

ThreadPoolExecutor#setMaximumPoolSize(int)에 전달되는 최대 스레드 풀 크기입니다. 이는 HystrixCommands를 거부하지 않고 지원할 수 있는 최대 동시성 양입니다. 이 설정은 allowMaximumSizeToDivergeFromCoreSizeSize도 설정하는 경우에만 적용됩니다.

10

정수

camel.hystrix.metrics-health-snapshot-interval-in-milliseconds

성공 및 오류 백분율을 계산하고 HystrixCircuitBreaker.isOpen() 상태에 영향을 미치는 상태 스냅샷 허용 사이에 대기하는 시간(밀리초)입니다. 양이 많은 경우 오류 백분율의 지속적인 계산이 CPU 집약적이 될 수 있으므로 계산된 빈도를 제어합니다.

500

정수

camel.hystrix.metrics-rolling-percentile-bucket-size

롤링 백분율의 각 버킷에 저장된 최대 값 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-percentile-enabled

HystrixCommandMetrics 내에서 HystrixRollingPercentile을 사용하여 백분율 지표를 캡처해야 하는지 여부입니다.

true

부울

camel.hystrix.metrics-rolling-percentile-window-buckets

롤링 백분위기 창이 분할되는 버킷 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

6

정수

camel.hystrix.metrics-rolling-percentile-window-in-milliseconds

백분율로 구성된 창(밀리초)입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10000

정수

camel.hystrix.metrics-rolling-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 HystrixCommandMetrics 내부의 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-statistical-window-in-milliseconds

이 속성은 통계 롤링 창(밀리초)을 설정합니다. 스레드 풀에 대해 메트릭을 유지하는 방법입니다. 이 창은 버킷으로 나뉘어져 해당 증분으로 롤백됩니다.

10000

정수

camel.hystrix.queue-size-rejection-threshold

큐 크기 거부 임계값은 maxQueueSize에 도달하지 않은 경우에도 거부가 발생하는 인위성 최대 크기입니다. BlockingQueue의 maxQueueSize는 동적으로 변경할 수 없으며 거부에 영향을 미치는 큐 크기의 동적으로 변경을 지원하려고 하므로 수행됩니다. 이는 실행을 위한 스레드를 대기열에 추가할 때 HystrixCommand에서 사용됩니다.

5

정수

camel.hystrix.request-log-enabled

HystrixCommand 실행 및 이벤트를 HystrixRequestLog에 기록해야 하는지 여부입니다.

true

부울

camel.hystrix.thread-pool-key

사용할 스레드 풀 키를 설정합니다. 기본적으로는 groupKey가 사용하도록 구성된 것과 동일한 값을 사용합니다.

CamelHystrix

문자열

camel.hystrix.thread-pool-rolling-number-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.thread-pool-rolling-number-statistical-window-in-milliseconds

통계 롤링 창(밀리초)입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10000

정수

camel.language.constant.enabled

상수 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.constant.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.csimple.enabled

csimple 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.csimple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.exchangeproperty.enabled

exchangeProperty 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.exchangeproperty.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.file.enabled

파일 언어 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.file.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.header.enabled

헤더 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.header.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.ref.enabled

ref 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.ref.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.simple.enabled

간단한 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.simple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.tokenize.enabled

토큰화 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.tokenize.group-delimiter

그룹화할 때 사용할 구분 기호를 설정합니다. 이 값을 설정하지 않으면 토큰은 구분 기호로 사용됩니다.

 

문자열

camel.language.tokenize.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.resilience4j.automatic-transition-from-open-to-half-open-enabled

waitDurationInOpenState가 통과되면 OPEN에서 HALF_OPEN 상태로 자동 전환할 수 있습니다.

false

부울

camel.resilience4j.circuit-breaker-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreaker 인스턴스를 나타냅니다. 이 기능을 사용할 때 다른 회로 차단기 옵션을 사용하지 않습니다.

 

문자열

camel.resilience4j.config-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreakerConfig 인스턴스를 나타냅니다.

 

문자열

camel.resilience4j.configurations

추가 구성 정의를 정의합니다.

 

map

camel.resilience4j.enabled

구성 요소를 활성화합니다.

true

부울

camel.resilience4j.failure-rate-threshold

실패 비율 임계값을 백분율로 구성합니다. 실패 비율이 임계값보다 크거나 같으면 CircuitBreaker가 열기로 전환되고 쇼트 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 50입니다.

 

float

camel.resilience4j.minimum-number-of-calls

CircuitBreaker가 오류 속도를 계산할 수 있기 전에 필요한 최소 호출 수(라이딩 창 기간당)를 구성합니다. 예를 들어, minimumNumberOf>-<s가 10인 경우 실패 비율을 계산하기 전에 최소 10번의 호출을 기록해야 합니다. 9 개의 호출 만 기록 된 경우 CircuitBreaker는 모든 9 번 호출이 실패하더라도 열기 위해 전환되지 않습니다. 기본 minimumNumberOf>-<s는 100입니다.

100

정수

camel.resilience4j.permitted-number-of-calls-in-half-open-state

CircuitBreaker가 절반 열려 있을 때 허용되는 호출 수를 설정합니다. 크기는 0보다 커야 합니다. 기본값은 10입니다.

10

정수

camel.resilience4j.sliding-window-size

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 크기를 설정합니다. slidingWindowSize는 슬라이딩 창 크기를 구성합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 슬라이딩 WindowSize는 0보다 커야 합니다. minimumNumberOf>-<s는 0보다 커야 합니다. slidingWindowType이 COUNT_BASED인 경우 minimumNumberOf>-<s는 slidingWindowSize . 슬라이딩 WindowType이 TIME_BASED인 경우 원하는 항목을 선택할 수 있습니다. 기본 slidingWindowSize는 100입니다.

100

정수

camel.resilience4j.sliding-window-type

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 유형을 설정합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 기본 sliding WindowType은 COUNT_BASED입니다.

COUNT_BASED

문자열

camel.resilience4j.slow-call-duration-threshold

호출이 느리고 느린 호출 비율을 늘리는 기간 임계값(초)을 구성합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.slow-call-rate-threshold

임계값을 백분율로 구성합니다. CircuitBreaker는 호출 기간이 slowECDHEDurationThreshold Duration보다 클 때 호출 속도가 느린 것으로 간주합니다. 느린 호출의 백분율이 임계값 이상인 경우 CircuitBreaker는 열기로 전환되고 단기 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 100 백분율로, 기록된 모든 호출이 slowECDHEDurationThreshold보다 느릴 수 있음을 의미합니다.

 

float

camel.resilience4j.wait-duration-in-open-state

대기 기간(초)을 설정합니다. CircuitBreaker는 반으로 전환되기 전에 열려 있어야 하는 시간을 지정합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.writable-stack-trace-enabled

쓰기 가능한 스택 추적을 활성화합니다. false로 설정하면 Exception.getStackTrace에서 길이 배열을 0개 반환합니다. 예외의 원인이 이미 알려진 대로 회로 차단기가 열려 있을 때 로그 스팸을 줄이는 데 사용할 수 있습니다(회로 차단기는 짧은 호출임).

true

부울

camel.rest.api-component

REST API(예: swagger)로 사용할 Camel 구성 요소의 이름(예: swagger)이 명시적으로 구성되어 있지 않은 경우, REST API 문서를 서비스하고 생성하는 Camel 구성 요소가 있는지 또는 org.apache.camel.camel.spi.RestApiProcessorFactory가 레지스트리에 등록되어 있는 경우 Camel을 조회합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.api-context-path

REST API 서비스가 사용할 선행 API 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다.

 

문자열

camel.rest.api-context-route-id

REST API를 제공하는 경로에 사용할 경로 ID를 설정합니다. 이 경로는 기본적으로 자동 할당된 경로 ID를 사용합니다.

 

문자열

camel.rest.api-host

API 설명서에 특정 호스트 이름(예: swagger)을 사용하려면 생성된 호스트를 이 구성된 호스트 이름으로 덮어쓸 수 있습니다.

 

문자열

camel.rest.api-property

api 설명서(swagger)에 대한 많은 추가 속성을 구성할 수 있습니다. 예를 들어 속성 api.title을 이상적인 제품으로 설정합니다.

 

map

camel.rest.api-vendor-extension

Rest API에서 벤더 확장이 활성화되었는지 여부. 활성화하면 Camel에는 추가 정보(예: 경로 ID, 클래스 이름 등 x로 시작하는 키)로 추가 정보가 포함됩니다. API docs를 가져올 때 모든 타사 API 게이트웨이 및 도구가 vendor-extensions를 지원하는 것은 아닙니다.

false

부울

camel.rest.binding-mode

사용할 바인딩 모드를 설정합니다. 기본값은 OFF입니다.

 

RestBindingMode

camel.rest.client-request-validation

클라이언트 요청의 유효성 검사를 활성화하여 클라이언트의 Content-Type 및 Accept 헤더가 사용/생산 설정의 Rest-DSL 구성에서 지원하는지 여부를 확인합니다. 확인을 위해 이 설정을 사용할 수 있습니다. 유효성 검사 오류의 경우 HTTP 상태 코드 415 또는 406이 반환됩니다. 기본값은 false입니다.

false

부울

camel.rest.component

netty-http, jetty, 서블릿과 같이 REST 전송(consumer)에 사용할 Camel Rest 구성 요소. 명시적으로 구성된 구성 요소가 없는 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestConsumerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.component-property

사용 중인 나머지 구성 요소에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.consumer-property

사용 중인 나머지 소비자에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.context-path

REST 서비스가 사용할 선행 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다. 또는 HTTP 서버를 포함하는 camel-jetty 또는 camel-netty-http와 같은 구성 요소의 경우

 

문자열

camel.rest.cors-headers

사용자 정의 CORS 헤더를 구성할 수 있습니다.

 

map

camel.rest.data-format-property

사용 중인 데이터 형식에 대한 추가 속성 수를 구성할 수 있습니다. 예를 들어 매우 모드에서 json을 출력하려면 속성 pretty 아닌 true로 속성을 설정합니다. 옵션 앞에 있는 속성을 추가하여 JSON 또는 XML과 IN 또는 OUT 중 하나에만 사용할 수 있습니다. 접두사는 json.in. json.out. xml.in. xml.out입니다. 예를 들어 xml.out.mustBeJAXB>-< 값이 있는 키는 나가는 XML 데이터 형식일 뿐입니다. 접두사가 없는 키는 모든 상황에서 공통 키입니다.

 

map

camel.rest.enable-cors

HTTP 응답에서 CORS 헤더를 활성화할지 여부입니다. 기본값은 false입니다.

false

부울

camel.rest.endpoint-property

사용 중인 나머지 엔드포인트에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.host

REST 서비스 노출에 사용할 호스트 이름입니다.

 

문자열

camel.rest.host-name-resolver

호스트 이름이 명시적으로 구성되지 않은 경우 이 확인자는 REST 서비스에서 사용할 호스트 이름을 계산하는 데 사용됩니다.

 

RestHostNameResolver

camel.rest.json-data-format

사용할 특정 json 데이터 형식의 이름입니다. 기본적으로 json-jackson이 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.port

REST 서비스 노출에 사용할 포트 번호입니다. 서블릿 구성 요소를 사용하는 경우 사용 중인 포트 번호가 실제로 적용되는 포트 번호가 적용되지 않습니다. 예를 들어 Apache Tomcat을 사용하는 경우 Apache Karaf를 사용하는 Karaf의 HTTP 서비스는 기본적으로 8181 포트를 사용합니다. 여기에 포트 번호를 설정하는 경우에는 툴링 및 ScanSetting이 포트 번호를 알 수 있으므로 포트 번호를 서블릿 엔진이 사용하는 번호로 설정하는 것이 좋습니다.

 

문자열

camel.rest.producer-api-doc

REST 프로듀서에서 REST uri 및 쿼리 매개변수가 api 문서에 따라 유효한지 확인하는 데 사용할 API 문서(swagger api)의 위치를 설정합니다. 이를 위해서는 classpath에 camel-swagger-java를 추가해야 하며, 누락된 구성으로 인해 Camel이 시작 시 실패하고 오류를 보고할 수 있습니다. 기본적으로 api 문서의 위치는 classpath에서 로드되지만 file: 또는 http:를 사용하여 파일 또는 http URL에서 로드할 리소스를 참조할 수 있습니다.

 

문자열

camel.rest.producer-component

REST 생산자로 사용할 Camel 구성 요소의 이름을 설정합니다.

 

문자열

camel.rest.scheme

REST 서비스를 노출하는 데 사용할 스키마입니다. 일반적으로 http 또는 https가 지원됩니다. 기본값은 http입니다.

 

문자열

camel.rest.skip-binding-on-error-code

사용자 정의 HTTP 오류 코드 헤더가 있는 경우 출력에 바인딩을 건너뛸지 여부입니다. 이렇게 하면 성공 메시지가 그렇지 않으면 json / xml 등에 바인딩되지 않는 사용자 정의 오류 메시지를 빌드할 수 있습니다.

false

부울

camel.rest.use-x-forward-headers

호스트 및 관련 설정에 X-Forward 헤더를 사용할지 여부입니다. 기본값은 true입니다.

true

부울

camel.rest.xml-data-format

사용할 특정 XML 데이터 형식의 이름입니다. 기본적으로 jvncb가 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.api-context-id-pattern

CamelContext id 패턴과 일치하는 CamelContext의 재사용 서비스 API만 허용하도록 CamelContext id 패턴을 설정합니다. 패턴 이름은 현재 CamelContext에서만 일치하는 CamelContext 이름을 나타냅니다. 다른 값의 경우 패턴은 Pattern>-<er#matchPattern(String,String)의 규칙을 사용합니다.

 

문자열

camel.rest.api-context-listing

JVM에서 REST 서비스를 사용하는 사용 가능한 모든 CamelContext의 목록이 활성화되었는지 여부를 더 이상 사용되지 않는 세트입니다. 활성화하면 이러한 컨텍스트를 검색할 수 있는 경우 false인 경우 현재 CamelContext만 사용 중입니다.

false

부울

71장. JSONPath

Camel은 Expression 또는 Predicate 를 사용하여 JSON 메시지에 사용할 수 있도록 JSONPath 를 지원합니다.

71.1. JSONPath 옵션

JSONPath 언어는 아래에 나열된 8가지 옵션을 지원합니다.

이름DefaultJava Type설명

resultType

 

문자열

결과 형식의 클래스 이름을 설정합니다(출력에서 유형).

suppressExceptions

 

부울

PathNotFoundException과 같은 예외를 억제할지 여부입니다.

allowSimple

 

부울

JSONPath 표현식에서 인라인 간단한 예외를 허용할지 여부입니다.

allowEasyPredicate

 

부울

쉬운 서술자 구문 분석기를 사용하여 서술자를 사전 구문 분석할 수 있는지 여부입니다.

writeAsString

 

부울

각 행/요소의 출력을 Map/POJO 값 대신 JSON String 값으로 작성할지 여부입니다.

headerName

 

문자열

메시지 본문 대신 입력으로 사용할 헤더 이름입니다.

옵션

 

Enum

JSONPath에서 추가 옵션을 구성하려면 다음을 수행합니다. 여러 값을 쉼표로 구분할 수 있습니다.

CloudEvent 값:

  • DEFAULT_PATH_LEAF_TO_NULL
  • ALWAYS_RETURN_LIST
  • AS_PATH_LIST
  • SUPPRESS_EXCEPTIONS
  • REQUIRE_PROPERTIES

trim

 

부울

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

71.2. 예

예를 들어 콘텐츠 기반 라우터 EIP 와 함께 Predicate 에서 JSONPath를 사용할 수 있습니다.

from("queue:books.new")
  .choice()
    .when().jsonpath("$.store.book[?(@.price < 10)]")
      .to("jms:queue:book.cheap")
    .when().jsonpath("$.store.book[?(@.price < 30)]")
      .to("jms:queue:book.average")
    .otherwise()
      .to("jms:queue:book.expensive");

XML DSL의 경우:

<route>
  <from uri="direct:start"/>
  <choice>
    <when>
      <jsonpath>$.store.book[?(@.price &lt; 10)]</jsonpath>
      <to uri="mock:cheap"/>
    </when>
    <when>
      <jsonpath>$.store.book[?(@.price &lt; 30)]</jsonpath>
      <to uri="mock:average"/>
    </when>
    <otherwise>
      <to uri="mock:expensive"/>
    </otherwise>
  </choice>
</route>

71.3. JSONPath Syntax

JSONPath 구문을 사용하는 경우 기본 서술자도 학습하는 데 시간이 걸립니다. 예를 들어,해야 할 저렴한 모든 도서를 찾으려면 다음을 수행하십시오.

$.store.book[?(@.price < 20)]

71.3.1. 쉬운 JSONPath Syntax

그러나 다음과 같이 작성할 수 있다면 어떻게 될까요?

store.book.price < 20

또한 가격 키가 있는 노드를 확인하려는 경우 경로를 생략할 수 있습니다.

price < 20

이를 지원하기 위해 기본 스타일로 서술자를 정의한 경우 easyPredicateParser 를 시작하는 easyPredicateParser가 있습니다. 즉, 서술자는 $ 기호로 시작하지 않아야 하며 하나의 연산자만 포함해야 합니다.

간단한 구문은 다음과 같습니다.

left OP right

올바른 연산자에서 Camel 간단한 언어를 사용할 수 있습니다.

store.book.price < ${header.limit}

자세한 구문 예제는 JSONPath 프로젝트 페이지를 참조하십시오.

71.4. 지원되는 메시지 본문 유형

Camel JSonPath는 다음 유형을 사용하여 메시지 본문을 지원합니다.

유형comment

파일

파일에서 읽기

문자열

일반 문자열

map

java.util.Map 유형으로 메시지 본문

list

java.util.List 유형으로 메시지 본문

POJO

선택 사항: Jackson이 classpath에 있는 경우 camel-jsonpath는 Jackson을 사용하여 메시지 본문을 192.0.2.로 읽고 JSonPath에서 지원하는 java.util.Map 으로 변환할 수 있습니다. 예를 들어 jackson을 포함시키기 위해 camel-jackson 을 종속성으로 추가할 수 있습니다.

InputStream

위의 유형 중 어느 것도 일치하지 않으면 Camel은 메시지 본문을 java.io.InputStream 으로 읽습니다.

메시지 본문이 지원되지 않는 유형인 경우 기본적으로 예외가 발생하지만 예외를 억제하도록 JSonPath를 구성할 수 있습니다(아래 참조).

71.5. 예외 억제

기본적으로 json 페이로드에 구성된 jsonpath 표현식에 따라 유효한 경로가 없는 경우 jsonpath에서 예외가 발생합니다. 일부 사용 사례에서 json 페이로드에 선택적 데이터가 포함된 경우 이를 무시해야 할 수 있습니다. 따라서 다음과 같이 옵션을 suppressExceptionstrue 로 설정하여 무시할 수 있습니다.

from("direct:start")
    .choice()
        // use true to suppress exceptions
        .when().jsonpath("person.middlename", true)
            .to("mock:middle")
        .otherwise()
            .to("mock:other");

XML DSL의 경우:

<route>
  <from uri="direct:start"/>
  <choice>
    <when>
      <jsonpath suppressExceptions="true">person.middlename</jsonpath>
      <to uri="mock:middle"/>
    </when>
    <otherwise>
      <to uri="mock:other"/>
    </otherwise>
  </choice>
</route>

이 옵션은 @JsonPath 주석에서도 사용할 수 있습니다.

71.6. 인라인 간단한 표현식

간단한 구문 ${xxx} 을 사용하여 JSONPath 표현식에서 간단한 언어를 인라인으로 지정할 수 있습니다.

예는 다음과 같습니다.

from("direct:start")
  .choice()
    .when().jsonpath("$.store.book[?(@.price < ${header.cheap})]")
      .to("mock:cheap")
    .when().jsonpath("$.store.book[?(@.price < ${header.average})]")
      .to("mock:average")
    .otherwise()
      .to("mock:expensive");

XML DSL의 경우:

<route>
  <from uri="direct:start"/>
  <choice>
    <when>
      <jsonpath>$.store.book[?(@.price &lt; ${header.cheap})]</jsonpath>
      <to uri="mock:cheap"/>
    </when>
    <when>
      <jsonpath>$.store.book[?(@.price &lt; ${header.average})]</jsonpath>
      <to uri="mock:average"/>
    </when>
    <otherwise>
      <to uri="mock:expensive"/>
    </otherwise>
  </choice>
</route>

다음과 같이 allowSimplefalse 로 설정하여 인라인 단순 표현식에 대한 지원을 해제할 수 있습니다.

.when().jsonpath("$.store.book[?(@.price < 10)]", false, false)

XML DSL의 경우:

<jsonpath allowSimple="false">$.store.book[?(@.price &lt; 10)]</jsonpath>

71.7. JSONPath 주입

CloudEvent Integration을 사용하여 빈 에서 메서드를 호출하고 JSONPath( @JsonPath 주석을 통해) 다양한 언어를 사용하여 메시지에서 값을 추출하고 메서드 매개변수에 바인딩할 수 있습니다.

public class Foo {

    @Consume("activemq:queue:books.new")
    public void doSomething(@JsonPath("$.store.book[*].author") String author, @Body String json) {
      // process the inbound message here
    }
}

71.8. 인코딩 탐지

JSON 문서의 인코딩은 문서가 유니코드(UTF-8, UTF-16LE, UTF-16BE, UTF-32LE, UTF-32LE, UTF-32BE )로 인코딩되는 경우 RFC-4627에 지정된 대로 자동으로 감지됩니다. 인코딩이 유니코드가 아닌 인코딩인 경우 문서를 JSONPath에 String 형식으로 입력해야 하거나 JsonpathConstants.HEADER_JSON_ENCODING 에서 상수로 정의된 CamelJsonPathJsonEncoding 헤더에서 인코딩을 지정할 수 있습니다.

71.9. JSON 데이터를 JSON으로 하위 행으로 분할

JSONPath를 사용하여 다음과 같은 JSON 문서를 분할할 수 있습니다.

from("direct:start")
    .split().jsonpath("$.store.book[*]")
    .to("log:book");

그러면 각 도서가 기록되지만 메시지 본문은 Map 인스턴스입니다. 대신 다음과 같이 writeAsString 옵션을 사용하여 수행할 수 있는 일반 String JSON 값으로 출력할 수 있습니다.

from("direct:start")
    .split().jsonpathWriteAsString("$.store.book[*]")
    .to("log:book");

그런 다음 각 도서는 문자열 JSON 값으로 기록됩니다.

71.10. 헤더를 입력으로 사용

기본적으로 JSONPath는 메시지 본문을 입력 소스로 사용합니다. 그러나 headerName 옵션을 지정하여 헤더를 입력으로 사용할 수도 있습니다.

예를 들어, 도서라는 헤더에 저장된 JSON 문서의 도서 수를 계산하려면 다음을 수행할 수 있습니다.

from("direct:start")
    .setHeader("numberOfBooks")
        .jsonpath("$..store.book.length()", false, int.class, "books")
    .to("mock:result");

위의 jsonpath 표현식에서는 헤더 이름을 도서 로 지정하고, 결과가 int.class 에 의해 정수로 변환되기를 바랐습니다.

XML DSL의 동일한 예는 다음과 같습니다.

<route>
  <from uri="direct:start"/>
  <setHeader name="numberOfBooks">
    <jsonpath headerName="books" resultType="int">$..store.book.length()</jsonpath>
  </setHeader>
  <to uri="mock:result"/>
</route>

71.11. Spring Boot Auto-Configuration

Spring Boot와 함께 jsonpath를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-jsonpath-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.language.jsonpath.allow-easy-predicate

쉬운 서술자 구문 분석기를 사용하여 서술자를 사전 구문 분석할 수 있는지 여부입니다.

true

부울

camel.language.jsonpath.allow-simple

JSONPath 표현식에서 인라인 간단한 예외를 허용할지 여부입니다.

true

부울

camel.language.jsonpath.enabled

jsonpath 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.jsonpath.header-name

메시지 본문 대신 입력으로 사용할 헤더 이름입니다.

 

문자열

camel.language.jsonpath.option

JSONPath에서 추가 옵션을 구성하려면 다음을 수행합니다. 여러 값을 쉼표로 구분할 수 있습니다.

 

문자열

camel.language.jsonpath.suppress-exceptions

PathNotFoundException과 같은 예외를 억제할지 여부입니다.

false

부울

camel.language.jsonpath.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.jsonpath.write-as-string

각 행/요소의 출력을 Map/POJO 값 대신 JSON String 값으로 작성할지 여부입니다.

false

부울

72장. Ref

Ref Expression Language는 실제로 사용자 지정 표현식을 조회하거나 레지스트리에서 Predicate 하는 방법입니다.

이는 XML DSL에서 특히 사용할 수 있습니다.

72.1. ref 언어 옵션

Ref 언어는 아래에 나열된 1가지 옵션을 지원합니다.

이름DefaultJava Type설명

trim

 

부울

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

72.2. 사용 예

XML DSL의 Splitter EIP는 다음과 같이 < ref >를 사용하여 사용자 지정 표현식을 사용할 수 있습니다.

<bean id="myExpression" class="com.mycompany.MyCustomExpression"/>

<route>
  <from uri="seda:a"/>
  <split>
    <ref>myExpression</ref>
    <to uri="mock:b"/>
  </split>
</route>

이 경우 seda:a 끝점에서 발생하는 메시지는 레지스트리에 my Expression 이 있는 사용자 지정 표현식을 사용하여 분할됩니다.

Java DSL을 사용하는 것과 동일한 예:

from("seda:a").split().ref("myExpression").to("seda:b");

72.3. 종속 항목

Ref 언어는 camel-core 의 일부입니다.

72.4. Spring Boot Auto-Configuration

Spring Boot와 함께 ref를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-core-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.cloud.consul.service-discovery.acl-token

Consul과 함께 사용할 ACL 토큰을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.block-seconds

감시 이벤트를 대기하는 시간(기본값: 10초)입니다.

10

정수

camel.cloud.consul.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.consul.service-discovery.connect-timeout-millis

OkHttpClient에 대한 연결 시간 초과입니다.

 

long

camel.cloud.consul.service-discovery.datacenter

데이터 센터입니다.

 

문자열

camel.cloud.consul.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.consul.service-discovery.password

기본 인증에 사용할 암호를 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.consul.service-discovery.read-timeout-millis

OkHttpClient에 대한 시간 초과를 읽습니다.

 

long

camel.cloud.consul.service-discovery.url

Consul 에이전트 URL입니다.

 

문자열

camel.cloud.consul.service-discovery.user-name

기본 인증에 사용할 사용자 이름을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.write-timeout-millis

OkHttpClient에 대한 쓰기 시간 초과입니다.

 

long

camel.cloud.dns.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.dns.service-discovery.domain

도메인 이름;.

 

문자열

camel.cloud.dns.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.dns.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.dns.service-discovery.proto

원하는 서비스의 전송 프로토콜입니다.

_tcp

문자열

camel.cloud.etcd.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.etcd.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.etcd.service-discovery.password

기본 인증에 사용할 암호입니다.

 

문자열

camel.cloud.etcd.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.etcd.service-discovery.service-path

서비스 검색을 찾는 경로입니다.

/services/

문자열

camel.cloud.etcd.service-discovery.timeout

작업을 완료하는 데 사용할 수 있는 최대 시간을 설정하려면 다음을 수행하십시오.

 

long

camel.cloud.etcd.service-discovery.type

검색 유형을 설정하려면 유효한 값이 온 디맨드 및 감시입니다.

On-demand

문자열

camel.cloud.etcd.service-discovery.uris

클라이언트가 연결할 수 있는 URI입니다.

 

문자열

camel.cloud.etcd.service-discovery.user-name

기본 인증에 사용할 사용자 이름입니다.

 

문자열

camel.cloud.kubernetes.service-discovery.api-version

클라이언트 조회를 사용할 때 API 버전을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-data

클라이언트 조회를 사용할 때 인증 기관 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 Certificate Authority 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-data

클라이언트 조회를 사용할 때 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-algo

클라이언트 조회를 사용할 때 RSA와 같은 Client Keystore 알고리즘을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-data

클라이언트 조회를 사용할 때 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-passphrase

클라이언트 조회를 사용할 때 클라이언트 키 저장소 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.kubernetes.service-discovery.dns-domain

DNS 조회에 사용할 DNS 도메인을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.kubernetes.service-discovery.lookup

서비스 조회를 수행하는 방법 가능한 값: client, dns, environment. 클라이언트를 사용하는 경우 클라이언트는 kubernetes 마스터를 쿼리하여 서비스를 제공하는 활성 Pod 목록을 가져온 다음 Pod를 무작위(또는 라운드 로빈)합니다. dns를 사용하면 서비스 이름이 name.namespace.svc.dnsDomain으로 확인됩니다. dnssrv를 사용하는 경우 . …​svc…​의 SRV 쿼리로 서비스 이름이 확인됩니다 .환경을 사용하는 경우 서비스를 조회하는 데 환경 변수를 사용합니다. 기본적으로 환경이 사용됩니다.

환경

문자열

camel.cloud.kubernetes.service-discovery.master-url

클라이언트 조회를 사용할 때 URL을 마스터로 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.namespace

사용할 네임스페이스를 설정합니다. 기본적으로 ENV 변수 KUBERNETES_MASTER의 네임스페이스를 사용합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.oauth-token

클라이언트 조회를 사용할 때 인증을 위해 OAUTH 토큰(사용자 이름/암호 대신)을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.password

클라이언트 조회를 사용할 때 인증 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-name

DNS/DNSSRV 조회에 사용할 포트 이름을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-protocol

DNS/DNSSRV 조회에 사용할 포트 프로토콜을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.kubernetes.service-discovery.trust-certs

클라이언트 조회를 사용할 때 신뢰 인증서 검사를 설정할지 여부를 설정합니다.

false

부울

camel.cloud.kubernetes.service-discovery.username

클라이언트 조회를 사용할 때 인증에 대한 사용자 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.client-name

Ribbon 클라이언트 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.ribbon.load-balancer.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.ribbon.load-balancer.namespace

네임스페이스입니다.

 

문자열

camel.cloud.ribbon.load-balancer.password

암호입니다.

 

문자열

camel.cloud.ribbon.load-balancer.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.ribbon.load-balancer.username

사용자 이름입니다.

 

문자열

camel.hystrix.allow-maximum-size-to-diverge-from-core-size

최대Size 설정을 적용할 수 있습니다. 그런 다음 해당 값은 coreSize보다 크거나 같을 수 있습니다.

false

부울

camel.hystrix.circuit-breaker-enabled

HystrixCircuitBreaker 사용 여부입니다. false인 경우 회로 차단기 논리가 사용되지 않고 모든 요청이 허용됩니다. 이는 circuitBreakerForceECDHEd()와 유사하지만 메트릭을 계속 추적하고 공개/닫어야 하는지 여부를 알고 있기 때문에 회로 교체를 인스턴스화하지 않습니다.

true

부울

camel.hystrix.circuit-breaker-error-threshold-percentage

오류 백분율 임계값(50과 같은 정수)은 회로 차단기가 열려 있고 요청을 거부합니다. 이는 circuitBreakerSleepWindowInMilliseconds에 정의된 기간 동안 트립을 유지합니다. 오류 비율은 HystrixCommandMetrics.getHealthCounts()와 비교됩니다.

50

정수

camel.hystrix.circuit-breaker-force-closed

true인 경우 HystrixCircuitBreaker#allowRequest()는 HystrixCommandMetrics.getHealthCounts()의 오류 백분율에 관계없이 요청을 허용하도록 항상 true를 반환합니다. circuitBreakerForceOpen() 속성이 우선하므로 true로 설정하면 이 속성이 아무 작업도 수행하지 않습니다.

false

부울

camel.hystrix.circuit-breaker-force-open

true인 경우 HystrixCircuitBreaker.allowRequest()는 항상 false를 반환하므로 회로가 열려 있고 모든 요청을 거부합니다. 이 속성은 circuitBreakerForce 10.0.0.1d()보다 우선합니다.

false

부울

camel.hystrix.circuit-breaker-request-volume-threshold

HystrixCircuitBreaker가 이동하기 전에 존재해야 하는 metricsRollingStatisticalWindowInMilliseconds()의 최소 요청 수입니다. 이 숫자 아래에 있는 경우 회로는 오류 백분율에 관계없이 이동하지 않습니다.

20

정수

camel.hystrix.circuit-breaker-sleep-window-in-milliseconds

HystrixCircuitBreaker 트립션이 열린 후 다시 요청을 시도하기 전에 대기해야 하는 시간(밀리초)입니다.

5000

정수

camel.hystrix.configurations

추가 구성 정의를 정의합니다.

 

map

camel.hystrix.core-pool-size

java.util.concurrent.ThreadPoolExecutor#setCorePoolSize(int)에 전달되는 코어 스레드 풀 크기입니다.

10

정수

camel.hystrix.enabled

구성 요소를 활성화합니다.

true

부울

camel.hystrix.execution-isolation-semaphore-max-concurrent-requests

HystrixCommand.run()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 거부됩니다. 실행IsolationStrategy == SEMAPHORE 경우에만 적용됩니다.

20

정수

camel.hystrix.execution-isolation-strategy

을 사용하여 격리 전략 HystrixCommand.run()를 실행합니다. THREAD가 별도의 스레드에서 실행되고 스레드 풀의 스레드 수에 따라 제한되는 동시 요청이 실행됩니다. SEMAPHORE는 호출 스레드와 세마포 수에 의해 제한되는 동시 요청에서 실행됩니다.

THREAD

문자열

camel.hystrix.execution-isolation-thread-interrupt-on-timeout

스레드가 시간 초과될 때 실행 스레드에서 인터럽트를 시도해야 하는지 여부입니다. whether the execution thread should attempt an interrupt (using an interrupt#cancel ) when a thread times out. executionIsolationStrategy() == THREAD 경우에만 적용됩니다.

true

부울

camel.hystrix.execution-timeout-enabled

이 명령에 시간 초과 메커니즘이 활성화되었는지 여부.

true

부울

camel.hystrix.execution-timeout-in-milliseconds

명령이 시간 초과되고 실행을 중지하는 시간(밀리초)입니다. executionIsolationThreadInterruptOnTimeout == true 및 명령이 thread-isolated인 경우 실행 중인 스레드가 중단됩니다. 명령이 세마포 분리 및 HystrixObservableCommand인 경우 해당 명령은 구독 해제됩니다.

1000

정수

camel.hystrix.fallback-enabled

오류가 발생할 때 HystrixCommand.getFallback()을 시도해야 하는지 여부

true

부울

camel.hystrix.fallback-isolation-semaphore-max-concurrent-requests

HystrixCommand.getFallback()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 빠르게 실패하며 폴백 검색을 시도하지 않습니다.

10

정수

camel.hystrix.group-key

사용할 그룹 키를 설정합니다. 기본값은 CamelHystrix입니다.

CamelHystrix

문자열

camel.hystrix.keep-alive-time

ThreadPoolExecutor#setKeepAliveTime(long,TimeUnit)에 전달되는 Keep-alive 시간(분).

1

정수

camel.hystrix.max-queue-size

HystrixConcurrencyStrategy.getBlockingQueue(int)에서 BlockingQueue에 전달되는 최대 대기열 크기는 스레드 풀의 인스턴스화에만 영향을 미칩니다. 이를 위해 queueSizeRejectionThreshold()를 사용합니다.

-1

정수

camel.hystrix.maximum-size

ThreadPoolExecutor#setMaximumPoolSize(int)에 전달되는 최대 스레드 풀 크기입니다. 이는 HystrixCommands를 거부하지 않고 지원할 수 있는 최대 동시성 양입니다. 이 설정은 allowMaximumSizeToDivergeFromCoreSizeSize도 설정하는 경우에만 적용됩니다.

10

정수

camel.hystrix.metrics-health-snapshot-interval-in-milliseconds

성공 및 오류 백분율을 계산하고 HystrixCircuitBreaker.isOpen() 상태에 영향을 미치는 상태 스냅샷 허용 사이에 대기하는 시간(밀리초)입니다. 양이 많은 경우 오류 백분율의 지속적인 계산이 CPU 집약적이 될 수 있으므로 계산된 빈도를 제어합니다.

500

정수

camel.hystrix.metrics-rolling-percentile-bucket-size

롤링 백분율의 각 버킷에 저장된 최대 값 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-percentile-enabled

HystrixCommandMetrics 내에서 HystrixRollingPercentile을 사용하여 백분율 지표를 캡처해야 하는지 여부입니다.

true

부울

camel.hystrix.metrics-rolling-percentile-window-buckets

롤링 백분위기 창이 분할되는 버킷 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

6

정수

camel.hystrix.metrics-rolling-percentile-window-in-milliseconds

백분율로 구성된 창(밀리초)입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10000

정수

camel.hystrix.metrics-rolling-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 HystrixCommandMetrics 내부의 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-statistical-window-in-milliseconds

이 속성은 통계 롤링 창(밀리초)을 설정합니다. 스레드 풀에 대해 메트릭을 유지하는 방법입니다. 이 창은 버킷으로 나뉘어져 해당 증분으로 롤백됩니다.

10000

정수

camel.hystrix.queue-size-rejection-threshold

큐 크기 거부 임계값은 maxQueueSize에 도달하지 않은 경우에도 거부가 발생하는 인위성 최대 크기입니다. BlockingQueue의 maxQueueSize는 동적으로 변경할 수 없으며 거부에 영향을 미치는 큐 크기의 동적으로 변경을 지원하려고 하므로 수행됩니다. 이는 실행을 위한 스레드를 대기열에 추가할 때 HystrixCommand에서 사용됩니다.

5

정수

camel.hystrix.request-log-enabled

HystrixCommand 실행 및 이벤트를 HystrixRequestLog에 기록해야 하는지 여부입니다.

true

부울

camel.hystrix.thread-pool-key

사용할 스레드 풀 키를 설정합니다. 기본적으로는 groupKey가 사용하도록 구성된 것과 동일한 값을 사용합니다.

CamelHystrix

문자열

camel.hystrix.thread-pool-rolling-number-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.thread-pool-rolling-number-statistical-window-in-milliseconds

통계 롤링 창(밀리초)입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10000

정수

camel.language.constant.enabled

상수 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.constant.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.csimple.enabled

csimple 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.csimple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.exchangeproperty.enabled

exchangeProperty 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.exchangeproperty.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.file.enabled

파일 언어 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.file.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.header.enabled

헤더 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.header.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.ref.enabled

ref 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.ref.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.simple.enabled

간단한 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.simple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.tokenize.enabled

토큰화 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.tokenize.group-delimiter

그룹화할 때 사용할 구분 기호를 설정합니다. 이 값을 설정하지 않으면 토큰은 구분 기호로 사용됩니다.

 

문자열

camel.language.tokenize.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.resilience4j.automatic-transition-from-open-to-half-open-enabled

waitDurationInOpenState가 통과되면 OPEN에서 HALF_OPEN 상태로 자동 전환할 수 있습니다.

false

부울

camel.resilience4j.circuit-breaker-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreaker 인스턴스를 나타냅니다. 이 기능을 사용할 때 다른 회로 차단기 옵션을 사용하지 않습니다.

 

문자열

camel.resilience4j.config-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreakerConfig 인스턴스를 나타냅니다.

 

문자열

camel.resilience4j.configurations

추가 구성 정의를 정의합니다.

 

map

camel.resilience4j.enabled

구성 요소를 활성화합니다.

true

부울

camel.resilience4j.failure-rate-threshold

실패 비율 임계값을 백분율로 구성합니다. 실패 비율이 임계값보다 크거나 같으면 CircuitBreaker가 열기로 전환되고 쇼트 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 50입니다.

 

float

camel.resilience4j.minimum-number-of-calls

CircuitBreaker가 오류 속도를 계산할 수 있기 전에 필요한 최소 호출 수(라이딩 창 기간당)를 구성합니다. 예를 들어, minimumNumberOf>-<s가 10인 경우 실패 비율을 계산하기 전에 최소 10번의 호출을 기록해야 합니다. 9 개의 호출 만 기록 된 경우 CircuitBreaker는 모든 9 번 호출이 실패하더라도 열기 위해 전환되지 않습니다. 기본 minimumNumberOf>-<s는 100입니다.

100

정수

camel.resilience4j.permitted-number-of-calls-in-half-open-state

CircuitBreaker가 절반 열려 있을 때 허용되는 호출 수를 설정합니다. 크기는 0보다 커야 합니다. 기본값은 10입니다.

10

정수

camel.resilience4j.sliding-window-size

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 크기를 설정합니다. slidingWindowSize는 슬라이딩 창 크기를 구성합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 슬라이딩 WindowSize는 0보다 커야 합니다. minimumNumberOf>-<s는 0보다 커야 합니다. slidingWindowType이 COUNT_BASED인 경우 minimumNumberOf>-<s는 slidingWindowSize . 슬라이딩 WindowType이 TIME_BASED인 경우 원하는 항목을 선택할 수 있습니다. 기본 slidingWindowSize는 100입니다.

100

정수

camel.resilience4j.sliding-window-type

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 유형을 설정합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 기본 sliding WindowType은 COUNT_BASED입니다.

COUNT_BASED

문자열

camel.resilience4j.slow-call-duration-threshold

호출이 느리고 느린 호출 비율을 늘리는 기간 임계값(초)을 구성합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.slow-call-rate-threshold

임계값을 백분율로 구성합니다. CircuitBreaker는 호출 기간이 slowECDHEDurationThreshold Duration보다 클 때 호출 속도가 느린 것으로 간주합니다. 느린 호출의 백분율이 임계값 이상인 경우 CircuitBreaker는 열기로 전환되고 단기 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 100 백분율로, 기록된 모든 호출이 slowECDHEDurationThreshold보다 느릴 수 있음을 의미합니다.

 

float

camel.resilience4j.wait-duration-in-open-state

대기 기간(초)을 설정합니다. CircuitBreaker는 반으로 전환되기 전에 열려 있어야 하는 시간을 지정합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.writable-stack-trace-enabled

쓰기 가능한 스택 추적을 활성화합니다. false로 설정하면 Exception.getStackTrace에서 길이 배열을 0개 반환합니다. 예외의 원인이 이미 알려진 대로 회로 차단기가 열려 있을 때 로그 스팸을 줄이는 데 사용할 수 있습니다(회로 차단기는 짧은 호출임).

true

부울

camel.rest.api-component

REST API(예: swagger)로 사용할 Camel 구성 요소의 이름(예: swagger)이 명시적으로 구성되어 있지 않은 경우, REST API 문서를 서비스하고 생성하는 Camel 구성 요소가 있는지 또는 org.apache.camel.camel.spi.RestApiProcessorFactory가 레지스트리에 등록되어 있는 경우 Camel을 조회합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.api-context-path

REST API 서비스가 사용할 선행 API 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다.

 

문자열

camel.rest.api-context-route-id

REST API를 제공하는 경로에 사용할 경로 ID를 설정합니다. 이 경로는 기본적으로 자동 할당된 경로 ID를 사용합니다.

 

문자열

camel.rest.api-host

API 설명서에 특정 호스트 이름(예: swagger)을 사용하려면 생성된 호스트를 이 구성된 호스트 이름으로 덮어쓸 수 있습니다.

 

문자열

camel.rest.api-property

api 설명서(swagger)에 대한 많은 추가 속성을 구성할 수 있습니다. 예를 들어 속성 api.title을 이상적인 제품으로 설정합니다.

 

map

camel.rest.api-vendor-extension

Rest API에서 벤더 확장이 활성화되었는지 여부. 활성화하면 Camel에는 추가 정보(예: 경로 ID, 클래스 이름 등 x로 시작하는 키)로 추가 정보가 포함됩니다. API docs를 가져올 때 모든 타사 API 게이트웨이 및 도구가 vendor-extensions를 지원하는 것은 아닙니다.

false

부울

camel.rest.binding-mode

사용할 바인딩 모드를 설정합니다. 기본값은 OFF입니다.

 

RestBindingMode

camel.rest.client-request-validation

클라이언트 요청의 유효성 검사를 활성화하여 클라이언트의 Content-Type 및 Accept 헤더가 사용/생산 설정의 Rest-DSL 구성에서 지원하는지 여부를 확인합니다. 확인을 위해 이 설정을 사용할 수 있습니다. 유효성 검사 오류의 경우 HTTP 상태 코드 415 또는 406이 반환됩니다. 기본값은 false입니다.

false

부울

camel.rest.component

netty-http, jetty, 서블릿과 같이 REST 전송(consumer)에 사용할 Camel Rest 구성 요소. 명시적으로 구성된 구성 요소가 없는 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestConsumerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.component-property

사용 중인 나머지 구성 요소에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.consumer-property

사용 중인 나머지 소비자에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.context-path

REST 서비스가 사용할 선행 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다. 또는 HTTP 서버를 포함하는 camel-jetty 또는 camel-netty-http와 같은 구성 요소의 경우

 

문자열

camel.rest.cors-headers

사용자 정의 CORS 헤더를 구성할 수 있습니다.

 

map

camel.rest.data-format-property

사용 중인 데이터 형식에 대한 추가 속성 수를 구성할 수 있습니다. 예를 들어 매우 모드에서 json을 출력하려면 속성 pretty 아닌 true로 속성을 설정합니다. 옵션 앞에 있는 속성을 추가하여 JSON 또는 XML과 IN 또는 OUT 중 하나에만 사용할 수 있습니다. 접두사는 json.in. json.out. xml.in. xml.out입니다. 예를 들어 xml.out.mustBeJAXB>-< 값이 있는 키는 나가는 XML 데이터 형식일 뿐입니다. 접두사가 없는 키는 모든 상황에서 공통 키입니다.

 

map

camel.rest.enable-cors

HTTP 응답에서 CORS 헤더를 활성화할지 여부입니다.

false

부울

camel.rest.endpoint-property

 

camel.rest.host

 

문자열

camel.rest.host-name-resolver

 

RestHostNameResolver

camel.rest.json-data-format

 

문자열

camel.rest.port

 

문자열

camel.rest.producer-api-doc

 

문자열

camel.rest.producer-component

 

문자열

camel.rest.scheme

 

문자열

camel.rest.skip-binding-on-error-code

false

부울

camel.rest.use-x-forward-headers

true

부울

camel.rest.xml-data-format

 

문자열

camel.rest.api-context-id-pattern

 

문자열

camel.rest.api-context-listing

false

부울

73장. XQuery

73.1.

이름DefaultJava Type설명

type

 

문자열

headerName

 

문자열

configurationRef

 

문자열

trim

 

부울

73.2.

Variable유형설명

in.body

개체

out.body

개체

in.headers.*

개체

out.headers.*

개체

개체

73.3. 예제

from("queue:foo")
  .filter().xquery("//foo")
  .to("queue:bar")

from("direct:start")
  .recipientList().xquery("concat('mock:foo.', /person/@city)", String.class);

<route>
  <from uri="direct:start"/>
  <recipientList>
    <xquery type="java.lang.String">concat('mock:foo.', /person/@city</xquery>
  </recipientList>
</route>

73.3.1.

Namespaces ns = new Namespaces("c", "http://acme.com/cheese");

from("direct:start")
  .filter().xquery("/c:person[@name='James']", ns)
  .to("mock:result");

/c:person[@name='James']

Namespaces ns = new Namespaces("c", "http://acme.com/cheese")
                     .add("w", "http://acme.com/wine")
                     .add("b", "http://acme.com/beer");

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:foo="http://example.com/person"
       xsi:schemaLocation="
       http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
       http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd">

  <camelContext id="camel" xmlns="http://activemq.apache.org/camel/schema/spring">
    <route>
      <from uri="activemq:MyQueue"/>
      <filter>
        <xquery>/foo:person[@name='James']</xquery>
        <to uri="mqseries:SomeOtherQueue"/>
      </filter>
    </route>
  </camelContext>
</beans>

73.4.

from("direct:start").
   transform().xquery("/people/person");

from("direct:start").
   transform().xquery("/people/person/text()", String.class);

<transform>
    <xquery>
        declare variable $in.headers.foo external;
        element item {$in.headers.foo}
    </xquery>
</transform>

73.5.

.setHeader("myHeader").xquery("resource:classpath:myxquery.txt", String.class)

73.6.

73.7.

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-saxon</artifactId>
  <version>{CamelSBVersion}</version>
</dependency>

73.8.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-saxon-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

이름설명Default유형

camel.component.xquery.autowired-enabled

true

부울

camel.component.xquery.bridge-error-handler

false

부울

camel.component.xquery.configuration

 

설정

camel.component.xquery.configuration-properties

 

camel.component.xquery.enabled

 

부울

camel.component.xquery.lazy-start-producer

false

부울

camel.component.xquery.module-u-r-i-resolver

 

ModuleURIResolver

camel.language.xquery.configuration-ref

 

문자열

camel.language.xquery.enabled

 

부울

camel.language.xquery.trim

true

부울

camel.language.xquery.type

 

문자열

74장.

참고

참고

참고

74.1.

이름DefaultJava Type설명

resultType

 

문자열

trim

 

부울

74.2.

Variable유형설명

camelId

문자열

camelContext.OGNL

개체

개체

exchangeId

문자열

id

문자열

messageTimestamp

문자열

body

개체

개체

bodyAs(type)

유형

bodyAs(type).OGNL

개체

bodyOneLine

문자열

mandatoryBodyAs(type)

유형

mandatoryBodyAs(type).OGNL

개체

header.foo

개체

개체

headers.foo

개체

개체

개체

header.foo[bar]

개체

개체

headerAs(key,type)

유형

headers

exchangeProperty.foo

개체

exchangeProperty[foo]

개체

exchangeProperty.foo.OGNL

개체

sys.foo

문자열

sysenv.foo

문자열

env.foo

문자열

개체

개체

exception.message

문자열

exception.stacktrace

문자열

date:_command_

날짜

date:_command:pattern_

문자열

date-with-timezone:_command:timezone:pattern_

문자열

bean:_bean expression_

개체

properties:key:default

문자열

routeId

문자열

stepId

문자열

threadName

문자열

hostname

문자열

ref:xxx

개체

type:name.field

개체

null

null

random(value)

정수

random(min,max)

정수

collate(group)

skip(number)

messageHistory

문자열

messageHistory(false)

문자열

74.3.

simple("${body.address}")
simple("${body.address.street}")
simple("${body.address.zip}")

simple("${body.address}")
simple("${body.getAddress.getStreet}")
simple("${body.address.getZip}")
simple("${body.doSomething}")

simple("${body?.address?.street}")

simple("${body[foo].name}")

simple("${body['foo bar'].name}")

simple("${body[foo]}")
simple("${body[this.is.foo]}")

simple("${body[foo]?.name}")

simple("${body.address.lines[0]}")
simple("${body.address.lines[1]}")
simple("${body.address.lines[2]}")

simple("${body.address.lines[last]}")

simple("${body.address.lines[last-1]}")

simple("${body.address.lines[last-2]}")

simple("${body.address.lines.size}")

String[] lines = new String[]{"foo", "bar", "cat"};
exchange.getIn().setBody(lines);

simple("There are ${body.length} lines")

simple("${body.address.zip} > 1000")

74.4.

${leftValue} OP rightValue

참고

Operator설명

==

=~

>

>=

<

!=

!=~

~~

!~~

regex

!regex

startsWith

endsWith

Operator설명

++

 — 

\n

\t

\r

\}

텍스트로 } 문자를 사용합니다. 간단한 언어로 JSon 구조를 빌드할 때 필요할 수 있습니다.

다음 논리 연산자를 사용하여 식을 그룹화할 수 있습니다.

Operator설명

&&

논리 및 연산자는 두 개의 표현식을 그룹화하는 데 사용됩니다.

  
 

논리 또는 연산자는 두 개의 표현식을 그룹화하는 데 사용됩니다.

AND 구문은 다음과 같습니다.

${leftValue} OP rightValue && ${leftValue} OP rightValue

OR의 구문은 다음과 같습니다.

${leftValue} OP rightValue || ${leftValue} OP rightValue

일부 예:

// exact equals match
simple("${header.foo} == 'foo'")

// ignore case when comparing, so if the header has value FOO this will match
simple("${header.foo} =~ 'foo'")

// here Camel will type convert '100' into the type of header.bar and if it is an Integer '100' will also be converter to an Integer
simple("${header.bar} == '100'")

simple("${header.bar} == 100")

// 100 will be converter to the type of header.bar so we can do > comparison
simple("${header.bar} > 100")

74.4.1. 다양한 유형 비교

String 및 int와 같은 다양한 유형과 비교할 때 몇 가지 주의를 취해야 합니다. Camel은 왼쪽의 유형을 1차 우선 순위로 사용합니다. 두 값을 해당 유형에 따라 비교할 수 없는 경우 오른쪽 유형으로 대체할 수 있습니다.
즉, 특정 형식을 적용하기 위해 값을 변경할 수 있습니다. 위의 bar 값이 문자열이라고 가정합니다. 그런 다음 식을 축소할 수 있습니다.

simple("100 < ${header.bar}")

그런 다음 int 유형이 1st 우선 순위로 사용되는지 확인합니다.

Camel 팀이 숫자 유형을 String 기반으로 선호하도록 바이너리 비교 작업을 개선하는 경우 향후 변경될 수 있습니다. 숫자와 비교할 때 문제가 발생하는 String 유형입니다.

// testing for null
simple("${header.baz} == null")

// testing for not null
simple("${header.baz} != null")

그리고 오른쪽 값이 다른 표현식인 약간 더 고급 예

simple("${header.date} == ${date:now:yyyyMMdd}")

simple("${header.type} == ${bean:orderService?method=getOrderType}")

및 이 포함된 예제로, 제목에 Camel이라는 단어가 포함되어 있는지 테스트합니다.

simple("${header.title} contains 'Camel'")

regex를 사용한 예로 숫자 헤더가 4자리 값인지 테스트합니다.

simple("${header.number} regex '\\d{4}'")

그리고 마지막으로 헤더가 목록의 값과 같은 경우의 예입니다. 각 요소는 쉼표로 구분되어야 하며 공백은 없어야 합니다.
Camel은 각 요소를 왼쪽의 유형으로 변환하므로 숫자에도 사용할 수 있습니다.

simple("${header.type} in 'gold,silver'")

그리고 마지막 3가지 모두의 경우 다음과 같이 사용하지 않고 부정 테스트를 지원합니다.

simple("${header.type} !in 'gold,silver'")

그리고 유형이 특정 인스턴스인지 테스트할 수 있습니다(예: String 인스턴스).

simple("${header.type} is 'java.lang.String'")

모든 java.lang 유형에 대한 단축을 추가했으므로 다음과 같이 작성할 수 있습니다.

simple("${header.type} is 'String'")

범위도 지원됩니다. 범위 간격에는 숫자가 필요하며 from 및 end 모두 포함됩니다. 예를 들어 값이 100에서 199 사이인지 테스트합니다.

simple("${header.number} range 100..199")

공백 없이 범위에서 .. 를 사용합니다. Groovy와 동일한 구문을 기반으로 합니다.

simple("${header.number} range '100..199'")

XML DSL에는 모든 다양한 빌더 방법이 포함된 Java DSL과 같은 모든 기능이 없으므로 간단한 연산자를 사용한 테스트에 다른 언어를 사용해야 합니다. 이제 간단한 언어로 이 작업을 수행할 수 있습니다. 아래 샘플에서 헤더가 위젯 순서인지 테스트하려고 합니다.

<from uri="seda:orders">
   <filter>
       <simple>${header.type} == 'widget'</simple>
       <to uri="bean:orderService?method=handleWidget"/>
   </filter>
</from>

74.4.2. 및 / 또는

두 개의 표현식이 있는 경우 &amp ;& amp; 또는 | 연산자와 결합할 수 있습니다.

예를 들면 다음과 같습니다.

simple("${header.title} contains 'Camel' && ${header.type'} == 'gold'")

그리고 물론 | | 도 지원됩니다. 샘플은 다음과 같습니다.

simple("${header.title} contains 'Camel' || ${header.type'} == 'gold'")

74.5. 예

아래의 XML DSL 샘플에서는 헤더 값을 기준으로 필터링합니다.

<from uri="seda:orders">
   <filter>
       <simple>${header.foo}</simple>
       <to uri="mock:fooOrders"/>
   </filter>
</from>

Message Filter 패턴에서 위의 서술자 테스트에 Simple 언어를 사용할 수 있습니다. 여기서 message에 foo 헤더( foo 키가 있는 헤더)가 있는지 테스트합니다. 표현식이 true 로 평가되면 메시지는 mock:fooOrders 끝점으로 라우팅되고, 그렇지 않으면 메시지가 삭제됩니다.

Java DSL의 동일한 예:

from("seda:orders")
    .filter().simple("${header.foo}")
        .to("seda:fooOrders");

다음과 같은 간단한 텍스트 연결을 위해 간단한 언어를 사용할 수도 있습니다.

from("direct:hello")
    .transform().simple("Hello ${header.user} how are you?")
    .to("mock:reply");

Camel이 올바르게 구문 분석할 수 있도록 이제 표현식에 $\\{ } 자리 표시자를 사용해야 합니다.

그리고 이 샘플은 date 명령을 사용하여 현재 날짜를 출력합니다.

from("direct:hello")
    .transform().simple("The today is ${date:now:yyyyMMdd} and it is a great day.")
    .to("mock:reply");

그리고 아래 샘플에서는 빈 언어를 호출하여 반환된 문자열에 포함될 빈의 메서드를 호출합니다.

from("direct:order")
    .transform().simple("OrderId: ${bean:orderIdGenerator}")
    .to("mock:reply");

여기서 orderIdGenerator 는 레지스트리에 등록된 빈의 ID입니다. Spring을 사용하는 경우 Spring kubeconfig ID입니다.

순서 ID 생성기 빈에서 호출할 메서드를 선언하려면 generateId 메서드를 호출하는 위치와 같은 .method 이름 앞에 .method 이름을 추가해야 합니다.

from("direct:order")
    .transform().simple("OrderId: ${bean:orderIdGenerator.generateId}")
    .to("mock:reply");

layer component 자체에 익숙한 ?method=methodname 옵션을 사용할 수 있습니다.

from("direct:order")
    .transform().simple("OrderId: ${bean:orderIdGenerator?method=generateId}")
    .to("mock:reply");

예를 들어 사용할 수 있는 String인지 확인하기 위해 본문을 지정된 유형으로 변환할 수도 있습니다.

<transform>
  <simple>Hello ${bodyAs(String)} how are you?</simple>
</transform>

몇 가지 유형이 있습니다. 간단한 표기법이 있으므로 java.lang. String 대신 String을 사용할 수 있습니다. 이 값은 byte[], String, Integer, Long 입니다. 다른 모든 유형은 해당 FQN 이름을 사용해야 합니다(예: org.w3c.dom.Document ).

헤더 맵에서 값을 조회할 수도 있습니다.

<transform>
  <simple>The gold value is ${header.type[gold]}</simple>
</transform>

위의 코드에서는 이름 유형이 있는 헤더를 조회하여 java.util.Map 으로 간주하고 키를 사용하여 조회 하고 값을 반환합니다. 헤더가 Map으로 변환할 수 없는 경우 예외가 발생합니다. name type 이 있는 헤더가 null 이 반환되지 않는 경우

다음과 같은 함수를 중첩할 수 있습니다.

<setHeader name="myHeader">
  <simple>${properties:${header.someKey}}</simple>
</setHeader>

74.6. 결과 유형 설정

이제 결과 유형을 Simple 표현식에 제공할 수 있습니다. 즉, 평가 결과가 원하는 형식으로 변환됩니다. 부울, 정수 등과 같은 유형을 정의하는 데 가장 유용합니다.

예를 들어 헤더를 부울 유형으로 설정하려면 다음을 수행할 수 있습니다.

.setHeader("cool", simple("true", Boolean.class))

XML DSL에서

<setHeader name="cool">
  <!-- use resultType to indicate that the type should be a java.lang.Boolean -->
  <simple resultType="java.lang.Boolean">true</simple>
</setHeader>

74.7. XML DSL에서 새 줄 또는 탭 사용

이제 값을 이스케이프할 수 있으므로 XML DSLs에서 새 줄이나 탭을 더 쉽게 지정할 수 있습니다.

<transform>
  <simple>The following text\nis on a new line</simple>
</transform>

74.8. 선행 및 후행 공백 처리

표현식의 trim 특성을 사용하여 선행 및 후행 공백 문자가 제거되거나 보존되는지 여부를 제어할 수 있습니다. 기본값은 true이며 공백 문자를 제거합니다.

<setBody>
  <simple trim="false">You get some trailing whitespace characters.     </simple>
</setBody>

74.9. 외부 리소스에서 스크립트 로드

스크립트를 외부화하고 "classpath:", "file:", "http:" 와 같은 리소스에서 Camel을 로드하도록 할 수 있습니다. 이 작업은 다음 구문을 사용하여 수행됩니다. "resource:scheme:location" 과 같이 수행할 수 있는 classpath의 파일을 참조합니다.

.setHeader("myHeader").simple("resource:classpath:mysimple.txt")

74.10. Spring Boot Auto-Configuration

Spring Boot와 함께 simple를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-core-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.cloud.consul.service-discovery.acl-token

Consul과 함께 사용할 ACL 토큰을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.block-seconds

감시 이벤트를 대기하는 시간(기본값: 10초)입니다.

10

정수

camel.cloud.consul.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.consul.service-discovery.connect-timeout-millis

OkHttpClient에 대한 연결 시간 초과입니다.

 

long

camel.cloud.consul.service-discovery.datacenter

데이터 센터입니다.

 

문자열

camel.cloud.consul.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.consul.service-discovery.password

기본 인증에 사용할 암호를 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.consul.service-discovery.read-timeout-millis

OkHttpClient에 대한 시간 초과를 읽습니다.

 

long

camel.cloud.consul.service-discovery.url

Consul 에이전트 URL입니다.

 

문자열

camel.cloud.consul.service-discovery.user-name

기본 인증에 사용할 사용자 이름을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.write-timeout-millis

OkHttpClient에 대한 쓰기 시간 초과입니다.

 

long

camel.cloud.dns.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.dns.service-discovery.domain

도메인 이름;.

 

문자열

camel.cloud.dns.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.dns.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.dns.service-discovery.proto

원하는 서비스의 전송 프로토콜입니다.

_tcp

문자열

camel.cloud.etcd.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.etcd.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.etcd.service-discovery.password

기본 인증에 사용할 암호입니다.

 

문자열

camel.cloud.etcd.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.etcd.service-discovery.service-path

서비스 검색을 찾는 경로입니다.

/services/

문자열

camel.cloud.etcd.service-discovery.timeout

작업을 완료하는 데 사용할 수 있는 최대 시간을 설정하려면 다음을 수행하십시오.

 

long

camel.cloud.etcd.service-discovery.type

검색 유형을 설정하려면 유효한 값이 온 디맨드 및 감시입니다.

On-demand

문자열

camel.cloud.etcd.service-discovery.uris

클라이언트가 연결할 수 있는 URI입니다.

 

문자열

camel.cloud.etcd.service-discovery.user-name

기본 인증에 사용할 사용자 이름입니다.

 

문자열

camel.cloud.kubernetes.service-discovery.api-version

클라이언트 조회를 사용할 때 API 버전을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-data

클라이언트 조회를 사용할 때 인증 기관 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 Certificate Authority 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-data

클라이언트 조회를 사용할 때 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-algo

클라이언트 조회를 사용할 때 RSA와 같은 Client Keystore 알고리즘을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-data

클라이언트 조회를 사용할 때 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-passphrase

클라이언트 조회를 사용할 때 클라이언트 키 저장소 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.kubernetes.service-discovery.dns-domain

DNS 조회에 사용할 DNS 도메인을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.kubernetes.service-discovery.lookup

서비스 조회를 수행하는 방법 가능한 값: client, dns, environment. 클라이언트를 사용하는 경우 클라이언트는 kubernetes 마스터를 쿼리하여 서비스를 제공하는 활성 Pod 목록을 가져온 다음 Pod를 무작위(또는 라운드 로빈)합니다. dns를 사용하면 서비스 이름이 name.namespace.svc.dnsDomain으로 확인됩니다. dnssrv를 사용하는 경우 . …​svc…​의 SRV 쿼리로 서비스 이름이 확인됩니다 .환경을 사용하는 경우 서비스를 조회하는 데 환경 변수를 사용합니다. 기본적으로 환경이 사용됩니다.

환경

문자열

camel.cloud.kubernetes.service-discovery.master-url

클라이언트 조회를 사용할 때 URL을 마스터로 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.namespace

사용할 네임스페이스를 설정합니다. 기본적으로 ENV 변수 KUBERNETES_MASTER의 네임스페이스를 사용합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.oauth-token

클라이언트 조회를 사용할 때 인증을 위해 OAUTH 토큰(사용자 이름/암호 대신)을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.password

클라이언트 조회를 사용할 때 인증 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-name

DNS/DNSSRV 조회에 사용할 포트 이름을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-protocol

DNS/DNSSRV 조회에 사용할 포트 프로토콜을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.kubernetes.service-discovery.trust-certs

클라이언트 조회를 사용할 때 신뢰 인증서 검사를 설정할지 여부를 설정합니다.

false

부울

camel.cloud.kubernetes.service-discovery.username

클라이언트 조회를 사용할 때 인증에 대한 사용자 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.client-name

Ribbon 클라이언트 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.ribbon.load-balancer.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.ribbon.load-balancer.namespace

네임스페이스입니다.

 

문자열

camel.cloud.ribbon.load-balancer.password

암호입니다.

 

문자열

camel.cloud.ribbon.load-balancer.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.ribbon.load-balancer.username

사용자 이름입니다.

 

문자열

camel.hystrix.allow-maximum-size-to-diverge-from-core-size

최대Size 설정을 적용할 수 있습니다. 그런 다음 해당 값은 coreSize보다 크거나 같을 수 있습니다.

false

부울

camel.hystrix.circuit-breaker-enabled

HystrixCircuitBreaker 사용 여부입니다. false인 경우 회로 차단기 논리가 사용되지 않고 모든 요청이 허용됩니다. 이는 circuitBreakerForceECDHEd()와 유사하지만 메트릭을 계속 추적하고 공개/닫어야 하는지 여부를 알고 있기 때문에 회로 교체를 인스턴스화하지 않습니다.

true

부울

camel.hystrix.circuit-breaker-error-threshold-percentage

오류 백분율 임계값(50과 같은 정수)은 회로 차단기가 열려 있고 요청을 거부합니다. 이는 circuitBreakerSleepWindowInMilliseconds에 정의된 기간 동안 트립을 유지합니다. 오류 비율은 HystrixCommandMetrics.getHealthCounts()와 비교됩니다.

50

정수

camel.hystrix.circuit-breaker-force-closed

true인 경우 HystrixCircuitBreaker#allowRequest()는 HystrixCommandMetrics.getHealthCounts()의 오류 백분율에 관계없이 요청을 허용하도록 항상 true를 반환합니다. circuitBreakerForceOpen() 속성이 우선하므로 true로 설정하면 이 속성이 아무 작업도 수행하지 않습니다.

false

부울

camel.hystrix.circuit-breaker-force-open

true인 경우 HystrixCircuitBreaker.allowRequest()는 항상 false를 반환하므로 회로가 열려 있고 모든 요청을 거부합니다. 이 속성은 circuitBreakerForce 10.0.0.1d()보다 우선합니다.

false

부울

camel.hystrix.circuit-breaker-request-volume-threshold

HystrixCircuitBreaker가 이동하기 전에 존재해야 하는 metricsRollingStatisticalWindowInMilliseconds()의 최소 요청 수입니다. 이 숫자 아래에 있는 경우 회로는 오류 백분율에 관계없이 이동하지 않습니다.

20

정수

camel.hystrix.circuit-breaker-sleep-window-in-milliseconds

HystrixCircuitBreaker 트립션이 열린 후 다시 요청을 시도하기 전에 대기해야 하는 시간(밀리초)입니다.

5000

정수

camel.hystrix.configurations

추가 구성 정의를 정의합니다.

 

map

camel.hystrix.core-pool-size

java.util.concurrent.ThreadPoolExecutor#setCorePoolSize(int)에 전달되는 코어 스레드 풀 크기입니다.

10

정수

camel.hystrix.enabled

구성 요소를 활성화합니다.

true

부울

camel.hystrix.execution-isolation-semaphore-max-concurrent-requests

HystrixCommand.run()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 거부됩니다. 실행IsolationStrategy == SEMAPHORE 경우에만 적용됩니다.

20

정수

camel.hystrix.execution-isolation-strategy

을 사용하여 격리 전략 HystrixCommand.run()를 실행합니다. THREAD가 별도의 스레드에서 실행되고 스레드 풀의 스레드 수에 따라 제한되는 동시 요청이 실행됩니다. SEMAPHORE는 호출 스레드와 세마포 수에 의해 제한되는 동시 요청에서 실행됩니다.

THREAD

문자열

camel.hystrix.execution-isolation-thread-interrupt-on-timeout

스레드가 시간 초과될 때 실행 스레드에서 인터럽트를 시도해야 하는지 여부입니다. whether the execution thread should attempt an interrupt (using an interrupt#cancel ) when a thread times out. executionIsolationStrategy() == THREAD 경우에만 적용됩니다.

true

부울

camel.hystrix.execution-timeout-enabled

이 명령에 시간 초과 메커니즘이 활성화되었는지 여부.

true

부울

camel.hystrix.execution-timeout-in-milliseconds

명령이 시간 초과되고 실행을 중지하는 시간(밀리초)입니다. executionIsolationThreadInterruptOnTimeout == true 및 명령이 thread-isolated인 경우 실행 중인 스레드가 중단됩니다. 명령이 세마포 분리 및 HystrixObservableCommand인 경우 해당 명령은 구독 해제됩니다.

1000

정수

camel.hystrix.fallback-enabled

오류가 발생할 때 HystrixCommand.getFallback()을 시도해야 하는지 여부

true

부울

camel.hystrix.fallback-isolation-semaphore-max-concurrent-requests

HystrixCommand.getFallback()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 빠르게 실패하며 폴백 검색을 시도하지 않습니다.

10

정수

camel.hystrix.group-key

사용할 그룹 키를 설정합니다. 기본값은 CamelHystrix입니다.

CamelHystrix

문자열

camel.hystrix.keep-alive-time

ThreadPoolExecutor#setKeepAliveTime(long,TimeUnit)에 전달되는 Keep-alive 시간(분).

1

정수

camel.hystrix.max-queue-size

HystrixConcurrencyStrategy.getBlockingQueue(int)에서 BlockingQueue에 전달되는 최대 대기열 크기는 스레드 풀의 인스턴스화에만 영향을 미칩니다. 이를 위해 queueSizeRejectionThreshold()를 사용합니다.

-1

정수

camel.hystrix.maximum-size

ThreadPoolExecutor#setMaximumPoolSize(int)에 전달되는 최대 스레드 풀 크기입니다. 이는 HystrixCommands를 거부하지 않고 지원할 수 있는 최대 동시성 양입니다. 이 설정은 allowMaximumSizeToDivergeFromCoreSizeSize도 설정하는 경우에만 적용됩니다.

10

정수

camel.hystrix.metrics-health-snapshot-interval-in-milliseconds

성공 및 오류 백분율을 계산하고 HystrixCircuitBreaker.isOpen() 상태에 영향을 미치는 상태 스냅샷 허용 사이에 대기하는 시간(밀리초)입니다. 양이 많은 경우 오류 백분율의 지속적인 계산이 CPU 집약적이 될 수 있으므로 계산된 빈도를 제어합니다.

500

정수

camel.hystrix.metrics-rolling-percentile-bucket-size

롤링 백분율의 각 버킷에 저장된 최대 값 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-percentile-enabled

HystrixCommandMetrics 내에서 HystrixRollingPercentile을 사용하여 백분율 지표를 캡처해야 하는지 여부입니다.

true

부울

camel.hystrix.metrics-rolling-percentile-window-buckets

롤링 백분위기 창이 분할되는 버킷 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

6

정수

camel.hystrix.metrics-rolling-percentile-window-in-milliseconds

백분율로 구성된 창(밀리초)입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10000

정수

camel.hystrix.metrics-rolling-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 HystrixCommandMetrics 내부의 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-statistical-window-in-milliseconds

이 속성은 통계 롤링 창(밀리초)을 설정합니다. 스레드 풀에 대해 메트릭을 유지하는 방법입니다. 이 창은 버킷으로 나뉘어져 해당 증분으로 롤백됩니다.

10000

정수

camel.hystrix.queue-size-rejection-threshold

큐 크기 거부 임계값은 maxQueueSize에 도달하지 않은 경우에도 거부가 발생하는 인위성 최대 크기입니다. BlockingQueue의 maxQueueSize는 동적으로 변경할 수 없으며 거부에 영향을 미치는 큐 크기의 동적으로 변경을 지원하려고 하므로 수행됩니다. 이는 실행을 위한 스레드를 대기열에 추가할 때 HystrixCommand에서 사용됩니다.

5

정수

camel.hystrix.request-log-enabled

HystrixCommand 실행 및 이벤트를 HystrixRequestLog에 기록해야 하는지 여부입니다.

true

부울

camel.hystrix.thread-pool-key

사용할 스레드 풀 키를 설정합니다. 기본적으로는 groupKey가 사용하도록 구성된 것과 동일한 값을 사용합니다.

CamelHystrix

문자열

camel.hystrix.thread-pool-rolling-number-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.thread-pool-rolling-number-statistical-window-in-milliseconds

통계 롤링 창(밀리초)입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10000

정수

camel.language.constant.enabled

상수 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.constant.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.csimple.enabled

csimple 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.csimple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.exchangeproperty.enabled

exchangeProperty 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.exchangeproperty.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.file.enabled

파일 언어 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.file.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.header.enabled

헤더 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.header.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.ref.enabled

ref 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.ref.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.simple.enabled

간단한 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.simple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.tokenize.enabled

토큰화 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.tokenize.group-delimiter

그룹화할 때 사용할 구분 기호를 설정합니다. 이 값을 설정하지 않으면 토큰은 구분 기호로 사용됩니다.

 

문자열

camel.language.tokenize.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.resilience4j.automatic-transition-from-open-to-half-open-enabled

waitDurationInOpenState가 통과되면 OPEN에서 HALF_OPEN 상태로 자동 전환할 수 있습니다.

false

부울

camel.resilience4j.circuit-breaker-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreaker 인스턴스를 나타냅니다. 이 기능을 사용할 때 다른 회로 차단기 옵션을 사용하지 않습니다.

 

문자열

camel.resilience4j.config-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreakerConfig 인스턴스를 나타냅니다.

 

문자열

camel.resilience4j.configurations

추가 구성 정의를 정의합니다.

 

map

camel.resilience4j.enabled

구성 요소를 활성화합니다.

true

부울

camel.resilience4j.failure-rate-threshold

실패 비율 임계값을 백분율로 구성합니다. 실패 비율이 임계값보다 크거나 같으면 CircuitBreaker가 열기로 전환되고 쇼트 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 50입니다.

 

float

camel.resilience4j.minimum-number-of-calls

CircuitBreaker가 오류 속도를 계산할 수 있기 전에 필요한 최소 호출 수(라이딩 창 기간당)를 구성합니다. 예를 들어, minimumNumberOf>-<s가 10인 경우 실패 비율을 계산하기 전에 최소 10번의 호출을 기록해야 합니다. 9 개의 호출 만 기록 된 경우 CircuitBreaker는 모든 9 번 호출이 실패하더라도 열기 위해 전환되지 않습니다. 기본 minimumNumberOf>-<s는 100입니다.

100

정수

camel.resilience4j.permitted-number-of-calls-in-half-open-state

CircuitBreaker가 절반 열려 있을 때 허용되는 호출 수를 설정합니다. 크기는 0보다 커야 합니다. 기본값은 10입니다.

10

정수

camel.resilience4j.sliding-window-size

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 크기를 설정합니다. slidingWindowSize는 슬라이딩 창 크기를 구성합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 슬라이딩 WindowSize는 0보다 커야 합니다. minimumNumberOf>-<s는 0보다 커야 합니다. slidingWindowType이 COUNT_BASED인 경우 minimumNumberOf>-<s는 slidingWindowSize . 슬라이딩 WindowType이 TIME_BASED인 경우 원하는 항목을 선택할 수 있습니다. 기본 slidingWindowSize는 100입니다.

100

정수

camel.resilience4j.sliding-window-type

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 유형을 설정합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 기본 sliding WindowType은 COUNT_BASED입니다.

COUNT_BASED

문자열

camel.resilience4j.slow-call-duration-threshold

호출이 느리고 느린 호출 비율을 늘리는 기간 임계값(초)을 구성합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.slow-call-rate-threshold

임계값을 백분율로 구성합니다. CircuitBreaker는 호출 기간이 slowECDHEDurationThreshold Duration보다 클 때 호출 속도가 느린 것으로 간주합니다. 느린 호출의 백분율이 임계값 이상인 경우 CircuitBreaker는 열기로 전환되고 단기 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 100 백분율로, 기록된 모든 호출이 slowECDHEDurationThreshold보다 느릴 수 있음을 의미합니다.

 

float

camel.resilience4j.wait-duration-in-open-state

대기 기간(초)을 설정합니다. CircuitBreaker는 반으로 전환되기 전에 열려 있어야 하는 시간을 지정합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.writable-stack-trace-enabled

쓰기 가능한 스택 추적을 활성화합니다. false로 설정하면 Exception.getStackTrace에서 길이 배열을 0개 반환합니다. 예외의 원인이 이미 알려진 대로 회로 차단기가 열려 있을 때 로그 스팸을 줄이는 데 사용할 수 있습니다(회로 차단기는 짧은 호출임).

true

부울

camel.rest.api-component

REST API(예: swagger)로 사용할 Camel 구성 요소의 이름(예: swagger)이 명시적으로 구성되어 있지 않은 경우, REST API 문서를 서비스하고 생성하는 Camel 구성 요소가 있는지 또는 org.apache.camel.camel.spi.RestApiProcessorFactory가 레지스트리에 등록되어 있는 경우 Camel을 조회합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.api-context-path

REST API 서비스가 사용할 선행 API 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다.

 

문자열

camel.rest.api-context-route-id

REST API를 제공하는 경로에 사용할 경로 ID를 설정합니다. 이 경로는 기본적으로 자동 할당된 경로 ID를 사용합니다.

 

문자열

camel.rest.api-host

API 설명서에 특정 호스트 이름(예: swagger)을 사용하려면 생성된 호스트를 이 구성된 호스트 이름으로 덮어쓸 수 있습니다.

 

문자열

camel.rest.api-property

api 설명서(swagger)에 대한 많은 추가 속성을 구성할 수 있습니다. 예를 들어 속성 api.title을 이상적인 제품으로 설정합니다.

 

map

camel.rest.api-vendor-extension

Rest API에서 벤더 확장이 활성화되었는지 여부. 활성화하면 Camel에는 추가 정보(예: 경로 ID, 클래스 이름 등 x로 시작하는 키)로 추가 정보가 포함됩니다. API docs를 가져올 때 모든 타사 API 게이트웨이 및 도구가 vendor-extensions를 지원하는 것은 아닙니다.

false

부울

camel.rest.binding-mode

사용할 바인딩 모드를 설정합니다. 기본값은 OFF입니다.

 

RestBindingMode

camel.rest.client-request-validation

클라이언트 요청의 유효성 검사를 활성화하여 클라이언트의 Content-Type 및 Accept 헤더가 사용/생산 설정의 Rest-DSL 구성에서 지원하는지 여부를 확인합니다. 확인을 위해 이 설정을 사용할 수 있습니다. 유효성 검사 오류의 경우 HTTP 상태 코드 415 또는 406이 반환됩니다. 기본값은 false입니다.

false

부울

camel.rest.component

netty-http, jetty, 서블릿과 같이 REST 전송(consumer)에 사용할 Camel Rest 구성 요소. 명시적으로 구성된 구성 요소가 없는 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestConsumerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.component-property

사용 중인 나머지 구성 요소에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.consumer-property

사용 중인 나머지 소비자에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.context-path

REST 서비스가 사용할 선행 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다. 또는 HTTP 서버를 포함하는 camel-jetty 또는 camel-netty-http와 같은 구성 요소의 경우

 

문자열

camel.rest.cors-headers

사용자 정의 CORS 헤더를 구성할 수 있습니다.

 

map

camel.rest.data-format-property

사용 중인 데이터 형식에 대한 추가 속성 수를 구성할 수 있습니다. 예를 들어 매우 모드에서 json을 출력하려면 속성 pretty 아닌 true로 속성을 설정합니다. 옵션 앞에 있는 속성을 추가하여 JSON 또는 XML과 IN 또는 OUT 중 하나에만 사용할 수 있습니다. 접두사는 json.in. json.out. xml.in. xml.out입니다. 예를 들어 xml.out.mustBeJAXB>-< 값이 있는 키는 나가는 XML 데이터 형식일 뿐입니다. 접두사가 없는 키는 모든 상황에서 공통 키입니다.

 

map

camel.rest.enable-cors

HTTP 응답에서 CORS 헤더를 활성화할지 여부입니다. 기본값은 false입니다.

false

부울

camel.rest.endpoint-property

사용 중인 나머지 엔드포인트에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.host

REST 서비스 노출에 사용할 호스트 이름입니다.

 

문자열

camel.rest.host-name-resolver

호스트 이름이 명시적으로 구성되지 않은 경우 이 확인자는 REST 서비스에서 사용할 호스트 이름을 계산하는 데 사용됩니다.

 

RestHostNameResolver

camel.rest.json-data-format

사용할 특정 json 데이터 형식의 이름입니다. 기본적으로 json-jackson이 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.port

REST 서비스 노출에 사용할 포트 번호입니다. 서블릿 구성 요소를 사용하는 경우 사용 중인 포트 번호가 실제로 적용되는 포트 번호가 적용되지 않습니다. 예를 들어 Apache Tomcat을 사용하는 경우 Apache Karaf를 사용하는 Karaf의 HTTP 서비스는 기본적으로 8181 포트를 사용합니다. 여기에 포트 번호를 설정하는 경우에는 툴링 및 ScanSetting이 포트 번호를 알 수 있으므로 포트 번호를 서블릿 엔진이 사용하는 번호로 설정하는 것이 좋습니다.

 

문자열

camel.rest.producer-api-doc

REST 프로듀서에서 REST uri 및 쿼리 매개변수가 api 문서에 따라 유효한지 확인하는 데 사용할 API 문서(swagger api)의 위치를 설정합니다. 이를 위해서는 classpath에 camel-swagger-java를 추가해야 하며, 누락된 구성으로 인해 Camel이 시작 시 실패하고 오류를 보고할 수 있습니다. 기본적으로 api 문서의 위치는 classpath에서 로드되지만 file: 또는 http:를 사용하여 파일 또는 http URL에서 로드할 리소스를 참조할 수 있습니다.

 

문자열

camel.rest.producer-component

REST 생산자로 사용할 Camel 구성 요소의 이름을 설정합니다.

 

문자열

camel.rest.scheme

REST 서비스를 노출하는 데 사용할 스키마입니다. 일반적으로 http 또는 https가 지원됩니다. 기본값은 http입니다.

 

문자열

camel.rest.skip-binding-on-error-code

사용자 정의 HTTP 오류 코드 헤더가 있는 경우 출력에 바인딩을 건너뛸지 여부입니다. 이렇게 하면 성공 메시지가 그렇지 않으면 json / xml 등에 바인딩되지 않는 사용자 정의 오류 메시지를 빌드할 수 있습니다.

false

부울

camel.rest.use-x-forward-headers

호스트 및 관련 설정에 X-Forward 헤더를 사용할지 여부입니다. 기본값은 true입니다.

true

부울

camel.rest.xml-data-format

사용할 특정 XML 데이터 형식의 이름입니다. 기본적으로 jvncb가 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.api-context-id-pattern

CamelContext id 패턴과 일치하는 CamelContext의 재사용 서비스 API만 허용하도록 CamelContext id 패턴을 설정합니다. 패턴 이름은 현재 CamelContext에서만 일치하는 CamelContext 이름을 나타냅니다. 다른 값의 경우 패턴은 Pattern>-<er#matchPattern(String,String)의 규칙을 사용합니다.

 

문자열

camel.rest.api-context-listing

JVM에서 REST 서비스를 사용하는 사용 가능한 모든 CamelContext의 목록이 활성화되었는지 여부를 더 이상 사용되지 않는 세트입니다. 활성화하면 이러한 컨텍스트를 검색할 수 있는 경우 false인 경우 현재 CamelContext만 사용 중입니다.

false

부울

75장. tokenize

토큰라이저 언어는 camel-core 의 내장 언어이며, 토큰 기반 전략을 사용하여 메시지를 분할 하기 위해 분할 EIP와 함께 가장 자주 사용됩니다.

tokenizer 언어는 지정된 구분 기호 패턴을 사용하여 텍스트 문서를 토큰화하는 것입니다. 또한 일부 제한된 기능을 사용하여 XML 문서를 토큰화하는 데 사용할 수도 있습니다. 진정한 XML 인식 토큰화를 위해 XML 토큰화 언어를 사용하는 것이 XML 문서의 경우 더 빠르고 효율적인 토큰화 기능을 제공하기 때문에 권장됩니다.

75.1. 토큰화 옵션

Tokenize 언어는 아래에 나열된 11 가지 옵션을 지원합니다.

이름DefaultJava Type설명

token

 

문자열

tokenizer(예: 새 줄 토큰을 사용할 수 있음) 토큰이 필요합니다. 간단한 언어를 토큰으로 사용하여 동적 토큰을 지원할 수 있습니다.

endToken

 

문자열

시작/엔드 토큰 쌍을 사용하는 경우 tokenizer로 사용할 종료 토큰입니다. 간단한 언어를 토큰으로 사용하여 동적 토큰을 지원할 수 있습니다.

inheritNamespaceTagName

 

문자열

XML을 사용할 때 루트/parent 태그 이름에서 네임스페이스를 상속하려면 간단한 언어를 태그 이름으로 사용하여 동적 이름을 지원할 수 있습니다.

headerName

 

문자열

메시지 본문을 사용하는 대신 토큰화할 헤더의 이름입니다.

regex

 

부울

토큰이 정규식 패턴인 경우 기본값은 false입니다.

xml

 

부울

입력이 XML 메시지인지 여부입니다. XML 페이로드로 작업하는 경우 이 옵션을 true로 설정해야 합니다.

includeTokens

 

부울

쌍을 사용할 때 부분에 토큰을 포함할지 여부입니다. 기본값은 false입니다.

group

 

문자열

예를 들어, n 부분을 그룹화하려면 큰 파일을 1000 줄의 청크로 분할합니다. 간단한 언어를 그룹으로 사용하여 동적 그룹 크기를 지원할 수 있습니다.

groupDelimiter

 

문자열

그룹화할 때 사용할 구분 기호를 설정합니다. 이 값을 설정하지 않으면 토큰은 구분 기호로 사용됩니다.

skipFirst

 

부울

첫 번째 요소를 건너뜁니다.

trim

 

부울

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

75.2. 예제

다음 예제에서는 직접:a 끝점에서 요청을 가져온 다음 표현식 을 사용하여 조각으로 분할한 다음 각 조각을 direct:b로 전달하는 방법을 보여줍니다.

<route>
  <from uri="direct:a"/>
  <split>
    <tokenize token="\n"/>
    <to uri="direct:b"/>
  </split>
</route>

Java DSL의 경우:

from("direct:a")
    .split(body().tokenize("\n"))
        .to("direct:b");

75.3. 예를 들면 다음과 같습니다.

자세한 내용은 분할 EIP를 참조하십시오.

75.4. Spring Boot Auto-Configuration

Spring Boot로 tokenize를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-core-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.cloud.consul.service-discovery.acl-token

Consul과 함께 사용할 ACL 토큰을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.block-seconds

감시 이벤트를 대기하는 시간(기본값: 10초)입니다.

10

정수

camel.cloud.consul.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.consul.service-discovery.connect-timeout-millis

OkHttpClient에 대한 연결 시간 초과입니다.

 

long

camel.cloud.consul.service-discovery.datacenter

데이터 센터입니다.

 

문자열

camel.cloud.consul.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.consul.service-discovery.password

기본 인증에 사용할 암호를 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.consul.service-discovery.read-timeout-millis

OkHttpClient에 대한 시간 초과를 읽습니다.

 

long

camel.cloud.consul.service-discovery.url

Consul 에이전트 URL입니다.

 

문자열

camel.cloud.consul.service-discovery.user-name

기본 인증에 사용할 사용자 이름을 설정합니다.

 

문자열

camel.cloud.consul.service-discovery.write-timeout-millis

OkHttpClient에 대한 쓰기 시간 초과입니다.

 

long

camel.cloud.dns.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.dns.service-discovery.domain

도메인 이름;.

 

문자열

camel.cloud.dns.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.dns.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.dns.service-discovery.proto

원하는 서비스의 전송 프로토콜입니다.

_tcp

문자열

camel.cloud.etcd.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.etcd.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.etcd.service-discovery.password

기본 인증에 사용할 암호입니다.

 

문자열

camel.cloud.etcd.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.etcd.service-discovery.service-path

서비스 검색을 찾는 경로입니다.

/services/

문자열

camel.cloud.etcd.service-discovery.timeout

작업을 완료하는 데 사용할 수 있는 최대 시간을 설정하려면 다음을 수행하십시오.

 

long

camel.cloud.etcd.service-discovery.type

검색 유형을 설정하려면 유효한 값이 온 디맨드 및 감시입니다.

On-demand

문자열

camel.cloud.etcd.service-discovery.uris

클라이언트가 연결할 수 있는 URI입니다.

 

문자열

camel.cloud.etcd.service-discovery.user-name

기본 인증에 사용할 사용자 이름입니다.

 

문자열

camel.cloud.kubernetes.service-discovery.api-version

클라이언트 조회를 사용할 때 API 버전을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-data

클라이언트 조회를 사용할 때 인증 기관 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.ca-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 Certificate Authority 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-data

클라이언트 조회를 사용할 때 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-cert-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 인증서 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-algo

클라이언트 조회를 사용할 때 RSA와 같은 Client Keystore 알고리즘을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-data

클라이언트 조회를 사용할 때 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-file

클라이언트 조회를 사용할 때 파일에서 로드되는 클라이언트 키 저장소 데이터를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.client-key-passphrase

클라이언트 조회를 사용할 때 클라이언트 키 저장소 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.kubernetes.service-discovery.dns-domain

DNS 조회에 사용할 DNS 도메인을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.kubernetes.service-discovery.lookup

서비스 조회를 수행하는 방법 가능한 값: client, dns, environment. 클라이언트를 사용하는 경우 클라이언트는 kubernetes 마스터를 쿼리하여 서비스를 제공하는 활성 Pod 목록을 가져온 다음 Pod를 무작위(또는 라운드 로빈)합니다. dns를 사용하면 서비스 이름이 name.namespace.svc.dnsDomain으로 확인됩니다. dnssrv를 사용하는 경우 . …​svc…​의 SRV 쿼리로 서비스 이름이 확인됩니다 .환경을 사용하는 경우 서비스를 조회하는 데 환경 변수를 사용합니다. 기본적으로 환경이 사용됩니다.

환경

문자열

camel.cloud.kubernetes.service-discovery.master-url

클라이언트 조회를 사용할 때 URL을 마스터로 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.namespace

사용할 네임스페이스를 설정합니다. 기본적으로 ENV 변수 KUBERNETES_MASTER의 네임스페이스를 사용합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.oauth-token

클라이언트 조회를 사용할 때 인증을 위해 OAUTH 토큰(사용자 이름/암호 대신)을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.password

클라이언트 조회를 사용할 때 인증 암호를 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-name

DNS/DNSSRV 조회에 사용할 포트 이름을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.port-protocol

DNS/DNSSRV 조회에 사용할 포트 프로토콜을 설정합니다.

 

문자열

camel.cloud.kubernetes.service-discovery.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.kubernetes.service-discovery.trust-certs

클라이언트 조회를 사용할 때 신뢰 인증서 검사를 설정할지 여부를 설정합니다.

false

부울

camel.cloud.kubernetes.service-discovery.username

클라이언트 조회를 사용할 때 인증에 대한 사용자 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.client-name

Ribbon 클라이언트 이름을 설정합니다.

 

문자열

camel.cloud.ribbon.load-balancer.configurations

추가 구성 정의를 정의합니다.

 

map

camel.cloud.ribbon.load-balancer.enabled

구성 요소를 활성화합니다.

true

부울

camel.cloud.ribbon.load-balancer.namespace

네임스페이스입니다.

 

문자열

camel.cloud.ribbon.load-balancer.password

암호입니다.

 

문자열

camel.cloud.ribbon.load-balancer.properties

사용할 클라이언트 속성을 설정합니다. 이러한 속성은 사용 중인 서비스 호출 구현에 따라 다릅니다. 예를 들어 windows를 사용하는 경우 클라이언트 속성은 com.netflix.client.config.CommonClientConfigKey에 정의됩니다.

 

map

camel.cloud.ribbon.load-balancer.username

사용자 이름입니다.

 

문자열

camel.hystrix.allow-maximum-size-to-diverge-from-core-size

최대Size 설정을 적용할 수 있습니다. 그런 다음 해당 값은 coreSize보다 크거나 같을 수 있습니다.

false

부울

camel.hystrix.circuit-breaker-enabled

HystrixCircuitBreaker 사용 여부입니다. false인 경우 회로 차단기 논리가 사용되지 않고 모든 요청이 허용됩니다. 이는 circuitBreakerForceECDHEd()와 유사하지만 메트릭을 계속 추적하고 공개/닫어야 하는지 여부를 알고 있기 때문에 회로 교체를 인스턴스화하지 않습니다.

true

부울

camel.hystrix.circuit-breaker-error-threshold-percentage

오류 백분율 임계값(50과 같은 정수)은 회로 차단기가 열려 있고 요청을 거부합니다. 이는 circuitBreakerSleepWindowInMilliseconds에 정의된 기간 동안 트립을 유지합니다. 오류 비율은 HystrixCommandMetrics.getHealthCounts()와 비교됩니다.

50

정수

camel.hystrix.circuit-breaker-force-closed

true인 경우 HystrixCircuitBreaker#allowRequest()는 HystrixCommandMetrics.getHealthCounts()의 오류 백분율에 관계없이 요청을 허용하도록 항상 true를 반환합니다. circuitBreakerForceOpen() 속성이 우선하므로 true로 설정하면 이 속성이 아무 작업도 수행하지 않습니다.

false

부울

camel.hystrix.circuit-breaker-force-open

true인 경우 HystrixCircuitBreaker.allowRequest()는 항상 false를 반환하므로 회로가 열려 있고 모든 요청을 거부합니다. 이 속성은 circuitBreakerForce 10.0.0.1d()보다 우선합니다.

false

부울

camel.hystrix.circuit-breaker-request-volume-threshold

HystrixCircuitBreaker가 이동하기 전에 존재해야 하는 metricsRollingStatisticalWindowInMilliseconds()의 최소 요청 수입니다. 이 숫자 아래에 있는 경우 회로는 오류 백분율에 관계없이 이동하지 않습니다.

20

정수

camel.hystrix.circuit-breaker-sleep-window-in-milliseconds

HystrixCircuitBreaker 트립션이 열린 후 다시 요청을 시도하기 전에 대기해야 하는 시간(밀리초)입니다.

5000

정수

camel.hystrix.configurations

추가 구성 정의를 정의합니다.

 

map

camel.hystrix.core-pool-size

java.util.concurrent.ThreadPoolExecutor#setCorePoolSize(int)에 전달되는 코어 스레드 풀 크기입니다.

10

정수

camel.hystrix.enabled

구성 요소를 활성화합니다.

true

부울

camel.hystrix.execution-isolation-semaphore-max-concurrent-requests

HystrixCommand.run()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 거부됩니다. 실행IsolationStrategy == SEMAPHORE 경우에만 적용됩니다.

20

정수

camel.hystrix.execution-isolation-strategy

을 사용하여 격리 전략 HystrixCommand.run()를 실행합니다. THREAD가 별도의 스레드에서 실행되고 스레드 풀의 스레드 수에 따라 제한되는 동시 요청이 실행됩니다. SEMAPHORE는 호출 스레드와 세마포 수에 의해 제한되는 동시 요청에서 실행됩니다.

THREAD

문자열

camel.hystrix.execution-isolation-thread-interrupt-on-timeout

스레드가 시간 초과될 때 실행 스레드에서 인터럽트를 시도해야 하는지 여부입니다. whether the execution thread should attempt an interrupt (using an interrupt#cancel ) when a thread times out. executionIsolationStrategy() == THREAD 경우에만 적용됩니다.

true

부울

camel.hystrix.execution-timeout-enabled

이 명령에 시간 초과 메커니즘이 활성화되었는지 여부.

true

부울

camel.hystrix.execution-timeout-in-milliseconds

명령이 시간 초과되고 실행을 중지하는 시간(밀리초)입니다. executionIsolationThreadInterruptOnTimeout == true 및 명령이 thread-isolated인 경우 실행 중인 스레드가 중단됩니다. 명령이 세마포 분리 및 HystrixObservableCommand인 경우 해당 명령은 구독 해제됩니다.

1000

정수

camel.hystrix.fallback-enabled

오류가 발생할 때 HystrixCommand.getFallback()을 시도해야 하는지 여부

true

부울

camel.hystrix.fallback-isolation-semaphore-max-concurrent-requests

HystrixCommand.getFallback()에 허용된 동시 요청 수입니다. 동시 제한을 초과하는 요청은 빠르게 실패하며 폴백 검색을 시도하지 않습니다.

10

정수

camel.hystrix.group-key

사용할 그룹 키를 설정합니다. 기본값은 CamelHystrix입니다.

CamelHystrix

문자열

camel.hystrix.keep-alive-time

ThreadPoolExecutor#setKeepAliveTime(long,TimeUnit)에 전달되는 Keep-alive 시간(분).

1

정수

camel.hystrix.max-queue-size

HystrixConcurrencyStrategy.getBlockingQueue(int)에서 BlockingQueue에 전달되는 최대 대기열 크기는 스레드 풀의 인스턴스화에만 영향을 미칩니다. 이를 위해 queueSizeRejectionThreshold()를 사용합니다.

-1

정수

camel.hystrix.maximum-size

ThreadPoolExecutor#setMaximumPoolSize(int)에 전달되는 최대 스레드 풀 크기입니다. 이는 HystrixCommands를 거부하지 않고 지원할 수 있는 최대 동시성 양입니다. 이 설정은 allowMaximumSizeToDivergeFromCoreSizeSize도 설정하는 경우에만 적용됩니다.

10

정수

camel.hystrix.metrics-health-snapshot-interval-in-milliseconds

성공 및 오류 백분율을 계산하고 HystrixCircuitBreaker.isOpen() 상태에 영향을 미치는 상태 스냅샷 허용 사이에 대기하는 시간(밀리초)입니다. 양이 많은 경우 오류 백분율의 지속적인 계산이 CPU 집약적이 될 수 있으므로 계산된 빈도를 제어합니다.

500

정수

camel.hystrix.metrics-rolling-percentile-bucket-size

롤링 백분율의 각 버킷에 저장된 최대 값 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-percentile-enabled

HystrixCommandMetrics 내에서 HystrixRollingPercentile을 사용하여 백분율 지표를 캡처해야 하는지 여부입니다.

true

부울

camel.hystrix.metrics-rolling-percentile-window-buckets

롤링 백분위기 창이 분할되는 버킷 수입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

6

정수

camel.hystrix.metrics-rolling-percentile-window-in-milliseconds

백분율로 구성된 창(밀리초)입니다. 이는 HystrixRollingPercentile 내부 HystrixCommandMetrics로 전달됩니다.

10000

정수

camel.hystrix.metrics-rolling-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 HystrixCommandMetrics 내부의 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.metrics-rolling-statistical-window-in-milliseconds

이 속성은 통계 롤링 창(밀리초)을 설정합니다. 스레드 풀에 대해 메트릭을 유지하는 방법입니다. 이 창은 버킷으로 나뉘어져 해당 증분으로 롤백됩니다.

10000

정수

camel.hystrix.queue-size-rejection-threshold

큐 크기 거부 임계값은 maxQueueSize에 도달하지 않은 경우에도 거부가 발생하는 인위성 최대 크기입니다. BlockingQueue의 maxQueueSize는 동적으로 변경할 수 없으며 거부에 영향을 미치는 큐 크기의 동적으로 변경을 지원하려고 하므로 수행됩니다. 이는 실행을 위한 스레드를 대기열에 추가할 때 HystrixCommand에서 사용됩니다.

5

정수

camel.hystrix.request-log-enabled

HystrixCommand 실행 및 이벤트를 HystrixRequestLog에 기록해야 하는지 여부입니다.

true

부울

camel.hystrix.thread-pool-key

사용할 스레드 풀 키를 설정합니다. 기본적으로는 groupKey가 사용하도록 구성된 것과 동일한 값을 사용합니다.

CamelHystrix

문자열

camel.hystrix.thread-pool-rolling-number-statistical-window-buckets

롤링 통계 창이 분할되는 버킷 수입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10

정수

camel.hystrix.thread-pool-rolling-number-statistical-window-in-milliseconds

통계 롤링 창(밀리초)입니다. 이는 각 HystrixThreadPoolMetrics 인스턴스 내에서 HystrixRollingNumber에 전달됩니다.

10000

정수

camel.language.constant.enabled

상수 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.constant.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.csimple.enabled

csimple 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.csimple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.exchangeproperty.enabled

exchangeProperty 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.exchangeproperty.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.file.enabled

파일 언어 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.file.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.header.enabled

헤더 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.header.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.ref.enabled

ref 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.ref.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.simple.enabled

간단한 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.simple.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.language.tokenize.enabled

토큰화 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.tokenize.group-delimiter

그룹화할 때 사용할 구분 기호를 설정합니다. 이 값을 설정하지 않으면 토큰은 구분 기호로 사용됩니다.

 

문자열

camel.language.tokenize.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

camel.resilience4j.automatic-transition-from-open-to-half-open-enabled

waitDurationInOpenState가 통과되면 OPEN에서 HALF_OPEN 상태로 자동 전환할 수 있습니다.

false

부울

camel.resilience4j.circuit-breaker-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreaker 인스턴스를 나타냅니다. 이 기능을 사용할 때 다른 회로 차단기 옵션을 사용하지 않습니다.

 

문자열

camel.resilience4j.config-ref

레지스트리에서 조회하고 사용할 기존 io.github.resilience4j.circuitbreaker.CircuitBreakerConfig 인스턴스를 나타냅니다.

 

문자열

camel.resilience4j.configurations

추가 구성 정의를 정의합니다.

 

map

camel.resilience4j.enabled

구성 요소를 활성화합니다.

true

부울

camel.resilience4j.failure-rate-threshold

실패 비율 임계값을 백분율로 구성합니다. 실패 비율이 임계값보다 크거나 같으면 CircuitBreaker가 열기로 전환되고 쇼트 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 50입니다.

 

float

camel.resilience4j.minimum-number-of-calls

CircuitBreaker가 오류 속도를 계산할 수 있기 전에 필요한 최소 호출 수(라이딩 창 기간당)를 구성합니다. 예를 들어, minimumNumberOf>-<s가 10인 경우 실패 비율을 계산하기 전에 최소 10번의 호출을 기록해야 합니다. 9 개의 호출 만 기록 된 경우 CircuitBreaker는 모든 9 번 호출이 실패하더라도 열기 위해 전환되지 않습니다. 기본 minimumNumberOf>-<s는 100입니다.

100

정수

camel.resilience4j.permitted-number-of-calls-in-half-open-state

CircuitBreaker가 절반 열려 있을 때 허용되는 호출 수를 설정합니다. 크기는 0보다 커야 합니다. 기본값은 10입니다.

10

정수

camel.resilience4j.sliding-window-size

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 크기를 설정합니다. slidingWindowSize는 슬라이딩 창 크기를 구성합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 슬라이딩 WindowSize는 0보다 커야 합니다. minimumNumberOf>-<s는 0보다 커야 합니다. slidingWindowType이 COUNT_BASED인 경우 minimumNumberOf>-<s는 slidingWindowSize . 슬라이딩 WindowType이 TIME_BASED인 경우 원하는 항목을 선택할 수 있습니다. 기본 slidingWindowSize는 100입니다.

100

정수

camel.resilience4j.sliding-window-type

CircuitBreaker가 닫힐 때 호출 결과를 기록하는 데 사용되는 슬라이딩 창의 유형을 설정합니다. Sliding 창은 계산 기반 또는 시간 기반일 수 있습니다. slidingWindowType이 COUNT_BASED인 경우 마지막 slidingWindowSize 호출이 기록되고 집계됩니다. slidingWindowType이 TIME_BASED인 경우 마지막 slidingWindowSize 초의 호출이 기록되고 집계됩니다. 기본 sliding WindowType은 COUNT_BASED입니다.

COUNT_BASED

문자열

camel.resilience4j.slow-call-duration-threshold

호출이 느리고 느린 호출 비율을 늘리는 기간 임계값(초)을 구성합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.slow-call-rate-threshold

임계값을 백분율로 구성합니다. CircuitBreaker는 호출 기간이 slowECDHEDurationThreshold Duration보다 클 때 호출 속도가 느린 것으로 간주합니다. 느린 호출의 백분율이 임계값 이상인 경우 CircuitBreaker는 열기로 전환되고 단기 호출을 시작합니다. 임계값이 0보다 커야 하며 100보다 크지 않아야 합니다. 기본값은 100 백분율로, 기록된 모든 호출이 slowECDHEDurationThreshold보다 느릴 수 있음을 의미합니다.

 

float

camel.resilience4j.wait-duration-in-open-state

대기 기간(초)을 설정합니다. CircuitBreaker는 반으로 전환되기 전에 열려 있어야 하는 시간을 지정합니다. 기본값은 60초입니다.

60

정수

camel.resilience4j.writable-stack-trace-enabled

쓰기 가능한 스택 추적을 활성화합니다. false로 설정하면 Exception.getStackTrace에서 길이 배열을 0개 반환합니다. 예외의 원인이 이미 알려진 대로 회로 차단기가 열려 있을 때 로그 스팸을 줄이는 데 사용할 수 있습니다(회로 차단기는 짧은 호출임).

true

부울

camel.rest.api-component

REST API(예: swagger)로 사용할 Camel 구성 요소의 이름(예: swagger)이 명시적으로 구성되어 있지 않은 경우, REST API 문서를 서비스하고 생성하는 Camel 구성 요소가 있는지 또는 org.apache.camel.camel.spi.RestApiProcessorFactory가 레지스트리에 등록되어 있는 경우 Camel을 조회합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.api-context-path

REST API 서비스가 사용할 선행 API 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다.

 

문자열

camel.rest.api-context-route-id

REST API를 제공하는 경로에 사용할 경로 ID를 설정합니다. 이 경로는 기본적으로 자동 할당된 경로 ID를 사용합니다.

 

문자열

camel.rest.api-host

API 설명서에 특정 호스트 이름(예: swagger)을 사용하려면 생성된 호스트를 이 구성된 호스트 이름으로 덮어쓸 수 있습니다.

 

문자열

camel.rest.api-property

api 설명서(swagger)에 대한 많은 추가 속성을 구성할 수 있습니다. 예를 들어 속성 api.title을 이상적인 제품으로 설정합니다.

 

map

camel.rest.api-vendor-extension

Rest API에서 벤더 확장이 활성화되었는지 여부. 활성화하면 Camel에는 추가 정보(예: 경로 ID, 클래스 이름 등 x로 시작하는 키)로 추가 정보가 포함됩니다. API docs를 가져올 때 모든 타사 API 게이트웨이 및 도구가 vendor-extensions를 지원하는 것은 아닙니다.

false

부울

camel.rest.binding-mode

사용할 바인딩 모드를 설정합니다. 기본값은 OFF입니다.

 

RestBindingMode

camel.rest.client-request-validation

클라이언트 요청의 유효성 검사를 활성화하여 클라이언트의 Content-Type 및 Accept 헤더가 사용/생산 설정의 Rest-DSL 구성에서 지원하는지 여부를 확인합니다. 확인을 위해 이 설정을 사용할 수 있습니다. 유효성 검사 오류의 경우 HTTP 상태 코드 415 또는 406이 반환됩니다. 기본값은 false입니다.

false

부울

camel.rest.component

netty-http, jetty, 서블릿과 같이 REST 전송(consumer)에 사용할 Camel Rest 구성 요소. 명시적으로 구성된 구성 요소가 없는 경우 Camel은 Rest DSL과 통합되는 Camel 구성 요소가 있거나 org.apache.camel.spi.RestConsumerFactory가 레지스트리에 등록되어 있는지 확인합니다. 이 중 하나라도 발견되면 해당 항목이 사용됩니다.

 

문자열

camel.rest.component-property

사용 중인 나머지 구성 요소에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.consumer-property

사용 중인 나머지 소비자에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.context-path

REST 서비스가 사용할 선행 컨텍스트 경로를 설정합니다. 이는 배포된 웹 애플리케이션이 context-path를 사용하여 배포되는 camel-servlet과 같은 구성 요소를 사용할 때 사용할 수 있습니다. 또는 HTTP 서버를 포함하는 camel-jetty 또는 camel-netty-http와 같은 구성 요소의 경우

 

문자열

camel.rest.cors-headers

사용자 정의 CORS 헤더를 구성할 수 있습니다.

 

map

camel.rest.data-format-property

사용 중인 데이터 형식에 대한 추가 속성 수를 구성할 수 있습니다. 예를 들어 매우 모드에서 json을 출력하려면 속성 pretty 아닌 true로 속성을 설정합니다. 옵션 앞에 있는 속성을 추가하여 JSON 또는 XML과 IN 또는 OUT 중 하나에만 사용할 수 있습니다. 접두사는 json.in. json.out. xml.in. xml.out입니다. 예를 들어 xml.out.mustBeJAXB>-< 값이 있는 키는 나가는 XML 데이터 형식일 뿐입니다. 접두사가 없는 키는 모든 상황에서 공통 키입니다.

 

map

camel.rest.enable-cors

HTTP 응답에서 CORS 헤더를 활성화할지 여부입니다. 기본값은 false입니다.

false

부울

camel.rest.endpoint-property

사용 중인 나머지 엔드포인트에 대한 추가 속성 수를 구성할 수 있습니다.

 

map

camel.rest.host

REST 서비스 노출에 사용할 호스트 이름입니다.

 

문자열

camel.rest.host-name-resolver

호스트 이름이 명시적으로 구성되지 않은 경우 이 확인자는 REST 서비스에서 사용할 호스트 이름을 계산하는 데 사용됩니다.

 

RestHostNameResolver

camel.rest.json-data-format

사용할 특정 json 데이터 형식의 이름입니다. 기본적으로 json-jackson이 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.port

REST 서비스 노출에 사용할 포트 번호입니다. 서블릿 구성 요소를 사용하는 경우 사용 중인 포트 번호가 실제로 적용되는 포트 번호가 적용되지 않습니다. 예를 들어 Apache Tomcat을 사용하는 경우 Apache Karaf를 사용하는 Karaf의 HTTP 서비스는 기본적으로 8181 포트를 사용합니다. 여기에 포트 번호를 설정하는 경우에는 툴링 및 ScanSetting이 포트 번호를 알 수 있으므로 포트 번호를 서블릿 엔진이 사용하는 번호로 설정하는 것이 좋습니다.

 

문자열

camel.rest.producer-api-doc

REST 프로듀서에서 REST uri 및 쿼리 매개변수가 api 문서에 따라 유효한지 확인하는 데 사용할 API 문서(swagger api)의 위치를 설정합니다. 이를 위해서는 classpath에 camel-swagger-java를 추가해야 하며, 누락된 구성으로 인해 Camel이 시작 시 실패하고 오류를 보고할 수 있습니다. 기본적으로 api 문서의 위치는 classpath에서 로드되지만 file: 또는 http:를 사용하여 파일 또는 http URL에서 로드할 리소스를 참조할 수 있습니다.

 

문자열

camel.rest.producer-component

REST 생산자로 사용할 Camel 구성 요소의 이름을 설정합니다.

 

문자열

camel.rest.scheme

REST 서비스를 노출하는 데 사용할 스키마입니다. 일반적으로 http 또는 https가 지원됩니다. 기본값은 http입니다.

 

문자열

camel.rest.skip-binding-on-error-code

사용자 정의 HTTP 오류 코드 헤더가 있는 경우 출력에 바인딩을 건너뛸지 여부입니다. 이렇게 하면 성공 메시지가 그렇지 않으면 json / xml 등에 바인딩되지 않는 사용자 정의 오류 메시지를 빌드할 수 있습니다.

false

부울

camel.rest.use-x-forward-headers

호스트 및 관련 설정에 X-Forward 헤더를 사용할지 여부입니다. 기본값은 true입니다.

true

부울

camel.rest.xml-data-format

사용할 특정 XML 데이터 형식의 이름입니다. 기본적으로 jvncb가 사용됩니다. 중요: 이 옵션은 기존 데이터 형식 인스턴스를 참조하지 않고 데이터 형식의 사용자 지정 이름을 설정하는 경우에만 해당합니다.

 

문자열

camel.rest.api-context-id-pattern

CamelContext id 패턴과 일치하는 CamelContext의 재사용 서비스 API만 허용하도록 CamelContext id 패턴을 설정합니다. 패턴 이름은 현재 CamelContext에서만 일치하는 CamelContext 이름을 나타냅니다. 다른 값의 경우 패턴은 Pattern>-<er#matchPattern(String,String)의 규칙을 사용합니다.

 

문자열

camel.rest.api-context-listing

JVM에서 REST 서비스를 사용하는 사용 가능한 모든 CamelContext의 목록이 활성화되었는지 여부를 더 이상 사용되지 않는 세트입니다. 활성화하면 이러한 컨텍스트를 검색할 수 있는 경우 false인 경우 현재 CamelContext만 사용 중입니다.

false

부울

76장. XML Tokenize

XML Tokenize 언어는 XML 문서를 효율적이고 효과적으로 토큰화하기 위해 Split EIP와 함께 사용할 수 있는 진정한 XML 인식 토큰라이저인 camel-xml-jaxp 의 내장 언어입니다.

XML Tokenize는 문서의 XML 네임스페이스 및 계층 구조뿐만 아니라 기존 토큰화 언어보다 XML 문서를 더 효율적으로 토큰화할 수 있습니다.

추가 종속성

이 구성 요소를 사용하려면 다음과 같이 추가 종속성이 필요합니다.

<dependency>
    <groupId>org.codehaus.woodstox</groupId>
    <artifactId>woodstox-core-asl</artifactId>
    <version>4.4.1</version>
</dependency>

또는

    <dependency>
      <groupId>org.apache.camel.springboot</groupId>
      <artifactId>camel-stax-starter</artifactId>
    </dependency>

76.1. XML Tokenizer 옵션

XML Tokenize 언어는 아래에 나열된 4가지 옵션을 지원합니다.

이름DefaultJava Type설명

headerName

 

문자열

메시지 본문을 사용하는 대신 토큰화할 헤더의 이름입니다.

mode

 

Enum

추출 모드입니다. 사용 가능한 추출 모드는 다음과 같습니다. i - 컨텍스트 네임스페이스 바인딩을 추출된 토큰(기본)에 삽입할 수 있습니다. - 추출된 토큰을 하위 콘텐츠로 래핑 해제 - 지정된 요소의 텍스트 콘텐츠를 추출합니다.

CloudEvent 값:

  • i
  • w
  • u
  • t

group

 

정수

N 개의 파트를 그룹화합니다.

trim

 

부울

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

76.2. 예제

XML Tokenize 언어를 사용하는 예제가 있는 분할 EIP를 참조하십시오.

76.3. Spring Boot Auto-Configuration

Spring Boot와 함께 xtokenize를 사용하는 경우 다음과 같은 Maven 종속성을 사용하여 자동 구성을 지원해야 합니다.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-xml-jaxp-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

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

이름설명Default유형

camel.language.xtokenize.enabled

xtokenize 언어의 자동 구성을 활성화할지 여부입니다. 이는 기본적으로 활성화되어 있습니다.

 

부울

camel.language.xtokenize.mode

추출 모드입니다. 사용 가능한 추출 모드는 다음과 같습니다. i - 컨텍스트 네임스페이스 바인딩을 추출된 토큰(기본)에 삽입할 수 있습니다. - 추출된 토큰을 하위 콘텐츠로 래핑 해제 - 지정된 요소의 텍스트 콘텐츠를 추출합니다.

 

문자열

camel.language.xtokenize.trim

선행 공백 및 후행 공백 및 줄 바꿈을 제거하는 값을 트리밍할지 여부입니다.

true

부울

77장. XPath

Camel은 DSL 에서 표현식 또는 Predicate 를 사용할 수 있도록 case를 지원합니다.

예를 들어, iPXE를 사용하여 메시지 필터에 서술자를 생성하거나 수신자 목록 표현식으로 만들 수 있습니다.

77.1. CloudEvent 언어 옵션

ECDHE 언어는 아래에 나열된 10 가지 옵션을 지원합니다.

이름DefaultJava Type설명

documentType

 

문자열

문서 유형의 클래스 이름: 기본값은 org.w3c.dom.Document입니다.

resultType

 

Enum

결과 유형(출력에서 유형)의 클래스 이름을 설정합니다. 기본값은 NodeSet입니다.

CloudEvent 값:

  • NUMBER
  • 문자열
  • 부울
  • NODESET
  • 노드

saxon

 

부울

saxon을 사용할지 여부입니다.

factoryRef

 

문자열

레지스트리의 조회에 대한 사용자 정의 gRPCFactory에 대한 참조입니다.

objectModel

 

문자열

사용할ECDHE 오브젝트 모델입니다.

logNamespaces

 

부울

문제 해결 중에 지원할 수 있는 네임스페이스를 기록할지 여부입니다.

headerName

 

문자열

메시지 본문 대신 입력으로 사용할 헤더 이름입니다.

threadSafety

 

부울

xpath 표현식의 반환된 결과에 대해 thread-safety를 활성화할지 여부입니다. 이는 NODESET을 결과 유형으로 사용할 때 적용되며 반환된 세트에는 여러 개의 요소가 있습니다. 이 상황에서는 동일한 처리 모드에서 Camel Splitter EIP와 같은 NODESET을 동시에 처리하는 경우 스레드로부터 안전한 문제가 발생할 수 있습니다. 이 옵션은 노드의 보호 사본을 수행하여 동시성 문제를 방지합니다. 애플리케이션에서 camel-s Galaxyon 또는 texon을 사용하는 경우 이 옵션을 켜는 것이 좋습니다. saxon에는 이 옵션을 켜서 방지할 수 있는 스레드 안전 문제가 있습니다.

preCompile

 

부울

초기화 단계에서 xpath 표현식을 사전 컴파일할지 여부입니다. 기본적으로 미리 컴파일이 활성화됩니다. 예를 들어 애플리케이션이 컴파일된 시간(예: camel-quarkus)보다 앞당기면(예: build 운영 체제의 xpath 팩토리)을 로드하고 JVM 런타임이 아닌 경우 컴파일 단계를 끄는 데 사용할 수 있습니다.

trim

 

부울

77.2.

77.3.

77.3.1.

77.3.2.

77.4. 함수

함수인수유형설명

in:body

none

개체

개체

none

개체

개체

문자열

개체

참고

77.4.1.

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
       http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
       http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd">

  <camelContext id="camel" xmlns="http://activemq.apache.org/camel/schema/spring"
                xmlns:foo="http://example.com/person">
    <route>
      <from uri="activemq:MyQueue"/>
      <filter>
        <xpath>/foo:person[@name='James']</xpath>
        <to uri="mqseries:SomeOtherQueue"/>
      </filter>
    </route>
  </camelContext>
</beans>

77.5.

from("queue:foo").
  filter().xpath("//foo")).
  to("queue:bar")
from("queue:foo").
  choice().xpath("//foo")).to("queue:bar").
  otherwise().to("queue:others");

77.6.

In Java DSL:

xpath("/foo:person/@id", String.class)

<xpath resultType="java.lang.String">/foo:person/@id</xpath>
참고

@XPath(value = "concat('foo-',//order/name/)", resultType = String.class) String name)

77.7.

<xpath headerName="invoiceDetails">/invoice/@orderType = 'premium'</xpath>

xpath("/invoice/@orderType = 'premium'", "invoiceDetails")

77.8. 예제

from("direct:start")
    .filter().xpath("/person[@name='James']")
        .to("mock:result");

<route>
  <from uri="direct:start"/>
  <filter>
    <xpath>/person[@name='James']</xpath>
    <to uri="mock:result"/>
  </filter>
</route>

77.9.

Namespaces ns = new Namespaces("c", "http://acme.com/cheese");

from("direct:start")
    .filter(xpath("/c:person[@name='James']", ns))
        .to("mock:result");

/c:person[@name='James']

Namespaces ns = new Namespaces("c", "http://acme.com/cheese")
                     .add("w", "http://acme.com/wine")
                     .add("b", "http://acme.com/beer");

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:foo="http://example.com/person"
       xsi:schemaLocation="
       http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
       http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd
    ">

  <camelContext xmlns="http://camel.apache.org/schema/spring">
    <route>
      <from uri="direct:start"/>
      <filter>
        <xpath logNamespaces="true">/foo:person[@name='James']</xpath>
        <to uri="mock:result"/>
      </filter>
    </route>
  </camelContext>

</beans>

77.10.

참고

public class Foo {

    @Consume(uri = "activemq:my.queue")
    public void doSomething(@XPath("/person/@name") String name, String xml) {
        // process the inbound message here
    }
}

77.11.

boolean matches = XPathBuilder.xpath("/foo/bar/@xyz").matches(context, "<foo><bar xyz='cheese'/></foo>"));

String name = XPathBuilder.xpath("foo/bar").evaluate(context, "<foo><bar>cheese</bar></foo>", String.class);
Integer number = XPathBuilder.xpath("foo/bar").evaluate(context, "<foo><bar>123</bar></foo>", Integer.class);
Boolean bool = XPathBuilder.xpath("foo/bar").evaluate(context, "<foo><bar>true</bar></foo>", Boolean.class);

String name = XPathBuilder.xpath("foo/bar").evaluate(context, "<foo><bar>cheese</bar></foo>");

77.12.

77.12.1.

XPathBuilder  INFO  Using system property javax.xml.xpath.XPathFactory:http://saxon.sf.net/jaxp/xpath/om with value:
                    net.sf.saxon.xpath.XPathFactoryImpl when creating XPathFactory

-Djavax.xml.xpath.XPathFactory=org.apache.xpath.jaxp.XPathFactoryImpl

77.12.2.

<xpath factoryRef="saxonFactory" resultType="java.lang.String">current-dateTime()</xpath>

<bean id="saxonFactory" class="net.sf.saxon.xpath.XPathFactoryImpl"/>

<xpath objectModel="http://saxon.sf.net/jaxp/xpath/om" resultType="java.lang.String">current-dateTime()</xpath>

<xpath saxon="true" resultType="java.lang.String">current-dateTime()</xpath>

77.13.

77.13.1.

[me: {prefix -> namespace}, {prefix -> namespace}], [parent: [me: {prefix -> namespace}, {prefix -> namespace}], [parent: [me: {prefix -> namespace}]]]

77.13.2.

Java DSL:

XPathBuilder.xpath("/foo:person/@id", String.class).logNamespaces()

XML DSL:

<xpath logNamespaces="true" resultType="String">/foo:person/@id</xpath>

2012-01-16 13:23:45,878 [stSaxonWithFlag] INFO  XPathBuilder  - Namespaces discovered in message:
{xmlns:a=[http://apache.org/camel], DEFAULT=[http://apache.org/default],
xmlns:b=[http://apache.org/camelA, http://apache.org/camelB]}

77.14.

.setHeader("myHeader").xpath("resource:classpath:myxpath.txt", String.class)

77.15.

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-xpath</artifactId>
  <version>{CamelSBProjectVersion}</version>
</dependency>

77.16.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-xpath-starter</artifactId>
  <version>{CamelSBVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

이름설명Default유형

camel.language.xpath.document-type

 

문자열

camel.language.xpath.enabled

 

부울

camel.language.xpath.factory-ref

 

문자열

camel.language.xpath.log-namespaces

false

부울

camel.language.xpath.object-model

 

문자열

camel.language.xpath.pre-compile

true

부울

camel.language.xpath.saxon

false

부울

camel.language.xpath.thread-safety

false

부울

camel.language.xpath.trim

true

부울

78장. Openapi Java

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-openapi-java</artifactId>
    <version>{CamelSBProjectVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>

78.1.

public class UserRouteBuilder extends RouteBuilder {
    @Override
    public void configure() throws Exception {
        // configure we want to use servlet as the component for the rest DSL
        // and we enable json binding mode
        restConfiguration().component("netty-http").bindingMode(RestBindingMode.json)
            // and output using pretty print
            .dataFormatProperty("prettyPrint", "true")
            // setup context path and port number that netty will use
            .contextPath("/").port(8080)
            // add OpenApi api-doc out of the box
            .apiContextPath("/api-doc")
                .apiProperty("api.title", "User API").apiProperty("api.version", "1.2.3")
                // and enable CORS
                .apiProperty("cors", "true");

        // this user REST service is json only
        rest("/user").description("User rest service")
            .consumes("application/json").produces("application/json")
            .get("/{id}").description("Find user by id").outType(User.class)
                .param().name("id").type(path).description("The id of the user to get").dataType("int").endParam()
                .to("bean:userService?method=getUser(${header.id})")
            .put().description("Updates or create a user").type(User.class)
                .param().name("body").type(body).description("The user to update or create").endParam()
                .to("bean:userService?method=updateUser")
            .get("/findAll").description("Find all users").outType(User[].class)
                .to("bean:userService?method=listUsers");
    }
}

78.2. 옵션

옵션유형설명

부울

openapi.version

문자열

host

문자열

문자열

base.path

문자열

api.path

문자열

api.version

문자열

api.title

문자열

api.description

문자열

api.termsOfService

문자열

api.contact.name

문자열

api.contact.email

문자열

api.contact.url

문자열

api.license.name

문자열

api.license.url

문자열

78.3.

rest("/user").tag("dude").description("User rest service")
    // setup security definitions
    .securityDefinitions()
        .oauth2("petstore_auth").authorizationUrl("http://petstore.swagger.io/oauth/dialog").end()
        .apiKey("api_key").withHeader("myHeader").end()
    .end()
    .consumes("application/json").produces("application/json")

.get("/{id}/{date}").description("Find user by id and date").outType(User.class)
    .security("api_key")

...

.put().description("Updates or create a user").type(User.class)
    .security("petstore_auth", "write:pets,read:pets")

78.4.

78.5.

restConfiguration().component("netty-http")
    .useXForwardHeaders(false)
    .apiProperty("schemes", "https");
    .host("localhost")
    .port(8080);

78.6. 예

78.7.

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-openapi-java-starter</artifactId>
  <version>{CamelSBProjectVersion}</version>
  <!-- Use your Camel Spring Boot version -->
</dependency>

이름설명Default유형

camel.openapi.enabled

true

부울

법적 공지

Copyright © 2023 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.