SpringBoot配置Email发送功能实例

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

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

qq邮箱发送方式
qq企业邮箱发送方式
总结

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 = xxxxxxx@qq.com

									#目标邮箱

									email.to = 

									#邮箱服务器

									email.host = smtp.qq.com

									#授权码，在qq邮箱客户端生成

									email.auth = kpzmxhrkqklwbbbd

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

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

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

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

SpringBoot配置Email发送功能实例

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("xxxxxx@qq.com",env.getproperty(configconstant.email_auth));

									      }

									    });

									    javamailsender.setsession(session);//③

									    return javamailsender;

									  }

									}

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

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

这里说明3个方面。

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

SpringBoot配置Email发送功能实例

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);