context

Documentation

Index

• type App
  • func NewApp() *App
  • func (app *App) ANY(url string, handler ...Handler) *App
  • func (app *App) AppendReqAndResp(url, method string, handler []Handler)
  • func (app *App) DELETE(url string, handler ...Handler) *App
  • func (app *App) Find(url, method string) []Handler
  • func (app *App) GET(url string, handler ...Handler) *App
  • func (app *App) Group(prefix string, middleware ...Handler) *RouterGroup
  • func (app *App) HEAD(url string, handler ...Handler) *App
  • func (app *App) Name(name string)
  • func (app *App) OPTIONS(url string, handler ...Handler) *App
  • func (app *App) POST(url string, handler ...Handler) *App
  • func (app *App) PUT(url string, handler ...Handler) *App
• type Context
  • func NewContext(req *http.Request) *Context
  • func (ctx *Context) Abort()
  • func (ctx *Context) AddHeader(key, value string)
  • func (ctx *Context) BindJSON(data interface{}) error
  • func (ctx *Context) Data(code int, contentType string, data []byte)
  • func (ctx *Context) FormValue(key string) string
  • func (ctx *Context) HTML(code int, body string)
  • func (ctx *Context) Headers(key string) string
  • func (ctx *Context) JSON(code int, Body map[string]interface{})
  • func (ctx *Context) LocalIP() string
  • func (ctx *Context) Method() string
  • func (ctx *Context) MustBindJSON(data interface{})
  • func (ctx *Context) Next()
  • func (ctx *Context) Path() string
  • func (ctx *Context) PostForm() url.Values
  • func (ctx *Context) Query(key string) string
  • func (ctx *Context) QueryDefault(key, def string) string
  • func (ctx *Context) Redirect(path string)
  • func (ctx *Context) SetContentType(contentType string)
  • func (ctx *Context) SetCookie(cookie *http.Cookie)
  • func (ctx *Context) SetHandlers(handlers Handlers) *Context
  • func (ctx *Context) SetHeader(key, value string)
  • func (ctx *Context) SetStatusCode(code int)
  • func (ctx *Context) SetUserValue(key string, value interface{})
  • func (ctx *Context) User() interface{}
  • func (ctx *Context) Write(code int, Header map[string]string, Body string)
  • func (ctx *Context) WriteString(Body string)
• type Handler
• type Handlers
• type Node
• type Path
• type Router
  • func (r Router) GetURL(value ...string) string
  • func (r Router) Method() string
• type RouterGroup
  • func (g *RouterGroup) ANY(url string, handler ...Handler) *RouterGroup
  • func (g *RouterGroup) AppendReqAndResp(url, method string, handler []Handler)
  • func (g *RouterGroup) DELETE(url string, handler ...Handler) *RouterGroup
  • func (g *RouterGroup) GET(url string, handler ...Handler) *RouterGroup
  • func (g *RouterGroup) Group(prefix string, middleware ...Handler) *RouterGroup
  • func (g *RouterGroup) HEAD(url string, handler ...Handler) *RouterGroup
  • func (g *RouterGroup) Name(name string)
  • func (g *RouterGroup) OPTIONS(url string, handler ...Handler) *RouterGroup
  • func (g *RouterGroup) POST(url string, handler ...Handler) *RouterGroup
  • func (g *RouterGroup) PUT(url string, handler ...Handler) *RouterGroup
  • func (g *RouterGroup) Print()
• type RouterMap
  • func (r RouterMap) Get(name string) Router

Types

type App

type App struct {
	Requests []Path

	Middlewares Handlers
	Prefix      string

	Routers RouterMap
	// contains filtered or unexported fields
}

App is the key struct of the package. App as a member of plugin entity contains the request and the corresponding handler. Prefix is the url prefix and MiddlewareList is for control flow.

func NewApp

func NewApp() *App

NewApp return an empty app.

func (*App) ANY

func (app *App) ANY(url string, handler ...Handler) *App

ANY registers a route that matches all the HTTP methods. GET, POST, PUT, HEAD, OPTIONS, DELETE.

func (*App) AppendReqAndResp

func (app *App) AppendReqAndResp(url, method string, handler []Handler)

