Fixflow,做中国最好的开源流程引擎!项目地址https://github.com/fixteam/fixflow
项目5.2升级过程中,应大多数用户强烈建议,需要将fixflow-expand项目名称可以修改,所以对代码进行了修改,使项目名称及其他系统配置文件可以修改路径,现将修改步骤整理如下(适用于fixflow5.2版本):
- 修改各项目中fixflow-expand项目名称(fixflow-expand、根目录、fixflow-common-api、fixflow-webapp-common),根据自己项目而定。
- 修改设计器根目录下conf.properties文件 projectName 修改为要修改的项目名,configPath为fixflowconfig.xml文件在项目中的物理路径。
对于5.2 maven版本,此时应该就能正常运行,如果是其他版本代码,或者不是maven结构,请参考以下文档。
原理分析:
设计器:
- 设计器启动时会读取根目录下conf.properties文件,这里告诉设计器去哪里读取fixflowconfig.xml文件。
- 设计器会根据fixflowconfig.xml中的resourcePathConfig节点中的其他配置文件的路径(ProjectName+virtualPath)
web端:
- 引擎启动时会先从web-Info/classes目录找fixflowconfig.xml文件,如果没找到,则使用web-Info/classes/config/fixflowconfig.xml文件,两个文件同时存在时以根目录优先。
- 根据fixflowconfig.xml中的resourcePathConfig节点中src属性加载其他系统配置文件。
综上原理:
如果想改动项目名称,需要保证以下几点:
- 首先保证设计器根目录下配置的fixflowconfig.xml文件路径正确,这是设计器加载其他配置文件的基础。
- 需要保证fixflowconfig.xml文件发布到web-Info/classes或web-Info/classes/config文件夹下,保证web能访问fixflowconfig.xml基础文件。
- 保证fixflowconfig.xml中resourcePathConfig中的projectName和virtualPath属性下能找到对应文件,保证设计器能加载其他资源文件。
- 保证fixflowconfig.xml中resourcePathConfig中的src文件能发布到对应目录下,保证web能加载其他配置文件。
只要做到以上四点,修改项目名称就能成功!如果出现错误,请对照上述4点检查即可。
附注:resourcePathConfig节点属性说明:
id:唯一值
name:说明
projectName :工程名称(设计器使用)
virtualPath :虚拟路径(设计器使用)
src :发布相对路径(对应web中web-Info/classes/***)
physicalPath :物理路径(目前只有web设计器使用)