Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Annotation Types
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

com.sun.xml.bind.serializer.NamespaceContext2
in JAXB1.0.1

com.sun.xml.bind.serializer.PrefixCallback
in JAXB1.0.1

com.sun.xml.wss.impl.callback.SAMLAssertionValidator
use the new extended SAMLValidator interface An implementation of the extended SAMLValidator interface can throw UnsupportedOperationException for methods defined in this base interface.

com.sun.xml.bind.unmarshaller.SAXUnmarshallerHandler
in JAXB1.0.1

com.sun.xml.bind.unmarshaller.UnmarshallableObject
in JAXB1.0.1

com.sun.xml.bind.unmarshaller.UnmarshallingContext
in JAXB1.0.1

com.sun.xml.bind.unmarshaller.UnmarshallingEventHandler
in JAXB1.0.1

com.sun.xml.bind.validator.ValidatableObject
in JAXB1.0.1

com.sun.xml.bind.serializer.XMLSerializable
in JAXB1.0.1

com.sun.xml.bind.serializer.XMLSerializer
in JAXB1.0.1

Deprecated Classes

com.sun.xml.bind.api.BridgeContext
The caller no longer needs to use this, as Bridge has methods that can work without BridgeContext.

com.sun.xml.bind.serializer.ContentHandlerAdaptor
in JAXB1.0.1

com.sun.xml.bind.unmarshaller.ContentHandlerEx
in JAXB1.0.1

com.sun.xml.bind.unmarshaller.ContentHandlerExAdaptor
in JAXB1.0.1

com.sun.xml.bind.ContextFactory
in JAXB1.0.1

com.sun.xml.bind.DatatypeConverterImpl
in JAXB 2.2.4 - use javax.xml.bind.DatatypeConverterImpl instead or let us know why you can't

org.apache.tomcat.util.buf.DateTool
Will be replaced with a more efficient impl, based on FastDateFormat, with an API using less objects.

com.sun.xml.bind.DefaultJAXBContextImpl
in JAXB1.0.1

org.apache.tomcat.util.mx.DynamicMBeanProxy
The same functionality ( and more ) is now available in commons-modeler

com.sun.xml.bind.GrammarInfo
in JAXB1.0.1

org.apache.tomcat.util.log.Log
Commons-logging should be used instead.

com.sun.xml.bind.marshaller.MarshallerImpl
in JAXB1.0.1

com.sun.xml.bind.validator.MSVValidator
in JAXB1.0.1

com.sun.xml.bind.serializer.NamespaceContextImpl
in JAXB1.0.1

com.sun.xml.wss.impl.callback.PrefixNamespaceMappingCallback
: since XWS 2.0 EA

com.sun.xml.wss.impl.callback.PropertyCallback
This callback is no longer supported by the XWS-Security runtime, use the XWS-Security configuration file to set the above property values instead.

com.sun.org.apache.xml.internal.resolver.tools.ResolvingParser
This interface has been replaced by the ResolvingXMLReader for SAX2.

com.sun.xml.bind.marshaller.SAXMarshaller
in JAXB1.0.1

com.sun.xml.bind.unmarshaller.SAXUnmarshallerHandlerImpl
in JAXB1.0.1

com.sun.xml.bind.marshaller.SchemaLocationFilter
not used in 2.0

org.apache.tomcat.util.threads.ThreadPoolMX
This was an attempt to introduce a JMX dependency. A better solution was the ThreadPoolListener - which is more powerfull and provides the same features. The class is here for backward compatibility, all the methods are in super().

com.sun.xml.bind.TypeRegistry
in JAXB1.0.1

com.sun.xml.bind.unmarshaller.UnmarshallerImpl
in JAXB1.0.1

com.sun.xml.bind.marshaller.Util
in JAXB1.0.1

com.sun.xml.bind.validator.ValidatingUnmarshaller
in JAXB1.0.1

com.sun.xml.bind.validator.ValidatorImpl
in JAXB1.0.1

Deprecated Exceptions

com.sun.xml.bind.unmarshaller.UnreportedException
in 1.0.1. Error should be reported to the appropriate error handler as soon as it is detected.

Deprecated Annotation Types

com.sun.xml.bind.annotation.XmlIsSet
this hasn't been implemented in the RI, and this hasn't been speced yet. I believe Joe asked for this feature. I'd like to drop this.

Deprecated Fields

com.sun.xml.bind.marshaller.Messages.ERR_DANGLING_IDREF
only used from 1.0

