Flutter 插件ews的使用_访问 Microsoft Exchange 服务的 Dart 客户端库

Flutter 插件ews的使用_访问 Microsoft Exchange 服务的 Dart 客户端库

EWS 简介

EWS（Exchange Web Services）是一个用于访问 Microsoft Exchange 服务的 Dart 客户端库。该库可以与 Office 365 Exchange Online 以及本地 Exchange 服务器配合使用，允许您访问存储在 Office 365、Exchange Online 或 Exchange Server 邮箱中的几乎所有信息。

需要注意的是，EWS API 目前处于维持模式，推荐使用 Microsoft Graph 来访问 Office 365 和 Exchange Online 数据。

开始使用

ExchangeService 类包含了设置用户凭据、识别 Exchange Web Services 终端、发送和接收 SOAP 消息以及配置与 Exchange Web Services 连接的方法和属性。要使用该库执行操作，必须先设置 ExchangeService 类。

final service = ExchangeService.withVersion(ExchangeVersion.Exchange2007_SP1)
  ..Url = Uri.parse("https://outlook.office365.com/ews/exchange.asmx")
  ..Credentials = WebCredentials("---USER_NAME---", "---USER_PASSWORD---", "---USER_DOMAIN---");

创建文件夹

以下代码示例展示了如何创建一个带有自定义文件夹类的文件夹。

final folder = Folder(service)
  ..DisplayName = "Custom Folder"
  ..FolderClass = "IPF.MyCustomFolderClass";
await folder.SaveWithWellKnownFolderName(WellKnownFolderName.Notes);

创建自定义扩展属性

以下代码示例展示了如何创建一个新的扩展属性，为其设置值，并将其添加到邮件中。

// 创建扩展属性的定义
final extendedPropertyDefinition = ExtendedPropertyDefinition.withDefaultPropertySetAndName(
  DefaultExtendedPropertySet.Common, 
  "custom:MeetingDescription", 
  MapiPropertyType.String
);

// 创建一封将添加扩展属性的电子邮件
final message = EmailMessage(service)
  ..Subject = "Saved with the meeting description"
  ..Body = MessageBody.withText("The meeting description is contained within the extended property.")
  ..ToRecipients.Add(EmailAddress(smtpAddress: "user@contoso.com"))
  ..SetExtendedProperty(extendedPropertyDefinition, "The meeting purpose is make the right decision");

// 保存并发送电子邮件
await message.SendAndSaveCopy();

创建预约

以下代码示例展示了如何创建一个预约，并为其设置主题、正文、开始时间和结束时间。

final startTime = DateTime(2019, 9, 9, 9, 10, 0);
final appointment = Appointment(service)
  ..Subject = "Dentist Appointment"
  ..Body = MessageBody.withText("The appointment is with Dr. Smith.")
  ..Start = startTime
  ..End = startTime.add(Duration(hours: 2));

await appointment.SaveWithSendInvitationsMode(SendInvitationsMode.SendToNone);

支持声明

从 2018 年 7 月 19 日起，Exchange Web Services (EWS) 将不再接收功能更新。虽然该服务将继续接收安全更新和某些非安全更新，但产品设计和功能将保持不变。这一变化也适用于 Java 和 .NET 的 EWS SDK。

完整示例 Demo

以下是一个完整的示例，展示了如何使用 EWS 插件创建一个文件夹并将一条带有自定义扩展属性的消息发送到该文件夹中。

import 'package:ews/ews.dart';

