tars

package
v0.0.0-...-bc1b0c2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 13, 2024 License: BSD-3-Clause Imports: 64 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	NotifyNormal = 0
	NotifyWarn   = 1
	NotifyError  = 2
)
View Source 
const (
	StatSuccess = iota
	StatFailed
)
View Source 
const (

	// Version is tars version
	Version string = "1.4.5"

	// AcceptTimeout accept timeout,default value is 500 milliseconds
	AcceptTimeout = 500
	// ReadTimeout zero millisecond for not set read deadline for Conn (better  performance)
	ReadTimeout = 0
	// WriteTimeout zero millisecond for not set write deadline for Conn (better performance)
	WriteTimeout = 0
	// HandleTimeout zero millisecond for not set deadline for invoke user interface (better performance)
	HandleTimeout = 0
	// IdleTimeout idle timeout,default value is 600000 milliseconds
	IdleTimeout = 600000
	// ZombieTimeout zombie timeout,default value is 10000 milliseconds
	ZombieTimeout = 10000
	// QueueCap queue gap
	QueueCap int = 10000000

	// Stat default value
	Stat = "tars.tarsstat.StatObj"
	// Property default value
	Property = "tars.tarsproperty.PropertyObj"
	// ModuleName default value
	ModuleName        = "tup_client"
	ClientMaxConnSize = 0
	// ClientQueueLen client queue length
	ClientQueueLen int = 10000
	// ClientIdleTimeout client idle timeout,default value is 600000 milliseconds
	ClientIdleTimeout = 600000
	// ClientReadTimeout client read timeout,default value is 100 milliseconds
	ClientReadTimeout = 100
	// ClientWriteTimeout client write timeout,default value is 3000 milliseconds
	ClientWriteTimeout = 3000
	// ReqDefaultTimeout request default timeout
	ReqDefaultTimeout int32 = 3000
	// ClientDialTimeout connection dial timeout
	ClientDialTimeout = 3000
	// ObjQueueMax obj queue max number
	ObjQueueMax int32 = 100000

	// PropertyReportInterval property report interval,default value is 10000 milliseconds
	PropertyReportInterval = 10000
	// StatReportInterval stat report interval,default value is 10000 milliseconds
	StatReportInterval = 10000
	// StatReportChannelBufLen stat report channel len
	StatReportChannelBufLen = 100000

	// MainLoopTicker main loop ticker,default value is 10000 milliseconds
	MainLoopTicker = 10000

	// AsyncInvokeTimeout async invoke timeout
	AsyncInvokeTimeout int = 3000

	// TCPReadBuffer tcp read buffer length
	TCPReadBuffer = 128 * 1024 * 1024
	// TCPWriteBuffer tcp write buffer length
	TCPWriteBuffer = 128 * 1024 * 1024
	// TCPNoDelay set tcp no delay
	TCPNoDelay = false

	// GracedownTimeout set timeout (milliseconds) for grace shutdown
	GracedownTimeout = 60000

	// MaxPackageLength maximum length of the request
	MaxPackageLength = 10485760
)

Variables

View Source 
var (
	// TLOG is the logger for tars framework.
	TLOG = rogger.GetLogger("TLOG")

	ServerConfigPath string
)
View Source 
var MaxInvoke int32

MaxInvoke number of worker routine to handle client request zero means no control, just one goroutine for a client request. runtime.NumCPU() usually the best performance in the benchmark.

View Source 
var (
	// ReportStat set the default stater(default is `ReportStatFromClient`).
	ReportStat reportStatFunc = ReportStatFromClient
)

Functions

func AddAppConfig 

func AddAppConfig(filename string) (config string, err error)

AddAppConfig add app level config

func AddConfig 

func AddConfig(filename string) (config string, err error)

AddConfig add server level config

func AddHttpServant 

func AddHttpServant(mux HttpHandler, obj string)

AddHttpServant add http servant handler with default exceptionStatusChecker for obj.

