Java核心知识体系2:注解机制详解

Java注解详解:从基础到高级应用 在Java中,注解通过@interface关键字定义。注解可以应用于类、方法、字段、参数等程序元素。自定义注解允许开发者定义自己的注解类型,以满足特定的需求。自定义注解通过@interface关键字定义,可以包含元素(成员变量)和默认值。Retention;Target; 阅读详情

前言

1 Java注解基础
注解是JDK1.5版本开始引入的一个特性,用于对程序代码的说明,可以对包、类、接口、字段、方法参数、局部变量等进行注解。
它主要的作用有以下四方面:

  • 生成javadoc文档,通过在代码里面标识元数据生成javadoc文档。
  • 编译期的检查,通过标识的元数据让编译器在编译期间对代码进行验证。
  • 编译时动态处理,编译时通过代码中标识的元数据动态处理,比如动态生成代码。
  • 运行时动态处理,运行时通过代码中标识的元数据动态处理,比如使用反射技术注入实例。

注解的常见分类有三种:

  • Java自带的标准注解 ,包括 @Override、@Deprecated和@SuppressWarnings,分别代表 方法重写、某个类或方法过时、以及忽略警告,用这些注解标明后编译器就会进行检查。
  • 元注解 ,元注解是用于定义注解的注解,包括@Retention、@Target、@Inherited、@Documented 等6种
    • @Retention:指定其所修饰的注解的保留策略
    • @Document:该注解是一个标记注解,用于指示一个注解将被文档化
    • @Target:用来限制注解的使用范围
    • @Inherited:该注解使父类的注解能被其子类继承
    • @Repeatable:该注解是Java8新增的注解,用于开发重复注解
    • 类型注解(Type Annotation):该注解是Java8新增的注解,可以用在任何用到类型的地方

  • 自定义注解 ,可以根据自己的需求定义注解,并可用元注解对自定义注解进行注解。

接下来我们通过这三种分类来逐一理解注解。
1.1 Java内置注解
我们先从Java内置注解开始说起,先看下下面的代码:
class Parent { public void rewriteMethod() { } } class Child extends Parent { /** * 重载父类的 rewriteMethod() 方法 */ @Override public void rewriteMethod() { } /** * 被弃用的过时方法 */ @Deprecated public void oldMethod() { } /** * 忽略告警 * * @return */ @SuppressWarnings("keep run") public List infoList() { List list = new ArrayList(); return list; } }
Java 1.5开始自带的标准注解,包括@Override、@Deprecated和@SuppressWarnings:

  • @Override :表示当前类中的方法定义将覆盖父类中的方法
  • @Deprecated :表示该代码段被弃用,但是可以使用,只是编译器会发出警告而已
  • @SuppressWarnings :表示关闭编译器的警告信息
    我们再具体看下这几个内置注解,同时通过这几个内置注解中的元注解的定义来引出元注解。

1.1.1 内置注解 - @Override
我们先来看一下这个注解类型的定义:
@Target(ElementType.METHOD) @Retention(RetentionPolicy.SOURCE) public @interface Override { }
从它的定义我们可以看到,这个注解可以被用来修饰方法,并且它只在编译时有效,在编译后的class文件中便不再存在。这个注解的作用我们大家都不陌生,那就是告诉编译器被修饰的方法是重写的父类的中的相同签名的方法,编译器会对此做出检查,
若发现父类中不存在这个方法或是存在的方法签名不同,则会报错。
1.1.2 内置注解 - @Deprecated
这个注解的定义如下:
@Documented @Retention(RetentionPolicy.RUNTIME) @Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE}) public @interface Deprecated { }
从它的定义我们可以知道,它会被文档化,能够保留到运行时,能够修饰构造方法、属性、局部变量、方法、包、参数、类型。这个注解的作用是告诉编译器被修饰的程序元素已被“废弃”,不再建议用户使用。
1.1.3 内置注解 - @SuppressWarnings
这个注解我们也比较常用到,先来看下它的定义:
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE}) @Retention(RetentionPolicy.SOURCE) public @interface SuppressWarnings { String[] value(); }
它能够修饰的程序元素包括类型、属性、方法、参数、构造器、局部变量,只能存活在源码时,取值为String[]。它的作用是告诉编译器忽略指定的警告信息,它可以取的值如下所示:

参数作用原描述
all抑制所有警告to suppress all warnings
boxing抑制装箱、拆箱操作时候的警告to suppress warnings relative to boxing/unboxing operations
cast抑制映射相关的警告to suppress warnings relative to cast operations
dep-ann抑制启用注释的警告to suppress warnings relative to deprecated annotation
deprecation抑制过期方法警告to suppress warnings relative to deprecation
fallthrough抑制确在switch中缺失breaks的警告to suppress warnings relative to missing breaks in switch statements
finally抑制finally模块没有返回的警告to suppress warnings relative to finally block that don’t return
hiding抑制与隐藏变数的区域变数相关的警告to suppress warnings relative to locals that hide variable()
incomplete-switch忽略没有完整的switch语句to suppress warnings relative to missing entries in a switch statement (enum case)
nls忽略非nls格式的字符to suppress warnings relative to non-nls string literals
null忽略对null的操作to suppress warnings relative to null analysis
rawtype使用generics时忽略没有指定相应的类型to suppress warnings relative to un-specific types when using
restriction抑制与使用不建议或禁止参照相关的警告to suppress warnings relative to usage of discouraged or
serial忽略在serializable类中没有声明serialVersionUID变量to suppress warnings relative to missing serialVersionUID field for a serializable class
static-access抑制不正确的静态访问方式警告to suppress warnings relative to incorrect static access
synthetic-access抑制子类没有按最优方法访问内部类的警告to suppress warnings relative to unoptimized access from inner classes
unchecked抑制没有进行类型检查操作的警告to suppress warnings relative to unchecked operations
unqualified-field-access抑制没有权限访问的域的警告to suppress warnings relative to field access unqualified
unused抑制没被使用过的代码的警告to suppress warnings relative to unused code

1.2 元注解
上述内置注解的定义中使用了一些元注解(注解类型进行注解的注解类),在JDK 1.5中提供了4个标准的元注解:@Target,@Retention,@Documented,@Inherited, 在JDK 1.8中提供了两个新的元注解 @Repeatable和@Native。
1.2.1 元注解 - @Target
Target注解的作用是:描述注解的使用范围(即:被修饰的注解可以用在什么地方) 。
Target注解用来说明那些被它所注解的注解类可修饰的对象范围:

  • packages、types(类、接口、枚举、注解类)
  • 类成员(方法、构造方法、成员变量、枚举值)
  • 方法参数和本地变量(如循环变量、catch参数)
    在定义注解类时使用了@Target 能够更加清晰的知道它能够被用来修饰哪些对象,它的取值范围定义在ElementType 枚举中。枚举信息如下:

public enum ElementType { TYPE, // 类、接口、枚举类 FIELD, // 成员变量(包括:枚举常量) METHOD, // 成员方法 PARAMETER, // 方法参数 CONSTRUCTOR, // 构造方法 LOCAL_VARIABLE, // 局部变量 ANNOTATION_TYPE, // 注解类 PACKAGE, // 可用于修饰:包 TYPE_PARAMETER, // 类型参数,JDK 1.8 新增 TYPE_USE // 使用类型的任何地方,JDK 1.8 新增 }
1.2.2 元注解 - @Retention & @RetentionTarget
Reteniton注解的作用是:描述注解保留的时间范围(即:被描述的注解在它所修饰的类中可以被保留到何时) 。
Reteniton注解用来限定那些被它所注解的注解类在注解到其他类上以后,可被保留到何时,一共有三种策略,定义在RetentionPolicy枚举中。枚举如下:
public enum RetentionPolicy { SOURCE, // 源文件保留 CLASS, // 编译期保留,默认为该值,CLASS RUNTIME // 运行期保留,可通过反射去获取注解信息 }
我们测试下这三种策略,在定义注解类的时候什么区别:
@Retention(RetentionPolicy.SOURCE) public @interface SourcePolicy { // 源文件保留策略 } @Retention(RetentionPolicy.CLASS) public @interface ClassPolicy { // 编译器保留策略 } @Retention(RetentionPolicy.RUNTIME) public @interface RuntimePolicy { // 运行期保留策略 }
上面已经定义好了三个注解类,我们再用这三个注解类再去注解方法,如下:
public class RetentionTest { @SourcePolicy public void sourcePolicy() { } @ClassPolicy public void classPolicy() { } @RuntimePolicy public void runtimePolicy() { } }
通过执行 javap -verbose RetentionTest命令获取到的RetentionTest 的 class 字节码内容如下。
{ public retention.RetentionTest(); flags: ACC_PUBLIC Code: stack=1, locals=1, args_size=1 0: aload_0 1: invokespecial #1 // Method java/lang/Object."<init>":()V 4: return LineNumberTable: line 3: 0 public void sourcePolicy(); flags: ACC_PUBLIC Code: stack=0, locals=1, args_size=1 0: return LineNumberTable: line 7: 0 public void classPolicy(); flags: ACC_PUBLIC Code: stack=0, locals=1, args_size=1 0: return LineNumberTable: line 11: 0 RuntimeInvisibleAnnotations: 0: #11() public void runtimePolicy(); flags: ACC_PUBLIC Code: stack=0, locals=1, args_size=1 0: return LineNumberTable: line 15: 0 RuntimeVisibleAnnotations: 0: #14() }
从 RetentionTest 的字节码内容我们可以得出以下两点结论:

  • 编译器并没有记录下 sourcePolicy() 方法的注解信息
  • 编译器使用 RuntimeInvisibleAnnotations 去记录 classPolicy()方法的注解信息
  • 编译器使用 RuntimeVisibleAnnotations 去记录 runtimePolicy()方法的注解信息

1.2.3 元注解 - @Documented
Documented注解的作用如下:使用 javadoc 工具为类生成帮助文档,并确认是否保留注解信息。
以下代码在使用Javadoc工具可以生成 @DocAnnotation注解信息。
import java.lang.annotation.Documented; import java.lang.annotation.ElementType; import java.lang.annotation.Target; @Documented @Target({ElementType.TYPE,ElementType.METHOD}) public @interface DocAnnotation { public String value() default "default"; }
@DocAnnotation("some method doc") public void testMethod() { // 测试方法的文档注解 }
1.2.4 元注解 - @Inherited
Inherited注解的作用:被它修饰的Annotation将具有继承特性。父类使用了被@Inherited修饰的Annotation,则子类将自动具备该注解。
我们来测试下这个注解:

  • 定义@Inherited注解:

@Inherited @Retention(RetentionPolicy.RUNTIME) @Target({ElementType.TYPE,ElementType.METHOD}) public @interface InheritedAnnotation { String [] values(); int number(); }

  • 使用这个注解

@InheritedAnnotation(values = {"brand"}, number = 100) public class UserInfo { } class Customer extends UserInfo { @Test public void testMethod(){ Class clazz = Student.class; Annotation[] annotations = clazz.getAnnotations(); for (Annotation annotation : annotations) { System.out.println(annotation.toString()); } } }

  • 输出

xxx.InheritedAnnotation(values=[brand], number=100)
虽然Customer类没有显示地被注解@InheritedAnnotation,但是它的父类UserInfo被注解,而且@InheritedAnnotation被@Inherited注解,因此Customer类自动继承注解
1.2.4 元注解 - @Repeatable (Java8)
Repeatable是可重复使用的意思,允许在同一声明的类型(类,属性,或方法)中,可以多次使用同一个注解
JDK8之前要想实现注解重复使用,需要组合模式,编写和可读性都不是很好
public @interface Pet { String myPet(); } public @interface Pets { Pet[] value(); } public class RepeatAnnotationOV { @Pets({@Pet(myPet="dog"),@Pet(myPet="cat")}) public void workMethod(){ } }
由另一个注解来存储重复注解,在使用时候,用存储注解Authorities来扩展重复注解。
Java 8中的做法:
@Repeatable(Pets.class) public @interface Pet { String myPet(); } public @interface Pets { Pet[] value(); } public class RepeatAnnotationNV { @Pet(role="dog") @Pet(role="cat") public void workMethod(){ } }
不同的地方是,创建重复注解Authority时,加上@Repeatable,指向存储注解Authorities,在使用时候,直接可以重复使用Authority注解。从上面例子看出,java 8里面做法更适合常规的思维,可读性强一点
1.2.5 元注解 - @Native (Java8)
使用 @Native 注解修饰成员变量,则表示这个变量可以被本地代码引用,常常被代码生成工具使用。对于 @Native 注解不常使用,了解即可
1.3 注解与反射接口
定义注解后,如何获取注解中的内容呢?反射包java.lang.reflect下的AnnotatedElement接口提供这些方法。这里注意:只有注解被定义为RUNTIME后,该注解才能是运行时可见,当class文件被装载时被保存在class文件中的Annotation才会被虚拟机读取。
AnnotatedElement 接口是所有程序元素(Class、Method和Constructor)的父接口,所以程序通过反射获取了某个类的AnnotatedElement对象之后,程序就可以调用该对象的方法来访问Annotation信息。我们看下具体的先关接口

  • boolean isAnnotationPresent(Class<?extends Annotation> annotationClass)
    判断该程序元素上是否包含指定类型的注解,存在则返回true,否则返回false。注意:此方法会忽略注解对应的注解容器。
  • T getAnnotation(Class annotationClass)
    返回该程序元素上存在的、指定类型的注解,如果该类型注解不存在,则返回null。
  • Annotation[] getAnnotations()
    返回该程序元素上存在的所有注解,若没有注解,返回长度为0的数组。
  • T[] getAnnotationsByType(Class annotationClass)
    返回该程序元素上存在的、指定类型的注解数组。没有注解对应类型的注解时,返回长度为0的数组。该方法的调用者可以随意修改返回的数组,而不会对其他调用者返回的数组产生任何影响。getAnnotationsByType方法与 getAnnotation的区别在于,getAnnotationsByType会检测注解对应的重复注解容器。若程序元素为类,当前类上找不到注解,且该注解为可继承的,则会去父类上检测对应的注解。
  • T getDeclaredAnnotation(Class annotationClass)
    返回直接存在于此元素上的所有注解。与此接口中的其他方法不同,该方法将忽略继承的注释。如果没有注释直接存在于此元素上,则返回null
  • T[] getDeclaredAnnotationsByType(Class annotationClass)
    返回直接存在于此元素上的所有注解。与此接口中的其他方法不同,该方法将忽略继承的注释
  • Annotation[] getDeclaredAnnotations()
    返回直接存在于此元素上的所有注解及注解对应的重复注解容器。与此接口中的其他方法不同,该方法将忽略继承的注解。如果没有注释直接存在于此元素上,则返回长度为零的一个数组。该方法的调用者可以随意修改返回的数组,而不会对其他调用者返回的数组产生任何影响。

1.4 自定义注解
当我们理解了内置注解, 元注解和获取注解的反射接口后,我们便可以开始自定义注解了。这个例子我把上述的知识点全部融入进来, 代码很简单:

  • 定义自己的注解

package com.helenlyn.common.annotation; import java.lang.annotation.Documented; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; /** * <p>Description: 水果供应者注解 </p> * <p>Copyright: Copyright (c) 2021 </p> * <p>Company: helenlyn Co., Ltd. </p> * * @author brand * @date 2021/5/16 16:35 * <p>Update Time: </p> * <p>Updater: </p> * <p>Update Comments: </p> */ @Target(ElementType.FIELD) @Retention(RetentionPolicy.RUNTIME) @Documented public @interface FruitProvider { /** * 供应商编号 * @return */ public int id() default -1; /** * 供应商名称 * @return */ public String name() default ""; /** * 供应商地址 * @return */ public String address() default ""; }

  • 使用注解

package com.helenlyn.common.dto; import com.helenlyn.common.annotation.FruitColor; import com.helenlyn.common.annotation.FruitName; import com.helenlyn.common.annotation.FruitProvider; /** * <p>Description: </p> * <p>Copyright: Copyright (c) 2021 </p> * <p>Company: helenlyn Co., Ltd. </p> * * @author brand * @date 2021/5/16 16:28 * <p>Update Time: </p> * <p>Updater: </p> * <p>Update Comments: </p> */ public class AppleDto { @FruitName("Apple") private String appleName; @FruitColor(fruitColor=FruitColor.Color.RED) private String appleColor; @FruitProvider(id=1,name="helenlyn 贸易公司",address="福州xx路xxx大楼") private String appleProvider; }

  • 用反射接口获取注解信息
    在 FruitInfoUtil 中进行测试:

/** * <p>Description: FruitInfoUtil注解实现 </p> * <p>Copyright: Copyright (c) 2021 </p> * <p>Company: helenlyn Co., Ltd. </p> * * @author brand * @date 2021/5/16 16:37 * <p>Update Time: </p> * <p>Updater: </p> * <p>Update Comments: </p> */ public class FruitInfoUtil { public static String getFruitInfo(Class<?> clazz) { String strFruitName = " 水果名称:"; String strFruitColor = " 水果颜色:"; String strFruitProvicer = "供应商信息:"; Field[] fields = clazz.getDeclaredFields(); for (Field field : fields) { if (field.isAnnotationPresent(FruitName.class)) { FruitName fruitName = (FruitName) field.getAnnotation(FruitName.class); strFruitName += fruitName.value(); System.out.println(strFruitName); } else if (field.isAnnotationPresent(FruitColor.class)) { FruitColor fruitColor = (FruitColor) field.getAnnotation(FruitColor.class); strFruitColor += fruitColor.fruitColor().toString(); System.out.println(strFruitColor); } else if (field.isAnnotationPresent(FruitProvider.class)) { FruitProvider fruitProvider = (FruitProvider) field.getAnnotation(FruitProvider.class); strFruitProvicer = " 供应商编号:" + fruitProvider.id() + " 供应商名称:" + fruitProvider.name() + " 供应商地址:" + fruitProvider.address(); System.out.println(strFruitProvicer); } } return String.format("%s;%s;%s;", strFruitName, strFruitColor, strFruitProvicer); } }

  • 测试的输出

2022-07-09 11:33:41.688 INFO 5895 --- [TaskExecutor-35] o.s.a.r.c.CachingConnectionFactory : Attempting to connect to: cl-debug-rabbitmq-erp-service-7w0cpa.docker.sdp:9146 Hibernate: update UserBasicInfo set personName=? where personCode=? 水果名称:Apple 水果颜色:RED 供应商编号:1 供应商名称:helenlyn 贸易公司 供应商地址:福州xx路xxx大楼
2 理解注解的原理
2.1 Java 8 提供了哪些新的注解

  • @Repeatable
  • ElementType.TYPE_USE
  • ElementType.TYPE_PARAMETER

ElementType.TYPE_USE(此类型包括类型声明和类型参数声明,是为了方便设计者进行类型检查)包含了ElementType.TYPE(类、接口(包括注解类型)和枚举的声明)和ElementType.TYPE_PARAMETER(类型参数声明), 可以看下面这个例子:
// 自定义ElementType.TYPE_PARAMETER注解 @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.TYPE_PARAMETER) public @interface MyNotEmpty { } // 自定义ElementType.TYPE_USE注解 @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.TYPE_USE) public @interface MyNotNull { } // 测试类 public class TypeParameterAndTypeUseAnnotation<@MyNotEmpty T>{ //使用TYPE_PARAMETER类型,会编译不通过 // public @MyNotEmpty T test(@MyNotEmpty T a){ // new ArrayList<@MyNotEmpty String>(); // return a; // } //使用TYPE_USE类型,编译通过 public @MyNotNull T test2(@MyNotNull T a){ new ArrayList<@MyNotNull String>(); return a; } }
2.2 注解支持继承吗?
注解是不支持继承的
不能使用关键字extends来继承某个@interface,但注解在编译后,编译器会自动继承java.lang.annotation.Annotation接口。虽然反编译后发现注解继承了Annotation接口,请记住,即使Java的接口可以实现多继承,但定义注解时依然无法使用extends关键字继承@interface。 区别于注解的继承,被注解的子类继承父类注解可以用@Inherited: 如果某个类使用了被@Inherited修饰的Annotation,则其子类将自动具有该注解。3 注解的应用场景
自定义注解多喝AOP - 通过切面实现解耦
笔者曾经在 《 基于AOP的动态数据源切换 》 这篇文章中有个典型的例子,就是使用AOP切面来对多数据源进行使用场景的切换,下面展示下如何通过注解实现解耦的。

  • 自定义Annotation,映射的目标范围为 类型和方法。

/** * @author brand * @Description: 数据源切换注解 * @Copyright: Copyright (c) 2021 * @Company: Helenlyn, Inc. All Rights Reserved. * @date 2021/12/15 7:36 下午 */ @Target({ ElementType.TYPE, ElementType.METHOD}) @Retention(RetentionPolicy.RUNTIME) @Documented public @interface DataSource { String name() default ""; }

  • 编写AOP实现,切面代码,以实现对注解的PointCut,切点拦截

/** * @author brand * @Description: * @Copyright: Copyright (c) 2021 * @Company: Helenlyn, Inc. All Rights Reserved. * @date 2021/12/15 7:49 下午 */ @Aspect @Component public class DataSourceAspect implements Ordered { /** * 定义一个切入点,匹配到上面的注解DataSource */ @Pointcut("@annotation(com.helenlyn.dataassist.annotation.DataSource)") public void dataSourcePointCut() { } /** * Around 环绕方式做切面注入 * @param point * @return * @throws Throwable */ @Around("dataSourcePointCut()") public Object around(ProceedingJoinPoint point) throws Throwable { MethodSignature signature = (MethodSignature) point.getSignature(); Method method = signature.getMethod(); DataSource ds = method.getAnnotation(DataSource.class); String routeKey = ds.name(); // 从头部中取出注解的name(basic 或 cloudoffice 或 attend),用这个name进行数据源查找。 String dataSourceRouteKey = DynamicDataSourceRouteHolder.getDataSourceRouteKey(); if (StringUtils.isNotEmpty(dataSourceRouteKey)) { // StringBuilder currentRouteKey = new StringBuilder(dataSourceRouteKey); routeKey = ds.name(); } DynamicDataSourceRouteHolder.setDataSourceRouteKey(routeKey); try { return point.proceed(); } finally { // 最后做清理,这个步骤很重要,因为我们的配置中有一个默认的数据源,执行完要回到默认的数据源。 DynamicDataSource.clearDataSource(); DynamicDataSourceRouteHolder.clearDataSourceRouteKey(); } } @Override public int getOrder() { return 1; } }

  • 测试,在Control中写三个测试方法

/** * 无注解默认情况:数据源指向basic * @return */ @RequestMapping(value = "/default/{user_code}", method = RequestMethod.GET) public UserInfoDto getUserInfo(@PathVariable("user_code") String userCode) { return userInfoService.getUserInfo(userCode); } /** * 数据源指向attend * @return */ @DataSource(name= Constant.DATA_SOURCE_ATTEND_NAME) @RequestMapping(value = "/attend/{user_code}", method = RequestMethod.GET) public UserInfoDto getUserInfoAttend(@PathVariable("user_code") String userCode) { return userInfoService.getUserInfo(userCode); } /** * 数据源指向cloud * @return */ @DataSource(name= Constant.DATA_SOURCE_CLOUD_NAME) @RequestMapping(value = "/cloud/{user_code}", method = RequestMethod.GET) public UserInfoDto getUserInfoCloud(@PathVariable("user_code") String userCode) { return userInfoService.getUserInfo(userCode); }

  • 执行效果

除此之外,我们可以看到很多日志管理、权限管理,也都是也是通过类似的注解机制来实现的,通过注解+AOP来最终实现模块之间的解耦,以及业务与系统层面的解耦 。

如何详解Java中的@Documented注解的作用和用法 通过本文,我们详细介绍了Java中的@Documented注解的作用和用法。@Documented注解允许被它修饰的注解的信息出现在生成的API文档中,这对于标记重要元数据信息的注解非常有用。我们通过一个示例代码演示了@Documented注解的实际效果,包括如何在API文档中展示自定义注解的信息。 阅读详情

相关推荐

Java 全栈知识体系( PDF 可下载)

40000 +字长文总结,民工哥已将此文整理成PDF文档了,需要的见文后下载获取方式。 全栈知识体系总览 Java入门与进阶 面向对象与Java基础 Java 基础 - 面向对象 Java 基础 - 知识点 Java 基础 - 图谱 & Q/A 基础知识点复习完了以后,我们需要深入的理解Java中的一些基础机制: Java 基础 - 泛型机制详解 Java泛型这个特性是从JDK 1.5才开始加入的,因此为了兼容之前的版本

m0_67698950的博客 6336

Java注解详解

Inherited的英文意思是继承,但是这个继承和我们平时理解的继承大同小异,一个被@Inherited注解了的注解修饰了一个父类,如果他的子类没有被其他注解修饰,则它的子类也继承了父类的注解。关于『注解』和『XML』两种不同的配置模式,争论了好多年了,各有各的优劣,注解可以提供更大的便捷性,易于维护修改,但耦合度高,而 XML 相对于注解则是相反的。以前,『XML』是各大框架的青睐者,它以松耦合的方式完成了框架中几乎所有的配置,但是随着项目越来越庞大,『XML』的内容也越来越复杂,维护成本变高。

qq_45705626的博客 2909

深入探究Java核心注解及自定义注解的奥秘

Java作为一门成熟的编程语言,其注解机制为开发者提供了极大的便利。注解不仅能够提供代码的额外信息,还能够被编译器和运行时环境所使用,从而实现更加丰富和动态的编程范式。在本文中,我们将深入探讨Java的核心注解、元注解的实现机制,以及如何自定义注解。

fudaihb的博客 939

Java注解实现原理

一、今天将从以下4个方面来系统的学习一下java注解 什么是注解 注解的用途 注解使用演示 注解的实现原理 1.什么是注解 注解也叫元数据,例如我们常见的@Override和@Deprecated,注解是JDK1.5版本开始引入的一个特性,用于对代码进行说明,可以对包、类、接口、字段、方法参数、局部变量等进行注解。 ...

hongfenglx的博客 2152

SpringBoot核心注解详解:定义、用法与原理

SpringBoot通过"约定优于配置"的理念极大地简化了Spring应用的开发,而其核心机制正是建立在各种注解之上。本文将详细介绍SpringBoot中最重要、最常用的几个注解,包括它们的定义、使用场景、具体用法以及底层实现原理。是SpringBoot最核心的注解,通常标注在主启动类上。:标识该类为配置类:启用SpringBoot的自动配置机制:启用组件扫描,自动发现和注册Bean是和的组合注解,用于标记一个类作为RESTful风格的控制器,其方法返回值默认会序列化为JSON/XML格式。

jnimiijabc的博客 1245

Java注解类型及其应用详解

本文详细解析了Java注解的核心概念与应用实践。主要内容包括: 注解类型与实例的区别:注解类型本质是特殊接口,但其实例通过动态代理机制实现,应避免直接实现注解类型。 注解实例化机制:使用注解时隐式完成代理类创建、实例化和元素值设置三个操作。 标准注解详解: @Deprecated在JDK9增强,新增since和forRemoval元素 @FunctionalInterface强制验证函数式接口规范 @Override确保方法正确覆盖父类 警告处理实践: 使用jdeprscan工具检测废弃API @Suppr

静水深流 1195

Java反射机制与注解:动态编程的核心

本文介绍了Java反射机制与注解的核心概念与应用。反射机制允许程序在运行时动态获取类信息(如构造方法、成员变量等),通过Class类的三种获取方式(getClass()、.class属性、Class.forName())实现。反射优势包括动态加载类、创建对象和调用方法,广泛应用于框架开发(如Spring)和动态代理。注解部分则涵盖定义与解析方法,为开发者提供灵活的元数据处理能力。通过代码示例演示了如何获取类结构信息,展示了反射机制在Java编程中的强大动态特性。

今天比昨天更努力一点! 1万+

Java注解规范与使用详解

Java注解使用规则摘要 注解除具有特殊限制外,还提供多种简化语法。关键规则包括: 空值限制:注解元素禁止使用null,可用空数组({})或空字符串("")代替 六大限制:注解类型禁止继承、方法参数、异常声明、特定返回类型、方法覆盖和泛型 简化语法:单元素注解可省略"value="前缀,数组可简化书写,默认值可省略赋值 元素类型:支持基本类型、String、Class、枚举、注解及数组等,各有特殊约束 这些规则保证了注解的简洁性和可靠性,开发者应合理运用简化语法,同时

静水深流 1204

Java注解四大作用详解:深度剖析核心机制

四大作用对比作用类型时机典型注解主要用途编译时检查编译期@Override代码安全、错误预防运行时处理运行期@Autowired依赖注入、AOP切面代码生成编译期@Data@Builder减少样板代码配置简化运行期@Service替代XML配置。

cjejwe的博客 1072

Java 中的注解机制:原理、使用场景与开发技巧

自定义注解时,需明确其目标元素、保留策略等元信息。在 Spring AOP 中,可以使用@Before@After@Around等注解定义切面。以下示例展示如何通过自定义注解@Loggable@Aspect@Component在上述代码中,@Before注解结合定义了一个切点,匹配所有被@Loggable注解标记的方法。当这些方法执行前,会触发logBefore方法,记录方法名和日志信息。通过自定义注解和切面,可以灵活地实现各种横切功能。例如,创建一个// 事务相关配置参数@Aspect。

shrgegrb的博客 1023

避坑指南:ShardingSphere连接达梦/金仓数据库时SQL解析器的那些‘坑‘

本文深入探讨了ShardingSphere与国产数据库(如达梦、金仓)集成时遇到的SQL解析器差异问题,提供了详细的解决方案和优化策略。通过分析SQL方言差异、JDBC实现差异及解析器兼容性,帮助开发者有效避坑,提升分布式数据库架构设计的效率与稳定性。

weixin_29309475的博客 392

Java 全栈知识体系

40000 +字长文总结。 面向对象与Java基础 Java 基础 - 面向对象Java 基础 - 知识点Java 基础 - 图谱 & Q/A基础知识点复习完了以后,我们需要深入的理解Java中的一些基础机制:Java 基础 - 泛型机制详解Java泛型这个特性是从JDK 1.5才开始加入的,因此为了兼容之前的版本,Java泛型的实现采取了“伪泛型”的策略,即Java在语法上支持泛型,但是在编译阶段会进行所谓的“类型擦除”(Type Erasure),将所有的泛型表示(尖括号中的内容)都替换为具体的

weixin_70730532的博客 8185

NLP实践——利用自己的语料进行Mask Language Model预训练

#!/usr/bin/env python # coding: utf-8 # In[1]: import os import json import copy from tqdm.notebook import tqdm import torch from torch.optim import AdamW from torch.utils.data import DataLoader, Dataset from transformers import BertForMaskedLM, BertTo

weixin_44826203的博客 1万+

SpringBoot条件注解全解析:核心作用与使用场景详解

Spring Boot的条件注解为开发者提供了强大的动态配置能力,理解其原理和适用场景是构建灵活、可扩展应用的关键。通过合理组合这些注解,可以实现“智能”的自动配置逻辑,同时避免冗余代码。实际开发中,建议结合Spring Boot的自动配置源码(如模块)深入学习。

从基础到源码解析的学习记录 5911

eVTOL热管理:从电动车到飞行器的技术跃迁与工程挑战

热管理系统是保障各类电动设备安全、高效运行的核心技术,其基本原理是通过冷却、加热和温度控制,确保电池、电机等关键部件在最佳工况下工作。在新能源汽车领域,热管理技术已相对成熟,但面对eVTOL(电动垂直起降飞行器)这一新兴领域,其设计逻辑需从二维地面转向三维空域,应对环境温度剧烈变化、重量约束极端严苛等全新挑战。eVTOL的热管理不仅是简单的技术移植,更涉及对电池瞬时高功率散热、乘员舱快速温控及多热源耦合等复杂工程问题的系统性解决,直接关系到飞行安全与商业航程。本文聚焦于**环境温度**和**有效载荷**等关

weixin_42521276的博客 615

DOTS 性能基石:为什么传统 Unity 代码难以满足现代游戏需求?(DOTS 系列教程 · 第1篇)

本文探讨了Unity游戏开发中的性能优化问题,指出性能问题不应在最后才考虑,而应贯穿整个开发过程。文章分析了性能问题的三大表现(渲染开销、物理模拟、游戏逻辑),并解释了依赖硬件升级的不可行性。重点剖析了传统Unity代码性能低下的六大根源:垃圾回收卡顿、编译器优化不足、多核利用不足、数据结构和代码缓存不友好、过度抽象等问题。最后指出Unity项目中常见的反模式,如主线程垄断、内存碎片化等,为后续学习DOTS高性能架构解决方案奠定基础。

分享知识,拥抱变化 151

@SpringBootApplication 注解详解:启动类核心机制

@SpringBootApplication 注解核心解析 @SpringBootApplication 是 Spring Boot 应用的启动核心注解,集成了三大核心功能: 自动配置:基于类路径依赖智能配置(如检测到 Web 环境自动配置 Tomcat) 组件扫描:默认扫描当前包及其子包下的组件 配置加载:支持多环境配置文件和属性绑定 主要应用场景包括: 单体应用启动(90% 以上 Spring Boot 项目) 微服务模块独立启动 测试环境特殊配置(如排除数据库自动配置) 多模块项目配置整合 典型代码实

走向CTO的路上... 1310

企业微信开发007_域名主体校验未通过,需配置备案主体与当前企业主体相同或有关联关系的域名_企业内部自建应用开发_配置可信域名_回调URL_可信IP---企业微信开发009

因为我这个企业微信是,已经注册了服务商了,所以我又注册了一个不是服务商的测试企业,没有实名认证的,去试了试。而且,网络上找的教程,都是不够详细的,还是会碰到各种各样的问题,记录下来,为后来者提供便利。首先我用natapp.cn 申请了一个免费的域名,然后去,一个,企业微信上去配置,注意。我这个域名,的主体,可能是域名服务商,比如阿里域名 等等的 不是一般的企业域名。我这个企业微信,是开通了服务商的,企业微信,右上角有服务商管理后台的。到时候,直接用,他们自己企业注册的域名,已经备案的再去尝试,

添柴程序猿的专栏 1702

Java核心API-反射机制和注解

注解必须先定义后使用定义注解的语法:// 关键字 注解名。

qq_68630091的博客 1221

第10章 shellcode实战:18 神级开源shellcode工具:donut

Donut是一款shellcode生成器,可将C/C++、C#生成的PE文件转换为shellcode文件,同时支持JS、XSL、VBS脚本转换为shellcode。以下“原生”EXE/DLL指非托管PE文件(包括并不限于C/C++、delphie等编写生成的可执行文件),可以直接由系统加载运行,区别于.Net生成的托管文件。被处理exe/dll为32位程序,则需要用32为的shellcode加载器启用,exe/dll为64位的就用64位shellcode加载器启用。

李小咖·网安技术库 2799

threejs中使用Reflector实现出倒影效果,并实现背景透明的效果(Reflector镜面背景透明, 倒影弱化)

在项目中遇到要实现倒影效果,threejs给我们提供了Reflector,可以轻松完成镜面效果,实现倒影。但背景不透明;并且反射出的倒影太亮了;网上没搜到解决方案, 自己修改了下源码实现了想要的效果,做个记录...

weixin_40856652的博客 5723

java注解机制详解

注解也被称为元数据,它是我们在代码中添加信息的一种形式化方法,使我们可以在稍后某个时刻非常方便地使用这些数据。注解是java se5中众多引入的变化之一。他们可以提供用来完整的描述程序所需的信息。而这些信息我们现在不能通过java的基本语法来表达。实际上,相比较使用java提供的注解,在使用中定义自己的新注解是更加常用的。

往事散云烟,十寸光阴换一钱 1018

visio安装包

Microsoft Office Visio 是一款专业的制图软件。利用经过更新的形状、协作工具和数据链接图表,创建专业级图表以简化复杂的信息。

Java基础(十五):注解(Annotation)详解

介绍注解作为Java元数据机制的本质与作用,可用于编译、类加载和运行时处理

从基础到源码解析的学习记录 2947

android 蓝牙通讯demo

android 下蓝牙通讯demo,实现了发现蓝牙,使能蓝牙,通过蓝牙发送消息。

廖雪峰Python教程[完整版]

廖雪峰的python教程整理的,已经排好版了,而且还是完整的,适合小白

详解 JAVA 中的 @Schema 注解

Schema注解是 Swagger(现更名为 OpenAPI)提供的一个重要注解,用于定义和描述 API 接口中的数据模型。通过@Schema注解,我们可以为类或字段添加描述信息,优化生成的 API 文档,方便开发者理解和使用接口。本篇博客从小白角度出发,详细讲解@Schema的用法,包括注解的功能、适用场景、常见配置项和代码示例,帮助大家快速上手并掌握其核心知识点。@Schema通过@Schema注解,我们可以为 API 数据模型添加详细的描述信息,显著提高生成文档的可读性和直观性。在实际项目中,

沉淀所学,分享所思,让热爱与成长同行。商务记录AI实战经验,助力开发者快速成长。 热爱AI,希望做出有影响力的技术成果。 技术点亮生活,分享连接价值与机会。 专注AI落地实战,陪你走好技术每一步。 1万+
上一篇: 微服务真的不挑数据库吗?如何选择?
下一篇: 2面字节,被面试官抬着走出去,分享给大家
程序员职业指南
博客等级 码龄4年 2139粉丝 960原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值