Documentation – Посібник розробника

Java: Відправка електронної пошти через MailGun та SendGrid у Java

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

Надсилання повідомлень за допомогою MailGun та SendGrid

Aspose.Email надає уніфікований API для надсилання електронних листів за допомогою сервісів MailGun або SendGrid. API дозволяє ініціалізувати клієнт, підготувати та надіслати лист.

По-перше, важливо налаштувати параметри залежно від того, який сервіс буде використаний для надсилання повідомлень. З DeliveryServiceOptions class, встановлює параметри DeliveryServiceClient. Наведений нижче зразок коду покаже, як налаштувати параметри для сервісів.

MailGun client параметри:

String domain = "YOUR_MAILGUN_DOMEN";
String privApiKey = "YOUR_MAILGUN_PRIVATE_API_KEY";
MailgunClientOptions opt = new MailgunClientOptions();
opt.setDomain(domain);
opt.setApiKey(privApiKey);

SendGrid client параметри:

String privApiKey = "YOUR_SENDGRID_PRIVATE_API_KEY";
SendGridClientOptions opt = new SendGridClientOptions();
opt.setApiKey(privApiKey);

Потім викличте потрібний екземпляр клієнта за допомогою builder.

IDeliveryServiceClient client = DeliveryServiceClientFactory.get(opt);

Нарешті, підготуйте та відправте електронний лист.

MailMessage eml = new MailMessage("fromAddress", "toAddress", "subject", "body");

DeliveryServiceResponse resp = client.send(eml);

if (!resp.isSuccessful()) {
    for (String error : resp.getErrorMessages()) {
        System.out.println(error);
    }
}

Java: Робота з MIME повідомленнями

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

Java: Робота з зустрічами

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

Завантажити та зберегти зустріч у форматі ICS

The Appointment Клас у Aspose.Email for Java можна використати для завантаження зустрічі у форматі ICS, а також для створення нової зустрічі та збереження її на диск у форматі ICS. У цій статті спочатку створюємо зустріч і зберігаємо її на диск у форматі ICS, а потім завантажуємо її.

Завантажити зустріч у форматі ICS

Щоб завантажити зустріч у форматі ICS, необхідно виконати наступні кроки:

Створіть екземпляр Appointment клас.
Викличте Load() метод, вказавши шлях до файлу ICS.
Прочитайте будь-яку властивість, щоб отримати будь-яку інформацію про зустріч (файл ICS).

Наведені нижче фрагменти коду показують, як завантажити зустріч у форматі ICS.

Створити зустріч і зберегти на диск у форматі ICS

Необхідно виконати наступні кроки для створення зустрічі та її збереження у форматі ICS.

Створіть екземпляр Appointment клас і ініціалізуйте його за допомогою цього конструктора.
Передайте наступні аргументи у вищезгаданий конструктор
1. Учасники
2. Опис
3. Дата закінчення
4. Місце
5. Організатор
6. Дата початку
7. Короткий опис
8. Дата створення
9. Дата останньої модифікації
Викличте Save() метод і вкажіть ім’я файлу та формат у аргументах.

Зустріч можна відкрити у Microsoft Outlook або будь‑якій програмі, що вміє завантажувати файли ICS. Якщо файл відкрито у Microsoft Outlook, він автоматично додає зустріч у календар Outlook.

Наступні фрагменти коду показують, як створити та зберегти зустріч на диск у форматі ICS.

Збереження зустрічей у форматі MSG

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

AppointmentMsgSaveOptions клас з додатковими параметрами для збереження зустрічей у форматі msg.
AppointmentIcsSaveOptions клас з додатковими параметрами для збереження зустрічі у форматі ics. Він був доданий для заміни застарілого IcsSaveOptions.

Нижче наведений приклад коду показує, як завантажити зустріч з файлу, а потім зберегти її у двох різних форматах: .ics та .msg.

Appointment appointment = Appointment.load("fileName");
appointment.save("fileName.ics", new AppointmentIcsSaveOptions());
appointment.save("fileName.msg", new AppointmentMsgSaveOptions());

