org.eclipse.persistence.jaxb.compiler
Class AnnotationsProcessor

java.lang.Object
  org.eclipse.persistence.jaxb.compiler.AnnotationsProcessor

public class AnnotationsProcessor
extends java.lang.Object

INTERNAL:

Purpose:To perform some initial processing of Java classes and JAXB 2.0 Annotations and generate meta data that can be used by the Mappings Generator and Schema Generator

Responsibilities:

• Generate a map of TypeInfo objects, keyed on class name
• Generate a map of user defined schema types
• Identify any class-based JAXB 2.0 callback methods, and create MarshalCallback and UnmarshalCallback objects to wrap them.
• Centralize processing which is common to both Schema Generation and Mapping Generation tasks

This class does the initial processing of the JAXB 2.0 Generation. It generates meta data that can be used by the later Schema Generation and Mapping Generation steps.

See Also:

Generator

Author:

mmacivor

Since:

Oracle TopLink 11.1.1.0.0

Constructor Summary

AnnotationsProcessor(Helper helper)


AnnotationsProcessor(Helper helper, java.util.Map<JavaClass,java.lang.reflect.Type> javaClassToType)


Method Summary

SchemaTypeInfo	addClass(JavaClass javaClass)
void	addEnumTypeInfo(JavaClass javaClass, EnumTypeInfo info)
void	addPackageToNamespaceMapping(java.lang.String packageName, NamespaceInfo nsInfo) Add a package name/NamespaceInfo entry to the map.
protected boolean	areEquals(JavaClass src, java.lang.Class tgt) Compares a JavaModel JavaClass to a Class.
protected boolean	areEquals(JavaClass src, java.lang.String tgtCanonicalName) Compares a JavaModel JavaClass to a Class.
void	buildNewTypeInfo(JavaClass[] javaClasses) Convenience method which class pre and postBuildTypeInfo for a given set of JavaClasses.
void	finalizeProperties() Perform any final generation and/or validation operations on TypeInfo properties.
java.util.Map<java.lang.String,java.lang.Class>	getArrayClassesToGeneratedClasses()
java.util.Map<java.lang.reflect.Type,java.lang.Class>	getCollectionClassesToGeneratedClasses()
java.util.ArrayList<Property>	getFieldPropertiesForClass(JavaClass cls, TypeInfo info, boolean onlyPublic)
java.util.Map<java.lang.Class,JavaClass>	getGeneratedClassesToArrayClasses()
java.util.Map<java.lang.Class,java.lang.reflect.Type>	getGeneratedClassesToCollectionClasses()
java.util.HashMap<javax.xml.namespace.QName,ElementDeclaration>	getGlobalElements() Lazy load and return the map of global elements.
java.util.HashMap<java.lang.String,MarshalCallback>	getMarshalCallbacks()
NamespaceInfo	getNamespaceInfoForPackage(JavaClass javaClass)
NamespaceInfo	getNamespaceInfoForPackage(JavaPackage pack)
NamespaceInfo	getNamespaceInfoForPackage(java.lang.String packageName)
NamespaceResolver	getNamespaceResolver()
java.util.ArrayList	getNoAccessTypePropertiesForClass(JavaClass cls, TypeInfo info)
java.util.HashMap<java.lang.String,NamespaceInfo>	getPackageToNamespaceMappings()
java.util.ArrayList<Property>	getPropertiesForClass(JavaClass cls, TypeInfo info)
java.util.HashMap	getPropertyMapFromArrayList(java.util.ArrayList<Property> props)
java.util.ArrayList<Property>	getPropertyPropertiesForClass(JavaClass cls, TypeInfo info, boolean onlyPublic)
java.util.ArrayList	getPublicMemberPropertiesForClass(JavaClass cls, TypeInfo info)
javax.xml.namespace.QName	getQNameForProperty(java.lang.String defaultName, JavaHasAnnotations element, NamespaceInfo namespaceInfo, java.lang.String uri)
javax.xml.namespace.QName	getSchemaTypeFor(JavaClass javaClass)
java.lang.String	getSchemaTypeNameFor(JavaClass javaClass, XmlType xmlType)
java.lang.String	getSchemaTypeNameForClassName(java.lang.String className)
javax.xml.namespace.QName	getSchemaTypeOrNullFor(JavaClass javaClass)
java.util.HashMap<java.lang.String,TypeInfo>	getTypeInfo()
java.util.ArrayList<JavaClass>	getTypeInfoClasses()
java.util.Map<java.lang.String,TypeInfo>	getTypeInfosForPackage(java.lang.String packageName) Convenience method for returning all of the TypeInfo objects for a given package name.
java.util.HashMap<java.lang.String,UnmarshalCallback>	getUnmarshalCallbacks()
java.util.HashMap<java.lang.String,javax.xml.namespace.QName>	getUserDefinedSchemaTypes()
void	init() Initialize maps, lists, etc.
boolean	isCollectionType(JavaClass type)
boolean	isCollectionType(Property field)
boolean	isDefaultNamespaceAllowed()
boolean	isMapType(JavaClass type)
JavaClass[]	postBuildTypeInfo(JavaClass[] javaClasses) Process any additional classes (i.e. inner classes, @XmlSeeAlso, @XmlRegisrty, etc.)
java.util.Map<java.lang.String,TypeInfo>	preBuildTypeInfo(JavaClass[] javaClasses) Process class level annotations only.
void	processClassesAndProperties(JavaClass[] classes) Generate TypeInfo instances for a given array of JavaClasses.
void	processJavaClasses(JavaClass[] classes) Process a given set of JavaClass instances.
NamespaceInfo	processNamespaceInformation(XmlSchema xmlSchema)
JavaClass[]	processObjectFactory(JavaClass objectFactoryClass, java.util.ArrayList<JavaClass> classes)
void	processSchemaType(XmlSchemaType type)
void	setPackageToNamespaceMappings(java.util.HashMap<java.lang.String,NamespaceInfo> packageToNamespaceMappings) Set namespace override info from XML bindings file.
boolean	shouldGenerateTypeInfo(JavaClass javaClass)
void	updateGlobalElements(JavaClass[] classesToProcess)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AnnotationsProcessor

public AnnotationsProcessor(Helper helper)

AnnotationsProcessor

public AnnotationsProcessor(Helper helper,
                            java.util.Map<JavaClass,java.lang.reflect.Type> javaClassToType)

Method Detail

processClassesAndProperties

public void processClassesAndProperties(JavaClass[] classes)

Generate TypeInfo instances for a given array of JavaClasses.

Parameters:

classes -

init

public void init()

Initialize maps, lists, etc. Typically called prior to processing a set of classes via preBuildTypeInfo, postBuildTypeInfo, processJavaClasses.

preBuildTypeInfo

public java.util.Map<java.lang.String,TypeInfo> preBuildTypeInfo(JavaClass[] javaClasses)

Process class level annotations only. It is assumed that a call to init() has been made prior to calling this method. After the types created via this method have been modified (if necessary) postBuildTypeInfo and processJavaClasses should be called to finish processing.

Parameters:

javaClasses -

Returns:

postBuildTypeInfo

public JavaClass[] postBuildTypeInfo(JavaClass[] javaClasses)

Process any additional classes (i.e. inner classes, @XmlSeeAlso, @XmlRegisrty, etc.) for a given set of JavaClasses, then complete building all of the required TypeInfo objects. This method is typically called after init and preBuildTypeInfo have been called.

Parameters:

javaClasses -

Returns:

updated array of JavaClasses, made up of the original classes plus any additional ones

finalizeProperties

public void finalizeProperties()

Perform any final generation and/or validation operations on TypeInfo properties.

processJavaClasses

public void processJavaClasses(JavaClass[] classes)

Process a given set of JavaClass instances. @XmlIDREFs will be validated, and call back methods will be handled as required. This method is typically called after init, preBuildTypeInfo, and postBuildTypeInfo have been called.

Parameters:

classes -

shouldGenerateTypeInfo

public boolean shouldGenerateTypeInfo(JavaClass javaClass)

getPropertiesForClass

public java.util.ArrayList<Property> getPropertiesForClass(JavaClass cls,
                                                           TypeInfo info)

getFieldPropertiesForClass

public java.util.ArrayList<Property> getFieldPropertiesForClass(JavaClass cls,
                                                                TypeInfo info,
                                                                boolean onlyPublic)

areEquals

protected boolean areEquals(JavaClass src,
                            java.lang.Class tgt)

Compares a JavaModel JavaClass to a Class. Equality is based on the raw name of the JavaClass compared to the canonical name of the Class.

Parameters:

src -

tgt -

Returns:

areEquals

protected boolean areEquals(JavaClass src,
                            java.lang.String tgtCanonicalName)

Compares a JavaModel JavaClass to a Class. Equality is based on the raw name of the JavaClass compared to the canonical name of the Class.

Parameters:

src -

tgt -

Returns:

getPropertyPropertiesForClass

public java.util.ArrayList<Property> getPropertyPropertiesForClass(JavaClass cls,
                                                                   TypeInfo info,
                                                                   boolean onlyPublic)

getPublicMemberPropertiesForClass

public java.util.ArrayList getPublicMemberPropertiesForClass(JavaClass cls,
                                                             TypeInfo info)

getPropertyMapFromArrayList

public java.util.HashMap getPropertyMapFromArrayList(java.util.ArrayList<Property> props)

getNoAccessTypePropertiesForClass

public java.util.ArrayList getNoAccessTypePropertiesForClass(JavaClass cls,
                                                             TypeInfo info)

