Java注解(Java高级)

最新推荐文章于 2022-09-09 15:23:17 发布

庭前云落

最新推荐文章于 2022-09-09 15:23:17 发布

阅读量59

点赞数

分类专栏： Java基础文章标签： java mysql mybatis spring 大数据

本文链接：https://blog.csdn.net/remsqks/article/details/108585785

版权

Java基础专栏收录该内容

20 篇文章 0 订阅

订阅专栏

思维导图

1、注解概述

什么是注解：什么是注解：Annotation 注解，是一种代码级别的说明。它是 JDK1.5 及以后版本引入的一个特性，与类、接口、枚举是在同一个层次
注解的作用：主要用于取代XML和properties配置文件

2、JDK提供的注解(了解)

@Override：用在方法上，表示这个方法重写了父类的方法，如toString()。如果父类没有这个方法，那么就无法编译通过。

//#2.1 JDK5.0 复写父类方法
class Parent1_2{
public void init(){
}
}
class Son1_2 extends Parent1_2{
@Override
public void init() {
}
}

//#2.2 JDK6.0 实现父接口方法
interface Parent1_3{
public void init();
}
class Son1_3 implements Parent1_3{
@Override
public void init() {
}
}

@Deprecated：表示这个方法已经过期，不建议开发者使用。(暗示在将来某个不确定的版本，就有可能会取消掉)
```
//#1 方法过期
class Parent1_1{
@Deprecated
public void init(){
    }
}
```

@SuppressWarnings：表示抑制警告，这个注解的用处是忽略警告信息。

deprecation ，忽略过时
rawtypes ，忽略类型安全
unused ，忽略不使用
unchecked ，忽略安全检查
null，忽略空
all，忽略所有

//#3 抑制警告
// serial : 实现序列号接口，但没有生产序列号
@SuppressWarnings("serial")class Parent1_4 implements java.io.Serializable{
//null：空指针
@SuppressWarnings("null")
public void init(){
     //rawtypes：类型安全，没有使用泛型
     //unused : 不使用
    @SuppressWarnings({ "rawtypes", "unused" })
    List list = new ArrayList();
    String str = null;
    str.toString();
     }
}

@SafeVarargs：当使用可变数量的参数的时候，而参数的类型又是泛型T的话，就会出现警告。

public class Hero {
    String name;

    @SafeVarargs
    public static <T> T getFirstOne(T... elements) {
        return elements.length > 0 ? elements[0] : null;
    }
}

@FunctionalInterface：用于约定函数式接口。

函数式接口概念：如果接口中只有一个抽象方法（可以包含多个默认方法或多个static方法），该接口称为函数式接口。函数式接口其存在的意义，主要是配合Lambda 表达式来使用。
```
@FunctionalInterface
public interface AD {
    public void adAttack();
}
```

3、自定义注解

定义注解使用关键字： @interface

// #1 定义注解
public @interface MyAnno1{
}

3.1、定义 - 元注解

元注解：用于修饰注解的注解。
- 元数据：为其它数据提供信息的数据

摘要

注释类型摘要
Documented	指示某一类型的注释将通过 javadoc和类似的默认工具进行文档化
Inherited	指示注释类型被自动继承
Retention	指示注释类型的注释要保留多久
Target	指示注释类型所适用的程序元素的种类
@Repeatable	指示注解在同一个位置，适用多次

枚举摘要
ElementType	程序元素类型
RetentionPolicy	注释保留策略

JDK 提供的 5种元注解：

@Target：用于确定被修饰的自定义注解使用位置

ElementType.TYPE 修饰类、接口
ElementType.CONSTRUCTOR：修饰构造
ElementType.METHOD：修饰方法
ElementType.FIELD：修饰字段
ElementType.PARAMETER：修饰参数
ElementType.LOCAL_VARIABLE：修饰局部变量
ElementType.ANNOTATION_TYPE：修饰注解
ElementType.PACKAGE：修饰包

package anno;

import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.TYPE;

import java.lang.annotation.Documented;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target({METHOD,TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface JDBCConfig {
     String ip();
     int port() default 3306;
     String database();
     String encoding();
     String loginName();
     String password();
}

@Retention：用于确定被修饰的自定义注解生命周期

RetentionPolicy.SOURCE：被修饰的注解只能在源码中存在，编译成字节码 class 没有。如：@Override
RetentionPolicy.CLASS ：被修饰的注解只能存在源码和字节码中，运行时内存中没有。
RetentionPolicy.RUNTIME ：被修饰的注解运行之后依然存在，程序可以通过反射获取这些信息。

package anno;

import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.TYPE;

import java.lang.annotation.Documented;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target({METHOD,TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface JDBCConfig {
     String ip();
     int port() default 3306;
     String database();
     String encoding();
     String loginName();
     String password();
}

@Inherited：表示该注解具有继承性(了解)

package util;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

import anno.JDBCConfig;

public class DBUtilChild extends DBUtil {

    public static Connection getConnection2() throws SQLException, NoSuchMethodException, SecurityException {
        JDBCConfig config = DBUtilChild.class.getAnnotation(JDBCConfig.class);
        String ip = config.ip();
        int port = config.port();
        String database = config.database();
        String encoding = config.encoding();
        String loginName = config.loginName();
        String password = config.password();

        String url = String.format("jdbc:mysql://%s:%d/%s?characterEncoding=%s", ip, port, database, encoding);
        return DriverManager.getConnection(url, loginName, password);
    }

    public static void main(String[] args) throws NoSuchMethodException, SecurityException, SQLException {
        Connection c = getConnection2();
        System.out.println(c);
    }
}

@Documented：使用 javadoc 生成 api 文档时，是否包含此注解 (了解)

@Repeatable：注解在同一个位置，只能出现一次。使用@Repeatable，可以在同一个地方使用多次了。

package util;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

import anno.JDBCConfig;

@JDBCConfig(ip = "127.0.0.1", database = "test", encoding = "UTF-8", loginName = "root", password = "admin")
@JDBCConfig(ip = "127.0.0.1", database = "test", encoding = "UTF-8", loginName = "root", password = "admin")
public class DBUtil {
    static {
        try {
            Class.forName("com.mysql.jdbc.Driver");
        } catch (ClassNotFoundException e) {
            e.printStackTrace();
        }
    }

    public static Connection getConnection() throws SQLException, NoSuchMethodException, SecurityException {
        JDBCConfig config = DBUtil.class.getAnnotation(JDBCConfig.class);
        System.out.println(config);

        String ip = config.ip();
        int port = config.port();
        String database = config.database();
        String encoding = config.encoding();
        String loginName = config.loginName();
        String password = config.password();

        String url = String.format("jdbc:mysql://%s:%d/%s?characterEncoding=%s", ip, port, database, encoding);
        return DriverManager.getConnection(url, loginName, password);
    }

    public static void main(String[] args) throws NoSuchMethodException, SecurityException, SQLException {
        Connection c = getConnection();
        System.out.println(c);
    }
}