Dienstprogrammfunktionen – MailMessage

Nachrichten verschlüsseln und entschlüsseln

Aspose.Email bietet die Möglichkeit, E‑Mail‑Nachrichten zu verschlüsseln und zu entschlüsseln. Dieser Abschnitt zeigt, wie eine vorhandene oder neue Nachricht geladen und mit MailMessage. Die encrypt() und decrypt() Methoden geben das Objekt MailMessage zurück, das die angewendeten Effekte enthält, und müssen beim Verschlüsseln/Entschlüsseln von Nachrichten beachtet werden. Das Verschlüsseln und Entschlüsseln von Nachrichten umfasst die folgenden Schritte:

Erstellen Sie eine neue Nachricht oder laden Sie eine bestehende
Verschlüsseln Sie die Nachricht mithilfe der Zertifikatdatei
Senden Sie die Nachricht oder speichern Sie sie
Entschlüsseln Sie die Nachricht nach Bedarf

Das folgende Code‑Snippet zeigt, wie Nachrichten verschlüsselt und entschlüsselt werden.

Überprüfen, ob eine Nachricht verschlüsselt ist

Aspose.Email MailMessage Klasse ermöglicht die Überprüfung, ob eine Nachricht verschlüsselt ist oder nicht. Die isEncrypted Eigenschaft von MailMessage, die dies prüft, wie im folgenden Code‑Beispiel gezeigt.

Nachrichtenverschlüsselung mit X509Certificate

Aspose.Email stellt die API für die Arbeit mit verschlüsselten Nachrichten mit X509Certificate bereit:

MailMessage Klasse verfügt über die folgenden Methoden zur Arbeit mit Nachrichtenverschlüsselung:

public MailMessage attachSignature(X509Certificate2 certificate, boolean detached) - Erstellt eine signierte Nachricht.
public MailMessage attachSignature(X509Certificate2 certificate) - Erstellt eine signierte Nachricht.
public X509Certificate2[] checkSignatureCert() - Prüft die Signatur der vorhandenen MailMessage.
public MailMessage decrypt(X509Certificate2 certificate)
public MailMessage encrypt(X509Certificate2 certificate)
public MailMessage encrypt(X509Certificate2[] certificates)

Locale‑Optionen für Aspose.Email konfigurieren

Sie können verwenden LocaleOptions Klasse für den Fall eines nicht erkannten Standard‑Locale und setzt das am besten geeignete Locale für die Aspose‑Email‑Bibliothek. Sie bietet die folgenden Methoden zur Ausführung:

getLocale() - Gibt das Standard‑Locale für Aspose.Email zurück.
setLocale(Locale locale) und setLocale(String localeName) - Legt das Standard‑Locale für Aspose.Email fest.
clear() - Löscht das Standard‑Locale für Aspose.Email. Wird als Standard‑Locale für Java verwendet.

Das folgende Beispiel zeigt, wie eine Mail‑Nachricht aus einer Datei geladen wird, wobei die angegebenen Locale‑Einstellungen verwendet werden:

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

Dieser Code stellt sicher, dass die Anwendung und die Aspose.Email‑Bibliothek die angegebenen Locale-Einstellungen für Sprache, Land und kulturelle Konventionen verwenden.

MailMessages mit TNEF‑Anhängen

Transport Neutral Encapsulation Format (TNEF) ist ein proprietäres E‑Mail‑Anhangsformat, das von Microsoft Outlook und Microsoft Exchange Server verwendet wird. Die Aspose.Email‑API ermöglicht das Lesen von E‑Mails mit TNEF‑Anhängen und das Ändern ihres Inhalts. Die E‑Mail kann anschließend als normale E‑Mail oder im selben Format gespeichert werden, wobei die TNEF‑Anhänge erhalten bleiben. Dieser Artikel zeigt verschiedene Code‑Beispiele für die Arbeit mit Nachrichten, die TNEF‑Anhänge enthalten.

Nachricht lesen und TNEF‑Anhänge erhalten

Das folgende Code‑Snippet zeigt, wie eine Nachricht gelesen wird, während TNEF‑Anhänge erhalten bleiben.

Ressourcen in einem TNEF‑Anhang aktualisieren und TNEF‑Format beibehalten

Das folgende Code‑Snippet zeigt, wie Ressourcen in einem TNEF‑Anhang aktualisiert und das TNEF‑Format erhalten bleibt.

Neue Anhänge zur Hauptnachricht mit TNEF hinzufügen

TNEF‑EML aus MSG erstellen

