ASM框架使用（四）--泛型与注解

泛型

对于泛型类型Type的解析，必须按照下面的顺序
访问方法签名按照下面的顺序
访问类签名的顺序
其中大部分方法都会返回一个SignatureVisitor，用于访问一个type签名。
SignatureVisitor返回SignatureVisitors（不能返回null）。

ASM提供SignatureReader和SugnatureWriter用于解析和创建签名。
SignatureReader解析签名并调用SignatureVisitor中相应的方法，SugnatureWriter根据收到的方法调用创建签名。

public class Node<T> {
    int key;
    T value;

    public <K>void do1(K a){
        System.out.println( "ss1"+a);
    }

    public static void main(String[] args) {
        Node m=new Node();
        m.do1(4);
    }
}

给Node类添加一个泛型M,也给方法添加一个泛型声明M：

public class GenericAdapter extends ClassVisitor implements Opcodes {
    public GenericAdapter( ClassVisitor classVisitor) {
        super(ASM6, classVisitor);
    }

    @Override
    public MethodVisitor visitMethod(int i, String s, String s1, String s2, String[] strings) {
        if (s2!=null) {
            s2=addGernicM(s2);
        }
        return super.visitMethod(i, s, s1, s2, strings);
    }

    @Override
    public void visit(int i, int i1, String s, String s1, String s2, String[] strings) {
        if (s1!=null)
            s1=addGernicM(s1);
        super.visit(i, i1, s, s1, s2, strings);
    }

    private String addGernicM(String s1) {
        SignatureWriter sw = new SignatureWriter();
        SignatureVisitor sa = new AddGernicMVisiter(sw);
        SignatureReader sr = new SignatureReader(s1);
        sr.acceptType(sa);
        return sw.toString();
    }

    public static void main(String[] args) throws IOException {
        ClassReader classReader=new ClassReader("bytecode.Node");
        ClassWriter cw=new ClassWriter(ClassWriter.COMPUTE_MAXS);
        TraceClassVisitor traceClassVisitor=new TraceClassVisitor(cw,new PrintWriter(System.out));
        GenericAdapter genericAdapter=new GenericAdapter(traceClassVisitor);
        classReader.accept(genericAdapter,ClassReader.EXPAND_FRAMES);

    }
    class AddGernicMVisiter extends SignatureVisitor{
        private SignatureVisitor signatureVisitor;
        public AddGernicMVisiter(SignatureVisitor signatureVisitor) {
            super(ASM6);
            this.signatureVisitor=signatureVisitor;
        }


        @Override
        public void visitClassType(String s) {
            signatureVisitor.visitClassType(s+"M:Ljava/lang/Object;");
        }

    }

}

---

注解

只要一个注解的作用域不是RetentionPolicy.SOURCE，那么它就会存储在编译后的class文件中。如果作用域是RetentionPolicy.RUNTIME，那么可以在运行时被反射获取。

ASM框架通过AnnotationVisitor来访问和修改注解。

访问顺序：

visitAnnotation方法返回Null可以移除一个注解，
下面分别移除了 字段上的注解，类上的注解，以及获取注解的值。

public class AnnotationAdapter extends ClassVisitor implements Opcodes{
    public AnnotationAdapter(ClassVisitor classVisitor) {
        super(ASM6, classVisitor);
    }

    @Override
    public FieldVisitor visitField(int access, String name, String descriptor, String signature, Object value) {
        FieldVisitor fv= super.visitField(access, name, descriptor, signature, value);
        if (fv!=null)
            fv=new RemoveFieldAnnotation(fv);//移除一个注解
        return fv;
    }

    /**
     * 移除类上的ClassR1注解
     * @param descriptor
     * @param visible
     * @return
     */
    @Override
    public AnnotationVisitor visitAnnotation(String descriptor, boolean visible) {
        if (descriptor.equals("Lcom/liu/asm/ClassR1;")){
            return null;
        }
        return new AnnotationValueVisitor(super.visitAnnotation(descriptor, visible));
    }

    public static void main(String[] args) throws IOException {
        ClassWriter cw=new ClassWriter(ClassWriter.COMPUTE_MAXS);
        TraceClassVisitor tv=new TraceClassVisitor(cw,new PrintWriter(System.out));
        AnnotationAdapter addFiled=new AnnotationAdapter(tv);
        ClassReader classReader=new ClassReader("com.liu.asm.Student");
        classReader.accept(addFiled,ClassReader.EXPAND_FRAMES);
    }
    class RemoveFieldAnnotation extends FieldVisitor{

        public RemoveFieldAnnotation(FieldVisitor fieldVisitor) {
            super(ASM6,fieldVisitor);
        }

        @Override
        public AnnotationVisitor visitAnnotation(String descriptor, boolean visible) {
            if (descriptor.equals("Lcom/liu/asm/ClassR1;")){
                return null;
            }
            return new AnnotationValueVisitor(super.visitAnnotation(descriptor, visible));
        }
    }
    class AnnotationValueVisitor extends AnnotationVisitor{

        public AnnotationValueVisitor( AnnotationVisitor annotationVisitor) {
            super(ASM6, annotationVisitor);
        }

        @Override
        public void visit(String name, Object value) {
            System.out.println("注解"+name+value);
            super.visit(name, value);
        }
    }
}

---

向后兼容性

学习新的class文件特性对字节码产生器，分析器和适配器的影响是重要的，因为二进制实现的兼容性问题。

对于字节码生成器，新特性对它没什么影响。
而分析器和适配器则可能会收到影响。

因此，制定了以下规则保证向后兼容性：

• ASM version X是为Java版本小于等于x的类写的，不能用于高于版本x的
• code written for ASM X不能用高于x版本的特性