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 类构建复合 SearchTerms。这可让您构建复杂的术语，例如：

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