Documentation – Bắt đầu

Java: Tổng quan sản phẩm

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

Chào mừng tới Aspose.Email cho Java!

Aspose.Email cho Java là một API Java cho phép các ứng dụng Java đọc và ghi tài liệu Microsoft Outlook® mà không cần sử dụng Microsoft Outlook®. Aspose.Email cho Java cung cấp một loạt các tính năng chính như quản lý người nhận, tiêu đề, nội dung, tệp đính kèm trong tài liệu Microsoft Outlook® MSG và đọc danh bạ, tin nhắn và thông tin thư mục từ tài liệu Microsoft Outlook® PST. Nó cũng có thể được sử dụng để tạo, chỉnh sửa và chuyển đổi các tin nhắn email ở định dạng EML, MSG và MHT.

Mô tả sản phẩm

Aspose.Email cho Java có thể được sử dụng với bất kỳ loại ứng dụng nào, dù là ứng dụng web hay desktop. Aspose.Email cho Java cũng cung cấp các ví dụ thực tế để giúp các nhà phát triển hiểu rõ hơn về Aspose.Email cho Java.

Aspose.Email cho Java không thể đọc các tệp MSG (định dạng tin nhắn Outlook), nhưng cho phép bạn lưu các tệp MSG sau khi áp dụng các thay đổi vào nội dung gốc. Bạn cũng có thể phân tích các tệp đính kèm và lưu chúng vào đĩa.

Việc đọc tệp Outlook PST cũng được hỗ trợ. Lấy các thư mục, thư mục con, số lượng tin nhắn, thông tin tin nhắn (tiêu đề, người gửi, người nhận, v.v.) và thông tin danh bạ từ tệp PST. Trích xuất tin nhắn từ tệp PST và lưu chúng vào đĩa ở định dạng MSG.

Aspose.Email cho Java được các nhà phát triển sử dụng để thực hiện nhiều tác vụ trong ứng dụng của họ. Ví dụ, mở hoặc lưu email ở dạng tệp EML hoặc MHT, phân tích hoặc đọc, và lưu các tin nhắn Microsoft Outlook và tệp Outlook PST, xử lý các tin nhắn MIME, nhúng đối tượng trong các tin nhắn email.

Tính năng

Tính năng định dạng tệp tin nhắn email

Hỗ trợ các tin nhắn email ở định dạng EML, MSG và MHTML.
Tạo tin nhắn mới.
Sửa đổi tin nhắn hiện có và cập nhật nội dung như tiêu đề, người gửi, người nhận, nội dung, tệp đính kèm, v.v.
Tải tin nhắn hiện có và lấy nội dung tin nhắn như tiêu đề, tệp đính kèm, người gửi, người nhận, v.v.
Quản lý (thêm/xóa) tệp đính kèm trong tin nhắn email.
Tạo tin nhắn email định dạng HTML.
Tạo tin nhắn ở chế độ nháp (chỉ MSG).
Đọc các tệp đính kèm tin nhắn email lồng nhau.
Chuyển đổi tin nhắn từ/đến bất kỳ định dạng nào được hỗ trợ.

Tính năng tệp MSG

Tạo tài liệu MSG mới từ đầu.
Mở tài liệu MSG hiện có.
Truy cập nội dung MSG.
Sửa đổi tài liệu MSG hiện có.
Lấy nhiều người nhận.
Truy cập các thuộc tính MAPI liên quan đến tài liệu MSG.
Phân tích tệp đính kèm từ tài liệu MSG.
Lưu tệp đính kèm vào đĩa.

Tính năng tệp PST/OST

Tải tệp Outlook PST từ đĩa và lấy thông tin về tất cả các thư mục của nó (chỉ hỗ trợ định dạng Unicode).
Lấy thông tin tin nhắn từ bất kỳ thư mục nào trong tệp PST, ví dụ: tiêu đề, người gửi, tệp đính kèm, v.v.
Trích xuất tin nhắn từ tệp PST và lưu vào đĩa ở định dạng MSG.
Đọc thông tin danh bạ từ tệp PST và lưu vào đĩa ở định dạng MSG.
Hỗ trợ đọc/điều chỉnh định dạng tệp OST (hiện tại không hỗ trợ tạo định dạng OST).

Java: Định dạng tệp được hỗ trợ

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

