Введение и примеры приложений

Сценарии использования Aspose.Email Mail

В этой статье предлагается ряд возможных способов использования Aspose.Email для Java, с особым акцентом на функции программирования электронной почты компонента.

Программное обеспечение для рассылки новостей

API Aspose.Email Mail может использоваться для создания надёжного приложения рассылки новостей. Благодаря поддержке Aspose.Email добавления встроенных объектов (например, изображений, звуков и т.п.), можно создавать богатыe HTML‑рассылки с полным набором изображений (и другими встроенными объектами). Используя функцию массовой рассылки в API Aspose.Email Mail, также возможно отправлять огромные объёмы писем за ограниченный период времени. Aspose.Email Mail предоставляет функцию слияния почты на основе шаблонов, которую можно использовать для создания шаблона рассылки новостей. Этот шаблон позволяет выполнять слияние почты для отправки массовой рассылки. Существует множество других задач, которые Aspose.Email Mail может выполнять в приложении email‑маркетинга.

Другие маркетинговые инструменты

Подобно приложениям для рассылки новостей, с помощью Aspose.Email Mail можно создавать многие другие типы программного обеспечения. Используйте его для построения email‑маркетинга, массовой рассылки и e‑campaign, и т.д.

Бизнес‑приложения

Aspose.Email Mail может использоваться почти во всех типах бизнес‑приложений для выполнения вспомогательных задач:

  • Электронные оповещения: отправляйте email‑оповещения, чтобы информировать пользователей о действиях.
  • Запросы на встречи: отправляйте запросы на деловые встречи, используя поддержку iCalendar в Aspose.Email Mail.
  • Электронные запланированные отчёты: Отчёты являются неотъемлемой частью большинства бизнес‑приложений. Многие бизнес‑отчёты генерируются периодически. Используйте Aspose.Email Mail для отправки запланированных отчётов по электронной почте.

Почтовые клиенты

Aspose.Email Mail также может использоваться в почтовых клиентах для отправки обычных писем. Он поддерживает вложения, встроенные объекты, события iCalendar, слияние почты, массовую рассылку и т.д., поэтому Aspose.Email Mail — лучший вариант для создания клиентских почтовых приложений.

Пример приложения Aspose.Email Mail

Чтобы проиллюстрировать, как использовать Aspose.Email Mail, мы создадим приложение, демонстрирующее, как построить электронное сообщение с помощью Класс MailMessage а затем отправьте его с помощью класса SmtpClient.

Mail : Шаги примерного приложения

Пожалуйста, следуйте нижеприведённым шагам для создания приложения с использованием Aspose.Email.

  1. Разработайте приложение: создайте интерфейс, принимающий три поля: From, To и Message.
  2. Дважды щёлкните кнопку Send в режиме дизайна и напишите ваш код в редакторе.
  3. Создайте экземпляр класса MailMessage и используйте его свойства для формирования электронного сообщения. (Экземпляры класса MailMessage используются для создания писем, которые передаются SMTP‑серверу для доставки с помощью класса SmtpClient).
  4. Создайте экземпляр класса SmtpClient и используйте его свойства для отправки электронного сообщения.
  5. Протестируйте ваше приложение.
  6. Введите адреса в поля From и To.
  7. Введите сообщение в поле Message Body.
  8. Щёлкните Send.

Вышеуказанные шаги описаны ниже: дважды щёлкните кнопку Send в режиме дизайна и добавьте приведённый ниже код:

// Declare message as MailMessage instance
MailMessage message = new MailMessage();
// Specify From, To, Subject and Body
message.setFrom(new MailAddress("#From"));
message.setTo(MailAddressCollection.to_MailAddressCollection("#To"));
message.setSubject("#Subject");
message.setBody("#Body");

// Send email using SmtpClient, Create an instance of the SmtpClient Class and Specify the mailing host server, Username, Password and Port
SmtpClient client = new SmtpClient();

// Specify the mailing host server, Username, Password and Port
client.setHost("mail.server.com");
client.setUsername("username");
client.setPassword("password");
client.setPort(25);
client.send(message);

// Notify the user that a message has been sent
System.out.println("Message Sent");

При подключении к серверу с включённым SSL необходимо установить следующие свойства объекта SMTPClient

// Set the port to 587. This is the SSL port of Gmail SMTP server, set the security mode to explicit
client.setPort(587);
client.setSecurityOptions(SecurityOptions.SSLExplicit);

Заключение

Aspose.Email Mail — очень мощный компонент, с помощью которого разработчики могут выполнять почти любые задачи, связанные с электронной почтой, такие как отправка массовой многопоточной рассылки, использование слияния почты, добавление вложений, встраивание изображений и звуков в сообщения, добавление событий iCalendar в письма, получение писем и многое другое.

Aspose.Email Pop3

Aspose.Email Pop3 реализует протокол Post Office Protocol v3 (POP3) на Java. Он позволяет Java‑разработчикам добавлять функции запроса и получения электронной почты в свои Java‑приложения без необходимости погружаться в детали протокола и сложность программирования почты и сетей. Aspose.Email Pop3 поддерживает все команды, определённые в стандартном протоколе POP3, и предоставляет простые в использовании интерфейсы вместе с компактной и интуитивной объектной моделью. Это значительно уменьшает обычную кривую обучения для Java‑разработчиков.

