Documentation – Технічні статті

Java: Різниця між вбудованими та звичайними вкладеннями

Mon, 01 Jan 0001 00:00:00 +0000

Повідомлення електронної пошти можуть містити вбудовані зображення та вкладення. Використовуючи MailMessage, вбудовані вкладення можна витягти з LinkedResourceCollection збірнику, тоді як звичайні вкладення можна отримати та витягти за допомогою повідомлення AttachmentCollection збірнику. Однак це відрізняється, коли повідомлення завантажується за допомогою MapiMessage, оскільки всі вбудовані зображення та звичайні вкладення доступні користувачеві в одному MapiAttachmentCollection. Тому метод, який може розрізняти вбудоване та звичайне вкладення, коли MapiMessage використовується, якщо необхідно.

У цій статті пояснюється, як розрізняти вбудовані вкладення від звичайних за допомогою MapiMessage. При прийнятті рішення тип тіла MapiMessage враховується наступним чином:

Тіло простого тексту: Повідомлення електронної пошти з типом тіла простого тексту не потребують перевірки, оскільки всі вкладення в таких повідомленнях завжди є звичайними вкладеннями.
Тіло HTML: Для повідомлень з HTML‑тілом вкладення повинно містити не лише властивість PR_ATTACH_FLAGS (0x37140003), а її значення має бути 0x00000004 для вбудованих вкладень. Якщо ця умова виконана, подальше визначення типу вкладення залежить від тегів PR_ATTACH_CONTENT_LOCATION та PR_ATTACH_CONTENT_ID. Однак за відсутності тегу PR_ATTACH_FLAGS MAPI, вкладення перевіряється за властивістю PR_ATTACH_DISPOSITION (0x3716001F або 0x3716001E) для визначення типу вкладення.
Тіло RTF: Якщо тіло у форматі RTF, тоді всі OLE-вкладення є вбудованими. Значення PR_ATTACH_METHOD для всіх OLE-вкладень дорівнює 0x00000006.

Наступний приклад коду демонструє програмне розрізнення вбудованих та звичайних вкладень. Функція isInlineAttachment приймає вкладення та MapiMessage як вхідні параметри і повертає true, якщо вкладення є вбудованим.

public static boolean isInlineAttachment(MapiAttachment att, MapiMessage msg) {
    if (msg.getBodyType() == BodyContentType.PlainText)
        // ignore indications for plain text messages
        return false;
    else if (msg.getBodyType() == BodyContentType.Html) {
        // check the PidTagAttachFlags property
        Long attachFlagsValue = att.getPropertyLong(MapiPropertyTag.PR_ATTACH_FLAGS);
        if (attachFlagsValue != null && (attachFlagsValue > 3 || attachFlagsValue < 1)) {
            // check PidTagAttachContentId property
            String contentId = att.getProperties().containsKey(MapiPropertyTag.PR_ATTACH_CONTENT_ID)
                    ? att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_ID)
                    : att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_ID_W);
            if (contentId != null && !contentId.isEmpty() && msg.getBodyHtml().contains("cid:" + contentId)) {
                return true;
            }
            // check PidTagAttachContentLocation property
            String contentLocation = att.getProperties().containsKey(MapiPropertyTag.PR_ATTACH_CONTENT_LOCATION)
                    ? att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_LOCATION)
                    : att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_LOCATION_W);
            if (contentLocation != null && !contentLocation.isEmpty() && msg.getBodyHtml().contains(contentLocation)) {
                return true;
            }
        }
        return "inline".equals(att.getPropertyString(0x3716001F)) || "inline".equals(att.getPropertyString(0x3716001E));
    } else if (msg.getBodyType() == BodyContentType.Rtf) {
        // If the body is RTF, then all OLE attachments are inline attachments.
        // OLE attachments have 0x00000006 for the value of the PidTagAttachMethod property
        Long attachMethod = att.getPropertyLong(MapiPropertyTag.PR_ATTACH_METHOD);
        return attachMethod != null && attachMethod == 0x00000006;
    } else {
        throw new ArgumentOutOfRangeException();
    }
}

Цей фрагмент коду використовує функцію isInlineAttachment() для оцінювання вкладень.

Java

String fileName = ("Sample.msg");
MapiMessage message = MapiMessage.fromFile(fileName);
MapiAttachmentCollection attachments = message.getAttachments();
for (int i = 0; i < attachments.size(); i++) {
    MapiAttachment attachment = (MapiAttachment) attachments.get(i);
    if (isInlineAttachment(attachment, message)) {
        System.out.println(attachment.getLongFileName() + " is inline attachment");
    } else {
        System.out.println(attachment.getLongFileName() + " is regular attachment");
    }
}

Java: Визначення та вилучення вбудованих вкладень з MSG, відформатованих як RTF

Mon, 01 Jan 0001 00:00:00 +0000

Повідомлення електронної пошти з тілом у форматі RTF можуть містити вбудовані вкладення, які представлені або як повний об’єкт, або як піктограма. Щоб розрізнити ці два типи вкладень, спочатку потрібно дослідити певні властивості вкладення. Після виконання певних критеріїв, заснованих на властивостях вкладення, його можна зберегти, витягнувши з ObjectData.

У цій статті визначають і витягують вбудовані вкладення з файлу MSG, відформатованого як RTF.

Java


   static void ExtractInlineAttachments()

  {

        MapiMessage message = MapiMessage.fromFile("Test.msg");

    MapiAttachmentCollection attachments = message.getAttachments();

    for (Object untypedAttachment : attachments)

    {

          MapiAttachment attachment = (MapiAttachment) untypedAttachment;

          if(IsAttachmentInline(attachment))

          {

                try

                {

                      SaveAttachment(attachment, UUID.randomUUID().toString());

                }

                catch (IOException | FileNotFoundException e)

                {

                      // TODO Auto-generated catch block

                          e.printStackTrace();

                    }

              }

        }

  }

  static boolean IsAttachmentInline(MapiAttachment attachment)

  {

        MapiObjectProperty objectData = attachment.getObjectData();

        if (objectData == null)

              return false;

        for (Object prop : attachment.getObjectData().getProperties().getValues())

        {

              MapiProperty property = (MapiProperty)prop;

              if ("\u0003ObjInfo".equals(property.getName()))

              {

                    byte[] data = property.getData();

                    int odtPersist1 = data[1] << 8 | data[0];

                    return (odtPersist1 & 0x40) == 0;

              }

        }

        return false;

  }

  static void SaveAttachment(MapiAttachment attachment, String fileName) throws IOException, FileNotFoundException

  {

        for (Object prop : attachment.getObjectData().getProperties().getValues())

        {

              MapiProperty property = (MapiProperty)prop;

              if ("Package".equals(property.getName()))

          {

                FileOutputStream fs;

                try

                {

                      fs = new FileOutputStream(fileName);

                      fs.write(property.getData(), 0, property.getData().length);

                }

                catch (java.io.IOException e)

                {

                      // TODO Auto-generated catch block

                          e.printStackTrace();

                    }

              }

        }

  }

Java: Збереження MSG як PDF

Mon, 01 Jan 0001 00:00:00 +0000

У цій статті показано, як перетворити електронний лист у PDF за допомогою Aspose.Email. Aspose.Email для Java працює з функціями Microsoft Outlook і не підтримує пряме перетворення у PDF. Щоб обійти це, у прикладах статті використовується Aspose.Email для конвертації листа у потік MHTML, а потім Aspose.Words для Java завантажує цей потік MHTML і зберігає його як PDF.

Електронний лист може містити також вкладення. Оскільки кожне вкладення може мати різний тип медіа, Aspose.Email ігнорує ці вкладення під час конвертації у MHTML, тобто лише вбудовані зображення в листі будуть включені у MHTML, а будь‑які звичайні вкладення будуть проігноровані.

Конвертувати лист у PDF

Наведений код показує конвертацію листа у PDF за допомогою Aspose.Email у поєднанні з Aspose.Words для Java. Це включає наступні кроки:

Завантажити лист за допомогою MailMessage
Зберегти лист у MemoryStream у форматі MHTML
Завантажити потік за допомогою Aspose.Words
Зберегти лист у PDF

Вихідний лист можна бачити наступним чином:

|| | :- | |Фігура: Вихідний MSG файл |

|| | :- | |Фігура: Конвертований PDF-файл | Java


 static void EmailToPdf(String emailPath) throws Exception

