在Java项目中配置JavaMail库

第1章前言

JavaMail是一个用于发送和接收电子邮件的开放源代码库。本文将详细介绍如何在Java项目中配置JavaMail库。

第2章环境准备

在配置JavaMail库之前，我们需要确保以下环境已经配置好：

安装JDK（Java Development Kit），建议使用JDK 8及以上版本。
配置好IDE（集成开发环境），推荐使用Eclipse或IntelliJ IDEA。

第3章配置JavaMail库

3.1 使用Maven配置JavaMail库

使用Maven可以简化依赖管理，自动处理库的下载和更新。通过以下步骤在Maven项目中配置JavaMail库：

3.1.1 创建Maven项目

如果还没有创建Maven项目，可以按照以下步骤创建一个新的Maven项目：

打开IDE（例如IntelliJ IDEA）。
选择File -> New -> Project。
选择Maven，然后点击Next。
输入项目名称和基本信息，然后点击Finish。

3.1.2 修改`pom.xml`文件

在Maven项目中，所有依赖项都在pom.xml文件中声明。打开项目中的pom.xml文件，并添加以下内容来引入JavaMail库：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.example</groupId>
  <artifactId>JavaMailExample</artifactId>
  <version>1.0-SNAPSHOT</version>

  <dependencies>
    <dependency>
      <groupId>com.sun.mail</groupId>
      <artifactId>javax.mail</artifactId>
      <version>1.6.2</version>
    </dependency>
  </dependencies>
</project>

3.2 手动添加JavaMail库

如果没有使用Maven，可以手动下载并添加JavaMail库到你的项目中。

3.2.1 下载JavaMail库

从JavaMail官网下载最新版本的JavaMail库。

3.2.2 添加库文件到项目

将下载好的JavaMail库（jar文件）复制到项目的lib目录，并在IDE中配置正确的依赖关系。以下是如何在Eclipse中配置依赖项的步骤：

右键点击项目名称，选择Properties。
选择Java Build Path，点击Libraries标签。
点击Add JARs按钮，选择项目中的jar文件，并点击确定。

第4章示例代码

完成配置后，可以编写示例代码来验证JavaMail库是否配置成功。

4.1 发送邮件示例

以下代码演示了如何使用JavaMail库发送邮件：

import java.util.Properties;
import javax.mail.*;
import javax.mail.internet.*;

public class MailSender {

    public static void sendMail(String host, String port, final String userName, final String password, String toAddress,
                                String subject, String message) throws AddressException, MessagingException {

        // 设置SMTP服务器属性
        Properties properties = new Properties();
        properties.put("mail.smtp.host", host);
        properties.put("mail.smtp.port", port);
        properties.put("mail.smtp.auth", "true");
        properties.put("mail.smtp.starttls.enable", "true");

        // 创建新会话并获取MimeMessage对象
        Authenticator auth = new Authenticator() {
            public PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication(userName, password);
            }
        };
        Session session = Session.getInstance(properties, auth);

        // 创建邮件消息
        Message msg = new MimeMessage(session);
        msg.setFrom(new InternetAddress(userName));
        InternetAddress[] toAddresses = { new InternetAddress(toAddress) };
        msg.setRecipients(Message.RecipientType.TO, toAddresses);
        msg.setSubject(subject);
        msg.setSentDate(new java.util.Date());
        msg.setText(message);

        // 发送邮件
        Transport.send(msg);
    }

    public static void main(String[] args) {
        // SMTP服务器信息
        String host = "smtp.gmail.com";
        String port = "587";
        String mailFrom = "your-email@gmail.com";
        String password = "your-email-password";
        
        // 收信人信息
        String mailTo = "recipient-email@gmail.com";
        String subject = "Hello Java";
        String message = "Hi there! This email was sent from a Java program.";

        try {
            sendMail(host, port, mailFrom, password, mailTo, subject, message);
            System.out.println("Email sent successfully.");
        } catch (Exception ex) {
            ex.printStackTrace();
            System.out.println("Failed to send email.");
        }
    }
}

4.2 接收邮件示例

以下代码演示了如何使用JavaMail库接收邮件：

import java.util.Properties;
import javax.mail.*;
import javax.mail.internet.MimeMultipart;

public class MailReceiver {

    public static void receiveMail(String host, String port, String userName, String password) {
        try {
            // 设置IMAP服务器属性
            Properties properties = new Properties();
            properties.put("mail.imap.host", host);
            properties.put("mail.imap.port", port);
            properties.put("mail.imap.starttls.enable", "true");
            
            // 创建Session实例
            Session emailSession = Session.getInstance(properties);

            // 创建IMAP store对象并连接到邮件服务器
            Store store = emailSession.getStore("imap");
            store.connect(userName, password);

            // 获取INBOX文件夹
            Folder emailFolder = store.getFolder("INBOX");
            emailFolder.open(Folder.READ_ONLY);

            // 获取所有邮件
            Message[] messages = emailFolder.getMessages();
            for (int i = 0; i < messages.length; i++) {
                Message message = messages[i];
                System.out.println("---------------------------------");
                System.out.println("Email Number " + (i + 1));
                System.out.println("Subject: " + message.getSubject());
                System.out.println("From: " + message.getFrom()[0]);
                System.out.println("Text: " + getTextFromMessage(message));
            }

            // 关闭文件夹和store对象
            emailFolder.close(false);
            store.close();

        } catch (NoSuchProviderException e) {
            e.printStackTrace();
        } catch (MessagingException e) {
            e.printStackTrace();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    private static String getTextFromMessage(Message message) throws Exception {
        String result = "";
        if (message.isMimeType("text/plain")) {
            result = message.getContent().toString();
        } else if (message.isMimeType("multipart/*")) {
            MimeMultipart mimeMultipart = (MimeMultipart) message.getContent();
            result = getTextFromMimeMultipart(mimeMultipart);
        }
        return result;
    }

    private static String getTextFromMimeMultipart(MimeMultipart mimeMultipart) throws Exception {
        String result = "";
        int count = mimeMultipart.getCount();
        for (int i = 0; i < count; i++) {
            BodyPart bodyPart = mimeMultipart.getBodyPart(i);
            if (bodyPart.isMimeType("text/plain")) {
                result = result + "\n" + bodyPart.getContent();
                break;  // without break same text appears twice in my tests
            } else if (bodyPart.isMimeType("text/html")) {
                String html = (String) bodyPart.getContent();
                result = result + org.jsoup.Jsoup.parse(html).text();
            }
        }
        return result;
    }

    public static void main(String[] args) {
        // IMAP服务器信息
        String host = "imap.gmail.com";
        String port = "993";
        String mailUser = "your-email@gmail.com";
        String mailPassword = "your-email-password";
        
        receiveMail(host, port, mailUser, mailPassword);
    }
}

第5章总结

通过以上步骤和示例代码，我们介绍了如何在Java项目中配置JavaMail库，并实现基本的邮件发送和接收功能。希望这些内容对你有所帮助。

第6章参考资料

JavaMail API documentation
Official Gmail SMTP and IMAP settings

秒客网

在Java项目中配置JavaMail库