基于JavaMail的月曆(會議)郵件發送實作

JavaMail發送基本郵件ATA上有的是，但這次有個需求提出要實作會議郵件，呃，習慣性看有沒有同學已經實作了，居然少之又少，不知道是不是有其他團隊有這種需求，目測也不多哈哈，實作了這個功能感覺還挺有意思的，分享給大家交流交流。（可能有些了解不對，請大家指出，謝謝）

前期真的是比較懵圈，雖然一開始已經有實作了普通郵件發送，是通過Spring提供的MimeMessageHelper這個元件，說是擺脫繁雜的JavaMail API，封裝了一些實作，簡化了使用，但如果用這它去實作會議郵件，我試了很久都不行。呃，深入方法去看實作，呃，原來它的底層是MimeMessage，提供setText()也是。是以，我想如果要實作會議郵件，隻能考慮抛棄helper這個元件去用JavaMail API重新實作。中間聯系過阿裡雲郵的同學，他們告訴我沒有提供HSF服務或通用API，隻需要實作SMTP協定就可以了，行吧，開工。

實作效果圖先曬為敬：

郵件内容效果圖

月曆效果圖

下面講下實作代碼：

最關鍵是兩點，一是實作RFC2445标準（月曆資料交換），會議郵件的核心；二是了解JavaMail實作發送郵件的關聯，下面關聯圖的左邊部分就是了。沒實作前覺得挺難，了解了就是拼裝的事。

第一點我是利用 ical4j

實作的，maven(org.mnode.ical4j:ical4j:1.0.7)

郵件内容我是用velocity生成的String填充進去的，百度就有這裡不做介紹，freemarker大家也可以試試。

郵件中還可以根據需要添加附件，addBodyPart實作就可以了。

// 注入bean必備
    private final static String SSL_FACTORY = "javax.net.ssl.SSLSocketFactory";
    @Autowired
    private JavaMailSender mailSender;
    @Resource
    private VelocityEngine velocityEngine;

    // 請根據你們自己的需要或申請配置
    @Value("${spring.mail.username}")
    private String fromMailAddress_preview;
    @Value("${spring.mail.host}")
    private String mailHost;
    @Value("${spring.mail.username}")
    private String mailUsername;
    @Value("${spring.mail.password}")
    private String mailPassword;
    @Value("${spring.mail.port}")
    private String mailPort;
    @Value("${spring.mail.properties.mail.smtp.socketFactory.port}")
    private String mailSmtpSocketFactoryPort;
    @Value("${spring.mail.properties.mail.smtp.auth}")
    private String mailSmtpAuth;           

發送會議郵件模闆方法：

/**
     * 發送會議邀請郵件
     *
     * @param toMailAddress   收件人（邀約人），支援多個
     * @param mailSubject     郵件主題
     * @param mailContent     郵件内容（建議傳入velocity去建構生成的HTML内容）
     * @param summary         摘要，即月曆（日程）上顯示的标題
     * @param startTimestamp  會議開始時間
     * @param endTimestamp    會議結束時間
     * @param locationContent 會議位置
     * @return 發送結果
     */
    public Boolean sendMeetingMailTemplate(String[] toMailAddressArray, String mailSubject, String mailContent,
                                           String summary, Long startTimestamp, Long endTimestamp,
                                           String locationContent) {
        if (toMailAddressArray == null || toMailAddressArray.length <= 0 || StringUtils.isEmpty(fromMailAddress_preview)
            || StringUtils.isEmpty(mailSubject) || StringUtils.isEmpty(mailContent) || StringUtils.isEmpty(summary)) {
            return false;
        }

        boolean sendStatus = false;
        Security.addProvider(new com.sun.net.ssl.internal.ssl.Provider());
        Properties prop = new Properties();
        prop.put("mail.smtp.host", mailHost);
        prop.put("mail.smtp.auth", mailSmtpAuth);
        prop.put("mail.smtp.port", mailPort);
        prop.setProperty("mail.smtp.socketFactory.class", SSL_FACTORY);
        prop.setProperty("mail.smtp.socketFactory.fallback", "false");
        prop.setProperty("mail.smtp.socketFactory.port", mailSmtpSocketFactoryPort);
        MailAuthenticator authenticator = new MailAuthenticator(mailUsername, mailPassword);
        Session session = Session.getDefaultInstance(prop, authenticator);
        MimeMessage message = new MimeMessage(session);
        try {
            message.addHeaderLine("method=REQUEST");
            message.addHeaderLine("charset=UTF-8");
            message.addHeaderLine("component=VEVENT");
            message.setFrom(new InternetAddress(fromMailAddress_preview));
            InternetAddress[] addressArray = new InternetAddress[toMailAddressArray.length];
            for (int i = 0; i < toMailAddressArray.length; i++) {
                addressArray[i] = new InternetAddress(toMailAddressArray[i]);
            }
            message.addRecipients(Message.RecipientType.TO, addressArray);
            message.setSubject(mailSubject);
        } catch (MessagingException e) {
            e.printStackTrace();
        }

        // 會議内容核心拼裝
        BodyPart meetingBodyPart = new MimeBodyPart();
        try {
            meetingBodyPart.setHeader("Content-Class", "urn:content-  classes:calendarmessage");
            meetingBodyPart.setHeader("Content-ID", "calendar_message");
            meetingBodyPart.setDataHandler(new DataHandler(new ByteArrayDataSource(
                buildCalendar(summary, startTimestamp, endTimestamp, locationContent, toMailAddressArray).toString(),
                "text/calendar")));

        } catch (IOException | MessagingException e) {
            e.printStackTrace();
        }

        // 郵件原文組合+發送
        Multipart multipart = new MimeMultipart();
        try {
            multipart.addBodyPart(meetingBodyPart);

            BodyPart contentBodyPart = new MimeBodyPart();
            // 普通檔案指派
            //contentBodyPart.setText(mailContent);
            /* HTML内容指派
            Map<String, Object> model = new HashMap<>();
            model.put("sscontent", "test測試師善");
            VelocityContext velocityContext = new VelocityContext();
            model.put("sscontent", model.get("sscontent"));
            String text = VelocityEngineUtils.mergeTemplateIntoString(velocityEngine, "/mail/test.vm", "UTF-8",
            model);*/
            contentBodyPart.setContent(mailContent, "text/html; charset=utf-8");
            multipart.addBodyPart(contentBodyPart);

            message.setContent(multipart);
            Transport.send(message);
            sendStatus = true;
        } catch (MessagingException e) {
            e.printStackTrace();
        }
        return sendStatus;
    }           