{

       FileInputStream fstream=new FileInputStream(emailPath);

       MailMessage eml = MailMessage.load(fstream);

       //Save the Message to output stream in MHTML format

       ByteArrayOutputStream emlStream = new ByteArrayOutputStream();

       eml.save(emlStream, SaveOptions.getDefaultMhtml());

       //Load the stream in Word document

       LoadOptions lo = new LoadOptions();

       lo.setLoadFormat(LoadFormat.MHTML);

       Document doc = new Document(new ByteArrayInputStream(emlStream.toByteArray()), lo);

       //Save to disc

       doc.save("About Aspose.Pdf", SaveFormat.PDF);

       //or Save to stream

       ByteArrayOutputStream foStream = new ByteArrayOutputStream();

       doc.save(foStream, SaveFormat.PDF);

}

Java: Пул з'єднань реформований

Mon, 01 Jan 0001 00:00:00 +0000

З випуском Aspose.Email 19.3 пул з’єднань був реформований. Нові EmailClient введено клас, який зрештою замінить CredentialsByHostClient клас. The EmailClient клас забезпечує ConnectionAsgmtMode властивості, яка визначає режим розподілу з’єднань у багатопотоковому середовищі. EmailClient.ConnectionAsgmtMode встановлюється за допомогою ConnectionAsgmtType перелічуваний.

Типи з’єднань

Існують наступні три типи з’єднань:

Основне з’єднання: це з’єднання створюється та знищується разом з поштовим клієнтом. Його не можна створювати або знищувати вручну.
З’єднання за замовчуванням: користувач може створювати з’єднання за замовчуванням для потоків за допомогою CreateConnection метод. Якщо існує з’єднання за замовчуванням, всі методи клієнта, виконані в потоці, будуть неявно використовувати це з’єднання. На один потік може існувати лише одне з’єднання за замовчуванням. Воно може бути створене вручну або автоматично. Це залежить від властивості EmailClient.ConnectionAsgmtMode. Ці з’єднання можна створити вручну за допомогою EmailClient.CreateConnection(createAsDefaultConnection = true) метод. Якщо з’єднання за замовчуванням не використовується (залежно від режиму розподілу з’єднань), замість нього неявно використовується основне з’єднання.
Незалежні з’єднання: це з’єднання, які не прив’язані до потоків. Їх можна створювати вручну і їх необхідно явно передавати як параметр методу. Ці з’єднання можна створити вручну за допомогою EmailClient.CreateConnection() метод або EmailClient.CreateConnection(createAsDefaultConnection = false) метод.

Типи розподілу з’єднань

Щоб налаштувати EmailClient.ConnectionAsgmtMode властивості, ConnectionAsgmtType перелічуваний тип використовується. Типи розподілу, надані ConnectionAsgmtType перераховані нижче.

ConnectionAsgmtType.UseMainOrDefault Цей режим використовується за замовчуванням у клієнтах електронної пошти. Клієнт використовує основне з’єднання для всіх операцій з декількох потоків, якщо з’єднання за замовчуванням не було створено, або якщо з’єднання не було передано явно як параметр методу. Основне з’єднання створюється одночасно з клієнтом електронної пошти. Користувач може створювати з’єднання за замовчуванням для потоків за допомогою CreateConnection метод. Якщо для потоку створено з’єднання за замовчуванням, воно використовується неявно для всіх методів клієнта електронної пошти, які викликаються в цьому потоці. Якщо з’єднання за замовчуванням для потоку не створено, використовується основне з’єднання для всіх методів клієнта, які викликаються в цьому потоці. Користувач також може створювати з’єднання, не прив’язані до потоків (не за замовчуванням), за допомогою CreateConnection метод. Якщо користувач хоче використовувати інші з’єднання (не основне і не за замовчуванням), він має передати це з’єднання явно як параметр методу, який він бажає використати. Користувач може додатково створювати будь-яку кількість з’єднань. З’єднання за замовчуванням може бути лише одне на потік. Зверніть увагу, що з’єднання за замовчуванням працюють коректно, якщо користувач використовує об’єкти Thread для багатозадачності. Якщо користувач використовує ConnectionPool або об’єкти Task для багатозадачності, цей режим може призвести до неправильного поводження програми. Щоб уникнути цієї проблеми, користувач повинен вручну звільнити з’єднання за замовчуванням (якщо він його використовує) в кінці виконання коду.
ConnectionAsgmtType.UseMain Клієнт електронної пошти використовує основне з’єднання для всіх операцій з декількох потоків. Основне з’єднання створюється одночасно з клієнтом електронної пошти. Користувач не може створювати з’єднання за замовчуванням. Користувач може створювати з’єднання, не пов’язані з потоками (не за замовчуванням), за допомогою CreateConnection метод. Якщо користувач хоче використовувати інші з’єднання (не основне і не за замовчуванням), він повинен передати це з’єднання явно як параметр методу, який він збирається використовувати.
ConnectionAsgmtType.UseDefault Клієнт електронної пошти неявно використовує лише з’єднання за замовчуванням для всіх операцій з декількох потоків. Основне з’єднання в цьому режимі не використовується. Якщо з’єднання за замовчуванням не було створено для певного потоку (перший виклик методу клієнта), клієнт створює з’єднання за замовчуванням неявно для потоку перед виконанням першої операції. Користувач не може створювати з’єднання за замовчуванням для потоків за допомогою CreateConnectionметод, оскільки вони створюються автоматично. Коли для потоку створюється з’єднання за замовчуванням, воно використовується неявно для всіх методів клієнта електронної пошти, які викликаються в цьому потоці. Користувач також може створювати з’єднання, які не прив’язані до потоків (не з’єднання за замовчуванням), за допомогою CreateConnectionметод. Якщо користувач хоче використовувати інші з’єднання (не основне і не за замовчуванням), він повинен передати це з’єднання явно як параметр методу, який він збирається використовувати. Користувач може додатково створювати будь-яку кількість з’єднань. На один потік може бути використане лише одне з’єднання за замовчуванням. Зверніть увагу, що з’єднання за замовчуванням працюють коректно, якщо користувач використовує об’єкти Thread для багатозадачності. Якщо користувач використовує ConnectionPool або об’єкти Task для багатозадачності, цей режим може призвести до неправильного поводження програми. Щоб уникнути цієї проблеми, користувач повинен вручну звільнити з’єднання за замовчуванням в кінці виконання коду.

Java: Підтримка встановлення Locale для поточного потоку

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email забезпечує можливість встановлювати Locale для поточного потоку. Aspose.Email надає клас CurrentThreadSettings що забезпечує setLocale метод для цього. Наведений нижче фрагмент коду демонструє використання CurrentThreadSettings клас для встановлення поточного Locale. Фрагмент спочатку встановлює Locale у некоректне значення, а потім використовує CurrentThreadSettings.setLocale метод для встановлення Locale для поточного потоку.

Locale defaultLocale = Locale.getDefault();
try {
    // set incorrect default Locale
    Locale.setDefault(new Locale("en", "RU"));
    // set Current Thread Locale
    CurrentThreadSettings.setLocale("en-US");
    // or
    // CurrentThreadSettings.setLocale(new Locale("en", "US"));

    PersonalStorage.create(dataDir + "test.pst", FileFormatVersion.Unicode);
} finally {
    Locale.setDefault(defaultLocale);
}

Java: Важливі деталі iCalendar RFC 2445

Mon, 01 Jan 0001 00:00:00 +0000

Про модель об’єктів Aspose iCalendar

Aspose.Email містить усі класи, надані Aspose iCalendar компонент RecurrencePattern і RecurrenceRule є центральними класами Aspose iCalendar, і надати конкретні реалізації відповідних елементів RFC 2445.

The RecurrencePattern клас представляє весь рекурентний шаблон. Ви можете створити новий рекурентний шаблон з нуля, використовуючи конструктор за замовчуванням, або завантажити існуючий шаблон у CalendarRecurrence. The RecurrenceRule клас представляє частину RRULE або EXRULE рекурентного шаблону. RecurrenceRule надає ряд властивостей, які безпосередньо відповідають їх аналогам у стандарті iCalendar. Наприклад, ByMonth відповідає BYMONTH в iCalendar тощо. Аналізуючи або встановлюючи значення RecurrenceRule властивості, за допомогою яких ви можете аналізувати або змінювати правило повторення. Для отримання додаткової інформації та прикладів коду дивіться RecurrencePattern і RecurrenceRule у довіднику API.

Важливі деталі iCalendar RFC 2445

Цей розділ включає наступні теми:

Формати дати та часу.
DATE.
DATE‑TIME з локальним часом.
DATE‑TIME з часом UTC.
DATE‑TIME з локальним часом та часовим поясом.
BYWEEKNO забезпечує відповідність ISO 8601

Формати дати та часу

