Deprecated API


Contents
Deprecated Interfaces
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.tools.ws.api.wsdl.TWSDLExtensible
          This interface is deprecated, will be removed in JAX-WS 2.2 RI. 
com.sun.tools.ws.api.wsdl.TWSDLExtension
          This interface is deprecated, will be removed in JAX-WS 2.2 RI. 
com.sun.tools.ws.api.wsdl.TWSDLOperation
          This interface is deprecated, will be removed in JAX-WS 2.2 RI. 
com.sun.tools.ws.api.wsdl.TWSDLParserContext
          This interface is deprecated, will be removed in JAX-WS 2.2 RI. 
 

Deprecated Classes
com.sun.tools.ws.ant.Apt
           
com.sun.istack.tools.APTTypeVisitor
            
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 
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.tools.ws.api.TJavaGeneratorExtension
          This class is deprecated, will be removed in JAX-WS 2.2 RI. 
com.sun.tools.ws.api.wsdl.TWSDLExtensionHandler
          This class is deprecated, will be removed in JAX-WS 2.2 RI. 
 

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_NOT_IDENTIFIABLE
          only used from 1.0 
org.codehaus.stax2.XMLStreamReader2.FEATURE_DTD_OVERRIDE
          Use XMLInputFactory2.P_DTD_OVERRIDE instead. 
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.codemodel.JPackage._class(int, String, boolean)
            
com.sun.codemodel.JDefinedClass._class(int, String, boolean)
            
com.sun.codemodel.JClassContainer._class(int, String, boolean)
          use JClassContainer._class(int, String, ClassType) 
com.sun.org.apache.xml.internal.resolver.CatalogManager.allowOasisXMLCatalogPI()
          No longer static; use get/set methods. 
com.sun.codemodel.JAnnotationUse.annotate(Class)
          use JAnnotationArrayMember.annotate(java.lang.Class) 
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.tools.xjc.model.CEnumLeafInfo.canBeReferencedByIDREF()
          why are you calling the method whose return value is 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. 
org.jvnet.ws.message.MessageContextFactory.create(ClassLoader...)
           
org.jvnet.ws.message.MessageContextFactory.create(SOAPMessage, ClassLoader...)
           
org.jvnet.ws.message.MessageContextFactory.create(Source, SOAPVersion, ClassLoader...)
           
org.jvnet.ws.message.MessageContextFactory.doCreate()
           
org.jvnet.ws.message.MessageContextFactory.doCreate(SOAPMessage)
           
org.jvnet.ws.message.MessageContextFactory.doCreate(Source, SOAPVersion)
           
com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallingContext.expectText()
           
com.sun.tools.xjc.XJCListener.generatedFile(String)
          Override XJCListener.generatedFile(String, int, int). Deprecated in 2.0.1. 
com.sun.tools.xjc.model.CNonElement.getAdapterUse()
           
com.sun.tools.xjc.model.CEnumLeafInfo.getAdapterUse()
           
com.sun.tools.xjc.model.CBuiltinLeafInfo.getAdapterUse()
           
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.tools.xjc.api.JAXBModel.getClassList()
          this method is provided for now to allow gradual migration for JAX-RPC. 
com.sun.xml.xsom.impl.scd.SimpleCharStream.getColumn()
            
org.kohsuke.rngom.parse.compact.UCode_UCodeESC_CharStream.getColumn()
            
org.kohsuke.rngom.parse.compact.JavaCharStream.getColumn()
           
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.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.tools.xjc.model.CNonElement.getInfo()
           
com.sun.tools.xjc.model.CEnumLeafInfo.getInfo()
           
com.sun.tools.xjc.model.CClassRef.getInfo()
           
com.sun.tools.xjc.model.CClassInfo.getInfo()
           
com.sun.tools.xjc.model.CBuiltinLeafInfo.getInfo()
           
com.sun.tools.xjc.model.CArrayInfo.getInfo()
           
com.sun.xml.xsom.impl.scd.SimpleCharStream.getLine()
            
org.kohsuke.rngom.parse.compact.UCode_UCodeESC_CharStream.getLine()
            
org.kohsuke.rngom.parse.compact.JavaCharStream.getLine()
           
com.sun.tools.xjc.model.Model.getLocator()
          No line number available for the "root" component. 
com.sun.codemodel.JMethod.getMods()
          use JMethod.mods() 
com.sun.tools.xjc.model.CPropertyInfo.getName()
          marked as deprecated so that we can spot the use of this method. 
com.sun.tools.xjc.api.SchemaCompiler.getOptions()
          This method is not really "deprecated" (in the sense of being removed from future versions), but the JAXB team is not committed to evolve Options class in the compatible fashion. So please don't use this method unless you know what you're doing. 
com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallingContext.getPredictor()
           
com.sun.tools.xjc.model.Model.getSchemaComponent()
          Always return null. Perhaps you are interested in Model.schemaComponent? 
com.sun.xml.bind.v2.model.impl.ClassInfoImpl.getScope()
          you shouldn't be invoking this method on ClassInfoImpl. 
org.jvnet.ws.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[]. 
com.sun.tools.xjc.model.CElementInfo.getType()
          why are you calling a method that returns this? 
com.sun.codemodel.JPrimitiveType.getWrapperClass()
          Use JPrimitiveType.boxify(). 
com.sun.tools.xjc.model.CReferencePropertyInfo.getXmlName()
           
com.sun.tools.xjc.model.CElementPropertyInfo.getXmlName()
           
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.tools.xjc.model.CNonElement.isCollection()
           
com.sun.tools.xjc.model.CEnumLeafInfo.isCollection()
           
com.sun.tools.xjc.model.CBuiltinLeafInfo.isCollection()
           
com.sun.xml.bind.v2.model.impl.BuiltinLeafInfoImpl.isElement()
          always return false at this level. 
com.sun.tools.xjc.model.CClassInfo.isFinal()
          if you are calling this method directly, you must be doing something wrong. 
com.sun.tools.xjc.model.nav.NavigatorImpl.isFinal(NClass)
          no class generated by XJC is final. 
com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallerImpl.isValidating()
          since 2.0 
com.sun.tools.xjc.reader.gbind.Element.iterator()
          if you statically call this method, there's something wrong. 
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. 
com.sun.xml.xsom.impl.ElementDecl.listSubstitutables()
            
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, String, boolean)
          Compatibility with older versions. 
com.sun.codemodel.JAnnotationArrayMember.param(JAnnotationUse)
          use JAnnotationArrayMember.annotate(java.lang.Class) 
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) 
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.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.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 
com.sun.tools.xjc.XJC2Task.setStackSize(String)
          not much need for JAXB2, as we now use much less stack. 
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.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) 
 

Deprecated Constructors
com.sun.tools.xjc.reader.xmlschema.bindinfo.BIConversion(Locator)
           
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) 
 



Copyright © 2005-2012 Oracle Corporation. All Rights Reserved.