|Định dạng|Mô tả|Tải|Lưu| | :- | :- | :- | :- | |MSG|Định dạng này được Microsoft Outlook và Exchange sử dụng để lưu trữ tin nhắn email, danh bạ, cuộc hẹn hoặc các tác vụ khác.| | | |PST|đại diện cho các tệp lưu trữ cá nhân Outlook (Personal Storage Files) lưu trữ email, mục lịch, ghi chú, danh bạ và một số định dạng tệp khác. Nó được sử dụng để lưu trữ dữ liệu email ngoại tuyến.| | | |OST|đại diện cho dữ liệu hộp thư của người dùng ở chế độ ngoại tuyến trên máy cục bộ sau khi đăng ký với Exchange Server bằng Microsoft Outlook.| | | |OFT|Các tệp mẫu tin nhắn được tạo bằng Microsoft Outlook.| | | |OLM|Định dạng này được Microsoft Outlook cho Mac sử dụng để lưu trữ tin nhắn email, danh bạ, nhật ký, dữ liệu lịch và các dữ liệu ứng dụng người dùng khác.| | | |EML|đại diện cho các tin nhắn email được lưu bằng Outlook và các ứng dụng liên quan khác.| | | |EMLX|Apple Mail xuất email theo định dạng này.| | | |MBOX|đại diện cho một container chứa bộ sưu tập các tin nhắn email.| | | |ICS|Định dạng iCalendar được sử dụng để trao đổi và triển khai các sự kiện lịch và lên lịch.| | | |VCF|Định dạng Thẻ Ảo (Virtual Card) là một định dạng tệp kỹ thuật số để lưu trữ thông tin liên hệ.| | | |HTML|HTML (HyperText Markup Language) là phần mở rộng cho các trang web được tạo để hiển thị trong trình duyệt.| | | |MHTML|Định dạng lưu trữ trang web lưu mã HTML và các tài nguyên liên quan trong một tệp duy nhất.| | |

Java: Tính năng

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

Java: Yêu cầu hệ thống

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

Aspose.Email cho Java không yêu cầu cài đặt Microsoft Outlook, vì Aspose.Email tự nó là một thư viện tạo, chuyển đổi và thao tác tài liệu Microsoft Outlook.

Các hệ điều hành được hỗ trợ

Aspose.Email cho Java hỗ trợ bất kỳ hệ điều hành nào chạy môi trường Java, bao gồm nhưng không giới hạn:

Windows

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

Linux

Linux (Ubuntu, openSUSE, CentOS và các bản khác)

Mac

Mac OS X, v.v.

Các phiên bản Java được hỗ trợ

Aspose.Email cho Java hỗ trợ các phiên bản Java sau:

J2SE 6.0 (1.6)
J2SE 7.0 (1.7)
J2SE 8.0 (1.8)
hoặc cao hơn

Java: Cài đặt

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

Cài đặt Aspose.Email cho Java từ kho Maven

Aspose lưu trữ tất cả các API Java trên Aspose Artifactory. Bạn có thể dễ dàng sử dụng Aspose.Email cho Java API trực tiếp trong các dự án Maven của bạn với cấu hình đơn giản.

Chỉ định cấu hình kho Maven

Đầu tiên, bạn cần chỉ định cấu hình/địa chỉ kho Maven của Aspose trong file pom.xml của Maven như sau:


 <repositories>

    <repository>

        <id>AsposeJavaAPI</id>

        <name>Aspose Java API</name>

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

    </repository>

</repositories>

Định nghĩa phụ thuộc API Aspose.Email cho Java

Sau đó định nghĩa phụ thuộc API Aspose.Email cho Java trong file pom.xml của bạn như sau:


 <dependencies>

    <dependency>

        <groupId>com.aspose</groupId>

        <artifactId>aspose-email</artifactId>

        <version>19.12</version>

        <classifier>jdk16</classifier>

 </dependency>

</dependencies>

Sau khi thực hiện các bước trên, phụ thuộc Aspose.Email cho Java cuối cùng sẽ được định nghĩa trong dự án Maven của bạn.

Java: Cấp phép

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

Bạn có thể tải xuống phiên bản dùng thử của Aspose.Email cho Java từ trang tải xuống. Phiên bản dùng thử cung cấp đầy đủ các tính năng giống như phiên bản có giấy phép. Hơn nữa, phiên bản dùng thử sẽ trở thành có giấy phép khi bạn mua giấy phép và thêm một vài dòng mã để áp dụng giấy phép.

