-
Notifications
You must be signed in to change notification settings - Fork 28
/
interface.go
116 lines (91 loc) · 4.41 KB
/
interface.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
package storage
import (
"github.com/golang/protobuf/proto"
"golang.org/x/net/context"
)
// Error type
type Error string
func (e Error) Error() string {
return string(e)
}
// Errors
const (
NotFound = Error("key not found")
AlreadyExists = Error("key already exists")
)
// Interface must be implemented for a key/value store
type Interface interface {
// Endpoints returns an array of endpoints for the storage
Endpoints() []string
// Connect to etcd using client v3 api
Connect() error
// Close connection to etcd
Close() error
// Create adds a new object at a key unless it already exists. 'ttl' is time-to-live
// in seconds (0 means forever). If no error is returned and out is not nil, out will be
// set to the read value from database.
Create(ctx context.Context, key string, val proto.Message, out proto.Message, ttl int64) error
// Put adds a new value to a key if the key does not already exist; else it updates the value passed
// to the specified key. 'ttl' is time-to-live in seconds (0 means forever).
Put(ctx context.Context, key string, val proto.Message, ttl int64) error
// Get unmarshals the protocol buffer message found at key into out, if found.
// If not found and ignoreNotFound is set, then out will be a zero object, otherwise
// error will be set to not found. A non-existing node or an empty response are both
// treated as not found.
Get(ctx context.Context, key string, out proto.Message, ignoreNotFound bool) error
// Delete(ctx context.Context, key string, recurse bool, out proto.Message) error
// TODO: will need to add preconditions support
// if recurse then all the key having the same path under 'key' are going to be deleted
// if !recurse then only 'key' is going to be deleted
Delete(ctx context.Context, key string, recurse bool, out proto.Message) error
// Update performs a guaranteed update, which means it will continue to retry until an update succeeds or the request is canceled.
Update(ctx context.Context, key string, uf UpdateFunc, template proto.Message) error
// List returns all the values that match the filter.
List(ctx context.Context, key string, filter Filter, obj proto.Message, out *[]proto.Message) error
// Watch begins watching the specified key.
Watch(ctx context.Context, key string, resourceVersion int64, filter Filter) (WatchInterface, error)
// WatchList begins watching the specified key's items.
WatchList(ctx context.Context, key string, resourceVersion int64, filter Filter) (WatchInterface, error)
// CompareAndSet atomically sets the value to the given updated value if the current value == the expected value
CompareAndSet(ctx context.Context, key string, expect proto.Message, update proto.Message) error
}
// UpdateFunc represents a function that will perform the update on a given object
// It gets the current object as input and returns the updated object as output
// If the function returns an error, the update is cancelled. Interface.Update will return this error
// If the function returns no error and nil data, the update doesn't need to be performed. Interface.Update will exit successfully without updating the object.
type UpdateFunc func(current proto.Message) (updated proto.Message, err error)
// Filter is the interface used for storage operations that apply to sets (list, find, update).
type Filter interface {
// Filter is a predicate that inspects a value (protocol buffer message instance) and returns true if and only if the value should remain in the set
Filter(val proto.Message) bool
}
// Everything is a Filter which accepts every object.
var Everything Filter = everything{}
// everything is an implementation of Everything.
type everything struct {
}
// Filter implements the Filter interface to accept every object.
func (e everything) Filter(val proto.Message) bool {
return true
}
// WatchInterface can be implemented by anything that knows how to watch and report changes.
type WatchInterface interface {
// Stops watching. Will close the channel returned by ResultChan(). Releases
// any resources used by the watch.
Stop()
// Returns a chan which will receive all the events. If an error occurs
// or Stop() is called, this channel will be closed, in which case the
// watch should be completely cleaned up.
ResultChan() <-chan Event
}
// Event represent a watch event
type Event struct {
Key string
Value []byte
Revision int64
IsCreated bool
IsDeleted bool
// Error management
Error error
IsError bool
}