Documentation – Bài viết kỹ thuật

Java: Phân biệt giữa Tệp đính kèm Inline và Thông thường

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

Các tin nhắn email có thể chứa hình ảnh inline cũng như tệp đính kèm. Sử dụng MailMessage, các tệp đính kèm inline có thể được trích xuất từ LinkedResourceCollection bộ sưu tập, trong khi các tệp đính kèm thông thường có thể được truy cập và trích xuất với một tin nhắn có AttachmentCollection bộ sưu tập. Tuy nhiên, điều này khác khi tin nhắn được tải bằng MapiMessage, vì tất cả các hình ảnh inline và tệp đính kèm thông thường đều có thể truy cập cho người dùng trong cùng một MapiAttachmentCollection. Do đó, một phương pháp có thể phân biệt giữa tệp đính kèm inline và tệp đính kèm thông thường khi MapiMessage được sử dụng nếu cần.

Bài viết này giải thích cách phân biệt tệp đính kèm inline và thông thường bằng cách sử dụng MapiMessage. Khi quyết định, loại thân của MapiMessage được tính đến như sau:

Thân plain text: Các tin nhắn email có loại thân plain text không cần kiểm tra, vì tất cả các tệp đính kèm trong các tin nhắn như vậy luôn là tệp đính kèm thông thường.
Thân HTML: Đối với các tin nhắn có thân HTML, tệp đính kèm không chỉ cần chứa thuộc tính PR_ATTACH_FLAGS (0x37140003), mà giá trị của nó phải bằng 0x00000004 cho các tệp đính kèm inline. Nếu điều kiện này được đáp ứng, thì còn phụ thuộc vào các thẻ PR_ATTACH_CONTENT_LOCATION và PR_ATTACH_CONTENT_ID để xác định tính chất của tệp đính kèm. Tuy nhiên, khi không có thẻ MAPI PR_ATTACH_FLAGS, tệp đính kèm sẽ được kiểm tra thuộc tính PR_ATTACH_DISPOSITION (0x3716001F hoặc 0x3716001E) để xác định loại tệp đính kèm.
Thân RTF: Nếu thân là RTF, thì tất cả các tệp đính kèm OLE đều là tệp đính kèm inline. Giá trị của PR_ATTACH_METHOD cho tất cả các tệp đính kèm OLE bằng 0x00000006.

Mẫu mã sau minh họa cách phân biệt programmatically giữa tệp đính kèm inline và thông thường. Hàm isInlineAttachment nhận một tệp đính kèm và MapiMessage làm tham số đầu vào và trả về true nếu tệp đính kèm là inline.

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

Đoạn mã này sử dụng hàm isInlineAttachment() để đánh giá các tệp đính kèm.

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: Xác định và Trích xuất Tệp đính kèm Nhúng từ MSG Định dạng RTF

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

Các tin nhắn email có thể chứa tệp đính kèm inline được nhúng dưới dạng một đối tượng toàn bộ hoặc dưới dạng một biểu tượng. Để phân biệt giữa hai loại tệp đính kèm này, trước tiên cần xem xét một số thuộc tính của tệp đính kèm. Sau khi đáp ứng các tiêu chí nhất định dựa trên các thuộc tính của tệp đính kèm, tệp đính kèm có thể được lưu bằng cách trích xuất nó từ ObjectData của nó.

Bài viết này xác định và trích xuất tệp đính kèm nhúng từ tệp MSG định dạng 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: Lưu file MSG dưới dạng PDF

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

Bài viết này chỉ cách chuyển một tin email sang PDF bằng Aspose.Email. Aspose.Email cho Java hỗ trợ các tính năng của Microsoft Outlook, nhưng không thể thực hiện chuyển đổi trực tiếp sang PDF. Để khắc phục, các mẫu trong bài này sử dụng Aspose.Email để chuyển tin email sang luồng MHTML, sau đó dùng Aspose.Words cho Java để tải luồng MHTML và lưu thành PDF.

Một tin email cũng có thể chứa các tệp đính kèm. Vì mỗi tệp đính kèm có thể có loại media khác nhau, Aspose.Email bỏ qua các tệp này khi chuyển sang MHTML, tức là chỉ các ảnh nhúng trong tin sẽ là một phần của MHTML và các tệp đính kèm thông thường sẽ bị bỏ qua.

Chuyển đổi tin email sang PDF

Đoạn mã dưới đây cho thấy cách chuyển tin email sang PDF bằng Aspose.Email kết hợp với Aspose.Words cho Java. Điều này bao gồm các bước sau:

Tải tin email bằng MailMessage
Lưu tin email vào MemoryStream dưới dạng MHTML
Tải luồng bằng Aspose.Words
Lưu tin dưới dạng PDF

Tin email nguồn có thể được xem như sau:

|| | :- | |Hình: Tệp MSG Gốc |

|| | :- | |Hình: Tệp PDF đã chuyển đổi | 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: Kết nối Pool Được Tái cấu trúc

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

Với việc phát hành Aspose.Email 19.3, pool kết nối đã được tái cấu trúc. Mới EmailClient lớp đã được giới thiệu sẽ cuối cùng thay thế CredentialsByHostClient lớp. EmailClient lớp cung cấp một ConnectionAsgmtMode thuộc tính xác định chế độ cấp phát kết nối trong môi trường đa luồng. EmailClient.ConnectionAsgmtMode được đặt bằng cách sử dụng ConnectionAsgmtType enumerable.

Các loại kết nối

Có ba loại kết nối sau:

The main connection: This is the connection created and disposed together with the mail client. It can’t be created or disposed manually.
Default connection: User can create default connections for threads with CreateConnection phương thức. Nếu kết nối mặc định tồn tại, tất cả các phương thức của client email thực thi trong một luồng sẽ ngầm sử dụng kết nối này. Chỉ một kết nối mặc định có thể tồn tại cho mỗi luồng. Nó có thể được tạo thủ công hoặc tự động. Điều này phụ thuộc vào thuộc tính EmailClient.ConnectionAsgmtMode. Các kết nối này có thể được tạo thủ công với EmailClient.CreateConnection(createAsDefaultConnection = true) phương thức. Nếu kết nối mặc định không được sử dụng (phụ thuộc vào chế độ cấp phát kết nối), kết nối chính sẽ được sử dụng ngầm thay thế cho nó.
Independent connections: These are connections that are not linked to threads. They can be created manually and have to be used explicitly as a method parameter. These connections can be created manually with EmailClient.CreateConnection() phương thức hoặc EmailClient.CreateConnection(createAsDefaultConnection = false) phương thức.

Các loại cấp phát kết nối

Để thiết lập EmailClient.ConnectionAsgmtMode thuộc tính, ConnectionAsgmtType enumerable được sử dụng. Các loại cấp phát được cung cấp bởi ConnectionAsgmtType được liệt kê dưới đây.

