service

package module
v0.0.2 Latest Latest
Warning

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

Go to latest
Published: Jun 26, 2024 License: MIT Imports: 17 Imported by: 0

README

service

create a web service over http/https/h2/h2c

service plugin for https://github.com/ssgo/s

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type APICache

type APICache struct {
	Filename string
	Mtime    int64
	Code     *gojs.PreCompiledCode
}

type APIConfig

type APIConfig struct {
	AuthLevel  int
	Method     string
	Host       string
	Path       string
	Memo       string
	ActionFile string
}

func (*APIConfig) String

func (conf *APIConfig) String() string

type AsyncServer

type AsyncServer struct {
	Addr      string
	Proto     string
	ProtoName string
	// contains filtered or unexported fields
}

func (*AsyncServer) Delete

func (c *AsyncServer) Delete(ctx *plugin.Context, url string, body interface{}, headers *map[string]string) (*Result, error)

Delete 发送DELETE请求

func (*AsyncServer) Do

func (c *AsyncServer) Do(ctx *plugin.Context, method string, url string, body interface{}, headers *map[string]string) (*Result, error)

Do 发送请求 * method 请求方法,GET、POST等

func (*AsyncServer) Get

func (c *AsyncServer) Get(ctx *plugin.Context, url string, headers *map[string]string) (*Result, error)

Get 发送GET请求 * url 以http://或https://开头的URL地址,如果设置了baseURL可以只提供path部分 * headers 传入一个Key-Value对象的HTTP头信息,如果不指定头信息这个参数可以省略不传 * return 返回结果对象,如果返回值是JSON格式,将自动转化为对象否则将字符串放在.result中,如发生错误将抛出异常,返回的对象中还包括:headers、statusCode、statusMessage

func (*AsyncServer) Head

func (c *AsyncServer) Head(ctx *plugin.Context, url string, headers *map[string]string) (*Result, error)

Head 发送HEAD请求

func (*AsyncServer) ManualDo

func (c *AsyncServer) ManualDo(ctx *plugin.Context, method string, url string, body interface{}, headers *map[string]string) (*ManualResult, error)

ManualDo 手动处理请求,需要自行从返回结果中读取数据,可实现SSE客户端 ManualDo return 应答的对象(需手动读取数据并关闭请求)

func (*AsyncServer) OnStop

func (c *AsyncServer) OnStop(f func())

func (*AsyncServer) Open

func (c *AsyncServer) Open(ctx *plugin.Context, url string, headers *map[string]string) (*WS, error)

Open 打开一个Websocket连接 Open return Websocket对象(使用完毕请关闭连接)

func (*AsyncServer) Post

func (c *AsyncServer) Post(ctx *plugin.Context, url string, body interface{}, headers *map[string]string) (*Result, error)

Post 发送POST请求 * body 可以传入任意类型,如果不是字符串或二进制数组时会自动添加application/json头,数据将以json格式发送

func (*AsyncServer) Put

func (c *AsyncServer) Put(ctx *plugin.Context, url string, body interface{}, headers *map[string]string) (*Result, error)

Put 发送PUT请求

func (*AsyncServer) SetBaseURL

func (c *AsyncServer) SetBaseURL(url string)

SetBaseURL 设置一个URL前缀,后续请求中可以只提供path部分 SetBaseURL url 以http://或https://开头的URL地址

func (*AsyncServer) SetGlobalHeaders

func (c *AsyncServer) SetGlobalHeaders(headers map[string]string)

SetGlobalHeaders 设置固定的HTTP头部信息,在每个请求中都加入这些HTTP头 SetGlobalHeaders headers 传入一个Key-Value对象的HTTP头信息

func (*AsyncServer) Stop

func (c *AsyncServer) Stop()

func (*AsyncServer) Wait

func (c *AsyncServer) Wait()

type DiscoverClient

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

func (*DiscoverClient) Delete

func (c *DiscoverClient) Delete(ctx *plugin.Context, app, url string, body interface{}, headers *map[string]string) (*Result, error)

Delete 发送DELETE请求

func (*DiscoverClient) Do

func (c *DiscoverClient) Do(ctx *plugin.Context, method, app, url string, body interface{}, headers *map[string]string) (*Result, error)

Do 发送请求 * method 请求方法,GET、POST等

func (*DiscoverClient) Get

func (c *DiscoverClient) Get(ctx *plugin.Context, app, url string, headers *map[string]string) (*Result, error)

