gitegg-cloud是微服务框架,整体功能是非业务相关的基础功能,在实际业务开发过程中需要新建微服务的业务模块,根据业务的整体规划,设计新建Maven子工程。
下面以常用的电商项目举例新建Maven子工程,电商项目一般包含商品微服务,订单微服务,支付微服务,账户微服务等,我们的整体规划是将电商项目作为一个整体的微服务Maven父工程,商品微服务,订单微服务,支付微服务,账户微服务作为电商项目的子工程,微服务之间通过Feign相互调用,所以我们在gitegg-cloud下新建gitegg-mall和gitegg-mall-client两个Maven工程。
Maven工程结构
下面以创建gitegg-mall和gitegg-mall-goods为例创建Maven父子工程:
1、在gitegg-cloud工程上点击右键,然后选择:New > Module... ,选择Maven,Create from archetype不要勾选,点击Next进入下一步,填写工程信息。
新建Maven工程
2、填写项目名称,选择工程代码存放路径,GroupId 、ArtifactId、Version,然后点击Finish完成创建。
填写Maven信息
3、因为gitegg-mall工程下面还要存放子模块工程,gitegg-mall也是一个父工程,所以删除工程下用不到的src目录。此时,pom.xml文件中没有节点<packaging>pom</packaging>,这里不需要处理,当创建子工程之后,这里会自动添加此节点。
gitegg-mall父工程
4、同样的方式创建gitegg-mall-client父工程,用于存放微服务之间相互调用的Feign客户端。
gitegg-mall-client
5、创建gitegg-mall第一个子工程gitegg-mall-goods商品微服务,在gitegg-mall工程上点击右键,然后选择:New > Module... > Maven,在Maven窗口点击右键选择org.apache.tapestry:quickstart,在Name处填入子工程名称:gitegg-mall-goods,然后点击Finish,子工程创建完成。
maven-quickstart
gitegg-mall-goods
6、同样的方式创建gitegg-mall-goods-client子工程,用于存放商品微服务之间相互调用的Feign客户端。
gitegg-mall-goods-client
gitegg-mall-goods-client
7、设置项目依赖库,复制gitegg-service下面的pom.xml里面的依赖库配置dependencies,放到gitegg-mall的pom.xml里。
需要复制的内容:
<dependencies><!-- gitegg Spring Boot自定义及扩展 --><dependency><groupId>com.gitegg.platform</groupId><artifactId>gitegg-platform-boot</artifactId></dependency><!-- gitegg Spring Cloud自定义及扩展 --><dependency><groupId>com.gitegg.platform</groupId><artifactId>gitegg-platform-cloud</artifactId></dependency><!-- gitegg数据库驱动及连接池 --><dependency><groupId>com.gitegg.platform</groupId><artifactId>gitegg-platform-db</artifactId></dependency><!-- gitegg mybatis-plus --><dependency><groupId>com.gitegg.platform</groupId><artifactId>gitegg-platform-mybatis</artifactId></dependency><!-- gitegg swagger2-knife4j --><dependency><groupId>com.gitegg.platform</groupId><artifactId>gitegg-platform-swagger</artifactId></dependency><!-- gitegg cache自定义扩展 --><dependency><groupId>com.gitegg.platform</groupId><artifactId>gitegg-platform-cache</artifactId></dependency><dependency><groupId>com.gitegg.platform</groupId><artifactId>gitegg-platform-redis</artifactId></dependency><!-- spring boot web核心包 --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- spring boot 健康监控 --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId></dependency></dependencies>
8、设置项目依赖库和打包配置,复制gitegg-service-client下面的pom.xml里面的依赖库配置dependencies和build内容,放到gitegg-mall-client的pom.xml里。
需要复制的内容:
<dependencies><!-- gitegg Spring Boot自定义及扩展 --><dependency><groupId>com.gitegg.platform</groupId><artifactId>gitegg-platform-boot</artifactId></dependency><!-- gitegg Spring Cloud自定义及扩展 --><dependency><groupId>com.gitegg.platform</groupId><artifactId>gitegg-platform-cloud</artifactId></dependency><!-- gitegg swagger2-knife4j --><dependency><groupId>com.gitegg.platform</groupId><artifactId>gitegg-platform-swagger</artifactId></dependency></dependencies><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><configuration><!--client模块不打可执行的jar包,打普通jar包即可--><skip>true</skip></configuration></plugin><plugin><groupId>com.google.cloud.tools</groupId><artifactId>jib-maven-plugin</artifactId><configuration><!--此模块不打可执行的jar包,打普通jar包即可--><skip>true</skip></configuration></plugin></plugins></build>
9、复制工程配置文件bootstrap.yml、bootstrap-dev.yml、bootstrap-test.yml、bootstrap-prod.yml到gitegg-mall-goods的src/main/resources目录下,gitegg-mall-goods-client不需要这些配置文件,在gitegg-mall-goods的pom.xml中新增打包插件配置。
同样client工程相关的配置也需要参考gitegg-service-client和gitegg-service-system-client里面的pom.xml配置,复制到gitegg-mall-goods和gitegg-mall-goods-client的pom.xml中。
<build><plugins><plugin><groupId>com.google.cloud.tools</groupId><artifactId>jib-maven-plugin</artifactId></plugin></plugins></build>
10、修改bootstrap.yml里面的服务端口配置,修改成一个当前未占用的端口。
修改端口
11、新建微服务启动类GitEggMallApplication,可以直接复制GitEggSystemApplication然后修改内容,包名根据自己规划,这里设置为com.gitegg.mall.goods.brand。
GitEggMallApplication 代码
/*** gitegg-mall 启动类* @author GitEgg*/
@EnableDiscoveryClient
@EnableFeignClients(basePackages = "com.gitegg")
@ComponentScan(basePackages = "com.gitegg")
@SpringBootApplication
public class GitEggMallApplication {public static void main(String[] args) {SpringApplication.run(GitEggMallApplication.class,args);}
}
Maven工程创建好之后,就可以点击GitEggMallApplication 右键运行,测试是否配置正确,后面的操作就是编写具体的增删查改等业务逻辑代码。gitegg-cloud提供代码生成器,下一节介绍说明如何使用代码生成器根据表设计生成前后端代码。