Дати, або дати з пов’язаними часами, можуть використовуватись у елементах DTSTART, UNTIL, EXDATE та RDATE при визначенні рекурентного шаблону. iCalendar визначає тип значення DATE для ідентифікації значень, що містять календарну дату, а також тип DATE‑TIME для ідентифікації значень, що вказують точну календарну дату та час доби. Значення DATE‑TIME можуть бути зазначені у трьох формах, з:

Локальний час.
Час UTC.
Локальний час та часовий пояс.

DATE

Згідно стандарту iCalendar, значення DATE мають мати формат yyyyMMdd. Наведений приклад представляє 14 липня 1997 року: 19970714

DATE‑TIME з локальним часом

Дата у формі локального часу — це просто значення date‑time, яке не містить позначки UTC і не посилається на часовий пояс. Наприклад, наступне представляє 18 січня 1998 року о 23:00: DTSTART:19980118T230000. Значення date‑time такого типу називаються "плаваючими" і не прив’язані до жодного конкретного часового поясу. Вони використовуються для представлення однакових годин, хвилин і секунд незалежно від того, який часовий пояс наразі застосовується.

DATE‑TIME з часом UTC

Дата з часом UTC, або абсолютним часом, позначається латинською великою літерою Z, що додається до значення часу. Наприклад, наступне представляє 19 січня 1998 року о 07:00 UTC: DTSTART:19980119T070000Z. Будь ласка, зауважте, що Aspose iCalendar ігнорує суфікс Z у форматі UTC і розглядає час як локальний. Стандарт RFC2445 стверджує, що частина часу, вказана в правилі UNTIL рекурентного шаблону, має бути у форматі UTC. Це дуже дивне твердження, і, фактично, у стандарті є приклади, розраховані некоректно. Aspose iCalendar приймає час у будь‑якому форматі в правилі UNTIL.

DATE‑TIME з локальним часом та часовим поясом

Щоб посилатися на часовий пояс, DATE‑TIME модифікується властивістю TZID. Наприклад, наступне представляє 2:00 в Нью‑Йорку 19 січня 1998 року: DTSTART;TZID=US-Eastern:19980119T020000. Будь ласка, зауважте, що Aspose iCalendar на даний момент ігнорує параметр TZID і розглядає час як місцевий.

BYWEEKNO забезпечує відповідність ISO 8601

Використовуйте BYWEEKNO лише коли потрібна відповідність ISO 8601 необхідний. Номери тижнів, визначені згідно ISO 8601, сильно відрізняються від звичних номерів тижнів. За ISO 8601, перший номер тижня календарного року — це перший тиждень року, у якому є принаймні чотири дні. Це правило робить алгоритм специфічним для застосувань, що вимагають відповідності ISO 8601, і практично робить його непридатним для інших випадків. ISO 8601 підтримується деякими європейськими банківськими та фінансовими застосунками. Він також використовується у телебаченні для планування рекламних роликів. Правило BYWEEKNO визначає список номерів тижнів року, розділених комами. Допустимі значення — від 1 до 53 і від 1 до 53. Це відповідає тижням згідно нумерації, визначеної в ISO 8601. BYWEEKNO діє лише для річних (YEARLY) правил.

Java: Парсинг файлів повідомлень Microsoft Outlook

Mon, 01 Jan 0001 00:00:00 +0000

За допомогою Aspose.Email ви можете розпарсити повідомлення Microsoft Outlook всього за кілька рядків коду. У цій статті показано, як це зробити. Aspose.Email містить класи для виконання різноманітних програмних задач з Outlook‑повідомленнями. Нижчий приклад коду демонструє, як:

Завантажте лист.
Отримайте тему листа.
Отримайте ім’я відправника.
Отримайте повне тіло листа.
Перевірте, чи є вкладення.
Отримайте імена файлів усіх вкладень і збережіть їх.

Наведений фрагмент коду показує, як парсити файли повідомлень Microsoft Outlook.

// The path to the File directory and Load Microsoft Outlook email message file
String dataDir = "data/";
MapiMessage msg = MapiMessage.fromFile(dataDir + "message3.msg");

// Obtain subject of the email message, sender, body and Attachment count
System.out.println("Subject:" + msg.getSubject());
System.out.println("From:" + msg.getSenderName());
System.out.println("Body:" + msg.getBody());
System.out.println("Attachment Count:" + msg.getAttachments().size());

// Iterate through the attachments
for (MapiAttachment attachment : msg.getAttachments()) {
    // Access the attachment's file name and Save attachment
    System.out.println("Attachment:" + attachment.getFileName());
    attachment.save(dataDir + attachment.getLongFileName());
}

Java: Отримання сповіщень про успішно надіслані та невдалі повідомлення

Mon, 01 Jan 0001 00:00:00 +0000

Коли ви хочете отримати сповіщення про доставку як успішних, так і невдаліх повідомлень, ви можете використати оператор вертикальної риски (|) для DeliveryNotificationOptions властивість MailMessage клас. Нижче наведено фрагмент коду, який показує, як отримувати сповіщення про успішно надіслані та невдалі повідомлення.

// Create the message
MailMessage msg = new MailMessage();
msg.setFrom(MailAddress.to_MailAddress("sender@sender.com"));
msg.setTo(MailAddressCollection.to_MailAddressCollection("receiver@receiver.com"));
msg.setSubject("the subject of the message");

// Set delivery notifications for success and failed messages and Add the MIME headers
msg.setDeliveryNotificationOptions(DeliveryNotificationOptions.OnSuccess | DeliveryNotificationOptions.OnFailure);
msg.getHeaders().add("Read-Receipt-To", "sender@sender.com");
msg.getHeaders().add("Disposition-Notification-To", "sender@sender.com");

// Send the message
SmtpClient client = new SmtpClient("host", "username", "password");
client.send(msg);

Java: Виявлення нових електронних листів на POP3 сервері

Mon, 01 Jan 0001 00:00:00 +0000

З використанням POP3-акаунтів ви можете залишати листи на сервері під час їх завантаження та читання. Залишення листів на сервері означає, що вони доступні іншим програмам і користувачам, наприклад, користувачам, які отримують пошту з кількох пристроїв. Або ви можете захотіти завантажувати лише листи, які відповідають певним критеріям, наприклад, листи з певною темою. Для управління поштою ви можете;

Прочитайте всі листи з POP3 сервера за допомогою Aspose.Email.
Завантажте листи у вашу локальну базу даних.

Листи не видаляються, а залишаються на сервері. Перший запуск проходить успішно: всі потрібні листи завантажуються у базу даних. При другому запуску ті ж листи завантажуються знову, оскільки вони все ще перебувають на сервері, що призводить до дублювання записів. Щоб вирішити цю проблему, використовуйте Pop3MessageInfo.UniqueID властивість для перевірки, чи був лист вже завантажений. Унікальний ідентифікатор листа має зберігатися в базі даних: це ключ пошуку для виявлення нових листів.

Виявлення нових повідомлень

Щоб визначити нові листи у списку листів на POP3 сервері:

Підключаєтесь до сервера.
Отримуєте список листів.
Підключаєтеся до бази даних.
Отримуєте список листів.
Порівнюєте списки.
Зберігаєте нові листи у базу даних.

Процес швидший, коли ви:

Отримайте всі унікальні ідентифікатори листів у хеш-таблицю.
Шукайте в хеш-таблиці замість бази даних для кожного листа у циклі for(…)

Замість запиту до бази даних для кожного листа, що потребує багатьох звернень, цей метод вимагає лише одного виклику. Наведений фрагмент коду показує, як виявити нові листи на POP3 сервері.

public static void run() {
    try {
        // Connect to the POP3 mail server and check messages.
        Pop3Client pop3Client = new Pop3Client("pop.domain.com", 993, "username", "password");

        // List all the messages
        Pop3MessageInfoCollection msgList = pop3Client.listMessages();
        for (Pop3MessageInfo msgInfo : msgList) {
            // Get the POP3 message's unique ID
            String strUniqueID = msgInfo.getUniqueId();

            // Search your local database or data store on the unique ID. If a match is found, that means it's already downloaded. Otherwise download and save it.
            if (searchPop3MsgInLocalDB(strUniqueID) == true) {
                // The message is already in the database. Nothing to do with this message. Go to next message.
            } else {
                // Save the message
                savePop3MsgInLocalDB(msgInfo);
            }
        }
    } catch (Exception ex) {
        System.err.println(ex);
    }

}

private static void savePop3MsgInLocalDB(Pop3MessageInfo msgInfo) {
    // Open the database connection according to your database. Use public properties (for example msgInfo.Subject) and store in database,
    // for example, " INSERT INTO POP3Mails (UniqueID, Subject) VALUES ('" + msgInfo.UniqueID + "' , '" + msgInfo.Subject + "') and Run the query to store in database.
}

