Skip to main content
This revision made April 02, 2013 22:48, by Bill Shannon

JavaMail API

Welcome to the JavaMail API project! This project hosts the downloads and source code for the JavaMail API reference implementation. The JavaMail reference implementation is licensed under the Common Development and Distribution License (CDDL) v1.1 and GNU General Public License (GPL) v2 with Classpath Exception.

UNDER CONSTRUCTION

This web site is still under construction after moving here from http://javamail.kenai.com and in preparation for the JavaMail 1.5 release. Please bear with us if some links aren't working yet.

Downloads

The following table provides easy access to the latest release. Most people will only need the main JavaMail reference implementation in the javax.mail.jar file.

Item Description
javax.mail.jar The JavaMail reference implementation, including the SMTP, IMAP, and POP3 protocol providers
README.txt Overview of the release
NOTES.txt Additional notes about using JavaMail
SSLNOTES.txt Notes on using SSL/TLS with JavaMail
NTLMNOTES.txt Notes on using NTLM authentication with JavaMail
CHANGES.txt Changes since the previous release
COMPAT.txt Important notes about compatibility

In addition, the JavaMail jar files are published to the Maven repository. You can find them in both the java.net Maven repository, and in Maven Central.

jar file groupId artifactId Description
javax.mail.jar com.sun.mail javax.mail The JavaMail reference implementation jar file, including the SMTP, IMAP, and POP3 protocol providers
javax.mail-api.jar javax.mail javax.mail-api The JavaMail API definitions only, suitable for compiling against
mailapi.jar com.sun.mail mailapi The JavaMail reference implementation with no protocol providers; use with one of the following providers
smtp.jar com.sun.mail smtp The SMTP protocol provider
imap.jar com.sun.mail imap The IMAP protocol provider
pop3.jar com.sun.mail pop3 The POP3 protocol provider
gimap.jar com.sun.mail gimap An EXPERIMENTAL Gmail IMAP protocol provider that supports Gmail-specific features
dsn.jar com.sun.mail dsn Support for parsing and creating messages containing Delivery Status Notifications



API Documentation

The JavaMail API is defined through the Java Community Process as JSR 919.

The JavaMail API documentation is available here and the JavaMail specification is available here.

The following documents summarize the API changes in each release of the JavaMail API specification:



Samples

Some sample programs showing how to use the JavaMail APIs are available here.

Help

Please read the JavaMail FAQ! Read it again. Tell everyone you know to read it. Thank you!

You can search for and post questions to the JavaMail forums here on java.net, and the JavaMail OTN forum. You can also join this project and subscribe to the "users" mailing list. Or, send mail directly to the JavaMail team at javamail_ww@oracle.com.

Project Documentation

You'll find more information about the protocol providers supported by JavaMail on the following pages:

If you're interested in writing your own protocol provider (most people won't need to), you can find more documentation on protocol providers [here].

The following pages provide hints and tips for using particular mail servers:

The following pages provide hints and tips for using JavaMail on particular operating systems or environments:


See Build Instructions for instructions on how to download and build the most recent JavaMail source code. You can also find a bundle of the source code for the most recent JavaMail release in the Downloads area of this project.

If you're interested in contributing to JavaMail, see the Contributions page.

To understand the JavaMail license, see the License page.

