上海高端网站建设,北京未来广告公司,近期重大新闻事件10条,门窗网站设计注解
注解#xff08;Annotation#xff09;#xff0c;也叫元数据。一种代码级别的说明。它是JDK1.5及以后版本引入的一个特性#xff0c;与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面#xff0c;用来对这些元素进行说…注解
注解Annotation也叫元数据。一种代码级别的说明。它是JDK1.5及以后版本引入的一个特性与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面用来对这些元素进行说明注释。注解相关类都包含在java.lang.annotation包中。 注解可以看作是一种特殊的标记可以用在方法、类、参数和包上程序在编译或者运行时可以检测到这些标记而进行一些特殊的处理。
Java注解分类基本注解元注解自定义注解 JDK基本注解
Override
重写
SuppressWarnings(value unchecked)
压制编辑器警告
JDK元注解
//表示需要在什么级别保存该注释信息用于描述注解的生命周期即被描述的注解在什么范围内有效
//即注解的生命周期。
Retention定义注解的保留策略
Retention(RetentionPolicy.SOURCE) //注解仅存在于源码中在class字节码文件中不包含
Retention(RetentionPolicy.CLASS) //默认的保留策略注解会在class字节码文件中存在但运行时无法获得
Retention(RetentionPolicy.RUNTIME)//注解会在class字节码文件中存在在运行时可以通过反射获取到// 用于描述注解的使用范围即被描述的注解可以用在什么地方。
Target指定被修饰的Annotation可以放置的位置(被修饰的目标)
Target(ElementType.TYPE) //接口、类
Target(ElementType.FIELD) //属性
Target(ElementType.METHOD) //方法
Target(ElementType.PARAMETER) //方法参数
Target(ElementType.CONSTRUCTOR) //构造函数
Target(ElementType.LOCAL_VARIABLE) //局部变量
Target(ElementType.ANNOTATION_TYPE) //注解
Target(ElementType.PACKAGE) //包
注可以指定多个位置例如
Target({ElementType.METHOD, ElementType.TYPE})也就是此注解可以在方法和类上面使用//表明使用了Inherited注解的注解所标记的类的子类也会拥有这个注解。
Inherited指定被修饰的Annotation将具有继承性//表明该注解标记的元素可以被Javadoc 或类似的工具文档化
Documented指定被修饰的该Annotation可以被javadoc工具提取成文档. 由此可见生命周期关系SOURCE CLASS RUNTIME我们一般用RUNTIME
其中最重要的是
Retention(RetentionPolicy.RUNTIME)
Target指定被修饰的Annotation可以放置的位置(被修饰的目标)自定义注解
注解分类根据Annotation是否包含成员变量,可以把Annotation分为两类:
标记Annotation: 没有成员变量的Annotation; 这种Annotation仅利用自身的存在与否来提供信息
元数据Annotation: 包含成员变量的Annotation; 它们可以接受(和提供)更多的元数据;
反射机制
反射最重要的就是类,一切反射的基础是类 静态语言 VS 动态语言
动态语言 是一类在运行时可以改变其结构的原因例如新的函数、对象、甚至代码可以被引进已有的函数可以被删除或是其他结构上的变化。通俗点说就是在运行时代码可以根据某些条件改变自身结构 主要动态语言Object-c、C#、JavaScript、php、Python等
静态语言 与动态语言相对应的运行时结构不可变的语言就是静态语言。如Java、C、C。 Java不是动态语言但Java可以称之为准动态语言。即Java有一定的动态性我们可以利用反射机制获得类似语言的特性。Java的动态性让编程的时候更加灵活
自定义注解参数可以支持的类型
1.八大基本数据类型
2.String类型
3.Class类型
4.enum类型
5.Annotation类型
6.以上所有类型的数组
如何处理注解
注解可以分两个主要阶段进行处理 编译时处理 在编译时注解可以由注解处理器处理 - 这些是特殊的类可以读取注解信息并生成附加源代码、文档或其他资源。注解处理器是 Java 注解处理工具 (APT) 的一部分。
编译时处理的一个示例是Override注解Java 编译器使用它来验证某个方法确实覆盖了超类中的方法。
运行时处理 保留策略为RUNTIME 的注解在运行时可供 JVM 使用。这允许运行时反射——代码可以检查自己的注解并根据这些注解的存在和配置执行不同步骤。
Java 中的注解是通过动态代理和接口实现的。当您查询元素上的注解时返回的不是注解接口的直接实例而是实现注解接口的代理。
自定义注解
定义注解
要创建自定义注解从interface关键字开始。这向 Java 编译器发出信号表明正在声明注解。以下是定义基本自定义注解的方法
package com.wsl.annotitiondemo.annotation;import java.lang.annotation.*;/*** packageName com.wsl.annotitiondemo.annotation OperationLog** author victor* version JDK 8* date 2024/7/9* description*/
Target(ElementType.METHOD)
Retention(RetentionPolicy.RUNTIME)
Documented
public interface OperationLog {String username() default ;OperationType type();String content() default ;}
package com.wsl.annotitiondemo.annotation;/*** packageName com.wsl.annotitiondemo.annotation OperationType** author victor* version JDK 8* date 2024/7/9* description*/
public enum OperationType {//FIND(0,find) ,//ADD(1,add) ,//UPDATE(2,update),//DELETE(3,delete);private final int number;private final String description;OperationType(int number,String description){this.number number;this.description description;}public int getNumber() {return number;}public String getDescription() {return description;}
}
在这个定义中
Retention(RetentionPolicy.RUNTIME)指定该注解在运行时可用于反射。 Target({ElementType.METHOD, ElementType.TYPE})表明该注解既可以用于类声明也可以用于方法声明。
应用注解
定义注解后您可以将其应用到代码中。例如
package com.wsl.annotitiondemo.annotation;import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.Signature;
import org.aspectj.lang.annotation.*;
import org.aspectj.lang.reflect.MethodSignature;
import org.springframework.stereotype.Component;import java.lang.reflect.Method;
import java.util.Optional;/*** packageName com.wsl.annotitiondemo.annotation ComLogAspect** author victor* version JDK 8* date 2024/7/9* description TODO*/
Component
Aspect
public class ComLogAspect {//配置织入点Pointcut(annotation(com.wsl.annotitiondemo.annotation.OperationLog))public void logPointCut(){}//Before: 前置通知, 在方法执行之前执行这个通知不能阻止连接点前的执行除非它抛出一个异常Before(logPointCut())public void doBefore(JoinPoint joinPoint){System.out.println(dobefore);handleLog(joinPoint,null);}
//
// //After: 后置通知, 在方法执行之后执行不论是正常返回还是异常退出。
// After(value logPointCut() annotation(operationLog))
// public void doAfter(OperationLog operationLog){
//
// }/*** Around: 包围一个连接点join point的通知如方法调用。这是最强大的一种通知类型。* 环绕通知可以在方法调用前后完成自定义的行为。* 它也会选择是否继续执行连接点或直接返回它们自己的返回值或抛出异常来结束执行。* */Around(logPointCut())public Object doAround(ProceedingJoinPoint pjp) throws Throwable {long startTime System.currentTimeMillis();Object[] args pjp.getArgs();System.out.println(Arrays.toString(args));Object ob pjp.proceed(); // ob 为方法的返回值System.out.println(耗时 : (System.currentTimeMillis() - startTime) ms);return ob;}//AfterRunning:返回通知, 在方法正常返回结果之后执行AfterReturning(pointcut logPointCut())public void doAfterRunning(JoinPoint joinPoint){System.out.println(方法执行完执行...afterRunning);handleLog(joinPoint,null);}//AfterThrowing: 异常通知, 在方法抛出异常之后。AfterThrowing(value logPointCut(),throwing e)public void doAfterThrowing(JoinPoint joinPoint,Exception e){handleLog(joinPoint,e);}private void handleLog(JoinPoint joinPoint,Exception ex){try {OperationLog operationLog getAnnotationLog(joinPoint);if (operationLognull){return ;}String className joinPoint.getTarget().getClass().getName();String methodName joinPoint.getSignature().getName();OperationType type operationLog.type();String content operationLog.content();String username operationLog.username();System.out.println(classNameclassName);System.out.println(methodNamemethodName);System.out.println(contentcontent);System.out.println(usernameusername);}catch (Exception es){es.printStackTrace();}}private static OperationLog getAnnotationLog(JoinPoint joinPoint) throws Exception{Signature signature joinPoint.getSignature();MethodSignature methodSignature (MethodSignature)signature;Method method methodSignature.getMethod();if (method!null){return method.getAnnotation(OperationLog.class);}return null;}}
处理注解
自定义注解可以通过两种方式处理在编译时使用注解处理器或在运行时使用反射。
编译时处理 要在编译时处理注解通常会使用 Java 注解处理 API。注解处理器是一种检查和处理 Java 代码中注解类型的工具。这是注解处理器的骨架结构
import javax.annotation.processing.AbstractProcessor;
import javax.annotation.processing.RoundEnvironment
import javax.lang.model.element.TypeElement;
import javax.lang.model.element.Element;
import java.util.Setpublic class MyAnnotationProcessor extends AbstractProcessor { Override public boolean process (Set? extends TypeElement comments, RoundEnvironment roundEnv) { for (TypeElement comment : comments) { for (Element element : roundEnv.getElementsAnnotatedWith(annotation)) { // 处理} }返回 true}
}运行时处理 对于运行时处理您将使用反射如上一节所示。这是一个重点关注我们的自定义注解的简短示例
import java.lang.reflect.Methodpublic class AnnotationRuntimeProcessor { public static void processAnnotations (Class? clazz) throws Exception { if (clazz.isAnnotationPresent(MyCustomAnnotation.class)) { // 类级注解MyCustomAnnotation classAnnotation clazz.getAnnotation(MyCustomAnnotation.class); } System.out.println( Class clazz.getSimpleName() 注解为 classAnnotation.author()); } for (Method method : clazz.getDeclaredMethods()) { if (method.isAnnotationPresent(MyCustomAnnotation.class)) { // 方法级注解MyCustomAnnotation methodAnnotation method.getAnnotation(MyCustomAnnotation.class); System.out.println( 方法 method.getName() 注解为 methodAnnotation.author()); } } } public static void main (String[] args) throws Exception { processAnnotations(SomeClass.class); }
}在 Java 中创建和使用自定义注解是增强代码的有效方法。它允许更清晰、更具描述性的代码并在编译时和运行时实现某些任务的自动化。通过定义、应用和处理自定义注解您可以创建更具可读性、可维护性和表现力的 Java 应用程序。
测试
package com.wsl.annotitiondemo.controller;import com.wsl.annotitiondemo.annotation.OperationLog;
import com.wsl.annotitiondemo.annotation.OperationType;
import org.springframework.stereotype.Component;/*** packageName com.wsl.annotitiondemo.controller LogController** author victor* version JDK 8* date 2024/7/9* description*/
Component
public class LogController {OperationLog(username wsl,type OperationType.ADD,content 新增内容)public void testlog(){System.out.println(第一个测试);}
}
package com.wsl.annotitiondemo.controller;import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;/*** packageName com.wsl.annotitiondemo.controller LogControllerTest** author victor* version JDK 8* date 2024/7/9* description TODO*/
RunWith(SpringRunner.class)
SpringBootTest
public class LogControllerTest {Autowiredprivate LogController logController;Testpublic void test01(){logController.testlog();}
}
添加的pom文件
?xml version1.0 encodingUTF-8?
project xmlnshttp://maven.apache.org/POM/4.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instancexsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsdmodelVersion4.0.0/modelVersionparentgroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-parent/artifactIdversion2.7.3/versionrelativePath/ !-- lookup parent from repository --/parentgroupIdcom.wsl/groupIdartifactIdannotitiondemo/artifactIdversion0.0.1-SNAPSHOT/versionnameannotitiondemo/namedescriptionannotitiondemo/descriptionurl/licenseslicense//licensesdevelopersdeveloper//developersscmconnection/developerConnection/tag/url//scmpropertiesjava.version22/java.version/propertiesdependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactId/dependencydependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-aop/artifactId/dependencydependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-test/artifactIdscopetest/scope/dependencydependencygroupIdjunit/groupIdartifactIdjunit/artifactId/dependencydependencygroupIdorg.springframework/groupIdartifactIdspring-test/artifactId/dependencydependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-test/artifactId/dependency/dependenciesbuildpluginsplugingroupIdorg.springframework.boot/groupIdartifactIdspring-boot-maven-plugin/artifactId/plugin/plugins/build/project
总结
注解是 Java 中的一项强大功能它允许开发人员编写更清晰、更具表现力的代码。它们可用于多种目的从向编译器提供提示到启用复杂的运行时基于反射的逻辑。通过理解和利用自定义注解Java 开发人员可以创建更健壮、可维护且防错的应用程序。
创建自定义注解涉及使用关键字定义注解、指定任何默认元素值以及使用和元注解RetentionTarget确定可以应用注解的位置。定义后自定义注解可以在编译时或运行时使用反射进行处理从而提供强大的机制来扩展 Java 语言的功能。
参考 https://www.jb51.net/program/315875pzt.htm https://zhuanlan.zhihu.com/p/668951448 https://www.jianshu.com/p/296272f4358f EnableAspectJAutoProxy(exposeProxytrue,proxyTargetClasstrue) https://blog.csdn.net/Lwcxz1006/article/details/132111786
