Documentation – Початок роботи

Java: Огляд продукту

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

Ласкаво просимо до Aspose.Email для Java!

Aspose.Email для Java — це Java‑API, який дозволяє Java‑застосункам читати та записувати документи Microsoft Outlook® без використання Microsoft Outlook®. Aspose.Email для Java пропонує ряд ключових можливостей, таких як управління одержувачами, темою, вмістом, вкладеннями у документах Microsoft Outlook® MSG та читання контактів, повідомлень і інформації про папки з документів Microsoft Outlook® PST. Він також може використовуватись для створення, зміни та конвертації електронних листів у форматах EML, MSG і MHT.

Опис продукту

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

Aspose.Email для Java не може створювати файли MSG (формат Outlook Message), але дозволяє зберігати файли MSG після внесення змін у оригінальний вміст. Ви також можете розпарсити вкладення та зберегти їх на диск.

Читання файлів Outlook PST також підтримується. Отримуйте папки, підпапки, кількість повідомлень, інформацію про повідомлення (тема, відправник, одержувачі тощо) та контакти з файлів PST. Витягайте повідомлення з файлу PST та зберігайте їх на диск у форматі MSG.

Aspose.Email для Java використовується розробниками для виконання різноманітних завдань у їхніх додатках. Наприклад, відкриття або збереження листів у вигляді файлів EML або MHT, парсинг або читання та збереження повідомлень Microsoft Outlook і файлів Outlook PST, робота з MIME-повідомленнями, вбудовування об’єктів у листи.

Функції

Функції форматів файлів електронних листів

Підтримує електронні повідомлення у форматах EML, MSG та MHTML.
Створити нове повідомлення.
Змінити існуюче повідомлення та оновити вміст, такий як тема, відправник, одержувачі, тіло, вкладення тощо.
Завантажити існуюче повідомлення та отримати його вміст, такий як тема, вкладення, відправник, одержувачі тощо.
Керувати (додавати/вилучати) вкладення в електронному листі.
Створити електронний лист у форматі HTML.
Створити повідомлення в режимі чернетки (лише MSG).
Читати вкладення вкладених електронних листів.
Конвертувати повідомлення з/у будь-які підтримувані формати.

Функції файлів MSG

Створити нові документи MSG з нуля.
Відкрити існуючі документи MSG.
Доступ до вмісту MSG.
Змінити існуючі документи MSG.
Отримати кілька одержувачів.
Доступ до властивостей MAPI, пов’язаних з документами MSG.
Розпарсити вкладення з документа MSG.
Зберегти вкладення на диск.

Функції файлів PST/OST

Завантажити файл Outlook PST з диска та отримати інформацію про всі його папки (підтримуються лише формати Unicode).
Отримати інформацію про повідомлення з будь-якої папки у файлі PST, наприклад, тему, відправника, вкладення тощо.
Витягувати повідомлення з файлу PST та зберігати їх на диск у форматі MSG.
Читати інформацію про контакти з файлу PST та зберігати її на диск у форматі MSG.
Підтримка читання/маніпулювання форматами файлів OST (створення форматів OST наразі не підтримується)

Java: Підтримувані формати файлів

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

|Формат|Опис|Завантаження|Збереження| | :- | :- | :- | :- | |MSG|Цей формат використовується Microsoft Outlook та Exchange для зберігання електронних листів, контактів, зустрічей чи інших завдань.| | | |PST|це представляє файли особистого сховища Outlook, які зберігають листи, елементи календаря, нотатки, контакти та кілька інших форматів файлів. Використовується для архівування даних пошти офлайн.| | | |OST|Він представляє дані поштової скриньки користувача в офлайн режимі на локальному комп’ютері після реєстрації на Exchange Server за допомогою Microsoft Outlook.| | | |OFT|Файли шаблонів повідомлень, створені за допомогою Microsoft Outlook.| | | |OLM|Цей формат використовується Microsoft Outlook for Mac для зберігання електронних листів, контактів, журналів, даних календаря та інших даних користувацьких застосунків.| | | |EML|Він представляє електронні листи, збережені за допомогою Outlook та інших відповідних застосунків.| | | |EMLX|Apple Mail експортує листи у цьому форматі.| | | |MBOX|Він представляє контейнер для колекції електронних листів.| | | |ICS|Формат iCalendar використовується для обміну та розгортання календарних подій і планування.| | | |VCF|Формат віртуальної картки — це цифровий файл для зберігання контактної інформації.| | | |HTML|HTML (HyperText Markup Language) — це розширення для веб-сторінок, створених для відображення в браузерах.| | | |MHTML|Формат архіву веб-сторінки, який зберігає HTML код і пов’язані ресурси в одному файлі.| | |

