SpringBoot配置Email发送功能实例

本篇介绍在springboot中配置email服务的具体步骤，以及常见的异常分析。

具体案例以qq邮箱以及qq企业邮箱为例。

1. qq邮箱发送方式
2. qq企业邮箱发送方式
3. 总结

tips:

下面提到的hashindex指的是一个元素put到hashmap中时，要根据其key.hashcode & (table.size()-1)来决定其在table中的位置。

table是一个数组，类型为node。node是hashmap的一个内部类，用来描述hashmap的元素的一些属性。

1.相关依赖包

<parent>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-parent</artifactid>
    <version>1.3.0.release</version>
</parent>

 <dependencies>
    <!-- springboot-->
    <dependency>
      <groupid>org.springframework.boot</groupid>
      <artifactid>spring-boot-starter-web</artifactid>
      <version>1.3.0.release</version>
    </dependency>
    <!-- email -->
    <dependency>
      <groupid>org.springframework.boot</groupid>
      <artifactid>spring-boot-starter-mail</artifactid>
    </dependency>
    <!-- html模板 -->
    <dependency>
      <groupid>org.springframework.boot</groupid>
      <artifactid>spring-boot-starter-velocity</artifactid>
    </dependency>
</dependencies>

springboot以及mail的依赖包就不做解释了。

这里简单介绍下velocity的作用：

velocity 是一个基于 java 的模板引擎框架，提供的模板语言可以使用在 java 中定义的对象和变量上。

作为邮件模板也是它的一个主要应用场景。

具体用法在下面会进行说明。

2.具体案例

1.使用qq邮箱进行发送

application.properties

#发送邮箱（可以填你自己的邮箱）
email.from = [e-mail]
#目标邮箱
email.to = 
#邮箱服务器
email.host = smtp.qq.com
#授权码，在qq邮箱客户端生成
email.auth = kpzmxhrkqklwbbbd

大家可能不理解auth授权码是干什么用的。

这相当于是当以第三方形式登录时用非密码验证的一种手段。

在qq邮箱->设置->账户 往下拉可以找到。

同时需要把pop3/smtp服务开启。

javamailsender

import org.springframework.beans.factory.annotation.autowired;
import org.springframework.context.annotation.bean;
import org.springframework.context.annotation.configuration;
import org.springframework.core.env.environment;
import org.springframework.mail.javamail.javamailsender;
import org.springframework.mail.javamail.javamailsenderimpl;

import javax.mail.authenticator;
import javax.mail.passwordauthentication;
import java.util.properties;

/**
 * author  : qianweifeng
 * date   : 16/4/9.
 * describe :
 */
@configuration
public class mailconfig {

  @autowired
  private environment env;

  @bean(name = "javamailsender")
  public javamailsender getsender(){
    javamailsenderimpl javamailsender = new javamailsenderimpl();
    javamailsender.setusername(env.getproperty(configconstant.email_from));
    javamailsender.sethost(env.getproperty(configconstant.email_host));
    javamailsender.setport(587);//①
    javamailsender.setdefaultencoding("utf-8");
    properties props = new properties();//②
    props.setproperty("mail.smtp.host", env.getproperty(configconstant.email_host));
    props.setproperty("mail.smtp.auth", "true");
    javax.mail.session session = javax.mail.session.getdefaultinstance(props,new authenticator(){
      @override
      protected passwordauthentication getpasswordauthentication(){
        return new passwordauthentication("[e-mail]",env.getproperty(configconstant.email_auth));
      }
    });
    javamailsender.setsession(session);//③
    return javamailsender;
  }

 
}

这是java邮件发送的一个具体实现bean。

关于javamailsender的内容大家自行看源码或者度娘。

这里说明3个方面。

1.javamailsender.setport(587) 这个端口不是随意设置的，根据邮箱服务器以及协议来定的。我在网上找了相关资料，大家参考下：

2.关于properties的设置。这里只需要设置其邮箱服务器以及启用授权码验证方式即可。

3.session完成的使用授权码验证邮件发送方，相当于建立起一个有效会话。

import com.service.config.configconstant;
import org.slf4j.logger;
import org.slf4j.loggerfactory;
import org.springframework.beans.factory.annotation.autowired;
import org.springframework.context.smartlifecycle;
import org.springframework.core.env.environment;
import org.springframework.mail.javamail.javamailsender;
import org.springframework.mail.javamail.mimemessagehelper;
import org.springframework.mail.javamail.mimemessagepreparator;
import org.springframework.stereotype.component;