func AddHttpServantWithExceptionStatusChecker 

func AddHttpServantWithExceptionStatusChecker(mux HttpHandler, obj string, exceptionStatusChecker func(int) bool)

AddHttpServantWithExceptionStatusChecker add http servant handler with exceptionStatusChecker for obj.

func AddServant 

func AddServant(v dispatch, f interface{}, obj string)

AddServant add dispatch and interface for object.

func AddServantWithProtocol 

func AddServantWithProtocol(proto transport.ServerProtocol, obj string)

AddServantWithProtocol adds a servant with protocol and obj

func CheckPanic 

func CheckPanic()

CheckPanic used to dump stack info to file when catch panic

func DefaultExceptionStatusChecker 

func DefaultExceptionStatusChecker(statusCode int) bool

DefaultExceptionStatusChecker Default Exception Status Checker

func GetBasePath 

func GetBasePath() string

func GetClientConfig 

func GetClientConfig() *clientConfig

GetClientConfig Get client config

func GetConf 

func GetConf() *conf.Conf

GetConf Get server conf.Conf config

func GetConfigList 

func GetConfigList() (fList []string, err error)

GetConfigList get server level config list

func GetDayLogger 

func GetDayLogger(name string, numDay int) *rogger.Logger

GetDayLogger Get a logger roll by day

func GetHourLogger 

func GetHourLogger(name string, numHour int) *rogger.Logger

GetHourLogger Get a logger roll by hour

func GetLogger 

func GetLogger(name string) *rogger.Logger

GetLogger Get a logger

func GetRemoteLogger 

func GetRemoteLogger(name string) *rogger.Logger

GetRemoteLogger returns a remote logger

func GetServerConfig 

func GetServerConfig() *serverConfig

GetServerConfig Get server config

func Hash 

func Hash(str string) uint32

func HashNew 

func HashNew(str string) uint32

func HashString 

func HashString(str string) uint32

func MagicStringHash 

func MagicStringHash(str string) uint32

func RegisterAdmin 

func RegisterAdmin(name string, fn adminFn)

RegisterAdmin register admin functions

func RegisterEncoder 

func RegisterEncoder(encoder Encoder)

func ReportAvg 

func ReportAvg(key string, i int)

ReportAvg avg report

func ReportCount 

func ReportCount(key string, i int)

ReportCount count report

func ReportDistr 

func ReportDistr(key string, in []int, i int)

ReportDistr distr report

func ReportMax 

func ReportMax(key string, i int)

ReportMax max report

func ReportMin 

func ReportMin(key string, i int)

ReportMin min report

func ReportNotifyInfo 

func ReportNotifyInfo(level int32, info string)

ReportNotifyInfo reports notify information with level and info

func ReportStatBase 

func ReportStatBase(head *statf.StatMicMsgHead, body *statf.StatMicMsgBody, FromServer bool)

ReportStatBase is base method for report statistics.

func ReportStatFromClient 

func ReportStatFromClient(msg *Message, succ int32, timeout int32, exec int32)

ReportStatFromClient report the statics from client.

func ReportStatFromServer 

func ReportStatFromServer(InterfaceName, MasterName string, ReturnValue int32, TotalRspTime int64)

ReportStatFromServer reports statics from server side.

func ReportSum 

func ReportSum(key string, i int)

ReportSum sum report

func Run 

func Run(opts ...Option)

func Trace 

func Trace(traceKey, annotation, client, server, funcName string, ret int32, data, ex string)

func WithClientInterceptor 

func WithClientInterceptor(interceptors ...ClientInterceptor)

func WithHttpInterceptor 

func WithHttpInterceptor(interceptor ...HttpInterceptor)

func WithServerInterceptor 

func WithServerInterceptor(interceptors ...ServerInterceptor)

Types

type AdapterProxy 

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

AdapterProxy : Adapter proxy

func NewAdapterProxy 

