api

type Client ¶

type Client[T any] struct {
	Handler[T]
}

func NewClient[T any](c ctx.C, init T) (Client[T], error)

func (this Client[T]) Recv(c ctx.C, res ClientResponse, into T) (err error)

func (this Client[T]) Send(c ctx.C, obj T, data ClientRequest) error

type ClientRequest ¶

type ClientRequest interface {
	Marshal(c ctx.C, name string, into reflect.Value) error
}

the client request object used to Marshal a request to a server

type ClientResponse ¶

type ClientResponse interface {
	Unmarshal(c ctx.C, name string, from reflect.Value) error
}

the client response object used to unmarshal the response from the server

type Handler ¶

type Handler[T any] struct {
	// contains filtered or unexported fields
}

each type of object T has its own handler

func NewHandler[T any](c ctx.C, init T) (Handler[T], error)

func (this *Handler[T]) Client() Client[T]

func (this *Handler[T]) Path() string

func (this *Handler[T]) Paths() []string

func (this *Handler[T]) Server() Server[T]

func (this *Handler[T]) Type() reflect.Type

func (this *Handler[T]) URL() *url.URL

func (this *Handler[T]) URLs() []*url.URL

type JSON ¶

type JSON struct {
	Data enc.Map
	UID  enc.Node
	// contains filtered or unexported fields
}

implementation for all the client/server request/responses using json Note(oha): the object is not goroutine safe, but it's not expected to be

func (this *JSON) Auth(c ctx.C, into reflect.Value, required bool) error

func (this *JSON) Marshal(c ctx.C, name string, from reflect.Value) error

func (this *JSON) ReadFrom(c ctx.C, r io.Reader) error

func (this JSON) String() string

func (this *JSON) Unmarshal(c ctx.C, name string, into reflect.Value) error

type Request ¶

type Request struct {
	Headers map[string]string
}

type Server ¶

type Server[T any] struct {
	Handler[T]
}

func NewServer[T any](c ctx.C, init T) (Server[T], error)

func (this Server[T]) Recv(c ctx.C, req ServerRequest) (T, error)

func (this Server[T]) Send(c ctx.C, obj T, res ServerResponse) (err error)

type ServerRequest ¶

type ServerRequest interface {
	Unmarshal(c ctx.C, name string, into reflect.Value) error
	Auth(c ctx.C, into reflect.Value, required bool) error
}

the server request object used to Unmarshal the request from the client

type ServerResponse ¶

type ServerResponse interface {
	Marshal(c ctx.C, name string, into reflect.Value) error
}

the server response object used to marshal the response to the client