hibernate涂鸦(2)——reflection反射

systemxgl 2010-11-14

org.hibernate.annotations.common.reflection.java.JavaXPackage extends JavaXAnnotatedElemen: Hibernate对Package的适配(Adapter pattern

  -- javaReflectionManager: 父类属性

  -- annotatedElement: 父类属性

  -- public JavaXPackage(Package, JavaReflectionManager): 直接调用同参数super构造函数,分别赋值给annotatedElement和javaReflectionManager

org.hibernate.annotations.common.reflection.java.JavaXClass extends JavaXAnnotatedElement: Hibernate对Class的适配(Adapter pattern

  -- javaReflectionManager: 父类属性

  -- annotatedElement: 父类属性

  -- clazz: 同父类的annotatedElement

  -- typeEnvironment

  -- public JavaXClass(Class, TypeEnvironment, JavaReflectionManager): 调用super(Class, JavaReflectionManager),分别赋值给annotatedElement和javaReflectionManager,赋值clazz和typeEnvironment

org.hibernate.annotations.common.reflection.java.generics.IdentityTypeEnvironment implements TypeEnvironment: 饥饿单例,描述唯一类型环境,每个Type都返回它本身

  -- public Type bind(Type): 接口方法,返回Type本身。

org.hibernate.annotations.common.reflection.java.generics.TypeSwitch<T>: 对根据Type进行条件分支的代码进行抽象后得到的默认模板类,使用时继承该类并覆盖其中某些针对具体Type的方法。

  -- public final T doSwitch(Type): 核心方法,根据Type不同switch到其他分支方法,并返回指定的T。

org.hibernate.cfg.annotations.reflection.XMLContext.Default: 内部类,默认构造函数,描述配置的默认值

  -- accessType: 配置持久化工具如何访问对象的属性,AccessType为枚举类型:PROPERTY|FIELD,参考一篇对2种方式分析利弊的文章(回帖也同样不错)

--StringpackageName:包名

--Stringschema:dbschema

--Stringcatalog:dbcatalog

--BooleanmetadataComplete:是否忽略annotation设置,true表示只采用xml设置,忽略ann设置。

--BooleancascadePersist:是否级联持久化

  -- Boolean delimitedIdentifier: 是否使用db的标识界定字符

  -- public void override(Default): 用传入的Default对象的各个属性值(如果存在)更新本对象的属性值。

  -- public boolean canUseJavaAnnotations(): 返回metadataComplete的非,或者在metadataComplete为null是返回true,表示不忽略ann设置。

org.hibernate.cfg.annotations.reflection.XMLContext: 描述整个xml配置的环境,会在JPAMetadataProvider的xmlContext属性初始化时被new出来。 

  -- boolean hasContext: 指示Context是否被建立起来了,属性默认值为false。

  -- globalDefaults: 在addDocument方法里被new Default出来并设置,全局的默认配置。

  -- classOverriding: Map<String, Element>,通过className找到dom4j的节点元,包括"entity","mapped-superclass","embeddable"以及各个地方定义的"entity-listener"。

  -- defaultEntityListeners: List<String>,所有className的列表,只包括"persistence-unit-defaults"节点上定义的"entity-listener"。

  -- defaultElements: List<Element>,所有dom4j节点元素的列表,只放了root节点。

  -- defaultOverriding: Map<String, Default>,通过className找到作用在它之上的Default默认配置,每一个"entity","mapped-superclass","embeddable"都有自己的Default对象。

  -- public Default getDefault(String): 针对传入的className得到从defaultOverriding中得到该类的默认配置。

  -- public Element getXMLTree(String): 针对传入的className得到从classOverriding中得到该类的dom4j节点。

  -- public List<String> addDocument(Document): 核心方法(其他都是get属性的方法),把dom4j的doc(JPA的orm.xml)加入的当前context中,并且返回doc中存在的所有class名字

  1. hasContext置为true
  2. 如果root节点("entity-mappings")包含"persistence-unit-metadata"子节点:并且如果globalDefaults为null,则new Default对象赋值给globalDefaults,然后分析该子节点:
    1. 将"xml-mapping-metadata-complete"子子节点的值赋值给globalDefaults.metadataComplete,不存在的话默认为false;
    2. 如果"persistence-unit-defaults"子子节点存在,则分别读取各个子节点并赋值globalDefaults."schema","catalog","access":accessType,"cascade-persist","delimited-identifiers";遍历"entity-listeners"子子节点下所有"entity-listener"节点,取得"class"属性值,如果classOverriding包含了该属性值:并且如果从classOverriding根据该属性值取出的element节点名字是"entity-listener"的话就log该listener的重复定义然后继续遍历下一个,else则抛出IllegalStateException说明已经定义成entity的类不能再被定义为listener,导致遍历终止;最后将listener放入classOverriding中,而listenerClassName放入defaultEntityListeners列表中。
  3. 用root节点下面的"package","schema","catalog","access"节点构造一个Default对象传入Step5的遍历过程;
  4. 把root节点("entity-mappings")放入到defaultElements列表中;
  5. 分别遍历root下的"entity","mapped-superclass","embeddable"子节点:
    1. 取得每个子节点的"class"属性值,并与root节点下面的"package"节点提供的默认包名构成类的全限定名字,如果classOverriding包含了该className则抛出IllegalStateException说明已经定义成entity的类不能再被定义为另外的entity;else则将该子节点元素放入classOverriding中;
    2. 如果该子节点定义了"metadata-complete"节点或者"access"节点,取出这些节点值并覆盖Step3传入的Default对象,将这个变化后的Defualt对象放入defaultsOverriding中;
    3. 遍历"entity-listeners"子子节点下所有"entity-listener"节点,取得"class"属性值,并与root节点下面的"package"节点提供的默认包名构成类的全限定名字,如果classOverriding包含了该className:并且如果从classOverriding根据该属性值取出的element节点名字是"entity-listener"的话就log该listener的重复定义然后继续遍历下一个,else则抛出IllegalStateException说明已经定义成entity的类不能再被定义为listener,导致遍历终止;最后将listener放入classOverriding中。
  6. 最终return一个包含所有"entity","mapped-superclass","embeddable"以及各个地方定义的"entity-listener"的className列表。

org.hibernate.annotations.common.reflection.java.JavaMetadataProvider: 默认构造函数,在JPAMetadataProvider的metadataProvider属性初始化被new出来,对MetadataProvider接口的最简单实现

  -- public Map<Object, Object> getDefaults(): 返回一个可系列化的并且immutable的空Map,即表明不存在default的metadata。

  -- public AnnotationReader getAnnotationReader(AnnotatedElement): 用传入的有ann的元素构造一个JavaAnnotationReader对象并return。

org.hibernate.annotations.common.reflection.java.JavaAnnotationReader: 唯一参数构造函数,仅在JavaMetadataProvider的getAnnotationReader方法里被new出来,封装了一个ann元素的对象,代理该对象上访问ann的方法。

  -- annotatedElement: 封装一个具有ann定义的类型元素

org.hibernate.cfg.annotations.reflection.JPAMetadataProvider: 默认构造函数,在Configuration的reset方法中被new出来,并设置给JavaReflectionManager的metadataProvider,在JavaMetadataProvider之上增强了JPA metadata的功能(多了Default/XMLContext/cache以及提供一个特有的JPAOverridenAnnotationReader,使得xml配置和ann配置可以统一处理)。

  -- metadataProvider: transient,属性初始化时new JavaMetadataProvider对象放入作为delegate被JPAMetadataProvider代理(Proxy pattern),

  -- xmlContext: metadata的context,属性初始化时new XMLContext对象放入。

  -- cache: transient,Map<AnnotatedElement, AnnotationReader>: 缓存AnnotationReader对象,可以根据被read的具有ann的元素来查找。

  -- public AnnotationReader getAnnotationReader(AnnotatedElement): 用传入的具有ann的元素在cache里查找对应的Reader,找到则return;else找不到则判断xmlContext.hasContext(),如果已经建立的context,则用传入的annotatedElement和xmlContext一起构造出一个JPAOverridenAnnotationReader对象并缓存后return,else没有建立起context,则调用被代理的metadataProvider.getAnnotationReader(传入的annotatedElemen)方法得到一个JavaAnnotationReader对象并缓存后return。

org.hibernate.cfg.annotations.reflection.JPAOverridenAnnotationReader: 仅在JPAMetadataProvider的getAnnotationReader方法里被new出来,比JavaAnnotationReader提供更复杂的功能:在调用AnnotationReader接口定义方法前会先执行initAnnotations方法.

  -- annotatedElement: 封装一个具有ann定义的类型元素,代理了该对象上访问ann的方法。

  -- xmlContext: metadata的context,由JPAMetadataProvider通过构造函数赋值。

  -- annotations: transient,包括annotatedElement上定义的所有ann的集合(有些ann是通过xml配置新构造的)数组,由initAnnotations方法建立并填充。

  -- annotationsMap: transient,Map<Class, Annotation>,和annotations数组放的东西一样,包括annotatedElement上定义的所有ann的集合(有些ann是通过xml配置新构造的),并且以ann的类型为key;同样由initAnnotations方法建立并填充。

  -- annotationToXml: static,Map<Class, String>,通过所有JPA定义的annotation找到对应的xml配置项。会在类初始化时被建立起来并初始化所有对应值。

  -- String className

  -- String propertyName

  -- propertyType: PropertyType为枚举类型:PROPERTY/FIELD/METHOD

  -- public JPAOverridenAnnotationReader(AnnotatedElement, XMLContext): 唯一构造函数:

  1. 对annotatedElement和xmlContext赋值;
  2. 如果传入的element是Class类型,则对className赋值;
  3. 如果传入的element是Field类型,则对className/propertyName分别赋值,propertyType置为Field,并假设存在该field的get方法,取得Method对象后赋值给mirroredAttribute,如果方法不存在,NoSuchMethodException会被吃掉。
  4. 如果传入的element是Method类型,则对className赋值,如果这个Method是某个Field的get/is方法,那么propertyName赋值为Field名字,propertyType置为PROPERTY,并假设存在这个field,取的Field对象后赋值给mirroredAttribute;else情况propertyName赋值为Method名,propertyType置为METHOD。
  5. 其他类型的情况,则置className/propertyName都为null。

  -- private void initAnnotations(): 根据annotatedElement类型不同分别构造对应的annotations数组和annotationsMap以方便在read的时候可以直接读取到和orm.xml的配置融合后的ann

  • 如果className不null并且propertyName为null,说明是class类型的annotatedElement构造的reader,则调用xmlContext.getXMLTree(className)得到dom4j节点,调用xmlContext.getDefault(className)得到Default配置,然后利用Default对象和dom4j节点对象以及annotatedElement上存在的所有ann构造出一个annotations数组和一个annotationsMap,数组和map是一致的,存放规则为:不包含在annotationToXml的类型的ann,以及如果在context里已经通过xml配置了,则被这些xml配置盖后的ann;最后将xml里配置了的attributes,但在具体的class上却没有该field或者property的话,记录log,不做任何处理。
  • 如果className不null并且propertyName也不null,说明是Field/Method类型的annotatedElement构造的reader,@TODO
  • 其他情况,annotations和annotationsMap包含所有在annotatedElement上存在的ann。

org.hibernate.annotations.common.reflection.java.JavaReflectionManager.TypeKey: 静态私有内部类,一个<Type, TypeEnvironment>的Pair结构

org.hibernate.annotations.common.reflection.java.JavaReflectionManager: static初始块里log一下annotation的版本,在Configuration的reset方法中被new出来,并设置给Configuration 的reflectionManager

  -- metadataProvider

  -- packagesToXPackages: Map<Package, JavaXPackage>

  -- xClasses: Map<TypeKey, JavaXClass>

  -- public XPackage packageForName(String) throws ClassNotFoundException: 根据传入的package名字(包中必须存在package-info.java文件)通过反射得到Package对象,把Package对象和this作为参数new出一个JavaXPackage;Package对象为key,JavaXPackage对象为value,在packagesToXPackages找key,找到返回;找不到放value进packagesToXPackages并返回。

  -- public XClass classForName(String className, Class caller) throws ClassNotFoundException: ①toXClass(通过传入caller的CL使用反射得到Class对象)

  -- public XClass toXClass(Class): ②toXClass(传入的Class对象, IdentityTypeEnvironment的实例)

  -- XClass toXClass(Type, TypeEnvironment): 构造一个能特殊处理Class和ParameterizedType两种Type的TypeSwitch<XClass>,其中对待Class的处理方法为:使用传入的Class和TypeEnvironment new一个TypeKey对象作为key,使用Class和TypeEnvironment以及this new一个JavaXClass对象作为value,在xClasses里找该key,找到返回;找不到放value进xClasses并返回。

相关推荐

LetonLIU / 0评论 2020-05-29
东方咖啡屋 / 0评论 2020-01-06