218.17. 使用自定义 SearchTerm

从 Camel 2.11 开始提供

您可以在 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>

您可以在 endpoint uri 配置中有多个 searchTerm。然后，它们将使用 AND 运算符合并，例如这两个条件都必须匹配。例如，要使最后一个不可预见的电子邮件返回 24 小时，在邮件主题中有 Camel，您可以：

<route>
  <from uri="imaps://mymailseerver?username=foo&password=secret&searchTerm.subject=Camel&searchTerm.fromSentDate=now-24h"/>
  <to uri="bean:myBean"/>
</route>

SimpleSearchTerm 旨在从 POJO 中轻松配置，因此您也可以使用 XML 中的 <bean> 风格进行配置

<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 路由中使用 #beanId 引用此 bean，如下所示：

<route>
  <from uri="imaps://mymailseerver?username=foo&password=secret&searchTerm=#mySearchTerm"/>
  <to uri="bean:myBean"/>
</route>

在 Java 中，有一个构建器类可用于使用 org.apache.camel.component.mail.SearchTermBuilder 类构建复合搜索 Terms。这可让您构建复杂的术语，例如：

// 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();