Documentation – บทความเชิงเทคนิค

Java: แยกแยะระหว่างไฟล์แนบแบบ Inline และแบบปกติ

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 for Java รองรับคุณลักษณะของ Microsoft Outlook แต่ไม่สามารถแปลงโดยตรงเป็น PDF เพื่อแก้ไข ปัจจัยในบทความนี้ใช้ Aspose.Email เพื่อแปลงข้อความอีเมลเป็นสตรีม MHTML แล้วใช้ Aspose.Words for Java โหลดสตรีม MHTML และบันทึกเป็น PDF.

ข้อความอีเมลสามารถมีไฟล์แนบด้วย เนื่องจากแต่ละไฟล์แนบอาจมีชนิดสื่อที่ต่างกัน Aspose.Email จะละเลยไฟล์แนบเหล่านั้นเมื่อแปลงเป็น MHTML คือ จะแปลงเฉพาะรูปภาพในตัวข้อความเป็นส่วนของ MHTML ส่วนไฟล์แนบทั่วไปจะถูกละเลย

แปลงข้อความอีเมลเป็น PDF

โค้ดต่อไปนี้แสดงการแปลงข้อความอีเมลเป็น PDF ด้วยการใช้ Aspose.Email ร่วมกับ Aspose.Words for Java ซึ่งประกอบด้วยขั้นตอนต่อไปนี้:

โหลดข้อความอีเมลโดยใช้ MailMessage
บันทึกข้อความอีเมลไปยัง MemoryStream เป็น MHTML
โหลดสตรีมโดยใช้ Aspose.Words
บันทึกข้อความเป็น PDF

ข้อมูลอีเมลต้นฉบับสามารถดูได้ดังต่อไปนี้:

|| | :- | |รูป: ไฟล์ MSG ต้นฉบับ |

|| | :- | |รูป: ไฟล์ PDF ที่แปลงแล้ว | Java


 static void EmailToPdf(String emailPath) throws Exception

{

       FileInputStream fstream=new FileInputStream(emailPath);

       MailMessage eml = MailMessage.load(fstream);

       //Save the Message to output stream in MHTML format

       ByteArrayOutputStream emlStream = new ByteArrayOutputStream();

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

       //Load the stream in Word document

       LoadOptions lo = new LoadOptions();

       lo.setLoadFormat(LoadFormat.MHTML);

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

       //Save to disc

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

       //or Save to stream

       ByteArrayOutputStream foStream = new ByteArrayOutputStream();

       doc.save(foStream, SaveFormat.PDF);

}

Java: การปรับโครงสร้าง Connection Pool

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

กับการเปิดตัว Aspose.Email 19.3, pool การเชื่อมต่อได้ถูกปรับโครงสร้างใหม่ ใหม่ EmailClient ได้แนะนำคลาสที่จะมาทดแทน CredentialsByHostClient คลาส. เมธอด EmailClient คลาสให้ ConnectionAsgmtMode คุณสมบัติที่กำหนดโหมดการจัดสรรการเชื่อมต่อในสภาพแวดล้อมหลายเธรด EmailClient.ConnectionAsgmtMode ถูกตั้งค่าด้วย ConnectionAsgmtType enumerable.

ประเภทการเชื่อมต่อ

มีประเภทการเชื่อมต่อต่อไปนี้สามประเภท:

การเชื่อมต่อหลัก: คือการเชื่อมต่อที่สร้างและทำลายพร้อมกับไคลเอนต์อีเมล ไม่สามารถสร้างหรือทำลายด้วยตนเองได้
การเชื่อมต่อค่าเริ่มต้น: ผู้ใช้สามารถสร้างการเชื่อมต่อค่าเริ่มต้นสำหรับเธรดด้วย CreateConnection เมธอด หากการเชื่อมต่อค่าเริ่มต้นมีอยู่ เมธอดทั้งหมดของไคลเอนต์อีเมลที่ทำงานในเธรดจะใช้การเชื่อมต่อนี้โดยอัตโนมัติ สามารถมีการเชื่อมต่อค่าเริ่มต้นได้เพียงหนึ่งต่อเธรด สามารถสร้างด้วยตนเองหรืออัตโนมัติ ขึ้นอยู่กับคุณสมบัติ EmailClient.ConnectionAsgmtMode การเชื่อมต่อเหล่านี้สามารถสร้างด้วยตนเองโดยใช้ EmailClient.CreateConnection(createAsDefaultConnection = true) เมธอด หากการเชื่อมต่อค่าเริ่มต้นไม่ได้ใช้ (ขึ้นอยู่กับโหมดการจัดสรรการเชื่อมต่อ) การเชื่อมต่อหลักจะถูกใช้โดยอัตโนมัติแทน
การเชื่อมต่ออิสระ: คือการเชื่อมต่อที่ไม่ได้เชื่อมโยงกับเธรด สามารถสร้างด้วยตนเองและต้องใช้เป็นพารามิเตอร์ของเมธอดอย่างชัดเจน การเชื่อมต่อเหล่านี้สามารถสร้างด้วยตนเองโดยใช้ EmailClient.CreateConnection() เมธอดหรือ EmailClient.CreateConnection(createAsDefaultConnection = false) เมธอด.

