# common-template-tools

**Repository Path**: tbnytbf/common-template-tools

## Basic Information

- **Project Name**: common-template-tools
- **Description**: 模板工具，专注于提供实现快速且灵活的业务功能的工具。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-11-28
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# common-template-tools

#### 介绍
模板工具，专注于提供实现快速且灵活的业务功能的工具。

#### 软件架构
软件架构说明
基本无第三方jar包依赖，基于JDK1.6开发，理论上JDK1.6及以上版本都可以集成使用

#### 安装教程

无需安装，pom直接配置依赖common-templates-service模块即可

#### 使用说明
总共三个模块
common-template-core：核心模块，包含各种模板组件的定义
common-template-service：服务模块：依赖核心模块，基于模板组件的定义来定制各种模板
common-template-samples：样例模块：依赖服务模块，包含使用定制的模板的样例。

### 模板主要组件定义简介
组件大致分类：
1.业务动作组件
1.1 action:普通业务动作组件 - 大部分业务功能开发都是在设计这个组件
1.2 ConditionalAction 条件动作 - 满足条件才会执行的业务动作组件
1.3 CanStopAction 可停止动作 - 动作执行前/后满足停止的条件则模板停止执行。

2.上下文组件
2.1 GlobalContext：全局上下文 包含业务上下文组件和执行上下文组件
    包含组件：BizContext，ExecContext，BaseTemplateModel，ActionActuatorFetchStrategy，ActionDef
2.2 BizContext：业务上下文组件 - 业务功能使用的上下文组件
2.3 ExecContext：执行上下文组件 - 模板执行器组件/业务动作执行器组件使用的上下文

3.动作定义组件
3.1 ActionDef：动作描述 - 包含具体的业务动作组件及业务动作相关的配置
    包含组件：action，ActionActuator，ActionListener（当前动作生效）,ActionRetryConfig

4. 动作重试配置组件
4.1 ActionRetryConfig：动作重试配置组件 - 包含动作重试的配置，比如重试的次数，时间，间隔等

5.动作执行器组件
5.1 ActionActuator:动作执行器组件 - 提供执行action动作的功能
目前提供的动作执行器组件有：
默认动作执行器：DefaultActionActuator
条件动作执行器：ConditionalActionActuator

6.动作执行监听组件
ActionListener:动作执行监听 - 提供动作执行前，执行后，执行异常的处理

7.模板模型组件
7.1 TemplateModel: 模板的模型，
7.2 BaseTemplateModel：目前系统提供一种基础模板
    包含组件：ActionDef，ActionListener（模板配置的所有动作都会生效），TemplateListener

8.动作执行器匹配策略组件
8.1 ActionActuatorFetchStrategy ：动作执行器匹配策略组件 - 指定执行动作的动作执行器
   目前提供一种默认实现：DefaultActionActuatorFetchStrategy
9.模板执行器组件 
9.1 TemplateActuator：模板执行器组件 - 执行全局上下文中定义的模板动作
    目前提供四种执行器，
    串行执行器：SerialTemplateActuator     串行执行模板里面配置的动作
    并行执行器：ParallelTemplateActuator   并行执行模板里面配置的动作
    排他执行器：ExclusiveTemplateActuator  最多执行模板配置里面的一个动作
    组合策略执行器：CombinatorialStrategyTemplateActuator  执行任意个动作，且可以在任意动作执行后停止。

10.模板监听组件
10.1 TemplateListener：模板监听   提供模板执行前，执行后，执行异常的处理