知识卡片
管理接口须返回结果
把管理命令集成到程序时,终端打印不等于调用者取得结果。书中的 TopicCommand.main() 返回 void:调用 describe 后终端能显示主题详情,程序却无法从返回值读取详情。AdminClient 的各操作返回结果对象,查询类结果可携带主题或配置信息,让调用者继续判断和处理。这个差别是选择管理接口的依据,不只是把命令字符串搬进代码。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《深入理解Kafka:核心设计与实践原理 2019》第4章《主题与分区》4.2.1「基本使用」(`_epub-src/OEBPS/Text/chapter5.xhtml`;旧调用示例 `138_2.jpg`)
- 结论依据:正文对比 `TopicCommand.main()` 的 `void` 返回值和 `KafkaAdminClient` 的结果类型,并以查询主题详情说明调用者无法捕获终端输出。
- 原始内容:当调用 describeTopic()方法时,虽然我们可以在终端看到主题 topic-create 的详细信息,但方法的调用者却无法捕获这个信息,因为返回值类型为void。