Java: Функції

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

Java: Системні вимоги

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

Aspose.Email для Java не вимагає встановлення Microsoft Outlook, оскільки Aspose.Email сам по собі є бібліотекою створення, конвертації та маніпулювання документами Microsoft Outlook.

Підтримувані операційні системи

Aspose.Email для Java підтримує будь‑яку операційну систему, що працює з середовищем виконання Java, включаючи, але не обмежуючись:

Windows

Microsoft Windows 2003 Server
Microsoft Windows 2008 Server
Microsoft Windows 2012 Server
Microsoft Windows XP
Microsoft Windows Vista
Microsoft Windows 7
Microsoft Windows 8, 8.1
Microsoft Windows 10

Linux

Linux (Ubuntu, openSUSE, CentOS та інші)

Mac

Mac OS X тощо.

Підтримувані версії Java

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

J2SE 6.0 (1.6)
J2SE 7.0 (1.7)
J2SE 8.0 (1.8)
або вище

Java: Встановлення

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

Встановлення Aspose.Email для Java з Maven репозиторію

Aspose розміщує всі Java API на Aspose Artifactory. Ви можете легко використовувати Aspose.Email для Java API безпосередньо у ваших Maven проектах з простими налаштуваннями.

Вказати конфігурацію Maven репозиторію

Спочатку вам потрібно вказати конфігурацію/розташування репозиторію Aspose Maven у вашому Maven pom.xml наступним чином:


 <repositories>

    <repository>

        <id>AsposeJavaAPI</id>

        <name>Aspose Java API</name>

        <url>https://releases.aspose.com/java/repo/</url>

    </repository>

</repositories>

Визначити залежність Aspose.Email для Java API

Потім визначте залежність Aspose.Email для Java API у вашому pom.xml наступним чином:


 <dependencies>

    <dependency>

        <groupId>com.aspose</groupId>

        <artifactId>aspose-email</artifactId>

        <version>19.12</version>

        <classifier>jdk16</classifier>

 </dependency>

</dependencies>

Після виконання наведених вище кроків залежність Aspose.Email для Java буде остаточно визначена у вашому Maven-проекті.

Java: Ліцензування

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

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

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

Кожна ліцензія Aspose включає однорічну підписку на безкоштовні оновлення до будь‑яких нових версій або виправлень, що виходять протягом цього часу. Технічна підтримка безкоштовна, необмежена та надається як ліцензованим, так і користувачам оцінкових версій.

Якщо ви хочете протестувати Aspose.Email без обмежень оцінкової версії, запросіть 30‑денну тимчасову ліцензію. Будь ласка, зверніться до Як отримати тимчасову ліцензію? для отримання додаткової інформації.

Обмеження оцінкової версії

Оцінкова версія Aspose.Email (без вказаної ліцензії) надає повний функціонал продукту, за винятком деяких її компонентів, таких як Aspose.Email.Mail, Aspose.Email.Pop3 та Aspose.Email.Imap, що містять певні оцінкові обмеження.

Файл License.txt додається до файлу повідомлення, що зберігається за допомогою Aspose.Email
Лише 50 електронних листів можна витягнути з папки у файлі PST
Лише 3 вкладення та вбудовані зображення можна витягнути з файлу MSG
Максимальна кількість оброблених вкладень у форматі CFB — 1
Максимальна кількість оброблених одержувачів у форматі CFB — 1
Додає "Evaluation Message" у рядок Тема під час збереження у форматах CFB, EML або MSG
Дата завершення не може бути пізнішою за 31‑12‑2004 у методі GenerateOccurrences шаблону повторень. Це дозволяє тестувати продукт у значущий спосіб, проте неможливо використати у виробничому застосунку. Наприклад, ви можете створити шаблон "почати 1 січня 2000 року і повторюватися кожного останнього робочого дня місяця" і згенерувати його випадки. Випадки після 31 грудня 2004 року не будуть згенеровані в оцінковому режимі.
Додає "Evaluation Watermark Image" під час збереження у форматах XPS або TIFF.
Максимальна кількість неоднозначних електронних адрес та імен, розв’язаних MS Exchange Server, становить 20
Максимальна довжина файлу даних, дозволеного для перетягування у FileDropPanel, становить 51200 байт
Показує діалогове вікно з повідомленням "Evaluation Message" під час операції перетягування, використаної FileDropPanel
Лише 1 файл витягується з заданого MSO‑потоку методом InlineAttachmentExtractor.EnumerateMsoPackage

Налаштування ліцензії

Ліцензія — це простий текстовий XML‑файл, який містить такі дані, як назва продукту, кількість розробників, яким вона надана, дата закінчення підписки тощо. Файл підписаний цифровим підписом, тому не змінюйте його; навіть випадкове додавання зайвого переносу рядка зробить його недійсним.

Ви повинні застосувати ліцензію, якщо хочете уникнути обмежень оцінкової версії. Ліцензію потрібно встановити лише один раз на застосунок чи процес.

Ліцензію можна завантажити з потоку або файлу в наступних розташуваннях:

Явний шлях.
Папка, що містить Aspose.Email.jar.

Використовуйте метод License.setLicense для ліцензування компонента. Найпростіший спосіб встановити ліцензію — розмістити файл ліцензії у тій самій папці, що й Aspose.Email.jar, і вказати лише назву файлу без шляху, як показано у наступному прикладі:

Встановлення ліцензії з файлу

У цьому прикладі Aspose.Email спробує знайти файл ліцензії у папці, що містить JAR‑и вашого застосунку.

Встановлення ліцензії з потоку

Ініціалізує ліцензію з потоку.

Застосувати лічену ліцензію

Aspose.Email дозволяє розробникам застосовувати метered‑ключ. Це новий механізм ліцензування. Новий механізм буде використовуватись разом із існуючим методом ліцензування. Клієнти, які хочуть оплачувати використання функцій API, можуть користуватись метered‑ліцензуванням. Для більш детальної інформації, будь ласка, зверніться до FAQ щодо метered‑ліцензування розділ.

Був представлений новий клас Metered для застосування метered‑ключа. Нижче наведено зразковий код, що демонструє, як встановити публічний та приватний метered‑ключі.

Включення файлу ліцензії як вбудованого

Перевірити ліцензію

Можна перевірити, чи ліцензія встановлена правильно чи ні. The Ліцензія Клас має поле isLicensed, яке поверне true, якщо ліцензію встановлено правильно.

Java


 License license = new License();

license.setLicense("Aspose.Email.Java.lic");

if (License.isLicensed()) {

    System.out.println("License is Set!");

}

Java: Як запустити приклади

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

Завантажити з GitHub

Усі приклади Aspose.Email for Java розміщені на Github. Ви можете клонувати репозиторій за допомогою вашого улюбленого клієнта Github або завантажити ZIP‑файл з тут.

Розпакуйте вміст ZIP‑файлу в будь‑яку папку на вашому комп’ютері. Усі приклади розташовані у папці Examples.

Проект використовує систему збірки Maven. Будь-яка сучасна IDE може легко відкрити або імпортнути проект і його залежності. Нижче ми показуємо, як використовувати популярні IDE для збірки та запуску прикладів.

IntelliJ IDEA

Клацніть меню File і виберіть Open. Перейдіть до папки проекту та виберіть файл pom.xml.

Він відкриє проект і автоматично завантажить залежності. На вкладці Project перегляньте приклади у папці src/main/java. Щоб запустити приклад, просто клацніть правою кнопкою миші на файлі і виберіть "Run ..", приклад буде виконано, а вивід буде показаний у вбудованому вікні консолі.

Eclipse

Клацніть меню File і виберіть Import. Виберіть Maven — Existing Maven Projects.

Перейдіть у папку, яку ви клонували або завантажили з GitHub, і виберіть файл pom.xml.

Він відкриє проєкт і автоматично завантажить залежності. На вкладці Package Explorer перегляньте приклади у папці src/main/java. Щоб запустити приклад, клацніть правою кнопкою миші на файлі і виберіть Run As — Java Application, приклад буде виконаний, а вивід буде показаний у вбудованому вікні консолі.

NetBeans

Клацніть меню File і виберіть Open Project. Перейдіть у папку, яку ви клонували або завантажили з GitHub. Піктограма папки Examples покаже, що це Maven проєкт. Виберіть Examples і відкрийте його.

Він відкриє проєкт і завантажить залежності автоматично. На вкладці Projects перегляньте приклади у source packages. Щоб запустити приклад, просто клацніть правою кнопкою миші на файлі і виберіть Run File, приклад буде виконаний, а вивід буде показаний у вбудованому вікні консолі.

Внести внесок

Якщо ви хочете додати або покращити приклад, ми закликаємо вас внести свій внесок у проєкт. Всі приклади та демонстраційні проєкти у цьому репозиторії є відкритим вихідним кодом і можуть вільно використовуватись у ваших власних додатках.

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

Java: Технічна підтримка

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

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

Якщо вам потрібна допомога, відвідайте Aspose.Forums. Розмістіть ваше питання у форумі Aspose.Email для Java, і на нього відповісти протягом кількох годин.

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

Повідомлення про проблему

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

Переконайтеся, що ви використовуєте останню версію продукту перед повідомленням про проблему. Дивіться Сторінка завантаження Aspose.Email для Java щоб дізнатися про останню версію.
Ознайомтеся з форуми, ця Wiki документація та Посилання на API перед подачею проблеми. На ваше питання вже може бути відповідь.
При повідомленні про проблему, будь ласка, включіть оригінальний документ і, можливо, фрагмент вашого коду, який викликає проблему. Якщо потрібно прикріпити декілька файлів, заархівуйте їх в один. Безпечно прикріплювати документи у форумах, оскільки доступ до файлів мають лише ви та розробники Aspose.
Будь ласка, намагайтеся повідомляти про одну проблему в одному темі. Якщо у вас є інша проблема, повідомте про неї в окремій темі.

Aspose не надає технічну підтримку по телефону. Телефонна підтримка доступна лише для питань щодо продажу та покупки.

Java: Ресурси

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

У цій таблиці перелічено важливі технічні ресурси Aspose.Email для Java.

Java: Оцінити Aspose.Email

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

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

Якщо ви хочете протестувати Aspose.Email без обмежень версії оцінки, запросіть 30-денну тимчасову ліцензію. Будь ласка, зверніться до Як отримати тимчасову ліцензію?

Обмеження оцінкової версії

Оцінювальна версія Aspose.Email (без вказаної ліцензії) надає повну функціональність продукту, за винятком того, що кілька компонентів — Aspose.Email.Mail, Aspose.Email.Pop3, Aspose.Email.Ftp та Aspose.Email.Imap — містять обмеження оцінки:

Файл License.txt додається до повідомлень, збережених за допомогою Aspose.Email.
Лише 50 листів можна витягти з папки у файлі PST.
Лише 3 вкладення та вбудовані зображення можна витягти з файлу MSG.
Максимальна кількість оброблених вкладень у форматі CFB — 1.
Максимальна кількість оброблених одержувачів у форматі CFB — 1.
Додає "Evaluation Message" до теми при збереженні у форматах CFB, EML чи MSG.
Дата закінчення не може бути пізнішою за 31-12-2004 у методі GenerateOccurrences патерну повторення. Це дозволяє вам змістовно тестувати продукт, проте робить його непридатним для використання у виробничих додатках. Наприклад, ви можете створити патерн типу "почати 1 січня 2000 року і повторювати кожен останній робочий день місяця" і генерувати події для нього. Події після 31 грудня 2004 не будуть згенеровані у режимі оцінки.
Лише 1 файл витягується з даного MSO потоку методом InlineAttachmentExtractor.EnumerateMsoPackage

Оцінювальні позначки, вбудовані у збережене повідомлення