9.8
/ 10
CRITICAL
CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H
Description
# one-java-agent
[](https://search.maven.org/search?q=g:com.alibaba%20AND%20a:one-java-agent*)
[](http://isitmaintained.com/project/alibaba/one-java-agent "Average time to resolve an issue")
[](http://isitmaintained.com/project/alibaba/one-java-agent "Percentage of issues still open")
## 目标
1. 提供插件化支持，统一管理众多的Java Agent
2. 插件支持install/unstall，需要插件方实现接口
3. 支持传统的java agent，即已经开发好的java agent
## 插件系统
插件如果希望感知生命周期，可以实现 `PluginActivator`接口：
```java
public interface PluginActivator {
// 让插件本身判断是否要启动
boolean enabled(PluginContext context);
public void init(PluginContext context) throws Exception;
/**
* Before calling this method, the {@link PluginState} is
* {@link PluginState#STARTING}, after calling, the {@link PluginState} is
* {@link PluginState#ACTIVE}
*
* @param context
*/
public void start(PluginContext context) throws Exception;
/**
* Before calling this method, the {@link PluginState} is
* {@link PluginState#STOPPING}, after calling, the {@link PluginState} is
* {@link PluginState#RESOLVED}
*
* @param context
*/
public void stop(PluginContext context) throws Exception;
}
```
## 传统的java agent
插件目录下面放一个`plugin.properties`，并且放上原生的agent jar文件。
例如：
```
type=traditional
name=demo-agent
version=1.0.0
agentJarPath=demo-agent.jar
```
则 one java agent会启动这个`demo-agent`。
## 编译开发
* 本项目依赖 bytekit: https://github.com/alibaba/bytekit ，可能需要先`mvn clean install` bytekit
* 执行测试： `mvn clean package -DskipTests && mvn test`
* `mvn clean package -P local -DskipTests`会打包后安装最新到本地 `~/oneoneagent` 目录下
[](https://search.maven.org/search?q=g:com.alibaba%20AND%20a:one-java-agent*)
[](http://isitmaintained.com/project/alibaba/one-java-agent "Average time to resolve an issue")
[](http://isitmaintained.com/project/alibaba/one-java-agent "Percentage of issues still open")
## 目标
1. 提供插件化支持，统一管理众多的Java Agent
2. 插件支持install/unstall，需要插件方实现接口
3. 支持传统的java agent，即已经开发好的java agent
## 插件系统
插件如果希望感知生命周期，可以实现 `PluginActivator`接口：
```java
public interface PluginActivator {
// 让插件本身判断是否要启动
boolean enabled(PluginContext context);
public void init(PluginContext context) throws Exception;
/**
* Before calling this method, the {@link PluginState} is
* {@link PluginState#STARTING}, after calling, the {@link PluginState} is
* {@link PluginState#ACTIVE}
*
* @param context
*/
public void start(PluginContext context) throws Exception;
/**
* Before calling this method, the {@link PluginState} is
* {@link PluginState#STOPPING}, after calling, the {@link PluginState} is
* {@link PluginState#RESOLVED}
*
* @param context
*/
public void stop(PluginContext context) throws Exception;
}
```
## 传统的java agent
插件目录下面放一个`plugin.properties`，并且放上原生的agent jar文件。
例如：
```
type=traditional
name=demo-agent
version=1.0.0
agentJarPath=demo-agent.jar
```
则 one java agent会启动这个`demo-agent`。
## 编译开发
* 本项目依赖 bytekit: https://github.com/alibaba/bytekit ，可能需要先`mvn clean install` bytekit
* 执行测试： `mvn clean package -DskipTests && mvn test`
* `mvn clean package -P local -DskipTests`会打包后安装最新到本地 `~/oneoneagent` 目录下
Basic Information
ID
91255BC8-23AA-5E69-8182-76128154DDB6
Published
Aug 16, 2025 at 13:26