Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Methods

Deprecated Interfaces

org.apache.axiom.attachments.SizeAwareDataSource
Please implement SizeAwareDataSource

Deprecated Classes

org.apache.axiom.om.impl.llom.util.AXIOMUtil
Use AXIOMUtil instead.

org.apache.axiom.om.util.Base64
Use Base64Utils instead.

org.apache.axiom.om.impl.builder.DataHandlerReaderUtils
Use the corresponding methods in XMLStreamReaderUtils instead.

org.apache.axiom.om.impl.dom.jaxp.DocumentBuilderFactoryImpl
This class has static methods that allow to switch between DOOM and the default DOM implementation as returned by JAXP. This was a hack introduced for Rampart. Recent versions of Rampart no longer rely on this hack. On the other hand usage of DocumentBuilderFactoryImpl.setDOOMRequired(boolean) in a concurrent environment can lead to unexpected behavior and severe bugs, as shown in AXIOM-3 and AXIS2-1570. Due to the way DocumentBuilderFactoryImpl.newDocumentBuilder() is implemented, it is not possible to get rid of the setDOOMRequired hack without the risk of breaking existing code. Therefore this class has been deprecated in favor of DOOMDocumentBuilderFactory.

org.apache.axiom.om.impl.dom.jaxp.DocumentBuilderImpl
see DocumentBuilderFactoryImpl

org.apache.axiom.om.impl.dom.DOOMAbstractFactory
Use OMAbstractFactory.getMetaFactory(String) with OMAbstractFactory.FEATURE_DOM to get a meta factory for DOOM.

org.apache.axiom.om.impl.EmptyOMLocation
use DummyLocation.INSTANCE instead

org.apache.axiom.om.impl.MIMEOutputUtils
The features of this class are now implemented by OMMultipartWriter, which has as cleaner API and supports streaming of individual MIME parts, in particular the SOAP part.

org.apache.axiom.om.impl.llom.util.NamespaceContextImpl
Use MapBasedNamespaceContext instead.

org.apache.axiom.om.impl.OMNamespaceImpl
OMNamespace instances should always be created using OMFactory.createOMNamespace(String, String). This class will be removed in Axiom 1.3.

org.apache.axiom.om.impl.llom.factory.OMXMLBuilderFactory
This class is deprecated because it is located in the wrong package and JAR (it is implementation independent but belongs to LLOM). Please use OMXMLBuilderFactory instead.

org.apache.axiom.om.util.UUIDGenerator
Please use one of the specialized methods in the UIDGenerator class. In contrast to what its name suggests, the UUIDGenerator.getUUID() method doesn't return a UUID. It also doesn't return a valid URN with uuid NID. See AXIS2-4527 for more information.

org.apache.axiom.om.impl.llom.util.XMLComparator
This class is outdated. Please use XmlUnit to compate two xml files.

Deprecated Methods

org.apache.axiom.om.impl.MIMEOutputUtils.complete(OutputStream, byte[], LinkedList, String, String, String, String)
Use OMMultipartWriter instead.

org.apache.axiom.om.impl.MIMEOutputUtils.complete(OutputStream, byte[], LinkedList, String, String, String, String, OMOutputFormat)
Use OMMultipartWriter instead.

org.apache.axiom.om.impl.MIMEOutputUtils.createMimeBodyPart(String, DataHandler)
This method is only useful in conjunction with MIMEOutputUtils.writeBodyPart(OutputStream, MimeBodyPart, String), which is deprecated.

org.apache.axiom.om.impl.MIMEOutputUtils.createMimeBodyPart(String, DataHandler, OMOutputFormat)
This method is only useful in conjunction with MIMEOutputUtils.writeBodyPart(OutputStream, MimeBodyPart, String), which is deprecated.

org.apache.axiom.om.impl.MIMEOutputUtils.finishWritingMime(OutputStream)
Use OMMultipartWriter instead.

org.apache.axiom.om.impl.MIMEOutputUtils.startWritingMime(OutputStream, String)
Use OMMultipartWriter instead.

org.apache.axiom.om.util.TextHelper.toOMText(byte[], int, int, OMFactory, boolean)
The implementation of this method is incomplete. It will be removed in Axiom 1.3.

org.apache.axiom.om.util.TextHelper.toOMText(byte[], int, int, OMFactory, boolean, String)
The implementation of this method is incomplete. It will be removed in Axiom 1.3.

org.apache.axiom.om.util.TextHelper.toString(InputStream)
This method was internally used by Axiom before version 1.2.9 but is no longer required.

org.apache.axiom.om.util.TextHelper.toStringBuffer(InputStream, StringBuffer)
This method was internally used by Axiom before version 1.2.9 but is no longer required.

org.apache.axiom.om.util.TextHelper.toStringBuffer(OMText, StringBuffer)
If you really need to write the base64 encoded content of an OMText instance to a StringBuffer, then request the DataHandler using OMText.getDataHandler() and use Base64EncodingStringBufferOutputStream to encode it.

org.apache.axiom.om.impl.MIMEOutputUtils.writeBodyPart(OutputStream, MimeBodyPart, String)
Use OMMultipartWriter instead.

org.apache.axiom.om.impl.MIMEOutputUtils.writeDataHandlerWithAttachmentsMessage(DataHandler, String, OutputStream, Map, OMOutputFormat)
Use OMMultipartWriter instead.

org.apache.axiom.om.impl.MIMEOutputUtils.writeDataHandlerWithAttachmentsMessage(DataHandler, String, OutputStream, Map, OMOutputFormat, Collection)
Use OMMultipartWriter instead.

org.apache.axiom.om.impl.MIMEOutputUtils.writeMimeBoundary(OutputStream, String)
Use OMMultipartWriter instead.

org.apache.axiom.om.impl.MIMEOutputUtils.writeMM7Message(StringWriter, OutputStream, Attachments, OMOutputFormat, String, String)
Axiom only supports standard SwA messages. However, OMMultipartWriter provides a flexible way to build MIME packages for non standard formats such as MM7.

org.apache.axiom.om.impl.MIMEOutputUtils.writeSOAPWithAttachmentsMessage(StringWriter, OutputStream, Attachments, OMOutputFormat)
Use OMMultipartWriter instead.