# com.eos.foundation.eoscommon.MailUtil

# 构件包说明

本工具类实现了对邮件的操作处理。

# 运算逻辑构件使用说明

该构件包包含以下构件：

序号	方法	功能描述
1	sendMail(DataObject mailInfo)	发送邮件

# sendMail：发送邮件

# 【功能说明】

发送邮件，支持带附件发送。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.eoscommon.MailUtil.sendMail，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	mailInfo	com.eos.foundation.MailInfo	发送的邮件信息

抛出异常说明邮件发送失败（例如smtpHost不存在）抛出org.apache.commons.mail.EmailException异常。
规则说明

发送的邮件信息的具体结构为：
- to：收件人地址列表，可以支持多个地址；
- from：发件人地址；
- cc：抄送人地址，可以支持多个地址；
- bcc：暗送人地址，可以支持多个地址；
  
  说明
  
  to、cc、bcc三者不能同时为空。
- subject：邮件主题；
- smtpHost、smtpPort：smtp的地址（必须提供）和端口；
- replyTo：回复人地址，可以支持多个；
- userName：发送邮箱用户名；
- password：发送邮箱密码；
- message：邮件消息；
- attachFilePaths：附件文件地址，支持多个，必须是绝对路径；
- charset：字符编码，例如：UTF-8、GBK等；
- inclineFilePaths：内嵌资源列表，支持多个，必须是绝对路径。

# 【参考案例】

示例：发送gocom论坛注册成功的邮件给指定用户的邮箱。

场景描述

一个用户在gocom社区注册用户，成功以后系统自动给该用户发送注册成功邮件。
- 邮件的主题为：gocom注册成功；
- 邮件的消息为：欢迎登录gocom社区，以下是你的注册信息：用户名，xxx，密码：t2eydd。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	mailInfo	com.eos.foundation.MailInfo	info	变量	传引用

参数描述第一个参数是需要发送的mail信息，其中包含地址信息以及邮件内容。
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <info __id="1" __type="sdo:com.eos.foundation.MailInfo">
            <from __type="java:java.lang.String">advice@primeton.com</from>
            <to __id="2" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                <__entry __index="0" __type="java:java.lang.String">wangcq@primeton.com</__entry>
            </to>
            <replyTo __collection="list"/>
            <cc __collection="list"/>
            <bcc __collection="list"/>
            <subject __type="java:java.lang.String">gocom注册成功</subject>
            <message __type="java:java.lang.String">欢迎登录gocom社区，以下是你的注册信息：用户名，xxx，密码：t2eydd</message>
            <inclineFilePaths __collection="list"/>
            <attachFilePaths __collection="list"/>
            <smtpHost __type="java:java.lang.String">mail.primeton.com</smtpHost>
            <smtpPort/>
            <userName __type="java:java.lang.String">advice</userName>
            <password __type="java:java.lang.String">advice</password>
            <messageFormat/>
            <charset/>
        </info>
    </__root>
</bizContext>

调用后的bizContext 同调用前

← 定时器文件 →