(paimon) branch master updated: [hotfix] Document difference between CommitListener and CommitCallback

[lzljs3620320]

This is an automated email from the ASF dual-hosted git repository.

lzljs3620320 pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/paimon.git


The following commit(s) were added to refs/heads/master by this push:
     new 3b0e9b71d9 [hotfix] Document difference between CommitListener and 
CommitCallback
3b0e9b71d9 is described below

commit 3b0e9b71d98facaa17c2f13b9c3eb89006ca1071
Author: JingsongLi <jingsongl...@gmail.com>
AuthorDate: Mon Jul 21 16:03:32 2025 +0800

    [hotfix] Document difference between CommitListener and CommitCallback
---
 .../org/apache/paimon/flink/sink/listener/CommitListener.java    | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git 
a/paimon-flink/paimon-flink-common/src/main/java/org/apache/paimon/flink/sink/listener/CommitListener.java
 
b/paimon-flink/paimon-flink-common/src/main/java/org/apache/paimon/flink/sink/listener/CommitListener.java
index b52d8709fe..ecc1b62774 100644
--- 
a/paimon-flink/paimon-flink-common/src/main/java/org/apache/paimon/flink/sink/listener/CommitListener.java
+++ 
b/paimon-flink/paimon-flink-common/src/main/java/org/apache/paimon/flink/sink/listener/CommitListener.java
@@ -19,11 +19,18 @@
 package org.apache.paimon.flink.sink.listener;
 
 import org.apache.paimon.manifest.ManifestCommittable;
+import org.apache.paimon.table.sink.CommitCallback;
 
 import java.io.Closeable;
 import java.util.List;
 
-/** The commit listener. */
+/**
+ * The commit listener for Flink sink.
+ *
+ * <p>The biggest difference between this class and {@link CommitCallback} is 
that it can implement
+ * the {@link #snapshotState()} method, which allows for customized 
requirements based on Flink's
+ * stream computing features.
+ */
 public interface CommitListener extends Closeable {
 
     void notifyCommittable(List<ManifestCommittable> committables);