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)


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.
void	addXmlRegistry(java.lang.String factoryClassName, XmlRegistry xmlReg) Add an XmlRegistry to ObjectFactory class name pair 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	createElementsForTypeMappingInfo()
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.List<ElementDeclaration>	getLocalElements()
java.util.HashMap<java.lang.String,MarshalCallback>	getMarshalCallbacks()
NamespaceInfo	getNamespaceInfoForPackage(JavaClass javaClass)
NamespaceInfo	getNamespaceInfoForPackage(JavaPackage pack, 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.Map<TypeMappingInfo,java.lang.Class>	getTypeMappingInfoToAdapterClasses()
java.util.Map<TypeMappingInfo,java.lang.Class>	getTypeMappingInfoToGeneratedClasses()
java.util.Map<TypeMappingInfo,javax.xml.namespace.QName>	getTypeMappingInfoToSchemaType()
java.util.HashMap<java.lang.String,UnmarshalCallback>	getUnmarshalCallbacks()
java.util.HashMap<java.lang.String,javax.xml.namespace.QName>	getUserDefinedSchemaTypes()
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,
java.util.Map<java.lang.String,TypeInfo>	preBuildTypeInfo(JavaClass[] javaClasses) Process class level annotations only.
void	processJavaClasses(JavaClass[] classes) This method was initially designed to handle processing one or more JavaClass instances.
NamespaceInfo	processNamespaceInformation(XmlSchema xmlSchema)
JavaClass[]	processObjectFactory(JavaClass objectFactoryClass, java.util.ArrayList<JavaClass> classes)
void	processSchemaType(java.lang.String name, java.lang.String namespace, java.lang.String jClassQualifiedName) Use name, namespace and type information to setup a user-defined schema type.
void	processSchemaType(XmlSchemaType type)
void	setDefaultNamespaceAllowed(boolean isDefaultNamespaceAllowed)
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)

Method Detail

createElementsForTypeMappingInfo

public void createElementsForTypeMappingInfo()

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,

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)

This method was initially designed to handle processing one or more JavaClass instances. Over time its functionality has been broken apart and handled in different methods. Its sole purpose now is to check for callback methods.

Parameters:

classes - this paramater can and should be null as it is not used

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(java.lang.String name,
                              java.lang.String namespace,
                              java.lang.String jClassQualifiedName)

Use name, namespace and type information to setup a user-defined schema type. This method will typically be called when processing an

Parameters:

name -

namespace -

jClassQualifiedName -

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,
                                                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()

getLocalElements

public java.util.List<ElementDeclaration> getLocalElements()

getTypeMappingInfoToGeneratedClasses

public java.util.Map<TypeMappingInfo,java.lang.Class> getTypeMappingInfoToGeneratedClasses()

getTypeMappingInfoToAdapterClasses

public java.util.Map<TypeMappingInfo,java.lang.Class> getTypeMappingInfoToAdapterClasses()

addXmlRegistry

public void addXmlRegistry(java.lang.String factoryClassName,
                           XmlRegistry xmlReg)

Add an XmlRegistry to ObjectFactory class name pair to the map.

Parameters:

factoryClassName - ObjectFactory class name

xmlReg - org.eclipse.persistence.jaxb.xmlmodel.XmlRegistry instance

getTypeMappingInfoToSchemaType

public java.util.Map<TypeMappingInfo,javax.xml.namespace.QName> getTypeMappingInfoToSchemaType()

setDefaultNamespaceAllowed

public void setDefaultNamespaceAllowed(boolean isDefaultNamespaceAllowed)