Java HtmlEmail 邮件发送的简单实现代码

Java 项目中常常回遇到发送邮件

Java 发送邮件有几种，今天先给大家介绍用 HtmlEmail 来发送邮件，我这里是用 Maven 来搭建的

HtmlEmail 可以抄带HTML

首先 需要导入jar 包

<dependency>
   <groupId>org.apache.commons</groupId>
   <artifactId>commons-email</artifactId>
   <version>1.4</version>
 </dependency>

然后我们来建立一个发送邮件的 Mail 类 JavaBean

public class Mail implements Serializable{

  private static final long serialVersionUID = -6390720891150157552L;
  public static final String ENCODEING = "UTF-8"; 

  // 服务器地址
  private String host;
  // 发件人的邮箱
  private String sender;
  // 发件人昵称
  private String name;
  // 账号
  private String username;
  // 密码
  private String password;
  // 收件人的邮箱
  private String receiver;
  // 收件人的名称
  private String receiverName;
  // 收件人的邮箱(key)和名称(value)
  private Map<String, String> to;
  // 抄送人的邮箱(key)和名称(value)
  private Map<String, String> cc;
  // 秘密抄送人的邮箱(key)和名称(value)
  private Map<String, String> bcc;
  // 主题
  private String subject;
  // 信息(支持HTML)
  private String message;

  public String getHost() {
    return host;
  }
  public void setHost(String host) {
    this.host = host;
  }
  public String getSender() {
    return sender;
  }
  public void setSender(String sender) {
    this.sender = sender;
  }
  public String getReceiver() {
    return receiver;
  }
  public void setReceiver(String receiver) {
    this.receiver = receiver;
  }
  public String getName() {
    return name;
  }
  public void setName(String name) {
    this.name = name;
  }
  public String getUsername() {
    return username;
  }
  public void setUsername(String username) {
    this.username = username;
  }
  public String getPassword() {
    return password;
  }
  public void setPassword(String password) {
    this.password = password;
  }
  public String getSubject() {
    return subject;
  }
  public void setSubject(String subject) {
    this.subject = subject;
  }
  public String getMessage() {
    return message;
  }
  public void setMessage(String message) {
    this.message = message;
  }
  public String getReceiverName() {
    return receiverName;
  }
  public void setReceiverName(String receiverName) {
    this.receiverName = receiverName;
  }
  public Map<String, String> getTo() {
    return to;
  }
  public void setTo(Map<String, String> to) {
    this.to = to;
  }
  public Map<String, String> getCc() {
    return cc;
  }
  public void setCc(Map<String, String> cc) {
    this.cc = cc;
  }
  public Map<String, String> getBcc() {
    return bcc;
  }
  public void setBcc(Map<String, String> bcc) {
    this.bcc = bcc;
  }
}

然后再来创建一个发送邮件的工具类 MailUtil

public class MailUtil {

  public Boolean send(Mail mail){
    HtmlEmail email = new HtmlEmail();
    try {
      // 这里是SMTP发送服务器的名字：163的如下："smtp.163.com"
      email.setHostName(mail.getHost());
      // 字符编码集的设置
      email.setCharset(Mail.ENCODEING);
      // 发送人的邮箱
      email.setFrom(mail.getSender(), mail.getName());
      // 如果需要认证信息的话，设置认证：用户名-密码。分别为发件人在邮件服务器上的注册名称和密码
      email.setAuthentication(mail.getUsername(), mail.getPassword());

      // 设置收件人信息
      setTo(email, mail);
      // 设置抄送人信息
      setCc(email, mail);
      // 设置密送人信息
      setBcc(email, mail);
      // 要发送的邮件主题
      email.setSubject(mail.getSubject());
      // 要发送的信息，由于使用了HtmlEmail，可以在邮件内容中使用HTML标签
      email.setHtmlMsg(mail.getMessage());
      // 发送
      email.send();
      if (Log.isDebugEnabled()) {
        Log.info(mail.getSender() + " 发送邮件到 " + mail.getReceiver());
      }
      return true;
    } catch (Exception e) {
      e.printStackTrace();
      Log.info(mail.getSender() + " 发送邮件到 " + mail.getReceiver() + " 失败");
      return false;
    }
  }

