ASM指南翻译-6
2.2.5移除类成员
前面例子中用来修改类版本号的方法也可以用在ClassVisitor接口中的其它方法上。例如，通过修改visitField和visitMethod方法中的access核name，你可以修改一个字段或者方法的访问修饰符和名称。更进一步，除了转发修改该参数的方法调用，你也可以选择不转发该方法调用，这样做的效果就是，对应的类元素将被移除。
例如，下面的类适配器将移除外部类和内部类，同时移除源文件的名称（修改过的类仍然是功能完整的，因为这些元素仅用作调试）。这主要是通过保留visit方法为空来实现。
public class RemoveDebugAdapter extends ClassAdapter {
public RemoveDebugAdapter(ClassVisitor cv) {
super(cv);
}
@Override
public void visitSource(String source, String debug) {
}
@Override
public void visitOuterClass(String owner, String name, String desc) {
}
@Override
public void visitInnerClass(String name, String outerName,
String innerName, int access) {
}
}
上面的策略对字段和方法不起作用，因为visitField和visitMethod方法必须返回一个结果。为了移除一个字段或者一个方法，你不能转发方法调用，而是返回一个null。下面的例子，移除一个指定了方法名和修饰符的方法（单独的方法名是不足以确定一个方法，因为一个类可以包含多个相同方法名的但是参数个数不同的方法）：
public class RemoveMethodAdapter extends ClassAdapter {
private String mName;
private String mDesc;
public RemoveMethodAdapter(
ClassVisitor cv, String mName, String mDesc) {
super(cv);
this.mName = mName;
this.mDesc = mDesc;
}
@Override
public MethodVisitor visitMethod(int access, String name,
String desc, String signature, String[] exceptions) {
if (name.equals(mName) && desc.equals(mDesc)) {
// do not delegate to next visitor -> this removes the method
return null;
}
return cv.visitMethod(access, name, desc, signature, exceptions);
}
}
2.2.6增加类成员
除了传递较少的方法调用，你也可以传递更多的方法调用，这样可以实现增加类元素。新的方法调用可以插入到原始方法调用之间，同时visitXxx方法调用的顺序必须保持一致（参看2.2.1）。
例如，如果你想给类增加一个字段，你需要在原始方法调用之间插入一个visitField调用，并且你需要将这个新的调用放置到类适配器的其中一个visit方法之中（这里的visit是指以visit打头的方法）。你不能在方法名为visit的方法中这样做，因为这样会导致后续对visitSource，visitOuterClass，visitAnnotation或者visitAttribute方法的调用，这样做是无效的。同样，你也不能将对visitField方法的调用放置到visitSource，visitOuterClass，visitAnnotation或者visitAttribute方法中。可能的位置是visitInnerClass，visitField，visitMethod和visitEnd方法。
如果你将这个调用放置到visitEnd中，字段总会被添加，除非你添加了显示的条件，因为这个方法总是会被调用。如果你把它放置到visitField或者visitMethod中，将会添加好几个字段，因为对原始类中每个字段或者方法的调用都会导致添加一个字段。两种方案都能实现，如何使用取决于你的需要。例如，你恶意增加一个单独的counter字段，用来统计对某个对象的调用次数，或者针对每个方法，添加一个字段，来分别统计对每个方法的调用。
注意：事实上，添加成员的唯一正确的方法是在visitEnd方法中增加额外的调用。同时，一个类不能包含重复的成员，而确保新添加的字段是唯一的方法就是比较它和已经存在的成员，这只能在所有成员都被访问之后来操作，例如在visitEnd方法中。程序员一般不大可能会使用自动生成的名字，如_counter$或者_4B7F_可以避免出现重复的成员，这样就不需要在visitEnd中添加它们。注意，如在第一章中讲的，tree API就不会存在这样的限制，使用tree API就可以在转换的任何时间点添加新成员。
为了展示上面的讨论，下面是一个类适配器，用来给一个类增加一个字段，除非这个字段已经存在：
public class AddFieldAdapter extends ClassAdapter {
private int fAcc;
private String fName;
private String fDesc;
private boolean isFieldPresent;
public AddFieldAdapter(ClassVisitor cv, int fAcc, String fName,
String fDesc) {
super(cv);
this.fAcc = fAcc;
this.fName = fName;
this.fDesc = fDesc;
}
@Override
public FieldVisitor visitField(int access, String name, String desc,
String signature, Object value) {
if (name.equals(fName)) {
isFieldPresent = true;
}
return cv.visitField(access, name, desc, signature, value);
}
@Override
public void visitEnd() {
if (!isFieldPresent) {
FieldVisitor fv = cv.visitField(fAcc, fName, fDesc, null, null);
if (fv != null) {
fv.visitEnd();
}
}
cv.visitEnd();
}
}
这个字段是在visitEnd方法中添加的。重写visitField方法不是为了修改已经存在的字段，而是为了检测我们希望添加的字段是否已经存在。注意，在调用fv.visitEnd之前，我们测试了fv是否为空，如我们前面所讲，一个class visitor的visitField方法可以返回null。
2.2.7转换链
到目前为止，我们看到了一些有ClassReader，一个类适配器和ClassWriter组成的转换链。当然，也可以将多个类适配器连接在一起，来实现更复杂的转换链。链接多个类适配器运行你组合多个独立的类转换，以实现更复杂的转换。注意，一个转换链条没必要是线性的，你可以编写一个ClassVisitor，然后同时转发所有的方法调用给多个ClassVisitor：
public class MultiClassAdapter implements ClassVisitor {
protected ClassVisitor[] cvs;
public MultiClassAdapter(ClassVisitor[] cvs) {
this.cvs = cvs;
}
@Override public void visit(int version, int access, String name,
String signature, String superName, String[] interfaces) {
for (ClassVisitor cv : cvs) {
cv.visit(version, access, name, signature, superName, interfaces);
}
}
...
}
相对地，多个类适配器也可以将方法调用都委托给相同的ClassVisitor（这需要额外的小心，以确保visit和visitEnd方法只被调用一次）。如图2.8这样的转换链也是可能地。
图2.8：一个复杂的转换链