ประเภทการจัดสรรการเชื่อมต่อ

เพื่อกำหนดค่า EmailClient.ConnectionAsgmtMode คุณสมบัติ, ConnectionAsgmtType enumerable ถูกใช้ ประเภทการจัดสรรที่ให้โดย 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 component RecurrencePattern และ RecurrenceRule เป็นคลาสหลักของ Aspose iCalendar, และให้การทำงานที่เป็นรูปธรรมของส่วนประกอบ RFC 2445 ที่สอดคล้องกัน.

นี้ RecurrencePattern คลาสนี้แสดงรูปแบบการทำซ้ำทั้งหมด คุณสามารถสร้างรูปแบบการทำซ้ำใหม่ตั้งแต่ต้นโดยใช้คอนสตรัคเตอร์เริ่มต้นหรือโหลดรูปแบบที่มีอยู่ใน CalendarRecurrence. ส่วน 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 พร้อมเวลาในท้องถิ่น

รูปแบบวันที่พร้อมเวลาในท้องถิ่นคือค่าตรงวันที่เวลาแบบไม่มีตัวบ่งชี้ UTC และไม่มีการอ้างอิงถึงโซนเวลา ตัวอย่างเช่น ข้อความต่อไปนี้แสดงวันที่ 18 มกราคม 1998 เวลา 23:00: DTSTART:19980118T230000. ค่าตรงวันที่เวลาแบบนี้เรียกว่า "floating" และไม่ได้ผูกกับโซนเวลาใดเป็นพิเศษ ใช้เพื่อแสดงค่า ชั่วโมง นาที และวินาทีเดียวกันโดยไม่คำนึงถึงโซนเวลาที่กำลังถูกสังเกตอยู่.

DATE-TIME พร้อมเวลา UTC

วันที่พร้อมเวลา UTC หรือเวลาสัมบูรณ์ จะระบุด้วยอักษร Z ตัวพิมพ์ใหญ่ของละติน ซึ่งเป็นตัวบ่งชี้ UTC ที่ต่อท้ายค่เวลา ตัวอย่างเช่น ข้อความต่อไปนี้แสดงวันที่ 19 มกราคม 1998 เวลา 07:00 UTC: DTSTART:19980119T070000Z โปรดทราบว่า Aspose iCalendar ละเว้นส่วนต่อท้ายรูปแบบ UTC Z และถือเวลาเป็นเวลาในพื้นที่ มาตรฐาน 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: การตั้งค่า Default Text Encoding ในข้อความอีเมล

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

บทความนี้แนะนำ MailMessage.PreferredTextEncoding คุณสมบัติและอธิบายวิธีการใช้งาน โดยใช้คุณสมบัตินี้คุณสามารถตั้งค่า default text encoding สำหรับคุณสมบัติดังต่อไปนี้:

จาก: ชื่อที่แสดง
ถึง: ชื่อที่แสดง
Subject
Body

ตั้งค่า Default Text Encoding

ในเวอร์ชันก่อนของ Aspose.Email การเข้ารหัสข้อความสำหรับคุณสมบัติ from, to, subject และ body ถูกตั้งค่าแยกกัน เพื่อเพิ่มความสะดวกใช้งาน เราได้เพิ่ม PreferredTextEncoding คุณสมบัติที่ตั้งค่าทั้งหมดพร้อมกัน ตอนนี้ง่ายขึ้นในการรับรองว่าเนื้อความทั้งหมดในคุณสมบัติดังกล่าวถูกเข้ารหัสอย่างถูกต้องในข้อความอีเมล โค้ดตัวอย่างต่อไปนี้แสดงวิธีใช้คำภาษาฝรั่งเศสเป็นชื่อแสดงสำหรับที่อยู่อีเมล, หัวเรื่องและเนื้อหา.

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

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

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

