KAFKA-15091: Fix misleading Javadoc for SourceTask::commit#13948
KAFKA-15091: Fix misleading Javadoc for SourceTask::commit#13948C0urante merged 2 commits intoapache:trunkfrom
Conversation
| * offsets are committed on transaction commits (also see {@link TransactionBoundary}). | ||
| * <p> | ||
| * SourceTasks are not required to implement this functionality; Kafka Connect will record offsets | ||
| * automatically. This hook is provided for systems that also need to store offsets internally |
There was a problem hiding this comment.
I'm on the fence on whether or not to remove this bit as well since I can't think of a realistic use-case where this method would help with offset tracking in the source system in its current form (and hence the question on deprecation of this method in https://issues.apache.org/jira/browse/KAFKA-15091).
There was a problem hiding this comment.
The "store offsets internally" language isn't great, but I'd rather leave it for now and explore it further if/when we start discussing deprecating this method. Connector developers might theoretically use this for acknowledging JMS records, for example, which in a very loose sense is storing offsets (or at least, some JMS-specific equivalent of them) in that system.
Reviewers: Chris Egerton <chrise@aiven.io>
Reviewers: Chris Egerton <chrise@aiven.io>
Reviewers: Chris Egerton <chrise@aiven.io>
* ak/trunk: (110 commits) MINOR: Update docs to include ZK deprecation notice and information (apache#14031) KAFKA-15091: Fix misleading Javadoc for SourceTask::commit (apache#13948) KAFKA-14669: Use the generated docs for MirrorMaker configs in the doc (apache#13658) KAFKA-14953: Add tiered storage related metrics (apache#13944) KAFKA-15121: Implement the alterOffsets method in the FileStreamSourceConnector and the FileStreamSinkConnector (apache#13945) Revert "MINOR: Update .asf.yaml file with refreshed github_whitelist, and collaborators" (apache#14037) MINOR: Update .asf.yaml file with refreshed github_whitelist, and collaborators KAFKA-14737: Move kafka.utils.json to server-common (apache#13585) KAFKA-14647: Move TopicFilter to server-common/utils (apache#13158) MINOR: remove unused variable in examples (apache#14021) ...
) Reviewers: Chris Egerton <chrise@aiven.io> (cherry picked from commit 35d4e9e)
From https://issues.apache.org/jira/browse/KAFKA-15091:
Committer Checklist (excluded from commit message)