learning_record_doc/java/内置API/Annotation.md

注解

@SafeVarargs

在声明具有模糊类型（比如：泛型）的可变参数的构造函数或方法时，Java 编译器会报 unchecked 警告。鉴于这些情况，如果程序员断定声明的构造函数和方法的主体不会对其 varargs 参数执行潜在的不安全的操作，可使用 @SafeVarargs 进行标记，这样的话，Java 编译器就不会报 unchecked 警告。

先看看 @SafeVarargs 在 Java SE 中的声明：

package java.lang;

import java.lang.annotation.*;

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.CONSTRUCTOR, ElementType.METHOD})
public @interface SafeVarargs {}

由 Java 源代码声明我们了解到：@SafeVarargs 注解，只能用于标记构造函数和方法，由于保留策略声明为 RUNTIME，所以此注解可以在运行时生效。

使用的时候要注意：@SafeVarargs 注解，对于非 static 或非 final 声明的方法，不适用，会编译不通过。

@SafeVarargs 使用示例如下：

package org.springmorning.demo.javabase.annotation.pre;

/**
 * @author 春晨
 * @date 2019/1/19 9:26
 * Copyright ©2019 春晨 https://www.cnblogs.com/springmorning/p/10285780.html
 */
public class SafeVarargsAnnotation<S>{

    private S[] args;

    //构造函数可以使用@SafeVarargs标记
    @SafeVarargs
    public SafeVarargsAnnotation(S... args){
        this.args = args;
    }

    //此处不能使用@SafeVarargs，因为此方法未声明为static或final方法，如果要抑制unchecked警告，可以使用@SuppressWarnings注解
    @SuppressWarnings("unchecked")
    //@SafeVarargs
    public void loopPrintArgs(S... args){
        for (S arg : args) {
            System.out.println(arg);
        }
    }

    //final方法可以使用@SafeVarargs标记
    @SafeVarargs
    public final void printSelfArgs(S... args){
        for (S arg : this.args) {
            System.out.println(arg);
        }
    }

    public static void main(String[] args) {
        SafeVarargsAnnotation.loopPrintInfo("A", "B", "C");
    }

    //static方法可以使用@SafeVarargs标记
    @SafeVarargs
    public static <T> void loopPrintInfo(T ... infos){
        for (T info : infos) {
            System.out.println(info);
        }
    }

}

如果以上把 @SafeVarargs 标记注释掉，在编译时就会报 unchecked 警告：

加上 @SafeVarargs 注解，警告被抑制：

本文由 简悦 SimpRead 转码， 原文地址 www.cnblogs.com