建構月曆對象方法：

/**
 * 建構會議邀約月曆對象
 *
 * @param summary            摘要，會議郵件顯示在月曆插件上的标題
 * @param startTimestamp     會議開始時間，GMT+8
 * @param endTimestamp       會議結束時間，GMT+8
 * @param LocationContent    會議位置
 * @param toMailAddressArray 邀約人
 * @return
 */
public Calendar buildCalendar(String summary, Long startTimestamp, Long endTimestamp, String LocationContent, String[] toMailAddressArray) {
    TimeZoneRegistry registry = TimeZoneRegistryFactory.getInstance().createRegistry();
    TimeZone timezone = registry.getTimeZone("Asia/Shanghai");
    VTimeZone tz = timezone.getVTimeZone();

    // 建立月曆
    Calendar calendar = new Calendar();
    calendar.getProperties().add(new ProdId("-//Ben Fortuna//iCal4j 1.0//EN"));
    calendar.getProperties().add(Version.VERSION_2_0);
    calendar.getProperties().add(CalScale.GREGORIAN);
    // ⭐️下面這行很關鍵，缺少的話釘釘IOS郵箱會顯示1970--01-01 08:00
    calendar.getProperties().add(Method.REQUEST); 

    DateTime start = new DateTime(startTimestamp);
    start.setTimeZone(timezone);
    DateTime end = new DateTime(endTimestamp);
    end.setTimeZone(timezone);
    VEvent event = new VEvent(start, end, summary);
    event.getProperties().add(new Location(LocationContent));
    try {
        // 生成唯一标示
        event.getProperties().add(new Uid(new UidGenerator("iCal4j").generateUid().getValue()));
        // 添加時區資訊
        event.getProperties().add(tz.getTimeZoneId());
        // 組織者
        event.getProperties().add(new Organizer("mailto:[email protected]"));
    } catch (SocketException | URISyntaxException e) {
        e.printStackTrace();
    }
    // 添加邀請者
    for (int i = 0; i < toMailAddressArray.length; i++) {
        Attendee dev = new Attendee(URI.create("mailto:" + toMailAddressArray[i]));
        dev.getParameters().add(Role.REQ_PARTICIPANT);
        dev.getParameters().add(new Cn("Developer " + (i + 1)));
        event.getProperties().add(dev);
    }
    /*
    // 重複事件
    Recur recur = new Recur(Recur.WEEKLY, Integer.MAX_VALUE);
    recur.getDayList().add(WeekDay.MO);
    recur.getDayList().add(WeekDay.TU);
    recur.getDayList().add(WeekDay.WE);
    recur.getDayList().add(WeekDay.TH);
    recur.getDayList().add(WeekDay.FR);
    RRule rule = new RRule(recur);
    event.getProperties().add(rule);
    */
    // 提醒,提前10分鐘
    VAlarm valarm = new VAlarm(new Dur(0, 0, -10, 0));
    valarm.getProperties().add(new Summary("事件提醒"));
    valarm.getProperties().add(Action.DISPLAY);
    valarm.getProperties().add(new Description("會議提醒描述，待定，不确定使用方式"));
    // 将VAlarm加入VEvent
    event.getAlarms().add(valarm);
    // 添加事件
    calendar.getComponents().add(event);
    // 驗證
    try {
        calendar.validate();
    } catch (ValidationException e) {
        e.printStackTrace();
    }
    return calendar;
}           

謝謝閱讀，歡迎大家指正。