Java: การแปลงไฟล์ข้อความ Outlook (MSG) เป็นภาพ TIFF

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

การแปลงไฟล์ Outlook MSG ไปเป็นภาพ TIFF ไม่รองรับใน Aspose.Email สำหรับ 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 สำหรับ Java ใช้เอกสาร MHTML ในเนื้อหาอีเมล.

ใช้เอกสาร Microsoft Word เป็นเนื้อหาอีเมล

ตัวอย่างโปรแกรมต่อไปนี้แสดงวิธีส่งเอกสาร Word เป็นเนื้อหาอีเมลโดยใช้ Aspose.Words สำหรับ Java และ Aspose.Email สำหรับ Java:

โหลดเอกสาร Microsoft Word โดยใช้ Aspose.Word สำหรับ Java’s Document คลาส.
บันทึกเป็นรูปแบบ MHTML.
โหลดเอกสาร MHTML โดยใช้ Aspose.Email สำหรับ Java’s MailMessage คลาสสำหรับตั้งค่าเนื้อหาอีเมล.
ตั้งค่าคุณสมบัติอื่นของข้อความโดยใช้ MailMessage คุณสมบัติและเมธอดของคลาส.
ส่งอีเมลโดยใช้ Aspose.Email สำหรับ Java’s 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 ตามตัวอย่างด้านล่าง ผลลัพธ์ของโค้ดจะเป็น: "ทำซ้ำทุกเดือนในวันแรกและวันที่แรกจากวันสุดท้ายของเดือน สูงสุด 2 ครั้ง" ตัวอย่างโค้ดต่อไปนี้แสดงวิธีรับข้อความที่เป็นมิตรต่อผู้ใช้สำหรับการทำซ้ำ

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

Java: เข้าถึงบริการเมลด้วย OAuth

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

ได้เพิ่มการสนับสนุน OAuth 2.0 ให้กับ Aspose.Email และสามารถใช้เข้าถึงเซิร์ฟเวอร์ SMTP, POP3, IMAP และ EWS โดยทั่วไป เซิร์ฟเวอร์ทั้งหมดที่สนับสนุนโทเค็น Bearer OAuth 2.0 สามารถใช้กับ Aspose.Email ได้ แต่ไคลเอนต์อีเมลของเราถูกทดสอบกับเซิร์ฟเวอร์อีเมลของ Google และเซิร์ฟเวอร์ Microsoft Office 365 การเข้าถึงเซิร์ฟเวอร์จาก SmtpClient, Pop3Client, ImapClient และ EWSClient ด้วย OAuth สามารถนำไปใช้ได้ 2 วิธี

ให้โทเค็นการเข้าถึงโดยตรงในคอนสตรัคเตอร์ของไคลเอนต์อีเมล ในกรณีนี้ผู้ใช้ต้องเข้าใจว่าช่วงอายุของโทเค็นการเข้าถึงมีจำกัด เมื่อโทเค็นหมดอายุ ไคลเอนต์อีเมลไม่สามารถใช้เข้าถึงเซิร์ฟเวอร์ได้
จัดเตรียมการนำเสนอผู้ให้โทเค็นแบบกำหนดเองโดยอิงจาก ITokenProvider อินเทอร์เฟซเข้าสู่คอนสตรัคเตอร์ของไคลเอนต์อีเมล ในกรณีนี้ไคลเอนต์จะตรวจสอบเวลาหมดอายุของโทเค็นและร้องขอ ITokenProvider สำหรับโทเค็นการเข้าถึงใหม่เมื่อโทเค็นก่อนหน้าหมดอายุ ด้วยวิธีนี้ไคลเอนต์จะรีเฟรชโทเค็นเป็นระยะและอาจทำงานกับเซิร์ฟเวอร์ได้ไม่จำกัดเวลา บริการส่วนใหญ่สนับสนุนวิธีง่ายๆ ในการรีเฟรชโทเค็นการเข้าถึง ตัวอย่างเช่น การใช้รีเฟรชโทเค็นในบริการของ Google หรือกระบวนการตรวจสอบสิทธิ์ ROPC ใน Microsoft identity platform สามารถใช้สำหรับการนำผู้ให้โทเค็นไปใช้ได้

กำหนดค่าบัญชีบนเซิร์ฟเวอร์ที่เหมาะสม

บทความต่อไปนี้ช่วยคุณกำหนดค่าบัญชีเพื่อเข้าถึงบริการอีเมล

สำหรับ 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)) {

}

