用途:为使用 tinystruct Java 框架开发模块提供架构与实现模式指引,适用于维护 tinystruct 代码库或基于它的项目。
主要能力:核心原则是 CLI 与 HTTP 对等,带 @Action 的方法应能同时从终端和浏览器运行,无需 main()、配置极少。路由由 ActionRegistry 处理,自动映射路径段到方法参数并注入依赖;应用通过继承 AbstractApplication 创建,提供 init() 等生命周期钩子与 Context 请求状态。数据服务使用原生 Builder/Builders 做 JSON 序列化;数据层用 AbstractData POJO 配合 @Table/@Column 或 XML 映射,database.autocreate=true 可自动建缺失表;支持 SSE(SSEPushManager)、multipart 文件上传、URLRequest/HTTPHandler 外发请求。1.7.0 起内置 MCP 支持,通过继承 MCPTool/MCPServer 并以 @Action、@Argument 声明工具与参数,可含同名重载方法(schema 合并、按序路由)。
使用方式:默认优先用 bin/dispatcher 运行、测试、调试任何 @Action,例如 bin/dispatcher greet/James --import com.example.MyService;需要 Web 侧时再执行 bin/dispatcher start --import org.tinystruct.system.HttpServer。启动器由框架生成而非手写:按 pom.xml 中的 tinystruct 版本运行 java -cp ...tinystruct-<version>.jar org.tinystruct.system.Dispatcher --version,会在 bin/ 生成对应平台脚本(Linux/macOS 生成 bin/dispatcher,Windows 生成 bin\dispatcher.cmd),需在各平台分别生成并提交,建议配置 .gitattributes 保留行尾。--import 每个类一次,逗号分隔会失败;也可在 application.properties 用 default.import.applications 配置。
限制与注意事项:Windows 用 bin\dispatcher.cmd,Git Bash/MSYS 下 shell 脚本会因 classpath 用冒号连接而报 ClassNotFoundException;JAVA_HOME 必须设置;默认只把 tinystruct jar 放进 classpath,其他模块与依赖需放入 lib/;MCP 工具返回值会进入模型上下文,必须校验并净化调用方参数以防提示注入。未提及具体收费、平台或其他信息,暂未提供。