邮件设置¶
项目
总览¶
这是发送邮件的设置。Javamail-config.xml是默认设置。Javamail-config_ {语言环境ID} .xml作为多语言支持而存在。
模块 邮件模块 格式化文件（xsd） WEB-INF /模式/ javamail-config.xsd 设定位置
参考资料¶
SMTP设置¶
标签名称 短信 配置SMTP设置。配置发送电子邮件时使用的SMTP设置。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” host = “ localhost” port = “ 25” > .... </ smtp-server> </ smtp> </ javamail-config>
必填项目 × 多种设定 × 设置值 /设定内容 指定SMTP的各种设置。 单位/类型 无 省略时的默认值 无 父标签 javamail-config
SMTP服务器设置¶
标签名称 SMTP服务器 配置SMTP服务器设置。可以定义多个SMTP服务器。如果从API发送电子邮件时未指定SMTP服务器，请使用与租户ID相同的ID的SMTP服务器。当没有与租户ID具有相同ID的SMTP服务器设置时使用此设置，因此请确保设置一台SMTP服务器，并在id属性中指定默认值。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” host = “ localhost” port = “ 25” > .... </ smtp-server> </ smtp> </ javamail-config>
必填项目 ○ 多种设定 ○ 设置值 /设定内容 指定SMTP服务器设置。 单位/类型 无 省略时的默认值 无 父标签 短信 [属性]
属性名称 说明 必填项 默认值 编号 ○ 无 主持人 指定SMTP服务器的主机名或IP地址。 ○ 无 港口 指定SMTP服务器的端口名称。 ○ 无
SMTPS（基于SSL的SMTP）设置¶
标签名称 短信 配置SMTPS（基于SSL的SMTP）。要使用SMTPS，Java运行时需要信任SMTP服务器的SSL证书。如果不信任SSL证书，将抛出javax.net.ssl.SSLHandshakeException，并且将无法连接到SMTP服务器。使用前，请确保Java运行时信任SMTP服务器的SSL证书。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” host = “ localhost” 端口= “ 25” > <smtps enable = “ true” starttls = “ false” /> .... </ smtp-服务器> </ smtp> </ javamail-config>
必填项目 × 多种设定 × 设置值 /设定内容 指定SMTPS（基于SSL的SMTP）的设置。 单位/类型 无 省略时的默认值 无 父标签 SMTP服务器 [属性]
属性名称 说明 必填项 默认值 使能 × false starttls × false
SSL协议组¶
标签名称 协议 设置通过SSL执行加密通信时要使用的SSL协议组。[设定项目 ]
<javamail的-配置> <SMTP> <SMTP服务器ID = “默认”宿主= “localhost”的端口= “25”> <SMTPS启用= “真” STARTTLS = “假”> <协议> .... </ 协议> </ smtps> </ smtp-server> </ smtp> </ javamail-config>
必填项目 × 多种设定 × 设置值 /设定内容 指定SSL协议组。 单位/类型 无 省略时的默认值 无 父标签 短信 注解
此设置在2018 Summer （Tiffany）之后可用。
SSL协议设置¶
标签名称 协议 设置执行SSL加密通信时要使用的SSL协议。当邮件服务器限制了允许的SSL协议时，必须指定此选项。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” 主机= “ localhost” 端口= “ 25” > <smtps enable = “ true” starttls = “ false” > <协议> <协议> TLSv1.2 </协议> </协议> </ smtps> </ smtp-server> </ smtp> </ javamail-config>
必填项目 ○ 多种设定 ○ 设置值 /设定内容
TLSv1 TLSv1.1 TLSv1.2 单位/类型 无 省略时的默认值 无 父标签 协议 注解
此设置在2018 Summer （Tiffany）之后可用。
注解
TLSv1是未执行SSL协议设置时使用的SSL协议。这是JavaMail 1.4.1的规范。
SMTP验证设置¶
标签名称 认证 使用SMTP验证时要指定的元素。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” host = “ localhost” 端口= “ 25” > <auth enable = “ false” > .... </ auth> </ smtp-server> </ smtp> </ javamail-config>
必填项目 ○ 多种设定 × 设置值 /设定内容 使用SMTP验证时指定设置。 单位/类型 无 省略时的默认值 无 父标签 SMTP服务器 [属性]
属性名称 说明 必填项 默认值 使能 配置SMTP身份验证的使用设置。如果使用SMTP身份验证，则设置为true；否则，则设置为false。 × false
SMTP验证用户设置¶
标签名称 使用者 使用SMTP身份验证时设置用户。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” host = “ localhost” 端口= “ 25” > <auth enable = “ true” > <user> USER </ user> ... </ auth > </ smtp-server> </ smtp> </ javamail-config>
必填项目 × 多种设定 × 设置值 /设定内容 使用SMTP身份验证时设置用户。 单位/类型 弦乐 省略时的默认值 无 父标签 认证
SMTP验证密码设置¶
标签名称 密码 使用SMTP身份验证时设置密码。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” host = “ localhost” 端口= “ 25” > <auth enable = “ true” > .... <password>密码</ password> </ auth> </ smtp-server> </ smtp> </ javamail-config>
必填项目 × 多种设定 × 设置值 /设定内容 使用SMTP身份验证时设置密码。 单位/类型 弦乐 省略时的默认值 无 父标签 认证
X-Mailer标头设置¶
标签名称 邮件 设置要在X-Mailer邮件标题中指定的值。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” host = “ localhost” port = “ 25” > ... <x-mailer> intra-mart MailSender ver 8.0 </ x-mailer> .. </ smtp-server> </ smtp> </ javamail-config>
必填项目 ○ 多种设定 × 设置值 /设定内容 设置发送邮件时作为X-Mailer标头发送的值。 单位/类型 弦乐 省略时的默认值 无 父标签 SMTP服务器
调试设置¶
标签名称 调试 在JavaMail中设置调试选项。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” host = “ localhost” port = “ 25” > ... <debug> false </ debug> ... </ smtp-server> </ smtp> </ javamail-config>
必填项目 ○ 多种设定 × 设置值 /设定内容
false 不要设置调试设置。 true 配置调试设置。 单位/类型 布尔值（真/假） 省略时的默认值 无 父标签 SMTP服务器
连接超时设置¶
标签名称 连接超时 连接 SMTP服务器时，设置连接超时值。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” host = “ localhost” port = “ 25” > ... <connection-timeout> 60000 </ connection-timeout> ... </ smtp-服务器> </ smtp> </ javamail-config>
必填项目 ○ 多种设定 × 设置值 /设定内容 单位/类型 数值（1或更大或-1） 省略时的默认值 无 父标签 SMTP服务器
超时设定¶
标签名称 超时时间 设置发送邮件时的超时值。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” host = “ localhost” port = “ 25” > ... <timeout> 60000 </ timeout> ... </ smtp-server> </ smtp> </ javamail-config>
必填项目 ○ 多种设定 × 设置值 /设定内容 单位/类型 数值（1或更大或-1） 省略时的默认值 无 父标签 SMTP服务器
邮件Session属性¶
标签名称 会话属性 通过JavaMail执行邮件操作时，设置邮件Session的属性。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” host = “ localhost” 端口= “ 25” > ... <session-properties> ... </ session-properties> ... </ smtp-server> </ smtp> </ javamail-config>
必填项目 × 多种设定 × 设置值 /设定内容 邮件Session属性。 单位/类型 无 省略时的默认值 无 父标签 SMTP服务器 注解
此设置在2018 Summer （Tiffany）之后可用。
邮件Session属性设置¶
标签名称 会话属性 通过JavaMail执行邮件操作时，设置邮件Session的属性。设置JavaMail规范定义的属性的值。[设定项目 ]
<javamail-config> <smtp> <smtp-server id = “ default” 主机= “ localhost” 端口= “ 25” > ... <session-properties> <session-property name = “ mail.smtp.xxxx” 值= “ yyyy” /> </会话属性> ... </ smtp-server> </ smtp> </ javamail-config>
必填项目 ○ 多种设定 ○ 设置值 /设定内容 邮件Session属性。 单位/类型 无 省略时的默认值 无 父标签 会话属性 [属性]
属性名称 说明 必填项 默认值 名 设置邮件Session的属性名称。 ○ 无 价值 设置邮件Session的属性值。 ○ 无 注解
此设置在2018 Summer （Tiffany）之后可用。
注解
发送邮件时，某些属性会自动设置为邮件Session属性。自动获得邮件Session -mail性能与此设置Session如果属性是重复的，这个设置的电子邮件Session属性优先。注意
对于JavaMail规范中定义的每个属性的行为，不能保证操作。
内容类型组¶
标签名称 内容类型 设置发送电子邮件时要附加的文件的内容类型组。[设定项目 ]
<javamail-config> <content-type> ... </ content-type> </ javamail-config>
必填项目 × 多种设定 × 设置值 /设定内容 指定发送邮件时要附加的文件的内容类型组。 单位/类型 无 省略时的默认值 无 父标签 javamail-config
内容类型设置¶
标签名称 档案 设置发送电子邮件时要附加的文件的内容类型。内容类型设置用于附件的扩展名。[设定项目 ]
<javamail-config> <内容类型> <文件 扩展名=“ .txt” 内容类型=“文字/纯文字”/> <文件 扩展名=“ .gif” 内容类型=“图片/ gif”/> <文件 扩展名=“ .jpg” 内容类型=“图片/ jpeg”/> <文件 扩展名=“ .png” 内容类型=“图片/ png”/> </ content-type> </ javamail-config>
必填项目 ○ 多种设定 ○ 设置值 /设定内容 指定发送电子邮件时要附加的文件的内容类型。 单位/类型 无 省略时的默认值 无 父标签 内容类型 [属性]
属性名称 说明 必填项 默认值 扩展名 指定扩展名。确保以句点（。）开头。 ○ 无 内容类型 内容类型属性。设置与扩展名相对应的内容类型。 ○ 无
监听器群设置¶
标签名称 听众 指定发送邮件时运行的监听器群。[设定项目 ]
<javamail-config> <听者> <listener-class> </ listener-class> </ listener> </ javamail-config>
必填项目 × 多种设定 × 设置值 /设定内容 指定发送邮件时运行的监听器群。 单位/类型 无 省略时的默认值 无 父标签 javamail-config
监听器设置¶
标签名称 侦听器类 指定在发送邮件时运行的侦听器。指定的侦听器必须实现jp.co.intra_mart.foundation.mail.javamail.listener.MailSendListener接口。默认 ，设置了一个用于将半角假名转换为全角假名的侦听器（jp.co.intra_mart.foundation.mail.javamail.listener.impl.HalfKanaTransrateListener）。[设定项目 ]
<javamail-config> <听者> <listener-class> </ listener-class> </ listener> </ javamail-config>
必填项目 ○ 多种设定 ○ 设置值 /设定内容 指定在发送邮件时运行的侦听器。 单位/类型 弦乐 省略时的默认值 无 父标签 听众
邮件标题组设置¶
标签名称 邮件标题 指定邮件标题组。[设定项目 ]
<javamail-config> <mail-headers> ... </ mail-headers> </ javamail-config>
必填项目 × 多种设定 × 设置值 /设定内容 指定发送邮件时添加的邮件标题组。 单位/类型 无 省略时的默认值 无 父标签 javamail-config
电子邮件标题设置¶
标签名称 标头 指定发送邮件时要添加的任何邮件头。如果多次指定同一标题，则将在底行指定的标题添加为标题。如果在API中指定了相同的标头（jp.co.intra_mart.foundation.mail.javamail.StandardMail＃addHeader），则将在API中指定的标头作为标头给出。[设定项目 ]
<javamail-config> <邮件头> <标题 名称=“错误至” 值=“XXXX阿托intra-mart .JP” /> </ mail-headers> </ javamail-config>
必填项目 ○ 多种设定 ○ 设置值 /设定内容 指定发送邮件时要添加的任何邮件头。 单位/类型 弦乐 省略时的默认值 无 父标签 邮件标题 [属性]
属性名称 说明 必填项 默认值 名 设置邮件头名称。 ○ 无 价值 设置邮件头值。 ○ 无
电子邮件编码设置¶
标签名称 编码 配置与区域设置相对应的邮件编码的设置。未设置语言环境属性的元素是未定义与语言环境相对应的邮件编码时使用的默认设置。[设定项目 ]
<javamail-config> <encode> <charset> UTF-8 </ charset> <mime-encoding> B </ mime-encoding> <content-transfer-encoding> base64 </ content-transfer-encoding> </ encoding > </ javamail-config>
必填项目 × 多种设定 ○ 设置值 /设定内容 配置与区域设置相对应的邮件编码的设置。 父标签 javamail-config [属性]
属性名称 说明 必填项 默认值 地区 指定语言环境ID。 × 无
字符码设定¶
标签名称 字符集 指定字符代码。[设定项目 ]
<javamail-config> <encode> <charset> UTF-8 </ charset> ... </ encode> </ javamail-config>
必填项目 ○ 多种设定 × 设置值 /设定内容 指定字符代码。 单位/类型 弦乐 省略时的默认值 无 父标签 编码