PROTON-1442: [Cpp] Support for local transactions #437

DreamPearl · 2024-11-20T08:57:17Z

PROTON-1442

AMQP Transaction Sequence:

Declare transaction:

Client establishes link to Broker (Transaction resource) to target with transaction coordinator type (usual types are sender/receiver) (ATTACH frame)
Client (Transaction Controller) sends a special message to that link to create transaction (TRANSFER frame)
Broker returns a disposition with the transaction id (DISPOSITION frame)

Send Message in the transaction:

Client sends a message to the broker with transaction id in the state field.

Commit/Abort

astitcher

I've taken a fairly thorough look. If you have any questions about these review items we should discuss further.

cpp/include/proton/container.hpp

cpp/include/proton/target_options.hpp

cpp/include/proton/tracker.hpp

cpp/include/proton/transaction.hpp

astitcher · 2024-12-04T20:37:59Z

cpp/include/proton/transaction.hpp

+class
+PN_CPP_CLASS_EXTERN transaction_handler {
+  public:
+    PN_CPP_EXTERN virtual ~transaction_handler();
+
+    /// Called when a local transaction is declared.
+    PN_CPP_EXTERN virtual void on_transaction_declared(transaction);
+
+    /// Called when a local transaction is discharged successfully.
+    PN_CPP_EXTERN virtual void on_transaction_committed(transaction);
+
+    /// Called when a local transaction is discharged unsuccessfully (aborted).
+    PN_CPP_EXTERN virtual void on_transaction_aborted(transaction);
+
+    /// Called when a local transaction declare fails.
+    PN_CPP_EXTERN virtual void on_transaction_declare_failed(transaction);
+
+    /// Called when the commit of a local transaction fails.
+    PN_CPP_EXTERN virtual void on_transaction_commit_failed(transaction);
+};
+
+} // namespace proton
+


I think this should be in a different header file like message and messaging_handler

So if the API makes transactions hidden in a session then these callbacks either go away or instead become session callbacks: on_session_transaction_committed(session&), etc. I think transaction_declared() goes away entirely and it's purpose is now another use for on_session_open(session&). on_.._declare_failed should be handled by the on_session_error(session&).

cpp/include/proton/transaction.hpp

cpp/examples/tx_recv.cpp

astitcher

I've not reviewed this comprehensively, but I think I'm now very much leaning towards not making the transaction class visible to the API user at all and having the transaction methods on the session. This is essentially the API in JMS and CMS.

cpp/include/proton/transaction.hpp

astitcher · 2024-12-18T23:10:52Z

cpp/include/proton/transaction.hpp

+class
+PN_CPP_CLASS_EXTERN transaction_handler {
+  public:
+    PN_CPP_EXTERN virtual ~transaction_handler();
+
+    /// Called when a local transaction is declared.
+    PN_CPP_EXTERN virtual void on_transaction_declared(transaction);
+
+    /// Called when a local transaction is discharged successfully.
+    PN_CPP_EXTERN virtual void on_transaction_committed(transaction);
+
+    /// Called when a local transaction is discharged unsuccessfully (aborted).
+    PN_CPP_EXTERN virtual void on_transaction_aborted(transaction);
+
+    /// Called when a local transaction declare fails.
+    PN_CPP_EXTERN virtual void on_transaction_declare_failed(transaction);
+
+    /// Called when the commit of a local transaction fails.
+    PN_CPP_EXTERN virtual void on_transaction_commit_failed(transaction);
+};
+
+} // namespace proton
+


So if the API makes transactions hidden in a session then these callbacks either go away or instead become session callbacks: on_session_transaction_committed(session&), etc. I think transaction_declared() goes away entirely and it's purpose is now another use for on_session_open(session&). on_.._declare_failed should be handled by the on_session_error(session&).

cpp/include/proton/transfer.hpp

cpp/examples/tx_send.cpp

pematous · 2025-01-21T15:35:45Z

cpp/examples/tx_recv.cpp

