0N/A README

0N/A ======

0N/A

121N/A JavaMail(TM) API ${mail.version} release

0N/A ------------------------------

0N/A

121N/AWelcome to the JavaMail API ${mail.version} release! This release includes

0N/Aversions of the JavaMail API implementation, IMAP, SMTP, and POP3

0N/Aservice providers, some examples, and documentation for the JavaMail

0N/AAPI.

0N/A

324N/APlease see the FAQ at http://www.oracle.com/technetwork/java/javamail/faq/

0N/A

0N/AJDK Version notes

0N/A-----------------

0N/A

549N/AThe JavaMail API supports JDK 1.5 or higher. Note that we have

732N/Acurrently tested this implementation with JDK 1.5, 1.6, 1.7, and 1.8.

0N/A

0N/AWhile JavaMail will work with JAF 1.0.2, we recommend the use of JAF 1.1

0N/Aor newer. JAF 1.1.1 is currently the newest version. Note that JAF 1.1

129N/Ais included in JDK 1.6 and JAF 1.1.1 is included in JDK 1.6.0_10 and

129N/Alater.

0N/A

0N/A

0N/AProtocols supported

0N/A-------------------

0N/A

0N/AThis release supports the following Internet standard mail protocols:

0N/A

0N/A IMAP - a message Store protocol, for reading messages from a server

0N/A POP3 - a message Store protocol, for reading messages from a server

0N/A SMTP - a message Transport protocol, for sending messages to a server

0N/A

0N/AThe following table lists the names of the supported protocols (as used

0N/Ain the JavaMail API) and their capabilities:

0N/A

0N/A Protocol Store or Uses Supports

0N/A Name Transport? SSL? STARTTLS?

0N/A -------------------------------------------------

0N/A imap Store No Yes

379N/A imaps Store Yes N/A

479N/A gimap Store Yes N/A

379N/A pop3 Store No Yes

379N/A pop3s Store Yes N/A

0N/A smtp Transport No Yes

379N/A smtps Transport Yes N/A

0N/A

324N/ASee our web page at http://www.oracle.com/technetwork/java/javamail/

324N/Afor the latest information on third party protocol providers.

0N/A

0N/A

549N/ADownload

0N/A--------

0N/A

549N/ASee the JavaMail project page to download this release.

0N/A

732N/A https://javamail.java.net

0N/A

0N/A

0N/ARequirements

0N/A------------

0N/A

0N/ANote that the JavaMail API requires the JavaBeans(TM) Activation

549N/AFramework package to be installed as well if you're using JDK 1.5.

549N/ADownload the latest version of the JavaBeans Activation Framework from

0N/A

324N/A http://www.oracle.com/technetwork/java/javase/index-jsp-136939.html

0N/A

0N/Aand install it in a suitable location.

0N/A

0N/A

0N/AInstallation

0N/A------------

0N/A

0N/A UNIX/Linux

0N/A ----------

0N/A

549N/A 1. Download the javax.mail.jar file from the JavaMail project website.

549N/A http://java.net/projects/javamail/downloads/download/javax.mail.jar

0N/A

549N/A 2. Set your CLASSPATH to include the "javax.mail.jar" file obtained from

549N/A the download, as well as the current directory.

0N/A

549N/A Assuming you have downloaded javax.mail.jar to the /u/me/download/

549N/A directory, the following would work:

0N/A

549N/A export CLASSPATH=$CLASSPATH:/u/me/download/javax.mail.jar:.

0N/A

549N/A (Don't forget the trailing "." for the current directory.)

549N/A Also, if you're using JDK 1.5, include the "activation.jar" file that you

549N/A obtained from downloading the JavaBeans Activation Framework. For example:

0N/A

0N/A export CLASSPATH=$CLASSPATH:/u/me/download/activation/activation.jar

0N/A

549N/A 3. Download the javamail-samples.zip file from the project website.

549N/A http://java.net/projects/javamail/downloads/download/javamail-samples.zip

0N/A

549N/A 4. Compile any sample program using your Java compiler. For example:

0N/A

0N/A javac msgshow.java

0N/A

549N/A 5. Run the sample program. The '-' option lists the required and optional

549N/A command-line options to successfully run any sample. For example:

0N/A

0N/A java msgshow -

549N/A

549N/A lists the available options. And

0N/A

0N/A java msgshow -T imap -H <mailserver> -U <username> -P <passwd> -f INBOX 5

549N/A

0N/A uses the IMAP protocol to display message number 5 from your INBOX.

0N/A

549N/A (Additional instructions on how to run the simple mail reader sample

549N/A and servlet sample are provided in client/README.txt and servlet/README.txt,

549N/A respectively.)

0N/A

0N/A

0N/A Windows

0N/A -------

0N/A

549N/A 1. Download the javax.mail.jar file from the JavaMail project website.

549N/A http://java.net/projects/javamail/downloads/download/javax.mail.jar

0N/A

549N/A 2. Set your CLASSPATH to include the "javax.mail.jar" file obtained from

549N/A the download, as well as the current directory.

0N/A

549N/A Assuming you have downloaded javax.mail.jar to the /u/me/download/

549N/A directory, the following would work:

0N/A

549N/A set CLASSPATH=%CLASSPATH%;c:\download\javax.mail.jar;.

549N/A

549N/A (Don't forget the trailing "." for the current directory.)

549N/A Also, if you're using JDK 1.5, include the "activation.jar" file that you

549N/A obtained from downloading the JavaBeans Activation Framework. For example:

0N/A

0N/A set CLASSPATH=%CLASSPATH%;c:\download\activation\activation.jar

0N/A

549N/A 3. Download the javamail-samples.zip file from the project website.

549N/A http://java.net/projects/javamail/downloads/download/javamail-samples.zip

549N/A

549N/A 4. Compile any sample program using your Java compiler. For example:

0N/A

0N/A javac msgshow.java

0N/A

549N/A 5. Run the sample program. The '-' option lists the required and optional

549N/A command-line options to successfully run any sample. For example:

0N/A

0N/A java msgshow -

0N/A

549N/A lists the available options. And

0N/A

0N/A java msgshow -T imap -H <mailserver> -U <username> -P <passwd> -f INBOX 5

549N/A

0N/A uses the IMAP protocol to display message number 5 from your INBOX.

0N/A

549N/A (Additional instructions on how to run the simple mail reader sample

549N/A and servlet sample are provided in client/README.txt and servlet/README.txt,

549N/A respectively.)

0N/A

0N/A

0N/AProblems?

0N/A---------

0N/A

324N/AThe JavaMail FAQ at http://www.oracle.com/technetwork/java/javamail/faq/

324N/Aincludes information on protocols supported, installation problems,

324N/Adebugging tips, etc.

0N/A

0N/ASee the NOTES.txt file for information on how to report bugs.

0N/A

0N/AEnjoy!

0N/A

0N/AThe JavaMail API Team