Skip to main content

dm_pure/
transaction.rs

1//! 事务 API:`Transaction` 借用 `DmClient`,Drop 时自动回滚(sqlx/dameng 风格)。
2//!
3//! ```no_run
4//! use dm_pure::{DmClient, Param};
5//!
6//! let mut c = DmClient::new("127.0.0.1", 5236, "SYSDBA", "password");
7//! c.connect()?;
8//! {
9//!     let mut tx = c.transaction()?;          // begin
10//!     tx.execute("INSERT INTO t VALUES (?, ?)", &[Param::Int(1), Param::Str("a".into())])?;
11//!     tx.commit()?;                        // 显式提交
12//! }
13//! // 未 commit 的 Transaction 在 Drop 时自动 rollback
14//! # Ok::<(), dm_pure::DmError>(())
15//! ```
16
17use crate::{DmClient, ExecuteResult, Param, Result};
18
19/// 借用客户端的事务句柄。Drop 时若未 commit/rollback 则自动回滚。
20pub struct Transaction<'a> {
21    pub(crate) client: &'a mut DmClient,
22    finished: bool,
23}
24
25impl<'a> Transaction<'a> {
26    pub(crate) fn new(client: &'a mut DmClient) -> Self {
27        Transaction { client, finished: false }
28    }
29
30    /// 在事务内执行 SQL。
31    pub fn execute(&mut self, sql: &str, params: &[Param]) -> Result<ExecuteResult> {
32        self.client.execute(sql, params)
33    }
34
35    /// 提交事务,消费自身并释放客户端借用。
36    pub fn commit(mut self) -> Result<()> {
37        self.client.commit()?;
38        self.finished = true;
39        Ok(())
40    }
41
42    /// 回滚事务,消费自身并释放客户端借用。
43    pub fn rollback(mut self) -> Result<()> {
44        self.client.rollback()?;
45        self.finished = true;
46        Ok(())
47    }
48
49    /// 是否已结束(commit/rollback 后为 true)。
50    pub fn is_finished(&self) -> bool {
51        self.finished
52    }
53}
54
55impl<'a> Drop for Transaction<'a> {
56    fn drop(&mut self) {
57        if !self.finished {
58            let _ = self.client.rollback();
59        }
60    }
61}
62
63/// DmClient 的事务入口。
64impl DmClient {
65    /// 开始事务并返回 `Transaction` 句柄(Drop 自动回滚)。
66    pub fn transaction(&mut self) -> Result<Transaction<'_>> {
67        self.begin()?;
68        Ok(Transaction::new(self))
69    }
70}