Deprecated API

Contents

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

Deprecated Classes

Class and Description
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.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.
org.apache.tomcat.util.mx.DynamicMBeanProxy The same functionality ( and more ) is now available in commons-modeler
org.apache.tomcat.util.log.Log Commons-logging should be used instead.
com.sun.org.apache.xml.internal.resolver.tools.ResolvingParser This interface has been replaced by the ResolvingXMLReader for SAX2.
com.sun.xml.xsom.impl.parser.SAXParserFactoryAdaptor
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.tools.ws.ant.WsGen2

Deprecated Annotation Types

Annotation Type and Description
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

Field and Description
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_NOT_IDENTIFIABLE only used from 1.0
org.codehaus.stax2.XMLStreamReader2.FEATURE_DTD_OVERRIDE Use XMLInputFactory2.P_DTD_OVERRIDE instead.
com.sun.xml.bind.DatatypeConverterImpl.theInstance
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

Method and Description
com.sun.codemodel.JClassContainer._class(int, String, boolean) use JClassContainer._class(int, String, ClassType)
com.sun.codemodel.JDefinedClass._class(int, String, boolean)
com.sun.codemodel.JPackage._class(int, String, boolean)
com.sun.org.apache.xml.internal.resolver.CatalogManager.allowOasisXMLCatalogPI() No longer static; use get/set methods.
com.sun.codemodel.JAnnotationUse.annotate(Class<? extends Annotation>) use JAnnotationArrayMember.annotate(java.lang.Class<? extends java.lang.annotation.Annotation>)
com.sun.xml.bind.v2.model.impl.BuiltinLeafInfoImpl.asElement() always return null at this level.
com.sun.codemodel.JClass.boxify() calling this method from JClass would be meaningless, since it's always guaranteed to return this.
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.oracle.webservices.api.message.MessageContextFactory.create(ClassLoader...)
com.oracle.webservices.api.message.MessageContextFactory.create(SOAPMessage, ClassLoader...)
com.oracle.webservices.api.message.MessageContextFactory.create(Source, SOAPVersion, ClassLoader...)
com.sun.xml.bind.v2.ContextFactory.createContext(Class[], Collection<TypeReference>, Map<Class, Class>, String, boolean, RuntimeAnnotationReader, boolean, boolean, boolean) use createContext(Class[] classes, Map<String,Object> properties) method instead
com.sun.xml.bind.v2.ContextFactory.createContext(Class[], Collection<TypeReference>, Map<Class, Class>, String, boolean, RuntimeAnnotationReader, boolean, boolean, boolean, boolean) use createContext( Class[] classes, Map<String,Object> properties) method instead
com.oracle.webservices.api.message.MessageContextFactory.createContext(InputStream, MimeHeaders) http://java.net/jira/browse/JAX_WS-1077
com.oracle.webservices.api.message.BasePropertySet.createMapView() use newer implementation PropertySet.asMap() which produces readwrite Map
com.oracle.webservices.api.message.PropertySet.createMapView() use newer implementation BasePropertySet.asMap() which produces readwrite Map
com.oracle.webservices.api.message.MessageContextFactory.doCreate()
com.oracle.webservices.api.message.MessageContextFactory.doCreate(SOAPMessage)
com.oracle.webservices.api.message.MessageContextFactory.doCreate(Source, SOAPVersion)
com.oracle.webservices.api.databinding.Databinding.Builder.entityResolver(EntityResolver) - no replacement - this was never implemented Sets the EntityResolver for reading the WSDL
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.xsom.impl.scd.SimpleCharStream.getColumn()
org.kohsuke.rngom.parse.compact.JavaCharStream.getColumn()
org.kohsuke.rngom.parse.compact.UCode_UCodeESC_CharStream.getColumn() @see #getEndColumn
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.
org.codehaus.stax2.XMLStreamReader2.getFeature(String) Should use XMLStreamReader.getProperty(java.lang.String) instead
com.sun.xml.bind.marshaller.DataWriter.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.txw2.output.IndentingXMLFilter.getIndentStep() Only return the length of the indent string.
com.sun.xml.txw2.output.IndentingXMLStreamWriter.getIndentStep() Only return the length of the indent string.
com.sun.xml.xsom.impl.scd.SimpleCharStream.getLine()
org.kohsuke.rngom.parse.compact.JavaCharStream.getLine()
org.kohsuke.rngom.parse.compact.UCode_UCodeESC_CharStream.getLine() @see #getEndLine
com.sun.codemodel.JMethod.getMods() use JMethod.mods()
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.oracle.webservices.api.message.MessageContext.getSOAPMessage() use getAsSOAPMessage
com.sun.xml.xsom.XSSchema.getSourceDocument() Since this method always returns null, if you are calling this method from XSSchema and not from XSComponent, there's something wrong with your code.
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.codemodel.JPrimitiveType.getWrapperClass() Use JPrimitiveType.boxify().
com.sun.org.apache.xml.internal.resolver.CatalogManager.ignoreMissingProperties(boolean) No longer static; use get/set methods.
com.sun.xml.xsom.XSDeclaration.isAnonymous() use the isGlobal method, which always returns the opposite of this function. Or the isLocal method.
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
com.sun.xml.xsom.impl.ElementDecl.listSubstitutables()
com.sun.xml.xsom.XSElementDecl.listSubstitutables() this method allocates a new array every time, so it could be inefficient when working with a large schema. Use XSElementDecl.getSubstitutables() instead.
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.codemodel.JCodeModel.newAnonymousClass(JClass) The naming convention doesn't match the rest of the CodeModel. Use JCodeModel.anonymousClass(JClass) instead.
com.sun.xml.bind.api.JAXBRIContext.newInstance(Class[], Collection<TypeReference>, String, boolean) Compatibility with older versions.
com.sun.codemodel.JAnnotationArrayMember.param(JAnnotationUse) use JAnnotationArrayMember.annotate(java.lang.Class<? extends java.lang.annotation.Annotation>)
com.sun.xml.bind.unmarshaller.DOMScanner.parse(Element, ContentHandler) in JAXB 2.0 Use DOMScanner.scan(Element)
com.sun.xml.bind.DatatypeConverterImpl.parseAnySimpleType(String)
com.sun.xml.bind.DatatypeConverterImpl.parseBase64Binary(String)
com.sun.xml.bind.DatatypeConverterImpl.parseBoolean(String)
com.sun.xml.bind.DatatypeConverterImpl.parseByte(String)
com.sun.xml.bind.DatatypeConverterImpl.parseDate(String)
com.sun.xml.bind.DatatypeConverterImpl.parseDateTime(String)
com.sun.xml.bind.DatatypeConverterImpl.parseDecimal(String)
com.sun.xml.bind.DatatypeConverterImpl.parseDouble(String)
com.sun.xml.bind.DatatypeConverterImpl.parseFloat(String)
com.sun.xml.bind.DatatypeConverterImpl.parseHexBinary(String)
com.sun.xml.bind.DatatypeConverterImpl.parseInt(String)
com.sun.xml.bind.DatatypeConverterImpl.parseInteger(String)
com.sun.xml.bind.DatatypeConverterImpl.parseLong(String)
com.sun.xml.bind.DatatypeConverterImpl.parseQName(String, NamespaceContext)
com.sun.xml.bind.DatatypeConverterImpl.parseShort(String)
com.sun.xml.bind.DatatypeConverterImpl.parseString(String)
com.sun.xml.bind.DatatypeConverterImpl.parseTime(String)
com.sun.xml.bind.DatatypeConverterImpl.parseUnsignedInt(String)
com.sun.xml.bind.DatatypeConverterImpl.parseUnsignedShort(String)
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.bind.DatatypeConverterImpl.printAnySimpleType(String)
com.sun.xml.bind.DatatypeConverterImpl.printBase64Binary(byte[])
com.sun.xml.bind.DatatypeConverterImpl.printBoolean(boolean)
com.sun.xml.bind.DatatypeConverterImpl.printByte(byte)
com.sun.xml.bind.DatatypeConverterImpl.printDate(Calendar)
com.sun.xml.bind.DatatypeConverterImpl.printDateTime(Calendar)
com.sun.xml.bind.DatatypeConverterImpl.printDecimal(BigDecimal)
com.sun.xml.bind.DatatypeConverterImpl.printDouble(double)
com.sun.xml.bind.DatatypeConverterImpl.printFloat(float)
com.sun.xml.bind.DatatypeConverterImpl.printHexBinary(byte[])
com.sun.xml.bind.DatatypeConverterImpl.printInt(int)
com.sun.xml.bind.DatatypeConverterImpl.printInteger(BigInteger)
com.sun.xml.bind.DatatypeConverterImpl.printLong(long)
com.sun.xml.bind.DatatypeConverterImpl.printQName(QName, NamespaceContext)
com.sun.xml.bind.DatatypeConverterImpl.printShort(short)
com.sun.xml.bind.DatatypeConverterImpl.printString(String)
com.sun.xml.bind.DatatypeConverterImpl.printTime(Calendar)
com.sun.xml.bind.DatatypeConverterImpl.printUnsignedInt(long)
com.sun.xml.bind.DatatypeConverterImpl.printUnsignedShort(int)
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)
org.codehaus.stax2.XMLStreamReader2.setFeature(String, Object) Should use XMLStreamReader2.setProperty(java.lang.String, java.lang.Object) instead
com.sun.xml.bind.marshaller.DataWriter.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.txw2.output.IndentingXMLFilter.setIndentStep(int) Should use the version that takes string.
com.sun.xml.txw2.output.IndentingXMLStreamWriter.setIndentStep(int) Should use the version that takes string.
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.stream.buffer.sax.SAXBufferProcessor.setXMLStreamBuffer(XMLStreamBuffer) Use SAXBufferProcessor.setXMLStreamBuffer(XMLStreamBuffer, boolean).
com.sun.xml.stream.buffer.stax.StreamWriterBufferProcessor.setXMLStreamBuffer(XMLStreamBuffer) Use StreamWriterBufferProcessor.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.codemodel.JPrimitiveType.unboxify() calling this method from JPrimitiveType would be meaningless, since it's always guaranteed to return this.
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)
com.oracle.webservices.api.databinding.Databinding.Builder.wsdlSource(Source) - no replacement - this was never implemented Sets the WSDL Source where the WSDL can be read from
com.oracle.webservices.api.databinding.Databinding.Builder.wsdlURL(URL) - no replacement - this was never implemented Sets the WSDL URL where the WSDL can be read from

Deprecated Constructors

Constructor and Description
com.sun.xml.xsom.parser.JAXPParser() Unsafe, use JAXPParser(factory) instead with security features initialized by setting XMLConstants.FEATURE_SECURE_PROCESSING feature.
com.sun.istack.localization.LocalizableMessage(String, String, Object...)
com.sun.istack.localization.LocalizableMessageFactory(String)
org.apache.tomcat.util.buf.MessageBytes() Use static newInstance() in order to allow future hooks.
com.sun.xml.bind.marshaller.SAX2DOMEx()
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)
com.sun.xml.xsom.parser.XSOMParser() Unsafe, use XSOMParser(factory) instead with security features initialized by setting XMLConstants.FEATURE_SECURE_PROCESSING feature.