| <?xml version="1.0"?> |
| <!-- |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --> |
| <document> |
| <properties> |
| <title>Home</title> |
| <author email="dev@commons.apache.org">Commons Documentation Team</author> |
| </properties> |
| <body> |
| <!-- ================================================== --> |
| <section name="Commons Email"> |
| <p> |
| Commons Email aims to provide a API for sending email. |
| It is built on top of the Java Mail API, which it aims to simplify. |
| </p> |
| <p> |
| Some of the mail classes that are provided are as follows: |
| <ul> |
| <li> |
| <b>SimpleEmail</b> |
| - |
| This class is used to send basic text based emails. |
| </li> |
| <li> |
| <b>MultiPartEmail</b> |
| - |
| This class is used to send multipart messages. |
| This allows a text message with attachments either inline or attached. |
| </li> |
| <li> |
| <b>HtmlEmail</b> |
| - |
| This class is used to send HTML formatted emails. |
| It has all of the capabilities as MultiPartEmail allowing attachments to be easily added. |
| It also supports embedded images. |
| </li> |
| <li> |
| <b>ImageHtmlEmail</b> |
| - |
| This class is used to send HTML formatted emails with inline images. |
| It has all of the capabilities as HtmlEmail but transform all image |
| references to inline images. |
| </li> |
| <li> |
| <b>EmailAttachment</b> |
| - |
| This is a simple container class to allow for easy handling of attachments. |
| It is for use with instances of MultiPartEmail and HtmlEmail. |
| </li> |
| </ul> |
| </p> |
| </section> |
| <!-- ================================================== --> |
| <section name="Documentation"> |
| <p> |
| The |
| <a href="userguide.html">Commons Email User Guide</a> |
| covers many |
| typical cases and provides several useful examples. |
| </p> |
| <p> |
| The Javadoc API documents are available online: |
| </p> |
| <ul> |
| <li>The |
| <a href="/apidocs/index.html">Javadoc</a> |
| </li> |
| <li>The |
| <a href="https://javadoc.io/doc/org.apache.commons/commons-email/latest/index.html">Javadoc Archive</a> |
| </li> |
| </ul> |
| <p> |
| The |
| <a href="scm.html">git repository</a> |
| can be |
| <a href="https://gitbox.apache.org/repos/asf?p=commons-email.git">browsed</a>. |
| </p> |
| </section> |
| <!-- ================================================== --> |
| <section name="Releases"> |
| <p> |
| The latest version requires Java 8 - |
| <a href="https://commons.apache.org/email/download_email.cgi">Download now!</a> |
| <br/> |
| The full |
| <a href="changes-report.html">change log</a> |
| is available |
| </p> |
| <p> |
| For previous releases, see the <a href="https://archive.apache.org/dist/commons/email/">Apache Archive</a>. |
| </p> |
| </section> |
| <!-- ================================================== --> |
| <section name="Support"> |
| <p> |
| The |
| <a href="mail-lists.html">commons mailing lists</a> |
| act as the main support forum. |
| The user list is suitable for most library usage queries. |
| The dev list is intended for the development discussion. |
| Please remember that the lists are shared between all commons components, |
| so prefix your email by [email]. |
| </p> |
| <p> |
| Issues may be reported via <a href="issue-tracking.html">ASF JIRA</a>. |
| </p> |
| </section> |
| <!-- ================================================== --> |
| </body> |
| </document> |