README-en.md

ByteTCC is an implementation of Distributed Transaction Manager, based on Try-Confirm-Cancel (TCC) mechanism.

ByteTCC is comptible with JTA and could be seamlessly integrated with Spring and other Java containers.

1. Quick Start

1.1 Add maven depenency

1.1.1. Spring Cloud

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

1.1.2. dubbo

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

1.2 Compose a business service

@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 Compose a confirm service

@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 Compose a cancel service

@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);
	}

}

2. Documentation & Samples

• Document
• Sample

3. Features

• 1. support declarative transaction management
• 2. support normal transaction, TCC transaction, compensating service transaction
• 3. support distributed transaction scenarios. e.g. multi-datasource, cross-applications and cross-servers transaction
• 4. support long live transaction
• 5. support Dubbo framework
• 6. provide solutions for service idempotence in framework layer

4. History

v0.4.x

• Link：https://github.com/liuyangming/ByteTCC/tree/0.4.x
• Doc：https://github.com/liuyangming/ByteTCC/wiki

v0.3.x

• Link：https://github.com/liuyangming/ByteTCC/tree/0.3.x
• Doc：https://github.com/liuyangming/ByteTCC/wiki

v0.2.0-alpha

• Link：http://code.taobao.org/p/openjtcc
• Doc：http://code.taobao.org/p/openjtcc/wiki/index/

v0.1.2

• Link：http://code.google.com/p/bytetcc

v0.1

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

5. Contact Me

If you have any questions or comements regarding this project, please feel free to contact me at:

1. send mail to [email protected] OR
2. add Tecent QQ group 537445956/606453172

We will review all the suggestions and implement good ones in future release.