【方向盘】版本历史代码范例之JavaMail、JDBC

前言

若你还不太清楚Java EE是什么，可先移步这里：什么是Java EE?

发邮件是企业级应用开发的刚性需求，如：每晚定时任务跑完后自动将结果数据发封邮件到领导邮箱供以查阅。邮件虽然“古老”，但相较于IM消息具有很多不可替代的优势：

更为正式：相对重要的场合/数据用邮件更为合适

承载内容多：一封邮件的文本字数理论上无上限

格式丰富：可由附件、图片、文本组合。支持HTML排版

发送形式丰富：除了收件人外，还可以抄送、密送

既然发邮件的场景这么常见，但据我经验，每每遇到发邮件问题时，同事往往“头疼不已”，你是否也有类似情况呢?本文就来聊聊JavaMail的发展历程，然后给出一些代码示例。

除此之外，本文还会聊聊更为重要的JDBC，它高频的出现在各大面试场合里，是考验一个求职者技术基础水平的重要知识点，更是流行框架MyBatis的基石。

所属专栏

【方向盘】-Java EE

相关下载

【本专栏源代码】：https://github.com/yourbatman/FXP-java-ee

【女娲Knife-Initializr工程】访问地址：http://152.136.106.14:8761

【程序员专用网盘】公益上线啦，注册送1G超小容量，帮你实践做减法：https://wangpan.yourbatman.cn

【Java开发软件包(Mac)】：https://wangpan.yourbatman.cn/s/rEH0 提取码：javakit

版本约定

Java EE：6、7、8

Jakarta EE：8、9、9.1

正文

JavaMail

JavaMail API提供了一个独立于平台和协议的框架来构建邮件和消息传递应用程序。JavaMail API作为可选包提供，可与Java SE平台一起使用，也包含在JavaEE平台中。

JavaMail 是sun公司为方便Java开发人员在应用程序中实现邮件发送和接收功能而提供的一套标准开发包，它支持一些常用的邮件协议，如SMTP，POP3，IMAP,还有MIME(发送附件)等。我们在使用JavaMail API 编写邮件时，无须考虑邮件的底层实现细节，只要调用JavaMail 开发包中相应的API类就可以了。

<!– javax命名空间版本（Tomcat 9.x及以下版本支持） –> 

<dependency> 

    <groupId>javax.mail</groupId> 

    <artifactId>javax.mail-api</artifactId> 

    <version>1.6.2</version> 

</dependency> 

<!– jakarta命名空间版本（Tomcat 10.x及以上版本支持） –> 

<dependency> 

    <groupId>jakarta.mail</groupId> 

    <artifactId>jakarta.mail-api</artifactId> 

    <version>2.0.1</version> <!– 对应的参考实现为：com.sun.mail:jakarta.mail –> 

    <!– <version>1.6.7</version> 此版本命名空间同javax –> 

</dependency> 

版本历程

JavaMail的最新版本是1.6.2，于2018.08发布。

javax.mail-api.jar是JavaMail的API，一般无需单独引入。即使需要引入，scope使用provide即可。com.sun.mail:javax.mail.jar是JavaMail的参考实现，包括SMTP、IMAP和POP3等常见协议的实现。

说明：“自古”传出的发邮件需要导入两个jar包，中的activtion.jar不是必须的，一个mail.jar大部分情况下就够了

值得注意的是：借助Spring发送邮件，并没有spring-mail独立模块(相关类在spring-context-support这个模块里)，只有Spring Boot提供的spring-boot-starter-mail独立启动器。

生存现状

不可或缺，且已非常成熟。

实现(框架)

com.sun.mail:javax.mail或者com.sun.mail:jakarta.mail即为官方参考实现，Spring Boot也是使用它来发送邮件的。

代码示例

生产环境当然建议使用Spring(or Spring Boot)提供的mail能力来发送邮件，非常简单方便。本文加点料，直接使用底层API来试试。

JavaMail API 按照功能可以划分为如下三大类：

创建和解析邮件的API

发送邮件的API

接收邮件的API

这三大类涉及到很多类，但核心的只有4个，也就是俗称的JavaMail四大核心类。如下图所示：

绝大部分情况下，我们只需使用JavaMail发送邮件即可，也就是三个类：

Session：用于定义整个应用程序所需的环境信息。如主机名、端口、邮件协议等等

Message：邮件内容。通常使用它的子类javax.mail.internet.MimeMessage 类。还有如SMTPMessage、SMTPMessage等等

Transport：发送邮件的核心API 类

下面笔者使用JavaMail API发送一封邮件到自己的邮箱：yourbatman@aliyun.com，代码如下。

准备基础发送、接收人元信息：

// =====发送者信息====== 

