This is an automated email from the ASF dual-hosted git repository.
zhangliang pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/shardingsphere.git
The following commit(s) were added to refs/heads/master by this push:
new aba594ce067 Update transaction.en.md (#19298)
aba594ce067 is described below
commit aba594ce067caf9ec9de52e3c237c3c010cc9f16
Author: Swastika Gupta <[email protected]>
AuthorDate: Sun Jul 17 21:27:33 2022 +0530
Update transaction.en.md (#19298)
---
docs/document/content/dev-manual/transaction.en.md | 91 ++++++++++++++--------
1 file changed, 58 insertions(+), 33 deletions(-)
diff --git a/docs/document/content/dev-manual/transaction.en.md
b/docs/document/content/dev-manual/transaction.en.md
index 976e9f1974e..f9481304b4c 100644
--- a/docs/document/content/dev-manual/transaction.en.md
+++ b/docs/document/content/dev-manual/transaction.en.md
@@ -5,49 +5,74 @@ weight = 10
chapter = true
+++
-## SPI Interface
+## ShardingSphereTransactionManager
-### ShardingSphereTransactionManager
+### Fully-qualified class name
-| *SPI Name* | *Description* |
-| ---------------------------------------- | ------------------------- |
-| ShardingSphereTransactionManager | Distributed transaction manager
|
-| XATransactionManagerProvider | XA distributed transaction manager
|
-| XADataSourceDefinition | Auto convert Non XA data source to XA
data source |
-| DataSourcePropertyProvider | Used to get standard properties of data source
pool |
+[`org.apache.shardingsphere.transaction.spi.ShardingSphereTransactionManager`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-core/src/main/java/org/apache/shardingsphere/transaction/spi/ShardingSphereTransactionManager.java)
+### Definition
+ShardingSphere transaction manager service definition
-## Sample
+### Implementation classes
-### ShardingSphereTransactionManager
+| *Configuration Type* | *Description* |
*Fully-qualified class name* |
+| -------------------- | ----------------------------------------- |
---------------------------- |
+| TransactionType.XA | XA distributed transaction manager |
[`org.apache.shardingsphere.transaction.xa.XAShardingSphereTransactionManager`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-core/src/main/java/org/apache/shardingsphere/transaction/xa/XAShardingSphereTransactionManager.java)
|
+| TransactionType.BASE | Seata distributed transaction manager |
[`org.apache.shardingsphere.transaction.base.seata.at.SeataATShardingSphereTransactionManager`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-base/shardingsphere-transaction-base-seata-at/src/main/java/org/apache/shardingsphere/transaction/base/seata/at/SeataATShardingSphereTransactionManager.java)
|
-| *Implementation Class* | *Description*
|
-| ---------------------------------------- | ------------------------- |
-| XAShardingSphereTransactionManager | XA distributed transaction
manager |
-| SeataATShardingSphereTransactionManager | Seata distributed transaction
manager |
+## XATransactionManagerProvider
-### XATransactionManagerProvider
+### Fully-qualified class name
-| *Implementation Class* | *Description*
|
-| ------------------------------------ | -------------------------------- |
-| AtomikosTransactionManagerProvider | XA distributed transaction manager
based on Atomikos |
-| NarayanaXATransactionManagerProvider | XA distributed transaction manager
based on Narayana |
-| BitronixXATransactionManagerProvider | XA distributed transaction manager
based on Bitronix |
+[`org.apache.shardingsphere.transaction.xa.spi.XATransactionManagerProvider`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-spi/src/main/java/org/apache/shardingsphere/transaction/xa/spi/XATransactionManagerProvider.java)
-### XADataSourceDefinition
+### Definition
-| *Implementation Class* | *Description*
|
-| -------------------------------- |
------------------------------------------------------- |
-| MySQLXADataSourceDefinition | Auto convert Non XA MySQL data source to
XA MySQL data source |
-| MariaDBXADataSourceDefinition | Auto convert Non XA MariaDB data source
to XA MariaDB data source |
-| PostgreSQLXADataSourceDefinition | Auto convert Non XA PostgreSQL data
source to XA PostgreSQL data source |
-| OracleXADataSourceDefinition | Auto convert Non XA Oracle data source to
XA Oracle data source |
-| SQLServerXADataSourceDefinition | Auto convert Non XA SQLServer data source
to XA SQLServer data source |
-| H2XADataSourceDefinition | Auto convert Non XA H2 data source to XA
H2 data source |
+XA transaction manager provider definition
-### DataSourcePropertyProvider
+### Implementation classes
-| *Implementation Class* | *Description* |
-| -------------------------- | ------------------------------ |
-| HikariCPPropertyProvider | Used to get standard properties of HikariCP |
\ No newline at end of file
+| *Configuration Type* | *Description* |
*Fully-qualified class name* |
+| -------------------- | ----------------------------------------- |
---------------------------- |
+| Atomikos | XA distributed transaction manager based on Atomikos |
[`org.apache.shardingsphere.transaction.xa.atomikos.manager.AtomikosTransactionManagerProvider`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-provider/shardingsphere-transaction-xa-atomikos/src/main/java/org/apache/shardingsphere/transaction/xa/atomikos/manager/AtomikosTra
[...]
+| Narayana | XA distributed transaction manager based on Narayana |
[`org.apache.shardingsphere.transaction.xa.narayana.manager.NarayanaXATransactionManagerProvider`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-provider/shardingsphere-transaction-xa-narayana/src/main/java/org/apache/shardingsphere/transaction/xa/narayana/manager/NarayanaXAT
[...]
+| Bitronix | XA distributed transaction manager based on Bitronix |
[`org.apache.shardingsphere.transaction.xa.bitronix.manager.BitronixXATransactionManagerProvider`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-provider/shardingsphere-transaction-xa-bitronix/src/main/java/org/apache/shardingsphere/transaction/xa/bitronix/manager/BitronixXAT
[...]
+
+## XADataSourceDefinition
+
+### Fully-qualified class name
+
+[`org.apache.shardingsphere.transaction.xa.jta.datasource.properties.XADataSourceDefinition`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-core/src/main/java/org/apache/shardingsphere/transaction/xa/jta/datasource/properties/XADataSourceDefinition.java)
+
+### Definition
+
+XA Data source definition
+
+### Implementation classes
+
+| *Configuration Type* | *Description* |
*Fully-qualified class name* |
+| -------------------- | ----------------------------------------- |
---------------------------- |
+| MySQL | Auto convert Non XA MySQL data source to XA MySQL data source
|
[`org.apache.shardingsphere.transaction.xa.jta.datasource.properties.dialect.MySQLXADataSourceDefinition`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-core/src/main/java/org/apache/shardingsphere/transaction/xa/jta/datasource/properties/dialect/MySQLXAD
[...]
+| MariaDBXADataSourceDefinition | Auto convert Non XA MariaDB data source
to XA MariaDB data source |
[`org.apache.shardingsphere.transaction.xa.jta.datasource.properties.dialect.MariaDBXADataSourceDefinition`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-core/src/main/java/org/apache/shardingsphere/transaction/xa/jta/datasource/pro
[...]
+| PostgreSQLXADataSourceDefinition | Auto convert Non XA PostgreSQL data
source to XA PostgreSQL data source |
[`org.apache.shardingsphere.transaction.xa.jta.datasource.properties.dialect.PostgreSQLXADataSourceDefinition`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-core/src/main/java/org/apache/shardingsphere/transaction/xa/jta/datasource/
[...]
+| OracleXADataSourceDefinition | Auto convert Non XA Oracle data source to
XA Oracle data source |
[`org.apache.shardingsphere.transaction.xa.jta.datasource.properties.dialect.OracleXADataSourceDefinition`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-core/src/main/java/org/apache/shardingsphere/transaction/xa/jta/datasource/prop
[...]
+| SQLServerXADataSourceDefinition | Auto convert Non XA SQLServer data source
to XA SQLServer data source |
[`org.apache.shardingsphere.transaction.xa.jta.datasource.properties.dialect.SQLServerXADataSourceDefinition`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-core/src/main/java/org/apache/shardingsphere/transaction/xa/jta/datasource/p
[...]
+| H2XADataSourceDefinition | Auto convert Non XA H2 data source to XA
H2 data source |
[`org.apache.shardingsphere.transaction.xa.jta.datasource.properties.dialect.H2XADataSourceDefinition`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-core/src/main/java/org/apache/shardingsphere/transaction/xa/jta/datasource/properti
[...]
+
+## DataSourcePropertyProvider
+
+### Fully-qualified class name
+
+[`org.apache.shardingsphere.transaction.xa.jta.datasource.swapper.DataSourcePropertyProvider`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-core/src/main/java/org/apache/shardingsphere/transaction/xa/jta/datasource/swapper/DataSourcePropertyProvider.java)
+
+### Definition
+
+Data source property provider service definition
+
+### Implementation classes
+
+| *Configuration Type* | *Description* |
*Fully-qualified class name* |
+| -------------------- | ----------------------------------------- |
---------------------------- |
+| com.zaxxer.hikari.HikariDataSource | Used to get standard properties of
HikariCP |
[`org.apache.shardingsphere.transaction.xa.jta.datasource.swapper.impl.HikariCPPropertyProvider`](https://github.com/apache/shardingsphere/blob/master/shardingsphere-kernel/shardingsphere-transaction/shardingsphere-transaction-type/shardingsphere-transaction-xa/shardingsphere-transaction-xa-core/src/main/java/org/apache/shardingsphere/transaction/xa/jta/datasource/swapper/impl/HikariCPPropertyProvider.java)
|