func NewAdapterProxy(objName string, point *endpointf.EndpointF, comm *Communicator) *AdapterProxy

NewAdapterProxy create an adapter proxy

func (*AdapterProxy) Close 

func (c *AdapterProxy) Close()

Close the client

func (*AdapterProxy) GetPoint 

func (c *AdapterProxy) GetPoint() *endpointf.EndpointF

GetPoint get an endpoint

func (*AdapterProxy) ParsePackage 

func (c *AdapterProxy) ParsePackage(buff []byte) (int, int)

ParsePackage : Parse packet from bytes

func (*AdapterProxy) Recv 

func (c *AdapterProxy) Recv(pkg []byte)

Recv : Recover read channel when closed for timeout

func (*AdapterProxy) SendKeepAlive 

func (c *AdapterProxy) SendKeepAlive(req *requestf.RequestPacket) error

Send : Send keepAlive

func (*AdapterProxy) SendPacket 

func (c *AdapterProxy) SendPacket(req *requestf.RequestPacket) error

Send : Send packet

type Admin 

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

Admin struct

func (*Admin) Notify 

func (a *Admin) Notify(ctx context.Context, command string) (string, error)

Notify handler for cmds from admin

func (*Admin) Shutdown 

func (a *Admin) Shutdown(ctx context.Context) error

Shutdown all servant by admin

type AppCache 

type AppCache struct {
	TarsVersion string
	ModifyTime  string
	LogLevel    string
	ObjCaches   []ObjCache
}

func GetAppCache 

func GetAppCache() AppCache

type Avg 

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

Avg for counting average for the report value.

func NewAvg 

func NewAvg() *Avg

NewAvg new and init the average struct.

func (*Avg) Enum 

func (a *Avg) Enum() ReportPolicy

Enum return the report policy

func (*Avg) Get 

func (a *Avg) Get() (out string)

Get gets the result of the average counting.

func (*Avg) Set 

func (a *Avg) Set(in int)

Set sets the value for the average counting.

type ClientInterceptor 

type ClientInterceptor func(ctx context.Context, msg *Message, invoke Invoke, timeout time.Duration) (err error)

ClientInterceptor is used for filter request & response for client, for implementing plugins like opentracing

type Communicator 

type Communicator struct {
	Client *clientConfig
	// contains filtered or unexported fields
}

Communicator struct

func GetCommunicator 

func GetCommunicator() *Communicator

GetCommunicator returns a default communicator

func NewCommunicator 

func NewCommunicator(opts ...Option) *Communicator

NewCommunicator returns a new communicator. A Communicator is used for communicating with the server side which should only init once and be global!!!

func (*Communicator) GetLocator 

func (c *Communicator) GetLocator() string

GetLocator returns locator as string

func (*Communicator) GetProperty 

func (c *Communicator) GetProperty(key string) (string, bool)

GetProperty returns communicator property value as string and true for key, or empty string and false for not exists key

func (*Communicator) GetPropertyBool 

func (c *Communicator) GetPropertyBool(key string) (bool, bool)

GetPropertyBool returns communicator property value as bool and true for key, or false and false for not exists key

func (*Communicator) GetPropertyInt 

func (c *Communicator) GetPropertyInt(key string) (int, bool)

GetPropertyInt returns communicator property value as int and true for key, or 0 and false for not exists key

func (*Communicator) SetLocator 

func (c *Communicator) SetLocator(obj string)

SetLocator sets locator with obj

func (*Communicator) SetProperty 

func (c *Communicator) SetProperty(key string, value interface{})

SetProperty sets communicator property with a string key and an interface value. var comm *tars.Communicator comm = tars.NewCommunicator() e.g. comm.SetProperty("locator", "tars.tarsregistry.QueryObj@tcp -h ... -p ...")

func (*Communicator) SetTraceParam 

func (c *Communicator) SetTraceParam(name string)

func (*Communicator) StringToProxy 

func (c *Communicator) StringToProxy(servant string, p ProxyPrx, opts ...EndpointManagerOption)

