[IGNITE-17260] Enrich IgniteTransactions and Transaction interfaces with RO related methods

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 3.0.0-beta1
• Labels: ignite-3 transaction3_ro

Release Note

Generally speaking, added an ability to run read-only transactions using KV API.

Particularly following methods were added to IgniteTransactions and Transaction interfaces:
- IgniteTransactoins#readOnly method is added to IgniteTransactoins. This one returns a decorated {@code IgniteTransactions} instance that will start read-only transactions.
- Transaction#isReadOnly in order to check whether given transaction is read-only.
- Transaction#readTimestamp - returns read timestamp for the given transaction if it is a read-only one or {code null} otherwise.

• Epic Link: Ignite 3 transactions
• Assignee: Alexander Lapin
• Reporter: Alexander Lapin
• Created: 29/Jun/22 06:27
• Updated: 25/Oct/22 19:22
• Resolved: 25/Oct/22 19:22

Description

It's required to explicitly register an intent of starting readOnly transaction, so following decorator producer is expected in IgniteTransactions

/**
 * Decorated {@code IgniteTransactions} instance that will start read-only transactions.
 *
 * @return Decorated {@code IgniteTransactions} instance that will start read-only transactions.
 */
IgniteTransactions readOnly(); 

Besides that Transaction interface should be extended with

boolean isReadOnly();

and

HybridTimestamp readTimestamp();

methods.

And finally three more overloaded methods will be added to the InternalTable

    CompletableFuture<BinaryRow> get(
            BinaryRowEx keyRow,
            @NotNull HybridTimestamp readTimestamp,
            @NotNull ClusterNode recipientNode
    );
 
    CompletableFuture<Collection<BinaryRow>> getAll(
            Collection<BinaryRowEx> keyRows,
            @NotNull HybridTimestamp readTimestamp,
            @NotNull ClusterNode recipientNode
    );
 
    Publisher<BinaryRow> scan(
            int p,
            @NotNull HybridTimestamp readTimestamp,
            @NotNull ClusterNode recipientNode
    );

Please, pay attention, that new parameter  @NotNull ClusterNode recipientNode is added.

Issue Links

• Dependency: IGNITE-17330 Support RO TX by SQL
• links to: GitHub Pull Request #1230
• links to: GitHub Pull Request #1248