Thema: Versenden von s mit der JavaMail API.

Transkript

1 Fachhochschule Ravensburg-Weingarten Fachbereich Elektrotechnik und Informatik Studiengang Technische Informatik Vorlesung Internet 2 Prof. Dr.-Ing. H. Usadel Hausarbeit im Wintersemester 2000/2001 Thema: Versenden von s mit der JavaMail API. Klaus Köhle Danziger Weg 2 D Friedrichshafen Friedrichshafen, 2. Dezember 2000

2 Seite I Inhaltsverzeichnis Kapitel 1 Einleitung...1 Kapitel 2 Architektur der JavaMail API Schichtenmodell Klassenhierarchie Die Message Class Struktur einer Message Class Einige Methoden der Message Class Das Part Interface Die Message Attribute Das contenttype Attribut Die Address Class Die BodyPart Class Die Multipart Class Das JavaBeans Activation Framework Message Komposition Die Mail Session Transportprotokolle und Mechanismen Programmbeispiel...16 Kapitel 3 Anhang Literaturverzeichnis Abkürzungsverzeichnis...19

3 Seite 1 Kapitel 1 Einleitung Mit der JavaMail API ist die Programmiersprache Java um ein Mail-System erweitert worden. Es wird eine Menge von abstrakten Klassen, wie Message, Store, Transport, bereitgestellt, die zur Programmentwicklung eingesetzt werden können. Die von der JavaMail API definierten Klassen können erweitert und abgeleitet werden, um neue Protokolle zu unterstützen und um weitere Funktionalitäten einzubinden. Die API bietet zusätzlich konkrete Unterklassen der abstrakten Klassen an, wie etwa die MimeMessage oder MimeBodyPart Klasse. Diese Unterklassen implementieren die weit verbreiteten Internet Mail Protokolle und wurden unter Berücksichtigung der RFC822 und der RFC2045 (MIME Part One) entwickelt. Das Thema dieser Hausarbeit umfasst das Versenden von s mit der JavaMail API. Es werden zunächst in einem Überblick die Architektur der JavaMail API, sowie einige wichtige Klassen erklärt. In einem weiteren Teil wird schrittweise gezeigt, wie eine Nachricht unter Verwendung der in der JavaMail API bereitgestellten Klassen und Methoden zusammengestellt und verschickt werden kann. Es wird dazu ein Programmbeispiel zur Verfügung gestellt.

4 Seite 2 Kapitel 2 Architektur der JavaMail API 2.1 Schichtenmodell Die folgende Abbildung veranschaulicht die Zusammenhänge von Mailprogramm, JavaMail API und den erforderlichen Protokollen: Mailprogramm Java Bean, wird verwendet zum Austausch und Anzeigen des Inhalts einer Nachricht JavaMail API Schicht der abstrakten Klassen für Java Mail Schicht der Klassen für Internet Mail Protokollschicht (POP3 / IMAP / SMTP / MIME..) Abbildung 1 Das Mailprogramm verwendet Klassen und Methoden aus der JavaMail API zur Erstellung, Bearbeitung und zum Versand von Nachrichten. Ein Mailprogramm greift auf diese Weise auf die Schicht der abstrakten Klassen für die Java Mail zu. Diese Schicht verwendet wiederum die Schicht der Klassen für die Internet Mail, um die Java Mail in eine für das Internet angepasste Form zu bringen. Von dieser Schicht aus wird die Kommunikation mit den Mailservern auf der Basis der erforderlichen Protokolle gesteuert. Die JavaMail API verwendet die Funktionalität des JavaBeans Activation Framework (JAF) 1, um MIME Datentypen zu bestimmen und um die verfügbaren Kommandos für diese Art von empfangenen Daten zu ermitteln. Die JAF wird unter anderem beim Einlesen einer empfangenen Nachricht in ein Message Objekt verwendet. 1 wird erklärt in Abschnitt 2.4 auf Seite 8.

