alvinalexander.com | career | drupal | java | mac | mysql | perl | scala | uml | unix  

Commons Email example source code file (release_1_1.xml)

This example Commons Email source code file (release_1_1.xml) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Java - Commons Email tags/keywords

apache, commons, commons, email, email, j2ee, java, javamail, jdk, license, license, sun, the, the

The Commons Email release_1_1.xml source code

<?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>Release notes for 1.1
    <author email="dev@commons.apache.org">Commons Documentation Team
  </properties>
  <body>

    These are the release notes for Commons Email version 1.1.

    <section name="Introduction">
      <p>
	Commons Email aims to provide a API for sending email. It builds on the JavaMail
	API with the aim of presenting a simplified API which is easy for developers who
	are not mail experts to use. It is a compact component with a small number of
	classes.
      </p>
      <p>
	The Commons Email website is the source for the most recent information,
	downloads, reports, and bug status:
      </p>
      <p>
	<a href="http://commons.apache.org/email/">http://commons.apache.org/email/
      </p>
      <p>
	This is a maintenance release which fixes several bugs present in the 1.0
	release and adds a number of small enhancements requested by
	users. All current users are encouraged to upgrade.
      </p>
    </section>

    <section name="Changes from 1.0">

      <subsection name="Compatibility">
	<ul>
	  <li>
	    Java 1.4 or later is now required. Earlier versions are no longer
	    supported by Sun.
	  </li>	  
	  <li>
	    JavaMail 1.4 or later and JavaBeans Activation Framework 1.1 or later are now
	    required.
	  </li>
	  <li>
	    The protected field <code>org.apache.commons.mail.HtmlEmail.inlineImages
            is now deprecated. Its function is now performed by the
            <code>org.apache.commons.mail.HtmlEmail.inlineEmbeds field; the new field
            is a <code>Map instead of a List. The change was made
            as a part of <a href="http://issues.apache.org/jira/browse/EMAIL-50">EMAIL-50.
            Clients that have subclassed <code>HtmlEmail should change their implementations
            accordingly.
          </li>
	</ul>
      </subsection>
      
      <subsection name="Notable bugfixes">
	<ul>
	  <li>
	    <a href="http://issues.apache.org/jira/browse/EMAIL-50">EMAIL-50:
	    HtmlEmails were not being constructed correctly; several
	    email clients were not displaying attachments or embedded images
	    properly. As part of the same problem, duplicate embeds were not
	    being handled correctly.
	  </li>
	  <li>
	    <a href="http://issues.apache.org/jira/browse/EMAIL-1">EMAIL-1: 
	    Email.setContent() was not taking a specified charset into
	    account. Additional setContent() overloadings were also added to
	    address common use cases.
	  </li>
	</ul>
      </subsection>
      
      <subsection name="Notable enhancements">
	<ul>
	  <li>
	    <a href="http://issues.apache.org/jira/browse/EMAIL-35">EMAIL-35: 
	    HtmlEmail now supports the embedding of any DataSource
	    implementation. Specific methods were added for File and URL
	    objects, removing the need for clumsy circumlocution.
	  </li>
	  <li>
	    Character set handling and encoding has been overhauled to use the
	    JDK 1.4 character set support. All charsets supported by the Java VM
	    are now recognized and handled appropriately in Email.setCharset()
	    and Email.setContent() calls.
	  </li>
	  <li>
	    HtmlEmail performance has been slightly improved.
	  </li>
	  <li>
	    The MIME structure of MultiPartEmail and HtmlEmail has
	    been improved.
	  </li>
	</ul>
      </subsection>
      
    </section>

    <section name="Requirements">
      
      <subsection name="J2SE environments">
	<p>
	  Commons Email requires JavaMail 1.4 or later. The proprietary Sun implementation
	  is available at:
	</p>
	<p>
	  <a href="http://java.sun.com/products/javamail/">http://java.sun.com/products/javamail/
	</p>
	<p>
	  However, the Apache Geronimo project (http://geronimo.apache.org)
	  provides a J2EE-certified implementation of the JavaMail 1.4
	  specification licensed under the Apache Software License.  
	</p>
	<p>
	  Commons Email also requires the JavaBeans Activation Framework. The
	  proprietary Sun implementation is available at:
	</p>
	<p>
	  <a href="http://java.sun.com/products/javabeans/glasgow/jaf.html">http://java.sun.com/products/javabeans/glasgow/jaf.html
	</p>
	<p>
	  Apache Geronimo likewise provides an implementation under the Apache
	  Software License.
	</p>
	<p>
	  Commons Email has been tested with JDK 1.4.2_15 and JDK 1.5.0_12.
	</p>
      </subsection>
      
      <subsection name="J2EE environments">
	<p>
	  Commons Email is compatible with all certified Java Enterprise Edition
	  5 implementations; no further dependencies are required. 
	</p>
	<p>
	  Java 2 Enterprise Edition 1.4 users must ensure that the versions of
	  JavaMail and JAF indicated above are available to their applications;
	  the J2EE 1.4 specification only requires earlier versions.
	</p>
	<p>
	  Earlier versions of J2EE are not supported.
	</p>
      </subsection>
    </section>

  </body>
</document>

Other Commons Email examples (source code examples)

Here is a short list of links related to this Commons Email release_1_1.xml source code file:

... this post is sponsored by my books ...

#1 New Release!

FP Best Seller

 

new blog posts

 

Copyright 1998-2021 Alvin Alexander, alvinalexander.com
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.