router

README

Package Router

This package help to manage routers in an API. This package requires go Gin Tonic API Framework.

By default, Gin Tonic API need a main package to register all handler func into the gin engine. This way is not easy usable with many people who's can add routers or exploit them. In add, middleware isn't defined as real middleware but more than cascaded call of all registered handler for a route.

This package allows to change this process :

• auth allow to register a real middleware who's can manage call of other handler for a route
• register implement a global collector of handler with router / group and called into init func of yours routers directly
• router implements the global registrar of all registered handler with route and group, ordered by group
• ...

Example of implementation

We will work on an example of file/folder tree like this :

/
  bin/
    api/
      config/
      routers/
        routers.go

in the routers.go file, we will implement the router package call :

package routers

import (
	"github.com/nabbar/golib/router"

    "myapp/bin/api/config"
)

var (
	RouterList = router.NewRouterList()
)

func Run() {
	config.GetConfig().ServerListen(router.Handler(RouterList))
}

This variable RouterList will be call by all routers. Note you will just need to call your routers' packages into a main router like this :

package main

import (
    _ "myapp/bin/api/routers/status"
    _ "myapp/bin/api/routers/static"
  // ... add all your packages with an init register
  // careful: do not add this import into your routers.go package to avoid circular import
)

Documentation

Index

• Constants
• func AuthForbidden(c *ginsdk.Context, err error)
• func AuthRequire(c *ginsdk.Context, err error)
• func DefaultGinInit() *ginsdk.Engine
• func DefaultGinWithTrustedPlatform(trustedPlatform string) *ginsdk.Engine
• func DefaultGinWithTrustyProxy(trustyProxy []string) *ginsdk.Engine
• func GinAccessLog(log liblog.FuncLog) ginsdk.HandlerFunc
• func GinAddGlobalMiddleware(eng *ginsdk.Engine, middleware ...ginsdk.HandlerFunc) *ginsdk.Engine
• func GinEngine(trustedPlatform string, trustyProxy ...string) (*ginsdk.Engine, error)
• func GinErrorLog(log liblog.FuncLog) ginsdk.HandlerFunc
• func GinLatencyContext(c *ginsdk.Context)
• func GinRequestContext(c *ginsdk.Context)
• func Handler(routerList RouterList) http.Handler
• func RoutersHandler(engine *ginsdk.Engine)
• func RoutersRegister(method string, relativePath string, router ...ginsdk.HandlerFunc)
• func RoutersRegisterInGroup(group, method string, relativePath string, router ...ginsdk.HandlerFunc)
• func SetGinHandler(fct func(c *ginsdk.Context)) ginsdk.HandlerFunc
• type AuthCode
• type Authorization
  • func NewAuthorization(log liblog.FuncLog, HeadAuthType string, ...) Authorization
• type Headers
  • func NewHeaders() Headers
• type HeadersConfig
  • func (h HeadersConfig) New() Headers
  • func (h HeadersConfig) Validate() liberr.Error
• type RegisterRouter
• type RegisterRouterInGroup
• type RouterList
  • func NewRouterList(initGin func() *ginsdk.Engine) RouterList

Constants

const (
	AUTH_CODE_SUCCESS = iota
	AUTH_CODE_REQUIRE
	AUTH_CODE_FORBIDDEN
)

const (
	HEAD_AUTH_REQR = "WWW-Authenticate"
	HEAD_AUTH_SEND = "Authorization"
	HEAD_AUTH_REAL = "Basic realm=LDAP Authorization Required"
)

const (
	ErrorParamEmpty liberr.CodeError = iota + liberr.MinPkgRouter
	ErrorConfigValidator
	ErrorHeaderAuth
	ErrorHeaderAuthMissing
	ErrorHeaderAuthEmpty
	ErrorHeaderAuthRequire
	ErrorHeaderAuthForbidden
)

const (
	EmptyHandlerGroup           = "<nil>"
	GinContextStartUnixNanoTime = "gin-ctx-start-unix-nano-time"
	GinContextRequestPath       = "gin-ctx-request-path"
	GinContextRequestUser       = "gin-ctx-request-user"
)

Functions

func AuthForbidden

func AuthForbidden(c *ginsdk.Context, err error)

func AuthRequire

func AuthRequire(c *ginsdk.Context, err error)

func DefaultGinInit

func DefaultGinInit() *ginsdk.Engine

func DefaultGinWithTrustedPlatform

func DefaultGinWithTrustedPlatform(trustedPlatform string) *ginsdk.Engine

func DefaultGinWithTrustyProxy

func DefaultGinWithTrustyProxy(trustyProxy []string) *ginsdk.Engine

func GinAccessLog

func GinAccessLog(log liblog.FuncLog) ginsdk.HandlerFunc

func GinAddGlobalMiddleware

func GinAddGlobalMiddleware(eng *ginsdk.Engine, middleware ...ginsdk.HandlerFunc) *ginsdk.Engine

func GinEngine

func GinEngine(trustedPlatform string, trustyProxy ...string) (*ginsdk.Engine, error)

func GinErrorLog

func GinErrorLog(log liblog.FuncLog) ginsdk.HandlerFunc

func GinLatencyContext

func GinLatencyContext(c *ginsdk.Context)

func GinRequestContext

func GinRequestContext(c *ginsdk.Context)

func Handler

func Handler(routerList RouterList) http.Handler

func RoutersHandler

func RoutersHandler(engine *ginsdk.Engine)

func RoutersRegister

func RoutersRegister(method string, relativePath string, router ...ginsdk.HandlerFunc)

func RoutersRegisterInGroup

func RoutersRegisterInGroup(group, method string, relativePath string, router ...ginsdk.HandlerFunc)

func SetGinHandler

func SetGinHandler(fct func(c *ginsdk.Context)) ginsdk.HandlerFunc

SetGinHandler func that return given func as ginTonic HandlerFunc interface type.

Types

type AuthCode

type AuthCode uint8

type Authorization

type Authorization interface {
	Handler(c *ginsdk.Context)
	Register(router ...ginsdk.HandlerFunc) ginsdk.HandlerFunc
	Append(router ...ginsdk.HandlerFunc)
}

func NewAuthorization

func NewAuthorization(log liblog.FuncLog, HeadAuthType string, authCheckFunc func(AuthHeader string) (AuthCode, liberr.Error)) Authorization

type Headers

type Headers interface {
	Add(key, value string)
	Set(key, value string)
	Get(key string) string
	Del(key string)

	Header() map[string]string
	Register(router ...ginsdk.HandlerFunc) []ginsdk.HandlerFunc
	Handler(c *ginsdk.Context)

	Clone() Headers
}

func NewHeaders

func NewHeaders() Headers

type HeadersConfig

type HeadersConfig map[string]string

func (HeadersConfig) New

func (h HeadersConfig) New() Headers

func (HeadersConfig) Validate

func (h HeadersConfig) Validate() liberr.Error

type RegisterRouter

type RegisterRouter func(method string, relativePath string, router ...ginsdk.HandlerFunc)

type RegisterRouterInGroup

type RegisterRouterInGroup func(group, method string, relativePath string, router ...ginsdk.HandlerFunc)

type RouterList

type RouterList interface {
	Register(method string, relativePath string, router ...ginsdk.HandlerFunc)
	RegisterInGroup(group, method string, relativePath string, router ...ginsdk.HandlerFunc)
	Handler(engine *ginsdk.Engine)
	Engine() *ginsdk.Engine
}

func NewRouterList

func NewRouterList(initGin func() *ginsdk.Engine) RouterList