5 2.2 Klassenhierarchie Seite 3 Die folgende Abbildung zeigt zunächst eine Übersicht über die Hauptklassen und Hauptschnittstellen, die in der JavaMail API realisiert sind. Eine Beschreibung der in der Abbildung enthaltenen Komponenten wird in den darauf folgenden Abschnitten gegeben. Part Bodypart Message Multipart Container Class MimePart MimeBodyPart MimeMessage MimeMultipart Container Class Extends Implements Interface Class Container Class Abbildung Die Message Class Die Message Class ist eine Klasse, die eine Menge von Attributen und den Inhalt einer Nachricht definiert. Die Attribute der Nachricht beschreiben die Adressinformationen und die Struktur des Inhalts mit Hilfe des Content-Type. Der Inhalt wird repräsentiert durch ein DataHandler Objekt (siehe Abschnitt 2.4), das die aktuellen Daten verwahrt. Die Message Class ist eine abstrakte Klasse, die das Interface Part implementiert 2. Unterklassen der Message Class können verschiedene Standardformate einer Nachricht implementieren. Zum Beispiel unterstützt die JavaMail API die MimeMessage Class, die von der Message Class abgeleitet wird und die RFC822 und den MIME Standard realisiert. Message Objekte werden entweder von einem Folder Objekt abgeholt oder durch die Instanzierung einer neuen, von der Message Class abgeleiteten, Unterklasse konstruiert. 2 Das Part Interface wird beschrieben in Abschnitt auf Seite 5.

6 Seite Struktur einer Message Class Die Struktur einer Message Class wird anhand des folgenden Schaubilds erläutert: Message Class Header Attributes Attribute, durch das Part Interface definiert, einschließlich Content-Type. Attribute, durch die Message Class hinzugefügt. Optionale Attribute, durch eine von Message abgeleitete Klasse hinzugefügt (z.b. MimeMessage). Content Body DataHandler Object Enthält Daten, die dem Content-Type Attribut entsprechen, zusammen mit Methoden, die den Zugriff auf die Daten erlauben. Abbildung 3 Die Kopfinformationen einer Nachricht werden durch die Header Attributes repräsentiert. Dazu gehören die vom Part Interface definierten Attribute, die auch den Content-Type enthalten. Dieser beschreibt die Art der Daten, die im Rumpf der Nachricht enthalten sind. Die Attribute der Message Class ergänzen die vom Part Interface definierten Attribute unter anderen um die Adressinformationen. Die von der Message Class abgeleiteten Klassen definieren außerdem noch weitere optionale Attribute. Zum Beispiel stellt die MimeMessage Class Attribute bereit, die für die Erstellung einer Nachricht nach dem MIME Standard erforderlich sind.. Der Inhalt des Rumpfes (Content Body) einer Nachricht, der aus einem DataHandler Objekt besteht, ist eine Ansammlung von Bytes oder ein Verweis auf eine Ansammlung von Bytes, die in einem Message Objekt gekapselt werden. JavaMail hat keine Kenntnis über den Typ der Daten oder das Format des Nachrichteninhalts. Ein Message Objekt agiert in Bezug auf dessen Inhalt über die Zwischenschicht JavaBeans Activation Framework. Diese Teilung erlaubt es einem Message Objekt, einen beliebigen Inhalt zu verarbeiten und zu übertragen. Der Nachrichtenempfänger kann gewöhnlich den Datentyp und das Format des Inhalts ermitteln und weiß, wie der Inhalt zu behandeln ist. Ein Message Objekt kann mehrere Teile enthalten. Jeder dieser Teile besitzt seine eigene Menge an

7 Seite 5 Attributen und Inhalten. Der Inhalt einer mehrteiligen Nachricht wird durch ein Multipart Objekt repräsentiert. Jeder einzelne Teil der Nachricht wird in einem BodyPart Objekt gekapselt. Das Part Interface definiert die gleichartige Struktur und Bedeutung zwischen der Message Class und der BodyPart Class Einige Methoden der Message Class Die Message Class unterstützt Methoden zur Verarbeitung folgender Aufgaben: Das Holen, Setzen und Erzeugen der Attribute und des Inhalts kann mit den folgenden Methoden erreicht werden: public String getsubject() throws MessagingException; public void setsubject(string subject) throws MessagingException; public String[] getheader(string name) throws MessagingException; public void setheader(string name, String value) throws MessagingException; public Object getcontent() throws MessagingException; public void setcontent(object content, String type) throws MessagingException; Änderungen werden wirksam mit der Methode: public void savechanges() throws MessagingException; Diese Methode stellt sicher, dass die Felder der Kopfinformation einer Nachricht aktualisiert werden, um eine Übereinstimmung mit dem veränderten Inhalt der Nachricht zu erreichen. Das Erzeugen eines Bytestroms für ein Message Objekt erfolgt mit: public void writeto(outputstream os) throws IOException, MessagingException; Dieser Bytestrom kann verwendet werden, um eine Nachricht zu speichern oder sie an ein Transport Objekt zu senden Das Part Interface Das Part Interface definiert eine Menge von Standard Kopfteilen einer Nachricht, die den meisten Mail-Systemen gemeinsam sind. Es spezifiziert den Datentyp, der im Nachrichtenrumpf enthaltenen Daten und definiert set- und get-methoden, um den Inhalt einer Nachricht in ein Message Objekt einfügen zu können oder diesen zu erhalten. Es ist die grundlegende Datenkomponente in der JavaMail API und stellt eine gemeinsame Schnittstelle zwischen der Message und der BodyPart Class dar Die Message Attribute Die Message Class fügt zu den vompart Interface geerbten Attributen eine Menge von eigenen