private static boolean searchPop3MsgInLocalDB(String strUniqueID) {
    // Open the database connection according to your database. Use strUniqueID in the search query to find existing records,
    // for example, " SELECT COUNT(*) FROM POP3Mails WHERE UniqueID = '" + strUniqueID + "' Run the query, return true if count == 1. Return false if count == 0.
    return false;
}

Java: Встановлення кодування тексту за замовчуванням у листі

Mon, 01 Jan 0001 00:00:00 +0000

У цій статті представлено MailMessage.PreferredTextEncoding властивість і пояснює, як її використовувати. За допомогою цієї властивості ви можете встановити кодування тексту за замовчуванням для наступних властивостей:

From: Відображуване ім’я
To: Відображуване ім’я
Subject
Тіло

Встановлення кодування тексту за замовчуванням

У попередніх версіях Aspose.Email кодування тексту для властивостей from, to, subject та body встановлювалося окремо. Щоб підвищити зручність, ми додали PreferredTextEncoding властивість, що встановлює все одразу. Тепер легше гарантувати, що весь текст у зазначених вище властивостях правильно закодований у листі. Наведений фрагмент коду показує, як використати французьке слово як відображуване ім’я для електронних адрес, теми та тіла листа.

// Create an instance of MailMessage
String fileName = "data/";
MailMessage msg = new MailMessage();

// Set the default or preferred encoding. This encoding will be used as the default for the from/to email addresses, subject and body of message.
msg.setPreferredTextEncoding(Charset.forName("cp1252"));

// Set email addresses, subject and body
msg.setFrom(new MailAddress("dmo@domain.com", "démo"));
msg.getTo().addItem(new MailAddress("dmo@domain.com", "démo"));
msg.setSubject("démo");
msg.setHtmlBody("démo");
msg.save(fileName + "SetDefaultTextEncoding_out.msg", SaveOptions.getDefaultMsg());

Java: Перетворення файлу повідомлення Outlook (MSG) у зображення TIFF

Mon, 01 Jan 0001 00:00:00 +0000

Перетворення файлу Outlook MSG у зображення TIFF не підтримується в Aspose.Email for Java.

Java: Використання документа Microsoft Word як тіла повідомлення та надсилання електронної пошти

Mon, 01 Jan 0001 00:00:00 +0000

У цій статті показано, як використовувати документ Microsoft Word як тіло електронного листа та надсилати його одержувачам. Приклад документа – рахунок-фактура продажу з прикладу бази даних Northwind, експортований у формат Microsoft Word. Aspose.Email for Java працює з мережевими протоколами та функціями Microsoft Outlook і не може обробляти документи Microsoft Word. Щоб подолати це, приклади в цій статті використовують Aspose.Words for Java для завантаження документа Word та конвертації його у формат MHTML. Aspose.Email for Java використовує документ MHTML у тілі електронного листа.

Використання документів Microsoft Word як тіла електронного листа

Нижче наведені зразки коду, які демонструють, як надіслати документ Word як тіло електронного листа за допомогою Aspose.Words for Java та Aspose.Email for Java:

Завантажте документ Microsoft Word за допомогою Aspose.Word for Java Document клас.
Збережіть його у форматі MHTML.
Завантажте документ MHTML за допомогою Aspose.Email for Java MailMessage клас для встановлення тіла електронного листа.
Встановіть інші властивості повідомлення, використовуючи різні MailMessage властивостей та методів класу.
Надішліть електронний лист за допомогою Aspose.Email for Java SMTPClient клас.

Вихідний документ, рахунок‑фактура продажу, експортований у Microsoft Word з прикладу Microsoft Northwind, можна бачити нижче.

Коли повідомлення було надіслано та отримано в Microsoft Outlook, воно виглядає так, як нижче.

HTML‑форматування та зображення зберігаються так само, як у вихідному документі, при перегляді в Outlook або веб‑клієнті електронної пошти, такому як Gmail чи Hotmail. Нижче — скріншот повідомлення, відкритого у Gmail у браузері Chrome.

У наведеному фрагменті коду показано, як використовувати документ Microsoft Word як тіло повідомлення та надіслати електронний лист за допомогою SmtpClient екземпляр класу.

// The path to the File directory
String dataDir = "data/";

// Load a Word document from disk and save it to stream as MHTML
Document wordDocument = new Document(dataDir + "Test.doc");
ByteArrayOutputStream mhtmlStream = new ByteArrayOutputStream();
wordDocument.save(mhtmlStream, SaveFormat.MHTML);

// Load the MHTML in a MailMessage object
MailMessage message = MailMessage.load(new ByteArrayInputStream(mhtmlStream.toByteArray()), new MhtmlLoadOptions());
message.setSubject("Sending Invoice in Email");
message.setFrom(new MailAddress("sender@gmail.com"));
message.setTo(MailAddressCollection.to_MailAddressCollection("recipient@gmail.com"));

// Save the message in MSG format to disk
message.save(dataDir + "WordDocAsEmailBody_out.msg", SaveOptions.getDefaultMsgUnicode());

    // Send the email message
try (SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "sender@gmail.com", "pwd")) {
    client.setSecurityOptions(SecurityOptions.SSLExplicit);
    client.send(message);
}

Java: Функції друку Aspose.Email

Mon, 01 Jan 0001 00:00:00 +0000

Функції друку

Функції Printing Features не підтримуються в Aspose.Email для Java.

Java: Генерувати випадки за шаблоном повторення

Mon, 01 Jan 0001 00:00:00 +0000

За допомогою Aspose.Email можна генерувати події, використовуючи шаблон повторення. Ця стаття пояснює як, як саме згенерувати наступну подію і отримати зручні для користувача описання елементів. Події з шаблону повторення календаря MAPI можна генерувати за допомогою Aspose.Email. Наведений нижче фрагмент коду показує, як генерувати події з шаблонів повторення.

Обчислити наступну подію або n наступних подій

Щоб отримати "наступну" подію, використайте метод GenerateOccurrences з параметром nNextOccurrences = 1. Наведений нижче фрагмент коду показує, як згенерувати 20 подій, використовуючи nNextOccurrences = 20. Вивід коду нижче виглядає наступним чином:

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

CalendarRecurrence recurrencePattern = new CalendarRecurrence();

recurrencePattern.setStartDate(sdf.parse("1997-09-10 09:00:00"));
RecurrenceRule rule = recurrencePattern.getRRules().add();
rule.setFrequency(Frequency.Monthly);
rule.setCount(20);
rule.setInterval(18);
rule.getByMonthDay().add(new int[] { 10, 11, 12, 13, 14, 15 });
DateCollection expectedDates = recurrencePattern.generateOccurrences(20);
System.out.println("expectedDates.Count = " + expectedDates.size());
for (int i = 0; i < expectedDates.size(); i++) {
    System.out.println("DateTime = " + sdf.format(expectedDates.getItem(i)));
}

Отримати дружній для користувача текст для повторення

Дружній для користувача текст правила можна отримати, використовуючи властивість FriendlyText, як показано нижче. Результат коду буде: "Повторювати щомісяця в 1-й і 1-й з кінця дня(днів) місяця, максимум 2 випадки.". Наступний фрагмент коду показує, як отримати дружній для користувача текст для повторення.

RecurrenceRule rule = recurrencePattern.getRRules().add();
rule.setFrequency(Frequency.Monthly);
rule.setCount(2);
rule.getByMonthDay().add(1);
rule.getByMonthDay().add(-1);
System.out.println(rule.getFriendlyText());

Java: Доступ до поштових сервісів за допомогою OAuth

Mon, 01 Jan 0001 00:00:00 +0000

Підтримку OAuth 2.0 додано до Aspose.Email, і її можна використовувати для доступу до серверів SMTP, POP3, IMAP та EWS. Загалом, всі сервери, що підтримують токени типу Bearer OAuth 2.0, можуть бути використані з Aspose.Email, однак наші клієнти електронної пошти протестовані на серверах пошти Google та серверах Microsoft Office 365. Доступ до сервера з SmtpClient, Pop3Client, ImapClient і EWSClient за допомогою OAuth може бути реалізовано 2 способами.

Надайте токен доступу безпосередньо у конструктор клієнта електронної пошти. У цьому випадку користувач повинен розуміти, що термін дії токенів обмежений. Коли токен прострочений, клієнт електронної пошти не може бути використаний для доступу до сервера.
Надайте користувацьку реалізацію постачальника токенів на основі ITokenProvider інтерфейс у конструктор клієнта електронної пошти. У цьому випадку клієнт перевіряє час закінчення терміну дії токена і запитує ITokenProvider для отримання нового токену доступу, коли попередній прострочений. Таким чином, клієнт періодично оновлює токени і може працювати з сервером необмежений час. Часто сервіси підтримують простий спосіб оновлення токенів доступу. Наприклад, використання токенів оновлення у сервісах Google або потік автентифікації ROPC у платформі Microsoft Identity може бути використано для реалізації постачальника токенів.