Get 发送GET请求 * url 以http://或https://开头的URL地址,如果设置了baseURL可以只提供path部分 * headers 传入一个Key-Value对象的HTTP头信息,如果不指定头信息这个参数可以省略不传 * return 返回结果对象,如果返回值是JSON格式,将自动转化为对象否则将字符串放在.result中,如发生错误将抛出异常,返回的对象中还包括:headers、statusCode、statusMessage

func (*DiscoverClient) Head

func (c *DiscoverClient) Head(ctx *plugin.Context, app, url string, headers *map[string]string) (*Result, error)

Head 发送HEAD请求

func (*DiscoverClient) ManualDo

func (c *DiscoverClient) ManualDo(ctx *plugin.Context, method, app string, url string, body interface{}, headers *map[string]string) (*ManualResult, error)

ManualDo 手动处理请求,需要自行从返回结果中读取数据,可实现SSE客户端 ManualDo return 应答的对象(需手动读取数据并关闭请求)

func (*DiscoverClient) Open

func (c *DiscoverClient) Open(ctx *plugin.Context, app, url string, headers *map[string]string) (*WS, error)

Open 打开一个Websocket连接 Open return Websocket对象(使用完毕请关闭连接)

func (*DiscoverClient) Post

func (c *DiscoverClient) Post(ctx *plugin.Context, app, url string, body interface{}, headers *map[string]string) (*Result, error)

Post 发送POST请求 * body 可以传入任意类型,如果不是字符串或二进制数组时会自动添加application/json头,数据将以json格式发送

func (*DiscoverClient) Put

func (c *DiscoverClient) Put(ctx *plugin.Context, app, url string, body interface{}, headers *map[string]string) (*Result, error)

Put 发送PUT请求

func (*DiscoverClient) SetGlobalHeaders

func (c *DiscoverClient) SetGlobalHeaders(headers map[string]string)

SetGlobalHeaders 设置固定的HTTP头部信息,在每个请求中都加入这些HTTP头 SetGlobalHeaders headers 传入一个Key-Value对象的HTTP头信息

type ManualResult

type ManualResult struct {
	Result
	// contains filtered or unexported fields
}

func (*ManualResult) Close

func (r *ManualResult) Close() error

func (*ManualResult) Read

func (r *ManualResult) Read(n int) (string, error)

func (*ManualResult) ReadBytes

func (r *ManualResult) ReadBytes(n int) ([]byte, error)

func (*ManualResult) Save

func (r *ManualResult) Save(filename string) error

type ProxyByResult

type ProxyByResult struct {
	AuthLevel int
	ToApp     *string
	ToPath    *string
	Headers   map[string]string
}

type Result

type Result struct {
	Error      string
	StatusCode int
	Headers    map[string]string
	Data       interface{}
	// contains filtered or unexported fields
}

func (*Result) Bytes

func (r *Result) Bytes() []byte

func (*Result) String

func (r *Result) String() string

type Session

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

func NewSession

func NewSession(id string, logger *log.Logger) *Session

func (*Session) Get

func (session *Session) Get(key string) any

func (*Session) MGet

func (session *Session) MGet(keys ...string) map[string]any

func (*Session) MSet

func (session *Session) MSet(data map[string]any)

func (*Session) Remove

func (session *Session) Remove(keys ...string)

func (*Session) Save

func (session *Session) Save()

func (*Session) Set

func (session *Session) Set(key string, value any)

type WS

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

func (*WS) Close

func (ws *WS) Close() error

Close 关闭连接

func (*WS) EnableCompression

func (ws *WS) EnableCompression()

EnableCompression 启用压缩

func (*WS) Read

func (ws *WS) Read() (string, error)

Read 读取文本数据 Read return 读取到的字符串

func (*WS) ReadBytes

func (ws *WS) ReadBytes() ([]byte, error)

ReadBytes 读取二进制数据 ReadBytes return 读取到的二进制数据

func (*WS) ReadJSON

func (ws *WS) ReadJSON() (interface{}, error)

ReadJSON 读取JSON对象 ReadJSON return 读取到的对象

func (*WS) Write

func (ws *WS) Write(content string) error

Write 写入文本数据 Write content 文本数据

func (*WS) WriteBytes

func (ws *WS) WriteBytes(content []byte) error

WriteBytes 写入二进制数据 WriteBytes content 二进制数据

func (*WS) WriteJSON

func (ws *WS) WriteJSON(content interface{}) error

WriteJSON 写入对象 WriteJSON content 对象

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL