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.

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 Personal Storage Files, които съхраняват имейли, календарни елементи, бележки, контакти и няколко други файлови формати. Използва се за архивиране на имейлни данни офлайн.| | | |OST|Той представлява данните на пощенската кутия на потребителя в офлайн режим на локалната машина след регистрация в Exchange Server с Microsoft Outlook.| | | |OFT|Файлове шаблон за съобщения, създадени с Microsoft Outlook.| | | |OLM|Този формат се използва от Microsoft Outlook за Mac за съхранение на имейл съобщения, контакти, дневници, календарни данни и други потребителски данни.| | | |EML|Той представлява имейл съобщения, запазени с Outlook и други съответни приложения.| | | |EMLX|Apple Mail експортира имейли в този формат.| | | |MBOX|Той представлява контейнер за колекция от електронни съобщения.| | | |ICS|Форматът iCalendar се използва за обмен и разпространение на календарни събития и планиране.| | | |VCF|Virtual Card Format е дигитален файлов формат за съхранение на контактна информация.| | | |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 runtime, включително, но не само:

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" в полето Subject при запазване във формати CFB, EML или MSG
Крайната дата не може да бъде след 31-12-2004 в метода GenerateOccurrences на шаблона за повторение. Това позволява смисленно тестване на продукта, но е невъзможно за използване в продуктивно приложение. Например, можете да създадете шаблон като "започвай от 1 януари 2000 и се повтаря всеки последен работен ден от месеца" и да генерирате повторения за него. Повторения след 31 декември 2004 няма да се генерират в режим на оценка.
Добавя "Evaluation Watermark Image" при запазване във формати XPS или TIFF.
Максималният брой двусмислени имейл адреси и имена за показване, разрешени от MS Exchange Server, е 20
Максималната дължина на данните, разрешена за drag-and-drop с FileDropPanel, е 51200 байта
Показва съобщителен прозорец с "Evaluation Message" по време на операцията drag-and-drop, използвана от FileDropPanel
Само 1 файл се извлича от дадения MSO поток с метода InlineAttachmentExtractor.EnumerateMsoPackage

Задаване на лиценз

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

Трябва да приложите лиценз, ако искате да избегнете ограниченията на оценъчната версия. Необходимо е да зададете лиценз само веднъж за приложение или процес.

Лицензът може да бъде зареден от поток или файл на следните места:

Изричен път.
Папката, която съдържа Aspose.Email.jar.

Използвайте метода License.setLicense, за да лицензирайте компонента. Често най-лесният начин за задаване на лиценз е да поставите лицензионния файл в същата папка като Aspose.Email.jar и да укажете само името на файла без път, както е показано в следния пример:

Задаване на лиценз от файл

В този пример Aspose.Email ще се опита да намери лицензионния файл в папката, която съдържа JAR файловете на вашето приложение.

Задаване на лиценз от поток

Инициализира лиценз от поток.

Прилагане на лиценз с измерване

Aspose.Email позволява на разработчиците да прилагат измервателен ключ. Това е нов механизъм за лицензиране. Новият механизъм ще се използва заедно с съществуващия метод за лицензиране. Клиентите, които искат да бъдат таксувани според използването на функциите на API, могат да ползват измервателното лицензиране. За повече подробности, моля, вижте ЧЗВ за измервателно лицензиране раздел.

Въведен е нов клас Metered за прилагане на измервателен ключ. По-долу е примерен код, демонстриращ как да се зададат публичен и частен измервателен ключ.

Включване на лицензния файл като вграден

Валидация на лиценза

Възможно е да се провери дали лицензът е зададен правилно или не. 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

Download from GitHub

Всички примери на Aspose.Email за 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.

Оценъчни марки, вградени в запазеното съобщение