processSchemaType

public void processSchemaType(XmlSchemaType type)

addEnumTypeInfo

public void addEnumTypeInfo(JavaClass javaClass,
                            EnumTypeInfo info)

getSchemaTypeNameForClassName

public java.lang.String getSchemaTypeNameForClassName(java.lang.String className)

getSchemaTypeOrNullFor

public javax.xml.namespace.QName getSchemaTypeOrNullFor(JavaClass javaClass)

getSchemaTypeFor

public javax.xml.namespace.QName getSchemaTypeFor(JavaClass javaClass)

isCollectionType

public boolean isCollectionType(Property field)

isCollectionType

public boolean isCollectionType(JavaClass type)

processNamespaceInformation

public NamespaceInfo processNamespaceInformation(XmlSchema xmlSchema)

getTypeInfo

public java.util.HashMap<java.lang.String,TypeInfo> getTypeInfo()

getTypeInfoClasses

public java.util.ArrayList<JavaClass> getTypeInfoClasses()

getUserDefinedSchemaTypes

public java.util.HashMap<java.lang.String,javax.xml.namespace.QName> getUserDefinedSchemaTypes()

getNamespaceResolver

public NamespaceResolver getNamespaceResolver()

getSchemaTypeNameFor

public java.lang.String getSchemaTypeNameFor(JavaClass javaClass,
                                             XmlType xmlType)

getQNameForProperty

public javax.xml.namespace.QName getQNameForProperty(java.lang.String defaultName,
                                                     JavaHasAnnotations element,
                                                     NamespaceInfo namespaceInfo,
                                                     java.lang.String uri)

getPackageToNamespaceMappings

public java.util.HashMap<java.lang.String,NamespaceInfo> getPackageToNamespaceMappings()

addPackageToNamespaceMapping

public void addPackageToNamespaceMapping(java.lang.String packageName,
                                         NamespaceInfo nsInfo)

Add a package name/NamespaceInfo entry to the map. This method will lazy-load the map if necessary.

getNamespaceInfoForPackage

public NamespaceInfo getNamespaceInfoForPackage(JavaClass javaClass)

getNamespaceInfoForPackage

public NamespaceInfo getNamespaceInfoForPackage(JavaPackage pack)

getNamespaceInfoForPackage

public NamespaceInfo getNamespaceInfoForPackage(java.lang.String packageName)

getMarshalCallbacks

public java.util.HashMap<java.lang.String,MarshalCallback> getMarshalCallbacks()

getUnmarshalCallbacks

public java.util.HashMap<java.lang.String,UnmarshalCallback> getUnmarshalCallbacks()

processObjectFactory

public JavaClass[] processObjectFactory(JavaClass objectFactoryClass,
                                        java.util.ArrayList<JavaClass> classes)

getGlobalElements

public java.util.HashMap<javax.xml.namespace.QName,ElementDeclaration> getGlobalElements()

Lazy load and return the map of global elements.

Returns:

updateGlobalElements

public void updateGlobalElements(JavaClass[] classesToProcess)

isMapType

public boolean isMapType(JavaClass type)

getCollectionClassesToGeneratedClasses

public java.util.Map<java.lang.reflect.Type,java.lang.Class> getCollectionClassesToGeneratedClasses()

getArrayClassesToGeneratedClasses

public java.util.Map<java.lang.String,java.lang.Class> getArrayClassesToGeneratedClasses()

getGeneratedClassesToCollectionClasses

public java.util.Map<java.lang.Class,java.lang.reflect.Type> getGeneratedClassesToCollectionClasses()

getGeneratedClassesToArrayClasses

public java.util.Map<java.lang.Class,JavaClass> getGeneratedClassesToArrayClasses()

getTypeInfosForPackage

public java.util.Map<java.lang.String,TypeInfo> getTypeInfosForPackage(java.lang.String packageName)

Convenience method for returning all of the TypeInfo objects for a given package name. This method is inefficient as we need to iterate over the entire typeinfo map for each call. We should eventually store the TypeInfos in a Map based on package name, i.e.: Map>

Parameters:

packageName -

Returns:

List of TypeInfo objects for a given package name

setPackageToNamespaceMappings

public void setPackageToNamespaceMappings(java.util.HashMap<java.lang.String,NamespaceInfo> packageToNamespaceMappings)

Set namespace override info from XML bindings file. This will typically be called from the XMLProcessor.

Parameters:

packageToNamespaceMappings -

addClass

public SchemaTypeInfo addClass(JavaClass javaClass)

buildNewTypeInfo

public void buildNewTypeInfo(JavaClass[] javaClasses)

Convenience method which class pre and postBuildTypeInfo for a given set of JavaClasses.

Parameters:

javaClasses -

isDefaultNamespaceAllowed

public boolean isDefaultNamespaceAllowed()