import javax.mail.internet.mimemessage;
import java.util.concurrent.executors;
import java.util.concurrent.scheduledexecutorservice;
import java.util.concurrent.timeunit;
import java.util.concurrent.atomic.atomicinteger;

/**
 * author  : qianweifeng
 * date   : 16/4/9.
 * describe :
 */
@component
public class mailutil implements smartlifecycle {
  @autowired
  private javamailsender javamailsender;

  @autowired
  private environment env;

  private logger logger = loggerfactory.getlogger(mailutil.class);

  private scheduledexecutorservice service = executors.newscheduledthreadpool(2);

  private final atomicinteger count = new atomicinteger(1);

  public mimemessagepreparator send(final string text) {
    mimemessagepreparator preparator = new mimemessagepreparator() {
      public void prepare(mimemessage mimemessage) throws exception {
        mimemessagehelper message = new mimemessagehelper(mimemessage);
        message.setto(env.getproperty(configconstant.email_to));
        message.setfrom(env.getproperty(configconstant.email_from));
        message.setsubject("java email send test");
//        string text = velocityengineutils.mergetemplateintostring(velocityengine, "velocity/report.vm", "utf-8", model);
        message.settext(text, true);
      }
    };
    return preparator;
  }


  @override
  public boolean isautostartup() {
    return true;
  }

  @override
  public void stop(runnable runnable) {

  }

  @override
  public void start() {
    service.schedulewithfixeddelay(new runnable() {
      @override
      public void run() {
        try {
          if (count.get() == 2) {
            service.shutdown();
            logger.info("the task is down");
          }
          logger.info("start send email and the index is " + count);

          javamailsender.send(send("test !" + "*" + count.getandincrement()));

          logger.info("send email success");
        }catch (exception e){
          logger.error("send email fail" , e);
        }

      }
    },2000,2000, timeunit.milliseconds);
  }

  @override
  public void stop() {

  }

  @override
  public boolean isrunning() {
    return false;
  }

  @override
  public int getphase() {
    return 0;
  }
}

使用方式：

将邮件服务器，授权码，发送方，接受放在application.properties配置好。

项目启动后就会开始发送，总共发送2封邮件。

使用velocity来构建邮件正文

public void send(final string date, final string date2) {


    final list<uvbean> uvbean = getuv(start, end);
    final list<userresandloginreport> resandloginreports = dao.registerandlogin(start, end);

    map model = new hashmap();
    model.put("uvbean", uvbean);
    model.put("resandloginreports", resandloginreports);
        string text = velocityengineutils.mergetemplateintostring(velocityengine, "velocity/report.vm", "utf-8", model);
}

<h3>1.uv</h3>
<table border="1px" style="border-collapse: collapse;">
  <tr>
    <td nowrap="nowarp" style="width:80px;" class="date">日期</td>
    <td nowrap="nowarp" style="width:120px;" class="head">uv</td>
  </tr>
  #foreach( $data in $uvbean )
    <tr>
      <td nowrap="nowarp" class="date">${data.date}</td>
      <td nowrap="nowarp" class="count">${data.data}</td>
    </tr>
  #end
</table>
...

假设我们需要在邮件中显示的一些复杂内容，可以后台以对象的形式包装起来，放入一个hashmap中，在velocity解析出来，至于如何解析，那就是velocity的语义的问题了。

使用velocity可以在邮件正文中以html的方式来丰富化邮件。

2.使用qq企业邮箱进行发送

过程以及代码几乎相同

区别是邮件服务器为：smtp.exmail.qq.com或者pop.exmail.qq.com

没有授权码这一概念。

发送端口号25或者smtp协议下端口为465，pop协议下端口为995。

推荐验证方式为直接用户名+密码，或者用ssl方式进行验证。

具体参考

给出一个简单的样例：

 javamailsenderimpl javamailsender = new javamailsenderimpl();
    javamailsender.setusername(env.getproperty("spring.mail.username"));
    javamailsender.sethost(env.getproperty("spring.mail.host"));
    javamailsender.setpassword(env.getproperty("spring.mail.password"));
    javamailsender.setport(25);
    javamailsender.setdefaultencoding("utf-8");
    javamailsender.send(preparator);

preparator就是上面出现过的mimemessagepreparator的实例。配置方法见上。

3.总结

1.发送邮件我们首要配置的包括：邮箱服务器，协议，端口。

2.一般验证有两种方式，一种是直接的用户名密码，另一种是通过授权码或者ssl进行验证。

3.邮件的正文可以是纯文本，或者是html内容，html内容可以由velocity模板构建或者直接用字符串构建出html内容。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。