Deprecated API

Contents

• Deprecated Classes
• Deprecated Methods
• Deprecated Constructors

Deprecated Classes

Class	Description
com.sun.xml.xsom.impl.parser.SAXParserFactoryAdaptor

Deprecated Methods

Method	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.codemodel.JAnnotationUse.annotate(Class<? extends Annotation>)	use JAnnotationArrayMember.annotate(java.lang.Class<? extends java.lang.annotation.Annotation>)
com.sun.tools.xjc.model.CBuiltinLeafInfo.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.tools.xjc.model.CBuiltinLeafInfo.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.tools.xjc.XJCListener.generatedFile(String)	Override XJCListener.generatedFile(String, int, int). Deprecated in 2.0.1.
com.sun.tools.xjc.model.CBuiltinLeafInfo.getAdapterUse()
com.sun.tools.xjc.model.CEnumLeafInfo.getAdapterUse()
com.sun.tools.xjc.model.CNonElement.getAdapterUse()
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.JavaCharStream.getColumn()
org.kohsuke.rngom.parse.compact.UCode_UCodeESC_CharStream.getColumn()
com.sun.tools.xjc.model.CBuiltinLeafInfo.getElementName()	always return null at this level.
com.sun.tools.xjc.model.CArrayInfo.getInfo()
com.sun.tools.xjc.model.CBuiltinLeafInfo.getInfo()
com.sun.tools.xjc.model.CClassInfo.getInfo()
com.sun.tools.xjc.model.CClassRef.getInfo()
com.sun.tools.xjc.model.CEnumLeafInfo.getInfo()
com.sun.tools.xjc.model.CNonElement.getInfo()
com.sun.xml.xsom.impl.scd.SimpleCharStream.getLine()
org.kohsuke.rngom.parse.compact.JavaCharStream.getLine()
org.kohsuke.rngom.parse.compact.UCode_UCodeESC_CharStream.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.tools.xjc.model.Model.getSchemaComponent()	Always return null. Perhaps you are interested in Model.schemaComponent?
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.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.CElementPropertyInfo.getXmlName()
com.sun.tools.xjc.model.CReferencePropertyInfo.getXmlName()
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.CBuiltinLeafInfo.isCollection()
com.sun.tools.xjc.model.CEnumLeafInfo.isCollection()
com.sun.tools.xjc.model.CNonElement.isCollection()
com.sun.tools.xjc.model.CBuiltinLeafInfo.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.tools.xjc.reader.gbind.Element.iterator()	if you statically call this method, there's something wrong.
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.
com.sun.codemodel.JCodeModel.newAnonymousClass(JClass)	The naming convention doesn't match the rest of the CodeModel. Use JCodeModel.anonymousClass(JClass) instead.
com.sun.codemodel.JAnnotationArrayMember.param(JAnnotationUse)	use JAnnotationArrayMember.annotate(java.lang.Class<? extends java.lang.annotation.Annotation>)
com.sun.tools.xjc.XJCBase.setStackSize(String)	not much need for JAXB2, as we now use much less stack.
com.sun.codemodel.JPrimitiveType.unboxify()	calling this method from JPrimitiveType would be meaningless, since it's always guaranteed to return this.

Deprecated Constructors

Constructor	Description
com.sun.tools.xjc.reader.xmlschema.bindinfo.BIConversion(Locator)
com.sun.xml.xsom.parser.JAXPParser()	Unsafe, use JAXPParser(factory) instead with security features initialized by setting XMLConstants.FEATURE_SECURE_PROCESSING feature.
com.sun.xml.xsom.parser.XSOMParser()	Unsafe, use XSOMParser(factory) instead with security features initialized by setting XMLConstants.FEATURE_SECURE_PROCESSING feature.