本文描述了开发 eMP 服务应用程序的通用步骤,本文的前提是 eMP 开发环境已经配置完成,请参考上一篇博文 “eMP 开发环境配置说明”。
环境确认
- JDK 环境,需要JDK1.8及以上版本,Path变量已经添加JDK主目录。
- Maven 环境,需要 Maven3 及以上版本,Path 变量已经添加 Maven 主目录,并且明确私服的地址,可以部署模块到私服上。
- Git 环境,安装了 Git 和 TortoiseGit 明确 Git 仓库地址,能够正常克隆、更新、提交、推送代码。
- IDE 环境,配置了Maven环境,部分偏好设置(如:文件编码等)配置完成。
以上环境确认无误方可进行以下操作。
创建步骤
克隆 emp 项目
- 在磁盘上新建一个文件夹作为开发目录(建议目录层次不要太深)。
- 单击鼠标右键,选择“TortoiseGit克隆”,正确输入版本库的地址,如:http://172.16.10.13/EMP/emp.git 克隆 emp 代码到本地。
- 切换分支,默认处于 Master 分支,可根据需要切换。
打开 emp 项目
- 启动 InteliJ IDEA ,选择 “open” 定位到 emp 的开发目录中的 pom.xml ,选择作为“project”打开。
- emp 打开后 IDEA 会进行自动配置和文件扫描,可能会联网下载依赖的组件,请保证网络畅通。
- IDEA 扫描完成后,在“Maven Project”窗口中点击“同步”按钮同步所有模块的依赖组件。
新建模块
- 右键单击“Project”的根目录,选择“New”-“Module”打开新建模块窗口,选择“Maven”,勾选“Create from archetype”,在原型列表中找到“emp-service-base-archetype”原型。
- 如果没有找到指定的原型,点击“Add Archetype…”添加原型,输入原型的坐标信息点击“OK”即可。
- 下一步中,选择模块的“Parent”为“emp-app-parent”,输入 ArtifactId,如:emp-service-test。
- 下一步中,确定“Maven”信息无误,直接点击“next”进入下一步。
- 正确命名模块名称及保存目录,完成模块创建。
配置模块
- 标识文件夹类型,打开 emp-service-test 模块,选择“java”目录,右键单击,选择“Make directory as”-“Source root”,将“java”目录转换为源代码主目录,同样将“resources”目录转换为资源主目录(“Resource root”)。
- 重命名启动类,选择“EmpServiceApplication”,右键单击,选择“Rafactor”-“Rename…”,修改类名为“EmpServiceTestApplication”,勾选“Rename variables”和“Rename inheritors”两项,点击“Rafactor”即可。
- 修改服务端口,打开模块配置文件“application.properties”,修改“service.port”配置项,给服务指定一个默认端口。
- 修改接口文档说明,打开“SwaggerConfig”,修改部分说明即可。
打包模块
打开控制台,输入命令:
mvn package -pl emp-service-test -am -DskipTests
其中,“-pl”指定需要打包的模块,“-am”表示打包所依赖的模块,“-DskipTests”表示打包的过程中跳过测试。