rex

package module
v0.12.3 Latest Latest
Warning

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

 Go to latest Published: Mar 16, 2020 License: MIT Imports: 24 Imported by: 1

README

REX

REX provides a simple & light-weight REST server in Golang.

GoDoc

Example
package main

import (
    "github.com/ije/rex"
)

func main() {
    rex.Get("/hello/:name", func(ctx *rex.Context) {
	    ctx.Ok("Hello, " + ctx.URL.Param("name"))
    })

    rex.Start(8080)
}

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Delete added in v0.9.0 

func Delete(path string, handles ...Handle)

Delete is a shortcut for rest.Handle("DELETE", path, handles)

func Get added in v0.9.0 

func Get(path string, handles ...Handle)

Get is a shortcut for rest.Handle("GET", path, handles) 

func Head(path string, handles ...Handle)

Head is a shortcut for rest.Handle("HEAD", path, handles)

func NotFound added in v0.9.0 

func NotFound(handle Handle)

NotFound sets a not found handle

func Options added in v0.9.0 

func Options(path string, handles ...Handle)

Options is a shortcut for rest.Handle("OPTIONS", path, handles)

func Patch added in v0.9.0 

func Patch(path string, handles ...Handle)

Patch is a shortcut for rest.Handle("PATCH", path, handles)

func Post added in v0.9.0 

func Post(path string, handles ...Handle)

Post is a shortcut for rest.Handle("POST", path, handles)

func Put added in v0.9.0 

func Put(path string, handles ...Handle)

Put is a shortcut for rest.Handle("PUT", path, handles)

func Serve 

func Serve(config Config)

Serve serves a rex server.

func Start added in v0.9.0 

func Start(port uint16)

Start starts a REX server.

func StartAutoTLS added in v0.9.0 

func StartAutoTLS(port uint16, hosts ...string)

StartAutoTLS starts a REX server with autocert powered by Let's Encrypto SSL

func StartTLS added in v0.9.0 

func StartTLS(port uint16, certFile string, keyFile string)

StartTLS starts a REX server with TLS.

func Trace added in v0.9.8 

func Trace(path string, handles ...Handle)

Trace is a shortcut for rest.Handle("TRACE", path, handles)

func Use added in v0.9.0 

func Use(middlewares ...Handle)

Use appends middleware to the REST middleware stack.

Types

type ACLUser added in v0.8.1 

type ACLUser interface {
	Permissions() []string
}

A ACLUser contains a Permissions method that returns the acl permission id list

type AutoTLSConfig added in v0.4.0 

type AutoTLSConfig struct {
	AcceptTOS bool           `json:"acceptTOS"`
	Hosts     []string       `json:"hosts"`
	CacheDir  string         `json:"cacheDir"`
	Cache     autocert.Cache `json:"-"`
}

AutoTLSConfig contains options to support autocert by Let's Encrypto SSL.

type BasicUser added in v0.8.1 

type BasicUser struct {
	Name     string
	Password string
}

BasicUser represents a http Basic-Auth user that contains the name & password

type CORSOptions added in v0.5.0 

type CORSOptions struct {
	AllowOrigin      string
	AllowMethods     []string
	AllowHeaders     []string
	ExposeHeaders    []string
	AllowCredentials bool
	MaxAge           int // in seconds
}

CORSOptions contains options to CORS.

type Config 

type Config struct {
	Port           uint16    `json:"port"`
	TLS            TLSConfig `json:"tls"`
	ReadTimeout    uint32    `json:"readTimeout"`
	WriteTimeout   uint32    `json:"writeTimeout"`
	MaxHeaderBytes uint32    `json:"maxHeaderBytes"`
	Debug          bool      `json:"debug"`
	Logger         Logger    `json:"-"`
	AccessLogger   Logger    `json:"-"`
}

Config contains options to run the REX server.

type Context 

type Context struct {
	W    http.ResponseWriter
	R    *http.Request
	URL  *URL
	Form *Form
	// contains filtered or unexported fields
}

func (*Context) ACLUser added in v0.6.0 

func (ctx *Context) ACLUser() ACLUser

func (*Context) AddHeader added in v0.1.5 

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

AddHeader adds the key, value pair to the header of response writer.

func (*Context) BasicUser added in v0.4.0 

func (ctx *Context) BasicUser() BasicUser

func (*Context) Content added in v0.9.10 

func (ctx *Context) Content(name string, modtime time.Time, content io.ReadSeeker)

Content replies to the request using the content in the provided ReadSeeker. The main benefit of ServeContent over io.Copy is that it handles Range requests properly, sets the MIME type, and handles If-Match, If-Unmodified-Since, If-None-Match, If-Modified-Since, and If-Range requests.