ConnectionAsgmtType.UseMainOrDefault Chế độ này được sử dụng mặc định trong client email. Client email sử dụng kết nối chính cho tất cả các thao tác từ nhiều luồng nếu kết nối mặc định chưa được tạo, hoặc nếu một kết nối chưa được truyền làm tham số phương thức một cách rõ ràng. Kết nối chính là kết nối được tạo đồng thời với một client email. Người dùng có thể tạo kết nối mặc định cho các luồng với CreateConnection phương thức. Nếu kết nối mặc định cho một luồng được tạo, nó sẽ được sử dụng ngầm cho tất cả các phương thức của client email được gọi trong luồng này. Nếu kết nối mặc định cho một luồng không được tạo, kết nối chính được sử dụng cho tất cả các phương thức của client email được gọi trong luồng này. Người dùng cũng có thể tạo các kết nối không liên kết với luồng (không phải kết nối mặc định) bằng CreateConnection phương thức. Nếu người dùng muốn sử dụng các kết nối khác (không phải chính và không phải mặc định) họ phải truyền kết nối này một cách rõ ràng như tham số của phương thức mà họ muốn sử dụng. Người dùng có thể tạo thêm bất kỳ số lượng kết nối nào. Kết nối mặc định có thể chỉ một cho mỗi luồng. Lưu ý rằng các kết nối mặc định hoạt động chính xác nếu người dùng sử dụng các đối tượng Thread cho lập trình đa nhiệm. Nếu người dùng sử dụng ConnectionPool hoặc các đối tượng Task cho lập trình đa nhiệm, chế độ này có thể dẫn đến hành vi sai của ứng dụng. Để tránh vấn đề này, người dùng phải tự tay giải phóng kết nối mặc định (nếu họ sử dụng nó) vào cuối quá trình thực thi mã.
ConnectionAsgmtType.UseMain Client email sử dụng kết nối chính cho tất cả các thao tác từ nhiều luồng. Kết nối chính là kết nối được tạo đồng thời với client email. Người dùng không thể tạo kết nối mặc định. Người dùng có thể tạo các kết nối không liên kết với luồng (không phải kết nối mặc định) bằng CreateConnection phương thức. Nếu người dùng muốn sử dụng các kết nối khác (không phải chính và không phải mặc định) họ phải truyền kết nối này một cách rõ ràng như tham số của phương thức mà họ muốn sử dụng.
ConnectionAsgmtType.UseDefault Client email ngầm sử dụng chỉ các kết nối mặc định cho tất cả các thao tác từ nhiều luồng. Kết nối chính không được sử dụng trong chế độ này. Nếu kết nối mặc định chưa được tạo cho một luồng nào đó (lần gọi đầu tiên của phương thức client email), client email sẽ tạo kết nối mặc định ngầm cho luồng đó trước khi thao tác đầu tiên được thực thi. Người dùng không thể tạo kết nối mặc định cho các luồng với CreateConnectionphương thức vì chúng được tạo tự động. Khi kết nối mặc định cho một luồng được tạo, nó sẽ được sử dụng ngầm cho tất cả các phương thức của client email được gọi trong luồng này. Người dùng cũng có thể tạo các kết nối không liên kết với luồng (không phải kết nối mặc định) bằng CreateConnectionphương thức. Nếu người dùng muốn sử dụng các kết nối khác (không phải chính và không phải mặc định) họ phải truyền kết nối này một cách rõ ràng như tham số của phương thức mà họ muốn sử dụng. Người dùng có thể tạo thêm bất kỳ số lượng kết nối nào. Chỉ một kết nối mặc định có thể được sử dụng cho mỗi luồng. Lưu ý rằng các kết nối mặc định hoạt động chính xác nếu người dùng sử dụng các đối tượng Thread cho lập trình đa nhiệm. Nếu người dùng sử dụng ConnectionPool hoặc các đối tượng Task cho lập trình đa nhiệm, chế độ này có thể dẫn đến hành vi sai của ứng dụng. Để tránh vấn đề này, người dùng phải tự tay giải phóng kết nối mặc định vào cuối quá trình thực thi mã.

Java: Hỗ trợ thiết lập Locale cho Luồng hiện tại

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

Aspose.Email cung cấp khả năng thiết lập Locale cho luồng hiện tại. Aspose.Email cung cấp một lớp CurrentThreadSettings điều cung cấp setLocale phương thức cho mục đích này. Đoạn mã dưới đây minh họa việc sử dụng CurrentThreadSettings lớp để đặt Locale hiện tại. Đoạn mã ban đầu đặt Locale thành giá trị không hợp lệ và sau đó sử dụng CurrentThreadSettings.setLocale phương thức để đặt Locale cho luồng hiện tại.

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: Chi tiết quan trọng về iCalendar RFC 2445

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

Về mô hình đối tượng Aspose iCalendar

Aspose.Email chứa tất cả các lớp mà Aspose cung cấp iCalendar thành phần RecurrencePattern và RecurrenceRule là các lớp trung tâm của Aspose iCalendar, và cung cấp các triển khai cụ thể cho các phần tử RFC 2445 tương ứng.

Cái RecurrencePattern lớp đại diện cho toàn bộ mẫu lặp lại. Bạn có thể tạo một mẫu lặp lại mới từ đầu bằng cách sử dụng hàm khởi tạo mặc định hoặc tải một mẫu đã tồn tại trong CalendarRecurrence. Thuộc tính RecurrenceRule lớp đại diện cho phần RRULE hoặc EXRULE của một mẫu lặp lại. RecurrenceRule phơi bày một số thuộc tính trực tiếp ánh xạ tới các đối tượng tương ứng trong tiêu chuẩn iCalendar. Ví dụ, ByMonth ánh xạ tới BYMONTH trong iCalendar và các thuộc tính tương tự. Bằng việc kiểm tra hoặc thiết lập các giá trị của RecurrenceRule các thuộc tính mà bạn có thể phân tích hoặc sửa đổi một quy tắc lặp lại. Để biết thêm thông tin và các mẫu mã, xem RecurrencePattern và RecurrenceRule trong Tham chiếu API.

Chi tiết quan trọng iCalendar RFC 2445

Phần này bao gồm các chủ đề sau:

Định dạng Ngày và Giờ.
DATE.
DATE-TIME với Thời gian địa phương.
DATE-TIME với Thời gian UTC.
DATE-TIME với Thời gian địa phương và Múi giờ.
BYWEEKNO Cung cấp Tuân thủ ISO 8601

Định dạng Ngày và Giờ

Ngày, hoặc ngày kèm thời gian liên quan, có thể được sử dụng trong các phần tử DTSTART, UNTIL, EXDATE và RDATE khi chỉ định một mẫu lặp lại. iCalendar định nghĩa kiểu giá trị DATE để nhận diện các giá trị chứa ngày lịch và cũng định nghĩa kiểu DATE-TIME để nhận diện các giá trị chỉ định ngày lịch và thời gian trong ngày một cách chính xác. Các giá trị DATE-TIME có thể được chỉ định dưới ba dạng, với:

Thời gian địa phương.
Thời gian UTC.
Thời gian địa phương và múi giờ.

DATE

Theo tiêu chuẩn iCalendar, các giá trị DATE phải tuân theo định dạng yyyyMMdd. Ví dụ sau biểu thị ngày 14 tháng 7 năm 1997: 19970714

DATE-TIME với Thời gian địa phương

Ngày ở dạng thời gian địa phương chỉ đơn giản là một giá trị ngày‑giờ không chứa ký hiệu UTC và không tham chiếu đến múi giờ. Ví dụ, đoạn sau biểu thị ngày 18 tháng 1 năm 1998, lúc 23:00: DTSTART:19980118T230000. Các giá trị ngày‑giờ kiểu này được gọi là "floating" và không bị ràng buộc vào bất kỳ múi giờ nào cụ thể. Chúng được dùng để đại diện cho cùng một giá trị giờ, phút và giây bất kể múi giờ nào đang được áp dụng.

