[KAFKA-13967] Guarantees for producer callbacks on transaction commit should be documented

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 3.3.0
• Component/s: clients
• Assignee: Chris Egerton
• Reporter: Chris Egerton
• Created: 08/Jun/22 04:13
• Updated: 13/Jun/22 11:05
• Resolved: 10/Jun/22 16:51

Description

As discussed in https://github.com/apache/kafka/pull/11780#discussion_r891835221, part of the contract for a transactional producer is that all callbacks given to the producer will have been invoked and completed (either successfully or by throwing an exception) by the time that KafkaProducer::commitTransaction returns. This should be documented so that users of the clients library can have a guarantee that they're not on the hook to do that kind of bookkeeping themselves.

Issue Links

• relates to: KAFKA-10000 Atomic commit of source connector records and offsets
• links to: GitHub Pull Request #12264