func (*Context) End 

func (ctx *Context) End(status int, a ...string)

func (*Context) Error 

func (ctx *Context) Error(err error)

Error replies to the request a internal server error. if debug is enable, replies the error message.

func (*Context) File added in v0.4.0 

func (ctx *Context) File(name string)

File replies to the request with the contents of the named file or directory.

func (*Context) GetCookie added in v0.1.9 

func (ctx *Context) GetCookie(name string) (cookie *http.Cookie, err error)

func (*Context) GetValue added in v0.11.0 

func (ctx *Context) GetValue(key string) (interface{}, bool)

GetValue returns the value stored in the values for a key, or nil if no value is present.

func (*Context) HTML added in v0.7.3 

func (ctx *Context) HTML(html string)

HTML replies to the request as a html.

func (*Context) IfModified added in v0.2.1 

func (ctx *Context) IfModified(modtime time.Time, then func())

func (*Context) IfNotMatch added in v0.5.0 

func (ctx *Context) IfNotMatch(etag string, then func())

func (*Context) JSON added in v0.7.3 

func (ctx *Context) JSON(v interface{})

JSON replies to the request as a json.

func (*Context) JSONError added in v0.7.4 

func (ctx *Context) JSONError(err error)

JSONError replies to the request a json error.

func (*Context) Next added in v0.4.0 

func (ctx *Context) Next()

func (*Context) Ok added in v0.4.0 

func (ctx *Context) Ok(text string)

Ok replies to the request the plain text with 200 status.

func (*Context) Redirect 

func (ctx *Context) Redirect(url string, status int)

func (*Context) RemoteIP 

func (ctx *Context) RemoteIP() string

func (*Context) RemoveCookie 

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

func (*Context) RemoveCookieByName added in v0.8.0 

func (ctx *Context) RemoveCookieByName(name string)

func (*Context) Render added in v0.5.0 

func (ctx *Context) Render(template Template, data interface{})

Render applies a parsed template with the specified data object, replies to the request.

func (*Context) RenderHTML added in v0.5.8 

func (ctx *Context) RenderHTML(html string, data interface{})

RenderHTML applies a unparsed html template with the specified data object, replies to the request.

func (*Context) Session 

func (ctx *Context) Session() *Session

func (*Context) SetACLUser added in v0.9.2 

func (ctx *Context) SetACLUser(user ACLUser)

func (*Context) SetCookie 

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

func (*Context) SetHeader added in v0.1.5 

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

SetHeader sets the header of response writer entries associated with key to the single element value.

func (*Context) StoreValue added in v0.9.2 

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

StoreValue sets the value for a key.

type Form added in v0.11.0 

type Form struct {
	R *http.Request
}

Form handles http form

func (*Form) Default added in v0.11.0 

func (form *Form) Default(key string, defaultValue string) string

func (*Form) File added in v0.11.0 

func (form *Form) File(key string) (multipart.File, *multipart.FileHeader, error)

func (*Form) Float added in v0.11.1 

func (form *Form) Float(key string) (float64, error)

func (*Form) Int added in v0.11.1 

func (form *Form) Int(key string) (int64, error)

func (*Form) Require added in v0.11.0 

func (form *Form) Require(key string) string

func (*Form) RequireFloat added in v0.11.0 

func (form *Form) RequireFloat(key string) float64

func (*Form) RequireInt added in v0.11.0 

func (form *Form) RequireInt(key string) int64

func (*Form) Value added in v0.11.0 

func (form *Form) Value(key string) string

Value returns the first value for the named component of the POST, PATCH, or PUT request body, or returns the first value for the named component of the request url query

type Handle added in v0.8.0 

type Handle func(ctx *Context)

Handle defines a REST handle

func ACL added in v0.5.1 

func ACL(permissions ...string) Handle

ACL returns a ACL middleware.

func BasicAuth added in v0.4.0 

func BasicAuth(authFunc func(name string, password string) (ok bool, err error)) Handle

BasicAuth returns a Basic HTTP Authorization middleware.

func BasicAuthWithRealm added in v0.8.0 

func BasicAuthWithRealm(realm string, authFunc func(name string, password string) (ok bool, err error)) Handle

BasicAuthWithRealm returns a Basic HTTP Authorization middleware with realm.

func CORS 

func CORS(opts CORSOptions) Handle

CORS returns a CORS middleware. 

func Header(key string, value string) Handle

Header is REX middleware to set http header

func SessionPool added in v0.9.4 

func SessionPool(pool session.Pool) Handle

SessionPool returns a SessionPool middleware.

func SessionSIDManager added in v0.9.10 

func SessionSIDManager(sidManager session.SIDManager) Handle

SessionSIDManager returns a SessionSIDManager middleware.