Khi bạn hài lòng với bản đánh giá Aspose.Email, bạn có thể mua giấy phép trên trang web Aspose. Hãy làm quen với các loại đăng ký khác nhau được cung cấp. Nếu có bất kỳ câu hỏi nào, đừng ngần ngại liên hệ với đội ngũ bán hàng của Aspose.

Mỗi giấy phép Aspose đi kèm với một năm đăng ký để được nâng cấp miễn phí lên bất kỳ phiên bản mới nào hoặc các bản sửa lỗi trong thời gian này. Hỗ trợ kỹ thuật là miễn phí, không giới hạn và được cung cấp cho cả người dùng có giấy phép và người dùng dùng thử.

Nếu bạn muốn thử Aspose.Email mà không bị giới hạn phiên bản dùng thử, hãy yêu cầu giấy phép tạm thời trong 30 ngày. Vui lòng tham khảo Làm thế nào để nhận Giấy phép tạm thời? để biết thêm thông tin.

Hạn chế của phiên bản Đánh giá

Phiên bản đánh giá của Aspose.Email (không có giấy phép được chỉ định) cung cấp đầy đủ chức năng sản phẩm ngoại trừ một vài thành phần như Aspose.Email.Mail, Aspose.Email.Pop3 và Aspose.Email.Imap có một số hạn chế khi dùng thử.

Tệp License.txt được thêm vào tệp tin nhắn được lưu bằng Aspose.Email.
Chỉ có thể trích xuất tối đa 50 email từ một thư mục trong tệp PST.
Chỉ có thể trích xuất tối đa 3 tệp đính kèm cùng các hình ảnh nội tuyến từ một tệp MSG.
Số tối đa tệp đính kèm được xử lý trong định dạng CFB là 1.
Số tối đa người nhận được xử lý trong định dạng CFB là 1.
Thêm "Tin nhắn Đánh giá" vào Chủ đề khi lưu ở định dạng CFB, EML hoặc MSG.
Ngày kết thúc không được muộn hơn 31-12-2004 trong phương thức GenerateOccurrences của mẫu lặp lại. Điều này cho phép bạn kiểm tra sản phẩm một cách có ý nghĩa, nhưng không thể sử dụng trong ứng dụng thực tế. Ví dụ, bạn có thể tạo một mẫu như "bắt đầu vào ngày 1 tháng 1 năm 2000 và lặp lại vào ngày làm việc cuối cùng của mỗi tháng" và tạo các lần xuất hiện cho nó. Các lần xuất hiện sau ngày 31 tháng 12 năm 2004 sẽ không được tạo trong chế độ đánh giá.
Thêm "Hình mờ Đánh giá" khi lưu ở định dạng XPS hoặc TIFF.
Số tối đa các địa chỉ email mơ hồ và tên hiển thị được giải quyết bởi MS Exchange Server là 20.
Độ dài tối đa của tệp dữ liệu cho phép kéo và thả với FileDropPanel là 51200 byte.
Hiển thị hộp thoại Tin nhắn Đánh giá trong quá trình kéo và thả được FileDropPanel sử dụng.
Chỉ 1 tệp được trích xuất từ luồng MSO đã cho bằng phương thức InlineAttachmentExtractor.EnumerateMsoPackage.

Cài đặt giấy phép

Giấy phép là một tệp XML văn bản thuần chứa các chi tiết như tên sản phẩm, số lượng nhà phát triển được cấp phép, ngày hết hạn đăng ký, v.v. Tệp được ký số, vì vậy không chỉnh sửa tệp; ngay cả việc vô tình thêm một dấu ngắt dòng extra vào tệp cũng sẽ làm nó mất hiệu lực.

Bạn cần áp dụng giấy phép nếu muốn tránh các hạn chế của phiên bản dùng thử. Bạn chỉ cần thiết lập giấy phép một lần cho mỗi ứng dụng hoặc quy trình.

Giấy phép có thể được tải từ một luồng hoặc tệp ở các vị trí sau:

Đường dẫn rõ ràng.
Thư mục chứa Aspose.Email.jar.

Sử dụng phương thức License.setLicense để cấp phép cho thành phần. Thông thường cách dễ nhất để thiết lập giấy phép là đặt tệp giấy phép cùng thư mục với Aspose.Email.jar và chỉ định tên tệp mà không có đường dẫn như trong ví dụ dưới đây:

Cài đặt giấy phép từ tệp

Trong ví dụ này, Aspose.Email sẽ cố gắng tìm tệp giấy phép trong thư mục chứa các JAR của ứng dụng của bạn.