StringToProxy sets the servant of ProxyPrx p with a string servant

type Count 

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

Count is for counting the total of reporting

func NewCount 

func NewCount() *Count

NewCount new and init the counting struct.

func (*Count) Enum 

func (c *Count) Enum() ReportPolicy

Enum return the report policy

func (*Count) Get 

func (c *Count) Get() (out string)

Get gets the total times of the reporting values.

func (*Count) Set 

func (c *Count) Set(in int)

Set sets the value for counting.

type Dispatch 

type Dispatch func(context.Context, interface{}, *requestf.RequestPacket, *requestf.ResponsePacket, bool) error

Dispatch server side Dispatch

type DispatchReporter 

type DispatchReporter func(ctx context.Context, req []interface{}, rsp []interface{}, returns []interface{})

DispatchReporter is the reporter in server-side dispatch, and will be used in logging

type Distr 

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

Distr is used for counting the distribution of the reporting values.

func NewDistr 

func NewDistr(in []int) (d *Distr)

NewDistr new and int the Distr

func (*Distr) Enum 

func (d *Distr) Enum() ReportPolicy

Enum return the report policy

func (*Distr) Get 

func (d *Distr) Get() string

Get the distribution of the reporting values.

func (*Distr) Set 

func (d *Distr) Set(in int)

Set sets the value for counting distribution.

type Encoder 

type Encoder interface {
	Marshal(any) ([]byte, error)
	Unmarshal([]byte, any) error
	Name() string
}

func GetEncoder 

func GetEncoder(name string) Encoder

type EndpointManager 

type EndpointManager interface {
	SelectAdapterProxy(msg *Message) (*AdapterProxy, bool)
	GetAllEndpoint() []*endpoint.Endpoint
	// contains filtered or unexported methods
}

EndpointManager interface of naming system

func GetManager 

func GetManager(comm *Communicator, objName string, opts ...EndpointManagerOption) EndpointManager

GetManager return a endpoint manager from global endpoint manager

type EndpointManagerOption 

type EndpointManagerOption interface {
	// contains filtered or unexported methods
}

type HashType 

type HashType int

HashType is the hash type 

const (
	ModHash HashType = iota
	ConsistentHash
)

HashType enum

type HttpHandler 

type HttpHandler interface {
	http.Handler
	SetConfig(cfg *TarsHttpConf)
}

type HttpInterceptor 

type HttpInterceptor func(w http.ResponseWriter, r *http.Request, handler http.HandlerFunc)

type Invoke 

type Invoke func(ctx context.Context, msg *Message, timeout time.Duration) (err error)

Invoke is used for Invoke tars server service

type Max 

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

Max struct is for counting the Max value for the reporting value.

func NewMax 

func NewMax() *Max

NewMax new and init the Max struct.

func (*Max) Enum 

func (m *Max) Enum() ReportPolicy

Enum return the report policy

func (*Max) Get 

func (m *Max) Get() (out string)

Get gets the max value.

func (*Max) Set 

func (m *Max) Set(in int)

Set sets a value for counting max.

type Message 

type Message struct {
	Req  *requestf.RequestPacket
	Resp *requestf.ResponsePacket

	Ser *ServantProxy
	Adp *AdapterProxy

	BeginTime int64
	EndTime   int64
	Status    int32
	// contains filtered or unexported fields
}

Message is a struct contains servant information

func (*Message) Cost 

func (m *Message) Cost() int64

Cost calculate the cost time

func (*Message) End 

func (m *Message) End()

End define the endTime

func (*Message) HashCode 

func (m *Message) HashCode() uint32

func (*Message) HashType 

func (m *Message) HashType() selector.HashType

func (*Message) IPPort 

func (m *Message) IPPort() string

func (*Message) Init 

func (m *Message) Init()

Init define the beginTime

func (*Message) IsHash 

func (m *Message) IsHash() bool

func (*Message) SetHash 

