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服务开启。
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) 这个端口不是随意设置的,根据邮箱服务器以及协议来定的。我在网上找了相关资料,大家参考下:
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内容。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
上一篇: JAVA线程同步实例教程