JavaMail

1. JavaMail • JavaMail Classes • Sending a Message Using JavaMail (MessageSend.java) • Sending a Message to Multiple Recipients • (SendToMany.java) • Installing JavaMail

2. E-mail Protocols • Message Store Protocols: Read messages from a server • Internet Message Access Protocol (IMAP) • Post Office Protocol (POP) • Message Transport Protocols: Send messages to a server (i.e. Simple Mail Transfer Protocol (SMTP)) • Multipurpose Internet Mail Extensions (MIME): Standard for describing e-mail messages

3. Classes to Send E-mail • Address: Abstract class representing any e-mail address • Message: Abstract message class • Header: Collection of attribute fields for a message • Content: Object representing a part of a message (i.e. text or an attachment) • Transport: Object representing a transport protocol that allows e-mail messages to be sent, implemented by a specific protocol • Session: Provides an interface between the e-mail client and the network, supporting the creation of and access to Store and Transport objects

4. Specific Implementations • InternetAddress: Object representing an e-mail address • MimeMessage: Object representing a specific e-mail message

5. Other JavaMail Classes • Store: Object representing database and access protocol for storing and accessing messages and folders, implemented by a specific protocol • Folder: Contains e-mail messages and subfolders and supports reading and deleting them • MailEvent: Can be registered with event listeners to catch events generated by Transport, Store, and Folder objects (i.e. announce arrival of new e-mail)

6. Java.util.Properties Class • Extends HashMap • Designed to contain a persistent set of properties that may be saved to or loaded from a stream • All keys and values must be Strings • Although it supports HashMap methods for handling Objects, use of the following is recommended to ensure that it contains Strings: • public Object setProperty(String key, String value) • public String getProperty(String key)

7. Example 1: MessageSend.javaSends an e-mail address from one person to another import java.io.*; import java.net.InetAddress; import java.util.Properties; import java.util.Date; import javax.mail.*; import javax.mail.internet.*; E-mail address class Properties class will be discussed Directory containing abstract mail classes Internet e-mail classes

8. createSession() Gets the default system properties public Session createSession() { Properties p = System.getProperties(); p.setProperty("mail.transport.protocol", "smtp"); p.setProperty("mail.smtp.host","andrew.cmu.edu"); Sets the transport protocol to SMTP and sets the appropriate SMTP host for CMU

9. Sets the store protocol to IMAP and sets the appropriate SMTP host for CMU (not really needed unless the application will read e-mail) p.setProperty("mail.store.protocol","imap"); p.setProperty("mail.imap.host","cyrus.andrew.cmu.edu"); Session sess = Session.getDefaultInstance(p); return sess; } Instantiates a session using the new properties object

10. createMessage() public Message createMessage(Session sess) throws MessagingException{ Message mess = new MimeMessage(sess); Base exception class for Internet mail Default Constructor for a MimeMessage takes a session object

11. 2 Methods to create an InternetAddress: • Constructor that takes a String: InternetAddress(String address) • static InternetAddress parse(String listOfAddresses, boolean strict) • (A false indicates the addresses may be space or comma delimited) mess.setFrom(new InternetAddress("mm6@andrew.cmu.edu")); mess.setRecipients(Message.RecipientType.TO, InternetAddress.parse("bob@andrew.cmu.edu", false)); mess.setSubject("Test"); mess.setText("This is a test of JavaMail's functionality."); mess.setSentDate(new Date()); return mess; } setRecipients(MessageRecipientType type, String address) MessageRecipientType may be TO, CC, or BCC

12. main() public static void main(String[] args) { MessageSend send = new MessageSend(); Session sess = send.createSession(); try { Message mess = send.createMessage(sess); Transport.send(mess); } catch(MessagingException e) { System.out.println("Messaging Exception: "+e); } } A static method of the Transport class saves and sends a message

13. Example 2:MessageSendToManySends a message to a group of addresses import java.io.*; import java.net.InetAddress; import java.util.Properties; import java.util.Date; import javax.mail.*; import javax.mail.internet.*; public class MessageSendToEach { public Session createSession() { Properties p = System.getProperties(); p.setProperty("mail.transport.protocol", "smtp"); p.setProperty("mail.smtp.host","andrew.cmu.edu"); p.setProperty("mail.store.protocol","imap"); p.setProperty("mail.imap.host","cyrus.andrew.cmu.edu"); Session sess = Session.getDefaultInstance(p); return sess; } Almost everything is the same

14. createMessage() public Message createMessage(Session sess)throws MessagingException, UnsupportedEncodingException { Message mess = new MimeMessage(sess); InternetAddress[] recip = new InternetAddress[6]; InternetAddress[] reply = new InternetAddress[1]; reply [0] = new InternetAddress("dmedvan@andrew.cmu.edu“, “Danielle Medvan”); Note the additional exception being thrown Another constructor for an InternetAddress: InternetAddress(String address, String identifyingName) This throws an UnsupportedEncodingException if the e-mail software does not support the character encoding in which the name is provided

15. recip[0]= new InternetAddress("garya@andrew.cmu.edu", "Gary"); recip[1]= new InternetAddress(“ma3q@andrew.cmu.edu”, “Martin"); recip[2]= new InternetAddress(“romoff@andrew.cmu.edu”, “Rebecca"); recip[3]= new InternetAddress(“marks215@home.com”, “Mark"); recip[4]= new InternetAddress(“ginas@andrew.cmu.edu”, “Gina"); recip[5]= new InternetAddress(“cameronw@andrew.cmu.edu”, “Cameron"); mess.setFrom(new InternetAddress("mm6@andrew.cmu.edu"));

16. mess.setReplyTo(reply); mess.setRecipients(Message.RecipientType.TO,recip); mess.setSubject("Test"); mess.setText("This is a test of JavaMail's functionality."); mess.setSentDate(new Date()); return mess; } The “reply-to” address is set with setReplyTo(Address[] addresses) We previously saw a method to set a single recipient. That method is overloaded. Now we see setRecipients(MessageRecipientType type, Address[] addresses)

17. Installation Instructions • Download the JavaMail API Implementation Version 1.2 at http://java.sun.com/products/javamail/index.html • Download the JavaBeans Application Framework (JAF) at: http://java.sun.com/products/javabeans/glasgow/jaf.html • Unzip both files. • Add the following files to your classpath: • mail.jar (JavaMail) • activation.jar (JAF file)