func (m *Message) SetHash(code uint32, h HashType)

SetHash set hash code

type Min 

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

Min is the struct for counting the min value.

func NewMin 

func NewMin() *Min

NewMin new and init the min struct.

func (*Min) Enum 

func (m *Min) Enum() ReportPolicy

Enum return the report policy

func (*Min) Get 

func (m *Min) Get() (out string)

Get returns the min value for the Min struct.

func (*Min) Set 

func (m *Min) Set(in int)

Set sets a value for counting min value.

type NodeFHelper 

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

NodeFHelper is helper struct.

func (*NodeFHelper) KeepAlive 

func (n *NodeFHelper) KeepAlive(adapter string)

KeepAlive sends the keepalive package to the node.

func (*NodeFHelper) ReportVersion 

func (n *NodeFHelper) ReportVersion(version string)

ReportVersion report the tars version to the node.

func (*NodeFHelper) SetNodeInfo 

func (n *NodeFHelper) SetNodeInfo(comm *Communicator, node string, app string, server string, container string)

SetNodeInfo sets node information with communicator, node name, app name, server and container name

type NotifyHelper 

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

NotifyHelper is the helper struct for the Notify service.

func (*NotifyHelper) ReportNotifyInfo 

func (n *NotifyHelper) ReportNotifyInfo(level int32, info string)

ReportNotifyInfo reports notify information with level and info

func (*NotifyHelper) SetNotifyInfo 

func (n *NotifyHelper) SetNotifyInfo(comm *Communicator, notify string, app string, server string, container string)

SetNotifyInfo sets the communicator's notify info with communicator, notify name, app name, server name, and container name

type ObjCache 

type ObjCache struct {
	Name    string
	SetID   string
	Locator string

	Endpoints         []endpointf.EndpointF
	InactiveEndpoints []endpointf.EndpointF
}

type Option 

type Option func(o *options)

func Registrar 

func Registrar(r registry.Registrar) Option

Registrar returns an Option to use the Registrar

type OptionFunc 

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

func WithSet 

func WithSet(setDivision string) OptionFunc

type PropertyReport 

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

PropertyReport property report struct

func CreatePropertyReport 

func CreatePropertyReport(key string, argv ...ReportMethod) *PropertyReport

CreatePropertyReport creates the property report instance with the key.

func GetPropertyReport 

func GetPropertyReport(key string) *PropertyReport

GetPropertyReport gets the property report instance with the key.

func (*PropertyReport) Report 

func (p *PropertyReport) Report(in int)

Report reports a value.

type PropertyReportHelper 

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

PropertyReportHelper is helper struct for property report. 

var (
	// ProHelper is global PropertyReportHelper instance
	ProHelper *PropertyReportHelper
)

func (*PropertyReportHelper) AddToReport 

func (p *PropertyReportHelper) AddToReport(pr *PropertyReport)

AddToReport adds the user's PropertyReport to the PropertyReportHelper

func (*PropertyReportHelper) Init 

func (p *PropertyReportHelper) Init(comm *Communicator, node string)

Init inits the PropertyReportHelper

func (*PropertyReportHelper) ReportToServer 

func (p *PropertyReportHelper) ReportToServer()

ReportToServer report to the remote propertyreport server.

func (*PropertyReportHelper) Run 

func (p *PropertyReportHelper) Run()

Run start the properting report goroutine.

type Protocol 

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

Protocol is struct for dispatch with tars protocol.

func NewTarsProtocol 

func NewTarsProtocol(dispatcher dispatch, imp interface{}) *Protocol

NewTarsProtocol return a TarsProtocol with dispatcher and implement interface. withContext explain using context or not.

func (*Protocol) DoClose 

func (s *Protocol) DoClose(ctx context.Context)

DoClose be called when close connection

func (*Protocol) GetCloseMsg 

func (s *Protocol) GetCloseMsg() []byte

GetCloseMsg return a package to close connection