Створити зустріч з HTML‑вмістом

Зазвичай використовується заголовок X-ALT-DESC у форматі iCalendar (RFC 5545). Це розширена властивість, яка надає альтернативний людсько‑читабельний опис календарного елементу або події. Цей заголовок часто використовується для включення простого тексту або HTML‑репрезентації опису події, що може бути корисно для сумісності зі старим календарним програмним забезпеченням або для надання спрощеної версії опису. У випадках, коли первинний опис не підтримується або не відображається коректно у календарному застосунку одержувача, заголовок X-ALT-DESC використовується для надання альтернативного опису події. Він дозволяє відправнику включати різні представлення опису події, щоб забезпечити кращу сумісність та доступність у різних календарних програмах і платформах. Щоб створити зустріч з HTML‑вмістом, встановіть HtmlDescription властивість у ’true’. Спробуйте наступний приклад коду, який демонструє, як створити та визначити об’єкт зустрічі зі специфічними деталями та налаштуваннями, включаючи дату, час, місце, організатора, учасників та форматований опис:

Date startDate = new Date();
Appointment appointment = new Appointment("Bygget 83",
        startDate, // start date
        addHours(startDate, 1), // end date
        new MailAddress("TintinStrom@from.com", "Tintin Strom"), // organizer
        MailAddressCollection.to_MailAddressCollection(
                new MailAddress("AinaMartensson@to.com", "Aina Martensson"))); // attendee
appointment.setHtmlDescription("<html>\n"
        + "     <style type=\"\"text/css\"\">\n"
        + "      .text {\n"
        + "             font-family:'Comic Sans MS';\n"
        + "             font-size:16px;\n"
        + "            }\n"
        + "     </style>\n"
        + "    <body>\n"
        + "     <p class=\"\"text\"\">Hi, I'm happy to invite you to our party.</p>\n"
        + "    </body>\n"
        + "    </html>");

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

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

Створення чернетки зустрічі з тексту

Додавання та видалення вкладень з календарних елементів

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

Створити та додати вкладення до Appointment об’єкт класу.
Отримати інформацію про вкладення зі зустрічі.
Витягти вкладення зі зустрічі.

Форматування зустрічей

Нижче наведені приклади коду демонструють, як використовувати AppointmentFormattingOptions клас для форматування тексту та HTML.

Приклад коду — форматування тексту

Приклад коду — HTML‑форматування

Читання кількох подій з файлу ICS

Запис кількох подій у файл ICS

Встановити статус учасників зустрічі

Aspose.Email для .NET API дозволяє встановлювати статус учасників зустрічі під час формування відповіді. Це додає властивість PARTSTAT до файлу ICS.

Налаштування ідентифікатора продукту для iCalendar

Aspose.Email for Java API дозволяє отримати або встановити ідентифікатор продукту, який створив об’єкт iCalendar.

Як обійти валідацію адреси під час завантаження зустрічей

Aspose.Email for Java API дозволяє обійти помилку валідації електронної пошти, встановивши IgnoreSmtpAddressCheck опція на AppointmentLoadOptions об’єкт і передачу його у виклик load.

AppointmentLoadOptions lo = new AppointmentLoadOptions();
lo.setIgnoreSmtpAddressCheck(true);
Appointment appointment = Appointment.load("app.ics", lo);

Java: Робота з елементами Outlook

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

Java: Робота з файлами сховища Outlook

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

Java: Робота з SMTP клієнтом

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

Java: Робота з POP3 клієнтом

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

Java: Робота з клієнтом IMAP

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

Java: Робота з клієнтом Exchange EWS

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

Java: Робота з Microsoft Graph Client

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

Java: Робота з Exchange WebDav Client

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

Java: Програмування з Gmail

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

Java: Програмування з Thunderbird

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

Читання повідомлень з MBOX

