JavaMailを使った画像や添付ファイルの送信、メールの受信方法を詳しく解説

この記事では、主に JavaMail での画像と添付ファイル付きのメールの送受信の実装について詳しく紹介します。興味のある方は参考にしてください。それでは、この一連のチュートリアルの最も重要な手順に入りましょう。上記の電子メールの理論的知識は誰もが理解しているので、このブログではコードを使用して電子メールの送信を完了します。実際のプロジェクトでは、アカウントのアクティベーションのためにメールを送信する必要がある登録や、OA プロジェクトでのタスクのリマインダーにメールを使用するなど、実際のプロジェクトで広く使用されています。ここで話しているのは、JavaMail を使用して電子メールの送受信機能を完了することです。

PS: このブログのソースコードのダウンロードリンク: https://github.com/YSOcean/cnblogs

1. JavaMail の紹介

JavaMail は、 Java 開発者のアプリケーション 電子メールの送受信機能を実装するためにプログラムで提供される一連の標準開発キット。前述の SMTP、POP3、IMAP、MIME などの一般的に使用される電子メール プロトコルをサポートします。 JavaMail API を使用して電子メールを作成する場合、電子メールの基礎となる実装の詳細を考慮する必要はありません。必要なのは、JavaMail 開発キット内の対応する API クラスを呼び出すことだけです。

JavaMailのダウンロードアドレス: https://github.com/javaee/javamail/releases

SMTP、IMAP、POP3プロトコルの実装を含むこのバージョンのJavaMailをダウンロードします。

2. JavaMail API

JavaMail APIは、その機能に応じて次の3つに分類できます:

①、メールの作成と解析を行うAPI

②、メールを送信するAPI

③、受信を行うAPI JavaMailでは上記3種類のAPIは複数のクラスで構成されていますが、プログラムを書く際には主に4つのコアクラスがあり、この4つのコアクラスを覚えておくと簡単にJavaメール処理プログラムを書くことができます。

①、メッセージクラス：javax.mail.Messageクラスはメールの作成と解析を行うためのコアAPIであり、通常はそのサブクラスであるjavax.mail.internet.MimeMessageクラスが使用されます。そのインスタンス オブジェクトは電子メールを表します。クライアント プログラムが電子メールを送信するときは、まず電子メールを作成する JavaMail API を使用して電子メール データをカプセル化する Message オブジェクトを作成し、このオブジェクトを電子メール送信 API (Transport クラス) に渡して送信します。クライアント プログラムがメールを受信すると、メール受信 API は受信したメール データを Message クラスのインスタンスにカプセル化します。クライアント プログラムは、メール解析 API を使用して、このオブジェクトから受信したメール データを解析します。

②. Transport クラス: javax.mail.Transport クラスは、クライアント プログラムがメッセージを作成した後、SMTP プロトコルなどの特定のメール送信プロトコルを実装するメール送信オブジェクトを表します。 object を使用する場合は、メール送信 API を使用して Transport オブジェクトを取得し、次に Message オブジェクトを Transport オブジェクトに渡し、その送信メソッドを呼び出して指定された SMTP サーバーにメールを送信するだけです。

③. ストアクラス: javax.mail.Store クラスは、メールを受信するためのコア API クラスであり、そのインスタンス オブジェクトは、クライアント プログラムがメールを受信するときに、特定のメール受信プロトコルを実装します。メール受信 API を使用して Store オブジェクトを取得し、Store オブジェクトの受信メソッドを呼び出して、指定した POP3 サーバーからメール データを取得し、メールを表す Message オブジェクトにメール データをカプセル化する必要があります。

④. セッションクラス: javax.mail.Session クラスは、アプリケーション全体に必要な環境情報を定義し、クライアントがメールサーバーとのネットワーク接続を確立するためのホスト名などのセッション情報を収集するために使用されます。ポート番号、メールサーバーの送受信プロトコルなど。 Session オブジェクトは、この情報に基づいて電子メールを送受信するための Transport オブジェクトと Store オブジェクトを構築し、クライアントの Message オブジェクトを作成するときに情報サポートを提供します。