public static final String SENDER_ADDRESS = "641385712@qq.com"; 

public static final String SENDER_ACCOUNT = "641385712@qq.com"; 

public static final String SENDER_PASSWORD = "xxxxxxxxxxxxx"; // QQ邮箱这里使用授权码登录，而不是密码哦 

public static final String SENDER_QQ_SMTP_SERVER = "smtp.qq.com"; 

// =====收件人信息====== 

public static final String RECIPIENT_ADDRESS = "yourbatman@aliyun.com"; 

什么是QQ邮箱登录授权码?就是这个东东(具体怎么获得，自己用谷歌百度一下)：

调用API，书写发送邮件的代码：

/** 

 * 发送邮件 

 * @param args 

 * @throws Exception 

 */ 

public static void main(String[] args) throws Exception { 

    Properties props = new Properties(); 

    props.setProperty("mail.smtp.auth", "true"); //用户的认证方式 

    props.setProperty("mail.transport.protocol", "smtp"); // 传输协议 

    props.setProperty("mail.smtp.host", SENDER_QQ_SMTP_SERVER); // 发件人的SMTP服务器地址 

    Session session = Session.getInstance(props); 

    session.setDebug(true); // 在控制台打印调试信息 

    // ======创建一封邮件====== 

    Message msg = createMimeMessage(session); 

    // ======准备发送====== 

    Transport transport = session.getTransport(); 

    transport.connect(SENDER_ACCOUNT, SENDER_PASSWORD); 

    transport.sendMessage(msg, msg.getAllRecipients()); // 发送邮件（包括） 

    //如果只想发送给指定的人，可以如下写法 

    //transport.sendMessage(msg, new Address[]{new InternetAddress("xxx@qq.com")}); 

    transport.close(); 

} 

private static MimeMessage createMimeMessage(Session session) throws Exception { 

    MimeMessage msg = new MimeMessage(session); 

    msg.setFrom(new InternetAddress(SENDER_ADDRESS)); // 设置发件人地址 

    /** 

     * 设置收件人地址（可以增加多个收件人、抄送、密送），即下面这一行代码书写多行 

     * MimeMessage.RecipientType.TO:发送 

     * MimeMessage.RecipientType.CC：抄送 

     * MimeMessage.RecipientType.BCC：密送 

     */ 

    msg.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(RECIPIENT_ADDRESS)); 

    msg.setSubject("我是邮件主题", "UTF-8"); 

    msg.setContent("我是简单的纯文本邮件！", "text/html;charset=UTF-8"); 

    msg.setSentDate(new Date()); // 邮件的发送时间,默认立即发送 

    return msg; 

} 

运行程序，收到邮件，完美!

控制台的debug日志可以窥探这个发送过程：

DEBUG: setDebug: Jakarta Mail version 1.6.7 

DEBUG: getProvider() returning javax.mail.Provider[TRANSPORT,smtp,com.sun.mail.smtp.SMTPTransport,Oracle] 

DEBUG SMTP: useEhlo true, useAuth true 

DEBUG SMTP: trying to connect to host "smtp.qq.com", port 25, isSSL false 

220 newxmesmtplogicsvrszb6.qq.com XMail Esmtp QQ Mail Server. 

DEBUG SMTP: connected to host "smtp.qq.com", port: 25 

EHLO 192.168.0.145 

250-newxmesmtplogicsvrszb6.qq.com 

250-PIPELINING 

250-SIZE 73400320 

250-STARTTLS 

250-AUTH LOGIN PLAIN XOAUTH XOAUTH2 

250-AUTH=LOGIN 

250-MAILCOMPRESS 

250 8BITMIME 

DEBUG SMTP: Found extension "PIPELINING", arg "" 

DEBUG SMTP: Found extension "SIZE", arg "73400320" 

DEBUG SMTP: Found extension "STARTTLS", arg "" 

DEBUG SMTP: Found extension "AUTH", arg "LOGIN PLAIN XOAUTH XOAUTH2" 

DEBUG SMTP: Found extension "AUTH=LOGIN", arg "" 

DEBUG SMTP: Found extension "MAILCOMPRESS", arg "" 

DEBUG SMTP: Found extension "8BITMIME", arg "" 

DEBUG SMTP: protocolConnect login, host=smtp.qq.com, user=641385712@qq.com, password=<non-null> 

DEBUG SMTP: Attempt to authenticate using mechanisms: LOGIN PLAIN DIGEST-MD5 NTLM XOAUTH2  

DEBUG SMTP: Using mechanism LOGIN 

DEBUG SMTP: AUTH LOGIN command trace suppressed 

DEBUG SMTP: AUTH LOGIN succeeded 

DEBUG SMTP: use8bit false 

MAIL FROM:<641385712@qq.com> 

