Deprecated API


Contents
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.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 WSCOMMONS-210 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.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.traverse.OMChildrenLegacyQNameIterator
            
org.apache.axiom.om.impl.llom.OMNamespaceImpl
          Use OMNamespaceImpl 
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 Fields
org.apache.axiom.om.impl.MTOMConstants.ATTACHMENTS
          This was used in old versions of Axis2 as the key identifying the attachments map in the message context. You should no longer use this. 
org.apache.axiom.om.OMConstants.DATA_HANDLER
            
org.apache.axiom.om.OMConstants.IS_BINARY
            
org.apache.axiom.om.OMConstants.IS_DATA_HANDLERS_AWARE
            
org.apache.axiom.om.impl.MTOMConstants.ROOT_PART
            
 

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.util.StAXUtils.createNetworkDetachedXMLStreamReader(InputStream)
          use StAXUtils.createXMLStreamReader(StAXParserConfiguration, InputStream) with StAXParserConfiguration.STANDALONE 
org.apache.axiom.om.util.StAXUtils.createNetworkDetachedXMLStreamReader(InputStream, String)
          use StAXUtils.createXMLStreamReader(StAXParserConfiguration, InputStream, String) with StAXParserConfiguration.STANDALONE 
org.apache.axiom.om.util.StAXUtils.createNetworkDetachedXMLStreamReader(Reader)
          use StAXUtils.createXMLStreamReader(StAXParserConfiguration, Reader) with StAXParserConfiguration.STANDALONE 
org.apache.axiom.om.impl.MIMEOutputUtils.finishWritingMime(OutputStream)
          Use OMMultipartWriter instead. 
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 WSCOMMONS-429) 
org.apache.axiom.om.util.StAXUtils.getEventTypeString(int)
          Use XMLEventUtils.getEventTypeString(int) instead 
org.apache.axiom.attachments.Part.getFileName()
          The callers should not no how the part is implemented. 
org.apache.axiom.om.OMNamespace.getName()
          This method is deprecated. Please use getNamespaceURI() method instead. 
org.apache.axiom.om.OMText.getNamespace()
          This API is going away. Please use getTextAsQName() instead. 
org.apache.axiom.om.util.StAXUtils.getNetworkDetachedXMLInputFactory()
          use StAXUtils.getXMLInputFactory(StAXParserConfiguration) with StAXParserConfiguration.STANDALONE 
org.apache.axiom.om.impl.builder.StAXBuilder.init(InputStream, String, String, String)
          Not used anywhere 
org.apache.axiom.om.impl.OMNodeEx.internalSerialize(XMLStreamWriter)
          This method will be removed in a future version of Axiom. It is only here to maintain backward compatibility with projects using this method despite the fact that it is marked as internal. 
org.apache.axiom.om.impl.OMNodeEx.internalSerializeAndConsume(XMLStreamWriter)
          This method will be removed in a future version of Axiom. It is only here to maintain backward compatibility with projects using this method despite the fact that it is marked as internal. 
org.apache.axiom.om.OMOutputFormat.isAutoCloseWriter()
            
org.apache.axiom.om.impl.traverse.OMChildrenQNameIterator.isEquals_Legacy(QName, QName)
            
org.apache.axiom.om.OMXMLStreamReader.isInlineMTOM()
          This method will be removed in a future release of Axiom. See OMXMLStreamReader.setInlineMTOM(boolean) for more details. 
org.apache.axiom.om.impl.MTOMXMLStreamWriter.isOptimized()
          Serialization code should use XMLStreamWriterUtils.writeDataHandler(XMLStreamWriter, DataHandler, String, boolean) or XMLStreamWriterUtils.writeDataHandler(XMLStreamWriter, org.apache.axiom.ext.stax.datahandler.DataHandlerProvider, String, boolean) to submit any binary content and let this writer decide whether the content should be written as base64 encoded character data or using xop:Include. This makes optimization entirely transparent for the caller and there should be no need to check if the writer is producing MTOM. 