8 Seite 6 Standardattributen hinzu 3. Diese Attribute schließen die Adressen von Sender und Empfänger ein, sowie den Betreff, einige Flags 4 und die gesendeten- und empfangenen Daten. Die Message Class unterstützt auch Nicht-Standardattribute in der Form von Kopfinformationen Das contenttype Attribut Das contenttype Attribut bestimmt, der MIME Spezifikation RFC2045 folgend, den Datentyp des Inhalts. Ein MIME Typ setzt sich zusammen aus einem primären Typ, der den allgemeinen Typ des Inhalts beschreibt, und einem Untertyp, der ein spezielles Format des Inhalts definiert. Außerdem werden optionale Typ-spezifische Parameter bereitgestellt Die Address Class Die Address Class steht für eine adresse. Sie ist eine abstrakte Klasse. Bei der Versendung von s steht die davon abgeleitete InternetAddress Class zur Instanzierung bereit Die BodyPart Class Die BodyPart Class ist eine abstrakte Klasse, die das Part Interface implementiert. Dadurch werden die Attribute und Definitionen zum Rumpfinhalt definiert. Allerdings deklariert die BodyPart Class die Attribute der From, To, Subject und ReplyTo Felder oder andere Adressfelder der Kopfinformation nicht, wie dies ein Message Objekt tut. Ein BodyPart Objekt ist dafür vorgesehen, dass es in einen Multipart Container eingefügt wird Die Multipart Class Mit der Multipart Class werden mehrteilige Nachrichten realisiert. Eine Multipart Nachricht ist ein Message Objekt, bei dem der Content-Type auf multipart gesetzt wurde. Die Multipart Class ist eine Container Klasse, die Objekte vom Typ BodyPart enthält. Ein BodyPart Objekt enthält entweder ein neues Multipart Container Objekt oder ein DataHandler Objekt. Die folgende Abbildung zeigt die Struktur und den Inhalt einer Multipart Nachricht: 3 Informationen über die in der Message Class definierten Standardattribute sind in der JavaMail API Dokumantation (Javadoc) einsehbar. 4 Flags beschreiben den Zustand des Message Objekts in dem Ordner (Folder), in dem es enthalten ist.

9 Seite 7 Message Header Attributes Normale Nachricht, die ein Content-Type Attribut enthält, das auf multipart gesetzt ist. Content Body Normale Nachricht, deren Rumpfinhalt vom Typ Multipart ist. Multipart Object Bodypart Object Header Attributes Attribute, nur durch das Part Interface definiert. Enhält ein zweites Content-Type Feld Content Body Kann bestehen aus einem DataHandler Objekt, das Daten enthält oder einem anderen Multipart Objekt.. Bodypart Object Abbildung 4 Es zeigt sich, dass Multipart Objekte in einer Multipart Nachricht verschachtelt werden können. Damit lassen sich entsprechende Datenstrukturen, die in DataHandler Objekten transportiert werden, abbilden. Deshalb ist eine Überprüfung der Content-Type Kopfinformation für jedes BodyPart Element, das in einem Multipart Container gespeichert wird, unerlässlich. Ein Client wird also die getcontenttype Methode aufrufen, um den Content-Type der Nachricht zu erhalten. Gibt getcontenttype einen MIME-Typ zurück, dessen primärer Typ multipart ist, so wird der Client die getcontent Methode aufrufen, um das Multipart Container Objekt zu erhalten. Das Multipart Objekt unterstützt verschiedene Methoden, um BodyPart Objekte erhalten, erzeugen und löschen zu können: public int getcount() throws MessagingException; public Body getbodypart(int index) throws MessagingException; public void addbodypart(bodypart part) throws MessagingException; public void removebodypart(bodypart body) throws MessagingException; public void removebodypart(int index) throws MessagingException; Die Multipart Class implementiert das javax.beans.datasource Interface. Es kann tätig sein als DataSource Objekt für die javax.beans.datahandler und

