Deprecated API

Contents

• Interfaces
• Classes
• Exceptions
• Fields
• Methods

Interfaces

Interface	Description
org.apache.axiom.attachments.SizeAwareDataSource	Please implement SizeAwareDataSource
org.apache.axiom.mime.MultipartWriter	Use MultipartBodyWriter instead.
org.apache.axiom.mime.MultipartWriterFactory
org.apache.axiom.om.impl.OMXMLStreamReaderEx
org.apache.axiom.om.OMConstants
org.apache.axiom.om.OMSerializer
org.apache.axiom.util.blob.Blob	Use Blob instead.
org.apache.axiom.util.blob.WritableBlob	Use WritableBlob instead.

Classes

Class	Description
org.apache.axiom.attachments.impl.BufferUtils
org.apache.axiom.attachments.utils.BAAInputStream
org.apache.axiom.attachments.utils.BAAOutputStream
org.apache.axiom.attachments.utils.ByteSearch	This class was part of the MIME parser in Axiom versions before 1.2.13 and is no longer used. It will be removed in Axiom 1.3. Please note that the code in this class is known to have issues; see AXIOM-449 and AXIOM-450 for more information.
org.apache.axiom.attachments.utils.DataHandlerUtils
org.apache.axiom.attachments.utils.IOUtils	This class is no longer used and will be removed in Axiom 1.3. You may want to use Commons IO instead.
org.apache.axiom.mime.ContentTypeBuilder	Use ContentType.Builder instead.
org.apache.axiom.mime.impl.axiom.AxiomMultipartWriterFactory
org.apache.axiom.mime.impl.javamail.JavaMailMultipartWriterFactory	The original purpose of this class was to provide an alternative implementation should bugs be discovered in AxiomMultipartWriterFactory. However, AxiomMultipartWriterFactory exists for several releases now and has no known issues. It should therefore always be used as MultipartWriterFactory implementation.
org.apache.axiom.om.ds.Behavior
org.apache.axiom.om.ds.ByteArrayDataSource	Use BlobOMDataSource instead.
org.apache.axiom.om.ds.CharArrayDataSource	Use StringOMDataSource instead.
org.apache.axiom.om.ds.custombuilder.ByteArrayCustomBuilder	Use BlobOMDataSourceCustomBuilder instead.
org.apache.axiom.om.ds.InputStreamDataSource	This class has been deprecated without replacement. Generally there is no need for OMDataSource instances that are pull based (i.e. use an XMLStreamReader) and that are destructive. For these scenarios, simply use OMXMLBuilderFactory to create an OMElement and add it to the tree. Since this operation will not expand the element (in Axiom 1.3.x), the result will be the same as using an OMSourcedElement with a destructive OMDataSource.
org.apache.axiom.om.ds.OMDataSourceExtBase	As described in AXIOM-419, this class has multiple issues and should no longer be used as a base class for OMDataSource implementations. Instead, use AbstractOMDataSource, AbstractPullOMDataSource or AbstractPushOMDataSource.
org.apache.axiom.om.ds.ParserInputStreamDataSource
org.apache.axiom.om.impl.builder.DataHandlerReaderUtils	Use the corresponding methods in XMLStreamReaderUtils instead.
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.jaxp.OMResult	In order to create a SAXResult that builds an Axiom tree, create an OMDocument instance and call OMContainer.getSAXResult() on it.
org.apache.axiom.om.impl.jaxp.OMSource	As of version 1.2.13, application code should use OMContainer.getSAXSource(boolean) instead of this class.
org.apache.axiom.om.impl.llom.util.AXIOMUtil	Use AXIOMUtil instead.
org.apache.axiom.om.impl.llom.util.NamespaceContextImpl	Use MapBasedNamespaceContext instead.
org.apache.axiom.om.impl.llom.util.XMLComparator	This class is no longer maintained. Please use XmlUnit to compare XML documents.
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.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.serialize.OMXMLReader	This class is used internally by OMSource. Starting with Axiom 1.2.13, application code should use OMContainer.getSAXSource(boolean) to serialize an OM tree to SAX. If there is a need to obtain an XMLReader instance, use SAXSource.getXMLReader() on the SAXSource returned by OMContainer.getSAXSource(boolean).
org.apache.axiom.om.impl.serialize.StreamingOMSerializer	To copy events from an XMLStreamReader to an XMLStreamWriter, use OMXMLBuilderFactory.createStAXOMBuilder(XMLStreamReader) to create an OMDocument, then serialize it using OMSerializable.serializeAndConsume(XMLStreamWriter).
org.apache.axiom.om.impl.serialize.StreamWriterToContentHandlerConverter	This is an internal implementation class that is no longer used.
org.apache.axiom.om.impl.traverse.OMAbstractIterator
org.apache.axiom.om.impl.traverse.OMChildElementIterator	This type of iterator should always be created using OMElement.getChildElements(), and this class should never be referenced directly. It will be removed in Axiom 1.3.
org.apache.axiom.om.impl.traverse.OMChildrenIterator
org.apache.axiom.om.impl.traverse.OMChildrenLegacyQNameIterator
org.apache.axiom.om.impl.traverse.OMChildrenLocalNameIterator	This type of iterator should always be created using OMContainer.getChildrenWithLocalName(String), and this class should never be referenced directly. It will be removed in Axiom 1.3.
org.apache.axiom.om.impl.traverse.OMChildrenNamespaceIterator	This type of iterator should always be created using OMContainer.getChildrenWithNamespaceURI(String), and this class should never be referenced directly. It will be removed in Axiom 1.3.
org.apache.axiom.om.impl.traverse.OMChildrenQNameIterator	This type of iterator should always be created using OMContainer.getChildrenWithName(QName), and this class should never be referenced directly. It will be removed in Axiom 1.3.
org.apache.axiom.om.impl.traverse.OMChildrenWithSpecificAttributeIterator
org.apache.axiom.om.impl.traverse.OMDescendantsIterator	This type of iterator should always be created using OMContainer.getDescendants(boolean), and this class should never be referenced directly. It will be removed in Axiom 1.3.
org.apache.axiom.om.impl.traverse.OMFilterIterator
org.apache.axiom.om.impl.traverse.OMQNameFilterIterator
org.apache.axiom.om.impl.traverse.OMQualifiedNameFilterIterator
org.apache.axiom.om.impl.util.EmptyIterator
org.apache.axiom.om.impl.util.OMSerializerUtil
org.apache.axiom.om.util.Base64	Use Base64Utils instead.
org.apache.axiom.om.util.CommonUtils
org.apache.axiom.om.util.DetachableInputStream
org.apache.axiom.om.util.LogOutputStream
org.apache.axiom.om.util.TextHelper	Class containing only deprecated utility methods.
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 doesn't return a valid URN with uuid NID either. See AXIS2-4527 for more information.
org.apache.axiom.om.util.XPathEvaluator
org.apache.axiom.soap.impl.builder.MTOMStAXSOAPModelBuilder	Please use the OMXMLBuilderFactory API to create builders.
org.apache.axiom.soap.impl.builder.StAXSOAPModelBuilder	Please use the OMXMLBuilderFactory API to create builders.
org.apache.axiom.util.blob.BlobDataSource	Use BlobDataSource instead.
org.apache.axiom.util.blob.BlobOutputStream
org.apache.axiom.util.blob.MemoryBlob	Use MemoryBlob instead.
org.apache.axiom.util.blob.OverflowBlob	Use OverflowableBlob instead.
org.apache.axiom.util.jaxb.JAXBUtils
org.apache.axiom.util.jaxb.UnmarshallerAdapter
org.apache.axiom.util.stax.AbstractXMLStreamReader	This class is no longer maintained.
org.apache.axiom.util.stax.AbstractXMLStreamWriter	This class is no longer maintained.
org.apache.axiom.util.stax.XMLEventUtils	This class is no longer maintained.