+        transaction.accept(d);
+        current_batch += 1;
+        if(current_batch == batch_size) {
+            transaction = proton::transaction(); // null


I believe we should do rather commit here, that way it works as expected and the receiver is closed after expected number of messages received (with the current implementation it's not).

I believe we should do rather commit here, that way it works as expected and the receiver is closed after expected number of messages received (with the current implementation it's not).

above mentioned change:

- transaction = proton::transaction(); // null + transaction.commit();

works as expected (against Artemis broker) when using multicast. However, when a pre-defined anycast queue is used, the commit() call ends with client segmentation fault.

cpp/examples/tx_recv.cpp

cpp/examples/tx_send.cpp

pematous · 2025-01-24T10:16:46Z

cpp/examples/tx_recv.cpp

+
+    void on_message(proton::delivery &d, proton::message &msg) override {
+        std::cout<<"# MESSAGE: " << msg.id() <<": "  << msg.body() << std::endl;
+        transaction.accept(d);


btw. I'm thinking if transaction.accept() does actually have any effect? I mean, when I comment it out, the program behaves the same. btw. is this transaction accept any different from delivery accept? looks both settles the messages related to the delivery.

Does explicit delivery settling play role in transaction mode? or are they mutually exclusive and only commits and aborts applies? Can ie. single message in transaction be rejected while other messages accepted?

I tried to accept / reject the delivery and it seems to have no effect in transaction mode (while in python, doing so makes the messages to be threat outside of the transaction, just like a normal messages, https://issues.redhat.com/browse/ENTMQCL-513).

cpp/src/messaging_adapter.cpp

astitcher

Lopts of detailed comments here, but the main change I'd like to see is either make coordinator a subclass of target or fold it into a simple boolean option of target.

cpp/examples/tx_recv.cpp

cpp/examples/tx_send.cpp

cpp/src/proton_bits.hpp

cpp/src/sender_options.cpp

cpp/src/transaction.cpp

cpp/include/proton/session.hpp

astitcher · 2025-04-24T13:51:24Z

cpp/include/proton/session.hpp

 struct pn_session_t;

 namespace proton {
+  class transaction_impl;


Is this actually needed here?

transaction_impl is pirely internal and should not be in an externally visible header file

cpp/include/proton/session.hpp

cpp/include/proton/target_options.hpp

cpp/include/proton/session.hpp

cpp/src/proactor_container_impl.cpp

cpp/examples/tx_send.cpp

cpp/src/session.cpp

astitcher

First batch of comments

cpp/examples/tx_recv.cpp

astitcher · 2025-08-28T16:08:10Z

cpp/include/proton/session.hpp

 struct pn_session_t;

 namespace proton {
+  class transaction_impl;


transaction_impl is pirely internal and should not be in an externally visible header file

cpp/include/proton/session.hpp

DreamPearl marked this pull request as draft November 20, 2024 08:57

DreamPearl force-pushed the local-transactions branch 2 times, most recently from 74818fc to eb4514b Compare November 21, 2024 18:28

DreamPearl force-pushed the local-transactions branch from 3e96834 to fa9236d Compare December 3, 2024 12:56

astitcher requested changes Dec 4, 2024

View reviewed changes

DreamPearl force-pushed the local-transactions branch from fa9236d to 347cf6e Compare December 16, 2024 13:29

astitcher requested changes Dec 18, 2024

View reviewed changes

pematous reviewed Jan 21, 2025

View reviewed changes

cpp/examples/tx_send.cpp Outdated Show resolved Hide resolved

pematous reviewed Jan 21, 2025

View reviewed changes

cpp/examples/tx_recv.cpp Outdated Show resolved Hide resolved

pematous reviewed Jan 24, 2025

View reviewed changes

cpp/examples/tx_send.cpp Show resolved Hide resolved

pematous reviewed Jan 24, 2025

View reviewed changes

cpp/examples/tx_send.cpp Outdated Show resolved Hide resolved

pematous reviewed Jan 24, 2025

View reviewed changes

DreamPearl force-pushed the local-transactions branch from 4c795ef to eb8afbd Compare March 17, 2025 17:54

pematous reviewed Mar 18, 2025

View reviewed changes

cpp/src/messaging_adapter.cpp Outdated Show resolved Hide resolved

astitcher requested changes Mar 20, 2025

View reviewed changes

DreamPearl force-pushed the local-transactions branch from eb8afbd to 4c795ef Compare March 26, 2025 05:04

DreamPearl force-pushed the local-transactions branch from 578445f to 6fd1434 Compare April 17, 2025 12:39

astitcher reviewed Apr 24, 2025

View reviewed changes

astitcher reviewed Aug 28, 2025

View reviewed changes

DreamPearl force-pushed the local-transactions branch 2 times, most recently from 4cfc58b to 6eb58f4 Compare October 4, 2025 05:18

Implement local transaction in CPP

2d440ef

DreamPearl force-pushed the local-transactions branch from 6eb58f4 to 2d440ef Compare October 4, 2025 05:20

DreamPearl added 3 commits October 5, 2025 00:51

Local Transaction tx_recv.cpp example shows abort() function

ae1251e

Update tx_send and tx_recv examples to fully work

f19223d

Add a test file and few improvements

89cf0f1

PROTON-1442: [Cpp] Support for local transactions #437

Are you sure you want to change the base?

PROTON-1442: [Cpp] Support for local transactions #437

Uh oh!

Conversation

DreamPearl commented Nov 20, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

astitcher left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

astitcher left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

pematous Feb 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

astitcher left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

astitcher left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

DreamPearl commented Nov 20, 2024 •

edited

Loading

pematous Feb 5, 2025 •

edited

Loading