Author: veithen
Date: Sun Jun 13 14:41:13 2010
New Revision: 954233
URL: http://svn.apache.org/viewvc?rev=954233&view=rev
Log:
Prepared the release note for 1.2.9.
Modified:
webservices/commons/trunk/modules/axiom/RELEASE-NOTE.txt
webservices/commons/trunk/modules/axiom/src/docbkx/devguide.xml
webservices/commons/trunk/modules/axiom/src/site/apt/index.apt
Modified: webservices/commons/trunk/modules/axiom/RELEASE-NOTE.txt
URL:
http://svn.apache.org/viewvc/webservices/commons/trunk/modules/axiom/RELEASE-NOTE.txt?rev=954233&r1=954232&r2=954233&view=diff
==============================================================================
--- webservices/commons/trunk/modules/axiom/RELEASE-NOTE.txt (original)
+++ webservices/commons/trunk/modules/axiom/RELEASE-NOTE.txt Sun Jun 13
14:41:13 2010
@@ -1,84 +1,117 @@
===========================================
- Apache AXIOM 1.2.8 Release Note
+ Apache AXIOM 1.2.9 Release Note
===========================================
-Apache AXIOM is a StAX-based, XML Infoset compliant object model which
supports
-on-demand building of the object tree. It supports a novel "pull-through"
model
-which allows one to turn off the tree building and directly access the
underlying
-pull event stream. It also has built-in support for XML Optimized Packaging
(XOP)
-and MTOM, the combination of which allows XML to carry binary data efficiently
-and in a transparent manner. The combination of these results in a easy to use
-API with a very high performant architecture!
-
-Initialy developed as part of Apache Axis2, Apache AXIOM (AXIs Object Model)
is
-the core of Apache Axis2. However, it is a pure standalone XML Infoset model
with
-novel features and can be used independently of Apache Axis2.
-
-Please visit: http://ws.apache.org/commons/axiom/
-
-
-Key Features
-============
-
- * Full XML Infoset compliant XML object model
- * StAX based builders with on-demand building and pull-through
- * XOP/MTOM support offering direct binary support
- * Convenient SOAP Infoset API on top of AXIOM
- * Two implementations included:
- o Linked list based implementation
- o W3C DOM supporting implementation
- * Highly performant
-
-
+Note: Starting with release 1.2.9, Axiom requires Java 1.5. While the API is
+still compatible with Java 1.4, Axiom relies on classes from the Java 1.5
+runtime environment. Some of its dependencies also require Java 1.5.
What's New in This Release
-==========================
-This release contains fixes for following issues (see
-
http://issues.apache.org/jira/browse/WSCOMMONS/component/12310703)
+ Highlights in this release:
+
+ * Improved interoperability with StAX implementations other than Woodstox.
Axiom now
+ detects the StAX implementation that is used and works around
interoperability issues.
+ In particular, version 1.2.9 solves the longstanding concurrency issue
that occurs
+ when using Axiom with SJSXP.
+
+ * Better control over XMLInputFactory and XMLOutputFactory settings. It is
now possible
+ to use property files to define application wide default settings for
the StAX factories
+ used by StAXUtils. It is also possible to specify a particular
configuration when
+ requesting a StAX parser from StAXUtils.
+
+ * Improved XOP/MTOM handling. Axiom 1.2.9 is able to stream binary/base64
data in several
+ situations where this was not possible previously. The behavior of Axiom
1.2.9 is also
+ more consistent with respect to XOP encoded data sent to the
application, solving
+ some issues where attachments were processed incorrectly.
+
+ * Improved documentation. There is now more and better Javadoc. Also, a
user guide
+ is available in HTML and as PDF.
+
+ * Better OSGi support.
+
+ * Improved consistency of the core interfaces. E.g. OMDocument now has a
build
+ method.
-WSCOMMONS-434 org.apache.axiom.om.impl.dom.NodeImpl#getTextContent() and
org.apache.axiom.om.impl.dom.NodeImpl#setTextContent(String arg0) are not
implemented
-WSCOMMONS-429 XOPAwareStAXOMBuilder / MTOMStAXSOAPModelBuilder should use
UTF-8 to decode cid: URIs
-WSCOMMONS-427 StreamingOMSerializer#serializeXOPInclude doesn't decode cid:
URLs
-WSCOMMONS-424 BufferUtils#doesDataHandlerExceedLimit needs review
-WSCOMMONS-423 DOOM doesn't correctly enforce hierarchy constraints on Document
-WSCOMMONS-420 Attempted validation of DomSource leads to
"java.lang.UnsupportedOperationException: TODO" from
"org.apache.axiom.om.impl.dom.DocumentImpl.getDoctype"
-WSCOMMONS-415 Provide implementations of javax.xml.transform.Source and
javax.xml.transform.Result
-WSCOMMONS-413 Build failure with JDK 1.4.2
-WSCOMMONS-412 Get rid of the setDOOMRequired hack
-WSCOMMONS-394 StAXUtils: Add Network Detached XMLStreamReader capability
-WSCOMMONS-393 Error using AxiomSoapMessageFactory with comments in request
-WSCOMMONS-386 Exception thrown is not descriptive, if content-type missing
boundary parameter
-WSCOMMONS-381 StringIndexOutOfBoundsException in
org.apache.axiom.attachments.impl.PartFactory.readHeader()
-WSCOMMONS-373 SAXOMBuilder needs to support default namespaces
-WSCOMMONS-372 Sometimes accessing an AXIOM tree while the underlying input
stream is closed causes an OutOfMemoryError
-WSCOMMONS-357 NPE will result in Axiom code if MD5 algorithm is not in
classpath
-WSCOMMONS-340 Error calling getTextCharacters() on a comment node
-WSCOMMONS-337 insertSiblingAfter() method doesn't set last child
-WSCOMMONS-336 Inconsistent specification for
OMDataSource#serialize(OutputStream, OMOutputFormat)
-WSCOMMONS-335 Add a getOutputFormat method to MTOMXMLStreamWriter
-WSCOMMONS-334 OMSourcedElementImpl#serialize produces wrong result when
element is expanded
-WSCOMMONS-333 Add an addNamespaces(OMElement) method to AXIOMXPath
-WSCOMMONS-329 org.apache.axiom.attachments.Attachments#getSOAPPartContentID()
does not parse content ids correctly.
-WSCOMMONS-328 Failure in boundaryPosition condition for checking position
validity
-WSCOMMONS-327 Namespace High verbosity combined with XMLBeans
-WSCOMMONS-323 XML Element lost when there is an OMException inside
OMChildrenIterator.next()
-WSCOMMONS-317 Reverted code, need to review code
-WSCOMMONS-281 xmlns:xml declaration is unnecessary and fails in some parsers
-WSCOMMONS-255 AXIOM DOM based org.w3c.dom.Element.getElementsByTagName and
getElementsByTagNameNS do not funcion according to spec
-WSCOMMONS-254 AXIOM DOM based implementation fails to parse documents that
start with xml comment.
-WSCOMMONS-253 mvn: creating axiom.jar (bundle of axiom-api.jar, axiom-dom.jar
and axiom-impl.jar)
-WSCOMMONS-239 org.apache.axiom.om.OMElement#getText() is not documented
sufficiently
-WSCOMMONS-237 Can't retrieve children from OMDocument
-WSCOMMONS-233 SecurityException thrown in OMAbstractFactory when run from an
applet (2)
-WSCOMMONS-207 Finding namespace based on prefix is broken
-WSCOMMONS-197 SOAP headers added using DOOM are lost during serialization
-WSCOMMONS-182 Infinite loop in OMElement possible
-WSCOMMONS-121 Handling of xml documents with two top level elements is
errorneous
-WSCOMMONS-115 Problem in serialization when comments presents
-WSCOMMONS-101 axiom base64 encoding is incorrect
+ Resolved JIRA issues:
+
+ * WSCOMMONS-547 apache-release profile not working
+
+ * WSCOMMONS-546 axiom unit test failure in axiom-parser-tests
+
+ * WSCOMMONS-545 Legal issue related to inclusion of Jaxen source code in
Axiom
+
+ * WSCOMMONS-541 Create replacement for UUIDGenerator
+
+ * WSCOMMONS-540 CustomBuilder interface is not well defined for optimized
binary data
+
+ * WSCOMMONS-536 OMStAXWrapper generated illegal event code of 0
+
+ * WSCOMMONS-535 StreamingOMSerializer drops "xml" prefixes
+
+ * WSCOMMONS-534 "prefix cannot be null or empty" with SJSXP
+
+ * WSCOMMONS-530 AXIOM DOM implementation of SOAPFaultDetailImpl only
serializes the first child node whereas the LLOM implementation serializes all
children
+
+ * WSCOMMONS-528 Unable to build axiom-api with IBM JDK
+
+ * WSCOMMONS-526 SOAPEnvelope toString() behavior inconsistant dependent on
content
+
+ * WSCOMMONS-518 Some consumers of Axiom need direct access to the orignal
parser/XMLStreamReader
+
+ * WSCOMMONS-516 Axiom Bundles are "named" the same, appear to be running
twice in ServiceMix/Karaf
+
+ * WSCOMMONS-513 Behavior of insertSiblingAfter and insertSiblingBefore is
not well defined for orphan nodes
+
+ * WSCOMMONS-505 Build Error when creating source jar fie on modules that
do not have source directory
+
+ * WSCOMMONS-502 Backward imcompatibility with Apache Abdera in Axiom
1.2.9-SNAPSHOT
+
+ * WSCOMMONS-489 StAXUtils incorrectly assumes that XMLInputFactory and
XMLOutputFactory instances are thread safe
+
+ * WSCOMMONS-488 The sequence of events produced by OMStAXWrapper with
inlineMTOM=false is inconsistent
+
+ * WSCOMMONS-487 DataHandler extension should support deferred
loading/parsing
+
+ * WSCOMMONS-485 The sequence of events produced by OMStAXWrapper for
XOP:Include is inconsistent
+
+ * WSCOMMONS-483 provide help how to find a datahandler when you see
"Cannot get InputStream from
DataHandler.javax.activation.UnsupportedDataTypeException: no object DCH for
MIME type ..."
+
+ * WSCOMMONS-481 Add a method to OMFactory to create an OMSourcedElement
using a QName
+
+ * WSCOMMONS-480 Some of the serialize/serializeAndConsume methods are
declared on the wrong interface
+
+ * WSCOMMONS-479 OMDocument should have a "build" method
+
+ * WSCOMMONS-478 OMChildrenIterator based on local name has bug in
isEqual() method
+
+ * WSCOMMONS-477 Attachment order is not preserved in Axiom
+
+ * WSCOMMONS-462 axiom-api 1.2.8 is missing OSGi Import-Package to
javax.xml.stream.util under JDK 1.5
+
+ * WSCOMMONS-461 Allow StAXUtils to apply properties to XMLInputFactory and
XMLOutputFactory
+
+ * WSCOMMONS-457 Build fails on JDK 1.6
+
+ * WSCOMMONS-452 Merge org.apache.axis2.format.ElementHelper into
org.apache.axiom.om.util.ElementHelper
+
+ * WSCOMMONS-446 Serializing an MTOM SOAPEnvelope inlines the attachments
+
+ * WSCOMMONS-437 Define a common superinterface for SOAPFaultCode and
SOAPFaultSubCode
+
+ * WSCOMMONS-435 org.apache.axiom.om.impl.dom.ParentNode.removeChild(Node)
is broken
+
+ * WSCOMMONS-433 When inlining a DataHandler as Base64, OMTextImpl doesn't
stream the data
+
+ * WSCOMMONS-432 Make OMAbstractFactory work correctly in an OSGi runtime
environment
+
+ * WSCOMMONS-417 Clarify the status of the JavaMail dependency
+
+ * WSCOMMONS-414 Namespace issue in SOAP message generated
+
+ * WSCOMMONS-111 Careless exception handling needs to be fixed
- The Apache Axiom Team.
Modified: webservices/commons/trunk/modules/axiom/src/docbkx/devguide.xml
URL:
http://svn.apache.org/viewvc/webservices/commons/trunk/modules/axiom/src/docbkx/devguide.xml?rev=954233&r1=954232&r2=954233&view=diff
==============================================================================
--- webservices/commons/trunk/modules/axiom/src/docbkx/devguide.xml (original)
+++ webservices/commons/trunk/modules/axiom/src/docbkx/devguide.xml Sun Jun 13
14:41:13 2010
@@ -232,6 +232,14 @@ javax.xml.stream.XMLOutputFactory=com.be
</para>
<screen>mvn clean install -Papache-release
-Dmaven.test.skip=true</screen>
</listitem>
+ <listitem>
+ <para>
+ Prepare the release note. This should include a
description of the major
+ changes in the release as well as a list of resolved
JIRA issues. Note that
+ both <filename>index.apt</filename> and
<filename>RELEASE-NOTE.txt</filename>
+ need to be updated.
+ </para>
+ </listitem>
</itemizedlist>
</section>
<section>
Modified: webservices/commons/trunk/modules/axiom/src/site/apt/index.apt
URL:
http://svn.apache.org/viewvc/webservices/commons/trunk/modules/axiom/src/site/apt/index.apt?rev=954233&r1=954232&r2=954233&view=diff
==============================================================================
--- webservices/commons/trunk/modules/axiom/src/site/apt/index.apt (original)
+++ webservices/commons/trunk/modules/axiom/src/site/apt/index.apt Sun Jun 13
14:41:13 2010
@@ -62,12 +62,107 @@ Latest Release
still compatible with Java 1.4, Axiom relies on classes from the Java 1.5
runtime environment. Some of its dependencies also require Java 1.5.
-What's New in This Release
+* What's New in This Release
- * Improved interoperability with StAX implementations other than Woodstox.
+ Highlights in this release:
+
+ * Improved interoperability with StAX implementations other than Woodstox.
Axiom now
+ detects the StAX implementation that is used and works around
interoperability issues.
+ In particular, version 1.2.9 solves the longstanding concurrency issue
that occurs
+ when using Axiom with SJSXP.
- * Better control over XMLInputFactory and XMLOutputFactory settings.
+ * Better control over XMLInputFactory and XMLOutputFactory settings. It is
now possible
+ to use property files to define application wide default settings for
the StAX factories
+ used by <<<StAXUtils>>>. It is also possible to specify a particular
configuration when
+ requesting a StAX parser from <<<StAXUtils>>>.
- * Improved base64 handling.
+ * Improved XOP/MTOM handling. Axiom 1.2.9 is able to stream binary/base64
data in several
+ situations where this was not possible previously. The behavior of Axiom
1.2.9 is also
+ more consistent with respect to XOP encoded data sent to the
application, solving
+ some issues where attachments were processed incorrectly.
- * Improved documentation.
\ No newline at end of file
+ * Improved documentation. There is now more and better Javadoc. Also, a
user guide
+ is available in HTML and as PDF.
+
+ * Better OSGi support.
+
+ * Improved consistency of the core interfaces. E.g. <<<OMDocument>>> now
has a <<<build>>>
+ method.
+
+ Resolved JIRA issues:
+
+ * WSCOMMONS-547 apache-release profile not working
+
+ * WSCOMMONS-546 axiom unit test failure in axiom-parser-tests
+
+ * WSCOMMONS-545 Legal issue related to inclusion of Jaxen source code in
Axiom
+
+ * WSCOMMONS-541 Create replacement for UUIDGenerator
+
+ * WSCOMMONS-540 CustomBuilder interface is not well defined for optimized
binary data
+
+ * WSCOMMONS-536 OMStAXWrapper generated illegal event code of 0
+
+ * WSCOMMONS-535 StreamingOMSerializer drops "xml" prefixes
+
+ * WSCOMMONS-534 "prefix cannot be null or empty" with SJSXP
+
+ * WSCOMMONS-530 AXIOM DOM implementation of SOAPFaultDetailImpl only
serializes the first child node whereas the LLOM implementation serializes all
children
+
+ * WSCOMMONS-528 Unable to build axiom-api with IBM JDK
+
+ * WSCOMMONS-526 SOAPEnvelope toString() behavior inconsistant dependent on
content
+
+ * WSCOMMONS-518 Some consumers of Axiom need direct access to the orignal
parser/XMLStreamReader
+
+ * WSCOMMONS-516 Axiom Bundles are "named" the same, appear to be running
twice in ServiceMix/Karaf
+
+ * WSCOMMONS-513 Behavior of insertSiblingAfter and insertSiblingBefore is
not well defined for orphan nodes
+
+ * WSCOMMONS-505 Build Error when creating source jar fie on modules that
do not have source directory
+
+ * WSCOMMONS-502 Backward imcompatibility with Apache Abdera in Axiom
1.2.9-SNAPSHOT
+
+ * WSCOMMONS-489 StAXUtils incorrectly assumes that XMLInputFactory and
XMLOutputFactory instances are thread safe
+
+ * WSCOMMONS-488 The sequence of events produced by OMStAXWrapper with
inlineMTOM=false is inconsistent
+
+ * WSCOMMONS-487 DataHandler extension should support deferred
loading/parsing
+
+ * WSCOMMONS-485 The sequence of events produced by OMStAXWrapper for
XOP:Include is inconsistent
+
+ * WSCOMMONS-483 provide help how to find a datahandler when you see
"Cannot get InputStream from
DataHandler.javax.activation.UnsupportedDataTypeException: no object DCH for
MIME type ..."
+
+ * WSCOMMONS-481 Add a method to OMFactory to create an OMSourcedElement
using a QName
+
+ * WSCOMMONS-480 Some of the serialize/serializeAndConsume methods are
declared on the wrong interface
+
+ * WSCOMMONS-479 OMDocument should have a "build" method
+
+ * WSCOMMONS-478 OMChildrenIterator based on local name has bug in
isEqual() method
+
+ * WSCOMMONS-477 Attachment order is not preserved in Axiom
+
+ * WSCOMMONS-462 axiom-api 1.2.8 is missing OSGi Import-Package to
javax.xml.stream.util under JDK 1.5
+
+ * WSCOMMONS-461 Allow StAXUtils to apply properties to XMLInputFactory and
XMLOutputFactory
+
+ * WSCOMMONS-457 Build fails on JDK 1.6
+
+ * WSCOMMONS-452 Merge org.apache.axis2.format.ElementHelper into
org.apache.axiom.om.util.ElementHelper
+
+ * WSCOMMONS-446 Serializing an MTOM SOAPEnvelope inlines the attachments
+
+ * WSCOMMONS-437 Define a common superinterface for SOAPFaultCode and
SOAPFaultSubCode
+
+ * WSCOMMONS-435 org.apache.axiom.om.impl.dom.ParentNode.removeChild(Node)
is broken
+
+ * WSCOMMONS-433 When inlining a DataHandler as Base64, OMTextImpl doesn't
stream the data
+
+ * WSCOMMONS-432 Make OMAbstractFactory work correctly in an OSGi runtime
environment
+
+ * WSCOMMONS-417 Clarify the status of the JavaMail dependency
+
+ * WSCOMMONS-414 Namespace issue in SOAP message generated
+
+ * WSCOMMONS-111 Careless exception handling needs to be fixed
