2015-11-26 12:23:42 +00:00
|
|
|
/*
|
|
|
|
The client package provides a method to make synchronous, asynchronous and
|
|
|
|
streaming requests to services. By default json and protobuf codecs are
|
|
|
|
supported.
|
|
|
|
*/
|
2015-01-13 23:31:27 +00:00
|
|
|
package client
|
|
|
|
|
2015-05-21 19:24:57 +01:00
|
|
|
import (
|
2015-05-23 11:53:40 +01:00
|
|
|
"golang.org/x/net/context"
|
2015-05-21 19:24:57 +01:00
|
|
|
)
|
|
|
|
|
2015-01-13 23:31:27 +00:00
|
|
|
type Client interface {
|
2015-06-12 19:52:27 +01:00
|
|
|
NewPublication(topic string, msg interface{}) Publication
|
|
|
|
NewRequest(service, method string, req interface{}) Request
|
|
|
|
NewProtoRequest(service, method string, req interface{}) Request
|
|
|
|
NewJsonRequest(service, method string, req interface{}) Request
|
|
|
|
Call(ctx context.Context, req Request, rsp interface{}) error
|
|
|
|
CallRemote(ctx context.Context, addr string, req Request, rsp interface{}) error
|
|
|
|
Stream(ctx context.Context, req Request, rspChan interface{}) (Streamer, error)
|
|
|
|
StreamRemote(ctx context.Context, addr string, req Request, rspChan interface{}) (Streamer, error)
|
|
|
|
Publish(ctx context.Context, p Publication) error
|
|
|
|
}
|
|
|
|
|
|
|
|
type Publication interface {
|
|
|
|
Topic() string
|
|
|
|
Message() interface{}
|
|
|
|
ContentType() string
|
|
|
|
}
|
|
|
|
|
|
|
|
type Request interface {
|
|
|
|
Service() string
|
|
|
|
Method() string
|
|
|
|
ContentType() string
|
|
|
|
Request() interface{}
|
2015-06-01 18:55:27 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
type Streamer interface {
|
|
|
|
Request() Request
|
|
|
|
Error() error
|
|
|
|
Close() error
|
2015-01-13 23:31:27 +00:00
|
|
|
}
|
|
|
|
|
2015-05-21 19:28:57 +01:00
|
|
|
type Option func(*options)
|
2015-05-21 19:24:57 +01:00
|
|
|
|
2015-01-13 23:31:27 +00:00
|
|
|
var (
|
2015-05-23 17:40:53 +01:00
|
|
|
DefaultClient Client = newRpcClient()
|
2015-01-13 23:31:27 +00:00
|
|
|
)
|
|
|
|
|
2015-11-26 12:21:00 +00:00
|
|
|
// Makes a synchronous call to a service using the default client
|
2015-05-23 11:53:40 +01:00
|
|
|
func Call(ctx context.Context, request Request, response interface{}) error {
|
|
|
|
return DefaultClient.Call(ctx, request, response)
|
2015-01-13 23:31:27 +00:00
|
|
|
}
|
|
|
|
|
2015-11-26 12:21:00 +00:00
|
|
|
// Makes a synchronous call to the specified address using the default client
|
2015-05-23 11:53:40 +01:00
|
|
|
func CallRemote(ctx context.Context, address string, request Request, response interface{}) error {
|
|
|
|
return DefaultClient.CallRemote(ctx, address, request, response)
|
2015-01-13 23:31:27 +00:00
|
|
|
}
|
|
|
|
|
2015-11-26 12:21:00 +00:00
|
|
|
// Creates a streaming connection with a service and returns responses on the
|
|
|
|
// channel passed in. It's upto the user to close the streamer.
|
2015-06-01 18:55:27 +01:00
|
|
|
func Stream(ctx context.Context, request Request, responseChan interface{}) (Streamer, error) {
|
|
|
|
return DefaultClient.Stream(ctx, request, responseChan)
|
|
|
|
}
|
|
|
|
|
2015-11-26 12:21:00 +00:00
|
|
|
// Creates a streaming connection to the address specified.
|
2015-06-01 18:55:27 +01:00
|
|
|
func StreamRemote(ctx context.Context, address string, request Request, responseChan interface{}) (Streamer, error) {
|
|
|
|
return DefaultClient.StreamRemote(ctx, address, request, responseChan)
|
|
|
|
}
|
|
|
|
|
2015-11-26 12:21:00 +00:00
|
|
|
// Publishes a publication using the default client. Using the underlying broker
|
|
|
|
// set within the options.
|
2015-06-12 19:52:27 +01:00
|
|
|
func Publish(ctx context.Context, p Publication) error {
|
|
|
|
return DefaultClient.Publish(ctx, p)
|
|
|
|
}
|
|
|
|
|
2015-11-26 12:21:00 +00:00
|
|
|
// Creates a new client with the options passed in
|
2015-05-23 20:04:16 +01:00
|
|
|
func NewClient(opt ...Option) Client {
|
2015-05-23 17:40:53 +01:00
|
|
|
return newRpcClient(opt...)
|
|
|
|
}
|
|
|
|
|
2015-11-26 12:21:00 +00:00
|
|
|
// Creates a new publication using the default client
|
2015-06-12 19:52:27 +01:00
|
|
|
func NewPublication(topic string, message interface{}) Publication {
|
|
|
|
return DefaultClient.NewPublication(topic, message)
|
|
|
|
}
|
|
|
|
|
2015-11-26 12:21:00 +00:00
|
|
|
// Creates a new request using the default client. Content Type will
|
|
|
|
// be set to the default within options and use the appropriate codec
|
2015-01-13 23:31:27 +00:00
|
|
|
func NewRequest(service, method string, request interface{}) Request {
|
2015-05-21 19:24:57 +01:00
|
|
|
return DefaultClient.NewRequest(service, method, request)
|
2015-01-13 23:31:27 +00:00
|
|
|
}
|
|
|
|
|
2015-11-26 12:21:00 +00:00
|
|
|
// Creates a new protobuf request using the default client
|
2015-01-13 23:31:27 +00:00
|
|
|
func NewProtoRequest(service, method string, request interface{}) Request {
|
2015-05-21 19:24:57 +01:00
|
|
|
return DefaultClient.NewProtoRequest(service, method, request)
|
2015-01-13 23:31:27 +00:00
|
|
|
}
|
|
|
|
|
2015-11-26 12:21:00 +00:00
|
|
|
// Creates a new json request using the default client
|
2015-01-13 23:31:27 +00:00
|
|
|
func NewJsonRequest(service, method string, request interface{}) Request {
|
2015-05-21 19:24:57 +01:00
|
|
|
return DefaultClient.NewJsonRequest(service, method, request)
|
2015-01-13 23:31:27 +00:00
|
|
|
}
|