0

0

如何在Java中自定义注解@Target作用范围与注解属性解析

P粉602998670

P粉602998670

发布时间:2026-03-10 05:01:16

|

121人浏览过

|

来源于php中文网

原创

@target写错会导致编译失败,因java编译器严格校验注解使用位置,如误写为@target(elementtype.type)缺大括号、或用在非法位置均报错。

如何在java中自定义注解@target作用范围与注解属性解析

注解的 @Target 写错会导致编译失败

Java 编译器会严格校验注解是否用在了允许的位置上。比如你定义了一个只允许用在方法上的注解,却把它加在类上,javac 直接报错:Annotation is not applicable to this kind of declaration

常见错误是把 @Target({ElementType.TYPE}) 误写成 @Target(ElementType.TYPE)(少了一层大括号),这会导致编译不通过——因为 @Target 要求的是 ElementType[] 数组,不是单个枚举值。

  • 必须用花括号包住一个或多个 ElementType 常量,如 @Target({ElementType.METHOD, ElementType.FIELD})
  • 如果只想限制单一位置,仍要写成数组形式:@Target({ElementType.CONSTRUCTOR}),不能省略 {}
  • ElementType.TYPE_PARAMETERElementType.TYPE_USE 是 Java 8 新增的,旧版本 JDK 下编译会失败

注解属性声明不加 default 值就只能显式赋值

自定义注解里每个方法声明都对应一个属性,但和普通接口不同:这些方法不能有参数、不能有 throws、返回类型只能是基本类型/字符串/Class/枚举/注解类型/以上类型的数组。

如果不写 default,使用时就必须显式提供该属性值,否则编译报错:Attribute value must be constant 或更常见的 Missing default value

立即学习Java免费学习笔记(深入)”;

Removal.AI
Removal.AI

AI移出图片背景工具

下载
  • 推荐为所有非必需属性加上 default ""default {}(空数组)、default -1 等合理兜底值
  • 数组类型的默认值必须写成 default {},不能写 default [] 或留空
  • 如果属性类型是另一个注解,default 只能设为 default @MyOtherAnnotation(),不能为 null

运行时读取注解要用 RetentionPolicy.RUNTIME

注解默认保留策略是 SOURCE,意味着它只在源码阶段存在,编译后就丢了。想在运行时通过反射拿到它,必须显式声明 @Retention(RetentionPolicy.RUNTIME)

没加这个,哪怕 @Target 和属性都写对了,clazz.getAnnotation(MyAnno.class) 永远返回 null,而且没有任何警告。

  • @Retention(RetentionPolicy.CLASS) 会被写入 class 文件,但 JVM 不加载;只有 RUNTIME 才能被反射读取
  • Maven 编译时若用了 compiler-pluginsource/target 设为 7 或更低,RUNTIME 依然有效,但要注意某些 Android 环境会 strip 注解
  • Spring 等框架依赖的就是 RUNTIME 级注解;如果只做编译期检查(如 Lombok),SOURCE 更轻量

反射获取注解属性时注意泛型擦除和数组边界

annotation.value() 这类调用读属性时,看似简单,但容易在两种情况出问题:一是属性是泛型集合(实际不可行,注解不支持泛型),二是属性是数组且长度为 0。

最常踩的坑是:以为 @MyAnno(names = {"a", "b"})names 属性可以直接当 List<string></string> 用,其实它就是 String[],需要手动转。

  • 注解属性不支持泛型,Class>[] 是合法的,但 List<string></string> 会编译失败
  • 空数组属性(如 default {})返回的是长度为 0 的数组,不是 null,判空要用 array.length == 0
  • 如果属性类型是 Class,反射拿到的是运行时类对象,比如 value() 返回 String.class,不是字符串 "java.lang.String"

注解本身不执行逻辑,它的威力完全取决于你怎么解析它。写得再规范,如果解析代码没处理好数组、没检查 isAnnotationPresent、或者忘了 @Retention,就等于白定义。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

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

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

154

2025.08.06

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

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

88

2026.01.26

Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

0

2025.09.15

string转int
string转int

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

990

2023.08.02

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

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

253

2023.09.22

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

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

1089

2024.03.01

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

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

1564

2023.10.24

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

739

2023.08.03

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

59

2026.03.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.2万人学习

C# 教程
C# 教程

共94课时 | 11万人学习

Java 教程
Java 教程

共578课时 | 79.3万人学习

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

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