func (*Protocol) Invoke 

func (s *Protocol) Invoke(ctx context.Context, req []byte) (rsp []byte)

Invoke puts the request as []byte and call the dispatcher, and then return the response as []byte.

func (*Protocol) InvokeTimeout 

func (s *Protocol) InvokeTimeout(pkg []byte) []byte

InvokeTimeout indicates how to deal with timeout.

func (*Protocol) ParsePackage 

func (s *Protocol) ParsePackage(buff []byte) (int, int)

ParsePackage parse the []byte according to the tars protocol. returns header length and package integrity condition (PackageLess | PackageFull | PackageError)

type ProxyPrx 

type ProxyPrx interface {
	SetServant(s.Servant)
}

ProxyPrx interface

type RConf 

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

RConf struct for getting remote config.

func GetRConf 

func GetRConf() *RConf

GetRConf returns a default RConf

func NewRConf 

func NewRConf(app string, server string, path string) *RConf

NewRConf init a RConf, path should be getting from GetServerConfig().BasePath

func (*RConf) GetAppConfig 

func (c *RConf) GetAppConfig(filename string) (config string, err error)

GetAppConfig gets the remote config and save it to the path, also return the content.

func (*RConf) GetConfig 

func (c *RConf) GetConfig(filename string) (config string, err error)

GetConfig gets the remote config and save it to the path, also return the content.

func (*RConf) GetConfigList 

func (c *RConf) GetConfigList() (fList []string, err error)

GetConfigList is discarded.

type RemoteTimeWriter 

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

RemoteTimeWriter writer for writing remote log.

func NewRemoteTimeWriter 

func NewRemoteTimeWriter() *RemoteTimeWriter

NewRemoteTimeWriter new and init RemoteTimeWriter

func (*RemoteTimeWriter) EnablePrefix 

func (rw *RemoteTimeWriter) EnablePrefix(hasAppNamePrefix bool)

EnablePrefix puts prefix before logs.

func (*RemoteTimeWriter) EnableSquareWrapper 

func (rw *RemoteTimeWriter) EnableSquareWrapper(hasSquareBracket bool)

EnableSquareWrapper enables SquareBracket wrapper for the logs.

func (*RemoteTimeWriter) EnableSuffix 

func (rw *RemoteTimeWriter) EnableSuffix(hasSuffix bool)

EnableSuffix puts suffix after logs.

func (*RemoteTimeWriter) InitFormat 

func (rw *RemoteTimeWriter) InitFormat(s string)

InitFormat sets the log format.

func (*RemoteTimeWriter) InitServerInfo 

func (rw *RemoteTimeWriter) InitServerInfo(app string, server string, filename string, setdivision string)

InitServerInfo init the remote log server info.

func (*RemoteTimeWriter) NeedPrefix 

func (rw *RemoteTimeWriter) NeedPrefix() bool

NeedPrefix return if you need prefix for the logger.

func (*RemoteTimeWriter) SetFileNameConcatStr 

func (rw *RemoteTimeWriter) SetFileNameConcatStr(s string)

SetFileNameConcatStr sets the filename concat string.

func (*RemoteTimeWriter) SetLogType 

func (rw *RemoteTimeWriter) SetLogType(logType string)

SetLogType sets the log type.

func (*RemoteTimeWriter) SetPrefix 

func (rw *RemoteTimeWriter) SetPrefix(enable bool)

SetPrefix set if you need prefix for the logger.

func (*RemoteTimeWriter) SetSeparator 

func (rw *RemoteTimeWriter) SetSeparator(s string)

SetSeparator set separator between logs.

func (*RemoteTimeWriter) Sync2remote 

func (rw *RemoteTimeWriter) Sync2remote()

Sync2remote syncs the log buffer to remote.

func (*RemoteTimeWriter) Write 

func (rw *RemoteTimeWriter) Write(b []byte)

Write the logs to the buffer.

type ReportMethod 