void main() async {
  // 设置凭据
  final credentials = BasicCredentials(
    "---username---",
    "---password---",
    "---domain---",
  );

  // 初始化 ExchangeService
  final service = ExchangeService.withVersion(ExchangeVersion.Exchange2007_SP1)
    ..Url = Uri.parse("https://outlook.office365.com/ews/exchange.asmx")
    ..Credentials = credentials
    ..TraceFlags = [TraceFlags.EwsRequest, TraceFlags.EwsResponse]
    ..TraceEnabled = true;

  // 创建文件夹
  final folder = Folder(service)..DisplayName = "My Folder";
  await folder.SaveWithWellKnownFolderName(WellKnownFolderName.Notes);

  // 创建扩展属性的定义
  final extendedPropertyDefinition = ExtendedPropertyDefinition.withDefaultPropertySetAndName(
    DefaultExtendedPropertySet.Common, 
    "custom:MeetingDescription", 
    MapiPropertyType.String
  );

  // 创建一封将添加扩展属性的电子邮件
  final message = EmailMessage(service)
    ..Subject = "Saved with the meeting description"
    ..Body = MessageBody.withText("The meeting description is contained within the extended property.")
    ..ToRecipients.Add(EmailAddress(smtpAddress: "user@contoso.com"))
    ..SetExtendedProperty(extendedPropertyDefinition, "The meeting purpose is make the right decision");

  // 保存并发送电子邮件
  await message.SendAndSaveCopy();
}

更多关于Flutter 插件ews的使用_访问 Microsoft Exchange 服务的 Dart 客户端库的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter 插件ews的使用_访问 Microsoft Exchange 服务的 Dart 客户端库的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在探索和使用Flutter中未知的第三方插件，尤其是像ews（假设这是一个插件名，实际中可能不存在或名称有所不同）这样的插件时，了解其文档和示例代码是至关重要的。由于ews这个名称在Flutter的官方插件库中并不常见，我假设这是一个自定义或第三方插件。以下是一个探索和使用假设插件ews的示例过程，包括如何集成、初始化和基本使用。

步骤 1: 添加插件依赖

首先，你需要在pubspec.yaml文件中添加ews插件的依赖。请注意，由于这是一个假设的插件，以下依赖项是虚构的。你需要根据实际的插件文档来替换正确的依赖项。

dependencies:
  flutter:
    sdk: flutter
  ews: ^0.0.1  # 假设的版本号，实际使用时需替换为真实版本号

然后运行flutter pub get来安装依赖。

步骤 2: 导入插件

在你的Dart文件中导入该插件。

import 'package:ews/ews.dart';

步骤 3: 初始化插件

根据插件的文档，初始化插件可能需要在应用的入口点（如main.dart）或其他合适的位置进行。以下是一个假设的初始化过程：

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  // 假设ews插件有一个初始化方法
  Ews.initialize().then((_) {
    runApp(MyApp());
  }).catchError((error) {
    // 处理初始化错误
    print('Failed to initialize Ews: $error');
  });
}

步骤 4: 使用插件功能

假设ews插件提供了一些功能，比如获取数据或执行某些操作。以下是一个假设的使用案例：

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('EWS Plugin Example'),
        ),
        body: Center(
          child: FutureBuilder<String>(
            future: _fetchData(),
            builder: (context, snapshot) {
              if (snapshot.connectionState == ConnectionState.done) {
                if (snapshot.hasError) {
                  return Text('Error: ${snapshot.error}');
                } else {
                  return Text('Data: ${snapshot.data}');
                }
              } else {
                return CircularProgressIndicator();
              }
            },
          ),
        ),
      ),
    );
  }

  Future<String> _fetchData() async {
    try {
      // 假设ews插件有一个获取数据的方法
      var data = await Ews.fetchData();
      return data;
    } catch (error) {
      throw error;
    }
  }
}

注意事项

  1. 查阅文档：始终查阅插件的官方文档以获取最新的安装和使用指南。
  2. 错误处理：在实际应用中，添加适当的错误处理逻辑以处理可能出现的异常情况。
  3. 版本兼容性：确保插件版本与你的Flutter SDK版本兼容。
  4. 社区支持：如果插件是第三方的，查看其在GitHub或相关社区的活跃度，以获取支持和帮助。

由于ews是一个假设的插件名，上述代码和步骤都是基于假设的。在实际使用中，你需要根据具体的插件文档来调整代码。

回到顶部