反射api操作注解示例

mybatis流程详解

Author: GitJavaProgramming

.idea/workspace.xml

@@ -1,14 +1,19 @@
 # mybatis-test
- **mybatis源码研究-2019/12/04**
-        
-        从整体到局部，最后再回到整体，从全局把控mybatis各个模块；深挖mybatis所有核心知识点，让你真正掌握mybatis核心设计思想；
+ 
+ mybatis源码研究-2019/12/04   
+ 教你一周精通mybatis（调试版本：3.5.3）
+ 从整体到局部，最后再回到整体，从全局把控mybatis各个模块；     
+ 深挖mybatis所有核心知识点，真正掌握mybatis核心设计思想；    
+ 赠送各种流程图，思维导图。  
+ 
 
 
 导航目录
 =================
 
    * [mybatis-test](#mybatis-test)
    * [导航目录](#导航目录)
+   * [一个例子](#一个例子)
    * [XML基础知识（名称空间/文档验证/文档处理）](#xml基础知识名称空间文档验证文档处理)
       * [XML](#xml)
       * [XML名称空间](#xml名称空间)
@@ -30,6 +35,8 @@
             * [注解：](#注解)
             * [泛型：](#泛型)
             * [JDK动态代理](#jdk动态代理)
+   * [从头开始](#从头开始)
+      * [mybatis初始化流程](#mybatis初始化流程)
    * [<em><strong>mybatis思维导图</strong></em>](#mybatis思维导图)
    * [<em><strong>主要参考资料：</strong></em>](#主要参考资料)
 
@@ -40,6 +47,10 @@ mybatis整体架构分为三层，分别是基础支持层、核心处理层和
 > ![mybatis整体架构图](./mybatis整体架构图02.png "mybatis整体架构图")    
 
 ****
+# 一个例子
+参考项目代码~~~  
+[详细标签版-MyBatis技术内幕](https://pan.baidu.com/s/1-JGtoXADDjQRw5v51np4vA "提取码是fcak")  
+
 # XML基础知识（名称空间/文档验证/文档处理）
 
 ## XML
@@ -277,9 +288,19 @@ Class (java.lang)
    泛型擦除会移除参数类型信息，数组必须知道所持有的确切类型，以强制保证类型安全。  
 
 #### JDK动态代理
-   参考：package   org.pp.mybatis.foundationsupportlayer.reflector.proxy
-   描述文件 proxy.txt  
-   测试类入口： Client.main  
+   参考：package   org.pp.mybatis.foundationsupportlayer.reflector.proxy   
+   描述文件 proxy.txt    
+   测试类入口： Client.main    
+
+关于模拟spring IOC请参考我的另一个repo：https://github.com/GitJavaProgramming/JavaAdvance/tree/master/src/reflection
+
+# 从头开始
+mybatis入口： SqlSessionFactoryBuilder读取xml文档，解析并构造Configuration，根据Configuration构造sqlSessionFactory  
+sqlSessionFactory可以很轻易的拿到sqlSession，sqlSession提供系列操作方法,    
+sqlSession Javadoc：Through this interface you can execute commands, get mappers and manage transactions.。  
+## mybatis初始化流程   
+mybatis初始化之后Configuration、sqlSessionFactory均已构造完成。  
+> ![mybatis初始化流程](./mybatis初始化流程.png "mybatis初始化流程图")   
 
 # ***mybatis思维导图***  
 > ![mybatis思维导图](./mybatis整体架构图01.png "mybatis思维导图")  
@@ -288,7 +309,7 @@ Class (java.lang)
 > - [x] [MyBatis技术内幕  徐郡明  2017/07](https://pan.baidu.com/s/1-JGtoXADDjQRw5v51np4vA "提取码是fcak")  
 > - [x] [MyBatis 3 源码深度解析  江荣波  2019/10]     
 > - [x] [MyBatis从入门到精通  刘增辉  2017/07](https://pan.baidu.com/s/1-JGtoXADDjQRw5v51np4vA "提取码是fcak")   
-> - [x] [深入浅出MyBatis 技术原理与实战  杨开振  2016/09](https://pan.baidu.com/s/1-JGtoXADDjQRw5v51np4vA "提取码是fcak")  
+> - [x] [深入浅出MyBatis 技术原理与实战 杨开振 2016/09](https://pan.baidu.com/s/1-JGtoXADDjQRw5v51np4vA "提取码是fcak")  
 > - [x] [xml](https://www.w3school.com.cn/xml/index.asp "W3CSchool") 
 > - [x] [dtd](https://www.w3school.com.cn/dtd/dtd_entities.asp "W3CSchool") 
 > - [x] [schema](https://www.w3school.com.cn/schema/index.asp "W3CSchool") 

README.md

@@ -0,0 +1,78 @@
+注解：一种标记，用于对java说明，注释。
+作用分类：
+①编写文档：通过代码里标识的元数据生成文档【生成文档doc文档】
+② 代码分析：通过代码里标识的元数据对代码进行分析【使用反射】
+③编译检查：通过代码里标识的元数据让编译器能够实现基本的编译检查【Override】
+
+元注解：负责注解其他注解
+Java5.0定义了4个标准的meta-annotation类型，它们被用来提供对其它 annotation类型作说明。Java5.0定义的元注解：
+@Target,@Retention,@Documented,@Inherited
+
+@Target
+作用：用于描述注解的使用范围
+注解可被用于 packages、types（类、接口、枚举、Annotation类型）、类型成员（方法、构造方法、成员变量、枚举值）、方法参数和本地变量（如循环变量、catch参数）。
+在Annotation类型的声明中使用了target可更加明晰其修饰的目标。
+取值(ElementType)有：
+　　　　1.CONSTRUCTOR:用于描述构造器
+　　　　2.FIELD:用于描述域
+　　　　3.LOCAL_VARIABLE:用于描述局部变量
+　　　　4.METHOD:用于描述方法
+　　　　5.PACKAGE:用于描述包
+　　　　6.PARAMETER:用于描述参数
+　　　　7.TYPE:用于描述类、接口(包括注解类型) 或enum声明
+
+@Retention
+作用：表示需要在什么级别保存该注释信息，用于描述注解的生命周期
+@Retention定义了该Annotation被保留的时间长短：某些Annotation仅出现在源代码中，而被编译器丢弃；而另一些却被编译在class文件中；
+编译在class文件中的Annotation可能会被虚拟机忽略，而另一些在class被装载时将被读取（请注意并不影响class的执行，因为Annotation与class在使用上是被分离的）。
+使用这个meta-Annotation可以对 Annotation的“生命周期”限制。
+取值（RetentionPoicy）有：
+　　　　1.SOURCE:在源文件中有效（即源文件保留） 无法通过发射获取
+　　　　2.CLASS:在class文件中有效（即class保留）
+　　　　3.RUNTIME:在运行时有效（即运行时保留）
+Retention meta-annotation类型有唯一的value作为成员，它的取值来自java.lang.annotation.RetentionPolicy的枚举类型值。
+
+@Documented
+用于描述其它类型的annotation应该被作为被标注的程序成员的公共API，因此可以被例如javadoc此类的工具文档化。Documented是一个标记注解，没有成员。
+
+@Inherited
+阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class，则这个annotation将被用于该class的子类。
+注意：@Inherited annotation类型是被标注过的class的子类所继承。类并不从它所实现的接口继承annotation，方法并不从它所重载的方法继承annotation。
+
+自定义注解
+使用@interface自定义注解时，自动继承了java.lang.annotation.Annotation接口，由编译程序自动完成其他细节。在定义注解时，不能继承其他的注解或接口。
+@interface用来声明一个注解，其中的每一个方法实际上是声明了一个配置参数。方法的名称就是参数的名称，返回值类型就是参数的类型（返回值类型只能是基本类型、Class、String、enum）。可以通过default来声明参数的默认值。
+定义注解格式：
+　　public @interface 注解名 {定义体}
+
+　　注解参数的可支持数据类型：
+　　　　1.所有基本数据类型（int,float,boolean,byte,double,char,long,short)
+　　　　2.String类型
+　　　　3.Class类型
+　　　　4.enum类型
+　　　　5.Annotation类型
+　　　　6.以上所有类型的数组
+
+　　Annotation类型里面的参数该怎么设定:
+　　第一,只能用public或默认(default)这两个访问权修饰.例如,String value();这里把方法设为defaul默认类型；　 　
+　　第二,参数成员只能用基本类型byte,short,char,int,long,float,double,boolean八种基本数据类型和 String,Enum,Class,annotations等数据类型,以及这一些类型的数组.例如,String value();这里的参数成员就为String;　　
+　　第三,如果只有一个参数成员,最好把参数名称设为"value",后加小括号.例:下面的例子FruitName注解就只有一个参数成员。
+
+注解处理器类库(java.lang.reflect.AnnotatedElement)：
+Java在java.lang.reflect 包下新增了AnnotatedElement接口，该接口代表程序中可以接受注解的程序元素，该接口主要有如下几个实现类：
+
+　　Class：类定义
+　　Constructor：构造器定义
+　　Field：累的成员变量定义
+　　Method：类的方法定义
+　　Package：类的包定义
+
+java.lang.reflect 包下主要包含一些实现反射功能的工具类，实际上，java.lang.reflect 包所有提供的反射API扩充了读取运行时Annotation信息的能力。
+当一个Annotation类型被定义为运行时的Annotation后，该注解才能是运行时可见，当class文件被装载时被保存在class文件中的Annotation才会被虚拟机读取。
+
+AnnotatedElement 接口是所有程序元素（Class、Method和Constructor）的父接口，所以程序通过反射获取了某个类的AnnotatedElement对象之后，程序就可以调用该对象的如下四个个方法来访问Annotation信息：
+　　方法1：<T extends Annotation> T getAnnotation(Class<T> annotationClass): 返回改程序元素上存在的、指定类型的注解，如果该类型注解不存在，则返回null。
+　　方法2：Annotation[] getAnnotations():返回该程序元素上存在的所有注解。
+　　方法3：boolean is AnnotationPresent(Class<?extends Annotation> annotationClass):判断该程序元素上是否包含指定类型的注解，存在则返回true，否则返回false.
+　　方法4：Annotation[] getDeclaredAnnotations()：返回直接存在于此元素上的所有注释。与此接口中的其他方法不同，该方法将忽略继承的注释。（如果没有注释直接存在于此元素上，则返回长度为零的一个数组。）
+该方法的调用者可以随意修改返回的数组；这不会对其他调用者返回的数组产生任何影响。

mybatis初始化流程.png

@@ -0,0 +1,15 @@
+package org.pp.annotation.demo_sql;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+
+@Target(ElementType.FIELD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface Constraints{
+	boolean primaryKey() default false;
+	boolean allowNull() default true;
+	boolean unique() default false;
+}

src/main/java/org/pp/annotation/annotation.jpg

@@ -0,0 +1,12 @@
+package org.pp.annotation.demo_sql;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface DBTable{
+	public String name() default "";
+}

src/main/java/org/pp/annotation/annotation.txt

@@ -0,0 +1,15 @@
+package org.pp.annotation.demo_sql;
+
+@DBTable(name="MEMBER")
+public class Member{
+	@SQLString(30)
+	String firstName;
+	@SQLString(50)
+	String lastName;
+	@SQLInteger
+	Integer age;
+	@SQLString(value=30, constraints=@Constraints(primaryKey = true))
+	String handle;
+	static int memberCount;
+}
+

src/main/java/org/pp/annotation/demo_sql/Constraints.java

@@ -0,0 +1,14 @@
+package org.pp.annotation.demo_sql;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+
+@Target(ElementType.FIELD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface SQLInteger{
+	String name() default "";
+	Constraints constraints() default @Constraints; 
+}

src/main/java/org/pp/annotation/demo_sql/DBTable.java

@@ -0,0 +1,15 @@
+package org.pp.annotation.demo_sql;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+
+@Target(ElementType.FIELD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface SQLString{
+	int value() default 0;
+	String name() default "";
+	Constraints constraints() default @Constraints;
+}