知识卡片

普通读书笔记卡

管理接口须返回结果

理解等级:中级

把管理命令集成到程序时,终端打印不等于调用者取得结果。书中的 TopicCommand.main() 返回 void:调用 describe 后终端能显示主题详情,程序却无法从返回值读取详情。AdminClient 的各操作返回结果对象,查询类结果可携带主题或配置信息,让调用者继续判断和处理。这个差别是选择管理接口的依据,不只是把命令字符串搬进代码。

这张卡片看不懂?

已有反馈 · 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。