Mozilla Thunderbird — це відкритий, крос‑платформений клієнт електронної пошти, розроблений Mozilla Foundation. Він зберігає листи у власній файловій структурі, керуючи індексами повідомлень та підпапками за допомогою пропрієтарних форматів файлів. Aspose.Email може працювати зі структурами сховища пошти Thunderbird. The MboxrdStorageReader клас дозволяє розробникам читати повідомлення з файлу сховища пошти Mozilla Thunderbird. У цій статті показано, як читати повідомлення зі сховища електронної пошти Thunderbird:

Відкрийте файл сховища Thunderbird у FileStream.
Створіть екземпляр MboxrdStorageReader класу і передайте вищезгаданий потік у конструктор.
Викличте ReadNextMessage() щоб отримати перше повідомлення.
Використайте той самий ReadNextMessage() у циклі while, щоб прочитати всі повідомлення.
Закрийте всі потоки.

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

//Getting Marker information while reading messages from Mbox storage file
try (FileInputStream stream = new FileInputStream(dataDir + "Outlook.pst")) {
    MboxLoadOptions lo = new MboxLoadOptions();
    lo.setLeaveOpen(false);
    try (MboxrdStorageReader reader = new MboxrdStorageReader(stream, lo)) {
        MailMessage msg;
        String[] fromMarker = {null};
        while ((msg = reader.readNextMessage(/* out */fromMarker)) != null) {
            System.out.println(fromMarker[0]);
        }
    }
}

Налаштування параметрів завантаження під час читання повідомлень з MBOX

API Aspose.Email дозволяє наступні маніпуляції з повідомленнями під час їх читання з файлу MBOX:

Конвертація повідомлень з MBOX у PST зі збереженням вкладень TNEF

EmlLoadOptions emlLoadOptions = new EmlLoadOptions();
emlLoadOptions.setPreserveTnefAttachments(true);
MailStorageConverter.setMboxMessageOptions(emlLoadOptions);
// Convert messages from mbox to pst preserving tnef attachments.
PersonalStorage storage = MailStorageConverter.mboxToPst("Input.mbox", "Output.pst");

MailStorageConverter.MboxMessageOptions() властивість — отримує або задає параметри завантаження електронної пошти при аналізі сховища Mbox.

Читання повідомлень зі збереженням вкладень TNEF

MboxrdStorageReader reader = new MboxrdStorageReader("Input.mbox", new MboxLoadOptions());
// Read messages preserving tnef attachments.
EmlLoadOptions emlLoadOptions = new EmlLoadOptions();
emlLoadOptions.setPreserveTnefAttachments(true);
MailMessage eml = reader.readNextMessage(emlLoadOptions);

MboxrdStorageReader.readNextMessage(EmlLoadOptions options) метод — Параметр EmlLoadOptions визначає параметри при читанні повідомлення зі сховища Mbox.

Перерахування повідомлень зі збереженням вкладень TNEF

EmlLoadOptions emlLoadOptions = new EmlLoadOptions();
emlLoadOptions.setPreserveTnefAttachments(true);
// Enumerate messages preserving tnef attachments.
for (MailMessage message : reader.enumerateMessages(emlLoadOptions)) {
    // do something
}

MboxrdStorageReader.enumerateMessages(EmlLoadOptions options) метод — Визначає EmlLoadOptions під час читання повідомлення зі сховища Mbox.

Витяг повідомлень з MBOX за ідентифікаторами

Іноді потрібно витягати вибрані повідомлення за ідентифікаторами. Наприклад, ваш застосунок зберігає ідентифікатори у базі даних і витягує повідомлення за запитом. Це ефективний спосіб уникнути перебору всього сховища щоразу, щоб знайти конкретне повідомлення для витягання. Для реалізації цієї функції у файлах MBOX Aspose.Email надає наступні методи та класи:

MboxMessageInfo клас з EntryId властивість — Отримує ідентифікатор запису.
enumerateMessageInfo() метод MboxStorageReader клас — Надає енумератор, який підтримує ітерацію повідомлень у сховищі.
extractMessage(String id) метод MboxStorageReader клас — Отримує повідомлення з MBOX.

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

MboxStorageReader reader = MboxStorageReader.createReader("my.mbox", new MboxLoadOptions());

