使用Apache commons email傳送郵件

康帝發表於2020-06-16
ApacheAI

今天研究了一下怎麼用java程式碼傳送郵件，用的是Apache的commons-email包。

據說這個包是對javamail進行了封裝，簡化了操作。 這裡講一下具體用法吧

 

一.首先你需要有郵箱賬號和一個授權碼。

需要進入到QQ郵箱或者是網易郵箱裡面去獲取。在郵箱的設定->賬戶裡面，開啟如下服務，就能得到一個授權碼，這個授權碼要好好保管。有了這兩個東西就能夠通過第三方客戶端傳送郵件了。

 

二.匯入commons-email的maven依賴。

我用的是1.4，也可以去maven倉庫網站（https://mvnrepository.com）上面找別的版本。

<dependency>
     <groupId>org.apache.commons</groupId>
     <artifactId>commons-email</artifactId>
     <version>1.4</version>
 </dependency>

三.然後就可以寫傳送郵件的程式碼了。

我在網上找了幾個案例，如下。

 1.傳送簡單文字郵件。這是最簡單也是最常用的。

    /**
     * @describe 傳送內容為簡單文字的郵件
     * @throws EmailException
     */
    public static void sendSimpleTextEmail() throws EmailException {
         Email email = new SimpleEmail();
         //設定主機名,QQ郵箱是"smtp.qq.com",網易郵箱是"smtp.163.com"
         email.setHostName("smtp.163.com");
         // 使用者名稱和密碼為郵箱的賬號和授權碼（不需要進行base64編碼）
         email.setAuthenticator(new DefaultAuthenticator("myemailaddress@163.com", "myshouquanma"));
         //設定SSL連線,這樣寫就對了
         email.setSSLOnConnect(true);
         //設定來源,就是傳送方的郵箱地址
         email.setFrom("myemailaddress@163.com");
         //設定主題,可以不設定
         email.setSubject("java傳送郵件");
         //設定資訊,就是內容,這個必須要有
         email.setMsg("這是測試郵件 ... :-)");
         //接收人郵箱地址
         email.addTo("receiveeraddress@qq.com");
         email.send();
    }

 

2.傳送包含附件的郵件（附件為本地資源），這裡用到了一個EmailAttachment物件，也就是附件的意思

    /**
     * @describe 傳送包含附件的郵件（附件為本地資源）
     * @throws EmailException
     */
    public static void sendEmailsWithAttachments() throws EmailException {
        // 建立一個attachment（附件）物件
        EmailAttachment attachment = new EmailAttachment();
        //設定上傳附件的地址
        attachment.setPath("C:\\Users\\Administrator\\Pictures\\Saved Pictures\\conti.png");
        attachment.setDisposition(EmailAttachment.ATTACHMENT);
        //這個描述可以隨便寫
        attachment.setDescription("Picture of conti");
        //這個名稱要注意和檔案格式一致,這將是接收人下載下來的檔名稱
        attachment.setName("conti.png");

        //因為要上傳附件，所以用MultiPartEmail()方法建立一個email物件，固定步驟都是一樣的
        MultiPartEmail email = new MultiPartEmail();
        email.setHostName("smtp.163.com");
        email.setAuthenticator(new DefaultAuthenticator("myemailaddress@163.com", "myshouquanma"));
        email.setSSLOnConnect(true);
        email.addTo("receiveemail@qq.com", "Conti Zhang");
        email.setFrom("myemailaddress@163.com", "Me");
        email.setSubject("圖片");
        email.setMsg("這是傳送給你的圖片");
        //將附件新增到郵件
        email.attach(attachment);

        email.send();
    }

 

