新建微服務工程 · SpringBlade開發手冊

## 模塊介紹框架的模塊結構如下： ``` SpringBlade ├── blade-auth -- 授權服務提供 ├── blade-common -- 常用工具封裝包 ├── blade-gateway -- Spring Cloud 網關 ├── blade-ops -- 運維中心 ├ ├── blade-admin -- spring-cloud后臺管理 ├ └── blade-develop -- 代碼生成 ├── blade-service -- 業務模塊 ├ ├── blade-desk -- 工作臺模塊 ├ ├── blade-log -- 日志模塊 ├ ├── blade-system -- 系統模塊 ├ └── blade-user -- 用戶模塊 ├── blade-service-api -- 業務模塊api封裝 ├ ├── blade-desk-api -- 工作臺api ├ ├── blade-dict-api -- 字典api ├ ├── blade-system-api -- 系統api └── └── blade-user-api -- 用戶api ``` 日常開發中，我們用的最多的模塊則是`blade-service`以及` blade-service-api`. * ` blade-service`主要編寫業務模塊 * ` blade-service-api`主要為其他業務模塊提供本模塊的api 那么目的很明確了，要開發一個業務模塊，我們就需要到`blade-service`以及` blade-service-api`中新建相關的代碼啦！下面我們就開始重要的第一步：子工程的新建 ## 新建子工程 1. 在`blade-service`上右擊依次選則 `New -> Module` ![](https://box.kancloud.cn/66b71feaeda565193cafa1a7be3e4e9e_871x448.png) 2. 在`New Module`界面選中左側的`Maven`并且點擊`Next` ![](https://box.kancloud.cn/d743961e491757a8283523e4c1049e97_743x598.png) 3. 接著我們可以給`ArtifactId`起個名，這里使用了`blade-demo`(大家可以根據實際的業務模塊命名) ![](https://box.kancloud.cn/c50157f196ea121989206747a91fe046_743x598.png) 4. 下一步推薦`Module name`命名的和`ArtifactId`一致 ![](https://box.kancloud.cn/ff010ee646e3cce5901ffe9dd1a3613b_743x598.png) 5. 點擊`Finish`等待maven工程加載完畢 6. 我們以同樣的方式在`blade-service-api`下新建`blade-demo-api`工程 ![](https://box.kancloud.cn/94c594087c093c89367cdcf3cf6c26e6_355x359.png) ## 工程版本依賴設置 1. 打開`blade-demo-api`工程下的`pom.xml`設置基本信息加上紅框內的信息 ![](https://box.kancloud.cn/282bcc6fd8d030e2d3e3addc6f99df54_642x399.png) 2. 打開`blade-demo`工程下的`pom.xml`設置基本信息加上紅框內的信息 ![](https://box.kancloud.cn/a70f0564f35c7cfec898a92e9ea2e68c_607x618.png) 3. 以下依賴為剛剛新建的`blade-demo-api`工程，代碼組成主要是entity，vo，dto，feign等模塊 ~~~ <dependency> <groupId>org.springblade</groupId> <artifactId>blade-demo-api</artifactId> <version>${blade.project.version}</version> </dependency> ~~~ 4. 以下依賴為[Blade-Tool](https://github.com/chillzhuang/blade-tool.git)封裝的模塊啟動依賴，只需引入一個，便解決了所有常用的配置 ~~~ <dependency> <groupId>org.springblade</groupId> <artifactId>blade-core-boot</artifactId> <version>${blade.tool.version}</version> </dependency> ~~~ 5. **商業版采用了bom架構，將所有固定的版本統一管理，自動依賴，無需再配置bladex-tool內的版本，具體引用如下** ~~~ <dependency> <groupId>org.springblade</groupId> <artifactId>blade-core-boot</artifactId> </dependency> ~~~ ## 工程配置 1. 參考`blade-desk`模塊，將`resource`下的文件拷貝到`blade-demo`的`resources`文件夾下 ![](https://box.kancloud.cn/2f2c23839af214f6444ac2980405b382_449x466.png) 2. 修改下`application-dev.yml`下`server.port`的值為9101(可以定義為其他端口，但必須不沖突) ![](https://box.kancloud.cn/aa817aeac2b80806815bc18c0c6fd2b5_1031x369.png) 3. 在`blade-demo`的`java`包下新建`package` ![](https://box.kancloud.cn/5442a98aa45e834695e4ab86bfccc103_825x407.png) 4. 推薦命名為`org.springblade.demo` ![](https://box.kancloud.cn/82a62d018f80e316172a7a7710f28743_453x145.png) 5. 參考`blade-desk`模塊，將`DeskApplication`拷貝至剛新建的包下并重命名為`DemoApplication` ![](https://box.kancloud.cn/47a674fc1c72e28eb714c4b7e4a13d62_396x556.png) 6. 修改對應代碼(后續會詳細介紹) ![](https://box.kancloud.cn/da3103481bf7112067c083f12661ff58_749x347.png) 7. 為了讓代碼更加優雅，我們可以到`blade-common`模塊的`CommonConstant`下新建常量 ![](https://box.kancloud.cn/2dbfdcab98b69b79a1a2f0d4cff794b4_735x327.png) 8. 再次修改`DemoApplication` ![](https://box.kancloud.cn/808c7ce63ff4dd3aa264cb4e7e0e88e1_865x281.png) 9. 右擊`DemoApplication`啟動，查看服務是否注冊到了`Nacos`. 10. 我們先啟動Demo服務，并訪問 http://localhost:8848/nacos 查看效果 11. 如果我們看到blade-demo在注冊列表中，說明一個新的微服務已經誕生！