Exceptions

Exceptions	Description
org.apache.axiom.om.impl.exception.OMBuilderException
org.apache.axiom.om.impl.exception.OMStreamingException
org.apache.axiom.om.impl.exception.XMLComparisonException	This exception is only used by XMLComparator which is deprecated.

Fields

Field	Description
org.apache.axiom.om.OMConstants.ARRAY_ITEM_LOCALNAME	This constant was used in early prototypes of Axis2 and is no longer relevant.
org.apache.axiom.om.OMConstants.ARRAY_ITEM_NS_PREFIX	This constant was used in early prototypes of Axis2 and is no longer relevant.
org.apache.axiom.om.OMConstants.ARRAY_ITEM_NSURI	This constant was used in early prototypes of Axis2 and is no longer relevant.
org.apache.axiom.om.OMConstants.ARRAY_ITEM_QNAME	This constant was used in early prototypes of Axis2 and is no longer relevant.
org.apache.axiom.om.OMConstants.DEFAULT_DEFAULT_NAMESPACE
org.apache.axiom.om.OMConstants.XMLNS_NS_PREFIX	Use XMLConstants.XMLNS_ATTRIBUTE instead.
org.apache.axiom.om.OMConstants.XMLNS_NS_URI	Use XMLConstants.XMLNS_ATTRIBUTE_NS_URI instead.
org.apache.axiom.om.OMConstants.XMLNS_PREFIX	Use XMLConstants.XML_NS_PREFIX instead.
org.apache.axiom.om.OMConstants.XMLNS_URI	Use XMLConstants.XML_NS_URI instead.

