| JavaMail Specification 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 Java 2 (Java 1.2 or later) |
| o Implementations of the JavaMail providers to deal with pop/imap/etc. |
| (You may use this with the geronimo-mail implementation or write your own) |
| |
| This contains no JavaDoc: 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 |
