2.12. Camel Maven 플러그인

Camel Maven 플러그인 실행 목표는 명령줄에서 구성 하거나 <configuration> 태그의 pom.xml 파일에 정의된 다음 옵션을 지원합니다.

camel:run 플러그인은 블루프린트 애플리케이션 실행을 지원하며 기본적으로 OSGI-INF/blueprint/*.xml 에서 OSGi 블루프린트 파일을 스캔합니다. 아래 표시된 대로 blueprint를 true로 사용하여 블루프린트를 사용하도록 camel:run 플러그인을 구성해야 합니다.

<plugin>
  <groupId>org.jboss.redhat-fuse</groupId>
  <artifactId>camel-maven-plugin</artifactId>
  <configuration>
    <useBlueprint>true</useBlueprint>
  </configuration>
</plugin>

이를 통해 Camel과 관련이 있는지 여부에 관계없이 원하는 블루프린트 서비스를 부팅할 수 있습니다. camel:run 목표는 카l-blueprint가 classpath에 있는지 또는 프로젝트에 블루프린트 XML 파일이 있는지 자동 감지할 수 있으므로 더 이상 useBlueprint 옵션을 구성할 필요가 없습니다.

Felix Connector 프로젝트를 블루프린트 컨테이너로 사용합니다. 이 프로젝트는 완전한 가상 블루프린트 컨테이너가 아닙니다. 이를 위해 Apache Karaf 또는 Apache ServiceMix를 사용할 수 있습니다. applicationContextUri 구성을 사용하여 다음과 같은 명시적 블루프린트 XML 파일을 지정할 수 있습니다.

<plugin>
  <groupId>org.jboss.redhat-fuse</groupId>
  <artifactId>camel-maven-plugin</artifactId>
  <configuration>
    <useBlueprint>true</useBlueprint>
    <applicationContextUri>myBlueprint.xml</applicationContextUri>
    <!-- ConfigAdmin options which have been added since Camel 2.12.0 -->
    <configAdminPid>test</configAdminPid>
    <configAdminFileName>/user/test/etc/test.cfg</configAdminFileName>
  </configuration>
</plugin>

applicationContextUri 는 classpath에서 파일을 로드하므로 위의 예제에서는 myBlueprint.xml 파일이 classpath의 루트에 있어야 합니다. configAdminPid 는 지속성 속성 파일을 로드할 때 구성 관리 서비스의 pid 이름으로 사용되는 pid 이름입니다. configAdminFileName 은 구성 관리자 서비스 속성 파일을 로드하는 데 사용할 파일 이름입니다.

camel:run 플러그인은 CDI 애플리케이션 실행도 지원합니다. 이를 통해 Camel 관련 또는 기타 CDI 활성화 서비스 여부에 관계없이 원하는 CDI 서비스를 부팅할 수 있습니다. 선택한 CDI 컨테이너(예: Weld 또는 OpenWebBeans)를 이 예제와 같이 camel-maven-plugin의 종속 항목에 추가해야 합니다. Camel 소스에서 다음과 같이 CDI 예제를 실행할 수 있습니다.

cd examples/camel-example-cdi
mvn compile camel:run

camel:run 을 실행할 때 classpath를 로깅해야 하는지 여부를 구성할 수 있습니다. 다음을 사용하여 구성에서 이 기능을 활성화할 수 있습니다.

<plugin>
  <groupId>org.jboss.redhat-fuse</groupId>
  <artifactId>camel-maven-plugin</artifactId>
  <configuration>
    <logClasspath>true</logClasspath>
  </configuration>
</plugin>

XML 파일 변경 사항을 스캔하고 해당 XML 파일에 포함된 Camel 경로를 다시 로드하도록 플러그인을 구성할 수 있습니다.

<plugin>
  <groupId>org.jboss.redhat-fuse</groupId>
  <artifactId>camel-maven-plugin</artifactId>
  <configuration>
    <fileWatcherDirectory>src/main/resources/META-INF/spring</fileWatcherDirectory>
  </configuration>
</plugin>

그런 다음 플러그인은 이 디렉터리를 조사합니다. 이를 통해 편집기에서 소스 코드를 편집하고 파일을 저장하고 실행 중인 Camel 애플리케이션에서 해당 변경 사항을 활용할 수 있습니다. 지원되는 Camel 경로 변경(예: <routes> 또는 < route >)만 변경합니다. Spring 또는 OSGi 블루프린트 < bean> 요소는 변경할 수 없습니다.

pom.xml 파일에 플러그인을 추가하지 않고도 Maven 프로젝트에서 검증 목표를 실행할 수도 있습니다. 이렇게 하려면 정규화된 이름을 사용하여 플러그인을 지정해야 합니다. 예를 들어 Apache Camel의 camel-example-cdi 목표를 실행하려면 다음을 실행할 수 있습니다.

$cd camel-example-cdi
$mvn org.apache.camel:camel-maven-plugin:2.20.0:validate

그러면 다음을 실행하고 출력합니다.

[INFO] ------------------------------------------------------------------------
[INFO] Building Camel :: Example :: CDI 2.20.0
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- camel-maven-plugin:2.20.0:validate (default-cli) @ camel-example-cdi ---
[INFO] Endpoint validation success: (4 = passed, 0 = invalid, 0 = incapable, 0 = unknown components)
[INFO] Simple validation success: (0 = passed, 0 = invalid)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

검증이 통과되고 4개의 끝점이 검증되었습니다. 이제 다음과 같은 소스 코드에서 Camel 엔드포인트 URI 중 하나에 오타를 발생했다고 가정합니다.

@Uri("timer:foo?period=5000")

기간 옵션에 오타 오류를 포함하도록 변경됨

@Uri("timer:foo?perid=5000")

검증 목표를 다시 실행하면 다음이 보고됩니다.

[INFO] ------------------------------------------------------------------------
[INFO] Building Camel :: Example :: CDI 2.20.0
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- camel-maven-plugin:2.20.0:validate (default-cli) @ camel-example-cdi ---
[WARNING] Endpoint validation error at: org.apache.camel.example.cdi.MyRoutes(MyRoutes.java:32)

	timer:foo?perid=5000

	                   perid    Unknown option. Did you mean: [period]


[WARNING] Endpoint validation error: (3 = passed, 1 = invalid, 0 = incapable, 0 = unknown components)
[INFO] Simple validation success: (0 = passed, 0 = invalid)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

Camel Maven 플러그인 검증 목표는 명령줄에서 구성 하거나 <configuration> 태그의 pom.xml 파일에 정의된 다음 옵션을 지원합니다.

예를 들어 명령줄에서 더 이상 사용되지 않는 옵션 사용을 무시하려면 다음을 실행할 수 있습니다.

$mvn camel:validate -Dcamel.ignoreDeprecated=true

camel. ignoreDeprecated 를 옵션 이름으로 사용하여 -D 명령 인수 앞에 붙여야 합니다.

Maven 프로젝트가 있는 경우 플러그인을 실행하여 단위 테스트 소스 코드에서 끝점을 검증할 수 있습니다. 다음과 같이 -D 스타일을 사용하여 옵션을 전달할 수 있습니다.

$cd myproject
$mvn org.apache.camel:camel-maven-plugin:2.20.0:validate -DincludeTest=true

다음 중 하나를 사용하여 단위 테스트를 실행하는 동안 경로 범위를 활성화할 수 있습니다.

JVM 시스템 속성 CamelTestRouteCoverage 를 켜면 모든 테스트 케이스에 대한 라우팅 범위를 활성화할 수 있습니다. 이 작업은 maven-surefire-plugin 의 구성에서 수행할 수 있습니다.

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <configuration>
    <systemPropertyVariables>
      <CamelTestRouteCoverage>true</CamelTestRouteCoverage>
    </systemPropertyVariables>
  </configuration>
</plugin>

또는 테스트를 실행할 때 명령줄에서 다음을 수행합니다.

mvn clean test -DCamelTestRouteCoverage=true

camel-test-spring 을 사용하여 테스트하는 경우 테스트 클래스에 @EnableRouteCoverage 주석을 추가하여 단위 테스트 클래스에서 라우팅 범위를 활성화할 수 있습니다.

@RunWith(CamelSpringBootRunner.class)
@SpringBootTest(classes = SampleCamelApplication.class)
@EnableRouteCoverage
public class FooApplicationTest {

그러나 camel-test 를 사용하고 단위 테스트가 CamelTestSupport 를 확장하는 경우 다음과 같이 경로 범위를 설정할 수 있습니다.

@Override
public boolean isDumpRouteCoverage() {
    return true;
}

RouteCoverage 메서드에서 범위를 지정할 수 있는 경로에는 고유한 ID가 할당되어야 합니다. 즉, 익명 경로를 사용할 수 없습니다. Java DSL에서 routeId 를 사용하여 이 작업을 수행합니다.

from("jms:queue:cheese").routeId("cheesy")
  .to("log:foo")
  ...

그리고 XML DSL에서는 id 속성을 통해 경로 ID를 할당하기만 하면 됩니다.

<route id="cheesy">
  <from uri="jms:queue:cheese"/>
  <to uri="log:foo"/>
  ...
</route>

TO generate the route coverage report, run the unit test with:

mvn test

그런 다음 다음을 실행하여 경로 범위를 보고할 수 있습니다.

mvn camel:route-coverage

이 보고서는 정확한 소스 코드 라인 보고를 사용하여 경로 범위가 누락된 경로를 보고합니다.

[INFO] --- camel-maven-plugin:2.21.0:route-coverage (default-cli) @ camel-example-spring-boot-xml ---
[INFO] Discovered 1 routes
[INFO] Route coverage summary:

File:	src/main/resources/my-camel.xml
RouteId:	hello

  Line #      Count   Route
  ------      -----   -----
      28          1   from
      29          1     transform
      32          1     filter
      34          0       to
      36          1     to

Coverage: 4 out of 5 (80.0%)

여기에서 의 두 번째 마지막 행에는 count 열에 0 이 있으므로 적용되지 않습니다. 또한 my-camel.xml XML 파일에 있는 소스 코드 파일에서 34행임을 알 수 있습니다.

Camel Maven 플러그인 적용 범위는 명령줄에서 구성 하거나 <configuration> 태그의 pom.xml 파일에 정의된 다음 옵션을 지원합니다.