DATE-TIME với Thời gian UTC

Ngày có thời gian UTC, hoặc thời gian tuyệt đối, được xác định bằng một ký tự hậu tố Z (CHỮ HOA) Latin, biểu tượng UTC, được thêm vào giá trị thời gian. Ví dụ, đoạn sau biểu thị ngày 19 tháng 1 năm 1998, lúc 07:00 UTC: DTSTART:19980119T070000Z Lưu ý rằng Aspose iCalendar bỏ qua hậu tố Z định dạng UTC và coi thời gian là thời gian địa phương. Tiêu chuẩn RFC2445 quy định rằng phần thời gian được chỉ định trong quy tắc UNTIL của mẫu lặp lại phải ở định dạng UTC. Đây là một tuyên bố rất lạ, và thực tế, có những ví dụ trong tiêu chuẩn được tính toán sai. Aspose iCalendar chấp nhận thời gian ở bất kỳ định dạng nào trong quy tắc UNTIL.

DATE-TIME với Thời gian địa phương và Múi giờ

Để tham chiếu múi giờ, DATE-TIME được sửa đổi với thuộc tính TZID. Ví dụ, đoạn sau biểu thị 2 giờ sáng tại New York vào ngày 19 tháng 1 năm 1998: DTSTART;TZID=US-Eastern:19980119T020000. Lưu ý rằng Aspose iCalendar hiện tại bỏ qua tham số TZID và coi thời gian là thời gian địa phương.

BYWEEKNO Cung cấp Tuân thủ ISO 8601

Chỉ sử dụng BYWEEKNO khi tuân thủ với ISO 8601 được yêu cầu. Số tuần được định nghĩa theo ISO 8601 rất khác so với số tuần theo nghĩa thông thường. Theo ISO 8601, tuần số một của năm lịch là tuần đầu tiên của năm lịch có ít nhất bốn ngày. Quy tắc này làm cho thuật toán trở nên đặc thù cho các ứng dụng yêu cầu tuân thủ ISO 8601 và gần như không áp dụng cho các mục đích khác. ISO 8601 được một số ứng dụng ngân hàng và tài chính châu Âu hỗ trợ. Nó cũng được sử dụng trong truyền hình để đặt chỗ quảng cáo. Quy tắc BYWEEKNO xác định danh sách các số, ngăn cách bằng dấu phẩy, chỉ định các tuần của năm. Giá trị hợp lệ là 1 đến 53 và 1 đến 53. Điều này tương ứng với các tuần theo đánh số tuần được định nghĩa trong ISO 8601. BYWEEKNO chỉ hợp lệ cho các quy tắc YEARLY.

Java: Phân tích Tệp Tin Nhắn Microsoft Outlook

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

Với Aspose.Email, bạn có thể phân tích các tin Outlook chỉ bằng một vài dòng mã. Bài viết này chỉ cách thực hiện. Aspose.Email có các lớp để thực hiện nhiều tác vụ lập trình với tin Outlook. Ví dụ mã dưới đây cho thấy cách:

Tải một tin email.
Lấy tiêu đề email.
Lấy tên người gửi.
Lấy nội dung toàn bộ tin.
Kiểm tra xem có tệp đính kèm hay không.
Lấy tên tệp của các tệp đính kèm và lưu chúng.

Đoạn mã dưới đây cho bạn thấy cách phân tích các tệp tin tin nhắn 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: Nhận thông báo cho các tin nhắn đã gửi thành công và thất bại

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

Khi bạn muốn nhận thông báo giao hàng cho cả tin nhắn đã gửi thành công và thất bại, bạn có thể sử dụng toán tử pipe (|) cho DeliveryNotificationOptions thuộc tính của MailMessage lớp. Đoạn mã mẫu sau cho bạn thấy cách nhận thông báo cho các tin nhắn đã gửi thành công và thất bại.

// 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: Phát hiện Tin nhắn Email Mới trên Máy chủ POP3

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

Với tài khoản POP3, bạn có thể để lại các tin trên máy chủ khi tải xuống và đọc chúng. Việc để email trên máy chủ có nghĩa là chúng có sẵn cho các ứng dụng và cá nhân khác, ví dụ, người dùng truy cập email từ nhiều thiết bị. Hoặc bạn có thể muốn chỉ tải những tin đáp ứng tiêu chí đặc biệt, chẳng hạn như các tin có tiêu đề nhất định. Để quản lý email, bạn có thể;

Đọc tất cả các tin từ máy chủ thư POP3 bằng Aspose.Email.
Tải các tin vào cơ sở dữ liệu cục bộ của bạn.

Các tin không bị xóa mà vẫn ở trên máy chủ. Lần đầu chạy, quy trình này hoạt động tốt. Tất cả các tin cần thiết được tải xuống cơ sở dữ liệu. Nhưng lần thứ hai chạy, cùng các tin lại được tải vì chúng vẫn còn trên máy chủ email. Điều này gây ra bản ghi trùng lặp. Để giải quyết vấn đề này, sử dụng Pop3MessageInfo.UniqueID thuộc tính để kiểm tra xem một tin đã được tải xuống chưa. ID duy nhất của tin phải được lưu trong cơ sở dữ liệu: nó là khóa tìm kiếm để phát hiện tin mới.

Phát hiện Tin nhắn Mới

Để xác định email mới từ danh sách email trên máy chủ POP3:

Kết nối tới máy chủ.
Lấy danh sách email.
Kết nối đến cơ sở dữ liệu.
Lấy danh sách email.
So sánh các danh sách.
Lưu các email mới vào cơ sở dữ liệu.

Quá trình nhanh hơn khi bạn:

Lấy tất cả ID duy nhất của các tin nhắn vào bảng băm.
Tìm kiếm trong bảng băm thay vì cơ sở dữ liệu cho mỗi tin email trong vòng for(…)

Thay vì truy vấn cơ sở dữ liệu cho mỗi tin nhắn, đòi hỏi nhiều lần gọi cơ sở dữ liệu, phương pháp này chỉ cần một lần gọi. Đoạn mã dưới đây cho bạn thấy cách phát hiện các tin nhắn Email mới trên máy chủ 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: Đặt Mã hoá Văn bản Mặc định trong Tin Email

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

Bài viết này giới thiệu MailMessage.PreferredTextEncoding thuộc tính và giải thích cách sử dụng. Bằng thuộc tính này, bạn có thể đặt mã hoá văn bản mặc định cho các thuộc tính sau:

Từ: Tên hiển thị
Đến: Tên hiển thị
Tiêu đề
Nội dung

Đặt Mã hoá Văn bản Mặc định

Trong các phiên bản trước của Aspose.Email, mã hoá văn bản cho các thuộc tính from, to, subject và body được đặt riêng biệt. Để cải thiện tính tiện dụng, chúng tôi đã thêm PreferredTextEncoding thuộc tính cho phép đặt tất cả cùng một lúc. Giờ đây dễ dàng hơn để đảm bảo rằng toàn bộ văn bản trong các thuộc tính trên được mã hoá đúng trong tin email. Đoạn mã dưới đây cho bạn thấy cách sử dụng một từ tiếng Pháp làm tên hiển thị cho địa chỉ email, tiêu đề và nội dung.

