day14
二、文档注解，文档注释
文档注解的声明，也有JDK核心类库声明过了
使用：程序员使用
读取：javadoc.exe来读取
使用javadoc时，可以加参数 -encoding UTF-8
@author：表示作者
@version：表示版本
@since：起始版本
@see：另请参考
@param：形参
@return：返回值
@throws：抛出的异常列表
@param、@return、@throws只能在方法上使用
@param 形参名 形参的数据类型 形参的解释
@return 返回值类型 说明
@throws 异常类型 说明
三、单元测试
声明和定义：JUnit框架中定义的
使用：程序员
读取：由java + JUnit框架读取
如何运行？
如果没有选择，那么当前源文件中的所有的单元测试都会运行
如果选中某个方法，只运行某一个
@Test：
加在需要单独测试的方法。
并且有要求：方法所在的类必须是public
方法本身必须是public，而且是无参无返回值的，非静态的
@Before
加在需要在单元测试方法前面运行的方法上
并且有要求：方法所在的类必须是public
方法本身必须是public，而且是无参无返回值的，非静态的
执行的特点：每一个@Test方法前面都会执行
@BeforeClass
加在需要在类初始化时执行的方法上
并且有要求：方法所在的类必须是public
方法本身必须是public，而且是无参无返回值的，静态的
@AfterClass
加在需要在类所有的测试方法之后执行的方法上
并且有要求：方法所在的类必须是public
方法本身必须是public，而且是无参无返回值的，静态的
四、自定义注解
1、语法格式：
【修饰符】 @interface 注解名{
}
2、加元注解说明一下
元注解：注解注解的注解，给注解加的注解。它们在java.lang.annotation包下
（1）@Target
@Target(ElementType.xx)
@Target({ElementType.xx,ElementType.xx,...})
ElementType是一个枚举类型，有很多常量对象：例如：TYPE,METHOD,FIELD,CONSTRUCTOR....
@Target作用：限制自定义的注解的使用的目标位置
（2）@Retention
@Retention(RetentionPolicy.SOURCE)：源代码阶段 该注解只能被编译器读取
@Retention(RetentionPolicy.CLASS)：字节码阶段 该注解只能被编译器和类加载器读取
@Retention(RetentionPolicy.RUNTIME)：运行时阶段 该注解可以在运行时仍然被读取
SOURCE < CLASS < RUNTIME
@Retention的作用：限制自定义注解的寿命，可以“滞留”到什么阶段
RetentionPolicy也是枚举类型，常量对象只有三个：SOURCE,CLASS,RUNTIME
（3）@Documented
标记某个注解是否可以被javadoc读取到API中。
（4）@Inherited
标记某个注解是否可以被子类继承
自定义注解2
1、语法格式：
@元注解
【修饰符】 @interface 注解名{
}
@元注解
【修饰符】 @interface 注解名{
配置参数
}
没有配置参数的注解：
（1）@Override
（2）@Deprecated
（3）@Documented
（4）@Inherited
（5）@Test
有配置参数的
（1）@SuppressWarnings(xx)
（2）@Target(xx)
（3）@Retention(xx)
（4）@WebServlet(xx)
1、配置参数的声明
(1)声明格式：
数据类型 参数名();
(2)配置参数在声明时，可以有默认值
数据类型 参数名() default 默认值;
(3)数据类型
注解的配置参数的数据类型的要求：8种基本数据类型，4种引用数据类型（String，Class，枚举，注解
可以是它们的数组类型，例如：int[],String[]，枚举类型[]等
2、如果有配置参数，在使用时
(1) @注解名(参数名1 = 参数值1,参数名2 = 参数值2，。。。。)
(2)如果这个注解只有一个配置参数，并且它的名字叫做value，那么可以省略value=
换句话说，声明配置参数时，参数名首先考虑value
3、读取配置参数值时， 变量 = 注解对象.参数名()
回忆:default
(1)switch
(2)接口
(3)注解配置参数的默认值
数据类型：
（1）数据类型有哪些:
（2）变量的数据类型: 都可以
（3）属性的数据类型什么要求: 都可以
（4）形参的数据类型什么要求: 都可以
（5）返回值类型的类型有什么要求: 都可以
（6）switch(表达式)中表达式的类型要求：4种基本数据类型，2种引用数据类
（7）注解的配置参数的数据类型的要求：8种基本数据类型，4种引用数据类型（String，Class，枚举，注解）
可以是它们的数组类型，例如：int[],String[]，枚举类型[]等
导包：
(1)import 包.类名;
(2)import 包.*;
(3)import static 包.类名.静态成员;
(4)import static 包.类名.*;
(3)(4)就是静态导入，JDK1.5之后引入
JDK1.5增加的：
（1）foreach
（2）枚举
（3）注解
（4）可变参数
（5）静态导入 ....
JDK1.8增加的：
接口的默认方法和静态方法……
异常：程序大多数情况下是可以正常，正确的运行，但是有的时候因为一些不可控的因素，导致程序运行异常，中断。
例如：复制文件时，因为目标盘空间不足
聊天功能时，因为网络中断
计算两个数的商，用户输入的除数为0 .....
Java中是如何处理异常？
当某句代码发生异常时，程序会在这句代码处“停”下来，然后JVM（大多数是JVM，有的时候也可能是程序中自己new）
会创建一个“合适类型的异常的对象”，并且“抛”出来，JVM会在该句代码的“外围”搜索是否有"try..catch"可以
“捕获”这个异常，如果可以“捕获”那么程序从"try..catch"下面继续运行，如果没有找对应的"try..catch"
或者先有的"try..catch"无法“捕获”，那么程序会把这个异常对象“抛”给“上级”，如果上级可以“捕获”，那么就从
“上级”的"try..catch"下面继续运行，否则接着往上抛，一直到main，如果main也“捕获”不了，就挂了。
异常的类型：
java.lang.Throwable：Throwable 类是 Java 语言中所有错误或异常的超类。
（1）只有当对象是此类（或其子类之一）的实例时，才能通过 Java 虚拟机或者 Java throw 语句抛出。
（2）只有此类或其子类之一才可以是 catch 子句中的参数类型。
“抛”：JVM抛，throw抛
“抓，捕获”：catch
两个子类的实例，Error 和 Exception，通常用于指示发生了异常情况。
通常，这些实例是在异常情况的上下文中新近创建的，因此包含了相关的信息（比如堆栈跟踪数据）。
分为：
Error：错误，严重的异常，用于指示合理的应用程序不应该试图捕获(catch)的严重问题。
例如：VirtualMachineError的两个子类： OutOfMemoryError, StackOverflowError
Exception：异常
非受检异常/运行时异常：RuntimeException及其它的子类
受检异常/编译时异常：除了运行时异常，剩下的都是编译时异常
编译器在检查程序时，遇到你throw或throws出RuntimeException，编译器不会强制要求你编写try..catch或继续throws处理；
编译器在检查程序时，遇到你throw或throws出非运行时异常，那么编译器会强制要求你编写try...catch或继续throws否则编译不通过。
try...catch
1、语法格式：
try{
可能发生异常的语句块;
}catch(异常类型1 异常名){
处理该异常的代码;
}catch(异常类型2 异常名){
处理该异常的代码;
}catch(异常类型3 异常名){
处理该异常的代码;
}
....
try..catch的执行过程：
（1）如果try中的代码没有异常，那么try中的代码执行完，正常执行try..catch下面的代码
（2）如果try中的代码发生异常，首先，try中发生异常那句代码 后面的代码是无法执行，其次，在try中抛出一个
异常对象，catch会按从上到下，依次尝试“捕获”，如果有一个“捕获”了，下面的catch就不看。
所有要求子异常类型写上面，父异常类型写下面。
（3）如果try中的代码发生异常，并且所有的catch都没有“捕获”，那么try..catch下面的代码就无法执行了，
会把异常对象抛出“上级——调用者”，如果已经是最上级（main），就挂了。
这个特点有的像：if...else if....
提示：把字符串类型的数字转成int的值Integer.parseInt(字符串)
try...catch...finally
语法格式：
try{
可能发生异常的语句块;
}catch(异常类型1 异常名){
处理该异常的代码;
}catch(异常类型2 异常名){
处理该异常的代码;
}catch(异常类型3 异常名){
处理该异常的代码;
}
....
finally{
无论try中是否发生异常，也不管catch是否能够捕获异常，finally中一定要执行。
}
finally块中一般编写：释放资源，断开连接等代码。
面试题：final,finally,finalize的区别？
final是修饰符，修饰类，表示不能被继承，修饰方法，表示不能被重写，修饰变量，表示值不能被修改。
finally：无论try中是否发生异常，也不管catch是否能够捕获异常，finally中一定要执行
finalize：是一个方法名，在Object类中，表示当对象被“垃圾回收器”回收之前调用，只调用一次。
形式：
try..catch
try..finally
try..catch...finally
throws：
1、用于在声明方法时，显式的声明当前方法中没有处理的异常，要调用者来处理。
调用者在使用有throws的方法时，用try...catch就知道该catch什么更具体异常，否则就按Exception
2、语法格式：
【修饰符】 返回值类型 方法名(【形参列表】)throws 异常列表{
}
异常列表可以写好几个，用,分割
3、关于方法重写
（1）方法名和形参列表必须相同
（2）返回值类型
基本数据类型和void：必须一致
引用数据类型：<= 子类重写方法的返回值类型<=父类被重写方法的返回值类型
（3）权限修饰符：>= 子类重写方法的权限修饰符的可见性范围 >= 父类被重写方法的权限修饰符的可见性范围
（4）其他修饰符： 哪些不能重写 static,final,private
（5）抛出的异常列表的类型：<= 子类重写方法抛出的异常类型 <= 父类被重写方法抛出的异常类型
大多数异常对象是JVM根据情况抛出。有的时候需要手动抛出异常，
throw：用于手动抛出异常对象
语法结构：
throw 异常对象;
可以代替return语句，即带回异常信息，而且可以结束方法的执行
自定义异常：
(1)要继承Throwable或它子类
一般都继承Exception（编译时异常）,或者RuntimeException（运行时异常）
(2) 异常名要见名知意
(3)尽量保留父类的两个构造器：一个是无参构造，一个是为message赋值的构造器
(4)自定义异常必须手动用throw来抛出，JVM无法给你自动抛出
一个异常：
（1）类型要见名知意
例如：ArrayIndexOutOfBoundsException
ClassCastException
FileNotFoundException
（2）自己的message消息
异常对象名.getMessage()可以获取
（3）堆栈跟踪信息
异常对象经历的抛出路线，从哪个方法到哪个方法
异常对象名.printStackTrace(); //Trace痕迹
System.err：异常信息，默认是红色的
System.out：普通信息
System.err和System.out是两个线程，谁先抢到谁先打印
