eMP 服务开发说明

本文描述了开发 eMP 服务应用程序的通用步骤，本文的前提是 eMP 开发环境已经配置完成，请参考上一篇博文 “eMP 开发环境配置说明”。

环境确认

1. JDK 环境，需要JDK1.8及以上版本，Path变量已经添加JDK主目录。
2. Maven 环境，需要 Maven3 及以上版本，Path 变量已经添加 Maven 主目录，并且明确私服的地址，可以部署模块到私服上。
3. Git 环境，安装了 Git 和 TortoiseGit 明确 Git 仓库地址，能够正常克隆、更新、提交、推送代码。
4. IDE 环境，配置了Maven环境，部分偏好设置（如：文件编码等）配置完成。

以上环境确认无误方可进行以下操作。

创建步骤

克隆 emp 项目

1. 在磁盘上新建一个文件夹作为开发目录（建议目录层次不要太深）。
2. 单击鼠标右键，选择“TortoiseGit克隆”，正确输入版本库的地址，如：http://172.16.10.13/EMP/emp.git 克隆 emp 代码到本地。
3. 切换分支，默认处于 Master 分支，可根据需要切换。

打开 emp 项目

1. 启动 InteliJ IDEA ，选择 “open” 定位到 emp 的开发目录中的 pom.xml ，选择作为“project”打开。
2. emp 打开后 IDEA 会进行自动配置和文件扫描，可能会联网下载依赖的组件，请保证网络畅通。
3. IDEA 扫描完成后，在“Maven Project”窗口中点击“同步”按钮同步所有模块的依赖组件。

新建模块

1. 右键单击“Project”的根目录，选择“New”-“Module”打开新建模块窗口，选择“Maven”，勾选“Create from archetype”，在原型列表中找到“emp-service-base-archetype”原型。
2. 如果没有找到指定的原型，点击“Add Archetype…”添加原型，输入原型的坐标信息点击“OK”即可。
3. 下一步中，选择模块的“Parent”为“emp-app-parent”，输入 ArtifactId，如：emp-service-test。
4. 下一步中，确定“Maven”信息无误，直接点击“next”进入下一步。
5. 正确命名模块名称及保存目录，完成模块创建。

配置模块

1. 标识文件夹类型，打开 emp-service-test 模块，选择“java”目录，右键单击，选择“Make directory as”-“Source root”，将“java”目录转换为源代码主目录，同样将“resources”目录转换为资源主目录（“Resource root”）。
2. 重命名启动类，选择“EmpServiceApplication”，右键单击，选择“Rafactor”-“Rename…”，修改类名为“EmpServiceTestApplication”，勾选“Rename variables”和“Rename inheritors”两项，点击“Rafactor”即可。
3. 修改服务端口，打开模块配置文件“application.properties”，修改“service.port”配置项，给服务指定一个默认端口。
4. 修改接口文档说明，打开“SwaggerConfig”，修改部分说明即可。

打包模块

打开控制台，输入命令：

mvn package -pl emp-service-test -am -DskipTests

其中，“-pl”指定需要打包的模块，“-am”表示打包所依赖的模块，“-DskipTests”表示打包的过程中跳过测试。