forked from couchbase/gocb
/
bucket_crud.go
227 lines (199 loc) · 6.66 KB
/
bucket_crud.go
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
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
package gocb
import (
"github.com/couchbaselabs/gocb/gocbcore"
)
type ioGetCallback func([]byte, uint32, gocbcore.Cas, error)
type ioCasCallback func(gocbcore.Cas, error)
type ioCtrCallback func(uint64, gocbcore.Cas, error)
type hlpGetHandler func(ioGetCallback) (pendingOp, error)
func (b *Bucket) hlpGetExec(valuePtr interface{}, execFn hlpGetHandler) (casOut Cas, errOut error) {
signal := make(chan bool, 1)
op, err := execFn(func(bytes []byte, flags uint32, cas gocbcore.Cas, err error) {
errOut = err
if errOut == nil {
errOut = b.transcoder.Decode(bytes, flags, valuePtr)
if errOut == nil {
casOut = Cas(cas)
}
}
signal <- true
})
if err != nil {
return 0, err
}
timeoutTmr := acquireTimer(b.opTimeout)
select {
case <-signal:
releaseTimer(timeoutTmr, false)
return
case <-timeoutTmr.C:
releaseTimer(timeoutTmr, true)
op.Cancel()
return 0, timeoutError{}
}
}
type hlpCasHandler func(ioCasCallback) (pendingOp, error)
func (b *Bucket) hlpCasExec(execFn hlpCasHandler) (casOut Cas, errOut error) {
signal := make(chan bool, 1)
op, err := execFn(func(cas gocbcore.Cas, err error) {
errOut = err
if errOut == nil {
casOut = Cas(cas)
}
signal <- true
})
if err != nil {
return 0, err
}
timeoutTmr := acquireTimer(b.opTimeout)
select {
case <-signal:
releaseTimer(timeoutTmr, false)
return
case <-timeoutTmr.C:
releaseTimer(timeoutTmr, true)
op.Cancel()
return 0, timeoutError{}
}
}
type hlpCtrHandler func(ioCtrCallback) (pendingOp, error)
func (b *Bucket) hlpCtrExec(execFn hlpCtrHandler) (valOut uint64, casOut Cas, errOut error) {
signal := make(chan bool, 1)
op, err := execFn(func(value uint64, cas gocbcore.Cas, err error) {
errOut = err
if errOut == nil {
valOut = value
casOut = Cas(cas)
}
signal <- true
})
if err != nil {
return 0, 0, err
}
timeoutTmr := acquireTimer(b.opTimeout)
select {
case <-signal:
releaseTimer(timeoutTmr, false)
return
case <-timeoutTmr.C:
releaseTimer(timeoutTmr, true)
op.Cancel()
return 0, 0, timeoutError{}
}
}
// Retrieves a document from the bucket
func (b *Bucket) Get(key string, valuePtr interface{}) (Cas, error) {
return b.hlpGetExec(valuePtr, func(cb ioGetCallback) (pendingOp, error) {
op, err := b.client.Get([]byte(key), gocbcore.GetCallback(cb))
return op, err
})
}
// Retrieves a document and simultaneously updates its expiry time.
func (b *Bucket) GetAndTouch(key string, expiry uint32, valuePtr interface{}) (Cas, error) {
return b.hlpGetExec(valuePtr, func(cb ioGetCallback) (pendingOp, error) {
op, err := b.client.GetAndTouch([]byte(key), expiry, gocbcore.GetCallback(cb))
return op, err
})
}
// Locks a document for a period of time, providing exclusive RW access to it.
func (b *Bucket) GetAndLock(key string, lockTime uint32, valuePtr interface{}) (Cas, error) {
return b.hlpGetExec(valuePtr, func(cb ioGetCallback) (pendingOp, error) {
op, err := b.client.GetAndLock([]byte(key), lockTime, gocbcore.GetCallback(cb))
return op, err
})
}
// Unlocks a document which was locked with GetAndLock.
func (b *Bucket) Unlock(key string, cas Cas) (Cas, error) {
return b.hlpCasExec(func(cb ioCasCallback) (pendingOp, error) {
op, err := b.client.Unlock([]byte(key), gocbcore.Cas(cas), gocbcore.UnlockCallback(cb))
return op, err
})
}
// Returns the value of a particular document from a replica server.
func (b *Bucket) GetReplica(key string, valuePtr interface{}, replicaIdx int) (Cas, error) {
return b.hlpGetExec(valuePtr, func(cb ioGetCallback) (pendingOp, error) {
op, err := b.client.GetReplica([]byte(key), replicaIdx, gocbcore.GetCallback(cb))
return op, err
})
}
// Touches a document, specifying a new expiry time for it.
func (b *Bucket) Touch(key string, cas Cas, expiry uint32) (Cas, error) {
return b.hlpCasExec(func(cb ioCasCallback) (pendingOp, error) {
op, err := b.client.Touch([]byte(key), gocbcore.Cas(cas), expiry, gocbcore.TouchCallback(cb))
return op, err
})
}
// Removes a document from the bucket.
func (b *Bucket) Remove(key string, cas Cas) (Cas, error) {
return b.hlpCasExec(func(cb ioCasCallback) (pendingOp, error) {
op, err := b.client.Remove([]byte(key), gocbcore.Cas(cas), gocbcore.RemoveCallback(cb))
return op, err
})
}
// Inserts or replaces a document in the bucket.
func (b *Bucket) Upsert(key string, value interface{}, expiry uint32) (Cas, error) {
bytes, flags, err := b.transcoder.Encode(value)
if err != nil {
return 0, err
}
return b.hlpCasExec(func(cb ioCasCallback) (pendingOp, error) {
op, err := b.client.Set([]byte(key), bytes, flags, expiry, gocbcore.StoreCallback(cb))
return op, err
})
}
// Inserts a new document to the bucket.
func (b *Bucket) Insert(key string, value interface{}, expiry uint32) (Cas, error) {
bytes, flags, err := b.transcoder.Encode(value)
if err != nil {
return 0, err
}
return b.hlpCasExec(func(cb ioCasCallback) (pendingOp, error) {
op, err := b.client.Add([]byte(key), bytes, flags, expiry, gocbcore.StoreCallback(cb))
return op, err
})
}
// Replaces a document in the bucket.
func (b *Bucket) Replace(key string, value interface{}, cas Cas, expiry uint32) (Cas, error) {
bytes, flags, err := b.transcoder.Encode(value)
if err != nil {
return 0, err
}
return b.hlpCasExec(func(cb ioCasCallback) (pendingOp, error) {
op, err := b.client.Replace([]byte(key), bytes, flags, gocbcore.Cas(cas), expiry, gocbcore.StoreCallback(cb))
return op, err
})
}
// Appends a string value to a document.
func (b *Bucket) Append(key, value string) (Cas, error) {
return b.hlpCasExec(func(cb ioCasCallback) (pendingOp, error) {
op, err := b.client.Append([]byte(key), []byte(value), gocbcore.StoreCallback(cb))
return op, err
})
}
// Prepends a string value to a document.
func (b *Bucket) Prepend(key, value string) (Cas, error) {
return b.hlpCasExec(func(cb ioCasCallback) (pendingOp, error) {
op, err := b.client.Prepend([]byte(key), []byte(value), gocbcore.StoreCallback(cb))
return op, err
})
}
// Performs an atomic addition or subtraction for an integer document.
func (b *Bucket) Counter(key string, delta, initial int64, expiry uint32) (uint64, Cas, error) {
realInitial := uint64(0xFFFFFFFFFFFFFFFF)
if initial > 0 {
realInitial = uint64(initial)
}
if delta > 0 {
return b.hlpCtrExec(func(cb ioCtrCallback) (pendingOp, error) {
op, err := b.client.Increment([]byte(key), uint64(delta), realInitial, expiry, gocbcore.CounterCallback(cb))
return op, err
})
} else if delta < 0 {
return b.hlpCtrExec(func(cb ioCtrCallback) (pendingOp, error) {
op, err := b.client.Decrement([]byte(key), uint64(-delta), realInitial, expiry, gocbcore.CounterCallback(cb))
return op, err
})
} else {
return 0, 0, clientError{"Delta must be a non-zero value."}
}
}