com.sun.xml.bind.marshaller.Messages.ERR_MISSING_OBJECT
use ERR_MISSING_OBJECT2

com.sun.xml.bind.marshaller.Messages.ERR_MISSING_OBJECT2
use XMLSerializer.reportMissingObjectError(String)

com.sun.xml.bind.marshaller.Messages.ERR_NOT_IDENTIFIABLE
only used from 1.0

com.sun.xml.bind.validator.Messages.MISSING_OBJECT
use MISSING_OBJECT2

com.sun.xml.bind.validator.Messages.MISSING_OBJECT2
use com.sun.xml.bind.serializer.Util#createMissingObjectError(JAXBObject, String)

com.sun.xml.bind.v2.WellKnownNamespace.XML_NAMESPACE_URI
Use javax.xml.XMLConstants.XML_NS_URI instead;

com.sun.xml.bind.v2.WellKnownNamespace.XML_SCHEMA
Use javax.xml.XMLConstants.W3C_XML_SCHEMA_NS_URI instead;

com.sun.xml.bind.v2.WellKnownNamespace.XML_SCHEMA_INSTANCE
Use javax.xml.XMLConstants.W3C_XML_SCHEMA_INSTANCE_NS_URI instead

Deprecated Methods

com.sun.org.apache.xml.internal.resolver.CatalogManager.allowOasisXMLCatalogPI()
No longer static; use get/set methods.

com.sun.xml.bind.v2.model.impl.BuiltinLeafInfoImpl.asElement()
always return null at this level.

com.sun.xml.bind.v2.model.impl.ArrayInfoImpl.canBeReferencedByIDREF()
why are you calling a method whose return value is always known?

com.sun.org.apache.xml.internal.resolver.CatalogManager.catalogClassName()
No longer static; use get/set methods.

com.sun.org.apache.xml.internal.resolver.CatalogManager.catalogFiles()
No longer static; use get/set methods.

com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallingContext.expectText()

com.sun.xml.messaging.saaj.packaging.mime.util.ASCIIUtility.getBytes(InputStream)
this is an expensive operation that require an additional buffer reallocation just to get the array of an exact size. Unless you absolutely need the exact size array, don't use this. Use ByteOutputStream and ByteOutputStream.write(InputStream).

com.sun.xml.bind.v2.runtime.XMLSerializer.getCachedBase64DataInstance()
Base64Data is no longer cached, so that XMLStreamWriterEx impl can retain the data, like JAX-WS does.

com.sun.xml.bind.unmarshaller.UnmarshallingContext.getCurrentHandler()
Ue the getCurentEventHandler method.

com.sun.xml.bind.unmarshaller.SAXUnmarshallerHandlerImpl.getCurrentHandler()

com.sun.xml.bind.v2.model.impl.BuiltinLeafInfoImpl.getElementName()
always return null at this level.

org.jvnet.fastinfoset.FastInfosetParser.getExternalVocabularies()
The map returned will not be the same instance and contain the same entries as the map set by FastInfosetParser.setExternalVocabularies(java.util.Map) method.

com.sun.xml.txw2.output.IndentingXMLStreamWriter.getIndentStep()
Only return the length of the indent string.

com.sun.xml.txw2.output.IndentingXMLFilter.getIndentStep()
Only return the length of the indent string.

com.sun.xml.txw2.output.DataWriter.getIndentStep()
Only return the length of the indent string.

com.sun.xml.bind.marshaller.DataWriter.getIndentStep()
Only return the length of the indent string.

com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallingContext.getPredictor()

com.sun.xml.bind.v2.model.impl.ClassInfoImpl.getScope()
you shouldn't be invoking this method on ClassInfoImpl.

com.sun.xml.fastinfoset.stax.StAXDocumentParser.getTextAlgorithmBytes()
was deprecated due to security reasons. Now the method return cloned byte[].

org.apache.tomcat.util.buf.MessageBytes.getTime()
The buffer are general purpose, caching for headers should be done in headers

com.sun.org.apache.xml.internal.resolver.CatalogManager.ignoreMissingProperties(boolean)
No longer static; use get/set methods.

com.sun.xml.bind.v2.model.impl.BuiltinLeafInfoImpl.isElement()
always return false at this level.

com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallerImpl.isValidating()
since 2.0

org.apache.tomcat.util.net.PoolTcpEndpoint.log(String)

org.apache.tomcat.util.net.PoolTcpEndpoint.log(String, int)

org.apache.tomcat.util.net.PoolTcpEndpoint.log(String, Throwable)