Methods

Method	Description
org.apache.axiom.om.impl.MIMEOutputUtils.complete(OutputStream, byte[], LinkedList, String, String, String, String)	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.finishWritingMime(OutputStream)	Use OMMultipartWriter instead.
org.apache.axiom.om.impl.MIMEOutputUtils.startWritingMime(OutputStream, String)	Use OMMultipartWriter instead.
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.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.
org.apache.axiom.om.impl.traverse.OMChildrenQNameIterator.isEquals_Legacy(QName, QName)
org.apache.axiom.om.impl.util.OMSerializerUtil.getNextNSPrefix()
org.apache.axiom.om.impl.util.OMSerializerUtil.isSetPrefixBeforeStartElement(XMLStreamWriter)	This method was used to work around a StAX conformance issue in early versions of the XL XP-J parser. This is now handled by StAXDialect, and this method always returns false.
org.apache.axiom.om.impl.util.OMSerializerUtil.serializeAttribute(OMAttribute, XMLStreamWriter)	use serializeStartpart instead
org.apache.axiom.om.impl.util.OMSerializerUtil.serializeAttributes(OMElement, XMLStreamWriter)	Consider using serializeStartpart instead
org.apache.axiom.om.impl.util.OMSerializerUtil.serializeByPullStream(OMElement, XMLStreamWriter)	This is an internal method that is no longer used.
org.apache.axiom.om.impl.util.OMSerializerUtil.serializeEndpart(XMLStreamWriter)	This is an internal method that is no longer used.
org.apache.axiom.om.impl.util.OMSerializerUtil.serializeNamespace(OMNamespace, XMLStreamWriter)	Use serializeStartpart instead
org.apache.axiom.om.impl.util.OMSerializerUtil.serializeNamespaces(OMElement, XMLStreamWriter)	Use serializeStartpart instead
org.apache.axiom.om.impl.util.OMSerializerUtil.serializeNormal(OMElement, XMLStreamWriter, boolean)	This is an internal method that is no longer used.
org.apache.axiom.om.impl.util.OMSerializerUtil.serializeStartpart(OMElement, XMLStreamWriter)	This is an internal method that is no longer used.
org.apache.axiom.om.util.AttributeHelper.importOMAttribute(OMAttribute, OMElement)	Use OMFactory.importInformationItem(OMInformationItem) instead.
org.apache.axiom.om.util.CommonUtils.isTextualPart(String)	Use ContentType.isTextual() instead.
org.apache.axiom.om.util.CopyUtils.copy(SOAPEnvelope)	This method has the same effect as calling OMInformationItem.clone(OMCloneOptions) on the source SOAPEnvelope with the following options enabled: OMCloneOptions.setFetchDataHandlers(boolean) OMCloneOptions.setPreserveModel(boolean) OMCloneOptions.setCopyOMDataSources(boolean) Instead of using this method, application code should use OMInformationItem.clone(OMCloneOptions) directly and fine tune the options for the particular use case.
org.apache.axiom.om.util.CopyUtils.reader2writer(XMLStreamReader, XMLStreamWriter)	Instead use OMXMLBuilderFactory.createStAXOMBuilder(XMLStreamReader) to create an OMDocument and then OMSerializable.serializeAndConsume(XMLStreamWriter) to write to the XMLStreamWriter.
org.apache.axiom.om.util.ElementHelper.getChildWithName(OMElement, String)	please use OMElement.getFirstChildWithName(qname) instead!
org.apache.axiom.om.util.ElementHelper.getContentID(XMLStreamReader, String)	use ElementHelper.getContentID(XMLStreamReader) instead (see AXIOM-129)
org.apache.axiom.om.util.ElementHelper.getTextAsStream(OMElement, boolean)	Use OMElement.getTextAsStream(boolean) instead.
org.apache.axiom.om.util.ElementHelper.importOMElement(OMElement, OMFactory)	Use OMFactory.importInformationItem(OMInformationItem) instead.
org.apache.axiom.om.util.ElementHelper.resolveQName(String, boolean)	The algorithm used by this method is incorrect. See AXIOM-356 for more details.
org.apache.axiom.om.util.ElementHelper.setNewElement(OMElement, OMElement, OMElement)
org.apache.axiom.om.util.ElementHelper.toSOAPHeaderBlock(OMElement, SOAPFactory)	Use SOAPFactory.createSOAPHeaderBlock(OMElement) instead.
org.apache.axiom.om.util.ElementHelper.writeTextTo(OMElement, Writer, boolean)	Use OMElement.writeTextTo(Writer, boolean) instead.
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.