Налаштування облікового запису на відповідному сервері

Наступні статті допоможуть вам налаштувати облікові записи для доступу до поштових сервісів.

Для Office 365
Для Gmail

Доступ до поштових сервісів за допомогою токенів доступу

Наступні приклади коду показують, як підключитися до поштових сервісів, використовуючи токени доступу.

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.gmail.com",
        587,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "imap.gmail.com",
        993,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "pop.gmail.com",
        995,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.Auto)) {

}

Доступ до поштових сервісів за допомогою постачальників токенів

Наступні приклади коду показують, як підключитися до поштових сервісів, використовуючи постачальник токенів.

ITokenProvider tokenProvider = TokenProvider.Google.getInstance(
        "ClientId",
        "ClientSecret",
        "RefreshToken");

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.gmail.com",
        587,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "imap.gmail.com",
        993,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "pop.gmail.com",
        995,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.Auto)) {

}

Реалізація користувацького ITokenProvider для Office 365

Ви можете використати нижченаведену реалізацію постачальника токенів для доступу до поштових сервісів Office 365.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = geToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> geToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" +
                        connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<>();
            String[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

Наступні приклади коду показують, як підключитися до сервісів Office 365, використовуючи користувацький постачальник токенів.

ITokenProvider tokenProvider = new AzureROPCTokenProvider(
        "Tenant",
        "ClientId",
        "ClientSecret",
        "EMail",
        "Password",
        scopes);

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.office365.com",
        587,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "outlook.office365.com",
        993,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "outlook.office365.com",
        995,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.Auto)) {

}

// Connecting to EWS server
final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
ICredentials credentials = new OAuthNetworkCredential(tokenProvider);
try (IEWSClient ewsClient = EWSClient.getEWSClient(mailboxUri, credentials)) {

}

Java: Використання OAuth для доступу до поштових сервісів

Mon, 01 Jan 0001 00:00:00 +0000

Надайте токен доступу безпосередньо у конструктор клієнта електронної пошти. У цьому випадку користувач повинен розуміти, що термін дії токенів обмежений. Коли токен прострочений, клієнт електронної пошти не може бути використаний для доступу до сервера.
Надайте користувацьку реалізацію постачальника токенів на основі ITokenProvider інтерфейс у конструктор клієнта електронної пошти. У цьому випадку клієнт перевіряє час закінчення терміну дії токена і запитує ITokenProvider для отримання нового токену доступу, коли попередній прострочений. Таким чином, клієнт періодично оновлює токени і може працювати з сервером необмежений час. Часто сервіси підтримують простий спосіб оновлення токенів доступу. Наприклад, використання токенів оновлення у сервісах Google або потік автентифікації ROPC у платформі Microsoft Identity може бути використано для реалізації постачальника токенів.

Налаштування облікового запису на відповідному сервері

Наступні статті допоможуть вам налаштувати облікові записи для доступу до поштових сервісів.

Для Office 365
Для Gmail

Доступ до поштових сервісів за допомогою токенів доступу

Наступні приклади коду показують, як підключитися до поштових сервісів, використовуючи токени доступу.

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.gmail.com",
        587,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "imap.gmail.com",
        993,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "pop.gmail.com",
        995,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.Auto)) {

}

Доступ до поштових сервісів за допомогою постачальників токенів

ITokenProvider tokenProvider = TokenProvider.Google.getInstance(
        "ClientId",
        "ClientSecret",
        "RefreshToken");

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.gmail.com",
        587,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "imap.gmail.com",
        993,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "pop.gmail.com",
        995,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.Auto)) {

}

Реалізація користувацького ITokenProvider для Office 365

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = geToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> geToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" +
                        connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<>();
            String[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

ITokenProvider tokenProvider = new AzureROPCTokenProvider(
        "Tenant",
        "ClientId",
        "ClientSecret",
        "EMail",
        "Password",
        scopes);

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.office365.com",
        587,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "outlook.office365.com",
        993,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "outlook.office365.com",
        995,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.Auto)) {

}

// Connecting to EWS server
final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
ICredentials credentials = new OAuthNetworkCredential(tokenProvider);
try (IEWSClient ewsClient = EWSClient.getEWSClient(mailboxUri, credentials)) {

}

Дозволи для доступу до Office 365 через IMAP, POP3 або SMTP

Необхідно застосувати правильні дозволи API та надати адміністративну згоду для доступу до поштових сервісів Office 365:

У майстрі дозволів API / Додати дозвіл виберіть Microsoft Graph, а потім Делеговані дозволи, щоб знайти наведених нижче областей дозволів:

offline_access
IMAP.AccessAsUser.All
POP.AccessAsUser.All
SMTP.Send

Приклад постачальника токену:

ITokenProvider tokenProvider = new AzureROPCTokenProvider(OAuth.Tenant, OAuth.ClientId, OAuth.ClientSecret, User.EMail, User.Password,
        new String[] {
                "offline_access",
                "https://outlook.office.com/IMAP.AccessAsUser.All", // IMAP scope
                "https://outlook.office.com/POP.AccessAsUser.All",  // POP3 scope
                "https://outlook.office.com/SMTP.Send"              // SMTP scope
        });

Java: Видобування даних вбудованих об’єктів

Mon, 01 Jan 0001 00:00:00 +0000

Іноді вбудовані OLE-дані представляються у вигляді вкладення "oleData.mso" за MapiAttachment і потребує ручного видобутку. Ці файли oleData.mso мають формат Microsoft Computer Document File (MCDF), і підтримка таких файлів виходить за межі можливостей Aspose.Email. Однак Aspose.Email можна використовувати в комбінації з іншими open-source бібліотеками, такими як OpenMCDF, для читання вмісту таких файлів і збереження їх на диск. Aspose.Email надає InlineAttachmentExtractor клас для перелічення MSO‑пакетів з бінарних даних oledata.mso, які потім можна використовувати для видобування вмісту за допомогою бібліотек читання Compound Files.

Якщо тип тіла листа — HTML (не RTF), і в листі є OLE‑об’єкти, властивість MapiPropertyTag.PR_ATTACH_DATA_OBJ відсутня. У такому випадку інформація про OLE‑об’єкти міститься у файлі oldedata.mso.

Видобування вбудованих об’єктів

У цій статті показано, як витягти вміст із такого файлу за допомогою Aspose.Email:

// The path to the File directory
String dataDir = "/data";

MapiMessage msg = MapiMessage.fromFile(dataDir + "double.msg");
for (MapiAttachment mapiAttachment : msg.getAttachments()) {
    if ("oledata.mso".equals(mapiAttachment.getLongFileName())) {
        IGenericDictionary<String, byte[]> oledata = InlineAttachmentExtractor.enumerateMsoPackage(new ByteArrayInputStream(mapiAttachment.getBinaryData()));

        for (String oleItem : oledata.getKeys()) {
            // Use binary data
            processBynaryData(oledata.get_Item(oleItem));
        }
    }
}

Java: Надсилання запиту на зустріч з повторенням

Mon, 01 Jan 0001 00:00:00 +0000

За допомогою Aspose.Email можна створити запит на зустріч з повторенням. У цій статті пояснюється, як можна створити запит на зустріч з конкретним повторенням. Унікальний ідентифікатор зустрічі можна зберегти для подальшого використання під час надсилання оновлень до зустрічі.

Генерація запиту на зустріч з повторенням

Наступний зразок коду показує, як це реалізувати.

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
String szUniqueId;

// Create a mail message
MailMessage msg1 = new MailMessage();
msg1.getTo().add("to@domain.com");
msg1.setFrom(new MailAddress("from@gmail.com"));

// Fill appointment object
Date startDate = sdf.parse("2013-12-01 17:00:00");
Date endDate = sdf.parse("2013-12-31 17:30:00");

// Create appointment object
Appointment agendaAppointment = new Appointment("same place", startDate, endDate, msg1.getFrom(), msg1.getTo());

// Create unique id as it will help to access this appointment later
szUniqueId = UUID.randomUUID().toString();
agendaAppointment.setUniqueId(szUniqueId);
agendaAppointment.setDescription("----------------");

// Create a weekly reccurence pattern object
WeeklyRecurrencePattern pattern1 = new WeeklyRecurrencePattern(14);

// Set weekly pattern properties like days: Mon, Tue and Thu
pattern1.setStartDays(new int[3]);
pattern1.getStartDays()[0] = CalendarDay.Monday;
pattern1.getStartDays()[1] = CalendarDay.Tuesday;
pattern1.getStartDays()[2] = CalendarDay.Thursday;
pattern1.setInterval(1);

