api

package module
v0.5.1 Latest Latest
Warning

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

 Go to latest Published: Jan 13, 2021 License: MIT Imports: 16 Imported by: 8

README

api-server

Documentation

Index

Constants

View Source 
const (
	//MethodGet GET
	MethodGet string = `GET`
	//MethodPost POST
	MethodPost string = `POST`

	//StatusBadRequest ...
	StatusBadRequest = 400
	//StatusUnauthorized ...
	StatusUnauthorized = 401
	//StatusNotFound ...
	StatusNotFound = 404
	//StatusOK ...
	StatusOK = 200

	//StatusInternalServerError ...
	StatusInternalServerError = 500

	//StatusBadGateway ...
	StatusBadGateway = 502
)

Variables

This section is empty.

Functions

This section is empty.

Types

type Action 

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

Action ...

type Context 

type Context interface {
	Session() Session
	Request() Request
	Response() Response
	Tx() *db.Tx
	SetValue(name string, value interface{})
	GetValue(name string) interface{}
}

Context ..

type Request 

type Request interface {
	Method() string
	URL() *url.URL
	JSON() json.Object
	Body() []byte
	Header() *RequestHeader
}

Request ..

type RequestHeader added in v0.5.0 

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

RequestHeader ...

func (*RequestHeader) Get added in v0.5.0 

func (r *RequestHeader) Get(key string) string

Get ..

func (*RequestHeader) GetOrNil added in v0.5.1 

func (r *RequestHeader) GetOrNil(key string) *string

GetOrNil ..

type Response 

type Response interface {
	Header() *ResponseHeader
	Body() []byte
	SetBody(body []byte)
	ContentType() string
	SetStatus(status int, msg string)
	SetStatusCode(status int)
	SetStatusMessage(msg string)
}

Response ..

type ResponseHeader added in v0.5.1 

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

ResponseHeader ...

func (*ResponseHeader) Add added in v0.5.1 

func (r *ResponseHeader) Add(key, value string)

Add ..

func (*ResponseHeader) Set added in v0.5.1 

func (r *ResponseHeader) Set(key, value string)

Set ..

type Route 

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

Route ...

func NewFuncRoute added in v0.4.0 

func NewFuncRoute(f func(ctx Context) (interface{}, error)) *Route

NewFuncRoute create POST route with single func action

func NewRoute added in v0.3.2 

func NewRoute() *Route

NewRoute create route

func (*Route) AddFuncAction 

func (r *Route) AddFuncAction(f func(ctx Context) (interface{}, error), property string) (Action, error)

AddFuncAction ...

func (*Route) AddQueryAction 

func (r *Route) AddQueryAction(query, params, property string) (Action, error)

AddQueryAction ...

func (*Route) SetSecure 

func (r *Route) SetSecure(secure bool)

SetSecure ...

type RouteAuthenticator added in v0.5.0 

type RouteAuthenticator func(ctx Context) error

RouteAuthenticator ..

type Server 

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

Server ...

func New added in v0.3.1 

func New() *Server

New ...

func (*Server) AddFinalHandler added in v0.5.0 

func (s *Server) AddFinalHandler(f func(ctx Context))

AddFinalHandler ..

func (*Server) AddFuncRoute added in v0.3.2 

func (s *Server) AddFuncRoute(f func(ctx Context) (interface{}, error), secure bool) (*Route, error)

AddFuncRoute add route with single func action. When secure is true, this route will validated using auth middlewares if any.

func (*Server) AddMiddleware 

func (s *Server) AddMiddleware(f func(Context) error)

AddMiddleware ..

func (*Server) AddPostRoute 

func (s *Server) AddPostRoute(path string, f func(ctx Context) (interface{}, error), secure bool) (*Route, error)

AddPostRoute ..

func (*Server) AddQueryRoute added in v0.3.2 

func (s *Server) AddQueryRoute(path, query, params string, secure bool) (*Route, error)

AddQueryRoute add route with single query action. When secure is true, this route will validated using auth middlewares if any.

func (*Server) AddRouteAuthenticator added in v0.5.0 

func (s *Server) AddRouteAuthenticator(a RouteAuthenticator)

AddRouteAuthenticator ..

func (*Server) AddSecureMiddleware added in v0.5.1 

func (s *Server) AddSecureMiddleware(f func(Context) error)

AddSecureMiddleware ..

func (*Server) Connect 

func (s *Server) Connect() error

Connect ...

func (*Server) Database 

func (s *Server) Database() *db.Connection

Database ...

func (*Server) FileRoute added in v0.4.0 

func (s *Server) FileRoute(path, dest, redirectTo string) error

FileRoute serve static file. Path parameter to determine url to be processed. Dest parameter will find directory of the file reside. RedirectTo parameter to redirect non existing file, this param can be used for SPA (ex. index.html).

func (*Server) FileRouteRemove added in v0.4.1 

func (s *Server) FileRouteRemove(path string) error

FileRouteRemove ...

func (*Server) GetRoute 

func (s *Server) GetRoute(method, path string) (*Route, error)

GetRoute ...

func (*Server) NormalizeFunc added in v0.3.2 

func (s *Server) NormalizeFunc(n bool)

NormalizeFunc if yes from this and beyond all Func added will renamed to lowercase, separated with underscore. Ex: HelloWorld registered as hello_world

func (*Server) OpenDatabase 

func (s *Server) OpenDatabase(driver, host string, port int, username, password, name string) error

OpenDatabase call SetDatabase and Connect

func (*Server) Proxy added in v0.4.0 

func (s *Server) Proxy(path, dest string) error

Proxy ...

func (*Server) Serve 

func (s *Server) Serve(port int) error

Serve ..

func (*Server) SetDatabase 

func (s *Server) SetDatabase(driver, host string, port int, username, password, name string)

SetDatabase ...

func (*Server) SetDebug 

func (s *Server) SetDebug()

SetDebug ...

func (*Server) SetLogger 

func (s *Server) SetLogger(debug func(v ...interface{}), warn func(v ...interface{}), err func(v ...interface{}))

SetLogger ...

func (*Server) SetProduction 

func (s *Server) SetProduction()

SetProduction ...

func (*Server) SetRoute 

func (s *Server) SetRoute(method, path string, route *Route)

SetRoute ...

func (*Server) Shutdown added in v0.5.1 

func (s *Server) Shutdown() error

Shutdown ..

type Session 

type Session interface {
	Put(key string, value interface{})
	Get(key string) interface{}
	GetInt(key string) int
	GetString(key string) string
}

Session ...

Source Files

View all Source files

Directories

Path Synopsis
examples
helloworld command
secure 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.