讲师中心 微信公众号
AI工具推荐 视频效率加速

Target注解限制注解应用范围的具体取值与含义

落敏大大_4004

落敏大大_4004

发布时间:2026-03-18 08:18:01

|

864人浏览过

|

来源于php中文网

原创

@Target的取值包括TYPE、METHOD、FIELD、PARAMETER、CONSTRUCTOR、LOCAL_VARIABLE、ANNOTATION_TYPE、PACKAGE、TYPE_PARAMETER、TYPE_USE;分别用于类/接口/枚举、方法、字段、形参、构造器、局部变量、注解声明、包声明、泛型类型参数、所有类型使用处。

target注解限制注解应用范围的具体取值与含义

@Target 的取值有哪些?分别能用在哪儿?

@Target 通过 ElementType 枚举限定注解可标注的语法位置。Java 编译器会严格校验,写错或用错位置直接报错,不给运行机会。

常用取值及对应适用场景:

  • TYPE:类、接口、枚举、注解类型本身(比如定义一个只能加在类上的 @Service)
  • METHOD:方法声明(如 @LogExecutionTime 只允许标在方法上)
  • FIELD:字段(含 public/private/protected 成员变量、枚举常量)
  • PARAMETER:方法或构造器的形参(常用于参数校验,如 @NotNull String name)
  • CONSTRUCTOR:构造方法(如限制某注解只能修饰构造器)
  • LOCAL_VARIABLE:局部变量(如 for 循环变量、catch 中的异常参数)
  • ANNOTATION_TYPE:仅用于其他注解的声明(即“注解的注解”,属于元注解)
  • PACKAGE:仅用于 package-info.java 中的包声明(如 @PackagePrivate)
  • TYPE_PARAMETER:泛型类型参数(如 class Box<@NonNull T>)—— Java 8+ 支持
  • TYPE_USE:所有“使用类型”的地方,包括泛型实参(List<@NonNull String>)、new 表达式(new @Immutable ArrayList<>())、类型转换((@NonNull String) obj)、throws 子句等——Java 8+ 新增,常需与 TYPE 等配合使用

写法要注意什么?常见错误有哪些?

语法上必须传 ElementType 数组,哪怕只写一个值,也得用大括号包住:

  • ✅ 正确:@Target({ElementType.METHOD}) 或 @Target({ElementType.METHOD, ElementType.FIELD})
  • ❌ 错误:@Target(ElementType.METHOD)(少一层大括号,编译失败)
  • ❌ 错误:@Target({ElementType.TYPE_USE}) 却试图把注解加在类上(TYPE_USE 不覆盖 TYPE,需显式加上)

比如想让注解既能标在方法上,也能用于泛型类型实参,就得写:
@Target({ElementType.METHOD, ElementType.TYPE_USE})

@Target 和 @Retention 是什么关系?

两者职责分明、互不替代:

  • @Target 管“能不能写”——编译期语法检查,写错位置立刻报错
  • @Retention 管“还在不在”——决定注解保留在源码(SOURCE)、字节码(CLASS)还是运行时(RUNTIME)

例如:
@Retention(RetentionPolicy.SOURCE) @Target(ElementType.ANNOTATION_TYPE)
表示:这个注解只能用来标注别的注解,且编译完就丢弃,反射永远读不到。

反过来,如果注解需要运行时反射处理(如 Spring AOP),却忘了写 @Retention(RUNTIME),
clazz.getAnnotation(MyAnno.class) 永远返回 null,而且没有任何提示。

怎么选才合适?实用建议

根据注解用途决定组合方式:

  • 做编译期检查(如 Lombok、APT 工具):@Retention(SOURCE) + 精准 @Target(如 PARAMETER 或 TYPE_PARAMETER)
  • 做运行时增强(如 Spring 的 @Transactional、自定义拦截):@Retention(RUNTIME) + 明确作用域(如 METHOD 或 TYPE)
  • 涉及泛型/类型转换等精细控制:必须包含 TYPE_USE,必要时叠加 TYPE、METHOD 等
  • 定义元注解(比如自己写个 @MyTarget):@Target(ANNOTATION_TYPE) 是标配

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2191

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

417

2026.01.26

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

5279

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

529

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1658

2024.03.01

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

5804

2023.10.24

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

3048

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

4309

2025.10.17

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

120

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn