Simple Java Mail快速入门：5分钟上手发送你的第一封邮件

Simple Java Mail快速入门：5分钟上手发送你的第一封邮件

【免费下载链接】simple-java-mail Simple API, Complex Emails (Jakarta Mail smtp wrapper) 项目地址: https://gitcode.com/gh_mirrors/si/simple-java-mail

Simple Java Mail是一个功能强大的Jakarta Mail SMTP封装库，它提供了简洁的API来处理复杂的邮件发送需求。无论是简单的文本邮件还是带有附件的HTML邮件，Simple Java Mail都能让你轻松实现。本文将带你快速掌握这个工具的基本使用方法，在5分钟内发送你的第一封邮件。

准备工作：获取Simple Java Mail

要开始使用Simple Java Mail，首先需要将它添加到你的项目中。如果你使用Maven，可以在pom.xml中添加以下依赖：

<dependency>
    <groupId>org.simplejavamail</groupId>
    <artifactId>simple-java-mail</artifactId>
    <version>最新版本</version>
</dependency>

你可以通过克隆仓库获取最新代码：

git clone https://gitcode.com/gh_mirrors/si/simple-java-mail

核心功能模块介绍

Simple Java Mail的核心功能分布在多个模块中，主要包括：

• core-module：提供基础的邮件构建和发送功能，定义了Email和Mailer等核心接口。
• simple-java-mail：包含邮件发送的实现类，如MailerImpl和EmailBuilder。
• smime-module：提供S/MIME加密和签名功能，确保邮件的安全性。

三步发送你的第一封邮件

第一步：构建邮件内容

使用EmailBuilder创建一个简单的邮件：

Email email = EmailBuilder.startingBlank()
    .from("发件人", "sender@example.com")
    .to("收件人", "recipient@example.com")
    .withSubject("这是我的第一封邮件")
    .withPlainText("Hello, Simple Java Mail!")
    .buildEmail();

第二步：配置邮件服务器

通过MailerBuilder配置SMTP服务器信息：

Mailer mailer = MailerBuilder.withSMTPServer("smtp.example.com", 587, "username", "password")
    .withTransportStrategy(TransportStrategy.SMTP_TLS)
    .buildMailer();

第三步：发送邮件

调用mailer.send()方法发送邮件：

mailer.send(email);
System.out.println("邮件发送成功！");

进阶功能探索

添加附件

Simple Java Mail支持轻松添加附件：

Email email = EmailBuilder.startingBlank()
    // ...其他配置
    .withAttachment("文档.pdf", new FileDataSource("path/to/document.pdf"))
    .buildEmail();

发送HTML邮件

你可以发送精美的HTML邮件：

Email email = EmailBuilder.startingBlank()
    // ...其他配置
    .withHTMLText("<h1>Hello</h1><p>这是一封HTML邮件</p>")
    .buildEmail();

邮件加密与签名

利用smime-module提供的功能，你可以对邮件进行加密和签名：

Email email = EmailBuilder.startingBlank()
    // ...其他配置
    .withSmimeSigning(new SmimeSigningConfig.Builder()
        .withSigningCertificate(new File("cert.p12"), "password")
        .build())
    .buildEmail();

常见问题解决

连接超时问题

如果遇到连接超时，检查SMTP服务器地址和端口是否正确，或者尝试更改传输策略：

MailerBuilder.withTransportStrategy(TransportStrategy.SMTPS)

认证失败问题

确保你的用户名和密码正确，有些邮箱需要开启"允许第三方应用访问"选项。

总结

Simple Java Mail为Java开发者提供了一个简单而强大的邮件发送解决方案。通过本文介绍的基本步骤，你已经可以发送简单的邮件了。要了解更多高级功能，可以查阅项目中的文档或源码，特别是modules/core-module和modules/simple-java-mail目录下的代码。

希望这篇快速入门指南能帮助你在5分钟内掌握Simple Java Mail的基本使用，开始你的邮件发送之旅！

【免费下载链接】simple-java-mail Simple API, Complex Emails (Jakarta Mail smtp wrapper) 项目地址: https://gitcode.com/gh_mirrors/si/simple-java-mail