purpose:
1.Java comment Profile
2. the Java meta-annotation (focus)
3. custom annotation
Case I (get comment on the value of the classes and methods)
Case II (annotation attribute values on the acquisition class attributes)
Case III (acquisition parameters modified annotation corresponding attribute value)
4. Aop custom annotation application (focus)
Introduction to Java Annotations
1. Java annotations (Annotation)
Java annotations are added to the code of some meta information for some of the tools in the compilation,
Parse and use run-time, play instructions, configuration functions.
Notes related classes are included in java.lang.annotation package.
2. Java annotations Category
2.1 JDK basic annotation
2.2 JDK yuan notes
2.3 custom annotation
3. JDK basic annotation
3.1 @Override
Rewrite
3.2 @Deprecated
Obsolete
3.3 @SuppressWarnings(value = "unchecked")
Pressing Editor Warning
Java meta-annotation
Role: a meta-annotation for the modification of other notes
- @Retention : annotation defined retention policy
@Retention (RetentionPolicy.SOURCE) // annotation exists only in the source code, the class bytecode file does not contain
@Retention (RetentionPolicy.CLASS) // default retention policy, annotations exist in the class bytecode file, but running can not be obtained,
@Retention (RetentionPolicy.RUNTIME) // annotations will exist in the class bytecode file at run time can be obtained by reflection
-
@Target : Specifies modified Annotation can be placed in the position ( modified target )
@Target (ElementType.TYPE) // interface class @Target (ElementType.FIELD) // property @Target (ElementType.METHOD) // method @Target (ElementType.PARAMETER) // Method parameters @Target (ElementType.CONSTRUCTOR) // constructor @Target (ElementType.LOCAL_VARIABLE) // local variable @Target (ElementType.ANNOTATION_TYPE) // annotation @Target (ElementType.PACKAGE) // package
Note: You can specify a plurality of positions, for example:
@Target ({ElementType.METHOD, ElementType.TYPE}) , i.e. This annotation can be used in the above methods and classes
- @ Inherited : Specifies the modified Annotation will have inherited
@Documented: specifies the modified Annotation can be extracted javadoc tool to document.
Custom annotation
Notes classification (according to Annotation contains a member variable , can Annotation divided into two categories) :
Mark Annotation:
No member variables Annotation; this Annotation using only their presence or absence to provide information
Metadata Annotation:
Member variables comprising the Annotation; they can accept ( and provided ) additional metadata ;
How to customize annotations?
Use @interface keyword , defined process and define the interface is very similar , to note that :
Annotation of member variables in Annotation is a form of non-parametric methods to declare the definition , its method name and return value type defines the name and type of the member variable ,
And we can also use the default keyword to set a default value for the member variable;
Note: Only the name is " value " property, you can omit the property name on assignment
Case I (get notes on classes and methods value):
TranscationModel
package com.huangting.annotation.P1;
/**
* enum枚举
*/
public enum TranscationModel {
Read, ReadWrite, Write
}
MyAnnotation1
package com.huangting.annotation.P1;
import java.lang.annotation.*;
/**
* MyAnnotation1注解可以用在类、接口、属性、方法上
* 注解运行期也保留
* 不可继承
*/
@Target({ElementType.TYPE, ElementType.FIELD,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface MyAnnotation1 {
String name();
}
MyAnnotation2
package com.huangting.annotation.P1;
import java.lang.annotation.*;
/**
* MyAnnotation2注解可以用在方法上
* 注解运行期也保留
* 不可继承
*/
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface MyAnnotation2 {
TranscationModel model() default TranscationModel.ReadWrite;
}
MyAnnotation3
package com.huangting.annotation.P1;
import java.lang.annotation.*;
/**
* MyAnnotation3注解可以用在方法上
* 注解运行期也保留
* 可继承
*/
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface MyAnnotation3 {
TranscationModel[] models() default TranscationModel.ReadWrite;
}
Dome1
package com.huangting.annotation.P1;
/**
* 获取类与方法上的注解值
*/
@MyAnnotation1(name = "abc")
public class Demo1 {
@MyAnnotation1(name = "xyz")
private Integer age;
@MyAnnotation2(model = TranscationModel.Read)
public void list() {
System.out.println("list");
}
@MyAnnotation3(models = {TranscationModel.Read, TranscationModel.Write})
public void edit() {
System.out.println("edit");
}
}
Demo1Test
package com.huangting.annotation.P1;
import org.junit.Test;
public class Demo1Test {
@Test
public void list() throws Exception {
// 获取类上的注解
MyAnnotation1 annotation1 = Demo1.class.getAnnotation(MyAnnotation1.class);
System.out.println(annotation1.name());//abc
// 获取方法上的注解
MyAnnotation2 myAnnotation2 = Demo1.class.getMethod("list").getAnnotation(MyAnnotation2.class);
System.out.println(myAnnotation2.model());//Read
}
@Test
public void edit() throws Exception {
MyAnnotation3 myAnnotation3 = Demo1.class.getMethod("edit").getAnnotation(MyAnnotation3.class);
for (TranscationModel model : myAnnotation3.models()) {
System.out.println(model);//Read,Write
}
}
}
效果:
注意:
jar包的运用中最好不要出现test,把《scope》《/scope》删除即可
否则会报错@Test无法使用
案例二(获取类属性上的注解属性值)
TestAnnotation
package com.huangting.annotation.P2;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
//@Retention(RetentionPolicy.SOURCE)
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface TestAnnotation {
String value() default "默认value值";
String what() default "这里是默认的what属性对应的值";
}
Dome2
package com.huangting.annotation.P2;
/**
* 获取类属性上的注解属性值
*/
public class Demo2 {
@TestAnnotation(value = "这就是value对应的值_msg1", what = "这就是what对应的值_msg1")
private static String msg1;
@TestAnnotation("这就是value对应的值1")
private static String msg2;
@TestAnnotation(value = "这就是value对应的值2")
private static String msg3;
@TestAnnotation(what = "这就是what对应的值")
private static String msg4;
}
Demo2Test
package com.huangting.annotation.P2;
import org.junit.Test;
public class Demo2Test {
@Test
public void test1() throws Exception {
TestAnnotation msg1 = Demo2.class.getDeclaredField("msg1").getAnnotation(TestAnnotation.class);
System.out.println(msg1.value());
System.out.println(msg1.what());
}
@Test
public void test2() throws Exception{
TestAnnotation msg2 = Demo2.class.getDeclaredField("msg2").getAnnotation(TestAnnotation.class);
System.out.println(msg2.value());
System.out.println(msg2.what());
}
@Test
public void test3() throws Exception{
TestAnnotation msg3 = Demo2.class.getDeclaredField("msg3").getAnnotation(TestAnnotation.class);
System.out.println(msg3.value());
System.out.println(msg3.what());
}
@Test
public void test4() throws Exception{
TestAnnotation msg4 = Demo2.class.getDeclaredField("msg4").getAnnotation(TestAnnotation.class);
System.out.println(msg4.value());
System.out.println(msg4.what());
}
}
效果:
案例三(获取参数修饰注解对应的属性值):
IsNotNull
package com.huangting.annotation.P3;
import java.lang.annotation.*;
/**
* 非空注解:使用在方法的参数上,false表示此参数可以为空,true不能为空
*/
@Documented
@Target({ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface IsNotNull {
boolean value() default false;
}
Demo3
package com.huangting.annotation.P3;
/**
* 获取参数修饰注解对应的属性值
*/
public class Demo3 {
public void hello1(@IsNotNull(true) String name) {
System.out.println("hello:" + name);
}
public void hello2(@IsNotNull String name) {
System.out.println("hello:" + name);
}
}
Demo3Test
package com.huangting.annotation.P3;
import org.junit.Test;
import java.lang.reflect.Parameter;
public class Demo3Test {
@Test
public void hello1() throws Exception {
Demo3 demo3 = new Demo3();
for (Parameter parameter : demo3.getClass().getMethod("hello1", String.class).getParameters()) {
IsNotNull annotation = parameter.getAnnotation(IsNotNull.class);
if(annotation != null){
System.out.println(annotation.value());//true
}
}
}
@Test
public void hello2() throws Exception {
Demo3 demo3 = new Demo3();
for (Parameter parameter : demo3.getClass().getMethod("hello2", String.class).getParameters()) {
IsNotNull annotation = parameter.getAnnotation(IsNotNull.class);
if(annotation != null){
System.out.println(annotation.value());//false
}
}
}
}
效果:
Aop自定义注解的应用
MyLog
package com.huangting.annotation.Aop;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyLog {
String desc();
}
MyLogAspect
package com.huangting.annotation.Aop;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.aspectj.lang.annotation.Pointcut;
import org.aspectj.lang.reflect.MethodSignature;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;
@Component
@Aspect
public class MyLogAspect {
private static final Logger logger = LoggerFactory.getLogger(MyLogAspect.class);
/**
* 只要用到了com.huangting.annotation.Aop.MyLog这个注解的,就是目标类
*/
@Pointcut("@annotation(com.huangting.annotation.Aop.MyLog)")
private void MyValid() {
}
@Before("MyValid()")
public void before(JoinPoint joinPoint) {
MethodSignature signature = (MethodSignature) joinPoint.getSignature();
MyLog myLog = signature.getMethod().getAnnotation(MyLog.class);
System.out.println("[" + signature.getName() + " : start.....]");
System.out.println("【目标对象方法被调用时候产生的日志,记录到日志表中】:"+myLog.desc());
}
}
BaseTestCase
package com.huangting.annotation.Aop;
import org.junit.runner.RunWith;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(locations={"classpath:applicationContext.xml"})
public class BaseTestCase {
}
LogController
package com.huangting.annotation.Aop;
import org.springframework.stereotype.Component;
@Component
public class LogController {
@MyLog(desc = "这是结合spring aop知识,讲解自定义注解应用的一个案例")
public void testLogAspect(){
System.out.println("墙头马上遥相顾");
}
}
LogControllerTest
package com.huangting.annotation.Aop;
import org.junit.Test;
import org.springframework.beans.factory.annotation.Autowired;
public class LogControllerTest extends BaseTestCase {
@Autowired
private LogController logController;
@Test
public void testLogAspect(){
logController.testLogAspect();
}
}
效果:
谢谢观看!