type ReportMethod interface {
	Enum() ReportPolicy
	Set(int)
	Get() string
	// contains filtered or unexported methods
}

ReportMethod is the interface for all kinds of report methods.

type ReportPolicy 

type ReportPolicy int

ReportPolicy is report policy 

const (
	ReportPolicyUnknown ReportPolicy = iota
	ReportPolicySum                  // 1
	ReportPolicyAvg                  // 2
	ReportPolicyDistr                // 3
	ReportPolicyMax                  // 4
	ReportPolicyMin                  // 5
	ReportPolicyCount                // 6
)

func (ReportPolicy) String 

func (p ReportPolicy) String() string

type ServantProxy 

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

ServantProxy tars servant proxy instance

func NewServantProxy 

func NewServantProxy(comm *Communicator, objName string, opts ...EndpointManagerOption) *ServantProxy

NewServantProxy creates and initializes a servant proxy

func (*ServantProxy) Endpoints 

func (s *ServantProxy) Endpoints() []*endpoint.Endpoint

Endpoints returns all active endpoint.Endpoint

func (*ServantProxy) Name 

func (s *ServantProxy) Name() string

Name is obj name

func (*ServantProxy) SetPushCallback 

func (s *ServantProxy) SetPushCallback(callback func([]byte))

SetPushCallback set callback function for pushing

func (*ServantProxy) TarsInvoke 

func (s *ServantProxy) TarsInvoke(ctx context.Context, cType byte,
	sFuncName string,
	buf []byte,
	status map[string]string,
	reqContext map[string]string,
	resp *requestf.ResponsePacket) error

TarsInvoke is used for client invoking server.

func (*ServantProxy) TarsInvokeOri 

func (s *ServantProxy) TarsInvokeOri(ctx context.Context, cType byte,
	ipport string,
	sFuncName string,
	buf []byte) (*requestf.ResponsePacket, error)

func (*ServantProxy) TarsSetProtocol 

func (s *ServantProxy) TarsSetProtocol(proto model.Protocol)

TarsSetProtocol tars set model protocol

func (*ServantProxy) TarsSetTimeout 

func (s *ServantProxy) TarsSetTimeout(t int)

TarsSetTimeout sets the timeout for client calling the server , which is in ms.

func (*ServantProxy) TarsSetVersion 

func (s *ServantProxy) TarsSetVersion(iVersion int16)

TarsSetVersion set tars version

type ServerConfOption 

type ServerConfOption func(*transport.TarsServerConf)

func WithMaxInvoke 

func WithMaxInvoke(maxInvoke int32) ServerConfOption

func WithQueueCap 

func WithQueueCap(queueCap int) ServerConfOption

func WithTlsConfig 

func WithTlsConfig(tlsConfig *tls.Config) ServerConfOption

type ServerInterceptor 

type ServerInterceptor func(ctx context.Context, dispatch Dispatch, impl interface{},
	req *requestf.RequestPacket, resp *requestf.ResponsePacket) (err error)

ServerInterceptor is used for add Filter for server dispatcher ,for implementing plugins like opentracing.

type StatFHelper 

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

StatFHelper is helper struct for stat reporting. 

var (
	StatReport *StatFHelper
)

StatReport instance pointer of StatFHelper

func (*StatFHelper) Init 

func (s *StatFHelper) Init(comm *Communicator, servant string)

Init the StatFHelper

func (*StatFHelper) ReportMicMsg 

func (s *StatFHelper) ReportMicMsg(stStatInfo StatInfo, fromServer bool)

ReportMicMsg report the StatInfo ,from server shows whether it comes from server.

func (*StatFHelper) Run 

func (s *StatFHelper) Run()

Run stat report loop

type StatInfo 

type StatInfo struct {
	Head statf.StatMicMsgHead
	Body statf.StatMicMsgBody
}

StatInfo struct contains stat info head and body.

type Sum 

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

Sum report methods.

func NewSum 

func NewSum() *Sum