Cài đặt giấy phép từ luồng

Khởi tạo giấy phép từ một luồng.

Áp dụng giấy phép có giới hạn

Aspose.Email cho phép các nhà phát triển áp dụng khóa định mức. Đó là một cơ chế cấp phép mới. Cơ chế cấp phép mới sẽ được sử dụng cùng với phương pháp cấp phép hiện có. Những khách hàng muốn trả phí dựa trên việc sử dụng các tính năng API có thể sử dụng giấy phép định mức. Để biết thêm chi tiết, vui lòng tham khảo Câu hỏi thường gặp về Giấy phép Định mức phần.

Một lớp mới Metered đã được giới thiệu để áp dụng khóa có tính phí. Dưới đây là mã mẫu minh họa cách thiết lập khóa công cộng và riêng tư có tính phí.

Bao gồm tệp giấy phép như một phần nhúng

Xác thực giấy phép

Có thể xác thực xem giấy phép đã được thiết lập đúng cách hay chưa. The Giấy phép lớp có trường isLicensed sẽ trả về true nếu giấy phép đã được thiết lập đúng cách.

Java


 License license = new License();

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

if (License.isLicensed()) {

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

}

Java: Cách chạy các ví dụ

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

Tải xuống từ GitHub

Tất cả các ví dụ của Aspose.Email for Java được lưu trữ trên Github. Bạn có thể sao chép kho bằng cách sử dụng client Github ưa thích của mình hoặc tải tệp ZIP từ ở đây.

Giải nén nội dung của tệp ZIP vào bất kỳ thư mục nào trên máy tính của bạn. Tất cả các ví dụ nằm trong thư mục Examples.

Dự án sử dụng hệ thống xây dựng Maven. Bất kỳ IDE hiện đại nào cũng có thể dễ dàng mở hoặc nhập dự án và các phụ thuộc của nó. Dưới đây chúng tôi sẽ chỉ cho bạn cách sử dụng các IDE phổ biến để biên dịch và chạy các ví dụ.

IntelliJ IDEA

Nhấp vào menu File và chọn Open. Duyệt tới thư mục dự án và chọn tệp pom.xml.

Nó sẽ mở dự án và tự động tải xuống các phụ thuộc. Từ thẻ Project, duyệt các ví dụ trong thư mục src/main/java. Để chạy một ví dụ, chỉ cần nhấp chuột phải vào tệp và chọn "Run ..", ví dụ sẽ được thực thi và đầu ra sẽ được hiển thị trong cửa sổ console tích hợp.

Eclipse

Nhấp vào menu File và chọn Import. Chọn Maven - Existing Maven Projects.

Duyệt tới thư mục bạn đã clone hoặc tải về từ GitHub và chọn tệp pom.xml.

Nó sẽ mở dự án và tự động tải các phụ thuộc. Từ tab Package Explorer, duyệt các ví dụ trong thư mục src/main/java. Để chạy một ví dụ, chỉ cần click chuột phải vào tệp và chọn Run As - Java Application, ví dụ sẽ được thực thi và đầu ra sẽ hiển thị trong cửa sổ console tích hợp.

NetBeans

Nhấp vào menu File và chọn Open Project. Duyệt tới thư mục bạn đã clone hoặc tải về từ GitHub. Biểu tượng của thư mục Examples sẽ cho thấy đó là một dự án Maven. Chọn Examples và mở nó.

Nó sẽ mở dự án và tải các phụ thuộc tự động. Từ tab Projects, duyệt các ví dụ trong source packages. Để chạy một ví dụ, chỉ cần click chuột phải vào tệp và chọn Run File, ví dụ sẽ được thực thi và đầu ra sẽ được hiển thị trong cửa sổ console tích hợp.

Đóng góp

Nếu bạn muốn thêm hoặc cải thiện một ví dụ, chúng tôi khuyến khích bạn đóng góp vào dự án. Tất cả các ví dụ và dự án trình diễn trong kho này là mã nguồn mở và có thể tự do sử dụng trong ứng dụng của bạn.

Để đóng góp, bạn có thể fork kho lưu trữ, chỉnh sửa mã nguồn và tạo pull request. Chúng tôi sẽ xem xét các thay đổi và bao gồm chúng trong kho nếu thấy hữu ích.

Java: Hỗ trợ kỹ thuật

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

Aspose cung cấp hỗ trợ kỹ thuật miễn phí không giới hạn cho tất cả các sản phẩm của mình. Hỗ trợ này có sẵn cho tất cả người dùng, bao gồm cả những người đang chạy bản đánh giá.

