1.2. Basic Java DSL Syntax

DSL(Domain Specific Language)은 특수한 목적을 위해 설계된 최소 언어입니다. DSL은 논리적으로 완료할 필요는 없지만 선택한 도메인에서 문제를 적절하게 설명하기 위해 표현 가능한 권한이 필요합니다. 일반적으로 DSL에는 전용 구문 분석기, 인터프리터 또는 컴파일러가 필요하지 않습니다. DSL은 기존 객체 지향 호스트 언어의 상단에 파키백을 할 수 있으며 호스트 언어 API의 구성에 DSL 구문이 깔끔하게 맵을 제공했습니다.

가상 DSL에서 다음과 같은 명령 시퀀스를 고려하십시오.

command01;
command02;
command03;

다음과 같이 이러한 명령을 Java 메서드 호출에 매핑할 수 있습니다.

command01().command02().command03()

블록을 Java 메서드 호출에 매핑할 수도 있습니다. 예를 들면 다음과 같습니다.

command01().startBlock().command02().command03().endBlock()

DSL 구문은 호스트 언어 API의 데이터 유형에 의해 암시적으로 정의됩니다. 예를 들어 Java 메서드의 반환 유형은 다음에 합법적으로 호출할 수 있는 방법을 결정합니다( DSL의 다음 명령과 동일함).

Apache Camel은 라우팅 규칙을 정의하는 라우터 DSL 을 정의합니다. 이 DSL을 사용하여 RouteBuilder.configure() 구현의 본문에 규칙을 정의할 수 있습니다. 그림 1.1. “로컬 라우팅 규칙” 는 로컬 라우팅 규칙을 정의하는 기본 구문의 개요를 보여줍니다.

그림 1.1. 로컬 라우팅 규칙

로컬 규칙은 항상 라우팅 규칙의 메시지 소스(소비자 끝점)를 지정하는 from("EndpointURL") 메서드로 시작합니다. 그런 다음 임의로 긴 프로세서 체인을 규칙에 추가할 수 있습니다(예: filter()). 일반적으로 규칙을 통과하는 메시지의 대상(프로덕터끝점)을 지정하는 to("EndpointURL") 메서드로 규칙을 종료합니다. 그러나 to() 로 규칙을 종료할 필요는 없습니다. 규칙에서 메시지 대상을 지정하는 다른 방법이 있습니다.

로컬 규칙은 항상 from("EndpointURL") 을 사용하여 소비자 끝점을 정의하여 시작하고 일반적으로 (항상은 아님) to("EndpointURL") 를 사용하여 생산자 엔드포인트를 정의하여 끝납니다. 엔드포인트 URL인 EndpointURL 은 배포 시 구성된 구성 요소 중 하나를 사용할 수 있습니다. 예를 들어 파일 엔드포인트, file:MyMessageDirectory, Apache CXF 엔드포인트, cxf:MyServiceName 또는 Apache ActiveMQ 엔드포인트 activemq:queue:MyQName 을 사용할 수 있습니다. 구성 요소 유형의 전체 목록은 Apache Camel 구성 요소 참조를 참조하십시오.

교환 오브젝트는 메타데이터에 의해 보강된 메시지로 구성됩니다. 교환은 라우팅 규칙을 통해 메시지가 전파되는 표준 형식이므로 Apache Camel에서 교환은 매우 중요합니다. 교환의 주요 구성 요소는 다음과 같습니다.

Exchange 개체를 사용하면 다양한 메시지 교환 패턴에 대한 메시지 처리를 쉽게 일반화할 수 있습니다. 예를 들어 비동기 프로토콜은 소비자 끝점에서 생산자 엔드포인트( InOnly MEP)로 이동하는 단일 메시지로 구성된 MEP를 정의할 수 있습니다. 반면 RPC 프로토콜은 요청 메시지와 응답 메시지( InOut MEP)로 구성된 MEP를 정의할 수 있습니다. 현재 Apache Camel은 다음 MEP를 지원합니다.

여기서 이러한 메시지 교환 패턴은 열거 유형인 org.apache.camel.ExchangePattern 의 상수로 표시됩니다.

경우에 따라 여러 교환 인스턴스를 캡슐화하는 단일 교환을 사용하는 것이 유용합니다. 이를 위해 그룹화된 교환을 사용할 수 있습니다. 그룹화된 교환은 기본적으로 Exchange.GROUPED_EXCHANGE 교환 속성에 저장된 java.util.List of Exchange 개체를 포함하는 교환 인스턴스입니다. 그룹화된 교환을 사용하는 방법에 대한 예제는 8.5절. “수집기” 를 참조하십시오.

프로세서는 경로를 통과하는 교환 스트림에 액세스하고 수정할 수 있는 경로의 노드입니다. 프로세서에서는 동작을 수정하는 표현식 또는 서술자 인수를 사용할 수 있습니다. 예를 들어 그림 1.1. “로컬 라우팅 규칙” 에 표시된 규칙에는 xpath() 서술자를 인수로 사용하는 filter() 프로세서가 포함되어 있습니다.

식(문자열 또는 기타 데이터 형식에 평가) 및 서술자(true 또는 false로 평가)는 기본 제공 프로세서 유형에 대한 인수로 자주 발생합니다. 예를 들어 다음 필터 규칙은 foo 헤더가 값 표시줄 과 동일한 경우에만 메시지에서 전파됩니다.

from("seda:a").filter(header("foo").isEqualTo("bar")).to("seda:b");

여기서 필터가 서술자인 header("foo").isEqualTo("bar") 에 의해 검증됩니다. 메시지 콘텐츠를 기반으로 보다 정교한 서술자 및 표현식을 구성하려면 표현식 및 서술자 언어 중 하나를 사용할 수 있습니다( II 부. 라우팅 표현식 및 서술자 언어참조).