func Static added in v0.5.0 

func Static(root string, fallbackPath ...string) Handle

Static returns a file static serve middleware.

type InvalidError added in v0.7.4 

type InvalidError struct {
	Code    int
	Message string
}

InvalidError is an error with code

func Invalid added in v0.7.4 

func Invalid(code int, message string) *InvalidError

Invalid returns a new InvalidError

func (*InvalidError) Error added in v0.7.4 

func (err *InvalidError) Error() string

Error implements the error type

type Logger added in v0.5.0 

type Logger interface {
	Println(v ...interface{})
	Printf(format string, v ...interface{})
}

Logger is a logger contains Println and Printf methods.

type REST added in v0.4.0 

type REST struct {
	// prefix to add base path at beginning of each route path
	// for example if the Prefix equals "v2", the given route path "/path" will route "/v2/path"
	Prefix string
	// contains filtered or unexported fields
}

REST is REST-based router

func Group added in v0.9.3 

func Group(prefix string, callback func(*REST)) *REST

Group creates a nested REST

func New added in v0.4.0 

func New(args ...string) *REST

New returns a new REST

func (*REST) Delete added in v0.4.0 

func (rest *REST) Delete(path string, handles ...Handle)

Delete is a shortcut for rest.Handle("DELETE", path, handles)

func (*REST) Get added in v0.4.0 

func (rest *REST) Get(path string, handles ...Handle)

Get is a shortcut for rest.Handle("GET", path, handles)

func (*REST) Group added in v0.9.0 

func (rest *REST) Group(prefix string, callback func(*REST)) *REST

Group creates a nested REST

func (*REST) Handle added in v0.4.0 

func (rest *REST) Handle(method string, path string, handles ...Handle)

Handle handles requests that match the method and path

func (*REST) Head added in v0.4.0 

func (rest *REST) Head(path string, handles ...Handle)

Head is a shortcut for rest.Handle("HEAD", path, handles)

func (*REST) Options added in v0.4.0 

func (rest *REST) Options(path string, handles ...Handle)

Options is a shortcut for rest.Handle("OPTIONS", path, handles)

func (*REST) Patch added in v0.4.0 

func (rest *REST) Patch(path string, handles ...Handle)

Patch is a shortcut for rest.Handle("PATCH", path, handles)

func (*REST) Post added in v0.4.0 

func (rest *REST) Post(path string, handles ...Handle)

Post is a shortcut for rest.Handle("POST", path, handles)

func (*REST) Put added in v0.4.0 

func (rest *REST) Put(path string, handles ...Handle)

Put is a shortcut for rest.Handle("PUT", path, handles)

func (*REST) Trace added in v0.9.8 

func (rest *REST) Trace(path string, handles ...Handle)

Trace is a shortcut for rest.Handle("TRACE", path, handles)

func (*REST) Use added in v0.4.0 

func (rest *REST) Use(middlewares ...Handle)

Use appends middlewares to current REST middleware stack.

type Session added in v0.5.1 

type Session struct {
	session.Session
}

Session handles session

func (*Session) Delete added in v0.5.1 

func (s *Session) Delete(key string)

Delete removes a session value

func (*Session) Flush added in v0.5.1 

func (s *Session) Flush()

Flush flushes all session values

func (*Session) Get added in v0.5.1 

func (s *Session) Get(key string) interface{}

Get returns a session value

func (*Session) Has added in v0.5.1 

func (s *Session) Has(key string) bool

Has checks a value exists

func (*Session) SID added in v0.5.1 

func (s *Session) SID() string

SID returns the sid

func (*Session) Set added in v0.5.1 

func (s *Session) Set(key string, value interface{})

Set sets a session value

type TLSConfig added in v0.9.0 

type TLSConfig struct {
	Port         uint16        `json:"port"`
	CertFile     string        `json:"certFile"`
	KeyFile      string        `json:"keyFile"`
	AutoTLS      AutoTLSConfig `json:"autotls"`
	AutoRedirect bool          `json:"autoRedirect"`
}

TLSConfig contains options to support https.

type Template added in v0.5.8 

type Template interface {
	Execute(wr io.Writer, data interface{}) error
}

Template is a template contains an Execute method.

type URL 

type URL struct {
	Params    router.Params
	RoutePath string
	*url.URL
}

A URL is a *url.URL with router.Params and RoutePath

func (*URL) Param added in v0.4.0 

func (url *URL) Param(name string) string

Param returns the value of the first Param which key matches the given name. If no matching Param is found, an empty string is returned.

Source Files

View all Source files

Directories

Path Synopsis
examples
basic-auth command
group-router command
hello command
json command
not-found command
session command
static command
todos command
zip command

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.