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”表示打包的過程中跳過測試。