Nếu bạn cần giúp đỡ, truy cập Aspose.Forums. Đăng câu hỏi của bạn trong diễn đàn Aspose.Email cho Java và nó sẽ được trả lời trong vòng vài giờ.

Khi mong đợi trả lời trong các diễn đàn, vui lòng tính đến sự khác nhau về múi giờ.

Báo cáo vấn đề

Nếu bạn gặp vấn đề, hãy làm theo các bước đơn giản sau để đảm bảo nó được giải quyết hiệu quả:

Đảm bảo bạn sử dụng phiên bản mới nhất của sản phẩm trước khi báo cáo vấn đề. Xem Trang tải xuống Aspose.Email cho Java để tìm hiểu về phiên bản mới nhất.
Hãy xem qua các diễn đàn, wiki tài liệu này và Tham chiếu API trước khi báo cáo vấn đề. Câu hỏi của bạn có thể đã có câu trả lời.
Khi báo cáo một vấn đề, vui lòng bao gồm tài liệu gốc và có thể một đoạn mã gây ra vấn đề. Nếu cần đính kèm nhiều tệp, hãy nén chúng thành một file zip. An toàn khi đính kèm tài liệu của bạn trong diễn đàn vì chỉ bạn và các nhà phát triển của Aspose mới có quyền truy cập vào các tệp đính kèm.
Vui lòng cố gắng báo cáo một vấn đề mỗi luồng. Nếu bạn có một vấn đề khác, hãy báo cáo trong một luồng riêng.

Aspose không cung cấp hỗ trợ kỹ thuật qua điện thoại. Hỗ trợ qua điện thoại chỉ dành cho các câu hỏi về bán hàng và mua hàng.

Java: Tài nguyên

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

Bảng này liệt kê các tài nguyên kỹ thuật quan trọng của Aspose.Email cho Java.

Java: Đánh giá Aspose.Email

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

Bạn có thể tải Aspose.Email cho Java miễn phí để đánh giá. Phiên bản đánh giá cung cấp gần như toàn bộ chức năng của sản phẩm với một số giới hạn. Phiên bản đánh giá này sẽ trở thành có giấy phép khi bạn mua giấy phép và thêm một vài dòng code vào áp dụng giấy phép.

Nếu bạn muốn thử Aspose.Email mà không bị giới hạn phiên bản đánh giá, yêu cầu giấy phép tạm thời 30 ngày. Vui lòng tham khảo Làm thế nào để nhận Giấy phép tạm thời?

Hạn chế của phiên bản Đánh giá

Phiên bản đánh giá của Aspose.Email (không có giấy phép được chỉ định) cung cấp đầy đủ chức năng sản phẩm ngoại trừ một vài thành phần - Aspose.Email.Mail, Aspose.Email.Pop3, Aspose.Email.Ftp và Aspose.Email.Imap có các giới hạn đánh giá:

Tệp License.txt được thêm vào các tệp tin tin nhắn được lưu bằng Aspose.Email.
Chỉ có thể trích xuất 50 email từ một thư mục trong tệp PST.
Chỉ có thể trích xuất 3 tệp đính kèm cũng như hình ảnh nhúng từ tệp MSG.
Số lượng tối đa tệp đính kèm được xử lý trong định dạng CFB là 1.
Số lượng tối đa người nhận được xử lý trong định dạng CFB là 1.
Thêm "Evaluation Message" vào tiêu đề khi lưu dưới định dạng CFB, EML hoặc MSG.
Ngày kết thúc không được muộn hơn 31-12-2004 trong phương thức GenerateOccurrences của mẫu lặp lại. Điều này cho phép bạn kiểm tra sản phẩm một cách có ý nghĩa, nhưng khiến nó không thể sử dụng trong ứng dụng thực tế. Ví dụ, bạn có thể tạo một mẫu như "bắt đầu vào ngày 1 tháng 1 năm 2000 và lặp lại vào ngày làm việc cuối cùng của mỗi tháng" và tạo các lần xuất hiện cho nó. Các lần xuất hiện sau ngày 31 tháng 12 năm 2004 sẽ không được tạo trong chế độ đánh giá
Chỉ 1 tệp được trích xuất từ luồng MSO được cung cấp bởi phương thức InlineAttachmentExtractor.EnumerateMsoPackage

Dấu đánh giá được nhúng trong tin nhắn đã lưu