Pop3 : Основные функции

Как часть Aspose.Email, Aspose.Email Pop3 специально разработан для Java и написан на управляемом коде Java. Он позволяет вам:

  • Подключение и вход на POP3‑серверы.
  • Поддержка APOP.
  • Запрос сообщений.
  • Получение сообщений.
  • Полная поддержка асинхронного стиля программирования.
  • Поддержка SSL.

Сценарии использования Aspose.Email Pop3

Aspose.Email Pop3 может использоваться разработчиками в различных сценариях. Здесь мы поделимся несколькими.

Автоматизация бизнес‑почты

Aspose.Email Pop3 можно использовать для запроса почтовых ящиков и получения электронных писем. Он работает гладко вместе с компонентом отправки писем Aspose.Email Mail. Aspose.Email полностью поддерживает автоматизацию электронной почты. Отправляйте письма с помощью Aspose.Email Mail и получайте сообщения с помощью Aspose.Email Pop3. Загруженные электронные письма затем могут быть проанализированы с помощью Aspose.Email Mime.

Почтовые клиенты

Aspose.Email Pop3 можно использовать в почтовых клиентских приложениях для получения электронных писем.

Pop3 : Пример приложения

Здесь мы продемонстрируем, как использовать Aspose.Email Pop3. Этот класс имеет множество функций, но мы сосредоточимся на том, как подключиться к серверу POP3 и получать сообщения. Пример показывает, как создать приложение, а также кодовые примеры, которые заставляют приложение работать. Следуйте шагам, приведённым ниже, чтобы создать образцовое приложение с использованием Aspose.Email Pop3.

  1. Создайте экземпляр Pop3Client.
  2. Установите имя хоста POP3, логин и пароль в этом экземпляре.
  3. Создайте экземпляр MailMessage и загрузите в него первое письмо из вашей учётной записи, вызвав функцию fetchMessage(). Это переносит первое сообщение из вашего почтового аккаунта в экземпляр MailMessage.
  4. Используйте свойства From, Subject и HtmlBody экземпляра MailMessage, чтобы увидеть отправителя, тему и тело сообщения.

Вышеуказанные шаги демонстрируются в приведенных ниже примерах кода.

// Create a POP3 client
Pop3Client client = new Pop3Client();

// Basic settings (required)
client.setHost("pop3.youdomain.com");
client.setUsername("username");
client.setPassword("psw");

try {
    // Retrieve first message in MailMessage format directly
    MailMessage msg;
    msg = client.fetchMessage(1);
    System.out.println(msg.getFrom().toString());
    System.out.println(msg.getSubject());
    System.out.println(msg.getHtmlBody());
} catch (Exception ex) {
    System.err.println(ex);
}

Для серверов с включённым SSL необходимо изменить следующие свойства объекта Pop3Client:

// Set implicit security mode
client.setSecurityOptions(SecurityOptions.SSLImplicit);

Aspose.Email Imap

Aspose.Email Imap реализует протокол Internet Message Access Protocol (IMAP) на Java. Aspose.Email Imap позволяет Java‑разработчикам быстро добавить возможности IMAP в свои приложения без необходимости разбираться в деталях протокола. Компонент поддерживает получение и загрузку сообщений, проверку статуса сообщений (новое/прочитано/непрочитано) и прочее.

Imap : Основные возможности

Aspose.Email Imap позволяет:

  • Получать сообщения электронной почты.
  • Загрузка email‑сообщений.
  • Перечисление email‑сообщений в разных папках.
  • Проверка статуса email‑сообщений.
  • Работа с MailMessage.
  • Работа с поддержкой SSL.

Использование Aspose.Email Imap

Aspose.Email Imap реализует протокол Internet Message Access Protocol (IMAP) на Java. С его помощью разработчики могут легко выполнять запросы и управлять письмами на IMAP‑сервере, а также создавать, удалять или переименовывать папки электронной почты. Используя Aspose.Email Imap, разработчики получают преимущества протокола IMAP через простые в использовании API. Они могут получать письма с любого компьютера, так как письма остаются сохранёнными на сервере. С помощью Aspose.Email Imap разработчики могут создавать веб‑ или настольные приложения, которые получают и обрабатывают письма с IMAP‑серверов. Aspose реализовал протокол IMAP в соответствии с интернет‑аутентификацией и стандартами RFC. Таким образом, Aspose.Email Imap представляет собой безопасную и полностью функциональную реализацию протокола IMAP с простой для понимания объектной моделью и интерфейсами.

Imap : Пример приложения

В этой статье объясняется, как использовать Aspose.Email Imap. Мы создаём небольшое приложение, которое получает количество email‑сообщений в вашей учётной записи IMAP. Следуйте указанным нижеприведённым шагам, чтобы создать пример приложения с использованием Aspose.Email Imap.

  1. Создайте экземпляр ImapClient, передав имя IMAP‑сервера, логин и пароль.
  2. Вызовите функцию selectFolder() экземпляра ImapClient, чтобы выбрать папку, в которой нужно подсчитать количество сообщений.
  3. Теперь вызовите свойство CurrentFolder.TotalMessageCount экземпляра ImapClient, чтобы получить количество email‑сообщений.

