/usr/share/gocode/src/github.com/couchbase/moss/wrap.go is in golang-github-couchbase-moss-dev 0.0~git20170914.0.07c86e8-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | // Copyright (c) 2016 Couchbase, Inc.
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the
// License. You may obtain a copy of the License at
// http://www.apache.org/licenses/LICENSE-2.0
// Unless required by applicable law or agreed to in writing,
// software distributed under the License is distributed on an "AS
// IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
// express or implied. See the License for the specific language
// governing permissions and limitations under the License.
package moss
import (
"io"
"sync"
)
// SnapshotWrapper implements the moss.Snapshot interface.
type SnapshotWrapper struct {
m sync.Mutex
refCount uint64
ss Snapshot
closer io.Closer // Optional, may be nil.
}
// NewSnapshotWrapper creates a wrapper which provides ref-counting
// around a snapshot. The snapshot (and an optional io.Closer) will
// be closed when the ref-count reaches zero.
func NewSnapshotWrapper(ss Snapshot, closer io.Closer) *SnapshotWrapper {
if ss == nil {
return nil
}
return &SnapshotWrapper{refCount: 1, ss: ss, closer: closer}
}
func (w *SnapshotWrapper) addRef() *SnapshotWrapper {
if w != nil {
w.m.Lock()
w.refCount++
w.m.Unlock()
}
return w
}
func (w *SnapshotWrapper) decRef() (err error) {
w.m.Lock()
w.refCount--
if w.refCount <= 0 {
if w.ss != nil {
err = w.ss.Close()
w.ss = nil
}
if w.closer != nil {
w.closer.Close()
w.closer = nil
}
}
w.m.Unlock()
return err
}
// ChildCollectionNames returns an array of child collection name strings.
func (w *SnapshotWrapper) ChildCollectionNames() ([]string, error) {
w.m.Lock()
defer w.m.Unlock()
if w.ss != nil {
return w.ss.ChildCollectionNames()
}
return nil, nil
}
// ChildCollectionSnapshot returns a Snapshot on a given child
// collection by its name.
func (w *SnapshotWrapper) ChildCollectionSnapshot(childCollectionName string) (
Snapshot, error) {
w.m.Lock()
defer w.m.Unlock()
if w.ss != nil {
return w.ss.ChildCollectionSnapshot(childCollectionName)
}
return nil, nil
}
// Close will decRef the underlying snapshot.
func (w *SnapshotWrapper) Close() (err error) {
return w.decRef()
}
// Get returns the key from the underlying snapshot.
func (w *SnapshotWrapper) Get(key []byte, readOptions ReadOptions) (
[]byte, error) {
return w.ss.Get(key, readOptions)
}
// StartIterator initiates a start iterator over the underlying snapshot.
func (w *SnapshotWrapper) StartIterator(
startKeyInclusive, endKeyExclusive []byte,
iteratorOptions IteratorOptions,
) (Iterator, error) {
return w.ss.StartIterator(startKeyInclusive, endKeyExclusive,
iteratorOptions)
}
|