10 Seite 8 javax.beans.datacontenthandler Objekte. Dadurch wird eine wirkungsvollere Behandlung der Datenquellen vom Typ multipart ermöglicht, da die Daten bereits schon als individuelle Teile bereitgestellt sind. Das folgende Codestück zeigt das Abholen eines Multipart Objektes: Multipart mp = (Multipart)message.getContent(); int count = mp.getcount(); BodyPart body_part; for (int i=0; i<count; i++) body_part = mp.getbodypart(i); 2.4 Das JavaBeans Activation Framework JavaMail steht in enger Verbindung zum JavaBeans Activation Framework, um die MIME Datentypen und die zu den Daten verfügbaren Kommandos zu bestimmen und um eine Softwarekomponente zu unterstützen, die einem besonderen Verhalten entspricht 5. Es wird im folgenden beschrieben, wie die JavaMail und die JAF API zusammenarbeiten, um den Inhalt einer Nachricht zu verarbeiten. Zugriff auf den Inhalt einer Nachricht Das javax.mail.part Interface erlaubt es einem Client, auf den Inhalt einer Nachricht zuzugreifen. Das Interface besteht aus einer Menge von Attributen und dem Inhalt. Es ist das gemeinsame Basisinterface für Messages und BodyParts. Für den Zugang zum Inhalt wird der DataHandler vom Part Interface verwendet. Mit diesem DataHandler wird der Inhalt entweder als ein InputStream oder als ein Objekt der Java Programmiersprache zur Verfügung gestellt. Das Part Interface definiert auch komfortable Methoden, deren Aufruf über den DataHandler erfolgt, wie beispielsweise die Part.getContent Methode (was der Methode Part.getDataHandler().getContent() entspricht) oder die Methode Part.getInputStream (was Part.getDataHandler().getInputStream() entspricht). Welcher Inhalt zurückgegeben wird, hängt vom MIME Typ ab. JavaMail API Komponenten können auf den Inhalt Mechanismen zugreifen: einer Nachricht mittels der folgenden als input stream: Das Part Interface deklariert die getinputstream Methode, die einen input stream an den Inhalt zurückgibt. Dabei ist zu bedenken, dass Part Implementierungen jede nachrichtspezifische Übertragungscodierung entschlüsseln müssen, bevor der input stream unterstützt werden kann. als ein DataHandler Objekt: Das Part Interface deklariert die getdatahandler Methode, die ein javax.activation.datahandler Objekt, das den Inhalt einschließt, zurückgibt. als ein Objekt der Java Programmiersprache: Das Part Interface deklariert die getcontent Methode, die den Inhalt als ein Objekt der Java Programmiersprache zurückgibt. Der Typ des zurückgegebenen Objekts ist abhängig vom Datentyp des Inhalts. Ist der Inhalt vom 5 Die JAF Spezifikation ist ein Teil der Glasgow JavaBeans Spezifikation. Mehr Details sind unter zu finden.

11 Seite 9 Typ multipart, so gibt die getcontent Methode ein Multipart Objekt oder Multipart Unterklassen Objekt zurück. Bei unbekanntem Typ gibt die getcontent Methode einen input stream zurück. Es gilt zu beachten, dass die getcontent Methode intern den DataHandler verwendet, um die ursprüngliche Form zu erhalten. Beispiel für ein Part Objekt, das einen aus Text bestehenden Inhalt besitzt: Die Part.getContentType Methode gibt text/plain zurück. Die Part.getInputStream Methode gibt einen InputStream zurück, der die Bytes des Textes enthält. Die Part.getContent Methode gibt ein java.lang.string Objekt zurück. Wird ein InputStream zurückgegeben, so wird jede nachrichtspezifische Codierung entschlüsselt, bevor der Stream zurückgegeben wird. Wird ein Objekt der Java Programmiersprache unter Verwendung der getcontent Methode zurückgegeben, so hängt der Typ des zurückgegeben Objekts von dessen Inhalt ab. In der JavaMail API gibt jedes Part Objekt, bei dem der Content-Type auf den Wert multipart/ gesetzt ist, ein javax.mail.multipart Objekt zurück, wenn die getcontent Methode aufgerufen wurde. Ein Part Objekt mit einem Content-Type, der den Wert message/rfc822 enthält, wird ein javax.mail.message Objekt zurückgeben, wenn die getcontent Methode aufgerufen wurde. Beispiel zum Anzeigen des Inhalts einer Nachricht:

12 Seite 10 public void printparts(part p) Object o = p.getcontent(); if (o instanceof String) System.out.println( Dies ist ein String ); System.out.println((String) o); else if (o instanceof Multipart) System.out.println( Dies ist ein Multipart ); Multipart mp = (Multipart) o; int count = mp.getcount(); for (int i=0; i<count; i++) printparts(mp.getbodypart(i)); else if (o instanceof InputStream) System.out.println( Dies ist ein InputStream ); InputStream is = (InputStream) o; int c; while ((c = is.read())!= -1) System.out.write(c); 2.5 Message Komposition Dieser Abschnitt beschreibt die Instanzierung eines Message Objekts, das Anfügen des Inhalts und das Versenden an eine Liste von Empfängern. Die JavaMail API erlaubt es einem Client eine Nachricht mit beliebiger Komplexität zu erzeugen. Erstellen eines Message Objekts Eine Nachricht wird erzeugt, indem ein Client eine von der Message Class abgeleitete Klasse instanziert, passende Attribute setzt und den Inhalt einfügt. Die Attribute spezifizieren die Adresse der Nachricht und andere Werte, die zum Versenden, Weiterleiten, Empfangen, Entschlüsseln und Speichern der Nachricht nötig sind. Attribute beschreiben außerdem die Struktur und den Datentyp des Inhalts einer Nachricht. Erzeugen einer Nachricht javax.mail.message ist eine abstrakte Klasse, die das Part Interface implementiert. Deshalb wird zur Erzeugung eines Message Objektes eine Unterklasse vonmessage ausgewählt, die den

13 Seite 11 passenden Nachrichtentyp implementiert. Zum Beispiel wird ein JavaMail Client zur Erzeugung einer MIME Nachricht ein leeres javax.mail.internet.mimemessage Objekt instanzieren, dem das aktuelle Session Objekt übergeben wird: Message msg = new MimeMessage(session); Setzen der Message Attribute Die Message Class unterstützt eine Menge von Methoden, die Standardattribute beschreiben, die allen Nachrichten gemeinsam sind. Die MimeMessage Class unterstützt zusätzliche Methoden, mit denen MIME-spezifische Attribute gesetzt werden. Das Client Programm kann auch nicht-standard Attribute als Name-Wert-Paare setzen. Die Methoden, mit denen Standardattribute gesetzt werden, werden im folgenden aufgelistet: public class Message public void setfrom(address addr); public void setfrom(); // retrieves from system public void setrecipients(recipienttype type, Address[] addrs); public void setreplyto(address[] addrs); public void setsentdate(date date); public void setsubject(string subject);... Das Part Interface spezifiziert die folgende Methode, die eine Kopfinformation setzt: public void setheader(string name, String value); Der setrecipients Methode (MimeMessage Class) wird als erster Parameter der RecipientType übergeben, der beschreibt, welches Empfängerfeld zu verwenden ist. Momentan sind Message.RecipientType.TO, Message.RecipientType.CC, Message.RecipientType.BCC definiert 6. Die Message Class unterstützt zwei Versionen der setfrom Methode: setfrom(address addr) beschreibt den Sender mit einem Address Objekt Parameter. setfrom() erhält den Benutzername des Senders vom lokalen System. Beispiel für das Setzen von Attributen für ein MimeMessage Objekt: toaddrs[] = new InternetAddress[1]; toaddrs[0] = new InternetAdress( mustermann@beispiel.de ); Address fromaddr = new InternetAddress( musterfrau@example.com ); msg.setfrom(fromaddr); msg.setrecipients(message.recipienttype.to, toaddrs); msg.setsubject( Hallo ); msg.setsentdate(new Date()); 6 Weitere RecipientType(s) können definiert werden, falls nötig.

14 Seite 12 Setzen des Nachrichteninhalts Um den Inhalt einer Nachricht an ein Message Objekt zu übergeben, erzeugt ein Client den gewünschten Inhalt, instanziert ein DataHandler Objekt, plaziert den Inhalt in das DataHandler Objekt und setzt dieses Objekt dann in ein Message Objekt, dessen Attribute definiert wurden. Die JavaMail API unterstützt zwei Arten zum Setzen des Nachrichteninhalts: 1. Clients fügen den Inhalt in ein DataHandler Objekt ein und rufen die Methode setdatahandler(datahandler) eines Message Objektes auf. Die Daten werden dem Konstruktor des DataHandler Objektes entweder als DataSource (ein stream, der mit den Daten verbunden ist) oder als Objekt der Java Programmiersprache übergeben. public class DataHandler DataHandler(DataSource datasource); DataHandler(Object data, String mimetype); Das folgende Beispiel zeigt, wie ein Textinhalt in eine Nachricht eingefügt wird. Zuerst wird der Text als ein Stringobjekt erzeugt, dann der String dem DataHandler Objekt zusammen mit dem MIME Typ übergeben. Schließlich wird das DataHandler Objekt an das Message Objekt angefügt. //create message text String content = Hallo ; // instantiate the DataHandler object DataHandler data = new DataHandler(content, text/plain ); // use setdatahandler() to insert data into the new message // object msg.setdatahandler(data); 2. Mit der setcontent Methode ist eine einfachere Technik gegeben. Ihr wird das Datenobjekt und der MIME Typ als Parameter übergeben, wobei dann das DataHandler Objekt automatisch erzeugt wird. //create message text String content = Hallo ; // call setcontent to pass content and content type together // into the message object msg.setcontent(content, text/plain ); Der Client kann diese Nachricht dann senden mit dem Aufruf Transport.send(). Erstellen einer MIME Multipart Message Zuerst wird ein neues MimeMultipart Objekt instanziert oder von einer Unterklasse eine Instanz erzeugt. Dann werden die für diese Nachrichtenteile benötigten MimeBodyPart Objekte erzeugt.

