blob: 18e415d5a55772787fae86db4c4b65f706fde801 [file] [log] [blame]
-----------------------------------
Apache Axiom - The XML Object Model
-----------------------------------
Welcome to Apache Axiom
AXIOM stands for AXis Object Model (also known as OM - Object Model) and refers to the XML
infoset model that was initially developed for Apache Axis2. XML infoset refers to the
information included inside the XML and for programmatical manipulation it is convenient
to have a representation of this XML infoset in a language specific manner. For an object
oriented language the obvious choice is a model made up of objects. DOM and JDOM are two
such XML models. OM is conceptually similar to such an XML model by its external behavior
but deep down it is very much different.
Latest Release
<<15th January 2009 - Apache Axiom Version 1.2.8 Released!>>
\[{{{http://ws.apache.org/commons/axiom/download.cgi}Download AXIOM 1.2.8}}\]
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 is an easy to use API with a very
high performant architecture!
Developed as part of Apache Axis2, Apache AXIOM 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.
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:
* Linked list based implementation
* W3C DOM supporting implementation
* Highly performant
* Improved XML serialization
* Improved Builder hierarchy
* Improved MTOM handling
What's New in This Release
* 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