Apache JavaMail Implementation 1.4 ================================== These classes are based on the JavaMail Specification taken from J2EE 1.4 API documentation and on the JavaMail 1.3 specification PDF. The classes represent the JavaMail API and contain implementations of the classes found in the javax.mail packages. In order to function correctly, these classes require: o The Java Activation Framework (JAF) in javax.activation o The JavaMail API (JavaMail) in javax.mail o Java 2 (Java 1.2 or later) See http://java.sun.com/products/javamail/ http://java.sun.com/j2ee/1.4/docs/api/ for more information on how to use JavaMail to send messages. Configuration ------------- The JavaMail spec defines the following configuration files: javamail.providers [Defines which classes are used to map to protocols] javamail.address.map [Defines which message types (rfc822, news) map to protocols] They need to be in the CLASSPATH (or in a Jar) in a directory /META-INF/ e.g. c:\mymail\META-INF\javamail.providers Providers --------- Provides a protocol, along with its implementation and whether it is a store or a transport (subclass of javax.mail.Store or javax.mail.Transport) protocol=smtp;type=transport;class=org.me.MySMTPTransport;vendor=Me Inc;version=1.0 protocol=imap;type=store;class=org.me.MyIMAPStore;vendor=Me Inc;version=1.0 Address Map ----------- Contains entries in 'name=value' format: rfc822=smtp news=nntp Default ======= To ensure that other files can be extended at a later stage, the JavaMail spec defines three locations for these files: $JAVA_HOME\lib\javamail.properties META-INF\javamail.properties META-INF\javamail.default.properties The files are located in that order and overwrite whatever the previous version contained, so if 'smtp' is defined in javamail.properties and javamail.default.properties, it will use the one from javamail.default.properties