从零开始搭建一套微服务框架(六)集成fescar
关于fescar的介绍,请移步
一、安装fescar服务
从https://github.com/alibaba/fescar/releases下载服务器包,解压缩。
sh fescar-server.sh $ LISTEN_PORT $ PATH_FOR_PERSISTENT_DATA
例如
sh fescar-server.sh 8091 / home / admin / fescar / data /
二、添加依赖
这里使用fescar最新的版本0.3.0
三、添加配置文件
registry.conf
registry {
# file nacos
type = "file"
nacos {
serverAddr = "localhost"
namespace = "public"
cluster = "default"
}
file {
name = "file.conf"
}
}
file.conf
transport {
# tcp udt unix-domain-socket
type = "TCP"
#NIO NATIVE
server = "NIO"
#enable heartbeat
heartbeat = true
#thread factory for netty
thread-factory {
boss-thread-prefix = "NettyBoss"
worker-thread-prefix = "NettyServerNIOWorker"
server-executor-thread-prefix = "NettyServerBizHandler"
share-boss-worker = false
client-selector-thread-prefix = "NettyClientSelector"
client-selector-thread-size = 1
client-worker-thread-prefix = "NettyClientWorkerThread"
# netty boss thread size,will not be used for UDT
boss-thread-size = 1
#auto default pin or 8
worker-thread-size = 8
}
}
service {
#vgroup->rgroup
vgroup_mapping.my_test_tx_group = "localRgroup"
#only support single node
localRgroup.grouplist = "10.8.80.222:9999"
#degrade current not support
enableDegrade = false
#disable
disable = false
}
client {
async.commit.buffer.limit = 10000
lock {
retry.internal = 10
retry.times = 30
}
}
fescar规划是可以使用各种注册中心和配置中心的,但是目前版本还没有支持,配置文件多数为预留项目,主要配置信息在file.conf中的srvice,主要配置项为
localRgroup.grouplist = "10.8.80.222:9999"设置fescar-server的地址
vgroup_mapping.my_test_tx_group = "localRgroup"中的my_test_tx_group为设置的事务组名称
四、与Spring集成
在TM和RM项目中分别创建Spring自动配置文件FescarConfig.java
package cn.ktp.demo.config;
import javax.sql.DataSource;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.transaction.jdbc.JdbcTransactionFactory;
import org.mybatis.spring.SqlSessionFactoryBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Import;
import org.springframework.core.io.support.PathMatchingResourcePatternResolver;
import com.alibaba.druid.pool.DruidDataSource;
import com.alibaba.druid.spring.boot.autoconfigure.DruidDataSourceAutoConfigure;
import com.alibaba.fescar.rm.datasource.DataSourceProxy;
import com.alibaba.fescar.spring.annotation.GlobalTransactionScanner;
/**
* @Author: kris
* @Description fescar全局设置,对数据源进行增强
* @Date Created in 2019/3/14 10:28
*/
@Configuration
@Import(DruidDataSourceAutoConfigure.class)
public class FescarConfig {
/**
* 包装数据源代理,用于在执行SQL之前生成回退日志
* @Param: druidDataSource datasource bean instance
* @Return: DataSourceProxy datasource proxy
*/
@Bean
public DataSourceProxy dataSourceProxy(DataSource druidDataSource){
return new DataSourceProxy((DruidDataSource)druidDataSource);
}
/**
* 替换 mybatis 的sqlSessionFactory,用数据源代理替换自动装配的数据源
* @Param: dataSourceProxy fescar数据源代理
* @Return: SqlSessionFactory mybatic使用的数据源
*/
@Bean
public SqlSessionFactory sqlSessionFactory(DataSourceProxy dataSourceProxy) throws Exception {
SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
factoryBean.setDataSource(dataSourceProxy);
factoryBean.setMapperLocations(new PathMatchingResourcePatternResolver()
.getResources("classpath*:/mapper/*.xml"));
factoryBean.setTransactionFactory(new JdbcTransactionFactory());
return factoryBean.getObject();
}
/**
* 初始化全局事务扫描器
*
* @Return: GlobalTransactionScanner
*/
@Bean
public GlobalTransactionScanner globalTransactionScanner(){
return new GlobalTransactionScanner("demo_service", "my_test_tx_group");
}
}
这里,我的数据库使用的是mysql,持久层使用mybatis,我需要对数据源进行包装以支持fescar分布式事务管理,因此在这里对数据源进行扩展。如果TM项目不需要访问数据库,可以去除数据源代理和SqlSeeionFactory的定义,记得连上面的Import一起去掉。
GlobalTransactionScanner向fescar服务注册TM和RM的id和分支事务组。
五、启用开始使用分布式事务
我这里提供了一个例子,authApi的addUser调用了authService的addUser方法和demoService的demo方法,这是一个分布式服务调用,而我要做的仅仅是在方法上给一个标签@GlobalTransactional
之后,我们就可以开始测试了,调用这个服务,抛出异常,然后去数据库查询,发现已经demo方法已经回滚,在DemoService的控制台可以得到以下内容
2019-03-14 16:14:24.139 INFO 29117 --- [atch_RMROLE_1_8] c.a.f.core.rpc.netty.RmMessageListener : onMessage:xid=10.8.80.222:9999:2005758210,branchId=2005758211,branchType=AT,resourceId=jdbc:mysql://10.8.80.222:3306/kris?useUnicode=true&characterEncoding=UTF-8&allowMultiQueries=true,applicationData=null
2019-03-14 16:14:24.139 INFO 29117 --- [atch_RMROLE_1_8] com.alibaba.fescar.rm.RMHandlerAT : AT Branch rolling back: 10.8.80.222:9999:2005758210 2005758211 jdbc:mysql://10.8.80.222:3306/kris?useUnicode=true&characterEncoding=UTF-8&allowMultiQueries=true
2019-03-14 16:14:24.167 INFO 29117 --- [atch_RMROLE_1_8] com.alibaba.fescar.rm.RMHandlerAT : AT Branch rollback result: PhaseTwo_Rollbacked
2019-03-14 16:14:24.167 INFO 29117 --- [atch_RMROLE_1_8] c.a.fescar.core.rpc.netty.RmRpcClient : RmRpcClient sendResponse branchStatus=PhaseTwo_Rollbacked,result code =Success,getMsg =null
DemoService中的RM收到回滚消息,进行了事务回滚。
分布式事务变得如此简单,期待fescar的生产版本上线!
代码已上传至https://gitee.com/krisdevhome/ktp-main ,如果觉得好就点个赞把