# 后端项目二次开发说明
# AFCENTER后端项目发开
# 1.修改maven配置
使用idea打看afcenter后端源代码项目后,配置正确的Maven的settings文件与仓库目录地址;
# 2.修改相关源码配置文件
打开 com.primeton.gocom.afcenter.boot模块,找到src/META-INF/_srv/config/user-config.xml文件;找到数据库连接配置修改为自己的数据库连接配置即可;
833版本检查user-config.xml中更新白名单配置如下;
<configValue key="Exclude">/api/afc/afc-proxy/employee/query-employee-orgs-by-emp-ids,/api/afc/user/validation-code,/api/afc/login,/api/afc/validation-code,/api/afc/login/password/key,/api/afc/login/clientId,/api/afc/login/third-party/qrConnect,/api/afc/login/third-party/mobile/authorize,/api/afc/login/third-party/auth,/api/afc/login/web/third-party/auth,/api/afc/login/third-party/types,/api/afc/login/third-party/validate,/api/afc/oauth2/*,/swagger-ui.html,/v2/api-docs,/webjars/*,/swagger-resources/*,/api/afc/job/api/*,/api/afc/preferences/info/*,/api/lowcode/resources/*/runtimes,/api/taskcenter/push-task/*,/api/lowcode/shares/actions/*,/api/afc/materials/font/*,/api/afc/component-centers,/actuator/*,/api/afc/components/*,/api/eos/hotupdates,/api/eos/tools/actions/call-method</configValue>
properties配置文件中添加如下配置:
application.properties:
# 关闭健康检查
management.health.redis.enabled=false
# 开启swagger-ui文档
springfox.documentation.auto-startup=true
application-afc.properties:
# 配置缓存设置
afc.web.resources.cache.location.paths=/
afc.web.resources.cache.no-cache-files=/no-cache-files
# 3.下载maven依赖并编译项目
点击右侧maven工具栏,展开后点击刷新图标;下载maven依赖,该过程第一次下载可能比较漫长,请耐心等待;或者直接使用产品发布的maven仓库即可无需下载;
maven工具操作区中打开afcenter项目目录,Lifecycle中依次次点击clean,install编译项目;
# 4.启动项目
编译通过后,点击idea项目启动按钮,即可启动项目;浏览器访问localhost:8081/swagger-ui.html,出现一下页面即为启动成功。
# 5.开发调试
后续可根据业务需求对afcenter源码就行二次开发,开发后需要对接口进行测试时,可部署前端介质通过nginx代理到当前服务后(nginx配置文件可参考发版nginx配置文件*.conf文件),访问前端页面登录后获取请求头中的token,进行postman接口测试即可。
# 6.项目打包
开发调试通过后,可在本地执行maven的clean、install操作(同步骤3),编译后的afcenter依赖会生成到maven仓库中,使用打包框架afcenterall进行步骤3操作,在boot目录的target文件夹下即可获得打包生成的afcenter的运行jar与项目整包。
注:另外根据项目需要,如只是简单修改afcenter的原有接口实现,或者添加新的接口,也可以通过打增量补丁jar的形式,把生成的补丁jar放置在afcenter后端介质的lib目录下启动即可。
# BFP后端项目开发
1.修改源码:根据业务需求修改BFP后端源码(BFP作为依赖库使用,无独立启动模块,无需配置参数或启动,参考AFCENTER后端项目)。
2.编译打包:编译BFP源码并打包。
3.整体打包:使用afcenterall打包框架重新打包。
若为自定义微服务或Express精简版项目:
修改AFCENTER和BFP源码并编译。在自定义项目中刷新Maven依赖。重新打包自定义项目。