// 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: Chuyển đổi tệp tin Outlook Message (MSG) sang ảnh TIFF

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

Chuyển đổi tệp Outlook MSG sang ảnh TIFF không được hỗ trợ trong Aspose.Email cho Java.

Java: Sử dụng tài liệu Microsoft Word làm nội dung tin nhắn và gửi email

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

Bài viết này hướng dẫn bạn cách sử dụng tài liệu Microsoft Word làm phần nội dung email và gửi nó tới người nhận. Tài liệu mẫu là một hoá đơn bán hàng từ mẫu cơ sở dữ liệu Northwind, được xuất sang định dạng Microsoft Word. Aspose.Email cho Java xử lý các giao thức mạng và các tính năng của Microsoft Outlook và không thể xử lý tài liệu Microsoft Word. Để khắc phục, các mẫu trong bài viết này sử dụng Aspose.Words cho Java để tải tài liệu Word và chuyển đổi nó sang định dạng MHTML. Aspose.Email cho Java sử dụng tài liệu MHTML trong nội dung email.

Sử dụng tài liệu Microsoft Word làm nội dung email

Các mẫu lập trình dưới đây minh họa cách gửi tài liệu Word làm nội dung email bằng Aspose.Words cho Java và Aspose.Email cho Java:

Tải tài liệu Microsoft Word bằng Aspose.Word cho Java’s Document lớp.
Lưu nó ở định dạng MHTML.
Tải tài liệu MHTML bằng Aspose.Email cho Java’s MailMessage lớp để đặt nội dung email.
Đặt các thuộc tính tin nhắn khác bằng cách sử dụng các MailMessage các thuộc tính và phương thức của lớp.
Gửi email bằng Aspose.Email cho Java’s SMTPClient lớp.

Tài liệu nguồn, một hoá đơn bán hàng đã được xuất sang Microsoft Word từ mẫu Microsoft Northwind có thể xem ở dưới.

Khi tin nhắn đã được gửi và nhận trong Microsoft Outlook, nó trông giống như tin nhắn dưới đây.

Định dạng HTML và hình ảnh được giữ nguyên như trong tài liệu nguồn gốc khi xem trong Outlook hoặc trình khách email web như Gmail hay Hotmail. Dưới đây là ảnh chụp màn hình của tin nhắn khi mở bằng Gmail trên trình duyệt Chrome.

Đoạn mã dưới đây cho bạn thấy cách sử dụng tài liệu Microsoft Word làm nội dung tin nhắn và gửi email bằng cách sử dụng SmtpClient đối tượng lớp.

// 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: Tính năng In ấn của Aspose.Email

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

Tính năng In ấn

Tính năng In ấn không được hỗ trợ trong Aspose.Email cho Java.

Java: Tạo các lần lặp lại từ Mẫu Lặp lại

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

Với Aspose.Email, có thể tạo các lần xuất hiện bằng cách sử dụng mẫu lặp lại. Bài viết này giải thích cách, cách thực hiện tạo lần xuất hiện tiếp theo và lấy mô tả mục thân thiện với người dùng. Các lần xuất hiện từ mẫu lặp lại lịch MAPI có thể được tạo bằng Aspose.Email. Đoạn mã dưới đây cho bạn thấy cách tạo các lần xuất hiện từ các mẫu lặp lại.

Tính lần xuất hiện tiếp theo hoặc n lần xuất hiện tiếp theo

Để lấy lần xuất hiện "tiếp theo", sử dụng phương thức GenerateOccurrences với tham số nNextOccurrences = 1. Đoạn mã dưới đây cho bạn thấy cách tạo 20 lần xuất hiện bằng cách sử dụng nNextOccurrences = 20. Kết quả của đoạn mã dưới đây như sau:

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

Lấy Văn bản Thân thiện với Người dùng cho Lặp lại

Văn bản thân thiện với người dùng cho một quy tắc có thể được lấy bằng cách sử dụng thuộc tính FriendlyText như dưới đây. Kết quả của mã sẽ là: "Lặp lại mỗi tháng vào ngày 1 và ngày 1 tính từ cuối ngày của tháng, tối đa 2 lần lặp lại.". Đoạn mã sau cho bạn thấy cách lấy văn bản thân thiện với người dùng cho một chu kỳ lặp lại.

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: Truy cập Dịch vụ Mail bằng OAuth

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

Hỗ trợ OAuth 2.0 đã được thêm vào Aspose.Email và có thể được sử dụng để truy cập các máy chủ SMTP, POP3, IMAP và EWS. Nói chung, tất cả các máy chủ hỗ trợ token bearer OAuth 2.0 có thể được sử dụng với Aspose.Email, nhưng các client email của chúng tôi đã được kiểm tra với máy chủ thư của Google và Microsoft Office 365. Truy cập máy chủ từ SmtpClient, Pop3Client, ImapClient và EWSClient với OAuth có thể được triển khai theo 2 cách.

Cung cấp token truy cập trực tiếp vào hàm khởi tạo của client email. Trong trường hợp này, người dùng phải hiểu rằng thời gian sống của token truy cập có giới hạn. Khi token hết hạn, client email không thể được sử dụng để truy cập máy chủ.
Cung cấp một triển khai tùy chỉnh của nhà cung cấp token dựa trên ITokenProvider giao diện vào hàm khởi tạo của client email. Trong trường hợp này, client sẽ kiểm tra thời gian hết hạn token và yêu cầu ITokenProvider để lấy token truy cập mới khi token trước đó đã hết hạn. Bằng cách này, client sẽ làm mới token định kỳ và có thể làm việc với máy chủ vô thời hạn. Thông thường các dịch vụ hỗ trợ một cách đơn giản để làm mới token truy cập. Ví dụ, sử dụng refresh token trong các dịch vụ của Google hoặc luồng xác thực ROPC trong nền tảng nhận diện của Microsoft có thể được dùng cho việc triển khai nhà cung cấp token.

Cấu hình tài khoản trên máy chủ phù hợp

Các bài viết sau sẽ giúp bạn cấu hình tài khoản để truy cập dịch vụ thư.

Cho Office 365
Cho Gmail

Truy cập Dịch vụ Thư với Token Truy cập

Các ví dụ mã sau cho bạn thấy cách kết nối tới dịch vụ thư bằng token truy cập.

// 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)) {

}

Truy cập Dịch vụ Thư với Các Nhà cung cấp Token

Các ví dụ mã sau cho bạn thấy cách kết nối tới dịch vụ thư bằng một nhà cung cấp token.

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

}

Triển khai ITokenProvider tùy chỉnh cho Office 365

Bạn có thể sử dụng triển khai nhà cung cấp token dưới đây để truy cập các dịch vụ thư của 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();
    }
}

Các ví dụ mã sau sẽ cho bạn thấy cách kết nối tới các dịch vụ Office 365 bằng cách sử dụng nhà cung cấp token tùy chỉnh.

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: Sử dụng OAuth để truy cập Dịch vụ Thư

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