// Set recurrence pattern for the appointment
agendaAppointment.setRecurrence(pattern1);

// Attach this appointment with mail
msg1.getAlternateViews().addItem(agendaAppointment.requestApointment());

// Create SmtpCleint
SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "your.email@gmail.com", "your.password");
client.setSecurityOptions(SecurityOptions.Auto);

// Send mail with appointment request
client.send(msg1);

// Return unique id for later usage
// return szUniqueId;

Надіслати запит оновлення зустрічі

Для надсилання оновлення попередньої зустрічі потрібен унікальний ідентифікатор. Наведений приклад коду показує, як можна надіслати запит оновлення цієї зустрічі

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
Date startDate = sdf.parse("2013-12-12 17:00:00");
Date endDate = sdf.parse("2013-12-12 17:30:00");
Appointment appUpdate = new Appointment("Different Place", startDate, endDate, new MailAddress("newcustomeronnet@gmail.com"),
        MailAddressCollection.to_MailAddressCollection("kashif.iqbal@aspose.com"));
appUpdate.setUniqueId(szUniqueId);
WeeklyRecurrencePattern pattern3 = (WeeklyRecurrencePattern) appUpdate.getRecurrence();
appUpdate.setSummary("update meeting request summary");
appUpdate.setDescription("update");
MailMessage msgUpdate = new MailMessage("newcustomeronnet@gmail.com", "kashif.iqbal@aspose.com", "06 - test email - update meeting request", "test email");
msgUpdate.addAlternateView(appUpdate.updateAppointment());
SmtpClient smtp = new SmtpClient("server.domain.com", 587, "username", "password");
smtp.send(msgUpdate);

Java: Підтримка багатопотоковості в поштових клієнтах

Mon, 01 Jan 0001 00:00:00 +0000

Поштові клієнти, такі як ImapClient і Pop3Client дозволяють користувачам використовувати їх у багатопотоковому середовищі. Поштові клієнти дозволяють мати одне або кілька з’єднань з сервером. Для керування набором з’єднань всередині клієнтів використовується пул з’єднань. Кількість з’єднань, які можуть бути створені та використані одночасно, обмежується властивістю CredentialsByHostClient.MaxConnectionsPerServer. Ця властивість може бути встановлена в 1 або більше. За замовчуванням вона дорівнює 10. Для з’єднання реалізована черга команд для підтримки багатопотокових операцій. Команди реалізують найпростіші операції, визначені протоколом, такі як Noop, Authenticate тощо. Користувач може запустити виконання більшої кількості команд, ніж доступна кількість з’єднань. Однак вони будуть виконані лише тоді, коли клієнт зможе створити з’єднання для операції.

Методи використання поштових клієнтів у багатопотоковому середовищі

Поштові клієнти мають таку поведінку:

1. Якщо MaxConnectionsPerServer = 1, клієнт створює 1 з’єднання, виконує автентифікацію та авторизацію. Це з’єднання підтримується у робочому стані до моменту, коли клієнт буде звільнений. Усі операції з різних потоків направляються в одну чергу команд, розміщену в головному з’єднанні.

2. Якщо MaxConnectionsPerServer > 1, клієнт створює необхідну кількість з’єднань, виконує автентифікацію та авторизацію для кожного з’єднання. Одне з’єднання зарезервовано як головне з’єднання. Це з’єднання підтримується у робочому стані до моменту, коли клієнт буде звільнений. Інші з’єднання створюються та звільняються за потребою. Максимальна кількість таких з’єднань визначається властивістю MaxConnectionsPerServer, наприклад, якщо MaxConnectionsPerServer = 2, то одне зарезервовано як головне з’єднання, а друге використовується як додаткове для операцій, які виконуються в інших потоках. Аналогічно, якщо MaxConnectionsPerServer = 3, то перше з’єднання зарезервовано як головне, а два інші використовуються як додаткові для операцій в інших потоках. У випадку надходження запиту на з’єднання від нового потоку, і коли всі з’єднання вже зайняті, клієнт чекає, доки кількість використаних з’єднань не зменшиться. Це дуже важливий момент, який пояснює, чому правильне звільнення з’єднань є таким важливим.

Приклади

Користувач може виконувати операції в різних потоках кількома способами. Їх можна розділити на два типи:

1. Користувач використовує асинхронні (Begin/End) методи, визначені в клієнті. У цьому випадку поштовий клієнт запускає нові потоки за потреби. У клієнті реалізована черга задач (будь ласка, не плутайте її з чергою команд у з’єднанні). Задача може бути виконана, якщо з’єднання доступне. Коли кількість використаних з’єднань стає меншою за межеве значення, клієнт створює нове з’єднання, створює потік для поточної задачі і виконує її. Приклад використання асинхронних операцій:

// Create an imapclient with host, user and password
ImapClient client = new ImapClient();
client.setHost("domain.com");
client.setUsername("username");
client.setPassword("password");
client.selectFolder("InBox");

ImapMessageInfoCollection messages = client.listMessages();
IAsyncResult res1 = client.beginFetchMessage(messages.get_Item(0).getUniqueId());
IAsyncResult res2 = client.beginFetchMessage(messages.get_Item(1).getUniqueId());
MailMessage msg1 = client.endFetchMessage(res1);
MailMessage msg2 = client.endFetchMessage(res2);

2. Користувач може створювати потоки, використовуючи такі об’єкти як Thread, ExecutorService або інші об’єкти, передбачені для цієї мети. Також користувач може використовувати потоки, створені у сторонньому коді. При цьому клієнт має дві моделі поведінки

a. Якщо користувач не створює додаткових з’єднань для операцій у потоці, всі операції для цього потоку будуть відправлені в чергу команд головного з’єднання. Приклад операцій у додатковому потоці без створення нового з’єднання, всі транзакції виконуються через головне з’єднання:

/**
 * Creates an executor service with a fixed pool size, that will time 
 * out after a certain period of inactivity.
 * 
 * @param poolSize The core- and maximum pool size
 * @param keepAliveTime The keep alive time
 * @param timeUnit The time unit
 * @return The executor service
 */
private static ExecutorService createFixedTimeoutExecutorService(
    int poolSize, long keepAliveTime, TimeUnit timeUnit)
{
    ThreadPoolExecutor e = 
        new ThreadPoolExecutor(poolSize, poolSize,
            keepAliveTime, timeUnit, new LinkedBlockingQueue<Runnable>());
    e.allowCoreThreadTimeOut(true);
    return e;
}

final List<MailMessage> list = new ArrayList<MailMessage>();

ExecutorService executor = createFixedTimeoutExecutorService(1, 1000, TimeUnit.MILLISECONDS);

executor.execute(new Runnable() {
    public void run() {
        client.selectFolder("folderName");
        ImapMessageInfoCollection messageInfoCol = client.listMessages();
        for (ImapMessageInfo messageInfo : messageInfoCol) {
            list.add(client.fetchMessage(messageInfo.getUniqueId()));
        }
    }
});

b. Коли користувач виконує метод створення нового з’єднання для додаткового потоку, цей потік блокується, поки значення квоти для нових з’єднань не буде змінено, щоб дозволити нове з’єднання. Потім нове з’єднання створюється. Це з’єднання встановлюється як дефолтне з’єднання для всіх операцій у цьому потоці. Після завершення всіх операцій у цьому потоці з’єднання має бути звільнене. Для створення нових з’єднань використовуйте метод CredentialsByHostClient.CreateConnection. Цей метод повертає об’єкт, який реалізує інтерфейс IDisposable. Для звільнення з’єднання треба викликати метод Dispose. Створення та звільнення з’єднання повинні виконуватись всередині потоку, у якому виконуються поштові операції. Спроба створити нове з’єднання у потоці, в якому був створений поштовий клієнт, призводить до помилки, оскільки цей потік у даний момент не може бути використаний для створення нового з’єднання. Також створення нового з’єднання неможливе, коли MaxConnectionsPerServer = 1. Приклад коду створення нового з’єднання в додатковому потоці:

final List<MailMessage> list = new ArrayList<MailMessage>();

ExecutorService executor = createFixedTimeoutExecutorService(1, 1000, TimeUnit.MILLISECONDS);

executor.execute(new Runnable() {
    public void run() {
        IConnection connection = client.createConnection();
        try {
            client.selectFolder(connection, "FolderName");
            ImapMessageInfoCollection messageInfoCol = client.listMessages(connection);
            for (ImapMessageInfo messageInfo : messageInfoCol)
                list.add(client.fetchMessage(connection, messageInfo.getUniqueId()));
        } finally {
            connection.dispose();
        }
    }
});

