13.2. 如何调用表达式语言

在使用特定表达式语言之前，您必须确保 classpath 上提供了所需的 JAR 文件。如果 Apache Camel 内核中不包含您要使用的语言，您必须将相关的 JAR 添加到您的类路径中。

如果使用 Maven 构建系统，您只需将相关依赖关系添加到 POM 文件来修改构建类路径。例如，如果您想要使用 Ruby 语言，请在 POM 文件中添加以下依赖项：

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-groovy</artifactId>
  <!-- Use the same version as your Camel core version -->
  <version>${camel.version}</version>
</dependency>

如果要在红帽 Fuse OSGi 容器中部署应用程序，您还需要确保安装相关的语言功能（功能在相应的 Maven 工件后被命名）。例如，若要在 OSGi 容器中使用 Groovy 语言，您必须首先通过输入以下 OSGi 控制台命令来安装 camel-groovy 功能：

karaf@root> features:install camel-groovy

Camel 在 EAP (Wildfly Camel)框架上支持 camel-groovy 组件，红帽 JBoss 企业应用平台(JBoss EAP)容器上提供了简化的部署模型。

如 表 13.1 “表达式和谓词语言” 所示，根据使用上下文调用表达式语言有几个不同的语法。您可以调用表达式语言：

大多数语言都定义了一种静态方法，可以在任何 环境中使用 org.apache.camel.Expression 类型或 org.apache.camel.Predicate 类型。静态方法使用字符串表达式（或 predicate）作为其参数，并返回 Expression 对象（通常是 Predicate 对象）。

例如，要实现以 XML 格式处理消息的基于内容的路由器，您可以根据 /order/address/countryCode 元素的值路由消息，如下所示：

from("SourceURL")
  .choice
    .when(xpath("/order/address/countryCode = 'us'"))
      .to("file://countries/us/")
    .when(xpath("/order/address/countryCode = 'uk'"))
      .to("file://countries/uk/")
    .otherwise()
      .to("file://countries/other/")
  .to("TargetURL");

Java fluent DSL 支持另一种形式的调用表达式语言。除了将表达式作为企业集成模式(EIP)的参数提供外，您可以将表达式作为 DSL 命令的子使用提供。例如，您可以不将 XPath 表达式调用为 filter (xpath ("))，而是以 filter （）.xpath (")的形式调用表达式。

例如，前面的基于内容的路由器可以在这种调用方式中重新实施，如下所示：

from("SourceURL")
  .choice
    .when().xpath("/order/address/countryCode = 'us'")
      .to("file://countries/us/")
    .when().xpath("/order/address/countryCode = 'uk'")
      .to("file://countries/uk/")
    .otherwise()
      .to("file://countries/other/")
  .to("TargetURL");

您还可以通过将表达式字符串放在相关 XML 元素中，在 XML 中调用表达式语言。

例如，XML 中调用 XPath 的 XML 元素是 xpath （属于标准 Apache Camel 命名空间）。您可以在基于 XML DSL 内容的路由器中使用 XPath 表达式，如下所示：

<from uri="file://input/orders"/>
<choice>
  <when>
    <xpath>/order/address/countryCode = 'us'</xpath>
    <to uri="file://countries/us/"/>
  </when>
  <when>
    <xpath>/order/address/countryCode = 'uk'</xpath>
    <to uri="file://countries/uk/"/>
  </when>
  <otherwise>
    <to uri="file://countries/other/"/>
  </otherwise>
</choice>

或者，您可以使用 language 元素指定语言表达式，您可以在其中指定 language 属性中的语言名称。例如，您可以使用 语言 元素定义 XPath 表达式，如下所示：

<language language="xpath">/order/address/countryCode = 'us'</language>

语言注解在 Bean 集成上下文中使用。该注解提供了从消息或标题提取信息的便捷方式，然后将提取的数据注入 Bean 的方法解析。

例如，可考虑作为 filter （） EIP 的 predicate 调用 bean myBeanProc。如果 bean 的 checkCredentials 方法返回 true，则消息被允许继续；但如果方法返回 假，则消息会被过滤器阻止。过滤器模式实现如下：

// Java
MyBeanProcessor myBeanProc = new MyBeanProcessor();

from("SourceURL")
  .filter().method(myBeanProc, "checkCredentials")
  .to("TargetURL");

MyBeanProcessor 类的实现利用 @XPath 注释从底层 XML 消息中提取 用户名和密码 ，如下所示：

// Java
import org.apache.camel.language.XPath;

public class MyBeanProcessor {
    boolean void checkCredentials(
        @XPath("/credentials/username/text()") String user,
        @XPath("/credentials/password/text()") String pass
    ) {
        // Check the user/pass credentials...
        ...
    }
}

@XPath 注释仅在注入参数之前放置。请注意，XPath 表达式如何通过将 /text （） 附加到路径来 显式 选择文本节点，这样可确保仅选择元素的内容，而不是链接的标签。

使用 Camel 语言组件，您可以在端点 URI 中调用受支持的语言。有两种替代语法：

要调用存储在文件中的语言脚本（或者由 Scheme定义的其他资源类型），请使用以下 URI 语法：

language://LanguageName:resource:Scheme:Location[?Options]

其中，该方案可以是 文件：、classpath: 或 http：

例如，以下路由从 classpath 执行 mysimplescript.txt ：

from("direct:start")
  .to("language:simple:classpath:org/apache/camel/component/language/mysimplescript.txt")
  .to("mock:result");

要调用嵌入的语言脚本，请使用以下 URI 语法：

language://LanguageName[:Script][?Options]

例如，运行保存在脚本字符串中的简单语言 脚本 ：

String script = URLEncoder.encode("Hello ${body}", "UTF-8");
from("direct:start")
  .to("language:simple:" + script)
  .to("mock:result");

有关语言组件的详情，请参阅 Apache Camel 组件参考指南 中的 语言。