15 Seite 13 Mit den MethodensetContent oder setdatahandler wird der Inhalt für jedes BodyPart Objekt erstellt 7. Mit der setcontent(multipart) Methode wird dann das Multipart Objekt in ein neues Message Objekt eingefügt. Das folgende Beispiel erzeugt ein Multipart Objekt und fügt dann zwei Nachrichtenteile ein. Der erste Teil ist ein Textstring, der zweite Teil enthält ein Dokument vom Typ application/postscript. Schließlich wird dieses Multipart Objekt in ein MimeMessage Objekt eingefügt. // Instantiate a Multipart object MimeMultipart mp = new MimeMultipart(); // create the first bodypart object MimeBodyPart b1 = new MimeBodyPart(); // create textual content and add it to the bodypart object b1.setcontent( Hallo, text/plain ); mp.addbodypart(b1); // create second bodypart and place it into the multipart message MimeBodyPart b2 = new MimeBodyPart(); b2.setcontent(map, application/postscript ); mp.addbodypart(b2); // create a new message object Message msg = new MimeMessage(session); // set message attributes as in a singlepart message // add Multipart msg.setcontent(mp); // save changes msg.savechanges(); Nachdem alle Nachrichtenteile erzeugt und eingefügt sind, kann die savechanges Methode aufgerufen werden, um sicherzustellen, dass der Client passende Kopfinformationen für die Nachricht schreibt Die Mail Session Ein Session Objekt verwaltet die Einstellungen zur Konfiguration und die Informationen zur Benutzerauthentifizierung, die bei der Kommunikation mit Nachrichtensystemen gebraucht werden. 7 Der voreingestellte Untertyp eines MimeMultipart Objektes ist mixed, kann aber bei Bedarf geändert werden. 8 Die JavaMail API ruft die savechanges Methode implizit während dem send Prozess auf. Dies bedeutet, dass ein Aufruf nicht notwendig ist, wenn eine Nachricht unmittelbar gesendet werden soll.

16 Seite 14 Um eine Session Objekt zu erzeugen, wird die statische Methode getinstance aufgerufen: Session session = Session.getInstance(props, authenticator); Um auf die voreingestellte Sitzung zuzugreifen, wird die Methode getdefaultinstance verwendet: Session defaultsession = Session.getDefaultInstance(props, authenticator); Das Properties Objekt, das die Sitzung initialisiert, enthält voreingestellte Werte und andere Konfigurationsinformationen. Es wird erwartet, dass Clients, die diese API verwenden, die Werte für die Eigenschaften setzen, besonders mail.store.protocol, mail.transport.protocol, mail.host, mail.user und mail.from, da es unwahrscheinlich ist, dass die Voreinstellungen auch passend sind. Das Authenticator Objekt kontrolliert den Sicherheitsaspekt für ein Session Objekt. Das Nachrichtensystem verwendet es als Rückfrage-Mechanismus, um mit dem Benutzer zu kommunizieren, wenn ein Passwort erforderlich ist. 2.7 Transportprotokolle und Mechanismen Die abstrakte Transport Class definiert die Übermittlung einer Nachricht und das Transportprotokoll. Unterklassen der Transport Class implementieren SMTP und andere Transportprotokolle. Transport Objekt Die gettransport Methode erhält ein Transport Objekt von einem Session Objekt. Es werden von der JavaMail API drei Versionen unterstützt: public class Session public Transport gettransport(address address); public Transport gettransport(string protocol); public Transport gettransport(); Die gettransport(address address) Methode gibt die Implementation der Transport Class zurück, die auf dem Adresstyp basiert. Eine vom Benutzer erweiterbare Zuordnung definiert, welcher Transporttyp bei einer bestimmten Adresse zu verwenden ist. Wird beispielsweise eine InternetAddress verwendet und die InternetAddress ist einem Protokoll zugeordnet, das SMTP unterstützt, so wird SMTPTransport zurückgeben. Der Client kann auch gettransport( SMTP ) aufrufen, um eine SMTP-Anfrage zu stellen, oder ein anderes Transportprotokoll. gettransport() gibt die in der mail.transport.protocol Eigenschaft definierte Transportart zurück. Transport Methoden Die Transport Class unterstützt die connect und protocolconnect Methoden. Das Transport Objekt erzeugt ein ConnectionEvent, um dem Listener eine erfolgreiche oder fehlgeschlagene Verbindung zu melden. Das Transport Objekt kann eine IOException auslösen, wenn die Verbindung fehlschlägt.

