Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xlorne/tx-lcn
LCN分布式事务框架v3.0
https://github.com/xlorne/tx-lcn
lcn
Last synced: 7 days ago
JSON representation
LCN分布式事务框架v3.0
- Host: GitHub
- URL: https://github.com/xlorne/tx-lcn
- Owner: xlorne
- License: apache-2.0
- Created: 2017-09-21T14:27:51.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-01-22T03:00:44.000Z (almost 7 years ago)
- Last Synced: 2024-12-27T06:08:19.337Z (14 days ago)
- Topics: lcn
- Language: Java
- Homepage: https://www.txlcn.org
- Size: 852 KB
- Stars: 293
- Watchers: 39
- Forks: 117
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LCN分布式事务框架v3.0 [停止维护，请使用4.0]
"LCN并不生产事务，LCN只是本地事务的搬运工"
3.0 将不再维护，请使用4.0版本。github地址 : https://github.com/codingapi/tx-lcn
## 框架官网
[www.txlcn.org](http://www.txlcn.org)
**LCN分布式事务框架v4.0 发布了，详情见框架官网**
## 框架特点
1. 支持各种基于spring的db框架
2. 兼容SpringCloud、Dubbo
3. 使用简单，低依赖，代码完全开源
4. 基于切面的强一致性事务框架
5. 高可用，模块可以依赖Dubbo或SpringCloud的集群方式做集群化，TxManager也可以做集群化
6. 支持本地事务和分布式事务共存
7. 事务补偿机制，服务故障或挂机再启动时可恢复事务
## 注意事项
1. 同一个模块单元下的事务是嵌套的。
2. 不同事务模块下的事务是独立的。
备注：框架在多个业务模块下操作更新同一个库下的同一张表下的同一条时，将会出现锁表的情况，会导致分布式事务异常，数据会丧失一致性。
方案：
希望开发者在设计模块时避免出现多模块更新操作（insert update delete）同一条数据的情况。
3. 禁止重名的bean对象。
事务的补偿机制是基于java反射的方式重新执行一次需要补偿的业务。因此执行的时候需要获取到业务的service对象，LCN是基于spring的ApplicationContent的getBean方法获取bean的对象的。因此不允许出现重名对象。
## 框架的设计原理
文档原理介绍：见 [tx-lcn/wiki](https://github.com/1991wangliang/tx-lcn/wiki)
视频原理介绍：见 [www.txlcn.org](http://www.txlcn.org/video.html)
## 使用示例
引入maven文件，根据框架选择SpringCloud或者Dubbo版本
```
com.github.1991wangliang
springcloud-transaction
1.0.2
com.github.1991wangliang
dubbo-transaction
1.0.2
```
分布式事务发起方：
```java
@Override
@TxTransaction
@Transactional
public boolean hello() {
//本地调用
testDao.save();
//远程调用方
boolean res = test2Service.test();
//模拟异常
int v = 100/0;
return true;
}
```
分布式事务被调用方(test2Service的业务实现类)
```java
@Override
@Transactional
public boolean test() {
//本地调用
testDao.save();
return true;
}
```
如上代码执行完成以后两个模块都将回滚事务。
说明：在使用LCN分布式事务时，只需要将事务的开始方法添加`@TxTransaction`注解即可。详细见demo教程
## 关于@TxTransaction 使用说明
@TxTransaction注解是分布式事务的标示。
若存在业务方法：a-b b-c b-d，那么开启分布式事务注解的话，只需要在a方法上添加@TxTransaction即可。
```java
@TxTransaction
@Transactional
public void a(){
b();
}
public void b(){
c();
d();
}
public void c(){}
public void d(){}
```
## 目录说明
lorne-tx-core 是LCN分布式事务框架的切面核心类库，支持关系型数据库分布式事务
lorne-tx-core-redis 是LCN分布式事务框架对Redis数据库的分布式事务扩展支持
dubbo-transaction 是LCN dubbo分布式事务框架
springcloud-transaction 是LCN springcloud分布式事务框架
tx-manager 是LCN 分布式事务协调器
## demo 示例
demo里包含jdbc\hibernate\mybatis版本的demo
dubbo版本的demo [dubbo-demo](https://github.com/1991wangliang/dubbo-lcn-demo)
springcloud版本的demo [springcloud-demo](https://github.com/1991wangliang/springcloud-lcn-demo)
Demo使用视频讲解地址：[http://www.txlcn.org/v3/index.html](http://www.txlcn.org/v3/index.html)
技术交流群：554855843