0.0.4 • Published 6 years ago
transactionaljs v0.0.4
@Transactional
Translations: 简体中文
@Transactional is a package created to solve the problem of transaction delivery in nodejs code can only rely on parameter passing between functions. Now, we use the decorator (annotation) to pass.
Use immediately:
import { Transactional } from 'transactionaljs'
class UserService {
@Transactional()
public async createUser(){}
}
Immediate test:
npm install
npm run test
Features:
- Non-intrusive: Put @Transactional() on any function and get powerful transaction functions automatically;
- Multiple modes: REQUIRED, SUPPORTS, REQUIRES_NEW, NEVER, NOT_SUPPORTED (plan support);
- Multiple data sources: Any database that supports transaction creation, transaction commit, transaction rollback, can be used, such as mysql, mongodb, etc.
- ORM friendly: Just need to inject multiple transaction methods into the TransactionalPlatform, you can easily complete the transaction takeover, SequelizeV4 injection only requires 9 lines of code;
- Test enrichment: The current unit test has reached 66.67% coverage, and our plan is 100% forever;
- Typescript : written entirely using typescript;
- One-click test: npm run test, download source code, does not require any external dependencies, as long as npm nodejs directly open the test;
- Open source free: Welcome to submit PR, forever MIT agreement;
Roadmap:
- Distributed transaction: I haven't thought about it yet, probably based on 2PC;
- Multiple data sources: Support mongodb, mysql, redis transaction chain;
- More tests: More unit tests;
- More mode support: Modes such as NOT_SUPPORTED, and iterations of other modes;
Type definition
Type | Description |
---|---|
REQUIRED | Supports the current transaction if there is a transaction. Turn on if there is no transaction |
SUPPORTS | Supports the current transaction if there is a transaction. Non-transactional execution if there is no transaction |
REQUIRES_NEW | Always open a new transaction. Suspend this existing transaction if a transaction already exists |
NOT_SUPPORTED | Always execute non-transactionally and suspend any existing transactions |
NEVER | is always executed non-transactionally, throwing an exception if there is an active transaction |