การนำเสนอ Custom ITokenProvider สำหรับ Office 365

คุณสามารถใช้การนำเสนอผู้ให้โทเค็นด้านล่างเพื่อเข้าถึงบริการอีเมลของ Office 365 ได้

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

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

    private static final String GRANT_TYPE = "password";

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

    private OAuthToken token;

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

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

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

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

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

    public void dispose() {
    }

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

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

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

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

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

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

            connection.connect();

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

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

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

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

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

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

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

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

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

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเชื่อมต่อบริการ Office 365 ด้วยผู้ให้โทเค็นแบบกำหนดเอง

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

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

}

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

}

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

}

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

}

Java: การใช้ OAuth เพื่อเข้าถึงบริการอีเมล

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

ให้โทเค็นการเข้าถึงโดยตรงในคอนสตรัคเตอร์ของไคลเอนต์อีเมล ในกรณีนี้ผู้ใช้ต้องเข้าใจว่าช่วงอายุของโทเค็นการเข้าถึงมีจำกัด เมื่อโทเค็นหมดอายุ ไคลเอนต์อีเมลไม่สามารถใช้เข้าถึงเซิร์ฟเวอร์ได้
จัดเตรียมการนำเสนอผู้ให้โทเค็นแบบกำหนดเองโดยอิงจาก ITokenProvider อินเทอร์เฟซเข้าสู่คอนสตรัคเตอร์ของไคลเอนต์อีเมล ในกรณีนี้ไคลเอนต์จะตรวจสอบเวลาหมดอายุของโทเค็นและร้องขอ ITokenProvider สำหรับโทเค็นการเข้าถึงใหม่เมื่อโทเค็นก่อนหน้าหมดอายุ ด้วยวิธีนี้ไคลเอนต์จะรีเฟรชโทเค็นเป็นระยะและอาจทำงานกับเซิร์ฟเวอร์ได้ไม่จำกัดเวลา บริการส่วนใหญ่สนับสนุนวิธีง่ายๆ ในการรีเฟรชโทเค็นการเข้าถึง ตัวอย่างเช่น การใช้รีเฟรชโทเค็นในบริการของ Google หรือกระบวนการตรวจสอบสิทธิ์ ROPC ใน Microsoft identity platform สามารถใช้สำหรับการนำผู้ให้โทเค็นไปใช้ได้

กำหนดค่าบัญชีบนเซิร์ฟเวอร์ที่เหมาะสม

บทความต่อไปนี้ช่วยคุณกำหนดค่าบัญชีเพื่อเข้าถึงบริการอีเมล

สำหรับ 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)) {

}

การนำเสนอ Custom ITokenProvider สำหรับ Office 365

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

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

    private static final String GRANT_TYPE = "password";

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

    private OAuthToken token;

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

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

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

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

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

    public void dispose() {
    }

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

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

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

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

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

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

            connection.connect();

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

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

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

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

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

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

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

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

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

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

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

}

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

}

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

}

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

}

สิทธิ์ในการเข้าถึง Office 365 ผ่าน IMAP, POP3 หรือ SMTP

เราจำเป็นต้องกำหนดสิทธิ์ API ที่ถูกต้องและมอบความยินยอมของผู้ดูแลระบบเพื่อเข้าถึงบริการอีเมลของ Office 365:

ในตัวช่วยสร้างสิทธิ์ API / เพิ่มสิทธิ์ ให้เลือก Microsoft Graph แล้วเลือก Delegated permissions เพื่อค้นหาระดับสิทธิ์ต่อไปนี้ที่แสดง:

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 คลาสสำหรับenumerate แพ็กเกจ 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;

ส่งคำขออัปเดตการนัดหมาย

สำหรับการส่งการอัปเดตสำหรับการนัดหมายก่อนหน้า จำเป็นต้องใช้รหัสยูนิก (unique id) ตัวอย่างโค้ดต่อไปนี้แสดงวิธีส่งคำขออัปเดตการนัดหมายนี้

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 อนุญาตให้ผู้ใช้ใช้ในสภาพแวดล้อมแบบหลายเธรด ไคลเอนต์เมลอนุญาตให้มีการเชื่อมต่อหนึ่งหรือหลายการเชื่อมต่อกับเซิร์ฟเวอร์ เพื่อจัดการชุดการเชื่อมต่อภายในไคลเอนต์จะใช้ connection pool จำนวนการเชื่อมต่อที่สามารถสร้างและใช้พร้อมกันได้จำกัดโดยคุณสมบัติ 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 interface เพื่อปล่อยการเชื่อมต่อต้องเรียก 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 ยังมีฟีเจอร์ mail merge แบบเทมเพลตที่ใช้สร้างเทมเพลตจดหมายข่าว เทมเพลตนี้สามารถใช้ทำ mail merge เพื่อส่งจดหมายข่าวจำนวนมาก มีงานอื่น ๆ อีกหลายอย่างที่ Aspose.Email Mail สามารถทำได้ในแอปพลิเคชันการตลาดอีเมล

