最近的工作与aspectj切面技术相关，为了实现零依赖，将aspectjrt包也重定位包名打到项目jar包中，但带来的问题因为aspectj相关包名被重定位了该项目也不能作为切面库使用，所以又想了一个更复杂的方案来解决这个问题，其中就需修改javac编译生成.class文件，将.class字节码中所有引用的aspectj类的包名进行修改重定向到新的包名。在DeepSeek的帮助下，已经实现了需求，此文作为技术总结，说明如何基于ASM实现.class引用包名的重定向。
一、实现原理
通过ASM字节码操作框架，我们可以实现对.class文件中包名引用的精准替换。核心原理是通过ClassVisitor和MethodVisitor遍历字节码结构，在以下四个层面进行包名替换：
- 类定义：修改类继承关系、接口实现中的包名
@Override
public void visit(int version, int access, String name,
String signature, String superName, String[] interfaces) {
super.visit(version, access, relocate(name),
relocate(signature), relocate(superName), relocate(interfaces));
}
- 方法指令：处理字段访问、方法调用等操作码
@Override
public void visitFieldInsn(int opcode, String owner, String name, String desc) {
super.visitFieldInsn(opcode, relocate(owner), name, relocate(desc));
}
- 注解处理：重写注解中的类型引用
@Override
public AnnotationVisitor visitAnnotation(String desc, boolean visible) {
return super.visitAnnotation(relocate(desc), visible);
}
- 类型描述符：替换方法参数和返回值的类型引用
@Override
public MethodVisitor visitMethod(int access, String name, String descriptor, String signature, String[] exceptions) {
MethodVisitor mv = super.visitMethod(
access,
name,
relocate(descriptor),
relocate(signature),
relocate(exceptions)
);
return new RelocatingMethodVisitor(mv);
}
二、应用场景
1. 依赖冲突解决
当不同库使用相同包路径时，可通过重定位隔离依赖（如将org.apache重命名为hidden.org.apache）。典型案例：
- 解决Log4j与Logback的包路径冲突
- 不同版本Guava库的兼容性问题
2. 代码混淆保护
通过包名混淆增加反编译难度（如将com.company.core重命名为a.b.c），保护关键业务逻辑
3. 框架定制开发
修改第三方库的包结构实现定制扩展，例如：
- AspectJ字节码增强框架的定制化改造
- Spring AOP的扩展实现
三、完整实现代码
import org.objectweb.asm.AnnotationVisitor;
import org.objectweb.asm.ClassVisitor;
import org.objectweb.asm.FieldVisitor;
import org.objectweb.asm.MethodVisitor;
import org.objectweb.asm.Opcodes;
/**
* RelocatingClassVisitor 是一个用于重定位类的访问者，继承自 ClassVisitor。
* 它主要用于将指定包名的类、方法和字段引用重定向到新的包名。
*
* <p>
* 该类实现了对类注解、方法和字段的访问，并在访问过程中替换包名。
* </p>
*
* <p>
* 内部类 RelocatingMethodVisitor 负责处理方法内部指令的包名替换。
* </p>
*
* <p>
* 提供了统一的包名替换逻辑，确保在处理过程中所有相关的引用都被正确重定向。
* </p>
*/
class RelocatingClassVisitor extends ClassVisitor {
// 原始包名 -> 重定位包名（示例值）
private static final String FROM_PKG = "org/aspectj";
private static final String TO_PKG = "com/custom/aspectj";
private static final String FROM_PKG_D = FROM_PKG.replace('/', '.');
private static final String TO_PKG_D = TO_PKG.replace('/', '.');
RelocatingClassVisitor(ClassVisitor cv) {
super(Opcodes.ASM9, cv);
}
@Override
public void visit(int version, int access, String name, String signature, String superName, String[] interfaces) {
super.visit(version,
access,
relocate(name),
relocate(signature),
relocate(superName),
relocate(interfaces));
}
/** 处理类注解 */
@Override
public AnnotationVisitor visitAnnotation(String descriptor, boolean visible) {
return super.visitAnnotation(relocate(descriptor), visible);
}
/** 处理方法中的类型引用 */
@Override
public MethodVisitor visitMethod(int access, String name,
String descriptor,
String signature,
String[] exceptions) {
MethodVisitor mv = super.visitMethod(
access,
name,
relocate(descriptor),
relocate(signature),
relocate(exceptions)
);
return new RelocatingMethodVisitor(mv);
}
/** 处理字段类型引用 */
@Override
public FieldVisitor visitField(int access, String name,
String descriptor,
String signature,
Object value) {
return super.visitField(
access,
name,
relocate(descriptor),
relocate(signature),
value
);
}
/** 统一包名替换逻辑 */
private String relocate(String input) {
return input != null ? input.replace(FROM_PKG, TO_PKG).replace(FROM_PKG_D, TO_PKG_D) : null;
}
private String[] relocate(String[] inputs) {
if (inputs == null) return null;
String[] results = new String[inputs.length];
for (int i = 0; i < inputs.length; i++) {
results[i] = relocate(inputs[i]);
}
return results;
}
/** 方法内部指令的包名替换 */
class RelocatingMethodVisitor extends MethodVisitor {
RelocatingMethodVisitor(MethodVisitor mv) {
super(Opcodes.ASM9, mv);
}
@Override
public void visitTypeInsn(int opcode, String type) {
super.visitTypeInsn(opcode, relocate(type));
}
@Override
public void visitLdcInsn(Object value) {
if (value instanceof String) {
super.visitLdcInsn(relocate((String) value));
} else {
super.visitLdcInsn(value);
}
}
@Override
public void visitMethodInsn(int opcode, String owner, String name, String descriptor, boolean isInterface) {
super.visitMethodInsn(opcode, relocate(owner), name, relocate(descriptor), isInterface);
}
@Override
public void visitFieldInsn(int opcode, String owner, String name, String descriptor) {
super.visitFieldInsn(opcode, relocate(owner), name, relocate(descriptor));
}
}
}
四、调用示例
import java.io.IOException;
import java.io.InputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.stream.Stream;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugin.logging.Log;
import org.objectweb.asm.ClassReader;
import org.objectweb.asm.ClassVisitor;
import org.objectweb.asm.ClassWriter;
public class RelocatingSupport{
/**
* 重定位指定文件夹中的包名引用。
*
* @param classesFolder 包含类文件的文件夹路径
* @param log 日志记录器，用于输出处理信息
* @throws MojoExecutionException 如果在重定位过程中发生错误
*/
static void relocateReferences(String classesFolder,Log log) throws MojoExecutionException {
log.info("开始重定位 AspectJ 包名引用..." + classesFolder);
Path outputPath = Paths.get(classesFolder);
try (Stream<Path> stream = Files.walk(outputPath)) {
stream.filter(p -> p.toString().endsWith(".class"))
.forEach(classFile -> processClass(classFile, log));
} catch (IOException e) {
throw new MojoExecutionException("包名重定位失败", e);
} catch (RelocatingException e) {
throw new MojoExecutionException("处理类文件失败: " + e.getMessage(), e);
}
}
static void processClass(Path classFile,Log log) {
try (InputStream is = Files.newInputStream(classFile)) {
log.info("处理类文件: " + classFile);
ClassReader cr = new ClassReader(is);
ClassWriter cw = new ClassWriter(0);
ClassVisitor cv = new RelocatingClassVisitor(cw);
cr.accept(cv, 0);
Files.write(classFile, cw.toByteArray());
} catch (Exception e) {
throw new RelocatingException(classFile.toString(), e);
}
}
static class RelocatingException extends RuntimeException {
private static final long serialVersionUID = 1L;
RelocatingException(String message, Throwable cause) {
super(message, cause);
}
}
}
五、技术要点
- 双包名格式处理：同时支持
org.aspectj和org/aspectj两种格式的替换 - 全量覆盖：处理类签名、方法描述符、字段类型等所有引用位置
- 类签名（Class Signature）
- 方法描述符（Method Descriptors）
- 注解类型（Annotation Types）
- 字段类型（Field Types）
- 局部变量表（Local Variable Table）
- 兼容性设计：基于ASM9支持最新Java版本特性
扫一扫
679
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
