java的注解与断言

什么是注解：

注释：使用文字描述程序，给程序员看的。

注解：使用代码解释程序，给计算机看的。

注解(Annotation)，也叫元数据，一种代码级别的说明，是JDK1.5及以后的版本引入的一个特性，与类、接口是在同一层次。它声明在包、类、字段、方法、局部变量、方法参数等前面，用来对这些元素进行说明。

注解的作用：

• 编译检查：通过代码里的标识的注解让编译器能够实现基本的编译检查（@Override）
• 编写文档：通过代码里的标识的注解生成文档（doc文档）

  /**
   * MathJunit2是一个工具类，提供加减法操作
   * @author xrc 
   * @version 1.0
   * @since 0.8
   * */
  public class MathJunit2 {
      //加法
      public static int add(int a ,int b){
          return a+b;
      }
  
      /**
       * 这是减法的操作
       * @param a 一个int类型的参数
       * @param b 一个int类型的参数
       * @return 返回两个int类型参数之和
       * */
      //减法
      public static int dvd(int a ,int b){
          return a-b;
      }
  }
  

 生成文档命令：javadoc MathJunit2.java（文件名）

黑窗口解决乱码问题：javadoc -encoding UTF-8 -version -author MathJunit2.java

 打开index.html。

• 代码分析：通过代码里的标识注解对代码进行分析，比如：junit单元测试，servlet3.0注解开发。

断言：

/测试自定义的工具类
//单元测试：可以帮忙测试摸一个方法，@Test，爆红，alt+回车
public class demo1 {
    //每个方法都能独立运行@Test
    @Test
    public void test01(){
        int add = MathJunit.add(2, 3);
        //使用断言，第一个参数：预期值，第二个参数：实际值，第三个参数：断言未通过显示的
        Assertions.assertEquals(5,add,"断言失败");//还可以传入第三个参数，断言失败的时候显示

    }

    @Test
    public void test02(){
        int dvd = MathJunit.dvd(2, 5);
        System.out.println("dvd = " + dvd);
    }

}

Assertions.assertEquals(5,add,"断言失败");

可以传三个参数，第一个参数：预期值，第二个参数：实际值，第三个参数：断言失败显示的

方法

方法	说明
assertEquals	判断两个对象或两个原始类型是否相等
assertNotEquals	判断两个对象或两个原始类型是否相等
assertSame	判断两个对象引用是否指向同一个对象
assertNotSame	判断两个对象引用是否指向不同的对象
assertTrue	判断给定的布尔值是否为true
assertFalse	判断给定的布尔值是否为false
assertNull	判断给定的对象引用是否为null
assertNotNull	判断给定的对象引用是否不为null