6bdf33c4ee
- auto and manual acking - retry limits
134 lines
4.2 KiB
Go
134 lines
4.2 KiB
Go
package events
|
|
|
|
import "time"
|
|
|
|
// PublishOptions contains all the options which can be provided when publishing an event
|
|
type PublishOptions struct {
|
|
// Metadata contains any keys which can be used to query the data, for example a customer id
|
|
Metadata map[string]string
|
|
// Timestamp to set for the event, if the timestamp is a zero value, the current time will be used
|
|
Timestamp time.Time
|
|
}
|
|
|
|
// PublishOption sets attributes on PublishOptions
|
|
type PublishOption func(o *PublishOptions)
|
|
|
|
// WithMetadata sets the Metadata field on PublishOptions
|
|
func WithMetadata(md map[string]string) PublishOption {
|
|
return func(o *PublishOptions) {
|
|
o.Metadata = md
|
|
}
|
|
}
|
|
|
|
// WithTimestamp sets the timestamp field on PublishOptions
|
|
func WithTimestamp(t time.Time) PublishOption {
|
|
return func(o *PublishOptions) {
|
|
o.Timestamp = t
|
|
}
|
|
}
|
|
|
|
// SubscribeOptions contains all the options which can be provided when subscribing to a topic
|
|
type SubscribeOptions struct {
|
|
// Queue is the name of the subscribers queue, if two subscribers have the same queue the message
|
|
// should only be published to one of them
|
|
Queue string
|
|
// StartAtTime is the time from which the messages should be consumed from. If not provided then
|
|
// the messages will be consumed starting from the moment the Subscription starts.
|
|
StartAtTime time.Time
|
|
// AutoAck if true (default true), automatically acknowledges every message so it will not be redelivered.
|
|
// If false specifies that each message need ts to be manually acknowledged by the subscriber.
|
|
// If processing is successful the message should be ack'ed to remove the message from the stream.
|
|
// If processing is unsuccessful the message should be nack'ed (negative acknowledgement) which will mean it will
|
|
// remain on the stream to be processed again.
|
|
AutoAck bool
|
|
AckWait time.Duration
|
|
// RetryLimit indicates number of times a message is retried
|
|
RetryLimit int
|
|
// CustomRetries indicates whether to use RetryLimit
|
|
CustomRetries bool
|
|
}
|
|
|
|
// SubscribeOption sets attributes on SubscribeOptions
|
|
type SubscribeOption func(o *SubscribeOptions)
|
|
|
|
// WithQueue sets the Queue fielf on SubscribeOptions to the value provided
|
|
func WithQueue(q string) SubscribeOption {
|
|
return func(o *SubscribeOptions) {
|
|
o.Queue = q
|
|
}
|
|
}
|
|
|
|
// WithStartAtTime sets the StartAtTime field on SubscribeOptions to the value provided
|
|
func WithStartAtTime(t time.Time) SubscribeOption {
|
|
return func(o *SubscribeOptions) {
|
|
o.StartAtTime = t
|
|
}
|
|
}
|
|
|
|
// WithAutoAck sets the AutoAck field on SubscribeOptions and an ackWait duration after which if no ack is received
|
|
// the message is requeued in case auto ack is turned off
|
|
func WithAutoAck(ack bool, ackWait time.Duration) SubscribeOption {
|
|
return func(o *SubscribeOptions) {
|
|
o.AutoAck = ack
|
|
o.AckWait = ackWait
|
|
}
|
|
}
|
|
|
|
// WithRetryLimit sets the RetryLimit field on SubscribeOptions.
|
|
// Set to -1 for infinite retries (default)
|
|
func WithRetryLimit(retries int) SubscribeOption {
|
|
return func(o *SubscribeOptions) {
|
|
o.RetryLimit = retries
|
|
o.CustomRetries = true
|
|
}
|
|
}
|
|
|
|
func (s SubscribeOptions) GetRetryLimit() int {
|
|
if !s.CustomRetries {
|
|
return -1
|
|
}
|
|
return s.RetryLimit
|
|
}
|
|
|
|
// WriteOptions contains all the options which can be provided when writing an event to a store
|
|
type WriteOptions struct {
|
|
// TTL is the duration the event should be recorded for, a zero value TTL indicates the event should
|
|
// be stored indefinately
|
|
TTL time.Duration
|
|
}
|
|
|
|
// WriteOption sets attributes on WriteOptions
|
|
type WriteOption func(o *WriteOptions)
|
|
|
|
// WithTTL sets the TTL attribute on WriteOptions
|
|
func WithTTL(d time.Duration) WriteOption {
|
|
return func(o *WriteOptions) {
|
|
o.TTL = d
|
|
}
|
|
}
|
|
|
|
// ReadOptions contains all the options which can be provided when reading events from a store
|
|
type ReadOptions struct {
|
|
// Limit the number of results to return
|
|
Limit uint
|
|
// Offset the results by this number, useful for paginated queries
|
|
Offset uint
|
|
}
|
|
|
|
// ReadOption sets attributes on ReadOptions
|
|
type ReadOption func(o *ReadOptions)
|
|
|
|
// ReadLimit sets the limit attribute on ReadOptions
|
|
func ReadLimit(l uint) ReadOption {
|
|
return func(o *ReadOptions) {
|
|
o.Limit = 1
|
|
}
|
|
}
|
|
|
|
// ReadOffset sets the offset attribute on ReadOptions
|
|
func ReadOffset(l uint) ReadOption {
|
|
return func(o *ReadOptions) {
|
|
o.Offset = 1
|
|
}
|
|
}
|