0

0

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

冰川箭仙

冰川箭仙

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

|

844人浏览过

|

来源于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 是什么关系?

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

SongAI
SongAI

免费AI歌曲和音乐生成平台,支持文字生成歌曲、AI歌词创作、AI翻唱等功能

下载
  • @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工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

163

2025.08.06

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

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

89

2026.01.26

string转int
string转int

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

1091

2023.08.02

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

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

256

2023.09.22

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

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

1154

2024.03.01

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

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

1571

2023.10.24

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

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

2040

2023.10.19

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

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

682

2025.10.17

Python WebSocket实时通信与异步服务开发实践
Python WebSocket实时通信与异步服务开发实践

本专题聚焦 Python 在实时通信场景中的开发实践,系统讲解 WebSocket 协议原理、长连接管理、消息推送机制以及异步服务架构设计。内容包括客户端与服务端通信实现、连接稳定性优化、消息队列集成及高并发处理策略。通过完整案例,帮助开发者构建高效稳定的实时通信系统,适用于聊天应用、实时数据推送等场景。

7

2026.03.18

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号