Difference compared to previous revision
= JavaMail API R= Weflcom to the JavaMail API project! This project hosts the downloads and source code for the JavaMail API reference implementation. Theerence Implementation W JavaMaikl reference mplementationi = is licensed under the T[http://glassfish.java.net/public/CDDL+GPL_1_1.html Common Development and Distributihis projon License (CDDL) v1.1 and GNU General Public License (GPL) v2 with Classpath Exception].

== UNDER CONSTRUCTION == Thi
s web site is sect hosts thtill undere s counstruction after moving here from [http://javamail.kenai.com] and in preparationrce code for the JavaMail A for the JavaMail 1.5 release. PIlease bear with us if some links aren't working yet.

== Downloads == The
following table provides easy access to the latest release. Most people will only need the main JavaMail reference implementation in the javax.mail.jar file. reference implementation. Y {|- bourder="1" ! Item ! Des cacription |- | [http://java.net/projects/javamail/downloads/download/javax.mail.jarn download t javax.mail.jar] | The JavaMail reference implementation,he JavaMail implementation b including the SMTP, IMAP, and POP3 protocol providerinaries,s |- | [http://javamail.java.net/ docudocs/README.txt README.txt] | Overview of the release |- | [http://javamail.java.net/docs/NOTES.txt NOTES.txt] | Additional notes about using JavaMail |- | [http://javamail.java.net/docs/SSLNOTES.txt SSLNOTES.txt] | Notes omentation,n using SSL/TLS with J samavaMail |- | [http://javamail.java.net/docs/NTLMNOTES.txt NTLMNOTES.txt] | Notes on using NTLM authentication with JavaMail |- | [http://javamail.java.net/docs/CHANGES.txt CHANGES.txt] | Changple code,es since the previous release |- | [http://javamail.java.net/docs/COMPAT.txt etc. f COMPAT.txt] | Important notes about compatibility |} In addition, the JavaMail jar files are published to the Maven repository.rom the [ You can find them in both he [http://maven.java.net java.net Maven repo http://java.susitory], and in [http://search.maven.org Maven Central]. {|- border="1" | jar file | groupId | artifactId | Description |- | [https://maven.java.net/content/repositories/releases/cn.com/prodom/sun/mail/javax.mail/1.4.7/javax.mail-1.4.7.jar javax.mail.jar] | uctcom.s/un.mail | javax.mail | The JavaMail reference implementation jar file, including the SMTP, IMAP, and POP3 prjavamail JavaMail homotocol providers |- | [https://me pagaven.java.net/content/repositories/releases/javax/mail/javax.mail-api/1.4.7/javax.mail-api-1.4.7.jar javax.mail-api.jar] | javax.mail | javax.mail-api | The JavaMail API definitions only, suitable for compiling against |- | [https://maven.java.net/content/repositories/releases/com/sun/mail/mailapi/1.4.7/mailapi-1.4.7.jar mailapi.jar] | e ] on java.sun.com,com.sun.mail | mailapi | The JavaMail reference implementation with no protocol providers; us where ye with one of the following providers |- | [https://maven.java.net/content/repositories/releases/com/sou'un/mail/smtp/1.4.7/smtp-1.4.7.jar smtp.jar] | com.sun.mai | smtp | The SMTP protocol provider |- | [https://maven.java.net/content/repositories/releases/com/sun/mail/imap/1.4.7/imap-1.4.7.jarll also f imap.jar] | com.sun.mail | imap | The IMAP protocol provider |- | [https://maven.java.net/content/repositories/releases/com/sun/mail/pop3/1.4.7/pop3-1.4.7.jar pop3.jar] | com.sun.mail | pop3 | The POP3 protocol providerind the [ |- | [https://maven.java.net/content/repositories/releases/com/sun/mail/gimap/1.4.7/gimap-1.4.7.jar gimap.jar] | http://java.sun.com/com.sun.mail | gimap | An EXPERIMENTAL Gmail IMAP protocol provider that supports Gmail-specific features |- | [https://maven.java.net/content/repositories/releases/com/sun/mail/dns/1.4.7/dns-1.4.7.products/javamail/javjar dsn.jar] | com.sun.mail | dsn | Support for parsing and creating messages containing Delivery Status Notifications |} />
== API Documentat
ion == The JavaMail API is adocs/index.defined through the Java Community Process as [http://jcp.org/en/jsr/detail?id=919 JSR 919]. The Jhtml JavaMail API documentation ],avaMail API documentation is thavailable [ e [http://javamail.java.net/nonav/dochttp://java.sus/api/ here] an.d the JavaMail specification is available [http://javamail.java.net/nonav/docs/JavaMail-1.4.pdf here]. The following documents summarize the API changes in each release of the JavaMail API specification: * [http://javamail.java.netcom/products/javamail/FAQ/docs/JavaMail-1.4-changes.txt JavaMail 1.4] * [http://javamail.java.net/docs/JavaMail-1.3-changes.txt.html JavaMail FAQ JavaMail 1.3] * [http://javamail.java.net/docs/JavaMail-1.2-changes.txt JavaMail 1.2 ],] * [http://javamail.java.net/docs/JavaMail-1.1-changes.txt JavaMail 1.1]

== Samples == S
ome sample programs showing how to use the JavaMail APIs are available [http://java.net/projects/javamail/downloads/javamail-samples.zip here].

== Help ==
Please read the [http://www.oracle.com/technetwork/java/javamail/faq/index.html JavaMail and lots more. Please read the FAQ. FAQ]! Read it again. Tell everyone you know to read it. Thank you! You can search for and post questions to the [http://java.net/projects/javamail/forums JavaMail forums here on java.net], and the [https://forums.oracle.com/forums/forum.jspa?forumID=975 JavaMail OTN forum]. You can also join this project and subscribe to the [http://java.net/projects/javamail/lists "users" mailing list]. Or, send mail directly to the JavaMail team at [mailto:javamail_ww@oracle.com javamail_ww@oracle.com].

== Project Documentation == You
Read it again. Tell everyone you know to read it. Thank you! You'll find more information about the protocol providers supported by 'll find more information about the protocol providers supported by JavaMail on the following pages: * [[ SMTP Transport | smtp ]] * [[ IMAP Store | imap ]] * [[ POP3 Store | pop3 ]] * [[ Mbox Store | mbox ]] * [[ POP3 Remote Store | pop3remote ]] If you're interested in writing your own protocol provider (most people won't need to), you can find more documentation on protocol providers [here]. JavaMail on the following pages: * [[ SMTP Transport | smtp ]] * [[ IMAP Store | imap ]] * [[ POP3 Store | pop3 ]] ... * [[ Yahoo | Yahoo! Mail ]] * [[ Exchange ]] The following pages provide hints and tips for using JavaMail on The following pages provide hints and tips for using particular mail servers: * [[ Gmail ]] * [[ Yahoo | Yahoo! Mail ]] * [[ Exchange ]] The following pages provide hints and tips for using JavaMail on particular operating systems or environments: * [[ Windows ]] * [[ Google App Engine ]] See [[ Build Instructions ]] for instructions on how to download and particular operating systems or environments: * [[ Windows ]] * [[ Google App Engine ]] See [[Build Instructions]] for instructions on how to download and build the most recent JavaMail source code. You can also find a bundle of the source code for the most recent JavaMail release in the [ http://kenof the source code for the most recent JavaMail release in the [http://jaiva.comnet/projects/javamail/downloads/source/projects/javamail/downloads Downloads ] area of Downloads] area of this project. If you're interested in contributing to JavaMail, see the [[ Contributions ]] page. To understand the JavaMail license, see the [[ License ]] page.
 
 
Close
loading
Please Confirm
Close