Outlook‑MSG‑Dateien enthalten manchmal Informationen wie Tabellen und Textstile, die bei einer Konvertierung nach EML gestört werden können. Das Erstellen von TNEF‑Nachrichten aus solchen MSG‑Dateien ermöglicht es, die Formatierung beizubehalten und solche Nachrichten sogar über E‑Mail‑Clients mit erhaltenem Layout zu senden.

Um TNEF zu erstellen, kann der folgende Beispielcode verwendet werden.

Erkennen, ob eine Nachricht TNEF ist

Verarbeiten von zurückgesandten Nachrichten

Es ist sehr häufig, dass eine an einen Empfänger gesendete Nachricht aus irgendeinem Grund, z. B. wegen einer ungültigen Empfängeradresse, zurückgesendet wird. Die Aspose.Email‑API bietet die Möglichkeit, eine solche Nachricht zu verarbeiten, um zu überprüfen, ob es sich um eine zurückgesandte E‑Mail oder um eine reguläre E‑Mail handelt. Der CheckBounced Methode des MailMessage Klasse gibt ein gültiges Ergebnis zurück, wenn die E‑Mail‑Nachricht eine Rückläufer‑E‑Mail ist.

Dieser Artikel zeigt die Verwendung von BounceResult Klasse, die die Fähigkeit bietet, zu prüfen, ob eine Nachricht eine Rückläufer‑E‑Mail ist. Sie liefert zudem detaillierte Informationen zu den Empfängern, den ergriffenen Maßnahmen und dem Grund der Benachrichtigung.

Ausnahmen ignorieren

Die Bibliothek bietet ein ExceptionManager Klasse, um die Fähigkeit zum Ignorieren von Ausnahmen in Ihre Anwendungsfunktionalität zu integrieren. Das untenstehende Code‑Snippet demonstriert, wie ein Callback zum Umgang mit Ausnahmen festgelegt wird:

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

   }

});

Oder verwenden Sie eine Alternative:

 ExceptionManager.setIgnoreAll(true);

Außerdem können Sie einen Rückruf für das Protokoll ignorierter Ausnahmen festlegen:

ExceptionManager.setIgnoreExceptionsLogHandler( new IgnoreExceptionsLogCallback() {

   public void invoke(String message) {

        System.out.println("=== EXCEPTION IGNORED === " + message);

   }

});

Der Benutzer wird darüber informiert, dass die Ausnahme durch eine Fehlermeldung ignoriert werden kann. Beispiel:

Ausnahme in Nachricht:

AsposeArgumentException: properties should not be empty.

Wenn Sie eine Ausnahme ignorieren und anschließend fortfahren möchten, können Sie folgendes verwenden:

ExceptionManager.getIgnoreList().add("MailMessage\\Load\\DecodeTnefAttachment\\64149867-679e-4645-9af0-d46566cae598")

Invalid TNEF Attachment will be interpreted as regular attachment.

Bayesianischer Spam‑Analyzer

Aspose.Email bietet die Möglichkeit der E‑Mail‑Filterung mit dem Bayes‑Spam‑Analyzer. Es stellt die SpamAnalyzer Klasse für diesen Zweck. Dieser Artikel zeigt, wie Sie den Filter trainieren, um Spam von regulären E‑Mails anhand der Wortdatenbank zu unterscheiden.

Abrufen von Präambel und Epilog aus EML‑Nachrichten

Im MIME‑Format ist die Präambel der Text, der nach den Headern und vor dem ersten Multipart‑Grenzwert erscheint. Der Epilog ist der Text, der nach dem letzten Grenzwert und vor dem Ende der Nachricht erscheint. Dieser Text ist normalerweise in Mail‑Readern nicht sichtbar, aber einige MIME‑Implementierungen können ihn benutzen, um Notizen für Empfänger einzufügen, die die Nachricht mit nicht MIME‑konformen Programmen lesen.

Das folgende Code‑Snippet zeigt, wie man Präambel und Epilog aus einer EML‑Nachricht erhält, was mit den entsprechenden Methoden von MailMessage Klasse:

setPreamble(String value) - Ruft den Präambel‑Text ab oder legt ihn fest.
setEpilogue(String value) - Ruft den Epilog‑Text ab oder legt ihn fest.

// Gets or sets a preamble text.
public String getPreamble, setPreamble

// Gets or sets an epilogue text.
public String getEpilogue, setEpilogue

Laden und Speichern von Nachrichten Verfolgung des Dokumentkonvertierungs‑Fortschritts