17 Seite 15 Zum Versenden einer Nachricht wird die statische Methode Transport.send oder die sendmessage Methode verwendet. Die Transport.send Methode ist eine komfortable Methode, die das zum Versenden einer Nachricht notwendige Transport Objekt abhängig von den Empfängeradressen instanziert und dann die Nachricht an die sendmessage Methode des entsprechenden Transport Objektes übergibt. Alternativ dazu kann der Client das Transport Objekt erhalten, das selbst ein besonderes Protokoll implementiert und dann die Nachricht mit der sendmessage Methode versenden. Dies hat den Vorteil, dass eine Registrierung als event listener für ein individuelles Transport Objekt möglich ist. Transport Events Clients können sich als Listener für Ereignisse, die von Transportimplementationen erzeugt werden, registrieren. Die abstrakte Transport Class löst allerdings keine Ereignisse aus, nur einige besondere Protokollimplementationen lösen Ereignisse aus. Es werden zwei Ereignisse erzeugt: ConnectionEvent und TransportEvent: Wenn die Transportverbindung erfolgreich hergestellt ist, wird ein ConnectionEvent vom Typ OPENED ausgelöst. Wurde die Verbindung geschlossen oder eine bestimmte Zeit überschritten, so wird ein ConnectionEvent vom Typ CLOSED erzeugt. Die sendmessage Methode löst ein TransportEvent an dessen Listener aus. Dieses Ereignis enthält Informationen über den Erfolg oder das Fehlschlagen der Methode. Es gibt drei Typen von TransportEvent: MESSAGE_DELIVERED, MESSAGE_NOT_DELIVERED, MESSAGE_PARTIALLY_DELIVERED. Das Ereignis enthält drei Bereichsvariablen von Adressen: validsent[], validunsent[] und invalid[]. Diese listen die gültigen und ungültigen Adressen für diese Nachricht und dieses Protokoll auf. Transport Event: MESSAGE_DELIVERED MESSAGE_NOT_DELIVERED Beschreibung: Wenn die Nachricht erfolgreich an alle Empfänger versendet wurde. validsent[] enthält dann alle Adressen. validunsent[] und invalid[] sind null. Wenn validsent[] null ist, so wurde die Nachricht an keinen Empfänger erfolgreich versendet. validunsent[] kann Adressen enthalten, die gültig sind. invalid[] kann ungültige Adressen enthalten. MESSAGE_PARTIALLY_DELIVERED Die Nachricht wurde an einige Empfänger erfolgreich versendet, aber nicht an alle. validsent[] enthält die Adressen der Empfänger, an die die Nachricht geschickt wurde. validunsent[] enthält gültige Adressen, die Nachricht wurde aber nicht an sie versandt. invalid[] enthält ungültige Adressen. Verwendung der Transport Class Das folgende Beispiel zeigt die Versendung einer MimeMessage. Es wird eine Transport Class verwendet, die das SMTP Protokoll implementiert. Der Client erzeugt zwei InternetAddress Objekte, die die Empfänger spezifizieren. Er erhält dann ein Transport Objekt von der voreingestellten Session zurück. Dieses unterstützt dann das Versenden von Nachrichten an Internetadressen. Abschließend wird mit Hilfe des Transport Objekts die Nachricht versandt.