for (MboxMessageInfo msgInfo : reader.enumerateMessageInfo()) {
    MailMessage eml = reader.extractMessage(msgInfo.getEntryId(), new EmlLoadOptions());
}

Примітка: Ідентифікатор повідомлення унікальний у файлі сховища. Ідентифікатори створюються Aspose.Email і не можуть бути використані в інших сторонніх бібліотеках або програмах обробки MBOX.

Фільтрація та пошук листів у файлах MBOX

Aspose.Email for Java забезпечує можливість фільтрування або пошуку повідомлень у файлах MBOX за допомогою запиту. Це дозволяє отримувати лише повідомлення, що відповідають певним критеріям. Таким чином, ви можете покращити продуктивність та зручність застосунку при роботі з великими файлами MBOX.

Наведений нижче приклад коду демонструє, як реалізувати цю функцію за допомогою наступних методів:

enumerateMessages(MailQuery query) - повертає перелік екземплярів MailMessage, що відповідають вказаному запиту.
enumerateMessageInfo(MailQuery query) - повертає перелік екземплярів MboxMessageInfo, що відповідають вказаному запиту.

MboxStorageReader reader = MboxStorageReader.createReader("input.mbox", new MboxLoadOptions());
MailQueryBuilder mqb = new MailQueryBuilder();
mqb.getSubject().contains("Project Update");
mqb.getSentDate().before(new Date());

for (MailMessage message : reader.enumerateMessages(mqb.getQuery())) {
    System.out.println("Subject: " + message.getSubject());
}

Посторінкове отримання повідомлень з файлів MBOX

Aspose.Email for Java підтримує посторінкове отримання повідомлень з файлів MBOX. Ця функція забезпечує ефективну обробку великих файлів MBOX, отримуючи повідомлення невеликими партіями, зменшуючи споживання пам’яті та підвищуючи продуктивність.

Наведений нижче приклад коду демонструє, як реалізувати цю функцію за допомогою наступних методів:

enumerateMessages(int startIndex, int count) - отримує вказану кількість екземплярів MailMessage, починаючи з заданого індексу.
enumerateMessageInfo(int startIndex, int count) - отримує вказану кількість екземплярів MboxMessageInfo, починаючи з заданого індексу.

MboxStorageReader reader = MboxStorageReader.createReader("input.mbox", new MboxLoadOptions());
int startIndex = 0;
int count = 10; // Retrieve messages in batches of 10

for (MailMessage message : reader.enumerateMessages(startIndex, count)) {
    System.out.println("Subject: " + message.getSubject());
}

Запис повідомлень

The MboxrdStorageWriter клас забезпечує можливість запису нових повідомлень у файл сховища пошти Thunderbird. Щоб записати повідомлення:

Відкрийте файл сховища Thunderbird у FileStream.
Створіть екземпляр MboxrdStorageWriter класу і передайте вищезгаданий потік у конструктор.
Підготуйте нове повідомлення за допомогою MailMessage клас.
Викличте WriteMessage() метод і передайте вищезазначене MailMessage екземпляр для додавання повідомлення у сховище Thunderbird.
Закрийте всі потоки.

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

//Getting marker information while writing messages to Mbox storage file
try (FileOutputStream writeStream = new FileOutputStream(dataDir + "inbox")) {
    try (MboxrdStorageWriter writer = new MboxrdStorageWriter(writeStream, false)) {
        MailMessage msg = MailMessage.load(dataDir + "Message.msg");
        String[] fromMarker = {null};
        writer.writeMessage(msg, fromMarker);
        System.out.println(fromMarker[0]);
    }
}

Отримання загальної кількості повідомлень з файлу MBox

The MboxrdStorageReader клас забезпечує можливість читати кількість елементів, доступних у файлі MBox. Це можна використати для розробки застосунків, які показують прогрес дії під час обробки такого файлу.

MboxLoadOptions lo = new MboxLoadOptions();
try (MboxrdStorageReader reader = new MboxrdStorageReader("inbox.dat", lo)) {
    System.out.println("Total number of messages in Mbox file: " + reader.getTotalItemsCount());
}

Отримати поточний розмір повідомлення

