项目本来使用sprigboot+serviceComb ,调整项目架构后需要拆分服务,变为springboot+XXX,将服务的cotroller层独立成一个服务,能适应基于springboot的不同微服务架构,我将过程以及碰到的坑记录下来。
1.拆分服务
将一个服务拆为2个模块,service+dao层单独成一个模块,controller层以引入pom文件依赖的方式将service+dao模块引入进来。
拆分完成代码应该是这样的:
controller服务
- src
- main
- java
- com
- …
- controller
- java类
- controller
- …
- com
- java
- main
service+dao模块
- src
- main
- java
- com
- …
- dao/idao/service/iservice
- java类
- dao/idao/service/iservice
- …
- com
- java
- main
而此时,在service+dao模块里是没有yml配置文件和springcloud的pom文件依赖的,yml配置文件和关于springcloud的依赖是在controller模块中,将代码结构拆分开来,当需要用到其他微服务框架时,我们可能需要多个controller层基于不同微服务框架的多个代码模块(引入的pom依赖不同,注解不同),这样拆分后,service+dao模块需要隔一段时间发一次版,但是确实可以适用于不同的微服务框架,
controller模块引入service+dao模块的pom依赖
<dependency>
<groupId>....</groupId>
<artifactId>..server-service</artifactId>
<version>${version}</version>
</dependency>
controller模块去掉cse相关依赖,引入springcloud依赖(展示部分)
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>${spring-cloud.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-commons</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-netflix-core</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-configuration-processor</artifactId>
<optional>true</optional>
</dependency>
</dependencies>
然后就是改报错的地方了(主要是注解:具体注解修改),由于我改的项目还有调用了公司平台提供的方法,所以我得多改点,此处略…
2.碰到的坑
主要的步骤已经完成了,搭建一个eurake服务端,我就开始启服务了,以为结束了,没想到噩梦才刚刚开始…
1.启动报错:service_description.name没有对应的value值
解决方法: 在yml配置文件中加上
service_description.name: your service_name
2.找不到数据源
解决方法:修改启动类配置注解
@SpringBootApplication(exclude={DataSourceAutoConfiguration.class, HibernateJpaAutoConfiguration.class})
3.多个模块相互依赖,注入bean错误
原因:springboot注入bean会扫描项目启动类同级以及同级以下的文件,当有多个项目相互依赖时,最好将项目目录建成一致的,不然可能找不到报错,找不到要注入的bean
eg:
service+dao模块目录
- com
- example
- 二级目录
- …
- 二级目录
- example
controller服务模块目录(controller模块引入了service+dao模块)
controller模块是一个服务,有启动类
- com
- example
- Application.java
- 二级目录
- …
- 二级目录
4.Swagger启动报错,找不到apiVersion版本
解决方法:在yml中添加
#swagger包扫描路径
swagger.scanPackage: com.example
swagger.apiVersion: V1.0.0
5.Swagger测试页面有接口列表,但是测试服务接口报404
原因:Swagger配置类中配置映射关系的方法如下
@Bean
public Docket createRestApi() {// 创建API基本信息
return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo()).select()
//.apis(RequestHandlerSelectors.basePackage("grp.basic"))// 扫描该包下的所有需要在Swagger中展示的API,@ApiIgnore注解标注的除外
.apis(basePackage("com.example1" + splitor + "com.example2"))
.paths(PathSelectors.any()) // 可以根据url路径设置哪些请求加入文档,忽略哪些请求
.build() ;// 在这里可以设置请求的统一前缀
//******************
//****** .pathMapping("/" + name); //*****处理映射
//*******************
}
把最后一行给删了,就能测试的通接口了,当时我被这坑了好长时间
还有一些细节的坑我就不全部列出来了(我不记得了0-0),如有错误,请指正