  /**
   * 设置收件人信息
   *
   * @param email
   * @param mail
   * @throws EmailException
   */
  private void setTo(HtmlEmail email, Mail mail) throws EmailException{
    // 收件人不为空
    if (StringUtils.isNotEmpty(mail.getReceiver())) {
      // 收件人名称不为空
      if (StringUtils.isNotEmpty(mail.getReceiverName())) {
        email.addTo(mail.getReceiver(), mail.getReceiverName());
      } else {
        email.addTo(mail.getReceiver());
      }
    }
    // 收件人 Map 不为空
    if (mail.getTo() != null) {
      for (Map.Entry<String, String> entry : mail.getTo().entrySet()) {
        // 收件人名称不为空
        if (StringUtils.isNotEmpty(entry.getValue())) {
          email.addTo(entry.getKey(), entry.getValue());
        } else {
          email.addTo(entry.getKey());
        }
      }
    }
  }

  /**
   * 设置抄送人信息
   *
   * @param email
   * @param mail
   * @throws EmailException
   */
  private void setCc(HtmlEmail email, Mail mail) throws EmailException{
    // 抄送人 Map 不为空
    if (mail.getCc() != null) {
      for (Map.Entry<String, String> entry : mail.getCc().entrySet()) {
        // 抄送人名称不为空
        if (StringUtils.isNotEmpty(entry.getValue())) {
          email.addCc(entry.getKey(), entry.getValue());
        } else {
          email.addCc(entry.getKey());
        }
      }
    }
  }

  /**
   * 设置密送人信息
   *
   * @param email
   * @param mail
   * @throws EmailException
   */
  private void setBcc(HtmlEmail email, Mail mail) throws EmailException{
    // 密送人 Map 不为空
    if (mail.getBcc() != null) {
      for (Map.Entry<String, String> entry : mail.getBcc().entrySet()) {
        // 密送人名称不为空
        if (StringUtils.isNotEmpty(entry.getValue())) {
          email.addBcc(entry.getKey(), entry.getValue());
        } else {
          email.addBcc(entry.getKey());
        }
      }
    }
  }
}

写到这里，大概也就差不多了，万里长征只有最后一步了

测试，测试，测试

这里编写一个 junit 方法来测试

@Test
  public void sendMail(){
    Mail mail = new Mail();
    // 设置邮件服务器
    mail.setHost("smtp.exmail.qq.com");
    // 发件人邮件地址
    mail.setSender("chenhao@kezhanbang.cn");
    // 发件人名称
    mail.setName("Java.小学生");
    // 登录账号,一般都是和邮箱名一样吧
    mail.setUsername("chenhao@kezhanbang.cn");
    // 发件人邮箱的登录密码
    mail.setPassword("xxxxxxxx");
    // 接收人
    mail.setReceiver("huntertochen@163.com");
    mail.setReceiverName("我要女票");
    mail.setSubject("万里长征最后一步测试");
    String html = "<!DOCTYPE html>";
    html += "<html><head><meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\">";
    html += "<title>Insert title here</title>";
    html += "</head><body>";
    html += "<div style=\"width:600px;height:400px;margin:50px auto;\">";
    html += "<h1>我来看看邮件是否发送成功呢</h1><br/><br/>";
    html += "<p>下面是通过该协议可以创建一个指向电子邮件地址的超级链接，通过该链接可以在Internet中发送电子邮件</p><br/>";
    html += "<a href=\"mailto:huntereagle@foxmail.com?subject=test&cc=huntertochen@163.com&body=use mailto sample\">send mail</a>";
    html += "</div>";
    html += "</body></html>";
    mail.setMessage(html);

    new MailUtil().send(mail);
  }

赶紧登录邮箱看看吧

来看看这里 主题 内容，发送人名称和收件人名称是否和代码写的一样呢，如果一样的话，恭喜你成功啦

到这，其实发送邮件就算完了！！！

这里在啰嗦最后一个小知识点 mailto

mailto: 通过该协议可以创建一个指向电子邮件地址的超级链接，通过该链接可以在Internet中发送电子邮件

我们点击 send mail 会打开你邮件客户端一个发送界面，如果你有写抄带信息，也会给你带上

以上这篇Java HtmlEmail 邮件发送的简单实现代码就是小编分享给大家的全部内容了，希望能给大家一个参考，也希望大家多多支持我们。