commit | c6d905ddc6e05f0ddd45689f5a46cb9cfa062b71 | [log] [tgz] |
---|---|---|
author | dferstay <dferstay@users.noreply.github.com> | Thu Jul 23 19:17:29 2020 -0700 |
committer | GitHub <noreply@github.com> | Thu Jul 23 19:17:29 2020 -0700 |
tree | 2d015b1329fccb1e2fead6feab87f01aa33bddce | |
parent | c75aa626183fb4086a9438215e9c55fed16565d9 [diff] |
Different MessageID implementations for message Production and Consumption (#324) This change splits the `MessageID` implementation in two: 1. `messageID` - A 24 byte structure that contains message identification information only; to be used during message production 2. `trackingMessageID` - A 72 byte structucture that shares the same message identification information as `messageID` and adds `ackTracker`, `acker`, and `receivedTime` fields; to be used during message consumption Micro benchmarks show that passing arguments by value that are less-than four words of memory are optimized by the Go runtime. Results from the pulsar/impl_message_bench_test.go module are below. ``` name time/op ProducerCall 1.46ns ± 5% ProducerCall-4 1.47ns ± 5% ConsumerCall 7.62ns ± 1% ConsumerCall-4 7.53ns ± 5% ``` Co-authored-by: Daniel Ferstay <dferstay@splunk.com>
A Go client library for the Apache Pulsar project.
This projects is developing a pure-Go client library for Pulsar that does not depend on the C++ Pulsar library.
Once feature parity and stability are reached, this will supersede the current CGo based library.
Check the Projects page at https://github.com/apache/pulsar-client-go/projects for tracking the status and the progress.
Import the client library:
import "github.com/apache/pulsar-client-go/pulsar"
Create a Producer:
client, err := pulsar.NewClient(pulsar.ClientOptions{
URL: "pulsar://localhost:6650",
})
defer client.Close()
producer, err := client.CreateProducer(pulsar.ProducerOptions{
Topic: "my-topic",
})
_, err = producer.Send(context.Background(), &pulsar.ProducerMessage{
Payload: []byte("hello"),
})
defer producer.Close()
if err != nil {
fmt.Println("Failed to publish message", err)
}
fmt.Println("Published message")
Create a Consumer:
client, err := pulsar.NewClient(pulsar.ClientOptions{
URL: "pulsar://localhost:6650",
})
defer client.Close()
consumer, err := client.Subscribe(pulsar.ConsumerOptions{
Topic: "my-topic",
SubscriptionName: "my-sub",
Type: pulsar.Shared,
})
defer consumer.Close()
msg, err := consumer.Receive(context.Background())
if err != nil {
log.Fatal(err)
}
fmt.Printf("Received message msgId: %#v -- content: '%s'\n",
msg.ID(), string(msg.Payload()))
Create a Reader:
client, err := pulsar.NewClient(pulsar.ClientOptions{URL: "pulsar://localhost:6650"})
if err != nil {
log.Fatal(err)
}
defer client.Close()
reader, err := client.CreateReader(pulsar.ReaderOptions{
Topic: "topic-1",
StartMessageID: pulsar.EarliestMessageID(),
})
if err != nil {
log.Fatal(err)
}
defer reader.Close()
for reader.HasNext() {
msg, err := reader.Next(context.Background())
if err != nil {
log.Fatal(err)
}
fmt.Printf("Received message msgId: %#v -- content: '%s'\n",
msg.ID(), string(msg.Payload()))
}
Contributions are welcomed and greatly appreciated. See CONTRIBUTING.md for details on submitting patches and the contribution workflow.
Name | Scope | |||
---|---|---|---|---|
users@pulsar.apache.org | User-related discussions | Subscribe | Unsubscribe | Archives |
dev@pulsar.apache.org | Development-related discussions | Subscribe | Unsubscribe | Archives |
Pulsar slack channel #dev-go
at https://apache-pulsar.slack.com/
You can self-register at https://apache-pulsar.herokuapp.com/
Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0