Code comments of updateConsumeOffset() should be corrected

[ghost]

Search before creation

• I had searched in the issues and found no similar issues.

Documentation Related

[org/apache/rocketmq/example/simple/PullConsumer.java]
https://github.com/apache/rocketmq/blob/develop/example/src/main/java/org/apache/rocketmq/example/simple/PullConsumer.java

consumer.updateConsumeOffset() uses the function of updateOffset() in OffsetStore interface here:

org/apache/rocketmq/client/consumer/store/OffsetStore.java

In example, the comments show "//update offset to broker" and the interface class code shows "Update the offset,store it in memory".

Or one of the two comments might be wrong. Please correct me if I misunderstood them.

Are you willing to submit PR?

• Yes I am willing to submit a PR!

[joeCarf]

updateOffset这个方法有两个实现，一个是在本地存储offset，一个是将offset存在broker里。这两种实现分别对应着广播消费和集群消费模式，因此我理解这里的comment有些模糊，但是大意应该没有问题

[ghost]

updateOffset这个方法有两个实现，一个是在本地存储offset，一个是将offset存在broker里。这两种实现分别对应着广播消费和集群消费模式，因此我理解这里的comment有些模糊，但是大意应该没有问题

@joeCarf Thanks for your reply :)

There is no difference in the implementations of method updateOffset() between LocalFileOffsetStore and RemoteBrokerOffsetStore. The codes of updateOffset() in RemoteBrokerOffsetStore (Clustering mode as you said) are as follows：

As per the code, I can not found the interaction between client and broker. Therefore, I still think the comment should be corrected. You are right with the fact that the scheduled service would update offset from client memory to broker disk. However, that action is not directly to update offset to broker.

[joeCarf]

图中的代码只更新了内存中的offset。在RemoteBrokerOffsetStore中，有一persistAll函数，会将整个offsetTable更新到对应的broker

而LocalFileOffsetStore中只会写到本地文件中

[joeCarf]

@tensory2022

[ghost]

@joeCarf

I never doubt the offset will be updated to broker, what I care is whether it is done by the method updateConsumeOffset(). If not, the code comment should be corrected.

In additon, you might need to think over this point: "而LocalFileOffsetStore中只会写到本地文件中" . Whether you use LocalFileOffsetStore or RemoteBrokerOffsetStore, the offset will be synchronized to broker by a scheduled service which runs every 10 seconds.

I hope you understand what I'm saying, thank you~

[joeCarf]

i get your point, and i will submit a pr to enhance it. btw, i didn't find the scheduled service which runs every 10 seconds in LocalFileOffsetStore, will you plz show me the code location

[joeCarf]

plz take a look at this pr #7490

[ghost]

@joeCarf Thanks for your PR. Hope it will be merged soon.

The code you require is at: org.apache.rocketmq.client.impl.factory.MQClientInstance.

And the scheduled time interval should be 5 seconds instead of 10 seconds I declared before.