18 Seite 16 // get a session Session session = Session.getInstance(props, null); // create an empty MimeMessage and its part Message msg = new MimeMessage(session);... add headers and message parts as before // create two destination addresses Address[] addrs = new InternetAddress( mickey@disney.com ), new InternetAddress( goofy@disney.com ); // get a transport that can handle sending message to // InternetAddresses. This will probably map to a tranport that // supports SMTP. Transport trans = session.gettransport(addrs[0]); // add ourselves as ConnectionEvent and TransportEvent listeners trans.addconnectionlistener(this); trans.addtransportlistener(this); // connect method determines what host to use from the session // properties trans.connect(); // send the message to the addresses specified above trans.sendmessage(msg, addrs); 2.8 Programmbeispiel /* * MailClient.java * * Project: Vorlesung Internet 2 im Wintersemester 2000/2001 * Vortrag: Versenden von s mit der JavaMail API */ package mailclient; import java.io.*; import java.awt.*; import java.awt.event.*; import java.util.*; import javax.swing.*; import javax.mail.*; import javax.mail.internet.*; import javax.activation.*; /** * Class to send simple s. *

19 Seite 17 Klaus Köhle 0.1, November 2000 */ public class MailClient extends JFrame... /** * Erzeugen, Zusammenstellen und Versenden der . */ void jbuttonsendmail_actionperformed(actionevent ae) MimeMessage msg; int count = 0; Address[] tos; // Objekt für die zu versendende Nachricht // Address-Array zur Zwischenspeicherung der // Empfängeradressen Properties props = new Properties(); props.put("mail.host", prefs.getnam server()); props.put("mail.transport.protocol", prefs.gettyp server()); try Authenticator authent = new Authenticator(); Session mailconnection = Session.getInstance(props, authent); msg = new MimeMessage(mailConnection); // Headerinfos holen Address from = new InternetAddress(getSender()); // AddressException // bei fehlerhafter Adresse, getsender() löst eine // RuntimeException aus, wenn keine Adresse gefunden msg.setfrom(from); // Absender setzen String[] address = gettoaddresses(); // gettoaddresses() löst eine // RuntimeException aus, wenn // keine Adresse gefunden. tos = new Address[address.length]; for (int i=0; i<address.length; i++) tos[i]= new InternetAddress(address[i]); msg.setrecipients(message.recipienttype.to, tos);// Empfänger setzen msg.setsubject(getsubject()); // Betreff setzen // Multipart Objekt MimeMultipart mp = new MimeMultipart(); // MimeBodyPart Objekt für Text aus Editor MimeBodyPart bptext = new MimeBodyPart(); String plainstr = maileditor.gettext(); bptext.setcontent(plainstr, "text/plain"); // Content-Type setzen mp.addbodypart(bptext); // bodypart Objekt in Text-MultiPart // MimeBodyPart Objekt für Attachements String[] attach = getadds(); if (attach!= null) count = attach.length; if (count > 0) for (int i=0; i<count;i++) // bodypart Objekt erzeugen MimeBodyPart bpattach = new MimeBodyPart(); // gewünschtes Objekt holen und verpacken FileDataSource fds = new FileDataSource(attach[i]); bpattach.setdatahandler(new DataHandler(fds)); bpattach.setfilename(fds.getname());

20 Seite 18 bpattach.setdisposition(mimepart.attachment); // bodypart Objekt hinzufügen mp.addbodypart(bpattach); msg.setcontent(mp); // Multipart Objekt setzen msg.setsentdate(new Date()); // Datum setzen if (getpriority()!= null) // Priorität setzen msg.setheader("x-priority", getpriority()); // Message in String packen und auf Konsole ausgeben ByteArrayOutputStream bos = new ByteArrayOutputStream(); msg.writeto(bos); String tempstr = bos.tostring(); System.out.println("************* Message: *************\n" + tempstr); // send the message Transport.send(msg); catch (Exception e) showmessage(e.tostring());.. //Main-Methode public static void main(string[] args) MailClient mc = new MailClient(); mc.pack(); mc.setvisible(true);

21 Seite 19 Kapitel 3 Anhang 3.1 Literaturverzeichnis Harold Elliotte Rusty, Java Network Programming, Second Edition, O Reilly & Associates 2000, Mani John, Shannon Bill, u.a., JavaMail API. Design Specification Version 1.2, Sun Microsystems Inc. (Hrsg.), Palo Alto Abkürzungsverzeichnis Abkürzung: Volltext: ACL Access Control Lists API Application Program Interface FTP File Transfer Protocol HTML Hypertext Markup Language IMAP Internet Message Access Protocol JAF JavaBeans Activation Framework LMTP Local Mail Transfer Protocol MDA Mail Delivery Agent MD5 Message Digest Algorithm 5 MIME Multipurpose Internet Mail Extensions MSA Mail Submission Agent MTA Mail Transfer Agent MUA Mail User Agent POP 3 Post Office Protocol Version 3 RFC Request for Comment SMTP Simple Mail Transfer Protocol TFTP Trivial File Transfer Protocol URL Uniform Resource Locator