java.lang

Annotation Type SafeVarargs

@Documented
 @Retention(value=RUNTIME)
 @Target(value={CONSTRUCTOR,METHOD})
public @interface SafeVarargs

一个程序员断言体标注的方法或构造函数没有对其参数进行交互可能不安全的操作。应用这种标注方法或构造函数抑制个空不可具体化的变arity制止警告（vararg）型和抑制在调用点制止警告参数数组的创建。

除了使用限制的@Target元注释强加的，编译器都需要实现这个注释类型的附加使用限制；它是一个编译时错误，如果一个方法或构造函数的声明是一个@SafeVarargs注释注释，要么：

• 宣言是一个固定数量的方法或构造函数
• 宣言是一个可变数量的方法，既不static也final。

当该注释类型被应用到一个方法或构造函数声明中时，鼓励编译器发出警告：

• 可变数量的参数有一个泛型具体化的元素类型，包括原始类型，Object，和String。（unchecked警告该注释类型的抑制已经不发生一个泛型具体化元素类型。）
• 的方法或构造函数的声明具有潜在的不安全操作的机构，例如赋值的变量数量的参数的数组元素，产生一个unchecked警告。一些不安全的操作不会触发未检查的警告。例如，在

   @SafeVarargs // Not actually safe!
   static void m(List<String>... stringLists) {
     Object[] array = stringLists;
     List<Integer> tmpList = Arrays.asList(42);
     array[0] = tmpList; // Semantically invalid, but compiles without warnings
     String s = stringLists[0].get(0); // Oh no, ClassCastException at runtime!
   }
   

  走样导致运行时ClassCastException。

  该平台的未来版本可能会强制编译器错误，这样不安全的操作。

从以下版本开始：

一点七

See The Java™ Language Specification:

4.7泛型具体化类型，进行正式的参数，9.6.3.7 @ SafeVarargs