1	<?php
2
3	declare(strict_types=1);
4
5	namespace PeServer\Core\Database;
6
7	use PDOException;
8	use PeServer\Core\Database\IDatabaseContext;
9	use PeServer\Core\IDisposable;
10	use PeServer\Core\Throws\DatabaseException;
11	use PeServer\Core\Throws\SqlException;
12	use PeServer\Core\Throws\TransactionException;
13
14	/**
15	* トランザクションをサポートする状態。
16	*/
17	interface IDatabaseTransactionContext extends IDatabaseContext, IDisposable
18	{
19	#region function
20
21	/**
22	* トランザクション開始。
23	*
24	* @return void
25	* @throws TransactionException
26	*/
27	public function beginTransaction(): void;
28
29	/**
30	* トランザクションの確定。
31	*
32	* @return void
33	* @throws TransactionException
34	*/
35	public function commit(): void;
36
37	/**
38	* トランザクションの取消。
39	*
40	* @return void
41	* @throws TransactionException
42	*/
43	public function rollback(): void;
44
45	/**
46	* トランザクションラップ処理。
47	*
48	* @param callable(IDatabaseContext $context): bool $callback 実際の処理。戻り値が真の場合にコミット、偽ならロールバック。
49	* @return bool コミットされたか。正常系としてのコミット・ロールバック処理の戻りであり、異常系は例外が投げられる。
50	* @throws DatabaseException
51	*/
52	public function transaction(callable $callback): bool;
53
54	#endregion
55	}