3. JavaMail を使用して単純なプレーンテキストメールを送信します

電子メールを送信するための次のコードを理解すると、衛星を運ぶロケットのように電子メールを送信することを想像できます。このうち、Message は衛星、Transport はロケットです。衛星やロケットの構築にはセッションの助けが必要です。

package com.ys.mail;
 
import java.io.ObjectInputStream.GetField;
import java.util.Date;
import java.util.Properties;
 
import javax.mail.Address;
import javax.mail.Message;
import javax.mail.MessagingException;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.AddressException;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import javax.swing.text.html.MinimalHTMLWriter;
 
public class SendMailText {
 //发件人地址
 public static String senderAddress = "xxx@163.com";
 //收件人地址
 public static String recipientAddress = "xxx@qq.com";
 //发件人账户名
 public static String senderAccount = "xxx";
 //发件人账户密码
 public static String senderPassword = "xxx";
 
 public static void main(String[] args) throws Exception {
 //1、连接邮件服务器的参数配置
 Properties props = new Properties();
 //设置用户的认证方式
 props.setProperty("mail.smtp.auth", "true");
 //设置传输协议
 props.setProperty("mail.transport.protocol", "smtp");
 //设置发件人的SMTP服务器地址
 props.setProperty("mail.smtp.host", "smtp.163.com");
 //2、创建定义整个应用程序所需的环境信息的 Session 对象
 Session session = Session.getInstance(props);
 //设置调试信息在控制台打印出来
 session.setDebug(true);
 //3、创建邮件的实例对象
 Message msg = getMimeMessage(session);
 //4、根据session对象获取邮件传输对象Transport
 Transport transport = session.getTransport();
 //设置发件人的账户名和密码
 transport.connect(senderAccount, senderPassword);
 //发送邮件，并发送到所有收件人地址，message.getAllRecipients() 获取到的是在创建邮件对象时添加的所有收件人, 抄送人, 密送人
 transport.sendMessage(msg,msg.getAllRecipients());
  
 //如果只想发送给指定的人，可以如下写法
 //transport.sendMessage(msg, new Address[]{new InternetAddress("xxx@qq.com")});
  
 //5、关闭邮件连接
 transport.close();
 }
 
 /**
 * 获得创建一封邮件的实例对象
 * @param session
 * @return
 * @throws MessagingException
 * @throws AddressException
 */
 public static MimeMessage getMimeMessage(Session session) throws Exception{
 //创建一封邮件的实例对象
 MimeMessage msg = new MimeMessage(session);
 //设置发件人地址
 msg.setFrom(new InternetAddress(senderAddress));
 /**
  * 设置收件人地址（可以增加多个收件人、抄送、密送），即下面这一行代码书写多行
  * MimeMessage.RecipientType.TO:发送
  * MimeMessage.RecipientType.CC：抄送
  * MimeMessage.RecipientType.BCC：密送
  */
 msg.setRecipient(MimeMessage.RecipientType.TO,new InternetAddress(recipientAddress));
 //设置邮件主题
 msg.setSubject("邮件主题","UTF-8");
 //设置邮件正文
 msg.setContent("简单的纯文本邮件！", "text/html;charset=UTF-8");
 //设置邮件的发送时间,默认立即发送
 msg.setSentDate(new Date());
  
 return msg;
 }
 
}

上記のコードには詳細なコメントが付いていますので、わからない場合はメッセージを残してください。注: 実行時に受信者、送信者などの情報を自分のものに変更してください。

上記のコードを実行した後、受信箱を確認します:

その後、単純なプレーンテキストファイルが送信されています。

4. メール送信の問題

①. 送信者のメールアカウント名とパスワード: 一部のメールには独自のパスワードが設定されており、その他のメールではログインに認証コードを使用する必要があります (qq メール)。このブログではpop3プロトコルを紹介しています。

　　②、发件人的SMTP服务器地址：一般是 smtp.xxx.com，比如163邮箱是smtp.163.com，qq邮箱是smtp.qq.com。

