org.hibernate.cfg

Class AnnotationBinder

java.lang.Object

org.hibernate.cfg.AnnotationBinder

public final class AnnotationBinder
extends Object

JSR 175 annotation binder which reads the annotations from classes, applies the principles of the EJB3 spec and produces the Hibernate configuration-time metamodel (the classes in the org.hibernate.mapping package)

Some design description I tried to remove any link to annotation except from the 2 first level of method call. It'll enable to: - facilitate annotation overriding - mutualize one day xml and annotation binder (probably a dream though) - split this huge class in smaller mapping oriented classes bindSomething usually create the mapping container and is accessed by one of the 2 first level method makeSomething usually create the mapping container and is accessed by bindSomething[else] fillSomething take the container into parameter and fill it.

Author:

Emmanuel Bernard, Hardy Ferentschik

Method Summary

Modifier and Type	Method and Description
static void	bindClass(XClass clazzToProcess, Map<XClass,InheritanceState> inheritanceStatePerClass, MetadataBuildingContext context) Bind a class having JSR175 annotations.
static void	bindDefaults(MetadataBuildingContext context)
static void	bindPackage(String packageName, MetadataBuildingContext context)
static Map<XClass,InheritanceState>	buildInheritanceStates(List<XClass> orderedClasses, MetadataBuildingContext buildingContext) For the mapped entities build some temporary data-structure containing information about the inheritance status of a class.
static Component	createComponent(PropertyHolder propertyHolder, PropertyData inferredData, boolean isComponentEmbedded, boolean isIdentifierMapper, MetadataBuildingContext context)
protected static void	defineFetchingStrategy(ToOne toOne, XProperty property)
static Component	fillComponent(PropertyHolder propertyHolder, PropertyData inferredData, AccessType propertyAccessor, boolean isNullable, EntityBinder entityBinder, boolean isComponentEmbedded, boolean isIdentifierMapper, boolean inSecondPass, MetadataBuildingContext buildingContext, Map<XClass,InheritanceState> inheritanceStatePerClass)
static Component	fillComponent(PropertyHolder propertyHolder, PropertyData inferredData, PropertyData baseInferredData, AccessType propertyAccessor, boolean isNullable, EntityBinder entityBinder, boolean isComponentEmbedded, boolean isIdentifierMapper, boolean inSecondPass, MetadataBuildingContext buildingContext, Map<XClass,InheritanceState> inheritanceStatePerClass)
static String	generatorType(GeneratedValue generatedValueAnn, MetadataBuildingContext buildingContext, XClass javaTypeXClass)
static FetchMode	getFetchMode(FetchType fetch)
static boolean	isDefault(XClass clazz, MetadataBuildingContext context)

Methods inherited from class java.lang.Object

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

Method Detail

bindDefaults

public static void bindDefaults(MetadataBuildingContext context)

bindPackage

public static void bindPackage(String packageName,
                               MetadataBuildingContext context)

bindClass

public static void bindClass(XClass clazzToProcess,
                             Map<XClass,InheritanceState> inheritanceStatePerClass,
                             MetadataBuildingContext context)
                      throws MappingException

Bind a class having JSR175 annotations. Subclasses have to be bound after its parent class.

Parameters:

clazzToProcess - entity to bind as XClass instance

inheritanceStatePerClass - Meta data about the inheritance relationships for all mapped classes

Throws:

MappingException - in case there is a configuration error

generatorType

public static String generatorType(GeneratedValue generatedValueAnn,
                                   MetadataBuildingContext buildingContext,
                                   XClass javaTypeXClass)

fillComponent

public static Component fillComponent(PropertyHolder propertyHolder,
                                      PropertyData inferredData,
                                      AccessType propertyAccessor,
                                      boolean isNullable,
                                      EntityBinder entityBinder,
                                      boolean isComponentEmbedded,
                                      boolean isIdentifierMapper,
                                      boolean inSecondPass,
                                      MetadataBuildingContext buildingContext,
                                      Map<XClass,InheritanceState> inheritanceStatePerClass)

fillComponent

public static Component fillComponent(PropertyHolder propertyHolder,
                                      PropertyData inferredData,
                                      PropertyData baseInferredData,
                                      AccessType propertyAccessor,
                                      boolean isNullable,
                                      EntityBinder entityBinder,
                                      boolean isComponentEmbedded,
                                      boolean isIdentifierMapper,
                                      boolean inSecondPass,
                                      MetadataBuildingContext buildingContext,
                                      Map<XClass,InheritanceState> inheritanceStatePerClass)

createComponent

public static Component createComponent(PropertyHolder propertyHolder,
                                        PropertyData inferredData,
                                        boolean isComponentEmbedded,
                                        boolean isIdentifierMapper,
                                        MetadataBuildingContext context)

defineFetchingStrategy

protected static void defineFetchingStrategy(ToOne toOne,
                                             XProperty property)

getFetchMode

public static FetchMode getFetchMode(FetchType fetch)

isDefault

public static boolean isDefault(XClass clazz,
                                MetadataBuildingContext context)

buildInheritanceStates

public static Map<XClass,InheritanceState> buildInheritanceStates(List<XClass> orderedClasses,
                                                                  MetadataBuildingContext buildingContext)

For the mapped entities build some temporary data-structure containing information about the inheritance status of a class.

Parameters:

orderedClasses - Order list of all annotated entities and their mapped superclasses

Returns:

A map of InheritanceStates keyed against their XClass.