|
|
@ -1,360 +1,43 @@ |
|
|
|
package tmspcli |
|
|
|
|
|
|
|
import ( |
|
|
|
"bufio" |
|
|
|
"container/list" |
|
|
|
"errors" |
|
|
|
"fmt" |
|
|
|
"net" |
|
|
|
"sync" |
|
|
|
"time" |
|
|
|
|
|
|
|
. "github.com/tendermint/go-common" |
|
|
|
"github.com/tendermint/tmsp/types" |
|
|
|
"sync" |
|
|
|
) |
|
|
|
|
|
|
|
const reqQueueSize = 256 // TODO make configurable
|
|
|
|
const maxResponseSize = 1048576 // 1MB TODO make configurable
|
|
|
|
const flushThrottleMS = 20 // Don't wait longer than...
|
|
|
|
|
|
|
|
type Callback func(*types.Request, *types.Response) |
|
|
|
|
|
|
|
// This is goroutine-safe, but users should beware that
|
|
|
|
// the application in general is not meant to be interfaced
|
|
|
|
// with concurrent callers.
|
|
|
|
type Client struct { |
|
|
|
QuitService |
|
|
|
sync.Mutex // [EB]: is this even used?
|
|
|
|
|
|
|
|
reqQueue chan *ReqRes |
|
|
|
flushTimer *ThrottleTimer |
|
|
|
mustConnect bool |
|
|
|
|
|
|
|
mtx sync.Mutex |
|
|
|
addr string |
|
|
|
conn net.Conn |
|
|
|
err error |
|
|
|
reqSent *list.List |
|
|
|
resCb func(*types.Request, *types.Response) // listens to all callbacks
|
|
|
|
} |
|
|
|
|
|
|
|
func NewClient(addr string, mustConnect bool) (*Client, error) { |
|
|
|
cli := &Client{ |
|
|
|
reqQueue: make(chan *ReqRes, reqQueueSize), |
|
|
|
flushTimer: NewThrottleTimer("Client", flushThrottleMS), |
|
|
|
mustConnect: mustConnect, |
|
|
|
|
|
|
|
addr: addr, |
|
|
|
reqSent: list.New(), |
|
|
|
resCb: nil, |
|
|
|
} |
|
|
|
cli.QuitService = *NewQuitService(nil, "Client", cli) |
|
|
|
_, err := cli.Start() // Just start it, it's confusing for callers to remember to start.
|
|
|
|
if mustConnect { |
|
|
|
return nil, err |
|
|
|
} else { |
|
|
|
return cli, nil |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) OnStart() (err error) { |
|
|
|
cli.QuitService.OnStart() |
|
|
|
doneCh := make(chan struct{}) |
|
|
|
go func() { |
|
|
|
RETRY_LOOP: |
|
|
|
for { |
|
|
|
conn, err_ := Connect(cli.addr) |
|
|
|
if err_ != nil { |
|
|
|
if cli.mustConnect { |
|
|
|
err = err_ // OnStart() will return this.
|
|
|
|
close(doneCh) |
|
|
|
return |
|
|
|
} else { |
|
|
|
fmt.Printf("tmsp.Client failed to connect to %v. Retrying...\n", cli.addr) |
|
|
|
time.Sleep(time.Second * 3) |
|
|
|
continue RETRY_LOOP |
|
|
|
} |
|
|
|
} |
|
|
|
go cli.sendRequestsRoutine(conn) |
|
|
|
go cli.recvResponseRoutine(conn) |
|
|
|
close(doneCh) // OnStart() will return no error.
|
|
|
|
return |
|
|
|
} |
|
|
|
}() |
|
|
|
<-doneCh |
|
|
|
return // err
|
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) OnStop() { |
|
|
|
cli.QuitService.OnStop() |
|
|
|
if cli.conn != nil { |
|
|
|
cli.conn.Close() |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
// Set listener for all responses
|
|
|
|
// NOTE: callback may get internally generated flush responses.
|
|
|
|
func (cli *Client) SetResponseCallback(resCb Callback) { |
|
|
|
cli.mtx.Lock() |
|
|
|
defer cli.mtx.Unlock() |
|
|
|
cli.resCb = resCb |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) StopForError(err error) { |
|
|
|
cli.mtx.Lock() |
|
|
|
fmt.Printf("Stopping tmsp.Client for error: %v\n", err.Error()) |
|
|
|
if cli.err == nil { |
|
|
|
cli.err = err |
|
|
|
} |
|
|
|
cli.mtx.Unlock() |
|
|
|
cli.Stop() |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) Error() error { |
|
|
|
cli.mtx.Lock() |
|
|
|
defer cli.mtx.Unlock() |
|
|
|
return cli.err |
|
|
|
type Client interface { |
|
|
|
SetResponseCallback(Callback) |
|
|
|
Error() error |
|
|
|
Stop() bool |
|
|
|
|
|
|
|
FlushAsync() *ReqRes |
|
|
|
EchoAsync(msg string) *ReqRes |
|
|
|
InfoAsync() *ReqRes |
|
|
|
SetOptionAsync(key string, value string) *ReqRes |
|
|
|
AppendTxAsync(tx []byte) *ReqRes |
|
|
|
CheckTxAsync(tx []byte) *ReqRes |
|
|
|
QueryAsync(tx []byte) *ReqRes |
|
|
|
CommitAsync() *ReqRes |
|
|
|
|
|
|
|
FlushSync() error |
|
|
|
EchoSync(msg string) (res types.Result) |
|
|
|
InfoSync() (res types.Result) |
|
|
|
SetOptionSync(key string, value string) (res types.Result) |
|
|
|
AppendTxSync(tx []byte) (res types.Result) |
|
|
|
CheckTxSync(tx []byte) (res types.Result) |
|
|
|
QuerySync(tx []byte) (res types.Result) |
|
|
|
CommitSync() (res types.Result) |
|
|
|
|
|
|
|
InitChainSync(validators []*types.Validator) (err error) |
|
|
|
EndBlockSync(height uint64) (changedValidators []*types.Validator, err error) |
|
|
|
} |
|
|
|
|
|
|
|
//----------------------------------------
|
|
|
|
|
|
|
|
func (cli *Client) sendRequestsRoutine(conn net.Conn) { |
|
|
|
w := bufio.NewWriter(conn) |
|
|
|
for { |
|
|
|
select { |
|
|
|
case <-cli.flushTimer.Ch: |
|
|
|
select { |
|
|
|
case cli.reqQueue <- NewReqRes(types.RequestFlush()): |
|
|
|
default: |
|
|
|
// Probably will fill the buffer, or retry later.
|
|
|
|
} |
|
|
|
case <-cli.QuitService.Quit: |
|
|
|
return |
|
|
|
case reqres := <-cli.reqQueue: |
|
|
|
cli.willSendReq(reqres) |
|
|
|
err := types.WriteMessage(reqres.Request, w) |
|
|
|
if err != nil { |
|
|
|
cli.StopForError(err) |
|
|
|
return |
|
|
|
} |
|
|
|
// log.Debug("Sent request", "requestType", reflect.TypeOf(reqres.Request), "request", reqres.Request)
|
|
|
|
if reqres.Request.Type == types.MessageType_Flush { |
|
|
|
err = w.Flush() |
|
|
|
if err != nil { |
|
|
|
cli.StopForError(err) |
|
|
|
return |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) recvResponseRoutine(conn net.Conn) { |
|
|
|
r := bufio.NewReader(conn) // Buffer reads
|
|
|
|
for { |
|
|
|
var res = &types.Response{} |
|
|
|
err := types.ReadMessage(r, res) |
|
|
|
if err != nil { |
|
|
|
cli.StopForError(err) |
|
|
|
return |
|
|
|
} |
|
|
|
switch res.Type { |
|
|
|
case types.MessageType_Exception: |
|
|
|
// XXX After setting cli.err, release waiters (e.g. reqres.Done())
|
|
|
|
cli.StopForError(errors.New(res.Error)) |
|
|
|
default: |
|
|
|
// log.Debug("Received response", "responseType", reflect.TypeOf(res), "response", res)
|
|
|
|
err := cli.didRecvResponse(res) |
|
|
|
if err != nil { |
|
|
|
cli.StopForError(err) |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) willSendReq(reqres *ReqRes) { |
|
|
|
cli.mtx.Lock() |
|
|
|
defer cli.mtx.Unlock() |
|
|
|
cli.reqSent.PushBack(reqres) |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) didRecvResponse(res *types.Response) error { |
|
|
|
cli.mtx.Lock() |
|
|
|
defer cli.mtx.Unlock() |
|
|
|
|
|
|
|
// Get the first ReqRes
|
|
|
|
next := cli.reqSent.Front() |
|
|
|
if next == nil { |
|
|
|
return fmt.Errorf("Unexpected result type %v when nothing expected", res.Type) |
|
|
|
} |
|
|
|
reqres := next.Value.(*ReqRes) |
|
|
|
if !resMatchesReq(reqres.Request, res) { |
|
|
|
return fmt.Errorf("Unexpected result type %v when response to %v expected", |
|
|
|
res.Type, reqres.Request.Type) |
|
|
|
} |
|
|
|
|
|
|
|
reqres.Response = res // Set response
|
|
|
|
reqres.Done() // Release waiters
|
|
|
|
cli.reqSent.Remove(next) // Pop first item from linked list
|
|
|
|
|
|
|
|
// Notify reqRes listener if set
|
|
|
|
if cb := reqres.GetCallback(); cb != nil { |
|
|
|
cb(res) |
|
|
|
} |
|
|
|
|
|
|
|
// Notify client listener if set
|
|
|
|
if cli.resCb != nil { |
|
|
|
cli.resCb(reqres.Request, res) |
|
|
|
} |
|
|
|
|
|
|
|
return nil |
|
|
|
} |
|
|
|
|
|
|
|
//----------------------------------------
|
|
|
|
|
|
|
|
func (cli *Client) EchoAsync(msg string) *ReqRes { |
|
|
|
return cli.queueRequest(types.RequestEcho(msg)) |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) FlushAsync() *ReqRes { |
|
|
|
return cli.queueRequest(types.RequestFlush()) |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) SetOptionAsync(key string, value string) *ReqRes { |
|
|
|
return cli.queueRequest(types.RequestSetOption(key, value)) |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) AppendTxAsync(tx []byte) *ReqRes { |
|
|
|
return cli.queueRequest(types.RequestAppendTx(tx)) |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) CheckTxAsync(tx []byte) *ReqRes { |
|
|
|
return cli.queueRequest(types.RequestCheckTx(tx)) |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) CommitAsync() *ReqRes { |
|
|
|
return cli.queueRequest(types.RequestCommit()) |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) QueryAsync(query []byte) *ReqRes { |
|
|
|
return cli.queueRequest(types.RequestQuery(query)) |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) InitChainAsync(validators []*types.Validator) *ReqRes { |
|
|
|
return cli.queueRequest(types.RequestInitChain(validators)) |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) EndBlockAsync(height uint64) *ReqRes { |
|
|
|
return cli.queueRequest(types.RequestEndBlock(height)) |
|
|
|
} |
|
|
|
|
|
|
|
//----------------------------------------
|
|
|
|
|
|
|
|
func (cli *Client) FlushSync() error { |
|
|
|
cli.queueRequest(types.RequestFlush()).Wait() |
|
|
|
return cli.err |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) InfoSync() (info string, err error) { |
|
|
|
reqres := cli.queueRequest(types.RequestInfo()) |
|
|
|
cli.FlushSync() |
|
|
|
if cli.err != nil { |
|
|
|
return "", cli.err |
|
|
|
} |
|
|
|
return string(reqres.Response.Data), nil |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) SetOptionSync(key string, value string) (log string, err error) { |
|
|
|
reqres := cli.queueRequest(types.RequestSetOption(key, value)) |
|
|
|
cli.FlushSync() |
|
|
|
if cli.err != nil { |
|
|
|
return "", cli.err |
|
|
|
} |
|
|
|
return reqres.Response.Log, nil |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) AppendTxSync(tx []byte) (res types.Result) { |
|
|
|
reqres := cli.queueRequest(types.RequestAppendTx(tx)) |
|
|
|
cli.FlushSync() |
|
|
|
if cli.err != nil { |
|
|
|
return types.ErrInternalError.SetLog(cli.err.Error()) |
|
|
|
} |
|
|
|
resp := reqres.Response |
|
|
|
return types.Result{Code: resp.Code, Data: resp.Data, Log: resp.Log} |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) CheckTxSync(tx []byte) (res types.Result) { |
|
|
|
reqres := cli.queueRequest(types.RequestCheckTx(tx)) |
|
|
|
cli.FlushSync() |
|
|
|
if cli.err != nil { |
|
|
|
return types.ErrInternalError.SetLog(cli.err.Error()) |
|
|
|
} |
|
|
|
resp := reqres.Response |
|
|
|
return types.Result{Code: resp.Code, Data: resp.Data, Log: resp.Log} |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) CommitSync() (res types.Result) { |
|
|
|
reqres := cli.queueRequest(types.RequestCommit()) |
|
|
|
cli.FlushSync() |
|
|
|
if cli.err != nil { |
|
|
|
return types.ErrInternalError.SetLog(cli.err.Error()) |
|
|
|
} |
|
|
|
resp := reqres.Response |
|
|
|
return types.Result{Code: resp.Code, Data: resp.Data, Log: resp.Log} |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) QuerySync(query []byte) (res types.Result) { |
|
|
|
reqres := cli.queueRequest(types.RequestQuery(query)) |
|
|
|
cli.FlushSync() |
|
|
|
if cli.err != nil { |
|
|
|
return types.ErrInternalError.SetLog(cli.err.Error()) |
|
|
|
} |
|
|
|
resp := reqres.Response |
|
|
|
return types.Result{Code: resp.Code, Data: resp.Data, Log: resp.Log} |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) InitChainSync(validators []*types.Validator) (err error) { |
|
|
|
cli.queueRequest(types.RequestInitChain(validators)) |
|
|
|
cli.FlushSync() |
|
|
|
if cli.err != nil { |
|
|
|
return cli.err |
|
|
|
} |
|
|
|
return nil |
|
|
|
} |
|
|
|
|
|
|
|
func (cli *Client) EndBlockSync(height uint64) (validators []*types.Validator, err error) { |
|
|
|
reqres := cli.queueRequest(types.RequestEndBlock(height)) |
|
|
|
cli.FlushSync() |
|
|
|
if cli.err != nil { |
|
|
|
return nil, cli.err |
|
|
|
} |
|
|
|
return reqres.Response.Validators, nil |
|
|
|
} |
|
|
|
|
|
|
|
//----------------------------------------
|
|
|
|
|
|
|
|
func (cli *Client) queueRequest(req *types.Request) *ReqRes { |
|
|
|
reqres := NewReqRes(req) |
|
|
|
// TODO: set cli.err if reqQueue times out
|
|
|
|
cli.reqQueue <- reqres |
|
|
|
|
|
|
|
// Maybe auto-flush, or unset auto-flush
|
|
|
|
switch req.Type { |
|
|
|
case types.MessageType_Flush: |
|
|
|
cli.flushTimer.Unset() |
|
|
|
default: |
|
|
|
cli.flushTimer.Set() |
|
|
|
} |
|
|
|
|
|
|
|
return reqres |
|
|
|
} |
|
|
|
type Callback func(*types.Request, *types.Response) |
|
|
|
|
|
|
|
//----------------------------------------
|
|
|
|
|
|
|
|
func resMatchesReq(req *types.Request, res *types.Response) (ok bool) { |
|
|
|
return req.Type == res.Type |
|
|
|
} |
|
|
|
|
|
|
|
type ReqRes struct { |
|
|
|
*types.Request |
|
|
|
*sync.WaitGroup |
|
|
|