เครื่องมือการตลาดอื่น ๆ

คล้ายกับแอปพลิเคชันจดหมายข่าว ซอฟต์แวร์ประเภทอื่น ๆ อีกหลายประเภทสามารถสร้างได้ด้วย Aspose.Email Mail ใช้เพื่อสร้างการตลาดอีเมล, เมลล์มาส, แคมเปญอีเมลแบบจำนวนมาก ฯลฯ

แอปพลิเคชันธุรกิจ

Aspose.Email Mail สามารถใช้ในแอปพลิเคชันธุรกิจเกือบทุกประเภทเพื่อทำงานยูทิลิตี้:

การแจ้งเตือนอีเมล: ส่งการแจ้งเตือนอีเมลเพื่อบอกผู้ใช้เกี่ยวกับกิจกรรม
การขอประชุม: ส่งคำขอประชุมธุรกิจโดยใช้การสนับสนุน iCalendar ของ Aspose.Email Mail
อีเมลรายงานที่กำหนดเวลา: รายงานเป็นส่วนสำคัญของแอปพลิเคชันธุรกิจหลายๆ ตัว รายงานธุรกิจหลายอย่างถูกสร้างเป็นช่วงๆ ใช้ Aspose.Email Mail เพื่อส่งอีเมลรายงานที่กำหนดเวลา

ไคลเอนต์อีเมล

Aspose.Email Mail ยังสามารถใช้ในไคลเอนต์อีเมลเพื่อส่งอีเมลทั่วไปได้ รองรับไฟล์แนบ, วัตถุฝัง, เหตุการณ์ iCalendar, mail merge, การส่งอีเมลจำนวนมาก ฯลฯ ดังนั้น 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 เป็นคอมโพเนนท์ที่มีประสิทธิภาพสูงที่นักพัฒนาสามารถทำงานเกี่ยวกับอีเมลได้เกือบทุกอย่าง เช่น การส่งอีเมลจำนวนมากแบบหลายเธรด การใช้ mail merge การเพิ่มไฟล์แนบ การฝังรูปภาพและเสียงลงในข้อความอีเมล การเพิ่มเหตุการณ์ iCalendar ลงในอีเมล การรับอีเมล และอื่น ๆ อีกมากมาย

Aspose.Email Pop3

Aspose.Email Pop3 ทำงานตามโปรโตคอลไปรษณีย์ (Post Office Protocol) รุ่น 3 (POP3) บน Java ทำให้ผู้พัฒนา Java สามารถเพิ่มฟีเจอร์การสอบถามและรับอีเมลเข้าสู่แอปพลิเคชัน Java ของตนโดยไม่ต้องเจาะลึกรายละเอียดของโปรโตคอลและความซับซ้อนของการเขียนโปรแกรมอีเมลและเครือข่าย Aspose.Email Pop3 รองรับคำสั่งทั้งหมดที่กำหนดในมาตรฐาน POP3 และมอบอินเทอร์เฟซที่ใช้งานง่ายพร้อมโมเดลอ็อบเจกต์ที่กะทัดรัดและเป็นธรรมชาติ ช่วยลดเส้นโค้งการเรียนรู้ที่มักเกิดขึ้นสำหรับนักพัฒนา Java อย่างมาก

Pop3 : คุณสมบัติหลัก

เป็นส่วนหนึ่งของ Aspose.Email, Aspose.Email Pop3 ถูกออกแบบเฉพาะสำหรับ Java และเขียนด้วยโค้ด Java ที่จัดการได้ มันให้คุณ:

เชื่อมต่อและเข้าสู่ระบบเซิร์ฟเวอร์ POP3.
รองรับ APOP.
สอบถามข้อความ.
ดึงข้อความ.
สนับสนุนรูปแบบการเขียนโปรแกรมแบบ Async อย่างเต็มที่
รองรับ SSL.

สถานการณ์การใช้ Aspose.Email Pop3

