Fitur Utilitas - MailMessage
Mengenkripsi dan Mendekripsi Pesan
Aspose.Email menyediakan fasilitas untuk Mengenkripsi dan mendekripsi pesan Email. Topik ini menunjukkan bagaimana pesan yang ada atau baru dapat dimuat dan dienkripsi menggunakan MailMessage. The encrypt() dan decrypt() metode mengembalikan objek MailMessage untuk efek yang diterapkan dan perlu diwaspadai saat mengenkripsi/mendekripsi pesan. Mengenkripsi dan mendekripsi pesan melibatkan langkah-langkah berikut:
- Buat pesan baru atau muat yang sudah ada
- Enkripsi pesan menggunakan file sertifikat
- Kirim pesan atau simpan
- Dekripsi pesan sesuai kebutuhan
Cuplikan kode berikut menunjukkan cara mengenkripsi dan mendekripsi pesan.
Memeriksa Enkripsi Pesan
Aspose.Email MailMessage kelas memungkinkan memeriksa apakah pesan terenkripsi atau tidak. The isEncrypted properti MailMessage memungkinkan memeriksa ini seperti yang ditunjukkan dalam contoh kode berikut.
Enkripsi Pesan dengan X509Certificate
Aspose.Email menyediakan API untuk bekerja dengan Pesan Terenkripsi dengan X509Certificate:
MailMessage kelas memiliki metode berikut untuk bekerja dengan enkripsi pesan:
- public MailMessage attachSignature(X509Certificate2 certificate, boolean detached) - Membuat pesan yang ditandatangani.
- public MailMessage attachSignature(X509Certificate2 certificate) - Membuat pesan yang ditandatangani.
- public X509Certificate2[] checkSignatureCert() - Memeriksa tanda tangan pada MailMessage yang ada.
- public MailMessage decrypt(X509Certificate2 certificate)
- public MailMessage encrypt(X509Certificate2 certificate)
- public MailMessage encrypt(X509Certificate2[] certificates)
Konfigurasi Opsi Locale untuk Aspose.Email
Anda dapat menggunakan LocaleOptions kelas untuk menangani locale default yang tidak dikenali dan menetapkan locale yang paling tepat untuk perpustakaan Aspose Email. Ia menawarkan metode berikut untuk melakukan tugas tersebut:
- getLocale() - Mengembalikan Locale default untuk Aspose.Email.
- setLocale(Locale locale) dan setLocale(String localeName) - Menetapkan locale default terkait untuk Aspose.Email.
- clear() - Menghapus locale default untuk Aspose.Email. Akan digunakan locale default untuk Java.
Contoh kode berikut menunjukkan cara memuat pesan email dari file menggunakan pengaturan locale yang ditentukan:
final Locale locale = new Locale("en", "DE");
Locale.setDefault(locale);
// set Locale for Aspose Email lib
LocaleOptions.setLocale("en-US");
// or
//LocaleOptions.setLocale(new Locale("en", "US"));
MailMessage.load("document.msg");
Kode ini memastikan bahwa aplikasi dan perpustakaan Aspose.Email menggunakan locale yang ditentukan untuk menangani bahasa, negara, dan konvensi budaya.
MailMessage yang Mengandung Lampiran TNEF
Transport Neutral Encapsulation Format (TNEF) adalah format lampiran email milik perusahaan yang digunakan oleh Microsoft Outlook dan Microsoft Exchange Server. API Aspose.Email memungkinkan Anda membaca pesan email yang memiliki lampiran TNEF dan memodifikasi isinya. Email tersebut kemudian dapat disimpan sebagai email normal atau dalam format yang sama, mempertahankan lampiran TNEF. Artikel ini menunjukkan berbagai contoh kode untuk bekerja dengan pesan yang berisi lampiran TNEF.
Membaca Pesan dengan Mempertahankan Lampiran TNEF
Cuplikan kode berikut menunjukkan cara membaca pesan dengan mempertahankan lampiran TNEF.
Memperbarui Sumber Daya dalam Lampiran TNEF dan Mempertahankan Format TNEF
Cuplikan kode berikut menunjukkan cara memperbarui sumber daya dalam lampiran TNEF dan mempertahankan format TNEF.
Menambahkan Lampiran Baru ke Pesan Utama yang Mengandung TNEF
Membuat TNEF EML dari MSG
MSG Outlook kadang berisi informasi seperti tabel dan gaya teks yang dapat terganggu jika dikonversi ke EML. Membuat pesan TNEF dari file MSG tersebut memungkinkan kita mempertahankan format dan bahkan mengirim pesan tersebut melalui klien email sambil mempertahankan format.
Untuk membuat TNEF, contoh kode berikut dapat digunakan.
Deteksi apakah Pesan merupakan TNEF
Memproses Pesan yang Bounce
Sangat umum bahwa pesan yang dikirim ke penerima dapat memantul karena alasan apapun seperti alamat penerima yang tidak valid. API Aspose.Email memiliki kemampuan untuk memproses pesan semacam itu untuk memeriksa apakah itu email yang bounce atau pesan email biasa. The PeriksaBounced metode dari MailMessage kelas mengembalikan hasil yang valid jika pesan email adalah email yang memantul.
Artikel ini menunjukkan penggunaan BounceResult kelas yang menyediakan kemampuan untuk memeriksa apakah pesan merupakan email yang memantul (bounced). Selain itu memberikan informasi rinci tentang penerima, tindakan yang diambil, dan alasan pemberitahuan.
Abaikan pengecualian
Perpustakaan menawarkan sebuah ExceptionManager kelas untuk mengimplementasikan kemampuan mengabaikan pengecualian ke dalam fungsionalitas aplikasi Anda. Potongan kode di bawah ini menunjukkan cara mengatur callback untuk menangani pengecualian:
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");
}
});
Atau gunakan alternatif:
ExceptionManager.setIgnoreAll(true);
Juga, Anda dapat mengatur callback untuk log pengecualian yang diabaikan:
ExceptionManager.setIgnoreExceptionsLogHandler( new IgnoreExceptionsLogCallback() {
public void invoke(String message) {
System.out.println("=== EXCEPTION IGNORED === " + message);
}
});
Pengguna akan diberitahu, bahwa pengecualian dapat diabaikan dengan pesan error. Contoh:
Pengecualian dalam pesan:
AsposeArgumentException: properties should not be empty.
Jika Anda ingin mengabaikan sebuah pengecualian dan ingin melanjutkan lebih jauh maka Anda dapat menggunakan:
ExceptionManager.getIgnoreList().add("MailMessage\\Load\\DecodeTnefAttachment\\64149867-679e-4645-9af0-d46566cae598")
Invalid TNEF Attachment will be interpreted as regular attachment.
Analisis Spam Bayesian
Aspose.Email menyediakan fasilitas penyaringan e‑mail menggunakan analis spam Bayes. Ini menyediakan the SpamAnalyzer kelas untuk tujuan ini. Artikel ini menunjukkan cara melatih filter untuk membedakan antara spam dan email reguler berdasarkan basis data kata.
Mendapatkan Preamble dan Epilogue dari Pesan EML
Pada format MIME, preamble adalah teks yang muncul setelah header dan sebelum batas multipart pertama. epilogue adalah teks yang muncul setelah batas terakhir dan sebelum akhir pesan. Teks ini biasanya tidak terlihat oleh pengguna di pembaca surel, namun beberapa implementasi MIME dapat menggunakannya untuk menyisipkan catatan bagi penerima yang membaca pesan menggunakan program yang tidak mendukung MIME.
Potongan kode berikut menunjukkan cara memperoleh preamble dan epilog dari pesan EML yang dapat dicapai dengan metode yang sesuai dari MailMessage kelas:
- setPreamble(String value) - Mendapatkan atau mengatur teks preamble.
- setEpilogue(String value) - Mendapatkan atau mengatur teks epilog.
// Gets or sets a preamble text.
public String getPreamble, setPreamble
// Gets or sets an epilogue text.
public String getEpilogue, setEpilogue