AppendReqAndResp stores the request info and handle into app. support the route parameter. The route parameter will be recognized as wildcard store into the RegUrl of Path struct. For example:

/user/:id      => /user/(.*)
/user/:id/info => /user/(.*?)/info

The RegUrl will be used to recognize the incoming path and find the handler.

func (*App) DELETE

func (app *App) DELETE(url string, handler ...Handler) *App

DELETE is a shortcut for app.AppendReqAndResp(url, "delete", handler).

func (*App) Find

func (app *App) Find(url, method string) []Handler

Find is public helper method for findPath of tree.

func (*App) GET

func (app *App) GET(url string, handler ...Handler) *App

GET is a shortcut for app.AppendReqAndResp(url, "get", handler).

func (*App) Group

func (app *App) Group(prefix string, middleware ...Handler) *RouterGroup

Group add middlewares and prefix for App.

func (*App) HEAD

func (app *App) HEAD(url string, handler ...Handler) *App

HEAD is a shortcut for app.AppendReqAndResp(url, "head", handler).

func (*App) Name

func (app *App) Name(name string)

func (*App) OPTIONS

func (app *App) OPTIONS(url string, handler ...Handler) *App

OPTIONS is a shortcut for app.AppendReqAndResp(url, "options", handler).

func (*App) POST

func (app *App) POST(url string, handler ...Handler) *App

POST is a shortcut for app.AppendReqAndResp(url, "post", handler).

func (*App) PUT

func (app *App) PUT(url string, handler ...Handler) *App

PUT is a shortcut for app.AppendReqAndResp(url, "put", handler).

type Context

type Context struct {
	Request   *http.Request
	Response  *http.Response
	UserValue map[string]interface{}
	// contains filtered or unexported fields
}

