The JavaMail API provides a platform-independent andprotocol-independent framework to build mail and messagingapplications.The JavaMail API is available as an optional package for use with theJava SE platformand is also included in theJava EE platform.
The 1.6.2 release contains bug fixes and enhancements,including the following significant changes:
Note that the JavaMail project will be moving to the Eclipse Foundationas part of theEclipse Enterprise for Javaproject over the next several weeks.Future releases will be done as part of the Eclipse project for JavaMail.
Welcome to the new home of the JavaMail API project on GitHub!This project hosts the downloads and source code for the JavaMail APIreference implementation. The JavaMail reference implementation islicensed under theCommon Development and Distribution License (CDDL) v1.1 and GNU General PublicLicense (GPL) v2 with Classpath Exception.
By contributing to this project, you agree to these additional terms ofuse, described inCONTRIBUTING.
The latest release of JavaMail is 1.6.2.
The following table provides easy access to the latest release. Mostpeople will only need the main JavaMail reference implementation in thejavax.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.The main JavaMail jar file, which is all most applications will need,can be included using this Maven dependency:
<dependencies> <dependency> <groupId>com.sun.mail</groupId> <artifactId>javax.mail</artifactId> <version>1.6.2</version> </dependency> </dependencies>You can find all of the JavaMail jar files in both thejava.net Maven repository, and inMaven 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; use only with a Maven “provided” dependency scope |
| 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 |
| logging-mailhandler.jar | com.sun.mail | logging-mailhandler | A java.util.logging handler that uses JavaMail, suitable for use in Google App Engine. |
The JavaMail API is defined through the Java Community Process asJSR 919.
The JavaMail API documentation is availablehere and theJavaMail specification is availablehere.
The following documents summarize the API changes in each release ofthe JavaMail API specification:
Some sample programs showing how to use the JavaMail APIs are availablehere.
Please read theJavaMail FAQ!Read it again. Tell everyone you know to read it. Thank you!
You can search for and post questions to theJavaMail OTN forum.You can also subscribe to themailing list.
Or, post a question onStack Overflow using thejavamail tag.
Finally, you can send mail directly to the JavaMail team atjavamail_ww@oracle.com.
JavaMail bugs are tracked in theGitHub JavaMail project issue tracker.
From time to time snapshot releases of the next version of JavaMailunder development are published to thejava.net Maven repository.These snapshot releases have received only minimal testing, but mayprovide previews of bug fixes or new features under development.
For example, you can download the javax.mail.jar file from the JavaMail1.6.3-SNAPSHOT releasehere.Be sure to scroll to the bottom and choose the jar file with the mostrecent time stamp.
The latest release includes support for JavaMail on Android.See theAndroid page for details.
You’ll find more information about the protocol providers supported byJavaMail on the following pages:
If you’re interested in writing your own protocol provider (most peoplewon’t need to), you can find more documentation on protocol providershere.
The use ofOAuth2 authenticationwith JavaMail is describedhere.
The following pages provide hints and tips for using particular mail servers:
The following pages provide hints and tips for using JavaMail onparticular operating systems or environments:
SeeBuild Instructions for instructions on how todownload and build the most recent JavaMail source code. You can alsofind a bundle of the source code for the most recent JavaMail releasein theReleases area ofthis project.
If you’re interested in contributing to JavaMail, see theContributions page.
You can find a list of products related to JavaMail on theThird Party Products page.
Please see our page oflinks to additional information about JavaMail and Internet emailand our list ofbooks about JavaMail and Internet email.
To understand the JavaMail license, see theLicense page.