Apache Pulsar Go 客户端库使用教程

Apache Pulsar Go 客户端库使用教程

pulsar-client-goApache Pulsar Go Client Library项目地址:https://gitcode.com/gh_mirrors/pul/pulsar-client-go

1. 项目的目录结构及介绍

Apache Pulsar Go 客户端库的目录结构如下：

pulsar-client-go/
├── admin
├── auth
├── client
├── cmd
├── common
├── config
├── consumer
├── internal
├── oauth2
├── producer
├── proto
├── reader
├── schema
├── utils
├── CONTRIBUTING.md
├── Dockerfile
├── go.mod
├── go.sum
├── LICENSE
├── Makefile
├── README.md
└── VERSION

目录介绍

• admin: 包含与 Pulsar 管理 API 交互的代码。
• auth: 包含身份验证相关的代码。
• client: 包含 Pulsar 客户端的主要实现。
• cmd: 包含命令行工具的代码。
• common: 包含通用工具和辅助函数。
• config: 包含配置文件和配置相关的代码。
• consumer: 包含消费者相关的代码。
• internal: 包含内部使用的辅助函数和工具。
• oauth2: 包含 OAuth2 身份验证的实现。
• producer: 包含生产者相关的代码。
• proto: 包含协议缓冲区定义。
• reader: 包含读者相关的代码。
• schema: 包含模式相关的代码。
• utils: 包含通用工具函数。
• CONTRIBUTING.md: 贡献指南。
• Dockerfile: Docker 镜像构建文件。
• go.mod: Go 模块文件。
• go.sum: Go 模块校验文件。
• LICENSE: 许可证文件。
• Makefile: 构建和测试的 Makefile。
• README.md: 项目介绍和使用说明。
• VERSION: 版本文件。

2. 项目的启动文件介绍

在 pulsar-client-go 项目中，没有特定的“启动文件”，因为这是一个库项目，而不是一个可执行的应用程序。不过，你可以通过以下步骤来初始化和使用 Pulsar Go 客户端：

初始化客户端

package main

import (
    "log"
    "context"
    "github.com/apache/pulsar-client-go/pulsar"
)

func main() {
    client, err := pulsar.NewClient(pulsar.ClientOptions{
        URL: "pulsar://localhost:6650",
    })
    if err != nil {
        log.Fatalf("Could not instantiate Pulsar client: %v", err)
    }
    defer client.Close()

    // 创建生产者、消费者或读者
    // ...
}

创建生产者

producer, err := client.CreateProducer(pulsar.ProducerOptions{
    Topic: "my-topic",
})
if err != nil {
    log.Fatalf("Could not create producer: %v", err)
}
defer producer.Close()

创建消费者

consumer, err := client.Subscribe(pulsar.ConsumerOptions{
    Topic:            "my-topic",
    SubscriptionName: "my-subscription",
    Type:             pulsar.Shared,
})
if err != nil {
    log.Fatalf("Could not create consumer: %v", err)
}
defer consumer.Close()

创建读者

reader, err := client.CreateReader(pulsar.ReaderOptions{
    Topic:          "my-topic",
    StartMessageID: pulsar.EarliestMessageID(),
})
if err != nil {
    log.Fatalf("Could not create reader: %v", err)
}
defer reader.Close()

3. 项目的配置文件介绍

在 pulsar-client-go 项目中，配置主要通过代码中的选项结构体来完成，而不是通过传统的配置文件。以下是一些常用的配置选项：

客户端配置

client, err := pulsar.NewClient(pulsar.ClientOptions{
    URL:               "pulsar://localhost:6650",
    OperationTimeout:  30 * time.Second,
    ConnectionTimeout: 30 * time.Second,
})

生产者配置

producer, err := client.CreateProducer(pulsar.ProducerOptions{
    Topic:  "my-topic

pulsar-client-goApache Pulsar Go Client Library项目地址:https://gitcode.com/gh_mirrors/pul/pulsar-client-go