Aspose.Email Pop3 สามารถใช้โดยนักพัฒนาในหลายสถานการณ์ เราจะแบ่งปันตัวอย่างสองกรณี

การอัตโนมัติอีเมลธุรกิจ

Aspose.Email Pop3 สามารถใช้สอบถามกล่องขาเข้าอีเมลและดึงข้อความอีเมลได้ ทำงานร่วมกับคอมโพเนนท์การส่งอีเมล Aspose.Email Mail อย่างราบรื่น Aspose.Email รองรับการอัตโนมัติของอีเมลอย่างเต็มที่ ส่งข้อความอีเมลด้วย Aspose.Email Mail และดึงข้อความด้วย Aspose.Email Pop3 หลังจากดาวน์โหลดแล้วข้อความอีเมลสามารถวิเคราะห์ได้โดย Aspose.Email Mime.

ไคลเอนต์อีเมล

Aspose.Email Pop3 สามารถใช้ในแอปพลิเคชันไคลเอนต์อีเมลเพื่อรับอีเมลได้

Pop3 : ตัวอย่างแอปพลิเคชัน

ที่นี่ เราจะสาธิตวิธีการใช้ Aspose.Email Pop3. คลาสนี้มีคุณลักษณะหลายอย่าง แต่เราจะเน้นที่การเชื่อมต่อไปยังเซิร์ฟเวอร์ POP3 และดึงข้อความ ตัวอย่างแสดงวิธีสร้างแอปพลิเคชันรวมถึงโค้ดตัวอย่างที่ทำให้แอปทำงาน ตามขั้นตอนด้านล่างเพื่อสร้างแอปตัวอย่างโดยใช้ Aspose.Email Pop3.

สร้างอ็อบเจกต์ Pop3Client.
ตั้งค่าชื่อโฮสต์ POP3, ชื่อผู้ใช้และรหัสผ่านในอ็อบเจกต์นี้
สร้างอ็อบเจกต์ MailMessage แล้วดึงอีเมลแรกในบัญชีของคุณเข้าไปโดยเรียกฟังก์ชัน fetchMessage() ซึ่งจะนำข้อความแรกจากบัญชีอีเมลของคุณเข้าสู่ MailMessage
ใช้คุณสมบัติ From, Subject และ HtmlBody ของอ็อบเจกต์ MailMessage เพื่อดูผู้ส่ง, หัวเรื่องและเนื้อหาของข้อความ

ขั้นตอนข้างต้นจะแสดงในตัวอย่างโค้ดด้านล่าง.

// Create a POP3 client
Pop3Client client = new Pop3Client();

// Basic settings (required)
client.setHost("pop3.youdomain.com");
client.setUsername("username");
client.setPassword("psw");

try {
    // Retrieve first message in MailMessage format directly
    MailMessage msg;
    msg = client.fetchMessage(1);
    System.out.println(msg.getFrom().toString());
    System.out.println(msg.getSubject());
    System.out.println(msg.getHtmlBody());
} catch (Exception ex) {
    System.err.println(ex);
}

สำหรับเซิร์ฟเวอร์ที่เปิดใช้งาน SSL เราต้องเปลี่ยนแปลงคุณสมบัติดังต่อไปนี้ของอ็อบเจ็กต์ Pop3Client:

// Set implicit security mode
client.setSecurityOptions(SecurityOptions.SSLImplicit);

Aspose.Email Imap

Aspose.Email Imap ทำการนำ Internet Message Access Protocol (IMAP) ไปใช้บน Java Aspose.Email Imap ทำให้นักพัฒนา Java สามารถเพิ่มความสามารถ IMAP ให้กับแอปพลิเคชัน Java ของตนได้อย่างรวดเร็วโดยไม่ต้องเข้าใจรายละเอียดของโปรโตคอล คอมโพเนนท์นี้สนับสนุนการดึงและอัปโหลดข้อความ, การตรวจสอบสถานะใหม่/อ่าน/ยังไม่ได้อ่านของข้อความ ฯลฯ

Imap : คุณสมบัติหลัก

Aspose.Email Imap อนุญาตให้คุณ:

ดึงข้อความอีเมล.
อัปโหลดข้อความอีเมล.
แสดงรายการข้อความอีเมลในโฟลเดอร์ต่าง ๆ.
ตรวจสอบสถานะของข้อความอีเมล.
ทำงานกับ MailMessage.
ทำงานร่วมกับการสนับสนุน SSL.

การใช้ Aspose.Email Imap

