ucloud

Documentation

Overview

Package ucloud is a package of utilities to setup ucloud sdk and improve using experience

Index

• Constants
• Variables
• type Client
  • func NewClient(config *Config, credential *auth.Credential) *Client
  • func NewClientWithMeta(config *Config, credential *auth.Credential, meta ClientMeta) *Client
  • func (c *Client) AddHttpRequestHandler(h HttpRequestHandler) error
  • func (c *Client) AddHttpResponseHandler(h HttpResponseHandler) error
  • func (c *Client) AddRequestHandler(h RequestHandler) error
  • func (c *Client) AddResponseHandler(h ResponseHandler) error
  • func (c *Client) GenericInvoke(req request.GenericRequest) (response.GenericResponse, error)
  • func (c *Client) GetConfig() *Config
  • func (c *Client) GetCredential() *auth.Credential
  • func (c *Client) GetLogger() log.Logger
  • func (c *Client) GetMeta() ClientMeta
  • func (c *Client) InvokeAction(action string, req request.Common, resp response.Common) error
  • func (c *Client) InvokeActionWithPatcher(action string, req request.Common, resp response.Common, ...) error
  • func (c *Client) NewGenericRequest() request.GenericRequest
  • func (c *Client) SetHttpClient(httpClient http.Client) error
  • func (c *Client) SetLogger(logger log.Logger)
  • func (c *Client) SetTransport(transport stdhttp.RoundTripper)
  • func (c *Client) SetupRequest(req request.Common) request.Common
• type ClientMeta
• type Config
• type HttpRequestHandler
• type HttpResponseHandler
• type RequestHandler
• type ResponseHandler
• type ServiceClient

Constants

const Version = version.Version

Version is the version of sdk

Variables

var (
	String            = request.String
	StringValue       = request.StringValue
	Int               = request.Int
	IntValue          = request.IntValue
	Bool              = request.Bool
	BoolValue         = request.BoolValue
	Float64           = request.Float64
	Float64Value      = request.Float64Value
	TimeDuration      = request.TimeDuration
	TimeDurationValue = request.TimeDurationValue
)

var NewConfig = config.NewConfig

NewConfig will return a new client config with default options.

Types

type Client

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

Client 客户端

func NewClient

func NewClient(config *Config, credential *auth.Credential) *Client

NewClient will create an client of ucloud sdk

func NewClientWithMeta

func NewClientWithMeta(config *Config, credential *auth.Credential, meta ClientMeta) *Client

func (*Client) AddHttpRequestHandler

func (c *Client) AddHttpRequestHandler(h HttpRequestHandler) error

AddHttpRequestHandler will append a response handler to client

func (*Client) AddHttpResponseHandler

func (c *Client) AddHttpResponseHandler(h HttpResponseHandler) error

AddHttpResponseHandler will append a http response handler to client

func (*Client) AddRequestHandler

func (c *Client) AddRequestHandler(h RequestHandler) error

AddRequestHandler will append a response handler to client

func (*Client) AddResponseHandler

func (c *Client) AddResponseHandler(h ResponseHandler) error

AddResponseHandler will append a response handler to client

func (*Client) GenericInvoke

func (c *Client) GenericInvoke(req request.GenericRequest) (response.GenericResponse, error)

func (*Client) GetConfig

func (c *Client) GetConfig() *Config

GetConfig will return the config of client.

func (*Client) GetCredential

func (c *Client) GetCredential() *auth.Credential

GetCredential will return the credential config of client.

func (*Client) GetLogger

func (c *Client) GetLogger() log.Logger

GetLogger will set the logger of client

func (*Client) GetMeta

func (c *Client) GetMeta() ClientMeta

GetMeta will return the meta data of client.

func (*Client) InvokeAction

func (c *Client) InvokeAction(action string, req request.Common, resp response.Common) error

InvokeAction will do an action request from a request struct and set response value into res struct pointer

func (*Client) InvokeActionWithPatcher

func (c *Client) InvokeActionWithPatcher(action string, req request.Common, resp response.Common, patches ...utils.Patch) error

InvokeActionWithPatcher will invoke action by patchers

func (*Client) NewGenericRequest

func (c *Client) NewGenericRequest() request.GenericRequest

func (*Client) SetHttpClient

func (c *Client) SetHttpClient(httpClient http.Client) error

SetHttpClient will setup a http client

func (*Client) SetLogger

func (c *Client) SetLogger(logger log.Logger)

SetLogger will set the logger of client

func (*Client) SetTransport

func (c *Client) SetTransport(transport stdhttp.RoundTripper)

func (*Client) SetupRequest

func (c *Client) SetupRequest(req request.Common) request.Common

SetupRequest will init request by client configuration

type ClientMeta

type ClientMeta struct {
	Product string
}

type Config

type Config = config.Config

Config is the config of ucloud sdk, use for setting up client

type HttpRequestHandler

type HttpRequestHandler func(c *Client, req *http.HttpRequest) (*http.HttpRequest, error)

HttpRequestHandler receive http request and return a new http request

type HttpResponseHandler

type HttpResponseHandler func(c *Client, req *http.HttpRequest, resp *http.HttpResponse, err error) (*http.HttpResponse, error)

HttpResponseHandler receive http response and return a new http response

type RequestHandler

type RequestHandler func(c *Client, req request.Common) (request.Common, error)

RequestHandler receive request and write data into this request memory area

type ResponseHandler

type ResponseHandler func(c *Client, req request.Common, resp response.Common, err error) (response.Common, error)

ResponseHandler receive response and write data into this response memory area

type ServiceClient

type ServiceClient interface {
	AddRequestHandler(h RequestHandler) error
	AddResponseHandler(h ResponseHandler) error
	AddHttpRequestHandler(h HttpRequestHandler) error
	AddHttpResponseHandler(h HttpResponseHandler) error
}