　　③、有可能你收件人地址，发件人地址等信息都正确了，控制台也打印了正确的信息，但是在收件箱就是收不到信息。这是因为可能收件箱服务器拒收了你发的邮件（比如认为你的邮件是广告），这时候可能在垃圾箱里能找到，可能找不到。解决办法是重复的邮件内容不要多次发送，或者更换收件箱试试。

　　④、本实例使用的是JavaMail1.6版本，支持的JDK必须是jdk1.7版本！！！

 5、使用 JavaMail 接收邮件

　　由于接收邮件的用处不多，这里我们就简单的给出一个实例：

package com.ys.mail;
 
import java.util.Properties;
import javax.mail.Address;
import javax.mail.Folder;
import javax.mail.Message;
import javax.mail.Session;
import javax.mail.Store;
 
public class RecipientMail {
 //收件人地址
 public static String recipientAddress = "xxx@163.com";
 //收件人账户名
 public static String recipientAccount = "xxx";
 //收件人账户密码
 public static String recipientPassword = "xxx";
 
 public static void main(String[] args) throws Exception {
 //1、连接邮件服务器的参数配置
 Properties props = new Properties();
 //设置传输协议
 props.setProperty("mail.store.protocol", "pop3");
 //设置收件人的POP3服务器
 props.setProperty("mail.pop3.host", "pop3.163.com");
 //2、创建定义整个应用程序所需的环境信息的 Session 对象
 Session session = Session.getInstance(props);
 //设置调试信息在控制台打印出来
 //session.setDebug(true);
  
 Store store = session.getStore("pop3");
 //连接收件人POP3服务器
 store.connect("pop3.163.com", recipientAccount, recipientPassword);
 //获得用户的邮件账户，注意通过pop3协议获取某个邮件夹的名称只能为inbox
 Folder folder = store.getFolder("inbox");
 //设置对邮件账户的访问权限
 folder.open(Folder.READ_WRITE);
  
 //得到邮件账户的所有邮件信息
 Message [] messages = folder.getMessages();
 for(int i = 0 ; i < messages.length ; i++){
  //获得邮件主题
  String subject = messages[i].getSubject();
  //获得邮件发件人
  Address[] from = messages[i].getFrom();
  //获取邮件内容（包含邮件内容的html代码）
  String content = (String) messages[i].getContent();
 }
  
 //关闭邮件夹对象
 folder.close();
 //关闭连接对象
 store.close();
 }
 
}

6、使用 JavaMail 发送带图片、附件的邮件

我们先看项目结构，在src目录下包含图片和附件：

然后看代码：

package com.ys.mail;
 
import java.util.Date;
import java.util.Properties;
 
import javax.activation.DataHandler;
import javax.activation.FileDataSource;
import javax.mail.Message;
import javax.mail.MessagingException;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.AddressException;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;
import javax.mail.internet.MimeUtility;
 
public class SendMailText_Picture_Enclosure {
 //发件人地址
 public static String senderAddress = "xxx@163.com";
 //收件人地址
 public static String recipientAddress = "xxx@qq.com";
 //发件人账户名
 public static String senderAccount = "xxx";
 //发件人账户密码
 public static String senderPassword = "xxx";
 
 public static void main(String[] args) throws Exception {
 //1、连接邮件服务器的参数配置
 Properties props = new Properties();
 //设置用户的认证方式
 props.setProperty("mail.smtp.auth", "true");
 //设置传输协议
 props.setProperty("mail.transport.protocol", "smtp");
 //设置发件人的SMTP服务器地址
 props.setProperty("mail.smtp.host", "smtp.163.com");
 //2、创建定义整个应用程序所需的环境信息的 Session 对象
 Session session = Session.getInstance(props);
 //设置调试信息在控制台打印出来
 session.setDebug(true);
 //3、创建邮件的实例对象
 Message msg = getMimeMessage(session);
 //4、根据session对象获取邮件传输对象Transport
 Transport transport = session.getTransport();
 //设置发件人的账户名和密码
 transport.connect(senderAccount, senderPassword);
 //发送邮件，并发送到所有收件人地址，message.getAllRecipients() 获取到的是在创建邮件对象时添加的所有收件人, 抄送人, 密送人
 transport.sendMessage(msg,msg.getAllRecipients());
  
 //5、关闭邮件连接
 transport.close();
 }
 