org.apache.axiom.om.impl.MTOMXMLStreamWriter.isOptimizedThreshold(OMText)
          Serialization code should use XMLStreamWriterUtils.writeDataHandler(XMLStreamWriter, DataHandler, String, boolean) or XMLStreamWriterUtils.writeDataHandler(XMLStreamWriter, org.apache.axiom.ext.stax.datahandler.DataHandlerProvider, String, boolean) to submit any binary content and let this writer decide whether the content should be written as base64 encoded character data or using xop:Include. Since the writer applies the settings defined in OMOutputFormat (including MTOM thresholds), there is not need for this method anymore. 
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.util.StAXUtils.releaseXMLInputFactory(XMLInputFactory)
          Returns an XMLInputFactory instance for reuse. 
org.apache.axiom.om.util.StAXUtils.releaseXMLOutputFactory(XMLOutputFactory)
          Returns an XMLOutputFactory instance for reuse. 
org.apache.axiom.om.util.StAXUtils.reset()
            
org.apache.axiom.om.util.ElementHelper.resolveQName(String)
          The algorithm used by this method is incorrect. See AXIOM-356 for more details. 
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.OMNode.serialize(OutputStream)
          This method is not meaningful on a node in general, but only on an OMElement. 
org.apache.axiom.om.OMNode.serialize(OutputStream, OMOutputFormat)
          This method is not meaningful on a node in general, but only on an OMElement. 
org.apache.axiom.om.OMNode.serialize(Writer)
          This method is not meaningful on a node in general, but only on an OMElement. 
org.apache.axiom.om.OMNode.serialize(Writer, OMOutputFormat)
          This method is not meaningful on a node in general, but only on an OMElement. 
org.apache.axiom.om.OMNode.serializeAndConsume(OutputStream)
          This method is not meaningful on a node in general, but only on an OMElement. 
org.apache.axiom.om.OMNode.serializeAndConsume(OutputStream, OMOutputFormat)
          This method is not meaningful on a node in general, but only on an OMElement. 
org.apache.axiom.om.OMNode.serializeAndConsume(Writer)
          This method is not meaningful on a node in general, but only on an OMElement. 
org.apache.axiom.om.OMNode.serializeAndConsume(Writer, OMOutputFormat)
          This method is not meaningful on a node in general, but only on an OMElement. 
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.serializeNamespace(OMNamespace, XMLStreamWriter)
          Use serializeStartpart instead 
org.apache.axiom.om.impl.util.OMSerializerUtil.serializeNamespaces(OMElement, XMLStreamWriter)
          Use serializeStartpart instead 
org.apache.axiom.om.OMOutputFormat.setAutoCloseWriter(boolean)
            
org.apache.axiom.om.impl.builder.StAXOMBuilder.setDoDebug(boolean)
            
org.apache.axiom.om.OMElement.setFirstChild(OMNode)
          This method should not be called, un-intentionally. When some one randomly set the first child, all the links handling will not happen inside this method. So we have moved this method to the less visible interface, OMContainerEx. 
org.apache.axiom.om.OMXMLStreamReader.setInlineMTOM(boolean)
          To return optimized base64 content as xop:Include elements, wrap the reader using XOPEncodingStreamReader or use the more generic XOPUtils.getXOPEncodedStream(XMLStreamReader) method. This method introduces unnecessary complexity in the XMLStreamReader implementation used by Axiom and will be removed in a future release. 
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.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.MTOMXMLStreamWriter.writeOptimized(OMText)
          Serialization code should use XMLStreamWriterUtils.writeDataHandler(XMLStreamWriter, DataHandler, String, boolean) or XMLStreamWriterUtils.writeDataHandler(XMLStreamWriter, org.apache.axiom.ext.stax.datahandler.DataHandlerProvider, String, boolean) to submit any binary content and let this writer decide whether the content should be written as base64 encoded character data or using xop:Include. 
org.apache.axiom.om.impl.MIMEOutputUtils.writeSOAPWithAttachmentsMessage(StringWriter, OutputStream, Attachments, OMOutputFormat)
          Use OMMultipartWriter instead. 
 



Copyright © 2004-2013 The Apache Software Foundation. All Rights Reserved.