250 OK. 

RCPT TO:<yourbatman@aliyun.com> 

250 OK 

DEBUG SMTP: Verified Addresses 

DEBUG SMTP:   yourbatman@aliyun.com 

DATA 

354 End data with <CR><LF>.<CR><LF>. 

Date: Wed, 6 Oct 2021 20:37:54 +0800 (CST) 

From: 641385712@qq.com 

To: yourbatman@aliyun.com 

Message-ID: <683287027.0.1633523875105@[192.168.0.145]> 

Subject: =?UTF-8?B?5oiR5piv6YKu5Lu25Li76aKY?= 

MIME-Version: 1.0 

Content-Type: text/html;charset=UTF-8 

Content-Transfer-Encoding: base64 

5oiR5piv566A5Y2V55qE57qv5paH5pys6YKu5Lu277yB 

. 

250 OK: queued as. 

DEBUG SMTP: message successfully delivered to mail server 

QUIT 

221 Bye. 

Process finished with exit code 0 

本专栏源代码：https://github.com/yourbatman/FXP-java-ee

JDBC

Java Data Base Connectivity：Java数据库连接。是一种用于执行SQL语句的Java API，可以为多种关系数据库提供统一访问，它由一组用Java语言编写的类和接口组成。根本上说JDBC是一种规范，它提供的接口，一套完整的，允许便捷式访问底层数据库。

简单而言，JDBC就是Java执行SQL语句进行数据库操作的API。

不同的数据库都有其自己的Driver驱动程序，为了便于开发者使用，Sun公司出手了：制定JDBC规范，统一了标准。

JDBC无需单独导包，包含在Java SE里

版本历程

在JDK 1.0时JDBC只是个可选组件，到JDK 1.1开始成为了Java SE的一部分，也就是java.sql类包。所以：JDBC 1.0是随着JDK 1.1一起发布的。

总的来讲，JDBC发展到4.0版本就已经非常完善了，使用起来非常的方便。

生存现状

虽然NoSQL如日中天，但传统的RDBMS不可或缺，所以JDBC是必备的技能。

实现(框架)

无。

代码示例

JDBC不同的版本代码使用方式不尽相同，下面基于Java 8(也就是JDBC 4.2)来给个示例。所谓的JDBC四大步骤/四大参数，今天它来啦：

/** 

 * 在此处添加备注信息 

 * 

 * @author YourBatman. <a href=mailto:yourbatman@aliyun.com>Send email to me</a> 

 * @site https://yourbatman.cn 

 * @date 2021/10/6 21:20 

 * @since 0.0.1 

 */ 

public class JDBCDemo { 

    // ==================JDBC 四大参数 ====================== 

    public static final String DB_DRIVER = "com.mysql.cj.jdbc.Driver"; 

    public static final String DB_URL = "jdbc:mysql://localhost:3306/demo?useSSL=false&serverTimezone=UTC"; 

    public static final String DB_USER = "root"; 

    public static final String DB_PASS = "root"; 

    public static void main(String[] args) throws Exception { 

        Class.forName(DB_DRIVER); 

        try (Connection conn = DriverManager.getConnection(DB_URL, DB_USER, DB_PASS); 

             PreparedStatement pstmt = conn.prepareStatement("SELECT id,name,age FROM user", ResultSet.TYPE_SCROLL_SENSITIVE, ResultSet.CONCUR_READ_ONLY)) { 

            // ==============获取到连接后，即可开始操作数据库================== 

            ResultSet rs = pstmt.executeQuery(); 

            //进行结果集滚动操作 打印结果集 

            System.out.println("第二条数据：" + rs.getLong("id")); 

            rs.absolute(1); 

            System.out.println("第一条数据：" + rs.getLong("id")); 

            rs.beforeFirst(); 

            System.out.println("最后一条数据：" + rs.getLong("id")); 

            rs.afterLast(); 

            // 关闭结果集（应该在finally关闭） 

            rs.close(); 

        } 

    } 

} 

这就是使用原生JDBC操作数据库的简单代码示例。

工程源代码：https://github.com/yourbatman/FXP-java-ee

总结

本文通过讲解发展历程、代码示例分别介绍了两项技术：

JavaMail：使用Java语言发送邮件(还可以接收邮件哦)

JDBC：Java操作数据库的统一抽象层

这里多聊一句：大多数小伙伴可能觉得使用JDBC操作DB毫无意义，其实不然!笔者在面试候选人的时候问JDBC的内容还算比较高频的，我的原因很简单：它很重要，是理解MyBatis、Hibernate等框架的内核。另外，几乎每个候选人简历里都会写“对技术感兴趣”，所以是否真的有“技术范”总得拉出来遛一遛吧!