【大数据】学习笔记 1 Java SE 第7章面向对象基础(下) 7.4 注解

Bertha 。 2024-03-22 11:25 12阅读 0赞

### 【大数据】学习笔记 ###

#### 文章目录 ####

*   *  【大数据】学习笔记
     *   *  1 Java SE
         *   *  第7章 面向对象基础(下)
             *   *  7.4 注解
                 *   *  7.4.1 什么是注解
                     *  7.4.2 三个最基本的注解
                     *  7.4.3 JUnit
                     *  7.4.4 自定义注解

![在这里插入图片描述][6d93ea1f9c8541ac88938f203c4016bb.png_pic_center]

#### 1 Java SE ####

##### 第7章 面向对象基础(下) #####

###### 7.4 注解 ######

###### 7.4.1 什么是注解 ######

注解是以“**@注释名**”在代码中存在的，还可以添加一些参数值，例如：

@SuppressWarnings(value=”unchecked”)
    @Override
    @Deprecated

注解Annotation是从JDK5.0开始引入。

虽然说注解也是一种注释，因为它们都不会改变程序原有的逻辑，只是对程序增加了某些注释性信息。不过它又不同于单行注释和多行注释，对于单行注释和多行注释是给程序员看的，而注解是可以被编译器或其他程序读取的一种注释，程序还可以根据注解的不同，做出相应的处理。所以注解是插入到代码中以便有工具可以对它们进行处理的标签。

###### 7.4.2 三个最基本的注解 ######

【1】@Override

用于检测被修饰的方法为有效的重写方法，如果不是，则报编译错误!

只能标记在方法上。

它会被编译器程序读取。

【2】@Deprecated

用于表示被标记的数据已经过时，不建议使用。

可以用于修饰 属性、方法、构造、类、包、局部变量、参数。

它会被编译器程序读取。

【3】@SuppressWarnings

抑制编译警告。

可以用于修饰类、属性、方法、构造、局部变量、参数

它会被编译器程序读取。

示例代码：

package com.dingjiaxiong.annotation;
    
    import java.util.ArrayList;
    
    /**
     * @Projectname: BigDataStudy
     * @Classname: TestAnnotation
     * @Author: Ding Jiaxiong
     * @Date:2023/4/27 13:38
     */
    
    public class TestAnnotation {
        
        @SuppressWarnings("all")
        public static void main(String[] args) {
        
            int i;
    
            ArrayList list = new ArrayList();
            list.add("hello");
            list.add(123);
            list.add("world");
    
            Father f = new Son();
            f.show();
            f.methodOl();
        }
    }
    
    class Father {
        
        @Deprecated
        void show() {
        
            System.out.println("Father.show");
        }
    
        void methodOl() {
        
            System.out.println("Father Method");
        }
    }
    
    class Son extends Father {
        
    /*	@Override
        void method01() {
            System.out.println("Son Method");
        }*/
    }

![在这里插入图片描述][554a6c01235845d59f56cd3f0144c318.png_pic_center]

###### 7.4.3 JUnit ######

JUnit是由 Erich Gamma 和 Kent Beck 编写的一个回归测试框架（regression testing framework）,供Java开发人员编写单元测试之用。多数Java的开发环境都已经集成了JUnit作为单元测试的工具。JUnit测试是程序员测试，即所谓白盒测试，因为程序员知道被测试的软件如何（How）完成功能和完成什么样（What）的功能。

要使用JUnit，必须在项目的编译路径中必须引入JUnit的库，即相关的.class文件组成的jar包。如何把JUnit的jar添加到编译路径如图所示：

后面会学习maven，在maven仓库中统一管理所有第三方框架和工具组件的jar，但是现在没有学习maven之前，可以使用本地jar包。

【1】引入本地JUnitjar

第一步：在当前IDEA项目目录下建立junitlibs，把下载的JUnit的相关jar包放进去：

