CoffeeLatte007 / ByteTCC

ByteTCC是一个兼容JTA规范的基于TCC机制的分布式事务管理器。用户手册：https://github.com/liuyangming/ByteTCC/wiki

ByteTCC是一个基于TCC（Try/Confirm/Cancel）机制的分布式事务管理器。兼容JTA，可以很好的与EJB、Spring等容器（本文档下文说明中将以Spring容器为例）进行集成。

一、快速入门

1.1. 加入maven依赖

1.1.1. 使用Spring Cloud

<dependency>
	<groupId>org.bytesoft</groupId>
	<artifactId>bytetcc-supports-springcloud</artifactId>
	<version>0.4.14</version>
</dependency>

1.1.2. 使用dubbo

<dependency>
	<groupId>org.bytesoft</groupId>
	<artifactId>bytetcc-supports-dubbo</artifactId>
	<version>0.4.14</version>
</dependency>

1.2. 编写业务服务

@Service("accountService")
@Compensable(
  interfaceClass = IAccountService.class 
, confirmableKey = "accountServiceConfirm"
, cancellableKey = "accountServiceCancel"
)
public class AccountServiceImpl implements IAccountService {

	@Resource(name = "jdbcTemplate")
	private JdbcTemplate jdbcTemplate;

	@Transactional
	public void increaseAmount(String accountId, double amount) throws ServiceException {
	    this.jdbcTemplate.update("update tb_account set frozen = frozen + ? where acct_id = ?", amount, acctId);
	}

}

1.3. 编写confirm服务

@Service("accountServiceConfirm")
public class AccountServiceConfirm implements IAccountService {

	@Resource(name = "jdbcTemplate")
	private JdbcTemplate jdbcTemplate;

	@Transactional
	public void increaseAmount(String accountId, double amount) throws ServiceException {
	    this.jdbcTemplate.update("update tb_account set amount = amount + ?, frozen = frozen - ? where acct_id = ?", amount, amount, acctId);
	}

}

1.4. 编写cancel服务

@Service("accountServiceCancel")
public class AccountServiceCancel implements IAccountService {

	@Resource(name = "jdbcTemplate")
	private JdbcTemplate jdbcTemplate;

	@Transactional
	public void increaseAmount(String accountId, double amount) throws ServiceException {
	    this.jdbcTemplate.update("update tb_account set frozen = frozen - ? where acct_id = ?", amount, acctId);
	}

}

二、文档 & 样例

• 使用文档： https://github.com/liuyangming/ByteTCC/wiki
• 使用样例： https://github.com/liuyangming/ByteTCC-sample

三、ByteTCC特性

• 1、支持Spring容器的声明式事务管理；
• 2、支持普通事务、TCC事务、业务补偿型事务等事务机制；
• 3、支持多数据源、跨应用、跨服务器等分布式事务场景；
• 4、支持长事务；
• 5、支持dubbo服务框架；
• 6、支持spring cloud；

四、服务质量

4.1. 故障恢复保障

• 任意时刻，因各类故障（包括但不限于：业务系统/RDBS服务器宕机；网络故障；断电等）造成的事务中断，ByteTCC均有相应机制予以恢复，保证全局事务的最终一致性。

4.2. 幂等性保障

• ByteTCC在框架层面提供对Confirm/Cancel业务逻辑的幂等性保障，业务系统仅需关注自身业务本身，无需为幂等性问题而烦恼。

五、历史版本

5.1. v0.4.x

• 地址：https://github.com/liuyangming/ByteTCC/tree/0.4.x
• 文档：https://github.com/liuyangming/ByteTCC/wiki

5.2. v0.3.x

• 地址：https://github.com/liuyangming/ByteTCC/tree/0.3.x
• 文档：https://github.com/liuyangming/ByteTCC/wiki

5.3. v0.2.0-alpha

• 地址：http://code.taobao.org/p/openjtcc
• 文档：http://code.taobao.org/p/openjtcc/wiki/index/

5.4. v0.1.2

• 地址：http://code.google.com/p/bytetcc

5.5. v0.1

• 地址：http://pan.baidu.com/s/1hq3ffxU

六、建议及改进

若您有任何建议，可以通过1）加入qq群537445956/606453172向群主提出，或2）发送邮件至[e-mail]向我反馈。本人承诺，任何建议都将会被认真考虑，优秀的建议将会被采用，但不保证一定会在当前版本中实现。