2014-07-30 18:30:38 +02:00
|
|
|
// Copyright (c) 2014 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.
|
2014-09-02 16:54:50 +02:00
|
|
|
|
2014-05-09 22:37:04 +02:00
|
|
|
package store
|
|
|
|
|
2015-09-23 20:25:47 +02:00
|
|
|
// KVStore is an abstraction for working with KV stores
|
|
|
|
type KVStore interface {
|
|
|
|
|
|
|
|
// Writer returns a KVWriter which can be used to
|
|
|
|
// make changes to the KVStore. If a writer cannot
|
|
|
|
// be obtained a non-nil error is returned.
|
|
|
|
Writer() (KVWriter, error)
|
|
|
|
|
|
|
|
// Reader returns a KVReader which can be used to
|
|
|
|
// read data from the KVStore. If a reader cannot
|
|
|
|
// be obtained a non-nil error is returned.
|
|
|
|
Reader() (KVReader, error)
|
|
|
|
|
|
|
|
// Close closes the KVStore
|
2014-05-09 22:37:04 +02:00
|
|
|
Close() error
|
|
|
|
}
|
|
|
|
|
2015-09-23 20:25:47 +02:00
|
|
|
// KVReader is an abstraction of an **ISOLATED** reader
|
|
|
|
// In this context isolated is defined to mean that
|
|
|
|
// writes/deletes made after the KVReader is opened
|
|
|
|
// are not observed.
|
|
|
|
// Because there is usually a cost associated with
|
|
|
|
// keeping isolated readers active, users should
|
|
|
|
// close them as soon as they are no longer needed.
|
|
|
|
type KVReader interface {
|
|
|
|
|
|
|
|
// Get returns the value associated with the key
|
|
|
|
// If the key does not exist, nil is returned.
|
|
|
|
// The caller owns the bytes returned.
|
|
|
|
Get(key []byte) ([]byte, error)
|
|
|
|
|
|
|
|
// PrefixIterator returns a KVIterator that will
|
|
|
|
// visit all K/V pairs with the provided prefix
|
|
|
|
PrefixIterator(prefix []byte) KVIterator
|
|
|
|
|
|
|
|
// RangeIterator returns a KVIterator that will
|
|
|
|
// visit all K/V pairs >= start AND < end
|
|
|
|
RangeIterator(start, end []byte) KVIterator
|
|
|
|
|
|
|
|
// Close closes the iterator
|
|
|
|
Close() error
|
|
|
|
}
|
|
|
|
|
|
|
|
// KVIterator is an abstraction around key iteration
|
2014-05-09 22:37:04 +02:00
|
|
|
type KVIterator interface {
|
2015-09-23 20:25:47 +02:00
|
|
|
|
|
|
|
// Seek will advance the iterator to the specified key
|
|
|
|
Seek(key []byte)
|
|
|
|
|
|
|
|
// Next will advance the iterator to the next key
|
2014-05-09 22:37:04 +02:00
|
|
|
Next()
|
|
|
|
|
2015-09-23 20:25:47 +02:00
|
|
|
// Key returns the key pointed to by the iterator
|
|
|
|
// The bytes returned are **ONLY** valid until the next call to Seek/Next/Close
|
|
|
|
// Continued use after that requires that they be copied.
|
2014-05-09 22:37:04 +02:00
|
|
|
Key() []byte
|
2015-09-23 20:25:47 +02:00
|
|
|
|
|
|
|
// Value returns the value pointed to by the iterator
|
|
|
|
// The bytes returned are **ONLY** valid until the next call to Seek/Next/Close
|
|
|
|
// Continued use after that requires that they be copied.
|
2014-05-09 22:37:04 +02:00
|
|
|
Value() []byte
|
2015-09-23 20:25:47 +02:00
|
|
|
|
|
|
|
// Valid returns whether or not the iterator is in a valid state
|
2014-05-09 22:37:04 +02:00
|
|
|
Valid() bool
|
|
|
|
|
2015-09-23 20:25:47 +02:00
|
|
|
// Current returns Key(),Value(),Valid() in a single operation
|
|
|
|
Current() ([]byte, []byte, bool)
|
2014-05-09 22:37:04 +02:00
|
|
|
|
2015-09-23 20:25:47 +02:00
|
|
|
// Close closes the iterator
|
2014-09-12 23:21:35 +02:00
|
|
|
Close() error
|
|
|
|
}
|
|
|
|
|
2015-09-23 20:25:47 +02:00
|
|
|
// KVWriter is an abstraction for mutating the KVStore
|
|
|
|
// KVWriter does **NOT** enforce restrictions of a single writer
|
|
|
|
// if the underlying KVStore allows concurrent writes, the
|
|
|
|
// KVWriter interface should also do so, it is up to the caller
|
|
|
|
// to do this in a way that is safe and makes sense
|
2014-09-12 23:21:35 +02:00
|
|
|
type KVWriter interface {
|
2015-09-23 20:25:47 +02:00
|
|
|
|
|
|
|
// NewBatch returns a KVBatch for performaing batch operations on this kvstore
|
2014-09-12 23:21:35 +02:00
|
|
|
NewBatch() KVBatch
|
2014-05-09 22:37:04 +02:00
|
|
|
|
2015-09-23 20:25:47 +02:00
|
|
|
// ExecuteBatch will execute the KVBatch, the provided KVBatch **MUST** have
|
|
|
|
// been created by the same KVStore (though not necessarily the same KVWriter)
|
|
|
|
// Batch execution is atomic, either all the operations or none will be performed
|
|
|
|
ExecuteBatch(batch KVBatch) error
|
|
|
|
|
|
|
|
// Close closes the writer
|
2014-09-12 23:21:35 +02:00
|
|
|
Close() error
|
|
|
|
}
|
2015-08-18 22:22:02 +02:00
|
|
|
|
2015-09-23 20:25:47 +02:00
|
|
|
// KVBatch is an abstraction for making multiple KV mutations at once
|
|
|
|
type KVBatch interface {
|
|
|
|
|
|
|
|
// Set updates the key with the specified value
|
|
|
|
// both key and value []byte may be reused as soon as this call returns
|
|
|
|
Set(key, val []byte)
|
|
|
|
|
|
|
|
// Delete removes the specified key
|
|
|
|
// the key []byte may be reused as soon as this call returns
|
|
|
|
Delete(key []byte)
|
|
|
|
|
|
|
|
// Merge merges old value with the new value at the specified key
|
|
|
|
// as prescribed by the KVStores merge operator
|
|
|
|
// both key and value []byte may be reused as soon as this call returns
|
|
|
|
Merge(key, val []byte)
|
|
|
|
|
|
|
|
// Reset frees resources for this batch and allows reuse
|
|
|
|
Reset()
|
2016-01-08 02:54:21 +01:00
|
|
|
|
|
|
|
// Close frees resources
|
|
|
|
Close() error
|
2015-08-18 22:22:02 +02:00
|
|
|
}
|