Cung cấp token truy cập trực tiếp vào hàm khởi tạo của client email. Trong trường hợp này, người dùng phải hiểu rằng thời gian sống của token truy cập có giới hạn. Khi token hết hạn, client email không thể được sử dụng để truy cập máy chủ.
Cung cấp một triển khai tùy chỉnh của nhà cung cấp token dựa trên ITokenProvider giao diện vào hàm khởi tạo của client email. Trong trường hợp này, client sẽ kiểm tra thời gian hết hạn token và yêu cầu ITokenProvider để lấy token truy cập mới khi token trước đó đã hết hạn. Bằng cách này, client sẽ làm mới token định kỳ và có thể làm việc với máy chủ vô thời hạn. Thông thường các dịch vụ hỗ trợ một cách đơn giản để làm mới token truy cập. Ví dụ, sử dụng refresh token trong các dịch vụ của Google hoặc luồng xác thực ROPC trong nền tảng nhận diện của Microsoft có thể được dùng cho việc triển khai nhà cung cấp token.

Cấu hình tài khoản trên máy chủ phù hợp

Các bài viết sau sẽ giúp bạn cấu hình tài khoản để truy cập dịch vụ thư.

Cho Office 365
Cho Gmail

Truy cập Dịch vụ Thư với Token Truy cập

Các ví dụ mã sau cho bạn thấy cách kết nối tới dịch vụ thư bằng token truy cập.

// 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)) {

}

Truy cập Dịch vụ Thư với Các Nhà cung cấp Token

Các ví dụ mã sau cho bạn thấy cách kết nối tới dịch vụ thư bằng một nhà cung cấp token.

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

}

Triển khai ITokenProvider tùy chỉnh cho Office 365

Bạn có thể sử dụng triển khai nhà cung cấp token dưới đây để truy cập các dịch vụ thư của 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();
    }
}

Các ví dụ mã sau sẽ cho bạn thấy cách kết nối tới các dịch vụ Office 365 bằng cách sử dụng nhà cung cấp token tùy chỉnh.

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

}

Quyền truy cập Office 365 qua IMAP, POP3 hoặc SMTP

Chúng ta cần áp dụng các quyền API đúng và cấp đồng ý của quản trị viên để truy cập các dịch vụ thư của Office 365:

Trong trình hướng dẫn Quyền API / Thêm quyền, chọn Microsoft Graph và sau đó Quyền ủy thác để tìm các phạm vi quyền được liệt kê sau:

offline_access
IMAP.AccessAsUser.All
POP.AccessAsUser.All
SMTP.Send

Ví dụ về nhà cung cấp Token:

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: Trích xuất dữ liệu Đối tượng Nhúng

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

Đôi khi dữ liệu OLE nhúng được biểu diễn dưới dạng tệp đính kèm "oleData.mso" bởi MapiAttachment và cần được trích xuất thủ công. Các tệp oleData.mso này là định dạng Microsoft Computer Document File (MCDF) và việc hỗ trợ các tệp như vậy vượt quá phạm vi của Aspose.Email. Tuy nhiên, Aspose.Email có thể được sử dụng kết hợp với các thư viện mã nguồn mở khác, chẳng hạn như OpenMCDF, để đọc nội dung của các tệp này và lưu vào đĩa. Aspose.Email cung cấp the InlineAttachmentExtractor lớp để liệt kê các gói MSO từ dữ liệu nhị phân của oledata.mso, sau đó có thể được dùng để trích xuất nội dung bằng các thư viện đọc Compound Files.

Nếu loại nội dung tin là HTML (không phải RTF), và có các đối tượng OLE trong tin, thuộc tính MapiPropertyTag.PR_ATTACH_DATA_OBJ sẽ không tồn tại. Trong trường hợp này, thông tin về các đối tượng OLE được chứa trong oldedata.mso.

Trích xuất Đối tượng Nhúng

Bài viết này chỉ cách trích xuất nội dung từ tệp như vậy bằng 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: Gửi yêu cầu họp với lặp lại

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

Với Aspose.Email, có thể tạo một yêu cầu họp có lặp lại. Bài viết này giải thích cách tạo một yêu cầu họp với lịch lặp lại cụ thể. ID duy nhất của cuộc hẹn có thể được lưu để sử dụng sau này khi gửi bất kỳ cập nhật nào cho cuộc hẹn.

Tạo Yêu cầu Họp với Lặp lại

Mẫu mã dưới đây cho thấy cách thực hiện điều này.

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;

Gửi Yêu cầu Cập nhật Cuộc hẹn

Để gửi cập nhật cho cuộc hẹn trước, cần có ID duy nhất. Mã mẫu dưới đây cho thấy cách gửi yêu cầu cập nhật cuộc hẹn này

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: Hỗ trợ đa luồng trong các client email

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

Các client email như ImapClient và Pop3Client cho phép người dùng sử dụng chúng trong môi trường đa luồng. Các client email cho phép có một hoặc nhiều kết nối với máy chủ. Để quản lý một tập hợp các kết nối bên trong client, sử dụng pool kết nối. Số lượng kết nối có thể tạo và sử dụng đồng thời bị giới hạn bởi thuộc tính CredentialsByHostClient.MaxConnectionsPerServer. Thuộc tính này có thể đặt thành 1 hoặc giá trị lớn hơn. Mặc định thuộc tính này bằng 10. Hàng đợi lệnh đã được triển khai cho kết nối để hỗ trợ các thao tác đa luồng. Các lệnh thực hiện các thao tác đơn giản được định nghĩa trong giao thức, như Noop, Authenticate, v.v. Người dùng có thể bắt đầu thực thi số lượng lệnh lớn hơn số lượng kết nối khả dụng. Nhưng các lệnh chỉ được thực thi khi client có thể tạo kết nối cho thao tác đó.

Phương pháp sử dụng client email trong môi trường đa luồng

Các client email có hành vi sau:

1. Khi MaxConnectionsPerServer = 1, client tạo 1 kết nối, thực hiện xác thực và ủy quyền. Kết nối này duy trì ở trạng thái hoạt động cho đến khi client được giải phóng. Tất cả các thao tác từ các luồng khác nhau được đưa vào một hàng đợi lệnh đặt trong kết nối chính.

2. Khi MaxConnectionsPerServer > 1, client tạo số lượng kết nối cần thiết, thực hiện xác thực và ủy quyền cho mỗi kết nối. Một kết nối được dành làm kết nối chính. Kết nối này được duy trì ở trạng thái hoạt động cho đến khi client được giải phóng. Tất cả các kết nối khác được tạo và giải phóng theo yêu cầu. Số lượng tối đa của các kết nối như vậy được xác định bởi thuộc tính MaxConnectionsPerServer, ví dụ nếu MaxConnectionsPerServer = 2 thì một kết nối được dành làm kết nối chính, và kết nối thứ hai được dùng làm bổ sung cho các thao tác thực hiện trong các luồng khác. Tương tự, nếu MaxConnectionsPerServer = 3 thì kết nối đầu tiên là kết nối chính, và hai kết nối còn lại được dùng làm bổ sung cho các thao tác thực hiện trong các luồng khác. Trong trường hợp có yêu cầu kết nối tiếp theo từ luồng mới, và tất cả các kết nối đã được sử dụng, client sẽ chờ cho đến khi số lượng kết nối đang dùng giảm xuống. Đây là một điểm quan trọng giải thích tại sao việc giải phóng kết nối đúng cách lại rất quan trọng.

Ví dụ

Người dùng có thể thực hiện các hoạt động trong các luồng khác nhau theo một số cách. Chúng có thể được chia thành hai loại:

1. Người dùng sử dụng các phương thức bất đồng bộ (Begin/End) được định nghĩa trong client. Trong trường hợp này client email khởi chạy các luồng mới khi cần thiết. Trong client được triển khai hàng đợi tác vụ (xin đừng nhầm lẫn với hàng đợi lệnh trong kết nối). Tác vụ có thể được thực thi nếu có kết nối khả dụng. Khi số lượng kết nối đã sử dụng giảm xuống dưới giá trị giới hạn, client tạo kết nối mới, tạo luồng cho tác vụ hiện tại và thực thi tác vụ này. Ví dụ về việc sử dụng các hoạt động bất đồng bộ:

// 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. Người dùng có thể tạo các luồng sử dụng các đối tượng như Thread, ExecutorService hoặc bất kỳ đối tượng nào khác cho mục đích này. Người dùng cũng có thể sử dụng các luồng được tạo trong mã của bên thứ ba. Trong trường hợp này client có hai mô hình hành vi

a. Nếu người dùng không tạo các kết nối bổ sung cho các hoạt động trong luồng, tất cả các hoạt động cho luồng này sẽ được gửi vào hàng đợi lệnh tới kết nối chính. Một ví dụ về các hoạt động trong một luồng phụ mà không tạo kết nối mới, tất cả giao dịch đều được thực hiện qua kết nối chính:

