ASM框架學習(二)-ClassVisitor

簡介

ClassVisitor是用來生成asm和改變字節(jié)碼的,ClassVisitor是一個訪問字節(jié)碼的框架,其對字節(jié)碼的創(chuàng)建和修改主要是通過其內(nèi)部的ClassVisitor具體實現(xiàn)來代理的;
ClassVisitor對一個java類的訪問是有一定順序的,其具體順序如下:

visit [visitSource] [visitModule] [visitNestHost][visitOuterClass](visitAnnotation | visitTypeAnnotation|visitAttribute)*
(visitNestMember|visitInnerClass|visitField| visitMethod)* visitEnd;
說明:visit,visitEnd必須調(diào)用一次,[]表示最多調(diào)用一次;
()*表示()里面的訪問可以按照排列順序調(diào)用多次;

方法說明

  • visit:訪問類的頭部,
public void visit(final int version,final int access,  final String name,  final String signature, final String superName, final String[] interfaces){
 if (cv != null) {
      cv.visit(version, access, name, signature, superName, interfaces);
    }};
其中version指的是類的版本;
acess指的是類的修飾符;
name類的名稱;
signature類的簽名,如果類不是泛型或者沒有繼承泛型類,那么signature為空;
superName類的父類名稱;
  • visitSource: 訪問類的源碼,就是.java文件,一般情況用不上;
  public void visitSource(final String source, final String debug) {
    if (cv != null) {
      cv.visitSource(source, debug);
    }
  }
  • visitModule:暫時不清楚用來干嘛的,用的比較少;
  • visitNestHost:訪問類的nest host;

nest 指的一個共享私有成員變量的包名相同的class集合,nest中有一個host(主類)和多個members(成員類),jdk11為了提供更大,更廣泛的嵌套類型,并且為了補足訪問控制檢測不足,引進了兩個新的class文件屬性,nest host 和nest member,nest host中包含了一個nest members列表,用來確定其他靜態(tài)nest members;nest member中包含了一個nest host屬性用來確定它的nesthost;

  • visitOuterClass: 訪問類的外部類,一般用于nest-class;
  • visitAnnotation:訪問類的注解;
  public AnnotationVisitor visitAnnotation(final String descriptor, final boolean visible) {
    if (cv != null) {
      return cv.visitAnnotation(descriptor, visible);
    }
    return null;
  }
其中:
descriptor:表示類注解類的描述;
visible表示該注解是否運行時可見;
return AnnotationVisitor:表示該注解類的Visitor,可以用來訪問注解值;
  • visitTypeAnnotation:訪問類的簽名類型(某個泛型)的注解;
 public AnnotationVisitor visitTypeAnnotation(
      final int typeRef, final TypePath typePath, final String descriptor, final boolean visible) {
    if (api < Opcodes.ASM5) {
      throw new UnsupportedOperationException("This feature requires ASM5");
    }
    if (cv != null) {
      return cv.visitTypeAnnotation(typeRef, typePath, descriptor, visible);
    }
    return null;
  }
其中:
typeRef:指的是類型引用,在這里只能是TypeReference.(CLASS_TYPE_PARAMETER |CLASS_TYPE_PARAMETER_BOUND|CLASS_EXTENDS );
typePath:被注解的類型參數(shù),wildcard bound,array element type,包含typeRef的static inner type;
descriptor: 注解類的描述;
visible:該注解類型運行時是否可見;
  • visitAttribute:訪問類的非標準屬性;
public void visitAttribute(final Attribute attribute) {
    if (cv != null) {
      cv.visitAttribute(attribute);
    }
  }
  • visitNestMember:訪問嵌套類的nest member,只有host class被visited時才能調(diào)用該方法
  • visitInnerClass:訪問一個內(nèi)部類的信息;
  • visitField:訪問一個類的域信息,如果需要修改或者新增一個域,可以通過重寫此方法;
  public FieldVisitor visitField( final int access, final String name, final String descriptor,final String signature,
      final Object value) {
    if (cv != null) {
      return cv.visitField(access, name, descriptor, signature, value);
    }
    return null;
  }
其中
access:表示該域的訪問方式,public,private或者static,final等等;
name:指的是域的名稱;
descriptro:域的描述,一般指的是該field的參數(shù)類型;
signature:指的是域的簽名,一般是泛型域才會有簽名;
value:指的該域的初始值
reture FiedVisitor:表示將返回一個可以訪問該域注解和屬性的訪問對象,如果不感興趣的話,可以設置為空;
  • visitMethod:訪問類的方法,如果需要修改類方法信息,則可以重寫此方法;
  public MethodVisitor visitMethod( final int access,final String name,final String descriptor,final String signature, final String[] exceptions) {
    if (cv != null) {
      return cv.visitMethod(access, name, descriptor, signature, exceptions);
    }
    return null;
  }
其中:
decsriptor:表示方法的參數(shù)類型和返回值類型;
  • visitEnd:訪問類的尾部,只有當類訪問結(jié)束時,才能調(diào)用該方法,同時必須調(diào)用該方法;
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內(nèi)容