 /**
 * 获得创建一封邮件的实例对象
 * @param session
 * @return
 * @throws MessagingException
 * @throws AddressException
 */
 public static MimeMessage getMimeMessage(Session session) throws Exception{
 //1.创建一封邮件的实例对象
 MimeMessage msg = new MimeMessage(session);
 //2.设置发件人地址
 msg.setFrom(new InternetAddress(senderAddress));
 /**
  * 3.设置收件人地址（可以增加多个收件人、抄送、密送），即下面这一行代码书写多行
  * MimeMessage.RecipientType.TO:发送
  * MimeMessage.RecipientType.CC：抄送
  * MimeMessage.RecipientType.BCC：密送
  */
 msg.setRecipient(MimeMessage.RecipientType.TO,new InternetAddress(recipientAddress));
 //4.设置邮件主题
 msg.setSubject("邮件主题(包含图片和附件)","UTF-8");
  
 //下面是设置邮件正文
 //msg.setContent("简单的纯文本邮件！", "text/html;charset=UTF-8");
  
 // 5. 创建图片"节点"
 MimeBodyPart image = new MimeBodyPart();
 // 读取本地文件
 DataHandler dh = new DataHandler(new FileDataSource("src\\mailTestPic.png"));
 // 将图片数据添加到"节点"
 image.setDataHandler(dh);
 // 为"节点"设置一个唯一编号（在文本"节点"将引用该ID）
 image.setContentID("mailTestPic"); 
  
 // 6. 创建文本"节点"
 MimeBodyPart text = new MimeBodyPart();
 // 这里添加图片的方式是将整个图片包含到邮件内容中, 实际上也可以以 http 链接的形式添加网络图片
 text.setContent("这是一张图片<br/><a href=&#39;http://www.cnblogs.com/ysocean/p/7666061.html&#39;><img src=&#39;cid:mailTestPic&#39;/></a>", "text/html;charset=UTF-8");
  
 // 7. （文本+图片）设置 文本 和 图片"节点"的关系（将 文本 和 图片"节点"合成一个混合"节点"）
 MimeMultipart mm_text_image = new MimeMultipart();
 mm_text_image.addBodyPart(text);
 mm_text_image.addBodyPart(image);
 mm_text_image.setSubType("related"); // 关联关系
  
 // 8. 将 文本+图片 的混合"节点"封装成一个普通"节点"
 // 最终添加到邮件的 Content 是由多个 BodyPart 组成的 Multipart, 所以我们需要的是 BodyPart,
 // 上面的 mailTestPic 并非 BodyPart, 所有要把 mm_text_image 封装成一个 BodyPart
 MimeBodyPart text_image = new MimeBodyPart();
 text_image.setContent(mm_text_image);
  
 // 9. 创建附件"节点"
 MimeBodyPart attachment = new MimeBodyPart();
 // 读取本地文件
 DataHandler dh2 = new DataHandler(new FileDataSource("src\\mailTestDoc.docx"));
 // 将附件数据添加到"节点"
 attachment.setDataHandler(dh2);
 // 设置附件的文件名（需要编码）
 attachment.setFileName(MimeUtility.encodeText(dh2.getName())); 
  
 // 10. 设置（文本+图片）和 附件 的关系（合成一个大的混合"节点" / Multipart ）
 MimeMultipart mm = new MimeMultipart();
 mm.addBodyPart(text_image);
 mm.addBodyPart(attachment); // 如果有多个附件，可以创建多个多次添加
 mm.setSubType("mixed");  // 混合关系
 
 // 11. 设置整个邮件的关系（将最终的混合"节点"作为邮件的内容添加到邮件对象）
 msg.setContent(mm);
 //设置邮件的发送时间,默认立即发送
 msg.setSentDate(new Date());
  
 return msg;
 }
 
}

执行程序后，我们查看邮箱：

那么一封包含图片（点击图片跳转到指定超链接），和附件的邮件就生成了。

以上がJavaMailを使った画像や添付ファイルの送信、メールの受信方法を詳しく解説の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。