/**
 * 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. Khi người dùng gọi phương thức để tạo kết nối mới cho luồng phụ, luồng này bị chặn cho đến khi giá trị hạn ngạch cho các kết nối mới được thay đổi để cho phép kết nối mới. Sau đó kết nối mới được tạo. Kết nối này được đặt làm kết nối mặc định cho tất cả các hoạt động trong luồng này. Khi tất cả các hoạt động trong luồng này hoàn thành, phải giải phóng kết nối. Để tạo kết nối mới, sử dụng phương thức CredentialsByHostClient.CreateConnection. Phương thức này trả về một đối tượng triển khai giao diện IDisposable. Để giải phóng kết nối, phải gọi phương thức Dispose. Việc tạo và giải phóng kết nối phải được thực hiện trong luồng mà các hoạt động mail được thực hiện. Cố gắng tạo kết nối mới trong luồng mà client mail đã được tạo sẽ dẫn đến lỗi, vì luồng này tại thời điểm đó không thể được dùng để tạo kết nối mới. Ngoài ra, việc tạo kết nối mới không khả thi khi MaxConnectionsPerServer = 1. Một ví dụ mã cho việc tạo kết nối mới trong luồng phụ:

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

Khuyến nghị

Cần lưu ý rằng nếu người dùng gửi tất cả lệnh tới kết nối chính, có thể xảy ra tình huống các lệnh từ các luồng khác nhau bị trộn lẫn. Người dùng nên hiểu lệnh nào phụ thuộc vào thứ tự của chúng và thực hiện các biện pháp đồng bộ cho những lệnh như vậy. Cũng cần xem xét khả năng thực thi lệnh trong các phiên khác nhau (IMAP/POP3). Các thao tác tốn thời gian nhất, như FetchMessage, AppendMessage và Send, có thể thực hiện bằng luồng mới và kết nối mới. Nhưng các thao tác nhanh như Delete nên thực hiện bằng kết nối chính. Lưu ý rằng việc khởi tạo kết nối mới là thao tác tốn thời gian đáng kể.

Java: Giới thiệu và Ứng dụng mẫu

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

Kịch bản sử dụng Aspose.Email Mail

Bài viết này gợi ý một số cách sử dụng Aspose.Email cho Java, đặc biệt tập trung vào các tính năng lập trình email của thành phần.

Phần mềm bản tin

API Aspose.Email Mail có thể được dùng để tạo một ứng dụng bản tin mạnh mẽ. Nhờ hỗ trợ thêm các đối tượng nhúng (như hình ảnh, âm thanh, v.v.) của Aspose.Email, có thể tạo bản tin HTML phong phú kèm đầy đủ hình ảnh (và các đối tượng nhúng khác). Nhờ tính năng gửi thư hàng loạt của API Aspose.Email Mail, cũng có thể gửi một lượng lớn email trong thời gian ngắn. Aspose.Email Mail còn cung cấp tính năng mail merge dựa trên mẫu, cho phép tạo mẫu bản tin. Mẫu bản tin này có thể được sử dụng để thực hiện mail merge và gửi bản tin hàng loạt. Có nhiều tác vụ khác mà Aspose.Email Mail có thể thực hiện trong một ứng dụng marketing email.

Công cụ Marketing khác

Tương tự như các ứng dụng bản tin, nhiều loại phần mềm khác có thể được xây dựng bằng Aspose.Email Mail. Sử dụng nó để xây dựng marketing email, công cụ gửi thư hàng loạt và chiến dịch e‑campaign, và hơn nữa.

Ứng dụng doanh nghiệp

Aspose.Email Mail có thể được sử dụng trong hầu hết các loại ứng dụng doanh nghiệp để thực hiện các tác vụ tiện ích:

Cảnh báo email: Gửi cảnh báo email để thông báo cho người dùng về các hoạt động.
Yêu cầu họp: Gửi yêu cầu họp doanh nghiệp bằng hỗ trợ iCalendar của Aspose.Email Mail.
Báo cáo định kỳ qua email: Báo cáo là phần không thể thiếu trong hầu hết các ứng dụng doanh nghiệp. Nhiều báo cáo doanh nghiệp được tạo theo thời gian. Sử dụng Aspose.Email Mail để gửi email báo cáo định kỳ.

Khách hàng Email

Aspose.Email Mail cũng có thể được sử dụng trong các ứng dụng khách email để gửi email thông thường. Nó hỗ trợ tệp đính kèm, đối tượng nhúng, sự kiện iCalendar, mail merge, gửi email hàng loạt, v.v., vì vậy Aspose.Email Mail là lựa chọn tốt nhất để tạo ứng dụng khách email.

Ứng dụng mẫu Aspose.Email Mail

Để minh họa cách sử dụng Aspose.Email Mail, chúng tôi sẽ tạo một ứng dụng thể hiện cách tạo một tin nhắn email với Lớp MailMessage và sau đó gửi nó bằng lớp SmtpClient.

Mail : Các bước ứng dụng mẫu

Vui lòng làm theo các bước dưới đây để tạo ứng dụng sử dụng Aspose.Email.

Thiết kế ứng dụng của bạn: tạo giao diện nhận ba trường: From, To và Message.
Nhấp đúp vào nút Send trong chế độ thiết kế và viết mã của bạn trong trình soạn thảo.
Tạo một đối tượng của lớp MailMessage và sử dụng các thuộc tính của nó để tạo một tin nhắn email. (Các đối tượng của lớp MailMessage được dùng để tạo tin nhắn email được truyền tới máy chủ SMTP để giao bằng lớp SmtpClient).
Tạo một đối tượng của lớp SmtpClient và sử dụng các thuộc tính của nó để gửi một tin nhắn email.
Kiểm tra Ứng dụng của bạn.
Nhập địa chỉ vào các trường From và To.
Nhập tin nhắn vào trường Message Body.
Nhấn Send.

Các bước trên được mô tả dưới đây: nhấp đúp vào nút Send trong chế độ thiết kế và thêm đoạn mã sau:

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

Khi kết nối tới máy chủ hỗ trợ SSL, chúng ta cần đặt các thuộc tính đối tượng SMTPClient sau

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

Kết luận

Aspose.Email Mail là một thành phần rất mạnh mẽ cho phép các nhà phát triển thực hiện hầu hết các nhiệm vụ liên quan đến email, như gửi email hàng loạt đa luồng, sử dụng mail merge, thêm tệp đính kèm, nhúng hình ảnh và âm thanh vào tin nhắn email, thêm sự kiện iCalendar vào email, nhận email và nhiều hơn nữa.

Aspose.Email Pop3

Aspose.Email Pop3 triển khai Giao thức Bưu điện phiên bản 3 (POP3) trên Java. Nó cho phép các nhà phát triển Java thêm các tính năng truy vấn và nhận email vào ứng dụng Java của họ mà không cần tham gia vào chi tiết giao thức và độ phức tạp của lập trình email và mạng. Aspose.Email Pop3 hỗ trợ tất cả các lệnh được định nghĩa trong giao thức POP3 tiêu chuẩn, và cung cấp các giao diện dễ sử dụng cùng với mô hình đối tượng gọn nhẹ và trực quan. Nó giảm đáng kể độ khó học cho các nhà phát triển Java.

Pop3 : Tính năng chính

Là một phần của Aspose.Email, Aspose.Email Pop3 được thiết kế đặc thù cho Java và được viết bằng mã Java quản lý. Nó cho phép bạn:

Kết nối và đăng nhập vào các máy chủ POP3.
Hỗ trợ APOP.
Truy vấn tin nhắn.
Lấy tin nhắn.
Hoàn toàn hỗ trợ kiểu lập trình bất đồng bộ.
Hỗ trợ SSL.

Kịch bản Aspose.Email Pop3

Aspose.Email Pop3 có thể được các nhà phát triển sử dụng trong nhiều kịch bản khác nhau. Dưới đây, chúng tôi chia sẻ một vài ví dụ.

Tự động hóa Email doanh nghiệp

Aspose.Email Pop3 có thể được sử dụng để truy vấn hộp thư đến và lấy các tin nhắn email. Nó hoạt động liền mạch với thành phần gửi email, Aspose.Email Mail. Aspose.Email hỗ trợ hoàn toàn tự động hoá email. Gửi tin nhắn email bằng Aspose.Email Mail và lấy tin nhắn bằng Aspose.Email Pop3. Các tin nhắn email đã tải về sau đó có thể được phân tích bởi Aspose.Email Mime.

Khách hàng Email

Aspose.Email Pop3 có thể được sử dụng trong các ứng dụng khách email để nhận thư.

Pop3 : Ứng dụng mẫu

Ở đây, chúng tôi sẽ trình bày cách sử dụng Aspose.Email Pop3. Lớp này có nhiều tính năng nhưng chúng tôi sẽ tập trung vào cách kết nối tới máy chủ POP3 và lấy tin nhắn. Ví dụ cho thấy cách tạo một ứng dụng cũng như mã nguồn để ứng dụng hoạt động. Thực hiện các bước dưới đây để tạo một ứng dụng mẫu sử dụng Aspose.Email Pop3.

Tạo một đối tượng Pop3Client.
Đặt tên máy chủ POP3, tên đăng nhập và mật khẩu trong đối tượng này.
Tạo một đối tượng MailMessage và lấy email đầu tiên trong tài khoản của bạn vào nó bằng cách gọi hàm fetchMessage(). Điều này sẽ đưa tin nhắn đầu tiên từ tài khoản email của bạn vào đối tượng MailMessage.
Sử dụng các thuộc tính From, Subject và HtmlBody của đối tượng MailMessage để xem người gửi, tiêu đề và nội dung của tin nhắn.

Các bước trên được minh họa trong các ví dụ mã dưới đây.

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

Đối với các máy chủ hỗ trợ SSL, chúng ta cần thay đổi các thuộc tính sau của đối tượng Pop3Client:

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

Aspose.Email Imap

Aspose.Email Imap triển khai giao thức Internet Message Access Protocol (IMAP) trên Java. Aspose.Email Imap cho phép các nhà phát triển Java thêm khả năng IMAP vào ứng dụng Java của họ một cách nhanh chóng, mà không cần hiểu chi tiết giao thức. Thành phần hỗ trợ lấy và tải lên tin nhắn, kiểm tra trạng thái mới/đã đọc/chưa đọc của tin nhắn, v.v.

Imap : Tính năng chính

Aspose.Email Imap cho phép bạn:

Lấy các tin nhắn email.
Tải lên các tin nhắn email.
Liệt kê các tin nhắn email trong các thư mục khác nhau.
Kiểm tra trạng thái của các tin nhắn email.
Làm việc với MailMessage.
Làm việc với hỗ trợ SSL.

Sử dụng Aspose.Email Imap

Aspose.Email Imap triển khai giao thức Internet Message Access Protocol trên Java. Với nó, các nhà phát triển có thể dễ dàng truy vấn và quản lý email trên máy chủ IMAP, đồng thời tạo, xóa hoặc đổi tên các thư mục email. Sử dụng Aspose.Email Imap, các nhà phát triển có thể tận dụng giao thức IMAP với các API dễ sử dụng. Họ có thể truy cập email từ bất kỳ máy tính nào vì email vẫn được lưu trên máy chủ. Sử dụng Aspose.Email Imap, các nhà phát triển có thể tạo các ứng dụng web hoặc desktop để nhận và thao tác với email từ máy chủ IMAP. Aspose đã triển khai giao thức IMAP theo các tiêu chuẩn xác thực internet và RFC. Do đó, Aspose.Email Imap là một triển khai an toàn và đầy đủ tính năng của giao thức IMAP với mô hình đối tượng và giao diện dễ hiểu.

Imap : Ứng dụng mẫu

Bài viết này giải thích cách sử dụng Aspose.Email Imap. Chúng tôi tạo một ứng dụng nhỏ để lấy số lượng tin nhắn email trong tài khoản IMAP của bạn. Thực hiện các bước dưới đây để tạo một ứng dụng mẫu sử dụng Aspose.Email Imap.

Tạo một thể hiện ImapClient bằng cách truyền tên máy chủ IMAP, tên đăng nhập và mật khẩu.
Gọi hàm selectFolder() của thể hiện ImapClient để chọn thư mục mà bạn muốn đếm số lượng tin nhắn.
Bây giờ gọi thuộc tính CurrentFolder.TotalMessageCount của thể hiện ImapClient để lấy số lượng tin nhắn email.

Imap : Ví dụ mã

Các ví dụ mã dưới đây cho thấy cách thực hiện các bước đã mô tả ở trên với 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);
}

Đối với các máy chủ email hỗ trợ SSL, thiết lập các thuộc tính sau của đối tượng ImapClient:

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

Aspose.Email Exchange

Aspose.Email Exchange Cho phép các nhà phát triển quản lý email trên Microsoft Exchange Server. Sử dụng thành phần này, bạn có thể kết nối, liệt kê tin nhắn và tải xuống email từ hộp thư của Exchange Server mà không cần hiểu chi tiết giao thức bên dưới. Thành phần hỗ trợ liệt kê tin nhắn, gửi email, tải xuống tin nhắn và lưu dưới định dạng eml hoặc msg trên đĩa cục bộ, v.v.

Exchange : Tính năng chính

Aspose.Email Exchange cho phép bạn:

Kết nối tới các máy chủ Microsoft Exchange.
Liệt kê các tin nhắn email trong hộp thư Exchange.
Liệt kê các tin nhắn email từ các thư mục khác nhau, ví dụ: Inbox, Sent, Deleted hoặc Drafts.
Xóa tin nhắn trong bất kỳ thư mục nào trên Exchange Server.

Sử dụng Aspose.Email Exchange

Với Aspose.Email Exchange, các nhà phát triển có thể truy cập hộp thư Exchange Server từ các ứng dụng Java của họ. Nó cung cấp một API dễ sử dụng để quản lý email trên các máy chủ Exchange. Các nhà phát triển có thể tạo các ứng dụng console, desktop hoặc web để quản lý email trong hộp thư Exchange.

Ứng dụng mẫu Aspose.Email Exchange

Bài viết này trình bày cách sử dụng Aspose.Email Exchange. Chúng tôi tạo một ứng dụng máy tính để bàn đơn giản kết nối tới hộp thư Exchange Server, lấy danh sách tin nhắn trong thư mục Inbox và hiển thị chúng trên biểu mẫu Windows.

Exchange : Các bước Ứng dụng mẫu

Để chạy ứng dụng thành công, bạn cần có thông tin đăng nhập đúng để truy cập Exchange Server. Ở đây, chúng tôi lấy thông tin xác thực - URI của Exchange Server, tên người dùng, mật khẩu và miền - từ biểu mẫu Windows. Đây là một mẫu rất cơ bản nên các thuộc tính của tin nhắn - chủ đề, người gửi và người nhận - chỉ được hiển thị đơn giản trong listbox.

Exchange : Ví dụ mã

Thêm đoạn mã sau vào trình xử lý sự kiện click của nút 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 : Kết quả

Ảnh chụp màn hình này hiển thị các tin nhắn được lấy từ Exchange Server. Phương thức listMessages() trả về thông tin cơ bản như chủ đề, người gửi, người nhận và ID tin nhắn. Để lấy toàn bộ tin nhắn, gọi phương thức IEWSClient.fetchMessage(). (Cách sử dụng IEWSClient.fetchMessage() được mô tả trong bài viết Làm việc với Hộp thư và Tin nhắn Exchange.)

Aspose.Email Mime

Multipurpose Internet Mail Extensions (MIME) là một tiêu chuẩn Internet mở rộng định dạng email để hỗ trợ văn bản trong các bộ ký tự khác ngoài US-ASCII, tệp đính kèm không phải văn bản, nội dung tin nhắn đa phần và thông tin tiêu đề trong các bộ ký tự không phải ASCII. Aspose.Email Mime triển khai giao thức MIME trên Java. Nó hoạt động như một trình dịch vì có thể đọc email từ tệp (.eml, v.v.) hoặc từ bộ nhớ (chuỗi). Sau đó nó phân tích tệp hoặc chuỗi email thành các phần có ý nghĩa. Nếu bạn muốn duyệt qua một tệp email mà không phải lo lắng về chi tiết giao thức MIME, ví dụ để trích xuất tệp đính kèm từ email, hãy sử dụng Aspose.Email Mime.

Tính năng chính

Aspose.Email Mime hoạt động hoàn hảo với Aspose.Email Pop3 và Aspose.Email Mail.

Aspose.Email Pop3 lấy các tin nhắn email từ một hộp thư đã chỉ định.
Aspose.Email Mail gửi tin nhắn email tới một hộp thư đã chỉ định.
Aspose.Email Mime là phần nối của hai phía trên, và phân tích các tin nhắn email.

Java: Hủy Yêu cầu Họp bằng Lịch

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

Bạn có thể gửi yêu cầu hủy họp bằng Aspose.Email sử dụng đối tượng lớp Appointment. Bạn cần có thông tin yêu cầu họp gốc để hủy. Ví dụ trong bài này đầu tiên gửi yêu cầu họp, lưu thông tin vào cơ sở dữ liệu và sau đó hủy yêu cầu dựa trên ID tin nhắn.

Gửi Yêu cầu Họp

Trước khi chúng ta có thể hủy yêu cầu họp, chúng ta cần gửi một vài cái:

Đầu tiên tạo một đối tượng kiểu SmtpClient để gửi tin nhắn.
Lưu toàn bộ thông tin người tham dự vào bộ sưu tập MailAddressCollection.
Tạo một đối tượng của lớp MailMessage và các thuộc tính cần thiết như From, To và Subject.
Tạo một đối tượng kiểu Appointment và cung cấp thông tin địa điểm, thời gian bắt đầu, thời gian kết thúc, người tổ chức và người tham dự.
Lưu tất cả thông tin vào cơ sở dữ liệu. Các công việc liên quan đến DB được thực hiện trong phương thức SaveIntoDB.

Đoạn mã sau cho bạn cách gửi yêu cầu họp.

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

Hủy Yêu cầu Họp

Để hủy yêu cầu họp, trước tiên lấy ID tin nhắn email. Vì chúng tôi đã lưu thông tin này trong cơ sở dữ liệu cho ví dụ này, nên có thể dễ dàng lấy lại.

Chọn tin nhắn để gửi yêu cầu hủy.
Nhấn Send Cancel Request để gửi yêu cầu.
Truy vấn cơ sở dữ liệu để lấy thông tin người tham dự, tin nhắn và lịch.
Tạo các đối tượng của lớp Calendar và lớp MailMessage bằng thông tin lấy từ cơ sở dữ liệu.
Sử dụng phương thức Appointment.cancelAppointment() để gửi yêu cầu hủy.
Gửi email bằng SMTP.

Đoạn mã sau cho bạn cách hủy yêu cầu họp.

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: Ứng dụng đầu tiên với Aspose.Email Outlook

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

Phần này trình bày cách sử dụng Aspose.Email Mapi. Chúng ta tạo một ứng dụng nhỏ tải tệp tin tin nhắn outlook (TestMessage.msg) và hiển thị tiêu đề, địa chỉ người gửi và người nhận, cùng nội dung. Thực hiện các bước sau để tạo ứng dụng đầu tiên của bạn bằng Aspose.Email Outlook.

Tạo một đối tượng của MapiMessage lớp bằng cách cung cấp đường dẫn tới tệp tin tin nhắn.
Sử dụng các thuộc tính công cộng để hiển thị tiêu đề, người gửi, người nhận và nội dung.

Cài đặt các bước trên được trình bày dưới đây trong đoạn mã mẫu.

// 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: Cách bỏ qua ngoại lệ

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

Hỗ trợ Bỏ qua Ngoại lệ

ExceptionManager lớp cung cấp khả năng bỏ qua ngoại lệ:

Ví dụ mã:

Đặt callback để xử lý ngoại lệ:

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

Hoặc sử dụng một phương án thay thế:

//Ignore all exceptions
ExceptionManager.setIgnoreAll(true);

Ngoài ra, bạn có thể đặt callback cho nhật ký ngoại lệ bị bỏ qua:

ExceptionManager.setIgnoreExceptionsLogHandler(new IgnoreExceptionsLogCallback() {
    public void invoke(String message) {
        System.out.println("=== EXCEPTION IGNORED === " + message);
    }
});

Người dùng sẽ được thông báo rằng ngoại lệ có thể được bỏ qua bằng một thông báo lỗi. Ví dụ:

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.