org.apache.tomcat.util.net.PoolTcpEndpoint.log(String, Throwable, int)

com.sun.xml.bind.api.JAXBRIContext.newInstance(Class[], Collection, String, boolean)
Compatibility with older versions.

com.sun.xml.bind.unmarshaller.DOMScanner.parse(Element, ContentHandler)
in JAXB 2.0 Use DOMScanner.scan(Element)

com.sun.xml.bind.unmarshaller.DOMScanner.parseWithContext(Element, ContentHandler)
in JAXB 2.0 Use DOMScanner.scan(Element)

com.sun.org.apache.xml.internal.resolver.CatalogManager.preferPublic()
No longer static; use get/set methods.

com.sun.xml.stream.buffer.sax.SAXBufferProcessor.process(XMLStreamBuffer)
Use SAXBufferProcessor.process(XMLStreamBuffer, boolean)

com.sun.xml.stream.buffer.XMLStreamBuffer.readAsXMLReader()
Use XMLStreamBuffer.readAsXMLReader(boolean)

com.sun.org.apache.xml.internal.resolver.CatalogManager.relativeCatalogs()
No longer static; use get/set methods.

com.sun.xml.stream.buffer.AbstractProcessor.setBuffer(XMLStreamBuffer)
Use AbstractProcessor.setBuffer(XMLStreamBuffer, boolean)

com.sun.xml.txw2.output.IndentingXMLStreamWriter.setIndentStep(int)
Should use the version that takes string.

com.sun.xml.txw2.output.IndentingXMLFilter.setIndentStep(int)
Should use the version that takes string.

com.sun.xml.txw2.output.DataWriter.setIndentStep(int)
Should use the version that takes string.

com.sun.xml.bind.marshaller.DataWriter.setIndentStep(int)
Should use the version that takes string.

com.sun.xml.wss.saml.Assertion.setMajorVersion(BigInteger)
Set the saml major version for SAML1.0 and SAML1.1

com.sun.xml.wss.saml.Assertion.setMinorVersion(BigInteger)
Set the saml minor version for SAML1.0 and SAML1.1

org.apache.tomcat.util.net.TcpConnectionHandler.setServer(Object)
This has nothing to do with TcpHandling, was used as a workaround

org.apache.tomcat.util.buf.MessageBytes.setTime(long, DateFormat)
The buffer are general purpose, caching for headers should be done in headers. The second parameter allows us to pass a date format instance to avoid synchronization problems.

com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallerImpl.setValidating(boolean)
since 2.0

com.sun.xml.wss.saml.Assertion.setVersion(String)
Set the saml version for SAML2.0

com.sun.xml.stream.buffer.stax.StreamWriterBufferProcessor.setXMLStreamBuffer(XMLStreamBuffer)
Use StreamWriterBufferProcessor.setXMLStreamBuffer(XMLStreamBuffer, boolean)

com.sun.xml.stream.buffer.sax.SAXBufferProcessor.setXMLStreamBuffer(XMLStreamBuffer)
Use SAXBufferProcessor.setXMLStreamBuffer(XMLStreamBuffer, boolean).

com.sun.org.apache.xml.internal.resolver.CatalogManager.staticCatalog()
No longer static; use get/set methods.

com.sun.xml.messaging.saaj.util.ByteOutputStream.toByteArray()
because this is evil!

com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallerImpl.unmarshal(SAXSource)

com.sun.org.apache.xml.internal.resolver.CatalogManager.verbosity()
No longer static; use get/set methods.

com.sun.xml.stream.buffer.XMLStreamBuffer.writeTo(ContentHandler)
Use XMLStreamBuffer.writeTo(ContentHandler,boolean)

com.sun.xml.stream.buffer.XMLStreamBuffer.writeToXMLStreamWriter(XMLStreamWriter)
Use XMLStreamBuffer.writeToXMLStreamWriter(XMLStreamWriter, boolean)

Deprecated Constructors

org.apache.tomcat.util.buf.MessageBytes()
Use static newInstance() in order to allow future hooks.

com.sun.xml.stream.buffer.sax.SAXBufferProcessor(XMLStreamBuffer)
Use SAXBufferProcessor.SAXBufferProcessor(XMLStreamBuffer, boolean)

com.sun.xml.stream.buffer.stax.StreamWriterBufferProcessor(XMLStreamBuffer)
Use StreamWriterBufferProcessor.StreamWriterBufferProcessor(XMLStreamBuffer, boolean)