Junit 官网：[https://junit.org/junit5/][https_junit.org_junit5]

![在这里插入图片描述][988975b4cac1468ca6a3a841cae67c10.png_pic_center]

仓库[https://github.com/junit-team/junit5/releases/tag/r5.9.3][https_github.com_junit-team_junit5_releases_tag_r5.9.3]

![在这里插入图片描述][568bce44a8d14c859777fda4eef6994b.png_pic_center]

![在这里插入图片描述][f4976f32649d42d7ba845f096ab75f90.png_pic_center]

笔者先下载4吧

[https://junit.org/junit4/][https_junit.org_junit4]

![在这里插入图片描述][8ae15b70127c43ca8c2af99d3c5a81b8.png_pic_center]

![在这里插入图片描述][8c7eb4e387ad4d34a59d4ee8191e6352.png_pic_center]

直接下载这个jar 包

![在这里插入图片描述][919d7682c8b54b2989f01c92973858fb.png_pic_center]

![在这里插入图片描述][a176d94fd3984963b3cb91732a904eaa.png_pic_center]

[https://repo1.maven.org/maven2/junit/junit/4.13.2/][https_repo1.maven.org_maven2_junit_junit_4.13.2]

![在这里插入图片描述][f662e47b004546c98a118dcbecb59893.png_pic_center]

下载下来

![在这里插入图片描述][e035d791f42145828f7355e95be68feb.png_pic_center]

放到我们的工程中

![在这里插入图片描述][c21c435a3d114cd18751d0090ddf8391.png_pic_center]

第二步：在项目中添加Libraries库

![在这里插入图片描述][6dbe063050984dc593a4d39f36a5e29f.png_pic_center]

![在这里插入图片描述][cc0cddd36e6f4c1eb09fdaf9feda4ed7.png_pic_center]

第三步：选择要在哪些module中应用JUnit库

![在这里插入图片描述][dced05422950486b962acd9ae925253c.png_pic_center]

第四步：检查是否应用成功

![在这里插入图片描述][dcda4e30e0734624a18943b8d3bd09de.png_pic_center]

编译时生效

**注意Scope：选择Complie，否则编译时，无法使用JUnit。**

第5步：下次如果有新的模块要使用该libs库，这样操作即可

![在这里插入图片描述][9d5ace6d1afa475c878beacb76003814.png_pic_center]

![在这里插入图片描述][089f329b0404439c8730d71ff3f2eae9.png_pic_center]

![在这里插入图片描述][62f4ee49122e4996950c65548d96e34d.png_pic_center]

记得改成compile

【2】编写和运行@Test单元测试方法

JUnit4版本，要求@Test标记的方法必须满足如下要求：

*  所在的类必须是public的，非抽象的，包含唯一的无参构造的。
 *  @Test标记的方法本身必须是public，非抽象，非静态的，void无返回值，()无参数的。

package com.dingjiaxiong.junit;
    
    import org.junit.Test;
    
    /**
     * @Projectname: BigDataStudy
     * @Classname: TestJUnit
     * @Author: Ding Jiaxiong
     * @Date:2023/4/27 14:05
     */
    
    public class TestJUnit {
        
        @Test
        public void test01() {
        
            System.out.println("TestJUnit.test01");
        }
    
        @Test
        public void test02() {
        
            System.out.println("TestJUnit.test02");
        }
    
        @Test
        public void test03() {
        
            System.out.println("TestJUnit.test03");
        }
    }

![在这里插入图片描述][8891273c0f2d4def95f9c0ccc1b7277b.png_pic_center]

![在这里插入图片描述][4c3c2ce7991c4dd592fc3340af326ef9.png_pic_center]

这里直接报错，看起来是有什么东西没找到

谷歌了一下，是版本问题，在4.11版本起，junit jar包不在包含hamcrest。

[https://repo1.maven.org/maven2/org/hamcrest/hamcrest-core/1.3/][https_repo1.maven.org_maven2_org_hamcrest_hamcrest-core_1.3]

![在这里插入图片描述][a65c76ec961e45bf835394ffbc4edd3e.png_pic_center]

下载下来放到我们的工程中

![在这里插入图片描述][20310e61678d4de098c009ad1e5e3e10.png_pic_center]

再试一次

![在这里插入图片描述][76e0fb6bf9194e74b81ef198d0922333.png_pic_center]

没问题。【当然如果不想依赖这个jar，可以把junit 的版本降一降】

【3】设置执行JUnit用例时支持控制台输入

在`idea64.exe.vmoptions`配置文件中加入下面一行设置，重启idea后生效。

需要注意的是，要看你当前IDEA读取的是哪个`idea64.exe.vmoptions`配置文件文件。如果在C盘的用户目录的config下（例如：C:\\Users\\Irene\\.IntelliJIdea2019.2\\config）也有一个idea64.exe.vmoptions文件，那么将优先使用C盘用户目录下的。否则用的是IDEA安装目录的bin目录（例如：`D:\ProgramFiles\JetBrains\IntelliJ_IDEA_2019.2.3\bin`）下的idea64.exe.vmoptions文件。

-Deditable.java.test.console=true

![在这里插入图片描述][bfe57ec4dcda4b1eaa158cdb03583875.png_pic_center]

###### 7.4.4 自定义注解 ######

注解是以“**@注释名**”在代码中存在的，还可以添加一些参数值，例如：

@SuppressWarnings(value=”unchecked”)
    @Override
    @Deprecated

注解Annotation是从JDK5.0开始引入。

一个完整的注解应该包含三个部分：  
（1）声明  
（2）使用  
（3）读取

【1】元注解

JDK1.5在java.lang.annotation包定义了4个标准的meta-annotation类型，它们被用来提供对其它 annotation类型作说明。

（1）@Target：用于描述注解的使用范围

*  可以通过枚举类型ElementType的10个常量对象来指定
 *  TYPE，METHOD，CONSTRUCTOR，PACKAGE…

（2）@Retention：用于描述注解的生命周期

*  可以通过枚举类型RetentionPolicy的3个常量对象来指定
 *  SOURCE（源代码）、CLASS（字节码）、RUNTIME（运行时）
 *  唯有RUNTIME阶段才能被反射读取到。

（3）@Documented：表明这个注解应该被 javadoc工具记录。

（4）@Inherited：允许子类继承父类中的注解

示例代码：

package java.lang;
    
    import java.lang.annotation.*;
    
    @Target(ElementType.METHOD)
    @Retention(RetentionPolicy.SOURCE)
    public @interface Override {
        
    }

package java.lang;
    
    import java.lang.annotation.*;
    import static java.lang.annotation.ElementType.*;
    
    @Target({
        TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
    @Retention(RetentionPolicy.SOURCE)
    public @interface SuppressWarnings {
        
        String[] value();
    }

package java.lang;
    
    import java.lang.annotation.*;
    import static java.lang.annotation.ElementType.*;
    
    @Documented
    @Retention(RetentionPolicy.RUNTIME)
    @Target(value={
        CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
    public @interface Deprecated {
        
    }

【2】自定义注解

\[1\] 声明自定义注解

【元注解】
    【修饰符】 @interface 注解名{
        
        【成员列表】
    }

*  自定义注解可以通过四个元注解@Retention,@Target，@Inherited,@Documented，分别说明它的声明周期，使用位置，是否被继承，是否被生成到API文档中。
 *  Annotation 的成员在 Annotation 定义中以无参数有返回值的抽象方法的形式来声明，我们又称为配置参数。返回值类型只能是八种基本数据类型、String类型、Class类型、enum类型、Annotation类型、以上所有类型的数组
 *  可以使用 default 关键字为抽象方法指定默认返回值
 *  如果定义的注解含有抽象方法，那么使用时必须指定返回值，除非它有默认值。格式是“方法名 = 返回值”，如果只有一个抽象方法需要赋值，且方法名为value，可以省略“value=”，所以如果注解只有一个抽象方法成员，建议使用方法名value。

package com.dingjiaxiong.annotation;
    
    import java.lang.annotation.*;
    
    /**
     * @Projectname: BigDataStudy
     * @Classname: Table
     * @Author: Ding Jiaxiong
     * @Date:2023/4/27 14:18
     */
    
    @Inherited
    @Target(ElementType.TYPE)
    @Retention(RetentionPolicy.RUNTIME)
    public @interface Table {
        
        String value();
    }

package com.dingjiaxiong.annotation;
    
    import java.lang.annotation.*;
    
    /**
     * @Projectname: BigDataStudy
     * @Classname: Column
     * @Author: Ding Jiaxiong
     * @Date:2023/4/27 14:19
     */
    
    @Inherited
    @Target(ElementType.FIELD)
    @Retention(RetentionPolicy.RUNTIME)
    public @interface Column {
        
        String columnName();
    
        String columnType();
    }

\[2\] 使用自定义注解

package com.dingjiaxiong.annotation;
    
    /**
     * @Projectname: BigDataStudy
     * @Classname: Student
     * @Author: Ding Jiaxiong
     * @Date:2023/4/27 14:19
     */
    
    @Table("t_stu")
    public class Student {
        
        @Column(columnName = "sid", columnType = "int")
        private int id;
        @Column(columnName = "sname", columnType = "varchar(20)")
        private String name;
    
        public int getId() {
        
            return id;
        }
    
        public void setId(int id) {
        
            this.id = id;
        }
    
        public String getName() {
        
            return name;
        }
    
        public void setName(String name) {
        
            this.name = name;
        }
    
        @Override
        public String toString() {
        
            return "Student{" +
                    "id=" + id +
                    ", name='" + name + '\'' +
                    '}';
        }
    }

[6d93ea1f9c8541ac88938f203c4016bb.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/481e2eb38e004fc28c4d92d7e74de2f2.png
[554a6c01235845d59f56cd3f0144c318.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/cc52d0b298fd470c8ae76fde39405b2b.png
[https_junit.org_junit5]: https://junit.org/junit5/
[988975b4cac1468ca6a3a841cae67c10.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/abc184a791b546638a378775a8eb6456.png
[https_github.com_junit-team_junit5_releases_tag_r5.9.3]: https://github.com/junit-team/junit5/releases/tag/r5.9.3
[568bce44a8d14c859777fda4eef6994b.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/adeb5e9974c7425dbfa2e3be4913c5b8.png
[f4976f32649d42d7ba845f096ab75f90.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/0d39b53aff1f4c2682b98ae11dbbfaf1.png
[https_junit.org_junit4]: https://junit.org/junit4/
[8ae15b70127c43ca8c2af99d3c5a81b8.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/37321f05db254248b7e72c17290ab290.png
[8c7eb4e387ad4d34a59d4ee8191e6352.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/3a09262dc5b445c99d4ee217ba20768c.png
[919d7682c8b54b2989f01c92973858fb.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/241ca49c4bef4a41a7c11a0f4f327217.png
[a176d94fd3984963b3cb91732a904eaa.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/1f904cfe4ac44050b5073479ae518aad.png
[https_repo1.maven.org_maven2_junit_junit_4.13.2]: https://repo1.maven.org/maven2/junit/junit/4.13.2/
[f662e47b004546c98a118dcbecb59893.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/71b424004f2242fc9f050cb679fa1f89.png
[e035d791f42145828f7355e95be68feb.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/74c36dd65b2d4dd8ad7cd0b159b6cbdc.png
[c21c435a3d114cd18751d0090ddf8391.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/0d31a0a5716848d7a4a59a61b2a63d6a.png
[6dbe063050984dc593a4d39f36a5e29f.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/582cf75545a34d8cbfbc6218b40987d6.png
[cc0cddd36e6f4c1eb09fdaf9feda4ed7.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/a3732b26a6374e3d9327feb38d189999.png
[dced05422950486b962acd9ae925253c.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/bcebd736bf844f588b01e34ff924acd4.png
[dcda4e30e0734624a18943b8d3bd09de.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/a7979a8257f94d8f8b6a385d2947522a.png
[9d5ace6d1afa475c878beacb76003814.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/3bfdd81628ec4254902ddc3cf5e2f29f.png
[089f329b0404439c8730d71ff3f2eae9.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/fcbc0f6212744864bd6cfe8c49288d5c.png
[62f4ee49122e4996950c65548d96e34d.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/fa55f235a0ec4096b14b4fefdc1856db.png
[8891273c0f2d4def95f9c0ccc1b7277b.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/576d1a3ab5bb494fb9b63afaafa6d1d4.png
[4c3c2ce7991c4dd592fc3340af326ef9.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/df725ca261574de79584f986d5294687.png
[https_repo1.maven.org_maven2_org_hamcrest_hamcrest-core_1.3]: https://repo1.maven.org/maven2/org/hamcrest/hamcrest-core/1.3/
[a65c76ec961e45bf835394ffbc4edd3e.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/b1610317d8624715a90c5805db96e5a9.png
[20310e61678d4de098c009ad1e5e3e10.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/759f2cedb64b4bc087a8b13125a9b780.png
[76e0fb6bf9194e74b81ef198d0922333.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/e0f4a434bfe24981bfc45016e43345c5.png
[bfe57ec4dcda4b1eaa158cdb03583875.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/8e0a5b5c5fa544118a0d2f2e1d49b3b0.png