NewSum new and init the sum report methods.

func (*Sum) Enum 

func (s *Sum) Enum() ReportPolicy

Enum return the report policy

func (*Sum) Get 

func (s *Sum) Get() (out string)

Get gets the result of the sum report method.

func (*Sum) Set 

func (s *Sum) Set(in int)

Set sets a value tho the sum method.

type TarsHttpConf 

type TarsHttpConf struct {
	Container              string
	AppName                string
	IP                     string
	Port                   int32
	Version                string
	SetId                  string
	ExceptionStatusChecker func(int) bool
}

TarsHttpConf is configuration for tars http server.

type TarsHttpMux 

type TarsHttpMux struct {
	http.ServeMux
	// contains filtered or unexported fields
}

TarsHttpMux is http.ServeMux for tars http server.

func (*TarsHttpMux) ServeHTTP 

func (mux *TarsHttpMux) ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP is the server for the TarsHttpMux.

func (*TarsHttpMux) SetConfig 

func (mux *TarsHttpMux) SetConfig(cfg *TarsHttpConf)

SetConfig sets the cfg tho the TarsHttpMux.

type TarsResponseWriter 

type TarsResponseWriter struct {
	http.ResponseWriter
	StatusCode int
}

TarsResponseWriter is http.ResponseWriter for tars.

func (*TarsResponseWriter) Hijack 

func (w *TarsResponseWriter) Hijack() (net.Conn, *bufio.ReadWriter, error)

Hijack add Hijack method for TarsResponseWriter

func (*TarsResponseWriter) WriteHeader 

func (w *TarsResponseWriter) WriteHeader(code int)

WriteHeader is used for write the http header with the http code.

Source Files

View all Source files

Directories

Path Synopsis
codec
push
res/adminf
Code generated by tars2go 1.2.3, DO NOT EDIT.
 Code generated by tars2go 1.2.3, DO NOT EDIT.
res/authf
Code generated by tars2go 1.2.3, DO NOT EDIT.
 Code generated by tars2go 1.2.3, DO NOT EDIT.
res/basef
Code generated by tars2go 1.2.3, DO NOT EDIT.
 Code generated by tars2go 1.2.3, DO NOT EDIT.
res/configf
Code generated by tars2go 1.2.3, DO NOT EDIT.
 Code generated by tars2go 1.2.3, DO NOT EDIT.
res/endpointf
Code generated by tars2go 1.2.3, DO NOT EDIT.
 Code generated by tars2go 1.2.3, DO NOT EDIT.
res/logf
Code generated by tars2go 1.2.3, DO NOT EDIT.
 Code generated by tars2go 1.2.3, DO NOT EDIT.
res/nodef
Code generated by tars2go 1.2.3, DO NOT EDIT.
 Code generated by tars2go 1.2.3, DO NOT EDIT.
res/notifyf
Code generated by tars2go 1.2.3, DO NOT EDIT.
 Code generated by tars2go 1.2.3, DO NOT EDIT.
res/propertyf
Code generated by tars2go 1.2.3, DO NOT EDIT.
 Code generated by tars2go 1.2.3, DO NOT EDIT.
res/queryf
Code generated by tars2go 1.2.3, DO NOT EDIT.
 Code generated by tars2go 1.2.3, DO NOT EDIT.
res/requestf
Code generated by tars2go 1.2.3, DO NOT EDIT.
 Code generated by tars2go 1.2.3, DO NOT EDIT.
res/statf
Code generated by tars2go 1.2.3, DO NOT EDIT.
 Code generated by tars2go 1.2.3, DO NOT EDIT.
tup
tars
consistenthash
modhash
random
roundrobin
_examples/helloserver
_examples/udpserver
util
conf
Package conf implements parse the taf config.
 Package conf implements parse the taf config.
current
debug
endpoint
gpool
grace
gtime
logx
rogger
rtimer
set
Package set implement
 Package set implement
ssl
sync
tools
trace

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.