etcdv3

Documentation

Index

• type Client
  • func (client *Client) DelPrefix(ctx context.Context, prefix string) (deleted int64, err error)
  • func (client *Client) GetKeyValue(ctx context.Context, key string) (kv *mvccpb.KeyValue, err error)
  • func (client *Client) GetLeaseSession(ctx context.Context, opts ...concurrency.SessionOption) (leaseSession *concurrency.Session, err error)
  • func (client *Client) GetPrefix(ctx context.Context, prefix string) (map[string]string, error)
  • func (client *Client) GetValues(ctx context.Context, keys ...string) (map[string]string, error)
  • func (client *Client) NewMutex(key string, opts ...concurrency.SessionOption) (mutex *Mutex, err error)
  • func (client *Client) WatchPrefix(ctx context.Context, prefix string) (*Watch, error)
• type Config
  • func DefaultConfig() *Config
  • func RawConfig(key string) *Config
  • func StdConfig(name string) *Config
  • func (config *Config) BindFlags(fs *flag.FlagSet)
  • func (config *Config) Build() (*Client, error)
  • func (config *Config) MustBuild() *Client
  • func (config *Config) MustSingleton() *Client
  • func (config *Config) Singleton() (*Client, error)
  • func (config *Config) WithLogger(logger *xlog.Logger) *Config
• type Mutex
  • func (mutex *Mutex) Lock(timeout time.Duration) (err error)
  • func (mutex *Mutex) TryLock(timeout time.Duration) (err error)
  • func (mutex *Mutex) Unlock() (err error)
• type Watch
  • func (w *Watch) C() chan *clientv3.Event
  • func (w *Watch) Close() error
  • func (w *Watch) IncipientKeyValues() []*mvccpb.KeyValue

Types

type Client

type Client struct {
	*clientv3.Client
	// contains filtered or unexported fields
}

Client ...

func (*Client) DelPrefix

func (client *Client) DelPrefix(ctx context.Context, prefix string) (deleted int64, err error)

DelPrefix 按前缀删除

func (*Client) GetKeyValue

func (client *Client) GetKeyValue(ctx context.Context, key string) (kv *mvccpb.KeyValue, err error)

GetKeyValue queries etcd key, returns mvccpb.KeyValue

func (*Client) GetLeaseSession

func (client *Client) GetLeaseSession(ctx context.Context, opts ...concurrency.SessionOption) (leaseSession *concurrency.Session, err error)

GetLeaseSession 创建租约会话

func (*Client) GetPrefix

func (client *Client) GetPrefix(ctx context.Context, prefix string) (map[string]string, error)

GetPrefix get prefix

func (*Client) GetValues

func (client *Client) GetValues(ctx context.Context, keys ...string) (map[string]string, error)

GetValues queries etcd for keys prefixed by prefix.

func (*Client) NewMutex

func (client *Client) NewMutex(key string, opts ...concurrency.SessionOption) (mutex *Mutex, err error)

NewMutex ...

func (*Client) WatchPrefix

func (client *Client) WatchPrefix(ctx context.Context, prefix string) (*Watch, error)

NewWatch ...

type Config

type Config struct {
	Name      string   `json:"name"`
	Endpoints []string `json:"endpoints"`
	CertFile  string   `json:"certFile"`
	KeyFile   string   `json:"keyFile"`
	CaCert    string   `json:"caCert"`
	BasicAuth bool     `json:"basicAuth"`
	UserName  string   `json:"userName"`
	Password  string   `json:"-"`
	// 连接超时时间
	ConnectTimeout time.Duration `json:"connectTimeout"`
	Secure         bool          `json:"secure"`
	// 自动同步member list的间隔
	AutoSyncInterval time.Duration `json:"autoAsyncInterval"`
	TTL              int           // 单位：s
	EnableTrace      bool          `json:"enableTrace" toml:"enableTrace"`
	// contains filtered or unexported fields
}

Config ...

func DefaultConfig

func DefaultConfig() *Config

DefaultConfig 返回默认配置

func RawConfig

func RawConfig(key string) *Config

RawConfig ...

func StdConfig

func StdConfig(name string) *Config

StdConfig ...

func (*Config) BindFlags

func (config *Config) BindFlags(fs *flag.FlagSet)

func (*Config) Build

func (config *Config) Build() (*Client, error)

Build ...

func (*Config) MustBuild

func (config *Config) MustBuild() *Client

MustBuild panics when error found.

func (*Config) MustSingleton

func (config *Config) MustSingleton() *Client

MustSingleton panics when error found.

func (*Config) Singleton

func (config *Config) Singleton() (*Client, error)

Singleton returns a singleton client conn.

func (*Config) WithLogger

func (config *Config) WithLogger(logger *xlog.Logger) *Config

WithLogger ...

type Mutex

type Mutex struct {
	// contains filtered or unexported fields
}

Mutex ...

func (*Mutex) Lock

func (mutex *Mutex) Lock(timeout time.Duration) (err error)

Lock ...

func (*Mutex) TryLock

func (mutex *Mutex) TryLock(timeout time.Duration) (err error)

TryLock ...

func (*Mutex) Unlock

func (mutex *Mutex) Unlock() (err error)

Unlock ...

type Watch

type Watch struct {
	// contains filtered or unexported fields
}

Watch A watch only tells the latest revision

func (*Watch) C

func (w *Watch) C() chan *clientv3.Event

C ...

func (*Watch) Close

func (w *Watch) Close() error

Close close watch

func (*Watch) IncipientKeyValues

func (w *Watch) IncipientKeyValues() []*mvccpb.KeyValue

IncipientKeyValues incipient key and values