FileInputStream stream = new FileInputStream(dataDir + "ExampleMbox.mbox");
MboxLoadOptions lo = new MboxLoadOptions();
try (MboxrdStorageReader reader = new MboxrdStorageReader(stream, lo)) {
    MailMessage msg = null;
    while ((msg = reader.readNextMessage()) != null) {
        //returns the number of bytes read
        long currentDataSize = reader.getCurrentDataSize();
        System.out.println("Bytes read: " + currentDataSize);
    }
}

Встановити перевагу кодування тексту під час завантаження файлів Mbox

The setPreferredTextEncoding(Charset value) метод MboxLoadOptions клас отримує або встановлює перевагу кодування для повідомлень. Створіть читача для файлу Mbox з вказаними параметрами завантаження, і ваші повідомлення з закодованим вмістом будуть правильно прочитані та оброблені. Наведений приклад коду показує, як реалізувати цю функцію в проєкті:

MboxLoadOptions lo = new MboxLoadOptions();
lo.setPreferredTextEncoding(Charset.forName("utf-8"));
MboxrdStorageReader reader = new MboxrdStorageReader("sample.mbox", lo);
MailMessage message = reader.readNextMessage();

Розділити сховище Mbox на менші частини

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

MboxStorageReader.SplitInto(long chunkSize, String outputPath) метод — Дозволяє розділяти сховище Mbox на менші частини, що спрощує управління та обробку великих файлів Mbox.

MboxStorageReader.SplitInto(long chunkSize, String outputPath, String partFileNamePrefix) Варіант попереднього методу, який також дозволяє зазначити власний префікс для імен розділених файлів Mbox.

MboxStorageReader.setEmlCopyingEventHandler Подія Ця подія відбувається перед копіюванням електронного листа у новий файл Mbox. Ви можете налаштовувати дії перед обробкою листів.

MboxStorageReader.setEmlCopiedEventHandler Подія Ця подія відбувається після копіювання електронного листа у новий файл Mbox. Ви можете виконувати постобробку листів.

MboxStorageReader.setMboxFileCreatedEventHandler Подія Ця подія відбувається, коли створюється новий файл Mbox. Ви можете обробити цю подію, щоб реагувати на створення файлу.

MboxStorageReader.setMboxFileFilledEventHandler Подія. Ця подія відбувається, коли новий файл Mbox заповнюється електронними листами. Ви можете реагувати на заповнення файлу листами.

NewStorageEventHandler(Object sender, NewStorageEventArgs e) представляє делегат для обробки подій, які виникають після створення або обробки нового файлу сховища.

MimeItemCopyEventHandler(Object sender, MimeItemCopyEventArgs e) представляє делегат для обробки подій, пов’язаних з копіюванням Mime‑елементів, зазвичай використовується у сценаріях, коли об’єкт MailMessage копіюється з одного сховища в інше.

NewStorageEventArgs представляє аргументи, що використовуються у подіях, які виникають після створення нового файлу сховища або після його обробки.

MimeItemCopyEventArgs представляє аргументи події, пов’язані з копіюванням об’єкта MailMessage з одного сховища в інше, як до початку копіювання, так і після його завершення.

Нижче наведений зразок коду демонструє, як взаємодіяти з файлами Mbox, обробляти події, пов’язані з цими файлами, та виконувати операції, такі як розділення сховища Mbox на менші частини з відстеженням кількості повідомлень та частин:

messageCount = 0;
partCount = 0;

// Create an instance of MboxrdStorageReader
MboxLoadOptions lo = new MboxLoadOptions();
lo.setLeaveOpen(false);
MboxrdStorageReader mbox = new MboxrdStorageReader("my.mbox", lo);

// Subscribe to events
mbox.setMboxFileCreatedEventHandler(new NewStorageEventHandler() {
    public void invoke(Object sender, NewStorageEventArgs e) {
        System.out.println("New Mbox file created: " + e.getFileName());
        partCount++;
    }
});

