Kafka Go客户端使用与技术文档

本文档旨在帮助用户安装、使用及详细了解基于Go语言的Kafka客户端，该客户端支持Kafka 0.7.x版本。以下是项目的安装指南、使用说明和API使用文档。

1. 安装指南

首先，确保安装了Go语言环境（版本1或更高）：

• 访问 Go官方安装指南 获取安装信息。
• 确保正确设置GOROOT环境变量 参考文档。
• 设置适当的GOPATH环境变量 参考文档。

安装完成后，从源代码构建项目：

make kafka

构建工具（发布者和消费者）：

make tools

启动Zookeeper和Kafka服务器：

• 参考Kafka官方文档 快速入门指南。

2. 项目的使用说明

启动消费者

启动消费者，该消费者将持续监听直到接收到消息：

$GOPATH/bin/consumer -topic test -consumeforever

发布消息

使用发布者向Kafka主题发布消息：

$GOPATH/bin/publisher -topic test -message "Hello World"

消费者应该输出接收到的消息。

3. 项目API使用文档

发布消息

broker := kafka.NewBrokerPublisher("localhost:9092", "mytesttopic", 0)
broker.Publish(kafka.NewMessage([]byte("testing 1 2 3")))

发布压缩消息

broker := kafka.NewBrokerPublisher("localhost:9092", "mytesttopic", 0)
broker.Publish(kafka.NewCompressedMessage([]byte("testing 1 2 3")))

消费者

broker := kafka.NewBrokerConsumer("localhost:9092", "mytesttopic", 0, 0, 1048576)
broker.Consume(func(msg *kafka.Message) { msg.Print() })

或者，消费者可以使用基于通道的方法：

broker := kafka.NewBrokerConsumer("localhost:9092", "mytesttopic", 0, 0, 1048576)
go broker.ConsumeOnChannel(msgChan, 10, quitChan)

消费偏移量

broker := kafka.NewBrokerOffsetConsumer("localhost:9092", "mytesttopic", 0)
offsets, err := broker.GetOffsets(-1, 1)

4. 项目安装方式

项目安装方式已在“安装指南”部分详细说明。确保遵循以上步骤以正确安装和使用Kafka Go客户端。