1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165
|
// Tideland Go Library - Redis Client - Subscription
//
// Copyright (C) 2009-2017 Frank Mueller / Oldenburg / Germany
//
// All rights reserved. Use of this source code is governed
// by the new BSD license.
package redis
//--------------------
// IMPORTS
//--------------------
import (
"strings"
"github.com/tideland/golib/errors"
)
//--------------------
// SUBSCRIPTION
//--------------------
// Subscription manages a subscription to Redis channels and allows
// to subscribe and unsubscribe from channels.
type Subscription struct {
database *Database
resp *resp
}
// newSubscription creates a new subscription.
func newSubscription(db *Database) (*Subscription, error) {
sub := &Subscription{
database: db,
}
err := sub.ensureProtocol()
if err != nil {
return nil, err
}
// Perform authentication and database selection.
err = sub.resp.authenticate()
if err != nil {
sub.database.pool.kill(sub.resp)
return nil, err
}
return sub, nil
}
// Subscribe adds one or more channels to the subscription.
func (sub *Subscription) Subscribe(channels ...string) error {
return sub.subUnsub("subscribe", channels...)
}
// Unsubscribe removes one or more channels from the subscription.
func (sub *Subscription) Unsubscribe(channels ...string) error {
return sub.subUnsub("unsubscribe", channels...)
}
// subUnsub is the generic subscription and unsubscription method.
func (sub *Subscription) subUnsub(cmd string, channels ...string) error {
err := sub.ensureProtocol()
if err != nil {
return err
}
pattern := false
args := []interface{}{}
for _, channel := range channels {
if containsPattern(channel) {
pattern = true
}
args = append(args, channel)
}
if pattern {
cmd = "p" + cmd
}
err = sub.resp.sendCommand(cmd, args...)
logCommand(cmd, args, err, sub.database.logging)
return err
}
// Pop waits for a published value and returns it.
func (sub *Subscription) Pop() (*PublishedValue, error) {
err := sub.ensureProtocol()
if err != nil {
return nil, err
}
result, err := sub.resp.receiveResultSet()
if err != nil {
return nil, err
}
// Analyse the result.
kind, err := result.StringAt(0)
if err != nil {
return nil, err
}
switch {
case strings.Contains(kind, "message"):
channel, err := result.StringAt(1)
if err != nil {
return nil, err
}
value, err := result.ValueAt(2)
if err != nil {
return nil, err
}
return &PublishedValue{
Kind: kind,
Channel: channel,
Value: value,
}, nil
case strings.Contains(kind, "subscribe"):
channel, err := result.StringAt(1)
if err != nil {
return nil, err
}
count, err := result.IntAt(2)
if err != nil {
return nil, err
}
return &PublishedValue{
Kind: kind,
Channel: channel,
Count: count,
}, nil
default:
return nil, errors.New(ErrInvalidResponse, errorMessages, result)
}
}
// Close ends the subscription.
func (sub *Subscription) Close() error {
err := sub.ensureProtocol()
if err != nil {
return err
}
err = sub.resp.sendCommand("punsubscribe")
if err != nil {
return err
}
for {
pv, err := sub.Pop()
if err != nil {
return err
}
if pv.Kind == "punsubscribe" {
break
}
}
sub.database.pool.push(sub.resp)
return nil
}
// ensureProtocol retrieves a protocol from the pool if needed.
func (sub *Subscription) ensureProtocol() error {
if sub.resp == nil {
p, err := sub.database.pool.pull(forcedPull)
if err != nil {
return err
}
sub.resp = p
}
return nil
}
// EOF
|