# agent

**Repository Path**: abd235/agent

## Basic Information

- **Project Name**: agent
- **Description**: java agent
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-19
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# agent

#### 介绍
java agent

一个玩具，用于启动时修改java字节码



#### 软件架构
java agent+asm



```ini
src/main/java/agent: 代码入口
src/main/java/agent/log：日志工具
src/main/java/agent/config：配置
src/main/java/agent/asm：使用asm修改字节码的转换工具

src/test/java：单元测试
src/test/resources：配置文件样例
```




#### 安装教程

​	-javaagent:/path/jar=/path/xml

   参数
       /path/jar: jar的路径
       /path/xml: 是配置文件的路径



#### 配置文件说明

```xml
<root outDir="D:\\tmp" logLevel="DEBUG">

    <!-- outDir：class文件转换后存储的目录 -->
    <!-- logLevel：日志级别 -->

    <init>
        <setProperty>
    		<!-- 系统属性 以:分割 -->
            a:b
            c:d
        </setProperty>
    </init>

    <targetClass save="true" matchMode="equals" value="chenjun.Person">
		<!-- save：是否将转换后的class输出到文件 -->
		<!-- value：要转换的类 -->
		<!-- matchMode：要转换的类的匹配模式， equals:全匹配; pattern:*?模式匹配; -->
        
        
        
        <!-- deleteClassAnnotation：删除类的注解 -->
        <action name="deleteClassAnnotation" skip="false">
            javax.annotation.Resource
        </action>

        <!-- targetMethod：转换类的一个方法 -->
        <targetMethod matchMode="equals" value="setIp" >
            <!-- replaceCode：替换方法体 -->
            <action name="replaceCode">
                aLoad|0
                iConst|1
                putField|chenjun/Person|isIp|Z;
                return
            </action>
        </targetMethod>

        <targetMethod matchMode="equals" value="setIpTestAfter" >
            <!-- insertWhenExit：在方法退出时 插入代码 -->
            <action name="insertWhenExit" whenExceptionAdd="false">
            	<!-- whenExceptionAdd：原字节码中抛出异常的代码throw 是否插入代码 -->
                aLoad|0
                iConst|0
                putField|chenjun/Person|isIp|Z;
            </action>
        </targetMethod>

        <targetMethod matchMode="equals" value="setIpTestAfterWithException" >
            <action name="insertWhenExit" >
                aLoad|0
                iConst|0
                putField|chenjun/Person|isIp|Z;
            </action>
        </targetMethod>

        <targetMethod matchMode="equals" value="setIpTestAfterWithExceptionTrue" >
            <action name="insertWhenExit" whenExceptionAdd="true">
                aLoad|0
                iConst|0
                putField|chenjun/Person|isIp|Z;
            </action>
        </targetMethod>

        <targetMethod matchMode="equals" value="setIpTestBeforeAndAfter" >
            <!-- insertWhenIn：在方法进入时 插入代码 -->
            <action name="insertWhenIn" whenExceptionAdd="false">
                aLoad|0
                iConst|1
                putField|chenjun/Person|isIp|Z;
            </action>
            <action name="insertWhenExit" whenExceptionAdd="false">
                aLoad|0
                iConst|0
                putField|chenjun/Person|isIp|Z;
            </action>
        </targetMethod>

        <targetMethod matchMode="equals" value="setIpTestBefore" >
            <action name="insertWhenIn" whenExceptionAdd="false">
                aLoad|0
                iConst|1
                putField|chenjun/Person|isIp|Z;
            </action>
        </targetMethod>

        <targetMethod matchMode="equals" value="setMessage" >
            <action name="replaceCode">
                aLoad|0
                ldcStr|ccd
                putField|chenjun/Person|message|Ljava/lang/String;
                return
            </action>

            <action name="deleteMethodAnnotation" skip="false">
                javax.annotation.PreDestroy
            </action>
        </targetMethod>

        <targetMethod matchMode="pattern" value="getMess*" >
            <!-- ${USERNAME}：支持获取属性值 -->
            <action name="replaceCode">
                aLoad|0
                ldcStr|xx${USERNAME}yy
                putField|chenjun/Person|message|Ljava/lang/String;

                return
            </action>
        </targetMethod>

    </targetClass>

</root>
```







#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)