go.etcd.io/etcd@v3.3.27+incompatible/etcdserver/api/v3client/v3client.go (about)

     1  // Copyright 2017 The etcd Authors
     2  //
     3  // Licensed under the Apache License, Version 2.0 (the "License");
     4  // you may not use this file except in compliance with the License.
     5  // You may obtain a copy of the License at
     6  //
     7  //     http://www.apache.org/licenses/LICENSE-2.0
     8  //
     9  // Unless required by applicable law or agreed to in writing, software
    10  // distributed under the License is distributed on an "AS IS" BASIS,
    11  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    12  // See the License for the specific language governing permissions and
    13  // limitations under the License.
    14  
    15  package v3client
    16  
    17  import (
    18  	"context"
    19  	"time"
    20  
    21  	"github.com/coreos/etcd/clientv3"
    22  	"github.com/coreos/etcd/etcdserver"
    23  	"github.com/coreos/etcd/etcdserver/api/v3rpc"
    24  	"github.com/coreos/etcd/proxy/grpcproxy/adapter"
    25  )
    26  
    27  // New creates a clientv3 client that wraps an in-process EtcdServer. Instead
    28  // of making gRPC calls through sockets, the client makes direct function calls
    29  // to the etcd server through its api/v3rpc function interfaces.
    30  func New(s *etcdserver.EtcdServer) *clientv3.Client {
    31  	c := clientv3.NewCtxClient(context.Background())
    32  
    33  	kvc := adapter.KvServerToKvClient(v3rpc.NewQuotaKVServer(s))
    34  	c.KV = clientv3.NewKVFromKVClient(kvc, c)
    35  
    36  	lc := adapter.LeaseServerToLeaseClient(v3rpc.NewQuotaLeaseServer(s))
    37  	c.Lease = clientv3.NewLeaseFromLeaseClient(lc, c, time.Second)
    38  
    39  	wc := adapter.WatchServerToWatchClient(v3rpc.NewWatchServer(s))
    40  	c.Watcher = &watchWrapper{clientv3.NewWatchFromWatchClient(wc, c)}
    41  
    42  	mc := adapter.MaintenanceServerToMaintenanceClient(v3rpc.NewMaintenanceServer(s))
    43  	c.Maintenance = clientv3.NewMaintenanceFromMaintenanceClient(mc, c)
    44  
    45  	clc := adapter.ClusterServerToClusterClient(v3rpc.NewClusterServer(s))
    46  	c.Cluster = clientv3.NewClusterFromClusterClient(clc, c)
    47  
    48  	// TODO: implement clientv3.Auth interface?
    49  
    50  	return c
    51  }
    52  
    53  // BlankContext implements Stringer on a context so the ctx string doesn't
    54  // depend on the context's WithValue data, which tends to be unsynchronized
    55  // (e.g., x/net/trace), causing ctx.String() to throw data races.
    56  type blankContext struct{ context.Context }
    57  
    58  func (*blankContext) String() string { return "(blankCtx)" }
    59  
    60  // watchWrapper wraps clientv3 watch calls to blank out the context
    61  // to avoid races on trace data.
    62  type watchWrapper struct{ clientv3.Watcher }
    63  
    64  func (ww *watchWrapper) Watch(ctx context.Context, key string, opts ...clientv3.OpOption) clientv3.WatchChan {
    65  	return ww.Watcher.Watch(&blankContext{ctx}, key, opts...)
    66  }