# sim-behavior-groovy-engine

**Repository Path**: sim-behavior/sim-behavior-groovy-engine

## Basic Information

- **Project Name**: sim-behavior-groovy-engine
- **Description**: 行为节点业务解析器
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# sim-behavior-groovy-engine
## 项目简介
sim-behavior-groovy-engine是仿真行为节点体系的独立Groovy脚本执行引擎，基于Java开发，专门承载所有差异化业务逻辑，实现业务逻辑与sim-behavior-core-kernel内核的完全解耦。支持脚本热加载、沙箱隔离执行、版本快照回滚，适配内核标准接口，为整个行为节点体系提供灵活、高效、安全的业务逻辑执行能力，无需重启服务即可完成业务逻辑更新。
## 核心功能
1.  **脚本隔离执行**：基于沙箱机制，单脚本故障互不影响，保障引擎稳定运行
2.  **脚本热加载**：实时监听脚本文件变更，修改后秒级生效，无需重启服务
3.  **脚本缓存优化**：缓存编译后的脚本，减少重复编译耗时，提升执行性能
4.  **版本管理**：支持脚本版本快照、一键回滚，记录版本变更记录，适配并行调试
5.  **安全管控**：封装内核只读安全API，禁止脚本调用高危操作，保障内核安全
6.  **内核适配**：严格实现sim-behavior-core-kernel的标准接口，实现与内核生命周期联动
## 技术栈
- Java 8+
- Groovy 3.x
- Spring Core
- Maven
- Junit 5
## 项目结构
src/main/java/com/sim/behavior/groovy/engine
├── api/ # 适配接口层（对接核心内核）
├── core/ # 核心执行层
│   ├── sandbox/ # 脚本沙箱隔离
│   ├── cache/ # 脚本缓存
│   ├── loader/ # 脚本热加载
│   ├── version/ # 脚本版本管理
│   ├── executor/ # 脚本执行器
├── config/ # 引擎配置类
├── exception/ # 脚本执行异常
├── util/ # 工具类
├── template/ # Groovy脚本标准模板
src/test/java # 单元测试
## 环境要求
- JDK 8及以上
- Maven 3.6及以上
- Groovy 3.x（Maven自动依赖，无需手动安装）
## 编译与安装
1.  克隆仓库至本地
2.  确保sim-behavior-core-kernel已打包安装至本地仓库
3.  执行Maven打包命令：`mvn clean install -DskipTests`
4.  打包完成后，作为依赖引入sim-behavior-admin-web仓库，供管理平台调用
## 依赖引入
在sim-behavior-admin-web的pom.xml中添加以下依赖：
<dependency>
    <groupId>com.sim.behavior</groupId>
    <artifactId>sim-behavior-groovy-engine</artifactId>
    <version>1.0.0</version>
</dependency>
## 快速使用
1.  在template目录获取Groovy脚本标准模板，编写自定义业务逻辑
2.  配置脚本目录，启动脚本监听机制
3.  通过sim-behavior-admin-web平台在线编辑、保存脚本，自动热生效
4.  如需回滚脚本，通过版本管理功能一键恢复至历史稳定版本
## 注意事项
1.  本仓库依赖sim-behavior-core-kernel，需先部署核心内核，确保版本一致
2.  脚本编写需遵循标准模板，仅可调用封装的安全API，禁止调用高危操作
3.  脚本执行超时时间、沙箱权限可通过配置文件调整
4.  热加载仅针对脚本文件变更，引擎配置变更需重启服务
## 版本管理
- 当前版本：1.0.0
- 版本迭代：遵循语义化版本规范，与sim-behavior-core-kernel版本保持一致
- 兼容要求：需与sim-behavior-core-kernel、sim-behavior-admin-web版本同步