FixFlow项目fixflow-expand项目名称修改方法

Fixflow,做中国最好的开源流程引擎！项目地址https://github.com/fixteam/fixflow

 

项目5.2升级过程中，应大多数用户强烈建议，需要将fixflow-expand项目名称可以修改，所以对代码进行了修改，使项目名称及其他系统配置文件可以修改路径，现将修改步骤整理如下（适用于fixflow5.2版本）：

 

1. 修改各项目中fixflow-expand项目名称（fixflow-expand、根目录、fixflow-common-api、fixflow-webapp-common），根据自己项目而定。
2. 修改设计器根目录下conf.properties文件 projectName 修改为要修改的项目名，configPath为fixflowconfig.xml文件在项目中的物理路径。

对于5.2 maven版本，此时应该就能正常运行，如果是其他版本代码，或者不是maven结构，请参考以下文档。

 

原理分析：

 

设计器：

1. 设计器启动时会读取根目录下conf.properties文件，这里告诉设计器去哪里读取fixflowconfig.xml文件。
2. 设计器会根据fixflowconfig.xml中的resourcePathConfig节点中的其他配置文件的路径（ProjectName+virtualPath）

web端：

1. 引擎启动时会先从web-Info/classes目录找fixflowconfig.xml文件，如果没找到，则使用web-Info/classes/config/fixflowconfig.xml文件，两个文件同时存在时以根目录优先。
2. 根据fixflowconfig.xml中的resourcePathConfig节点中src属性加载其他系统配置文件。

综上原理：

如果想改动项目名称，需要保证以下几点：

1. 首先保证设计器根目录下配置的fixflowconfig.xml文件路径正确，这是设计器加载其他配置文件的基础。
2. 需要保证fixflowconfig.xml文件发布到web-Info/classes或web-Info/classes/config文件夹下，保证web能访问fixflowconfig.xml基础文件。
3. 保证fixflowconfig.xml中resourcePathConfig中的projectName和virtualPath属性下能找到对应文件，保证设计器能加载其他资源文件。
4. 保证fixflowconfig.xml中resourcePathConfig中的src文件能发布到对应目录下，保证web能加载其他配置文件。

只要做到以上四点，修改项目名称就能成功！如果出现错误，请对照上述4点检查即可。

 

附注：resourcePathConfig节点属性说明：

id：唯一值

name：说明

projectName ：工程名称（设计器使用）

virtualPath ：虚拟路径（设计器使用）

src ：发布相对路径（对应web中web-Info/classes/***）

physicalPath ：物理路径（目前只有web设计器使用）