Aspose.Email Imap ใช้การทำงานของ Internet Message Access Protocol บน Java ด้วยมัน นักพัฒนาสามารถสืบค้นและจัดการอีเมลบนเซิร์ฟเวอร์ IMAP ได้อย่างง่ายดาย และทำการสร้าง, ลบ หรือเปลี่ยนชื่อโฟลเดอร์อีเมล การใช้ Aspose.Email Imap ทำให้นักพัฒนานำประโยชน์จากโปรโตคอล IMAP ด้วย API ที่ใช้งานง่าย พวกเขาสามารถเข้าถึงอีเมลจากคอมพิวเตอร์ใดก็ได้ เนื่องจากอีเมลยังคงเก็บบนเซิร์ฟเวอร์ การใช้ Aspose.Email Imap นักพัฒนาสามารถสร้างแอปพลิเคชันเว็บหรือเดสก์ท็อปที่รับและจัดการอีเมลจากเซิร์ฟเวอร์ IMAP ได้ Aspose ได้นำโปรโตคอล IMAP ไปใช้งานตามมาตรฐานการตรวจสอบสิทธิ์อินเทอร์เน็ตและ RFC ดังนั้น Aspose.Email Imap จึงเป็นการนำไปใช้ที่ปลอดภัยและมีฟีเจอร์ครบถ้วนของโปรโตคอล IMAP พร้อมโมเดลวัตถุและอินเทอร์เฟซที่เข้าใจง่าย

Imap : แอปพลิเคชันตัวอย่าง

บทความนี้อธิบายวิธีการใช้ Aspose.Email Imap. เราสร้างแอปพลิเคชันเล็ก ๆ ที่รับจำนวนข้อความอีเมลในบัญชี IMAP ของคุณ ทำตามขั้นตอนด้านล่างเพื่อสร้างแอปตัวอย่างโดยใช้ Aspose.Email Imap.

สร้างอินสแตนซ์ของ ImapClient โดยส่งชื่อเซิร์ฟเวอร์ IMAP, ชื่อผู้เข้าสู่ระบบและรหัสผ่าน
เรียกฟังก์ชัน selectFolder() ของอินสแตนซ์ ImapClient เพื่อเลือกโฟลเดอร์ที่ต้องการนับจำนวนข้อความ
ตอนนี้เรียกคุณสมบัติ CurrentFolder.TotalMessageCount ของอินสแตนซ์ ImapClient เพื่อนับจำนวนข้อความอีเมล.

Imap : ตัวอย่างโค้ด

ตัวอย่างโค้ดด้านล่างแสดงวิธีดำเนินการตามขั้นตอนที่อธิบายข้างต้นโดยใช้ Aspose.Email.

// Creates an instance of the class ImapClient by specified the host, username and password
ImapClient client = new ImapClient("localhost", "username", "password");

try {
    client.selectFolder(ImapFolderInfo.IN_BOX);
    String strTemp;
    strTemp = "You have " + client.getCurrentFolder().getTotalMessageCount() + " messages in your account.";
    // Gets number of messages in the folder, Disconnects to imap server.
    System.out.println(strTemp);
} catch (Exception ex) {
    System.err.println(ex);
}

สำหรับเซิร์ฟเวอร์อีเมลที่เปิดใช้งาน SSL ให้ตั้งค่าคุณสมบัติดังต่อไปนี้ของอ็อบเจ็กต์ ImapClient:

// Set security mode
client.setSecurityOptions(SecurityOptions.SSLImplicit);

Aspose.Email Exchange

Aspose.Email Exchange ช่วยให้นักพัฒนาจัดการอีเมลบน Microsoft Exchange Server โดยใช้คอมโพเนนท์นี้คุณสามารถเชื่อมต่อ, แสดงรายการข้อความและดาวน์โหลดอีเมลจากกล่องจดหมาย Exchange Server ได้โดยไม่ต้องเข้าใจรายละเอียดของโปรโตคอลพื้นฐาน คอมโพเนนท์นี้สนับสนุนการแสดงรายการข้อความ, การส่งอีเมล, การดาวน์โหลดข้อความและการบันทึกเป็นรูปแบบ eml หรือ msg ลงในดิสก์ของคุณ เป็นต้น

Exchange : คุณสมบัติหลัก

Aspose.Email Exchange ให้คุณ:

เชื่อมต่อกับ Microsoft Exchange Server
แสดงรายการข้อความอีเมลในกล่องจดหมาย Exchange
แสดงรายการข้อความอีเมลจากโฟลเดอร์ต่าง ๆ เช่น Inbox, Sent, Deleted หรือ Drafts
ลบข้อความในโฟลเดอร์ใดก็ได้บน Exchange Server.