mbox.setMboxFileFilledEventHandler(new NewStorageEventHandler() {
    public void invoke(Object sender, NewStorageEventArgs e) {
        System.out.println("Mbox file filled with messages: " + e.getFileName());
    }
});

mbox.setEmlCopiedEventHandler(new MimeItemCopyEventHandler() {
    public void invoke(Object sender, MimeItemCopyEventArgs e) {
        System.out.println("Message added to new Mbox file. Subject: " + e.getItem().getSubject());
        messageCount++;
    }
});

// Split the Mbox storage into smaller parts
mbox.splitInto(10000000, testOutPath, "Prefix");

// Output the final messageCount and partCount
System.out.println("Total messages added: " + messageCount);
System.out.println("Total parts created: " + partCount);

Java: Робота з Zimbra

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

Про Zimbra

Zimbra — це набор для електронної пошти, календаря та співпраці, створений для хмари. Zimbra включає повний електронний лист, контакти, календар, спільний доступ до файлів, завдання та обмін повідомленнями/відеоконференціями, все це доступно через веб‑клієнт Zimbra з будь‑якого пристрою.

Читання всіх повідомлень з Zimbra TGZ сховища

Aspose.Email надає TgzReader class для читання файлів сховища Zimbra TGZ. Наведений нижче зразок коду демонструє використання TgzReader class для читання всіх повідомлень з файлу.

Збереження повідомлень та структури каталогів

Ви також можете зберегти всі повідомлення зі структурою каталогів з файлу сховища Zimbra TGZ. Для цього, TgzReader class надає метод ExportTo який приймає шлях виводу як параметр.

Нижче наведений фрагмент коду демонструє використання TgzReader.ExportTo method для збереження всіх повідомлень з файлу сховища Zimbra TGZ.

Експорт календаря та контактів з резервних файлів Zimbra

Aspose.Email дозволяє експортувати календар та контакти Zimbra у формати iCalendar та VCard. Нижче наведений зразок коду показує, як реалізувати цю функціональність у нашому проєкті:

try (TgzReader reader = new TgzReader("test2.tgz")) {
    //contacts files can be found in Contacts and Emailed Contacts subfolders
    //calendar files can be found in Calendar subfolder
    reader.exportTo("out");
}

Java: Робота з IBM Notes

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

Про IBM Notes

IBM Notes — це клієнт, а IBM Domino — сервер колаборативної клієнт‑серверної платформи. IBM Notes забезпечує функції співпраці, такі як електронна пошта, календарі, списки справ, управління контактами тощо. Файл бази даних, який використовується IBM Notes, зберігається у форматі Notes Storage Facility (NSF).

Читання повідомлень з файлу сховища NSF

Примітка, реалізація NSF досить обмежена. Загалом, можуть виникати проблеми у наступних випадках:

Файл був створений у Notes версії 7 і вище
Використовується стиснення LZ1

Aspose.Email надає NotesStorageFacility class для читання файлів сховища NSF. NotesStorageFacility class надає EnumerateMessages method, який ітерує повідомлення у файлі сховища NSF. Нижче наведений зразок коду демонструє використання NotesStorageFacility class та EnumerateMessages method для читання повідомлень з файлу сховища NSF.

Зверніть увагу, що реалізовано лише читання повідомлень. Читання папок ще не підтримується через відсутність специфікації.

Java: Програмування перевірки електронної пошти

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

Використання EmailValidator

EmailValidator надає повну підтримку валідації електронних адрес. За допомогою EmailValidator class, можуть виконуватись різні типи валідації, включаючи перевірку синтаксису електронної пошти, перевірку домену та перевірку користувацьких акаунтів на поштових серверах. ValidationPolicy перерахування використовується для встановлення рівня політики валідації:

SyntaxOnly перевіряє лише синтаксис електронної адреси.
SyntaxAndDomain перевіряє синтаксис електронної адреси, а потім домен.

Базова функціональність валідації

Використати EmailValidator для перевірки коректності електронних адрес.

Перевірка електронних адрес

Функція валідації Aspose.Email може бути використана для перевірки електронних адрес, доменних імен та поштових серверів. Наведений нижче фрагмент коду показує, як її використовувати EmailValidator для валідації електронної адреси.

