2.12. Camel Maven 插件

Camel Maven 插件 运行 目标支持以下选项，这些选项可以从命令行（使用 -D 语法）或在 < configuration > 标签的 pom.xml 文件中定义。

camel:run 插件还支持运行 Blueprint 应用程序，默认情况下，它扫描 OSGI-INF/blueprint/*.xml 中的 OSGi 蓝图文件。您需要将 camel:run 插件配置为使用蓝图，将 useBlueprint 设置为 true，如下所示：

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

这可让您启动所需的任何蓝图服务，无论它们是与 Camel 相关的，还是其它蓝图。camel:run 目标可自动检测 camel-blueprint 是否在类路径上，或者存在项目中的蓝图 XML 文件，因此您不必再配置 useBlueprint 选项。

我们使用 Felix Connector 项目作为蓝图容器。此项目不是完全创建的蓝图容器。您可以使用 Apache Karaf 或 Apache ServiceMix。您可以使用 应用程序ContextUri 配置指定明确的蓝图 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 的 root 中。configAdminPid 是 pid 名称，在载入持久性属性文件时，它将用作配置 admin 服务的 pid 名称。configAdminFileName 是文件名，用于加载配置 admin 服务属性文件。

camel:run 插件也支持运行 CDI 应用程序。这可让您启动所需的任何 CDI 服务，无论它们是与 Camel 相关的，还是任何其他启用的 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&gt;，或支持 <route >。您不能更改 Spring 或 OSGi Blueprint < bean> 元素。

您还可以在任何 Maven 项目上运行验证目标，而无需将插件添加到 pom.xml 文件中。这样做需要通过其完全限定名称指定插件。例如，若要在 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")

被修改为在 period 选项中包含拼写错误

@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 插件 验证 目标支持下列选项，可从命令行（使用 -D 语法）或在 < configuration > 标签的 pom.xml 文件中定义。

例如，要关闭忽略使用命令行已弃用选项的使用，您可以运行：

$mvn camel:validate -Dcamel.ignoreDeprecated=false

请注意，您必须将 -D 命令参数加上 camel.，eg camel.ignoreDep ated 作为选项名称。

如果您有一个 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>

要生成路由覆盖报告，使用以下方法运行单元测试：

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%)

在这里，我们可以看到计算列中的 2 最后一行包含 0， 因此没有涵盖。我们还可以看到，源代码文件中为 34 行，它位于 my-camel.xml XML 文件中。

Camel Maven 插件 覆盖 目标支持以下选项，可从命令行（使用 -D 语法）或在 < configuration > 标签的 pom.xml 文件中定义。