3.傳送包含附近的郵件（附件為線上資源），這個與上傳本地附件稍有區別，注意一下就行

 　　/**
     * @describe 傳送包含附件的郵件（附件為線上資源）
     * @throws EmailException
     * @throws MalformedURLException
     */
    public static void sendEmailsWithOnlineAttachments() throws EmailException, MalformedURLException {
        EmailAttachment attachment = new EmailAttachment();
        //設定線上資源路徑，和上傳本地附件的唯一區別
        attachment.setURL(new URL("http://www.apache.org/images/asf_logo_wide.gif"));
        attachment.setDisposition(EmailAttachment.ATTACHMENT);
        attachment.setDescription("Apache logo");
        attachment.setName("Apache logo.gif");

        MultiPartEmail email = new MultiPartEmail();
        email.setHostName("smtp.163.com");
        email.setAuthenticator(new DefaultAuthenticator("myemailaddress@163.com", "myshouquanma"));
        email.setSSLOnConnect(true);
        email.addTo("receiveemail@qq.com", "Conti Zhang");
        email.setFrom("myemailaddress@163.com", "Me");
        email.setSubject("The logo");
        email.setMsg("Here is Apache's logo");
        email.attach(attachment);
        email.send();
    }

 

4.傳送內容為HTML格式的郵件，有些郵件直接開啟就是一個HTML頁面。雖然不一定用到，可以瞭解一下

 　　/**
     * @describe 傳送內容為HTML格式的郵件
     * @throws EmailException
     * @throws MalformedURLException
     */
    public static void sendHTMLFormattedEmail() throws EmailException, MalformedURLException {
        // 這裡需要使用HtmlEmail建立一個email物件
        HtmlEmail email = new HtmlEmail();
        email.setHostName("smtp.163.com");
        email.setAuthenticator(new DefaultAuthenticator("myemailaddresss@163.com", "myshouquanma"));
        email.addTo("receiveemail@qq.com", "Conti Zhang");
        email.setFrom("myemailaddress@163.com", "Me");
        email.setSubject("Test email with inline image");

        // 嵌入影像並獲取內容id,雖然案例這樣寫，但我感覺直接在html內容裡面寫圖片網路地址也可以
        URL url = new URL("http://www.apache.org/images/asf_logo_wide.gif");
        String cid = email.embed(url, "Apache logo");

        // 設定html內容
        email.setHtmlMsg("<html>The apache logo - <img src=\"cid:" + cid + "\"></html>");

        // 設定替代內容，如果不支援html
        email.setTextMsg("你的郵件客戶端不支援html郵件");
        email.send();
    }

 

5.傳送內容為HTML格式的郵件（嵌入圖片更方便）

這裡用到了DataSourceFileResolver物件，和DataSourceUrlResolver物件，前者可以解析本地檔案路徑，後者可以解析網路路徑

具體用法如下

    /**
     * @describe 傳送內容為HTML格式的郵件（嵌入圖片更方便）
     * @throws MalformedURLException
     * @throws EmailException
     */
    public static void sendHTMLFormattedEmailWithEmbeddedImages() throws MalformedURLException, EmailException {
        //html郵件模板
        String htmlEmailTemplate = "<img src=\"http://www.conti.com/images/1.jpg\">";
        DataSourceResolver[] dataSourceResolvers =new DataSourceResolver[]{new DataSourceFileResolver(),new DataSourceUrlResolver(new URL("http://"))};
        email.setDataSourceResolver(new DataSourceCompositeResolver(dataSourceResolvers));
        email.setHostName("smtp.qq.com");
        email.setAuthenticator(new DefaultAuthenticator("myemailaddress@qq.com", "myshouquanma"));
        email.addTo("receiveemail@qq.com", "Conti Zhang");
        email.setFrom("myemailaddress@qq.com", "Me");
        email.setSubject("Test email with inline image");
        email.setHtmlMsg(htmlEmailTemplate);
        email.setTextMsg("你的郵件客戶端不支援html郵件");

        email.send();
    }

此種方式可能會報錯，會被郵箱認為是有害郵件不接收而導致傳送失敗。解決方法就是，網易郵箱不行就換QQ郵箱，我就是這樣做的

 

好了，就這麼多，歡迎討論！

 

相關文章