输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
  • 更多
高级筛选
API version全部版本

您当前正在浏览HarmonyOS开发者3.0版本配套的开发者文档，对应API能力级别为API 8 Release。此版本文档已归档不再维护，推荐您使用HarmonyOS NEXT版本。

API参考Java API参考java.langAnnotationSafeVarargs

SafeVarargs

更新时间: 2024-01-12 08:55
收起
自动换行
深色代码主题
复制
  1. @Documented
  2. @Retention(RUNTIME)
  3. @Target({CONSTRUCTOR,METHOD})
  4. public @interface SafeVarargs
A programmer assertion that the body of the annotated method or constructor does not perform potentially unsafe operations on its varargs parameter. Applying this annotation to a method or constructor suppresses unchecked warnings about a non-reifiable variable arity (vararg) type and suppresses unchecked warnings about parameterized array creation at call sites.

In addition to the usage restrictions imposed by its Target meta-annotation, compilers are required to implement additional usage restrictions on this annotation type; it is a compile-time error if a method or constructor declaration is annotated with a @SafeVarargs annotation, and either:

  • the declaration is a fixed arity method or constructor
  • the declaration is a variable arity method that is neither static nor final.

Compilers are encouraged to issue warnings when this annotation type is applied to a method or constructor declaration where:

  • The variable arity parameter has a reifiable element type, which includes primitive types, Object, and String. (The unchecked warnings this annotation type suppresses already do not occur for a reifiable element type.)
  • The body of the method or constructor declaration performs potentially unsafe operations, such as an assignment to an element of the variable arity parameter's array that generates an unchecked warning. Some unsafe operations do not trigger an unchecked warning. For example, the aliasing in

    收起
    自动换行
    深色代码主题
    复制
    1.  @SafeVarargs // Not actually safe!
    2.  static void m(List<String>... stringLists) {
    3.    Object[] array = stringLists;
    4.    List<Integer> tmpList = Arrays.asList(42);
    5.    array[0] = tmpList; // Semantically invalid, but compiles without warnings
    6.    String s = stringLists[0].get(0); // Oh no, ClassCastException at runtime!
    7.  }
    8.

    leads to a ClassCastException at runtime.

    Future versions of the platform may mandate compiler errors for such unsafe operations.

Since:

1.7
Override
SuppressWarnings
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
搜索
请输入您想要搜索的关键词