Java: Вступ та приклади застосувань

Mon, 01 Jan 0001 00:00:00 +0000

Сценарії використання Aspose.Email Mail

У цій статті пропонується кілька можливих застосувань Aspose.Email для Java, зокрема зосереджуючись на можливостях програмування електронної пошти компонента.

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

API Aspose.Email Mail можна використовувати для створення надійного додатку розсилки новин. Завдяки підтримці Aspose.Email додавання вбудованих об’єктів (наприклад, зображень, звуків тощо), можна створювати багаті HTML‑розсилки з повними images (та іншими вбудованими об’єктами). Використовуючи можливість масової розсилки в API Aspose.Email Mail, можна надсилати величезні масові листи за обмежений час. Aspose.Email Mail також надає функцію злиття пошти на основі шаблону, яку можна використати для створення шаблону розсилки новин. Цей шаблон можна застосовувати для злиття пошти при надсиланні масових розсилок. Існує багато інших можливих завдань, які Aspose.Email Mail може виконувати в додатку email‑маркетингу.

Інші інструменти маркетингу

Подібно до додатків розсилки новин, за допомогою Aspose.Email Mail можна створювати багато інших видів програмного забезпечення. Використовуйте його для створення email‑маркетингу, масових розсилок та e‑кампаній, та інше.

Ділові додатки

Aspose.Email Mail можна використовувати майже у всіх типах ділових додатків для виконання утилітних завдань:

Сповіщення електронною поштою: Надсилайте сповіщення, щоб інформувати користувачів про події.
Запити на зустріч: Надсилайте запити на ділові зустрічі, використовуючи підтримку 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.

Спроектуйте ваш додаток: створіть інтерфейс, який приймає три поля: From, To та Message.
Двічі клацніть кнопку Send у режимі дизайну та напишіть код у редакторі.
Створіть екземпляр класу MailMessage і використайте його властивості для формування електронного листа. (Екземпляри класу MailMessage використовуються для створення листів, які передаються SMTP‑серверу для доставки за допомогою класу SmtpClient).
Створіть екземпляр класу SmtpClient та використайте його властивості для надсилання електронного листа.
Протестуйте ваш додаток.
Введіть адреси у поля From та To.
Введіть повідомлення у поле Message Body.
Клацніть 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 реалізує протокол поштового відділення версії 3 (POP3) у 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.

Створіть екземпляр класу Pop3Client.
Встановіть у цьому екземплярі ім’я хоста POP3, логін та пароль.
Створіть екземпляр MailMessage і отримайте перший лист у вашому обліковому записі, викликавши функцію fetchMessage(). Це завантажить перше повідомлення з вашого поштового акаунту в екземпляр MailMessage.
Використовуйте властивості 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 до своїх Java‑застосунків, без необхідності розуміти деталі протоколу. Компонент підтримує отримання та завантаження листів, перевірку статусу листів (нові/прочитані/непрочитані) та інше.

Imap : Основні можливості

Aspose.Email Imap дозволяє:

Отримати листи.
Завантажуйте листи.
Перелічуйте листи у різних папках.
Перевірте статус листів.
Працюйте з 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. Ми створюємо невеликий застосунок, який отримує кількість листів у вашому IMAP‑акаунті. Дотримуйтесь наведених нижче кроків, щоб створити приклад застосунку з використанням Aspose.Email Imap.

Створіть екземпляр ImapClient, передавши назву сервера IMAP, логін та пароль.
Викличте функцію selectFolder() екземпляра ImapClient, щоб вибрати папку, у якій необхідно підрахувати кількість повідомлень.
Тепер викличте властивість CurrentFolder.TotalMessageCount екземпляра ImapClient, щоб отримати кількість листів.

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 Server. Використовуючи цей компонент, ви можете підключатися, перелікати повідомлення та завантажувати листи з поштової скриньки Exchange Server без необхідності розуміти деталі протоколу. Компонент підтримує перелік повідомлень, надсилання листів, завантаження повідомлень та збереження їх у форматах eml або msg на локальному диску тощо.

Exchange : Основні можливості

Aspose.Email Exchange дозволяє:

Підключатися до Microsoft Exchange Server.
Перераховувати листи у скриньках Exchange.
Перераховувати електронні листи з різних папок, наприклад Inbox, Sent, Deleted або Drafts.
Видаляти повідомлення в будь‑якій папці на Exchange Server.

Використання Aspose.Email Exchange

За допомогою Aspose.Email Exchange розробники можуть отримувати доступ до поштових скриньок Exchange Server зі своїх Java‑застосунків. Він надає простий у використанні API для керування електронною поштою на Exchange Server. Розробники можуть створювати консольні, десктопні або веб‑застосунки, які керують листами в скриньках Exchange.

Приклад застосунку Aspose.Email Exchange

У цій статті показано, як використовувати Aspose.Email Exchange. Ми створюємо простий десктопний застосунок, який підключається до поштової скриньки Exchange Server, отримує список повідомлень у папці Inbox та відображає їх у формі Windows.

Exchange : Кроки прикладу застосунку

Щоб успішно запустити застосунок, потрібні правильні облікові дані для доступу до Exchange Server. Тут ми отримуємо інформацію про облікові дані — URI Exchange Server, ім’я користувача, пароль та домен — з форми 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 Server. Метод 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 є ланкою між вищезазначеними двома і аналізує повідомлення електронної пошти.

Java: Скасування запитів на зустріч за допомогою календаря

Mon, 01 Jan 0001 00:00:00 +0000

Ви можете надіслати запит на скасування зустрічі за допомогою Aspose.Email, використовуючи об’єкт класу Appointment. Потрібна вихідна інформація про запит на зустріч, щоб скасувати його. У прикладі в цій статті спочатку надсилається запит на зустріч, інформація зберігається в базі даних, а потім запит скасовується на підставі ідентифікатора повідомлення.

Надсилання запитів на зустріч

Перш ніж ми зможемо скасувати запити на зустрічі, нам потрібно надіслати декілька:

Спочатку створіть екземпляр типу SmtpClient для надсилання повідомлення.
Збережіть всю інформацію про учасників у колекції MailAddressCollection.
Створіть екземпляр класу MailMessage та необхідні властивості, такі як From, To і Subject.
Створіть екземпляр типу Appointment і вкажіть місце, час початку, час закінчення, організаторів та учасників.
Збережіть всю інформацію у базі даних. Робота з БД виконується у методі SaveIntoDB.

Наступний фрагмент коду показує, як надсилати запити на зустріч.

class Attendees {
    public String MessageId;
    public String EmailAddress;
    public String DisplayName;
}

class Message {
    public String MessageId;
    public String From;
    public String Subject;
    public String Body;
    public String AppLocation;
    public Date AppStartDate;
    public Date AppEndDate;
    public String AppSummary;
    public String AppDescription;
}

public void send(Attendees[] attendeesArr, String from, String appLocation, Date appStartDate, Date appEndDate) {
    try {
        // Create an instance of SMTPClient
        SmtpClient client = new SmtpClient("MailServer", "Username", "Password");
        // Get the attendees
        MailAddressCollection attendees = new MailAddressCollection();
        for (Attendees a : attendeesArr) {
            attendees.addItem(new MailAddress(a.EmailAddress, a.DisplayName));
        }

        // Create an instance of MailMessage for sending the invitation
        MailMessage msg = new MailMessage();

        // Set from address, attendees
        msg.setFrom(new MailAddress(from));
        msg.setTo(attendees);

        // Create am instance of Appointment
        Appointment app = new Appointment(appLocation, appStartDate, appEndDate, new MailAddress(from), attendees);
        app.setSummary("Monthly Meeting");
        app.setDescription("Please confirm your availability.");
        msg.addAlternateView(app.requestApointment());

        // Save the info to the database
        if (saveIntoDB(msg, app) == true) {
            // Save the message and Send the message with the meeting request
            msg.save(msg.getMessageId() + ".eml", SaveOptions.getDefaultEml());
            client.send(msg);
            System.out.println("message sent");
        }
    } catch (Exception ex) {
        System.err.println(ex);
    }
}

private boolean saveIntoDB(MailMessage msg, Appointment app) {
    // Save Message and Appointment information
    Message messageRow = new Message();
    messageRow.MessageId = msg.getMessageId();
    messageRow.From = msg.getFrom().getAddress();
    messageRow.Subject = msg.getSubject();
    messageRow.Body = msg.getBody();
    messageRow.AppLocation = app.getLocation();
    messageRow.AppStartDate = app.getStartDate();
    messageRow.AppEndDate = app.getEndDate();
    messageRow.AppSummary = app.getSummary();
    messageRow.AppDescription = app.getDescription();
    addToDB(messageRow);

    // Save attendee information
    for (MailAddress address : app.getAttendees()) {
        Attendees attendeesRow = new Attendees();
        attendeesRow.MessageId = msg.getMessageId();
        attendeesRow.EmailAddress = address.getAddress();
        attendeesRow.DisplayName = address.getDisplayName();
        addToDB(attendeesRow);
    }

    return true;
}