Imap : Примеры кода

Приведённые ниже примеры кода показывают, как реализовать описанные выше шаги с Aspose.Email.

// Creates an instance of the class ImapClient by specified the host, username and password
ImapClient client = new ImapClient("localhost", "username", "password");

try {
    client.selectFolder(ImapFolderInfo.IN_BOX);
    String strTemp;
    strTemp = "You have " + client.getCurrentFolder().getTotalMessageCount() + " messages in your account.";
    // Gets number of messages in the folder, Disconnects to imap server.
    System.out.println(strTemp);
} catch (Exception ex) {
    System.err.println(ex);
}

Для серверов почты с включённым SSL установите следующие свойства объекта ImapClient:

// Set security mode
client.setSecurityOptions(SecurityOptions.SSLImplicit);

Aspose.Email Exchange

Aspose.Email Exchange Позволяет разработчикам управлять электронными письмами на сервере Microsoft Exchange. С помощью этого компонента вы можете подключаться, получать список сообщений и загружать письма из почтового ящика Exchange, не изучая детали нижележащего протокола. Компонент поддерживает перечисление сообщений, отправку писем, загрузку сообщений и сохранение их в формате eml или msg на локальном диске и т.д.

Exchange : Основные возможности

Aspose.Email Exchange позволяет вам:

  • Подключаться к серверам Microsoft Exchange.
  • Перечислять email‑сообщения в почтовых ящиках Exchange.
  • Список email‑сообщений из разных папок, например, Входящие, Отправленные, Удалённые или Черновики.
  • Удалять сообщения в любой папке на серверах Exchange.

Использование Aspose.Email Exchange

С помощью Aspose.Email Exchange разработчики могут получать доступ к почтовым ящикам Exchange Server из Java‑приложений. Он предоставляет простой API для управления электронной почтой на серверах Exchange. Разработчики могут создавать консольные, настольные или веб‑приложения, которые управляют письмами в почтовых ящиках Exchange.

Пример приложения Aspose.Email Exchange

В этой статье демонстрируется, как использовать Aspose.Email Exchange. Мы создаём простое настольное приложение, которое подключается к почтовому ящику Exchange Server, получает список сообщений в папке «Входящие» и отображает их в форме Windows.

Exchange : Шаги примера приложения

Чтобы успешно запустить приложение, нужны правильные учётные данные для доступа к серверу Exchange. Здесь мы получаем информацию о учётных данных — URI сервера Exchange, имя пользователя, пароль и домен — из формы Windows. Это очень простой пример, поэтому свойства сообщения — тема, отправитель и получатель — просто выводятся в listbox.

Exchange : Примеры кода

Добавьте следующий код в обработчик события click кнопки List Messages.

// Clear the items in the listbox
lstMessages.clear();

// Create instance of IEWSClient class by giving credentials and Call ListMessages method to list messages info from Inbox
IEWSClient client = EWSClient.getEWSClient("mailboxURI", "Username", "Password", "Domain");
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to display the basic information
for (ExchangeMessageInfo msgInfo : msgCollection) {
    String strMsgInfo = "Subject: " + msgInfo.getSubject() + " == From: " + msgInfo.getFrom().toString() + " == To: " + msgInfo.getTo().toString();
    lstMessages.add(strMsgInfo);
}

Exchange : Вывод

На этом скриншоте показаны сообщения, полученные с сервера Exchange. Метод listMessages() возвращает базовую информацию, такую как тема, отправитель, получатель и идентификатор сообщения. Чтобы получить полное сообщение, вызовите метод IEWSClient.fetchMessage(). (Использование IEWSClient.fetchMessage() описано в статье Работа с почтовым ящиком Exchange и сообщениями.)

Aspose.Email Mime

Multipurpose Internet Mail Extensions (MIME) — это интернет‑стандарт, расширяющий формат электронных писем для поддержки текста в кодировках, отличных от US‑ASCII, вложений не‑текстового типа, многочастных тел сообщений и заголовков в не‑ASCII кодировках. Aspose.Email Mime реализует протокол MIME на Java. Он действует как переводчик: может читать электронное письмо из файла (.eml и т.п.) или из памяти (строка). Затем он разбирает файл или строку сообщения на осмысленные части. Если вам нужно обработать файл письма, не вдаваясь в детали протокола MIME, например извлечь вложение из письма, используйте Aspose.Email Mime.

Основные возможности

Aspose.Email Mime прекрасно работает с Aspose.Email Pop3 и Aspose.Email Mail.

  • Aspose.Email Pop3 получает сообщения электронной почты из указанного почтового ящика.
  • Aspose.Email Mail отправляет сообщения электронной почты в указанный почтовый ящик.
  • Aspose.Email Mime является связующим звеном этих двух компонентов и разбирает сообщения электронной почты.
Поддержка многопоточности в почтовых клиентах Отмена запросов на встречи с помощью Calendar