Java 获取 Outlook 邮箱的日历事件

1.需求描述
2.实现方案
3.运行结果

IDE：IntelliJ IDEA 2022.3.3
JDK：1.8.0_351
Outlook：Microsoft Office 2016

1.需求描述

比如现在需要获取 Outlook 邮箱中四月的全部的会议安排，如下图所示
在这里插入图片描述

2.实现方案

使用 ews 获取部署的 Exchange Web Services 数据，这里我们需要使用 Maven 引入下列 jar 包

 <!-- Exchange Web Services (EWS) Java API -->
 <dependency>
     <groupId>com.microsoft.ews-java-api</groupId>
     <artifactId>ews-java-api</artifactId>
     <version>2.0</version>
 </dependency>

代码如下：

import microsoft.exchange.webservices.data.core.ExchangeService;
import microsoft.exchange.webservices.data.core.enumeration.misc.ExchangeVersion;
import microsoft.exchange.webservices.data.core.enumeration.property.WellKnownFolderName;
import microsoft.exchange.webservices.data.core.service.item.Appointment;
import microsoft.exchange.webservices.data.credential.ExchangeCredentials;
import microsoft.exchange.webservices.data.credential.WebCredentials;
import microsoft.exchange.webservices.data.search.CalendarView;
import microsoft.exchange.webservices.data.search.FindItemsResults;

import java.net.URI;
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;

public class ExchangeUtil {

    public static void main(String[] args) throws Exception {
        //替换为自己公司的Exchange服务器地址
        String serverAddress = "https://webmail.******.com/ews/Exchange.asmx";
        //邮箱用户名（可以是域账号用户）
        String username = "03******";
        //邮箱密码（可以对应域账号密码）
        String password = "12******";

        //创建 Exchange 服务实例
        ExchangeService service = new ExchangeService(ExchangeVersion.Exchange2010_SP2);

        //设置邮箱认证
        ExchangeCredentials credentials = new WebCredentials(username, password);
        service.setCredentials(credentials);

        //设置Exchange服务器地址
        service.setUrl(new URI(serverAddress));

        //定义日历视图
        CalendarView calendarView = new CalendarView(toDate("2024-04-01"), toDate("2024-05-01"));

        //获取日历事件
        FindItemsResults<Appointment> appointments = service.findAppointments(WellKnownFolderName.Calendar, calendarView);

        //输出日历事件信息
        for (Appointment appointment : appointments) {
            System.out.println("主题: " + appointment.getSubject());
            System.out.println("地点: " + appointment.getLocation());
            System.out.println("开始时间: " + toString(appointment.getStart()));
            System.out.println("结束时间: " + toString(appointment.getEnd()));
            System.out.println("-----------------------------");
        }
    }

    //字符串转日期
    public static Date toDate(String str) throws ParseException {
        DateFormat format = new SimpleDateFormat("yyyy-MM-dd");
        return format.parse(str);
    }

    //日期转字符串
    public static String toString(Date date) {
        DateFormat format = new SimpleDateFormat("yyyy-MM-dd hh:mm");
        return format.format(date);
    }
}