การใช้ Aspose.Email Exchange

ด้วย Aspose.Email Exchange นักพัฒนาสามารถเข้าถึงกล่องจดหมาย Exchange Server จากแอปพลิเคชัน Java ของตนได้ มันมอบ API ที่ใช้งานง่ายสำหรับการจัดการอีเมลบน Exchange Server นักพัฒนาสามารถสร้างแอปพลิเคชันคอนโซล, เดสก์ท็อป หรือเว็บที่จัดการอีเมลในกล่องจดหมาย Exchange

ตัวอย่างแอปพลิเคชัน Aspose.Email Exchange

บทความนี้แสดงวิธีการใช้ Aspose.Email Exchange. เราสร้างแอปพลิเคชันเดสก์ท็อปง่าย ๆ ที่เชื่อมต่อกับกล่องจดหมาย Exchange Server ดึงรายการข้อความในโฟลเดอร์ Inbox และแสดงบนฟอร์ม Windows.

Exchange : ขั้นตอนแอปพลิเคชันตัวอย่าง

เพื่อให้แอปพลิเคชันทำงานได้สำเร็จ คุณต้องมีข้อมูลรับรองที่ถูกต้องสำหรับการเข้าถึง Exchange Server ที่นี่ เราดึงข้อมูลรับรอง – URI ของ Exchange Server, ชื่อผู้ใช้, รหัสผ่านและโดเมน – จากแบบฟอร์ม Windows ตัวอย่างนี้เป็นพื้นฐานมาก ดังนั้นคุณสมบัติของข้อความ – หัวข้อ, ผู้ส่งและผู้รับ – จึงแสดงใน ListBox อย่างง่าย

Exchange : ตัวอย่างโค้ด

เพิ่มโค้ดต่อไปนี้ลงในตัวจัดการเหตุการณ์คลิกของปุ่ม List Messages.

// Clear the items in the listbox
lstMessages.clear();

// Create instance of IEWSClient class by giving credentials and Call ListMessages method to list messages info from Inbox
IEWSClient client = EWSClient.getEWSClient("mailboxURI", "Username", "Password", "Domain");
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to display the basic information
for (ExchangeMessageInfo msgInfo : msgCollection) {
    String strMsgInfo = "Subject: " + msgInfo.getSubject() + " == From: " + msgInfo.getFrom().toString() + " == To: " + msgInfo.getTo().toString();
    lstMessages.add(strMsgInfo);
}

Exchange : ผลลัพธ์

ภาพหน้าจอนี้แสดงข้อความที่ดึงจาก Exchange Server เมธอด listMessages() คืนข้อมูลพื้นฐานเช่น หัวข้อ, ผู้ส่ง, ผู้รับ และรหัสข้อความ หากต้องการข้อความเต็ม ให้เรียกเมธอด IEWSClient.fetchMessage() (การใช้ IEWSClient.fetchMessage() ถูกอธิบายในบทความ ทำงานกับกล่องเมล Exchange และข้อความ.)

Aspose.Email Mime

Multipurpose Internet Mail Extensions (MIME) เป็นมาตรฐานอินเทอร์เน็ตที่ขยายรูปแบบอีเมลเพื่อรองรับข้อความในชุดอักขระที่ไม่ใช่ US‑ASCII, ไฟล์แนบที่ไม่ใช่ข้อความ, เนื้อหาข้อความหลายส่วน, และข้อมูลหัวข้อในชุดอักขระที่ไม่ใช่ ASCII Aspose.Email Mime ติดตั้งโปรโตคอล MIME บน Java ทำหน้าที่เป็นตัวแปล เพราะสามารถอ่านอีเมลจากไฟล์ (.eml ฯลฯ) หรือจากหน่วยความจำ (string) แล้วแยกไฟล์หรือสตริงอีเมลออกเป็นส่วนที่มีความหมาย หากคุณต้องการอ่านไฟล์อีเมลโดยไม่ต้องเจาะลึกรายละเอียดของโปรโตคอล 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 คลาสให้ความสามารถในการละเลยข้อยกเว้น:

ตัวอย่างโค้ด:

ตั้งค่าฟังก์ชัน callback เพื่อจัดการข้อยกเว้น:

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);

คุณยังสามารถตั้งค่าฟังก์ชัน callback สำหรับ บันทึกข้อยกเว้นที่ละเลย:

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.