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, за да се определи характерът на прикачения файл. Въпреки това, при липса на MAPI тага PR_ATTACH_FLAGS, прикаченият файл се проверява за свойството 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

Изходното имейл съобщение може да се види по следния начин:

|| | :- | |Figure: Source MSG File |

|| | :- | |Figure: Converted PDF File | 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 клас. Този 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.

Този 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 с UTC време

Датата с UTC време, или абсолютното време, се идентифицира със суфикс от главна латинска буква Z, обозначаващ UTC, добавен към стойността на времето. Например, следното представлява 19 януари 1998 г. в 07:00 UTC: DTSTART:19980119T070000Z. Моля, обърнете внимание, че Aspose iCalendar игнорира суфикса Z, указващ UTC формат, и третира времето като местно време. Стандартът RFC2445 посочва, че времевата част, зададена в правилото UNTIL на модел за повтаряне, трябва да бъде в UTC формат. Това е много странно твърдение и всъщност има примери в стандарта, които са изчислени неправилно. Aspose iCalendar приема време във всякакъв формат в правилото UNTIL.

DATE-TIME с местно време и часова зона

За да се посочи часовата зона, DATE-TIME се модифицира със свойството TZID. Например, следното представлява 2 ч. сутринта в Ню Йорк на 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

Когато искате да получите известие за доставка както за успешно изпратени, така и за неуспешни съобщения, можете да използвате оператор pipe (|) за 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 свойство и обяснява как се използва. С това свойство можете да зададете кодиране по подразбиране за следните свойства:

От: Показвано име
До: Показвано име
Subject
Тяло

Задаване на кодиране по подразбиране за текст

В предишни версии на Aspose.Email, кодировката на текста за свойства от, до, тема и тяло се задаваше отделно. За подобряване на удобството, добавихме 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 за Java.

Java: Използване на Microsoft Word документ като тяло на съобщение и изпращане на имейл

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

Тази статия показва как да използвате документ на Microsoft Word като тяло на имейл и да го изпратите до получателите. Примерният документ е фактура за продажба от пробната база данни Northwind, експортирана в формат Microsoft Word. Aspose.Email за 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 за 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. По принцип всички сървъри, поддържащи токени тип OAuth 2.0, могат да се използват с Aspose.Email, но нашите имейл клиенти са тествани с пощенските сървъри на Google и Microsoft Office 365. Достъпът до сървъра от SmtpClient, Pop3Client, ImapClient и EWSClient с OAuth може да се реализира по 2 начина.

Предоставете токен за достъп директно в конструктора на имейл клиента. В този случай потребителят трябва да разбира, че срокът на валидност на токените за достъп е ограничен. Когато токенът изтече, имейл клиентът не може да се използва за достъп до сървъра.
Предоставете персонализирана имплементация на доставчик на токени, базирана на ITokenProvider интерфейс в конструктора на имейл клиента. В този случай клиентът проверява времето на изтичане на токена и изпраща заявка за ITokenProvider за нов токен за достъп, когато предишният изтече. По този начин клиентът обновява токените периодично и може да работи със сървъра неограничено време. Често услугите поддържат прост начин за обновяване на токените за достъп. Например, използването на токени за обновяване в услугите на Google или ROPC поток за удостоверяване в Microsoft идентификационната платформа може да се използва за реализиране на доставчик на токени.

Конфигурирайте акаунт на съответния сървър

Следващите статии ви помагат да конфигурирате акаунти за достъп до имейл услуги.

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

Конфигурирайте акаунт на съответния сървър

Следващите статии ви помагат да конфигурирате акаунти за достъп до имейл услуги.

За 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();
    }
}

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 може да се използва в комбинация с други с отворен код библиотеки, като 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();
        }
    }
});

Препоръки

Струва си да се отбележи, че ако потребителят изпраща всички команди към главната връзка, може да възникне ситуация, при която команди от различни нишки се смесват. Потребителят трябва да разбира кои команди са зависими от реда им и да предприеме мерки за синхронизация на такива команди. Също така е необходимо да се вземе предвид възможността за изпълнение на команди в различни сесии (IMAP/POP3). Най-времеемките операции, като FetchMessage, AppendMessage и Send, вероятно имат смисъл да се изпълняват в нова нишка и нова връзка. Но бързите операции, като Delete, имат смисъл да се изпълняват с главната връзка. Моля, имайте предвид, че инициализирането на нова връзка е достатъчно времеемка операция.

Java: Въведение и примерни приложения

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

Сценарии за употреба на Aspose.Email Mail

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

Софтуер за бюлетини

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

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