EmailValidator ev = new EmailValidator();
ValidationResult[] result = new ValidationResult[] { null };
ev.validate("user@domain.com", result);
if (result[0].getReturnCode() == ValidationResponseCode.ValidationSuccess)
{
    System.out.println("the email address is valid.");
}
else
{
    System.out.println("the mail address is invalid,for the " + result[0].getMessage());
}

Перевірка електронних повідомлень

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

MIME Формати: eml, emlx, mht
MAPI Формати: msg, oft

Aspose.Email надає наступні інструменти для виконання завдання:

MessageValidator.validate method - валідовує повідомлення за допомогою цього методу, передаючи шлях до файлу або потік як вхід.
MessageValidationResult class - інкапсулює результати процесу валідації повідомлення. Надає інформацію про успішність валідації, тип формату та будь‑які виявлені помилки.
MessageValidationErrorType Enum - Перераховує різні типи помилок валідації.

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

MessageValidationResult result = MessageValidator.validate(fileName);

// Check if validation is successful
if (!result.isSuccess()) {
    System.out.println("Validation failed.");

    // Check the format type
    if (result.getFormatType() == FileFormatType.Mht) {
        System.out.println("Format type is Mht.");
    }

    // Check and display errors
    System.out.println("Number of errors: " + result.getErrors().size());

    for (MessageValidationError error : result.getErrors()) {
        System.out.println("Error Type: " + error.getErrorType());
        System.out.println("Description: " + error.getDescription());
    }
} else {
    System.out.println("Validation successful.");
}

Java: Робота з AMP HTML листами

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

Про AMP

AMP (Accelerated Mobile Pages) — це відкритий фреймворк Google, створений на основі HTML, CSS та JavaScript. Він дозволяє створювати легкі листи з швидшим завантаженням. AMP надає багато компонентів, таких як каруселі, форми, зображення тощо. Окрім швидкості, AMP листи повністю інтерактивні всередині клієнта електронної пошти, і користувачі можуть взаємодіяти з листом безпосередньо, наприклад, заповнювати форму або відповідати на опитування, не виходячи з поштового клієнта.

Робота з AMP HTML листами

Aspose.Email надає AmpMessage який представляє AMP лист. Aspose.Email надає багато класів для додавання компонентів до AMP листів, таких як AmpImage, AmpCarousel, AmpAccordion, AmpForm, тощо. Наведений нижче фрагмент коду демонструє створення, збереження та оновлення AMP листів за допомогою API Aspose.Email.

Java: Інформація про протокол

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

Java: Технічні статті

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

Java: Міграція з Office Automation до Aspose

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

Java: Міграція з попередніх версій Aspose.Email

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

Java: Сумісність з JDK 11

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

API Aspose.Email EWSClient повністю сумісний і може використовуватись з JDK 11. Для роботи з JDK 11 необхідно додати залежності JAXB. Весь інший API Aspose.Email працюватиме нормально без додаткових залежностей.

API JAXB вважаються частиною Java EE, тому їх більше немає у стандартному класшепі Java SE 9. У Java 11 вони повністю видалені з JDK.

Наступні залежності Maven JAXB слід додати до проєкту:


 <dependency>

    <groupId>javax.xml.bind</groupId>

    <artifactId>jaxb-api</artifactId>

    <version>2.3.1</version>

</dependency>

<dependency>

    <groupId>com.sun.xml.bind</groupId>

    <artifactId>jaxb-impl</artifactId>

    <version>2.3.1</version>

</dependency>

<dependency>

    <groupId>com.sun.xml.bind</groupId>

    <artifactId>jaxb-core</artifactId>

    <version>2.3.0.1</version>

</dependency>

<dependency>

    <groupId>com.sun.xml.messaging.saaj</groupId>

    <artifactId>saaj-impl</artifactId>

    <version>1.5.0</version>

</dependency>

Java: FAQ

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

Question

Привіт! щодо наступного коду:


ContentType ct = new ContentType();

ct.setMediaType("application/msword");