Context is the simplify version of web framework context. But it is important which will be used in plugins to custom the request and response. And adapter will help to transform the Context to the web framework`s context. It has three attributes. Request and response are belongs to net/http package. UserValue is the custom key-value store of context.

func NewContext

func NewContext(req *http.Request) *Context

NewContext used in adapter which return a Context with request and slice of UserValue and a default Response.

func (*Context) Abort

func (ctx *Context) Abort()

Abort abort the context.

func (*Context) AddHeader

func (ctx *Context) AddHeader(key, value string)

AddHeader adds the key, value pair to the header.

func (*Context) BindJSON

func (ctx *Context) BindJSON(data interface{}) error

func (*Context) Data

func (ctx *Context) Data(code int, contentType string, data []byte)

Data writes some data into the body stream and updates the HTTP code.

func (*Context) FormValue

func (ctx *Context) FormValue(key string) string

FormValue get the value of request form key.

func (*Context) HTML

func (ctx *Context) HTML(code int, body string)

HTML output html response.

func (*Context) Headers

func (ctx *Context) Headers(key string) string

Headers get the value of request headers key.

func (*Context) JSON

func (ctx *Context) JSON(code int, Body map[string]interface{})

JSON serializes the given struct as JSON into the response body. It also sets the Content-Type as "application/json".

func (*Context) LocalIP

func (ctx *Context) LocalIP() string

LocalIP return the request client ip.

func (*Context) Method

func (ctx *Context) Method() string

Method return the request method.

func (*Context) MustBindJSON

func (ctx *Context) MustBindJSON(data interface{})

func (*Context) Next

func (ctx *Context) Next()

Next should be used only inside middleware.

func (*Context) Path

func (ctx *Context) Path() string

Path return the url path.

func (*Context) PostForm

func (ctx *Context) PostForm() url.Values

PostForm get the values of request form.

func (*Context) Query

func (ctx *Context) Query(key string) string

Query get the query parameter of url.

func (*Context) QueryDefault

func (ctx *Context) QueryDefault(key, def string) string

QueryDefault get the query parameter of url. If it is empty, return the default.

func (*Context) Redirect

func (ctx *Context) Redirect(path string)

Redirect add redirect url to header.

func (*Context) SetContentType

func (ctx *Context) SetContentType(contentType string)

SetContentType save the given content type header into the response header.

func (*Context) SetCookie

func (ctx *Context) SetCookie(cookie *http.Cookie)

SetCookie save the given cookie obj into the response Set-Cookie header.

func (*Context) SetHandlers

func (ctx *Context) SetHandlers(handlers Handlers) *Context

SetHandlers set the handlers of Context.

func (*Context) SetHeader

func (ctx *Context) SetHeader(key, value string)

SetHeader set the key, value pair to the header.

func (*Context) SetStatusCode

func (ctx *Context) SetStatusCode(code int)

SetStatusCode save the given status code into the response.

func (*Context) SetUserValue

func (ctx *Context) SetUserValue(key string, value interface{})

SetUserValue set the value of user context.

func (*Context) User

func (ctx *Context) User() interface{}

User return the current login user.

func (*Context) Write

func (ctx *Context) Write(code int, Header map[string]string, Body string)

Write save the given status code, header and body string into the response.

func (*Context) WriteString

func (ctx *Context) WriteString(Body string)

WriteString save the given body string into the response.

type Handler

type Handler func(ctx *Context)

Handler defines the handler used by the middleware as return value.

type Handlers

type Handlers []Handler

Handlers is the array of Handler

type Node

type Node struct {
	Path     string
	Method   string
	Handlers []Handler
	Value    map[string]interface{}
}

type Path

type Path struct {
	URL    string
	Method string
}

Path is used in the matching of request and response. Url stores the raw register url. RegUrl contains the wildcard which on behalf of the route params.

type Router

type Router struct {
	Methods []string
	Patten  string
}

func (Router) GetURL

func (r Router) GetURL(value ...string) string

func (Router) Method

func (r Router) Method() string

type RouterGroup

type RouterGroup struct {
	Middlewares Handlers
	Prefix      string
	// contains filtered or unexported fields
}

RouterGroup is a group of routes.

func (*RouterGroup) ANY

func (g *RouterGroup) ANY(url string, handler ...Handler) *RouterGroup

ANY registers a route that matches all the HTTP methods. GET, POST, PUT, HEAD, OPTIONS, DELETE.

func (*RouterGroup) AppendReqAndResp

func (g *RouterGroup) AppendReqAndResp(url, method string, handler []Handler)

AppendReqAndResp stores the request info and handle into app. support the route parameter. The route parameter will be recognized as wildcard store into the RegUrl of Path struct. For example:

/user/:id      => /user/(.*)
/user/:id/info => /user/(.*?)/info

The RegUrl will be used to recognize the incoming path and find the handler.

func (*RouterGroup) DELETE

func (g *RouterGroup) DELETE(url string, handler ...Handler) *RouterGroup

DELETE is a shortcut for app.AppendReqAndResp(url, "delete", handler).

func (*RouterGroup) GET

func (g *RouterGroup) GET(url string, handler ...Handler) *RouterGroup

GET is a shortcut for app.AppendReqAndResp(url, "get", handler).

func (*RouterGroup) Group

func (g *RouterGroup) Group(prefix string, middleware ...Handler) *RouterGroup

Group add middlewares and prefix for RouterGroup.

func (*RouterGroup) HEAD

func (g *RouterGroup) HEAD(url string, handler ...Handler) *RouterGroup

HEAD is a shortcut for app.AppendReqAndResp(url, "head", handler).

func (*RouterGroup) Name

func (g *RouterGroup) Name(name string)

func (*RouterGroup) OPTIONS

func (g *RouterGroup) OPTIONS(url string, handler ...Handler) *RouterGroup

OPTIONS is a shortcut for app.AppendReqAndResp(url, "options", handler).

func (*RouterGroup) POST

func (g *RouterGroup) POST(url string, handler ...Handler) *RouterGroup

POST is a shortcut for app.AppendReqAndResp(url, "post", handler).

func (*RouterGroup) PUT

func (g *RouterGroup) PUT(url string, handler ...Handler) *RouterGroup

PUT is a shortcut for app.AppendReqAndResp(url, "put", handler).

func (*RouterGroup) Print

func (g *RouterGroup) Print()

type RouterMap

type RouterMap map[string]Router

func (RouterMap) Get

func (r RouterMap) Get(name string) Router