Подобно на приложения за бюлетини, много други типове софтуер могат да се създадат с помощта на Aspose.Email Mail. Използвайте го за изграждане на имейл маркетинг, масови пощи и 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 реализира протокола Post Office Protocol v3 (POP3) за Java. Позволява на Java разработчиците да добавят функции за заявка и получаване на имейли към своите Java приложения, без да се включват в детайли на протокола и сложността на имейл и мрежово програмиране. Aspose.Email Pop3 поддържа всички команди, дефинирани в стандартния POP3 протокол, и предоставя лесни за използване интерфейси заедно с компактен и интуитивен обектен модел. Това значително намалява типичната крива на обучение за Java разработчиците.

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

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

Свързване и влизане в POP3 сървъри.
Поддръжка на APOP.
Запитване за съобщения.
Извличане на съобщения.
Пълна поддръжка за асинхронен стил на програмиране.
Поддръжка на SSL.

Сценарии за Aspose.Email Pop3

Aspose.Email Pop3 може да се използва от разработчиците в много различни сценарии. Тук споделяме няколко.

Бизнес имейл автоматизация

Aspose.Email Pop3 може да се използва за заявка към входящи пощенски кутии и извличане на имейл съобщения. Той работи плавно с компонента за изпращане на имейли, Aspose.Email Mail. Aspose.Email напълно поддържа автоматизацията на имейли. Изпращайте имейл съобщения с Aspose.Email Mail и извличайте съобщения с Aspose.Email Pop3. Изтеглените имейл съобщения могат след това да се анализират от Aspose.Email Mime.

Имейл клиенти

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

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

Тук ще демонстрираме как да се използва Aspose.Email Pop3. Този клас има много функции, но ще се фокусираме върху свързването към POP3 сървър и извличането на съобщения. Примерът показва как да създадете приложение, както и кодовите примери, които го правят работещо. Следвайте стъпките по-долу, за да създадете примерно приложение, използвайки Aspose.Email Pop3.

Създайте инстанция на 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 реализира Интернет протокола за достъп до съобщения (IMAP) върху Java. Aspose.Email Imap позволява на Java разработчиците да добавят IMAP функционалност към своите Java приложения бързо, без необходимостта да разбират детайлите на протокола. Компонентът поддържа извличане и качване на съобщения, проверка на състоянието ново/прочетено/непрочетено на съобщения и др.

Imap : Основни функции

Aspose.Email Imap ви позволява:

Извличане на имейл съобщения.
Качване на имейл съобщения.
Списък на имейл съобщения в различни папки.
Проверка на състоянието на имейл съобщенията.
Работа с MailMessage.
Работа с поддръжка на SSL.

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

Aspose.Email Imap реализира Интернет протокола за достъп до съобщения (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 сървъри.
Списък на имейл съобщения в Exchange пощенски кутии.
Списък на имейл съобщения от различни папки, например Inbox, Sent, Deleted или Drafts.
Изтриване на съобщения във всяка папка на Exchange сървъри.

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

С Aspose.Email Exchange разработчиците могат да достъпват пощенски кутии на Exchange Server от своите Java приложения. Той предоставя лесен за използване API за управление на имейли в Exchange сървъри. Разработчиците могат да създават конзолни, настолни или уеб приложения, които управляват имейли в Exchange пощенски кутии.

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

Тази статия демонстрира как да се използва Aspose.Email Exchange. Създаваме просто настолно приложение, което се свързва с пощенска кутия на Exchange Server, получава списъка със съобщения в папка Inbox и ги показва в Windows форма.

Exchange : Стъпки на примерното приложение

За да стартирате приложението успешно, ви трябват правилните идентификационни данни за достъп до Exchange Server. Тук получаваме информацията за идентификация – URI на Exchange Server, потребителско име, парола и домейн – от Windows форма. Това е много прост пример, затова свойствата на съобщението – тема, подател и получател – се показват просто в листбокса.

Exchange : Примери с код

Добавете следния код в обработчика на клик събитие на бутона 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, не-текстови прикачени файлове, многочастови тела на съобщения и заглавна информация в нестандартни азбуки. 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: Отменяне на заявки за среща с Calendar

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

Можете да изпратите заявка за отмяна на среща с Aspose.Email, използвайки обекта от клас Appointment. Трябва да разполагате с оригиналната информация за заявката за среща, за да я отмените. Примерът в тази статия първо изпраща заявка за среща, запазва информацията в база данни и след това отменя заявката въз основа на ID‑то на съобщението.

Изпращане на заявки за срещи

Преди да можем отмяна на заявки за среща, трябва да изпратим някои:

Първо създайте инстанция от тип 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;
}

Отменяне на заявка за среща

За да отмените заявка за среща, първо вземете ID‑то на имейл съобщението. Тъй като за този пример записахме тази информация в база данни, можем лесно да я получим отново.

Избиране на съобщението, за което да се изпрати заявка за отмяна.
Щракнете върху 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.