ct.setCharSet("ISO-2022-JP");

Attachment att = new Attachment("Test.doc", ct);

System.out.println(att.getContentType().getName());

att.getContentType().getName() повертає назву прикріпленого документа. Чи це очікувана поведінка?

Answer: Так, це очікувана поведінка. Якщо getContentType().getName() не встановлено явно, в якості імені буде використано назву файлу.

Question: Як витягти дані з вкладення "oleData.mso", яке я отримую під час читання MapiMessage з вбудованим OLE‑об’єктом?

Answer: Файли типу "oleData.mso" належать до формату Microsoft Compound Document (MCDF) і, на жаль, підтримка таких файлів виходить за межі можливостей Aspose.Email. Проте існують відкриті .NET бібліотеки, наприклад OpenMCDF, які можна використовувати для читання вмісту таких файлів та збереження їх на диск.

Question: Чи можна записувати у той самий файл PST у паралельних потоках, використовуючи ті ж об’єкти?

Answer: Ні, безпечність потоків у цьому випадку не гарантована. Запис повідомлень має виконуватись в одному потоці. Однак продукт має коректно працювати з різними об’єктами з різних потоків.

Documentation – Посібник розробника

Java: Відправка електронної пошти через MailGun та SendGrid у Java

Надсилання повідомлень за допомогою MailGun та SendGrid

Java: Робота з MIME повідомленнями

Java: Робота з зустрічами

Завантажити та зберегти зустріч у форматі ICS

Завантажити зустріч у форматі ICS

Створити зустріч і зберегти на диск у форматі ICS

Збереження зустрічей у форматі MSG

Створити зустріч з HTML‑вмістом

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

Створення чернетки зустрічі з тексту

Додавання та видалення вкладень з календарних елементів

Форматування зустрічей

Приклад коду — форматування тексту

Приклад коду — HTML‑форматування

Читання кількох подій з файлу ICS

Запис кількох подій у файл ICS

Встановити статус учасників зустрічі

Налаштування ідентифікатора продукту для iCalendar

Як обійти валідацію адреси під час завантаження зустрічей

Java: Робота з елементами Outlook

Java: Робота з файлами сховища Outlook

Java: Робота з SMTP клієнтом

Java: Робота з POP3 клієнтом

Java: Робота з клієнтом IMAP

Java: Робота з клієнтом Exchange EWS

Java: Робота з Microsoft Graph Client

Java: Робота з Exchange WebDav Client

Java: Програмування з Gmail

Java: Програмування з Thunderbird

Читання повідомлень з MBOX

Налаштування параметрів завантаження під час читання повідомлень з MBOX

Витяг повідомлень з MBOX за ідентифікаторами

Фільтрація та пошук листів у файлах MBOX

Посторінкове отримання повідомлень з файлів MBOX

Запис повідомлень

Отримання загальної кількості повідомлень з файлу MBox

Отримати поточний розмір повідомлення

Встановити перевагу кодування тексту під час завантаження файлів Mbox

Розділити сховище Mbox на менші частини

Java: Робота з Zimbra

Про Zimbra

Читання всіх повідомлень з Zimbra TGZ сховища

Збереження повідомлень та структури каталогів

Експорт календаря та контактів з резервних файлів Zimbra

Java: Робота з IBM Notes

Про IBM Notes

Читання повідомлень з файлу сховища NSF

Java: Програмування перевірки електронної пошти

Використання EmailValidator

Базова функціональність валідації

Перевірка електронних адрес

Перевірка електронних повідомлень

Java: Робота з AMP HTML листами

Про AMP

Робота з AMP HTML листами

Java: Інформація про протокол

Java: Технічні статті

Java: Міграція з Office Automation до Aspose

Java: Міграція з попередніх версій Aspose.Email

Java: Сумісність з JDK 11

Java: FAQ

Завантажити та зберегти зустріч у форматі ICS

Завантажити зустріч у форматі ICS

Створити зустріч і зберегти на диск у форматі ICS

Збереження зустрічей у форматі MSG

Читання кількох подій з файлу ICS

Запис кількох подій у файл ICS