31.3. 组件选项
邮件组件支持 43 选项,如下所列。
名称 | 描述 | 默认 | 类型 |
---|---|---|---|
bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
关闭Folder (使用者) | 消费者是否应该在轮询后关闭文件夹。将这个选项设置为 false 并在轮询之间保持 disconnect=false,然后消费者保持打开文件夹。 | true | 布尔值 |
copyTo (consumer) | 处理邮件消息后,可以将其复制到具有给定名称的邮件文件夹。您可以用带有键 copyTo 的标头覆盖此配置值,允许您将消息复制到运行时配置的文件夹名称。 | 字符串 | |
decodeFilename (consumer) | 如果设置为 true,则 MimeUtility.decodeText 方法将用于解码文件名。这与设置 JVM 系统属性 mail.mime.encodefilename 类似。 | false | 布尔值 |
删除 (使用者) | 在消息被处理后删除它们。这可以通过在邮件消息上设置 DELETED 标志来完成。如果为 false,则设置 SEEN 标志。从 Camel 2.10 开始,您可以通过使用密钥 delete 设置标头来确定是否应删除邮件,来覆盖此配置选项。 | false | 布尔值 |
断开连接 (消费者) | 轮询后消费者是否应断开。如果启用此项,则强制 Camel 在每个轮询上连接。 | false | 布尔值 |
handleFailedMessage (consumer) | 如果邮件使用者无法检索给定的邮件,则此选项允许处理使用者错误处理程序所导致的异常。通过在消费者上启用网桥错误处理程序,Camel 路由错误处理程序可以处理异常。默认行为是消费者抛出异常,并且来自批处理中的邮件都无法由 Camel 路由。 | false | 布尔值 |
mimeDecodeHeaders (consumer) | 此选项为邮件标头启用透明 MIME 解码和取消折叠。 | false | 布尔值 |
MoveTo (消费者) | 处理邮件后,可以将其移动到具有给定名称的邮件文件夹。您可以使用键 moveTo 的标头覆盖此配置值,允许您在运行时将消息移到文件夹名称。 | 字符串 | |
Site (consumer) | 将 javax.mail.Message 标记为 openmpied,然后再处理邮件邮件。这只适用于 IMAPMessage 消息类型。通过使用在邮件服务器上立即标记为 SEEN 的邮件,那么当 Camel 中出现错误处理时,我们就可以回滚邮件消息。 | true | 布尔值 |
skipFailedMessage (consumer) | 如果邮件使用者无法检索给定的邮件,则此选项将允许跳过邮件并移动以检索下一个邮件。默认行为是消费者抛出异常,并且来自批处理中的邮件都无法由 Camel 路由。 | false | 布尔值 |
不可预见 (消费者) | 是否仅受不可预见的邮件的限制。 | true | 布尔值 |
fetchSize (consumer (advanced)) | 设置轮询期间要消耗的消息的最大数量。如果邮箱文件夹包含大量消息,这可用于避免加载邮件服务器。默认值 -1 表示没有获取大小,所有消息都会被使用。将值设为 0 是一个特殊情况,Camel 根本不消耗任何消息。 | -1 | int |
folderName (使用者(高级) | 要轮询的文件夹。 | INBOX | 字符串 |
mapMailMessage (consumer (advanced)) | 指定 Camel 是否应该将收到的邮件映射到 Camel 正文/headers/attachments。如果设置为 true,邮件正文将映射到 Camel IN 消息的正文,邮件标题将映射到 IN 标头,并附加至 Camel IN attachment 消息。如果此选项设为 false,则 IN 消息将包含原始 javax.mail.Message。您可以通过调用 exchange.getIn ().getBody (javax.mail.Message.class)来检索此原始消息。 | true | 布尔值 |
bcc (producer) | 设置 BCC 电子邮件地址。使用逗号分隔多个电子邮件地址。 | 字符串 | |
CC (生成者) | 设置 CC 电子邮件地址。使用逗号分隔多个电子邮件地址。 | 字符串 | |
from (producer) | 来自电子邮件地址。 | camel@localhost | 字符串 |
lazyStartProducer (producer) | 制作者是否应启动 lazy (在第一个消息中)。通过启动 lazy,您可以使用此选项来允许 CamelContext 和路由在制作者启动期间启动,并导致路由启动失败。通过将这个启动延迟到延迟,那么可以通过 Camel 的路由错误处理程序路由消息期间,可以处理启动失败。请注意,在处理第一个消息时,创建并启动制作者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
replyTo (producer) | Reply-To 收件人(响应邮件的接收器)。使用逗号分隔多个电子邮件地址。 | 字符串 | |
主题 (生成者) | 要发送的消息的 Subject。注:在标头中设置主题优先于这个选项。 | 字符串 | |
到 (生成者) | 设置电子邮件地址。使用逗号分隔多个电子邮件地址。 | 字符串 | |
javaMailSender (producer (advanced)) | 要使用自定义 org.apache.camel.component.mail.JavaMailSender 来发送电子邮件。 | JavaMailSender | |
其他JavaMailProperties (高级) | 设置其他 java 邮件属性,这将附加/覆盖根据所有其他选项设置的任何默认属性。如果您需要添加一些特殊选项,但希望保留其他选项,这将非常有用。 | Properties | |
alternativeBodyHeader (advanced) | 指定包含替代电子邮件正文的 IN 消息标头的密钥。例如,如果您以 text/html 格式发送电子邮件,并希望为非HTML 电子邮件客户端提供替代邮件正文,请将这个密钥的替代邮件正文设置为标头。 | CamelMailAlternativeBody | 字符串 |
attachmentsContentTransferEncodingResolver (advanced) | 要使用自定义 AttachmentsContentTransferEncodingResolver 来解析用于附件的 content-type-encoding。 | AttachmentsContentTransferEncodingResolver | |
验证器 (高级) | 用于登录的验证器。如果设置,则忽略密码和用户名。可用于可以过期的令牌,因此必须动态读取。 | MailAuthenticator | |
autowiredEnabled (高级) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
配置 (高级) | 设置邮件配置。 | MailConfiguration | |
connectionTimeout (高级) | 连接超时(以毫秒为单位)。 | 30000 | int |
ContentType (advanced) | 邮件内容类型。将 text/html 用于 HTML 邮件。 | text/plain | 字符串 |
contentTypeResolver (advanced) | 解析器决定 Content-Type 用于文件附加。 | ContentTypeResolver | |
debugMode (高级) | 在底层邮件框架上启用调试模式。默认情况下,SUN 邮件框架会将调试消息记录到 System.out。 | false | 布尔值 |
ignoreUnsupportedCharset (advanced) | 选项可使 Camel 在发送邮件时忽略本地 JVM 中不支持的 charset。如果不支持 charset,则 charset=XXX (其中 XXX 代表不支持的字符集)已从 content-type 中删除,它依赖于平台默认值。 | false | 布尔值 |
ignoreUriScheme (advanced) | 选项可使 Camel 在发送邮件时忽略本地 JVM 中不支持的 charset。如果不支持 charset,则 charset=XXX (其中 XXX 代表不支持的字符集)已从 content-type 中删除,它依赖于平台默认值。 | false | 布尔值 |
javaMailProperties (高级) | 设置 java 邮件选项。将清除任何默认属性,并且仅使用为此方法提供的属性。 | Properties | |
会话 (高级) | 指定 camel 应该用于所有邮件交互的邮件会话。在由某些其他资源(如 JavaEE 容器)创建和管理邮件会话的情形中,可使用。使用自定义邮件会话时,将使用邮件会话的主机名和端口(如果在会话上配置)。 | session | |
useInlineAttachments (高级) | 是否使用 disposition inline 或 attachment。 | false | 布尔值 |
headerFilterStrategy (filter) | 要使用自定义 org.apache.camel.spi.HeaderFilterStrategy 过滤标头到 Camel 消息或从 Camel 消息过滤。 | HeaderFilterStrategy | |
密码 (安全) | 登录的密码。另请参阅 setAuthenticator (MailAuthenticator)。 | 字符串 | |
sslContextParameters (security) | 使用 SSLContextParameters 配置安全性。 | SSLContextParameters | |
useGlobalSslContextParameters (security) | 启用对全局 SSL 上下文参数的使用。 | false | 布尔值 |
用户名 (安全) | 登录的用户名。另请参阅 setAuthenticator (MailAuthenticator)。 | 字符串 |