Скасування запиту на зустріч

Щоб скасувати запит на зустріч, спочатку отримайте ідентифікатор повідомлення електронної пошти. Оскільки ми зберегли цю інформацію в базі даних для цього прикладу, її можна легко отримати знову.

Вибір повідомлення, для якого слід надіслати запит на скасування.
Натисніть Send Cancel Request, щоб відправити запит.
Запитує базу даних, щоб отримати інформацію про учасників, повідомлення та календар.
Створіть екземпляри класу Calendar та MailMessage, використовуючи дані, отримані з бази даних.
Використайте метод Appointment.cancelAppointment() для надсилання запиту на скасування.
Надішліть лист за допомогою SMTP.

Наступний фрагмент коду показує, як скасувати запит на зустріч.

public void cancel(String messageId) {
    // Get the message and calendar information from the database get the attendee information

    // Get the attendee information in reader
    Attendees[] attendeesRows = getAttendeesFromDB(messageId);

    // Create a MailAddressCollection from the attendees found in the database
    MailAddressCollection attendees = new MailAddressCollection();
    for (Attendees attendeesRow : attendeesRows) {
        attendees.addItem(new MailAddress(attendeesRow.EmailAddress, attendeesRow.DisplayName));
    }
    // Get message and calendar information
    Message messageRow = getMessageFromDB(messageId);

    // Create the Calendar object from the database information
    Appointment app = new Appointment(messageRow.AppLocation, messageRow.AppSummary, messageRow.AppDescription, messageRow.AppStartDate, messageRow.AppEndDate,
            new MailAddress(messageRow.From), attendees);

    // Create message and Set from and to addresses and Add the cancel meeting request
    MailMessage msg = new MailMessage();
    msg.setFrom(new MailAddress(messageRow.From));
    msg.setTo(attendees);
    msg.setSubject("Cencel meeting");
    msg.addAlternateView(app.cancelAppointment());
    SmtpClient smtp = new SmtpClient("smtp.gmail.com", 587, "user@gmail.com", "password");
    smtp.send(msg);
    System.out.println("cancellation request successfull");
}

Java: Перша програма з Aspose.Email Outlook

Mon, 01 Jan 0001 00:00:00 +0000

У цьому розділі демонструється, як використовувати Aspose.Email Mapi. Ми створюємо невелику програму, яка завантажує файл повідомлення Outlook (TestMessage.msg) і відображає тему, адреси відправника та одержувача, а також вміст листа. Дотримуйтесь цих кроків, щоб створити свою першу програму з використанням Aspose.Email Outlook.

Створіть екземпляр MapiMessage клас, задаючи шлях до файлу листа.
Використовуйте публічні властивості для відображення теми, відправника, одержувача та вмісту.

Реалізацію зазначених кроків продемонстровано нижче у наведеному фрагменті коду.

// Load the outlook message file
MapiMessage msg = MapiMessage.fromFile("outlookmessage.msg");

// Use the public properties
//read subject
System.out.print("Subject:" + msg.getSubject());

//sender name
System.out.print("From:" + msg.getSenderName());

//message body
System.out.print("Body:" + msg.getBody());

//Attachments
for(MapiAttachment att : msg.getAttachments())
{
    System.out.print("Attachment Name:"+att.getFileName());
    att.save(att.getFileName());
}

Java: Як ігнорувати виключення

Mon, 01 Jan 0001 00:00:00 +0000

Підтримка ігнору виключень

ExceptionManager клас забезпечує можливість ігнорування виключень:

Приклади коду:

Встановіть зворотний виклик для обробки виключень:

ExceptionManager.setIgnoreExceptionsHandler(new IgnoreExceptionsCallback() {
    //exception path: {Module}\{Method}\{Action}\{GUID}
    //example: MailMessage\Load\DecodeTnefAttachment\64149867-679e-4645-9af0-d46566cae598
    public boolean invoke(AsposeException ex, String path) {
        //Ignore all exceptions on MailMessage.Load
        return path.equals("MailMessage\\Load");
    }
});

Або використайте альтернативу:

//Ignore all exceptions
ExceptionManager.setIgnoreAll(true);

Також ви можете встановити зворотний виклик для журналу ігнорованих виключень:

ExceptionManager.setIgnoreExceptionsLogHandler(new IgnoreExceptionsLogCallback() {
    public void invoke(String message) {
        System.out.println("=== EXCEPTION IGNORED === " + message);
    }
});

Користувач буде повідомлений, що виключення можна ігнорувати, за допомогою повідомлення про помилку. Наприклад:

Exceptioin message:

AsposeArgumentException: properties should not be empty.
If you want to ignore an exception and want to proceed further then you can use:
ExceptionManager.getIgnoreList().add("MailMessage\\Load\\DecodeTnefAttachment\\64149867-679e-4645-9af0-d46566cae598")
Invalid TNEF Attachment will be interpreted as regular attachment.

Documentation – Технічні статті

Java: Різниця між вбудованими та звичайними вкладеннями

Java: Визначення та вилучення вбудованих вкладень з MSG, відформатованих як RTF

Java: Збереження MSG як PDF

Конвертувати лист у PDF

Java: Пул з'єднань реформований

Типи з’єднань

Типи розподілу з’єднань

Java: Підтримка встановлення Locale для поточного потоку

Java: Важливі деталі iCalendar RFC 2445

Про модель об’єктів Aspose iCalendar

Важливі деталі iCalendar RFC 2445

Формати дати та часу

DATE

DATE‑TIME з локальним часом

DATE‑TIME з часом UTC

DATE‑TIME з локальним часом та часовим поясом

BYWEEKNO забезпечує відповідність ISO 8601

Java: Парсинг файлів повідомлень Microsoft Outlook

Java: Отримання сповіщень про успішно надіслані та невдалі повідомлення

Java: Виявлення нових електронних листів на POP3 сервері

Виявлення нових повідомлень

Java: Встановлення кодування тексту за замовчуванням у листі

Встановлення кодування тексту за замовчуванням

Java: Перетворення файлу повідомлення Outlook (MSG) у зображення TIFF

Java: Використання документа Microsoft Word як тіла повідомлення та надсилання електронної пошти

Використання документів Microsoft Word як тіла електронного листа

Java: Функції друку Aspose.Email

Функції друку

Java: Генерувати випадки за шаблоном повторення

Обчислити наступну подію або n наступних подій

Отримати дружній для користувача текст для повторення

Java: Доступ до поштових сервісів за допомогою OAuth

Налаштування облікового запису на відповідному сервері

Доступ до поштових сервісів за допомогою токенів доступу

Доступ до поштових сервісів за допомогою постачальників токенів

Реалізація користувацького ITokenProvider для Office 365

Java: Використання OAuth для доступу до поштових сервісів

Налаштування облікового запису на відповідному сервері

Доступ до поштових сервісів за допомогою токенів доступу

Доступ до поштових сервісів за допомогою постачальників токенів

Реалізація користувацького ITokenProvider для Office 365

Дозволи для доступу до Office 365 через IMAP, POP3 або SMTP

Java: Видобування даних вбудованих об’єктів

Видобування вбудованих об’єктів

Java: Надсилання запиту на зустріч з повторенням

Генерація запиту на зустріч з повторенням

Надіслати запит оновлення зустрічі

Java: Підтримка багатопотоковості в поштових клієнтах

Методи використання поштових клієнтів у багатопотоковому середовищі

Приклади

Рекомендації

Java: Вступ та приклади застосувань

Сценарії використання Aspose.Email Mail

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

Інші інструменти маркетингу

Ділові додатки

Поштові клієнти

Зразковий додаток Aspose.Email Mail

Mail : Кроки створення зразкового додатку

Висновок

Aspose.Email Pop3

Pop3 : Основні можливості

Сценарії використання Aspose.Email Pop3

Автоматизація ділової електронної пошти

Поштові клієнти

Pop3 : Зразковий додаток

Aspose.Email Imap

Imap : Основні можливості

Використання Aspose.Email Imap

Imap : Приклад застосунку

Imap : Приклади коду

Aspose.Email Exchange

Exchange : Основні можливості

Використання Aspose.Email Exchange

Приклад застосунку Aspose.Email Exchange

Exchange : Кроки прикладу застосунку

Exchange : Приклади коду

Exchange : Вивід

Aspose.Email Mime