1. 背景

历史项目使用Dubbo进行服务构建,并基于Spring集成了一些所需的开源组件。

在考虑新一轮的架构目标时,我们基于Dubbo和SpringCloud分别进行了方案规划,并结合自身状况评估后发现,基于Dubbo进行架构升级时,部分组件的集成或研发成本太大,而SpringCloud的生态系统则能够以较低的成本满足新的架构诉求。我们最终决定将整体的技术栈转换为SpringCloud,并对已有的业务系统进行迁移。

1.1 Dubbo工程现状概要

关键依赖版本

JDK 1.8 、Dubbo 2.5.3 、Spring 4.3.8

工程结构

使用maven构建,采用dubbo通用套路。

user

user-api dubbo接口

user-service 服务实现

pom.xml

配置管理

运维配置写入文件,通过profile管理dev/test/mo/prod环境;业务配置使用自研配置系统管理。

Spring配置

绝大部分组件集成均使用spring的xml配置方式,并对xml文件进行了一定的切分。如:spring-dubbo.xml、spring-beans.xml、spring-*.xml。

Dubbo接口规范

返回数据进行了统一封装,入参过多时使用封装对象提交 。

Response<Integer> commitResourceDymaic(ResourceDymaic resourceDymaic);

1.2 迁移目标

1,使用springcloud的eureka、config、zuul构建基础架构,dubbo项目迁移到新架构中。

2,使用springboot+core(自研框架核心包)作为基础框架。初步阶段完成对已有项目的springboot集成调整,最终全面使用springboot与core统一实现AutoConfig。



2. 准备工作

2.1 dubbo快速集成验证springboot

如果有项目已经集成了springboot,并开始使用它所提供的start来自动装配,那么该步骤可以就此略过。

而对于还未集成spirngboot的项目,实施改造并没有看起来的那么复杂。单纯的集成springboot框架,仅完成以下调整就足够了,在改造前期,可以通过这种方式快速对项目进行依赖和配置的梳理调整。

maven依赖中父工程pom文件

<dependencyManagement>
 <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-dependencies</artifactId>
 <version>${spring.boot.version}</version>
 <type>pom</type>
 <scope>import</scope>
 </dependency>
</dependencyManagement>
<build>
 <plugins>
 <plugin>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-maven-plugin</artifactId>
 <executions>
 <execution>
 <goals>
 <goal>repackage</goal>
 </goals>
 </execution>
 </executions>
 </plugin>
 </plugins>
</build>

dubbo的service工程pom文件

<dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-web</artifactId>
</dependency>

添加启动类和配置文件,在service的相应package下添加springboot启动类。

@SpringBootApplication
public class ApplicationSupport {
 public static void main(String[] args) {
 SpringApplication.run(ApplicationSupport.class, args);
 }
}

在resources下新增application.yml

spring:
 application:
 name: user

替换原项目启动方式,废弃原web.xml等配置文件,在启动类中通过注解加载spring的xml配置。

@ImportResource("classpath:spring-root.xml")

2.2 集成springboot

我们的最终目标中包含springboot框架来简化开发,例如使用springboot内置及dubbo等外部提供的一些starter,不过实际上他们与迁移并无依赖或冲突干扰,可以按照实际状况

进行基础的AutoConfig。

在初次集成时尽可能使用自动装配,去掉spring的xml配置。

使用@EnableTransactionManagement,@ComponentScan等注解取代xml相关配置;

使用dubbo-spring-boot-starter及注解取代dubbo的xml配置,git地址

maven依赖

<dependency>
 <groupId>com.alibaba.boot</groupId>
 <artifactId>dubbo-spring-boot-starter</artifactId>
 <version>0.1.0</version>
</dependency>

自定义注解及AutoConfig取代三方组件的xml配置,例如elasticjob

@Configuration
@ConditionalOnClass(ElasticJob.class)
public class ElasticJobAutoConfig {
 @Autowired
 private ConfigurableApplicationContext configurableContext;
 @Bean(initMethod = "init")
 public ZookeeperRegistryCenter zookeeperRegistryCenter(@Value("${job.reg.address}") final String serverList, @Value("${job.reg.namespace}") final String namespace) {
 return new ZookeeperRegistryCenter(new ZookeeperConfiguration(serverList, namespace));
 }
}

2.3 搭建springcloud基础服务

部署config、eureka、zuul,有大量的资料供参考实施,略过。

在集成springboot后的项目上引入springcloud,完成eureka、config的相关配置,略过。



三、服务迁移

在准备工作中,我们已经完成了对工程的调整并接入springcloud,服务在保持dubbo正常工作的基础上,同时能够连接到eureka进行服务提供。接下来,服务迁移的核心包含两部分:

1,使原有的dubbo服务提供Restful规范接口

2,服务调用方接入调整

3.1 dubbo与springcloud独立共存方案

初始状态结构

共存状态结构:保持原dubbo的service实现不变,额外基于service改造提供Restful接口。

该方式能够最大程度保证原服务稳定运行,但会额外增加开发成本,长期保持共存也容易导致消费方的调用混乱。

 

 

3.2 基于Feign的切换方案

修改原dubbo provider,同时向dubbo registry和eureka注册相同服务。

修改原dubbo consumer,根据配置方式支持dubbo或http调用。

切换过程中,服务状态如下:

 

 

具体实现思路:

1,修改原dubbo服务定义的api接口,支持feign调用。

@FeignClient("demo")
public interface DemoService {
 @RequestMapping(value = "/{version}/pt/demos/{appId}", method = RequestMethod.GET)
 Response<Integer> post(@PathVariable("appId") String appId);
}

2,修改原dubbo服务的实现类,添加@RestController对外提供Restful接口

@Service
@RestController
public class DemoServiceImpl implements DemoService {
 @Override
 public Response<Integer> post(String appId) {
 return null;
 }
}

3,消费者切换调用方式,如果原dubbo消费者使用了@Refrence注解,直接更改为@Autowoired即可。若使用了xml配置refrence则注解即可。

@Reference
private DemoService demoService;
//更改为
@Autowired
private DemoService demoService;

存在的问题:spring MVC不支持继承接口中方法参数的组件,dubbo接口转换Restful接口时可能无法适应等。

欢迎工作一到五年的Java工程师朋友们加入Java架构开发:855801563

群内提供免费的Java架构学习资料(里面有高可用、高并发、高性能及分布式、Jvm性能调优、Spring源码,MyBatis,Netty,Redis,Kafka,Mysql,Zookeeper,Tomcat,Docker,Dubbo,Nginx等多个知识点的架构资料)合理利用自己每一分每一秒的时间来学习提升自己,不要再用"没有时间“来掩饰自己思想上的懒惰!趁年轻,使劲拼,给未来的自己一个交代