sk-ews(顺科ews spring-boot-starter)

打个小广告：作者博客地址:http://nbsanke.top:68

sk-ews基本介绍

  sk-ews是wangzy基于ews(ExchangeWebService)Api二次开发构建出来的基于SpringBoot的Starter，开发者只需要通过maven或gradle或引入lib包形式引入本jar即可快速对ExchangeWebService进行二次开发

快速开始(当前版本号为：0.0.4)

目前仅在私服上传，有需要可联系作者qq:1197983391

maven:

    
        com.sanke
        sk-ews
        0.0.4
    

gradle:

    compile "com.sanke:sk-ews:0.0.4"

sk-ews基本接口介绍

起步

sk-ews在使用之前需要注入配置信息(已废弃，0.0.1版本适用)
示例代码如下：

    @Bean
	public EwsConfigProperties ewsConfigProperties() {
		EwsConfigProperties ewsConfigProperties = new EwsConfigProperties();
		ewsConfigProperties.setServerUrl("https://dc1.nbsanke.top/EWS/Exchange.asmx");
		ewsConfigProperties.setServerHost("dc1.nbsanke.top");
		return ewsConfigProperties;
	}

在启动类中加上

    @ComponentScan("com.sanke")

ews相关接口都在EwsService接口类中
ews相关接口实现都在EwsServiceImpl实现类中

初始化ExchangeService

  初始化ExchangeService对象需要传入username和password两个参数。sk-ews默认初始化ExchangeService采用Exchange2010_SP2版本，此版本也是Ews提供可用最高版本
初始化ExchangeService接口为：

    ExchangeService initExchangeService(String username, String password) throws Exception;

使用示例：

    ExchangeService exchangeService = ewsService.initExchangeService("[email protected]", "xxx");

获取一个预约(根据预约ID)

获取一个预约需要传入两个对象：
  ExchangeService(ExchangeService服务)
  AppointmentBean(预约参数Bean)

获取一个预约初始化AppointmentBean必传参数有一个：
  appointmentId(会议Id) 类型:String

获取一个Appointment接口为：

    Appointment getOneAppointment(ExchangeService exchangeService, AppointmentBean appointmentBean) throws Exception;

初始化AppointmentBean示例：

    AppointmentBean appointmentBean = AppointmentBean.builder()
		.appointmentId("xxx")
		.build();

获取一个预约示例：

    @Autowired
    private EwsService ewsService;
    
    Appoinetment appointment = ewsService.getOneApppinement(exchangeService, appointmentBean);

列出指定时间内预约

列出指定时间内预约需要传入两个对象：
  ExchangeService(ExchangeService服务)
  AppointmentBean(预约参数Bean)

获取一个预约初始化AppointmentBean必传参数有两个：
  beginTime(开始时间) 类型:Date
  endTime(结束时间) 类型:Date

获取指定时间内预约接口为：

    List listAppointment(ExchangeService exchangeService,AppointmentBean appointmentBean) throws Exception;

初始化AppointmentBean示例：

    AppointmentBean appointmentBean = AppointmentBean.builder()
		.beginTime(new Date(new Date().getTime() - 1000 * 3600 *24))
		.endTIme(new Date(new Date().getTime() + 1000 * 3600 *24))
		.build();

获取指定时间内预约示例：

    @Autowired
    private EwsService ewsService;
    
    List appointments = ewsService.listAppointment(exchangeService, appointmentBean);

创建预约

创建预约需要传入两个对象：
  ExchangeService(ExchangeService服务)
  AppointmentBean(预约参数Bean)

创建预约初始化AppointmentBean必传参数有：
  beginTime(开始时间) 类型:Date
  endTime(结束时间) 类型:Date
  subject(预约主题) 类型:String
  attendees(与会人) 类型:List<String> (注意：会议室在预约中是以与会人形式存在，所以与会人中必有会议室)
  location(地点) 类型:String

可传参数有：
  content(预约内容) 类型:String
  importance(重要性) 类型:Importance(枚举类)
    注：Importance有三个成员变量
    1、Low (低)
    2、Normal (中)
    3、Heigh (高)

创建预约接口为：

    Appointment createAppointment(ExchangeService exchangeService, AppointmentBean appointmentBean) throws Exception;

初始化AppointmentBean示例：

    AppointmentBean appointmentBean = AppointmentBean.builder()
            .beginTime(new Date(new Date().getTime() + 1000 * 3600))
            .endTIme(new Date(new Date().getTime() + 1000 * 3600))
            .content("胡泰迪")
            .subject("一起来学Linux")
            .importance(Importance.Normal)
            .attendees(attendees)
            .location("会议室101")
            .build();

创建预约示例：

    @Autowired
    private EwsService ewsService;
    
    Appointment appointment = ewsService.createAppointment(exchangeService, appointmentBean);

更新预约

更新预约需要传入两个对象：
  ExchangeService(ExchangeService服务)
  AppointmentBean(预约参数Bean)

更新预约AppointmentBean必传参数有一个：
  appointmentId(会议Id) 类型:String

更新预约AppointmentBean可传参数:
  beginTime(开始时间) 类型:Date
  endTime(结束时间) 类型:Date
  subject(预约主题) 类型:String
  attendees(与会人) 类型:List<String> (注意：会议室在预约中是以与会人形式存在，所以与会人中必有会议室)
  location(地点) 类型:String
  content(预约内容) 类型:String
  importance(重要性) 类型:Importance(枚举类)
    注：Importance有三个成员变量
    1、Low (低)
    2、Normal (中)
    3、Heigh (高)

更新预约接口为：

    Appointment updateAppointment(ExchangeService exchangeService, AppointmentBean appointmentBean) throws Exception;

初始化AppointmentBean与创建预约一样

更新预约示例：

    @Autowired
    private EwsService ewsService;
    
    Appointment appointment = ewsService.updateAppointment(exchangeService, appointmentBean);

拒绝预约(拒绝预约必须以会议室身份才能有效拒绝)

获取一个预约需要传入两个对象：
  ExchangeService(ExchangeService服务)
  AppointmentBean(预约参数Bean)

拒绝会议AppointmentBean必传参数有一个：
  appointmentId(会议Id) 类型:String

拒绝预约接口为：

    Appointment declineAppointment(ExchangeService exchangeService, AppointmentBean appointmentBean) throws Exception;

初始化AppointmentBean与获取一个预约一样

拒绝预约示例：

    @Autowired
    private EwsService ewsService;
    
    ewsService.declineAppointment(exchangeService, appointmentBean);