beego

package module
v1.10.1 Latest Latest
Warning

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

 Go to latest Published: Jul 31, 2018 License: Apache-2.0 Imports: 41 Imported by: 0

README

Beego Build Status GoDoc Foundation Go Report Card

beego is used for rapid development of RESTful APIs, web apps and backend services in Go. It is inspired by Tornado, Sinatra and Flask. beego has some Go-specific features such as interfaces and struct embedding.

More info at beego.me.

Quick Start

Download and install
go get github.com/astaxie/beego
Create file hello.go
package main

import "github.com/astaxie/beego"

func main(){
    beego.Run()
}
Build and run
go build hello.go
./hello
Go to http://localhost:8080

Congratulations! You've just built your first beego app.

Please see Documentation for more.

Features

  • RESTful support
  • MVC architecture
  • Modularity
  • Auto API documents
  • Annotation router
  • Namespace
  • Powerful development tools
  • Full stack for Web & API

Documentation

Community

License

beego source code is licensed under the Apache Licence, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0.html).

Documentation

Overview

Package beego provide a MVC framework beego: an open-source, high-performance, modular, full-stack web framework

It is used for rapid development of RESTful APIs, web apps and backend services in Go. beego is inspired by Tornado, Sinatra and Flask with the added benefit of some Go-specific features such as interfaces and struct embedding. 

package main
import "github.com/astaxie/beego"

func main() {
 beego.Run()
}

more information: http://beego.me

Index

Constants

View Source 
const (
	// VERSION represent beego web framework version.
	VERSION = "1.10.1"

	// DEV is for develop
	DEV = "dev"
	// PROD is for production
	PROD = "prod"
)
View Source 
const (
	LevelEmergency = iota
	LevelAlert
	LevelCritical
	LevelError
	LevelWarning
	LevelNotice
	LevelInformational
	LevelDebug
)

Log levels to control the logging output.

View Source 
const (
	BeforeStatic = iota
	BeforeRouter
	BeforeExec
	AfterExec
	FinishRouter
)

default filter execution points

Variables

View Source 
var (
	// BConfig is the default config for Application
	BConfig *Config
	// AppConfig is the instance of Config, store the config information from file
	AppConfig *beegoAppConfig
	// AppPath is the absolute path to the app
	AppPath string
	// GlobalSessions is the instance for the session manager
	GlobalSessions *session.Manager
)
View Source 
var (
	// ErrAbort custom error when user stop request handler manually.
	ErrAbort = errors.New("User stop run")
	// GlobalControllerRouter store comments with controller. pkgpath+controller:comments
	GlobalControllerRouter = make(map[string][]ControllerComments)
)
View Source 
var BeeLogger = logs.GetBeeLogger()

BeeLogger references the used application logger.

View Source 
var ErrorMaps = make(map[string]*errorInfo, 10)

ErrorMaps holds map of http handlers for each error string. there is 10 kinds default error(40x and 50x)

View Source 
var FilterMonitorFunc func(string, string, time.Duration, string, int) bool

FilterMonitorFunc is default monitor filter when admin module is enable. if this func returns, admin module records qbs for this request by condition of this function logic. usage: 

func MyFilterMonitor(method, requestPath string, t time.Duration, pattern string, statusCode int) bool {
 	if method == "POST" {
		return false
 	}
 	if t.Nanoseconds() < 100 {
		return false
 	}
 	if strings.HasPrefix(requestPath, "/astaxie") {
		return false
 	}
 	return true
}
beego.FilterMonitorFunc = MyFilterMonitor.

Functions

func AddAPPStartHook 

func AddAPPStartHook(hf ...hookfunc)

AddAPPStartHook is used to register the hookfunc The hookfuncs will run in beego.Run() such as initiating session , starting middleware , building template, starting admin control and so on.

func AddFuncMap 

func AddFuncMap(key string, fn interface{}) error

AddFuncMap let user to register a func in the template.

func AddNamespace 

func AddNamespace(nl ...*Namespace)

AddNamespace register Namespace into beego.Handler support multi Namespace

func AddTemplateExt 

func AddTemplateExt(ext string)

AddTemplateExt add new extension for template.

func AddViewPath added in v1.8.0 

func AddViewPath(viewPath string) error

AddViewPath adds a new path to the supported view paths. Can later be used by setting a controller ViewPath to this folder will panic if called after beego.Run()

func Alert added in v1.4.0 

func Alert(v ...interface{})

Alert logs a message at alert level.

func AssetsCSS added in v1.6.0 

func AssetsCSS(text string) template.HTML

AssetsCSS returns stylesheet link tag with src string.

func AssetsJs 

func AssetsJs(text string) template.HTML

AssetsJs returns script tag with src string.

func BuildTemplate 

func BuildTemplate(dir string, files ...string) error

BuildTemplate will build all template files in a directory. it makes beego can render any template file in view directory.

func Compare 

func Compare(a, b interface{}) (equal bool)

Compare is a quick and dirty comparison function. It will convert whatever you give it to strings and see if the two values are equal. Whitespace is trimmed. Used by the template parser as "eq".

func CompareNot added in v1.4.3 

func CompareNot(a, b interface{}) (equal bool)

CompareNot !Compare

func Critical 

func Critical(v ...interface{})

Critical logs a message at critical level.

func Date 

func Date(t time.Time, format string) string

Date takes a PHP like date func to Go's time format.

func DateFormat 

func DateFormat(t time.Time, layout string) (datestring string)

DateFormat takes a time and a layout string and returns a string with the formatted date. Used by the template parser as "dateformat"

func DateParse 

func DateParse(dateString, format string) (time.Time, error)

DateParse Parse Date use PHP time format.

func Debug 

func Debug(v ...interface{})

Debug logs a message at debug level.

func Emergency added in v1.4.0 

func Emergency(v ...interface{})

Emergency logs a message at emergency level.

func Error 

func Error(v ...interface{})

Error logs a message at error level.

func ExceptMethodAppend 

func ExceptMethodAppend(action string)

ExceptMethodAppend to append a slice's value into "exceptMethod", for controller's methods shouldn't reflect to AutoRouter

func Exception added in v1.7.0 

func Exception(errCode uint64, ctx *context.Context)

Exception Write HttpStatus with errCode and Exec error handler if exist.

func ExecuteTemplate added in v1.7.0 

func ExecuteTemplate(wr io.Writer, name string, data interface{}) error

ExecuteTemplate applies the template with name to the specified data object, writing the output to wr. A template will be executed safely in parallel.

func ExecuteViewPathTemplate added in v1.8.0 

func ExecuteViewPathTemplate(wr io.Writer, name string, viewPath string, data interface{}) error

ExecuteViewPathTemplate applies the template with name and from specific viewPath to the specified data object, writing the output to wr. A template will be executed safely in parallel.

func GetConfig added in v1.4.0 

func GetConfig(returnType, key string, defaultVal interface{}) (value interface{}, err error)

GetConfig get the Appconfig

func HTML2str added in v1.6.0 

func HTML2str(html string) string

HTML2str returns escaping text convert from html.

func HasTemplateExt 

func HasTemplateExt(paths string) bool

HasTemplateExt return this path contains supported template extension of beego or not.

func Htmlquote 

func Htmlquote(text string) string

Htmlquote returns quoted html string.

func Htmlunquote 

func Htmlunquote(text string) string

Htmlunquote returns unquoted html string.

func Info 

func Info(v ...interface{})

Info compatibility alias for Warning()

func Informational added in v1.4.0 

func Informational(v ...interface{})

Informational logs a message at info level.

func InitBeegoBeforeTest added in v1.7.1 

func InitBeegoBeforeTest(appConfigPath string)

InitBeegoBeforeTest is for test package init

func LoadAppConfig added in v1.6.1 

func LoadAppConfig(adapterName, configPath string) error

LoadAppConfig allow developer to apply a config file

func MapGet added in v1.6.0 

func MapGet(arg1 interface{}, arg2 ...interface{}) (interface{}, error)

MapGet getting value from map by keys usage: 

Data["m"] = map[string]interface{} {
    "a": 1,
    "1": map[string]float64{
        "c": 4,
    },
}

{{ map_get m "a" }} // return 1 {{ map_get m 1 "c" }} // return 4

func NotNil added in v1.4.3 

func NotNil(a interface{}) (isNil bool)

NotNil the same as CompareNot

func Notice added in v1.4.0 

func Notice(v ...interface{})

Notice logs a message at notice level.

func ParseForm 

func ParseForm(form url.Values, obj interface{}) error

ParseForm will parse form values to struct via tag.

func Policy added in v1.7.2 

func Policy(pattern, method string, policy ...PolicyFunc)

Policy Register new policy in beego

func PrintTree added in v1.8.2 

func PrintTree() map[string]interface{}

PrintTree prints all registered routers.

func RenderForm 

func RenderForm(obj interface{}) template.HTML

RenderForm will render object to form html. obj must be a struct pointer.

func Run 

func Run(params ...string)

Run beego application. beego.Run() default run on HttpPort beego.Run("localhost") beego.Run(":8089") beego.Run("127.0.0.1:8089")

func RunWithMiddleWares added in v1.9.2 

func RunWithMiddleWares(addr string, mws ...MiddleWare)

RunWithMiddleWares Run beego application with middlewares.

func SetLevel 

func SetLevel(l int)

SetLevel sets the global log level used by the simple logger.

func SetLogFuncCall 

func SetLogFuncCall(b bool)

SetLogFuncCall set the CallDepth, default is 3

func SetLogger 

func SetLogger(adaptername string, config string) error

SetLogger sets a new logger.

func Str2html 

func Str2html(raw string) template.HTML

Str2html Convert string to template.HTML type.

func Substr 

func Substr(s string, start, length int) string

Substr returns the substr from start to length.

func TestBeegoInit 

func TestBeegoInit(ap string)

TestBeegoInit is for test package init

func Trace 

func Trace(v ...interface{})

Trace logs a message at trace level. compatibility alias for Warning()

func URLFor added in v1.6.0 

func URLFor(endpoint string, values ...interface{}) string

URLFor returns url string with another registered controller handler with params. 

	usage:

	URLFor(".index")
	print URLFor("index")
 router /login
	print URLFor("login")
	print URLFor("login", "next","/"")
 router /profile/:username
	print UrlFor("profile", ":username","John Doe")
	result:
	/
	/login
	/login?next=/
	/user/John%20Doe

 more detail http://beego.me/docs/mvc/controller/urlbuilding.md

func Warn 

func Warn(v ...interface{})

Warn compatibility alias for Warning()

func Warning added in v1.4.0 

func Warning(v ...interface{})

Warning logs a message at warning level.

Types

type App 

type App struct {
	Handlers *ControllerRegister
	Server   *http.Server
}

App defines beego application with a new PatternServeMux. 

var (
	// BeeApp is an application instance
	BeeApp *App
)

func AddTemplateEngine added in v1.7.0 

func AddTemplateEngine(extension string, fn templatePreProcessor) *App

AddTemplateEngine add a new templatePreProcessor which support extension

func Any 

func Any(rootpath string, f FilterFunc) *App

Any used to register router for all methods usage: 

beego.Any("/api", func(ctx *context.Context){
      ctx.Output.Body("hello world")
})

func AutoPrefix 

func AutoPrefix(prefix string, c ControllerInterface) *App

AutoPrefix adds controller handler to BeeApp with prefix. it's same to App.AutoRouterWithPrefix. if beego.AutoPrefix("/admin",&MainContorlller{}) and MainController has methods List and Page, visit the url /admin/main/list to exec List function or /admin/main/page to exec Page function.

func AutoRouter 

func AutoRouter(c ControllerInterface) *App

AutoRouter adds defined controller handler to BeeApp. it's same to App.AutoRouter. if beego.AddAuto(&MainContorlller{}) and MainController has methods List and Page, visit the url /main/list to exec List function or /main/page to exec Page function.

func DelStaticPath 

func DelStaticPath(url string) *App

DelStaticPath removes the static folder setting in this url pattern in beego application.

func Delete 

func Delete(rootpath string, f FilterFunc) *App

Delete used to register router for Delete method usage: 

beego.Delete("/api", func(ctx *context.Context){
      ctx.Output.Body("hello world")
})

func ErrorController added in v1.4.3 

func ErrorController(c ControllerInterface) *App

ErrorController registers ControllerInterface to each http err code string. usage: 

beego.ErrorController(&controllers.ErrorController{})

func ErrorHandler added in v1.6.0 

func ErrorHandler(code string, h http.HandlerFunc) *App

ErrorHandler registers http.HandlerFunc to each http err code string. usage: 

beego.ErrorHandler("404",NotFound)
beego.ErrorHandler("500",InternalServerError)

func Get 

func Get(rootpath string, f FilterFunc) *App

Get used to register router for Get method usage: 

beego.Get("/", func(ctx *context.Context){
      ctx.Output.Body("hello world")
})

func Handler 

func Handler(rootpath string, h http.Handler, options ...interface{}) *App

Handler used to register a Handler router usage: 

beego.Handler("/api", http.HandlerFunc(func (w http.ResponseWriter, r *http.Request) {
      fmt.Fprintf(w, "Hello, %q", html.EscapeString(r.URL.Path))
}))

func Head(rootpath string, f FilterFunc) *App

Head used to register router for Head method usage: 

beego.Head("/api", func(ctx *context.Context){
      ctx.Output.Body("hello world")
})

func Include added in v1.3.0 

func Include(cList ...ControllerInterface) *App

Include will generate router file in the router/xxx.go from the controller's comments usage: beego.Include(&BankAccount{}, &OrderController{},&RefundController{},&ReceiptController{}) 

type BankAccount struct{
  beego.Controller
}

register the function 

func (b *BankAccount)Mapping(){
 b.Mapping("ShowAccount" , b.ShowAccount)
 b.Mapping("ModifyAccount", b.ModifyAccount)
}

//@router /account/:id [get] 

func (b *BankAccount) ShowAccount(){
   //logic
}

//@router /account/:id [post] 

func (b *BankAccount) ModifyAccount(){
   //logic
}

the comments @router url methodlist url support all the function Router's pattern methodlist [get post head put delete options *]

func InsertFilter 

func InsertFilter(pattern string, pos int, filter FilterFunc, params ...bool) *App

InsertFilter adds a FilterFunc with pattern condition and action constant. The pos means action constant including beego.BeforeStatic, beego.BeforeRouter, beego.BeforeExec, beego.AfterExec and beego.FinishRouter. The bool params is for setting the returnOnOutput value (false allows multiple filters to execute)

func NewApp 

func NewApp() *App

NewApp returns a new beego application.

func Options 

func Options(rootpath string, f FilterFunc) *App

Options used to register router for Options method usage: 

beego.Options("/api", func(ctx *context.Context){
      ctx.Output.Body("hello world")
})

func Patch 

func Patch(rootpath string, f FilterFunc) *App

Patch used to register router for Patch method usage: 

beego.Patch("/api", func(ctx *context.Context){
      ctx.Output.Body("hello world")
})

func Post 

func Post(rootpath string, f FilterFunc) *App

Post used to register router for Post method usage: 

beego.Post("/api", func(ctx *context.Context){
      ctx.Output.Body("hello world")
})

func Put 

func Put(rootpath string, f FilterFunc) *App

Put used to register router for Put method usage: 

beego.Put("/api", func(ctx *context.Context){
      ctx.Output.Body("hello world")
})

func RESTRouter 

func RESTRouter(rootpath string, c ControllerInterface) *App

RESTRouter adds a restful controller handler to BeeApp. its' controller implements beego.ControllerInterface and defines a param "pattern/:objectId" to visit each resource.

func Router 

func Router(rootpath string, c ControllerInterface, mappingMethods ...string) *App

Router adds a patterned controller handler to BeeApp. it's an alias method of App.Router. usage: 

simple router
beego.Router("/admin", &admin.UserController{})
beego.Router("/admin/index", &admin.ArticleController{})

regex router

beego.Router("/api/:id([0-9]+)", &controllers.RController{})

custom rules
beego.Router("/api/list",&RestController{},"*:ListFood")
beego.Router("/api/create",&RestController{},"post:CreateFood")
beego.Router("/api/update",&RestController{},"put:UpdateFood")
beego.Router("/api/delete",&RestController{},"delete:DeleteFood")

func SetStaticPath 

func SetStaticPath(url string, path string) *App

SetStaticPath sets static directory path and proper url pattern in beego application. if beego.SetStaticPath("static","public"), visit /static/* to load static file in folder "public".

func SetViewsPath 

func SetViewsPath(path string) *App

SetViewsPath sets view directory path in beego application.

func UnregisterFixedRoute added in v1.9.2 

func UnregisterFixedRoute(fixedRoute string, method string) *App

UnregisterFixedRoute unregisters the route with the specified fixedRoute. It is particularly useful in web applications that inherit most routes from a base webapp via the underscore import, and aim to overwrite only certain paths. The method parameter can be empty or "*" for all HTTP methods, or a particular method type (e.g. "GET" or "POST") for selective removal.

Usage (replace "GET" with "*" for all methods): 

beego.UnregisterFixedRoute("/yourpreviouspath", "GET")
beego.Router("/yourpreviouspath", yourControllerAddress, "get:GetNewPage")

func (*App) Run 

func (app *App) Run(mws ...MiddleWare)

Run beego application.

type Config added in v1.3.0 

type Config struct {
	AppName             string //Application name
	RunMode             string //Running Mode: dev | prod
	RouterCaseSensitive bool
	ServerName          string
	RecoverPanic        bool
	RecoverFunc         func(*context.Context)
	CopyRequestBody     bool
	EnableGzip          bool
	MaxMemory           int64
	EnableErrorsShow    bool
	EnableErrorsRender  bool
	Listen              Listen
	WebConfig           WebConfig
	Log                 LogConfig
}

Config is the main struct for BConfig

type Controller 

type Controller struct {
	// context data
	Ctx  *context.Context
	Data map[interface{}]interface{}

	AppController interface{}

	// template data
	TplName        string
	ViewPath       string
	Layout         string
	LayoutSections map[string]string // the key is the section name and the value is the template name
	TplPrefix      string
	TplExt         string
	EnableRender   bool

	XSRFExpire int
	EnableXSRF bool

	// session
	CruSession session.Store
	// contains filtered or unexported fields
}

Controller defines some basic http request handler operations, such as http context, template and view, session and xsrf.

func (*Controller) Abort 

func (c *Controller) Abort(code string)

Abort stops controller handler and show the error data if code is defined in ErrorMap or code string.

func (*Controller) CheckXSRFCookie added in v1.6.0 

func (c *Controller) CheckXSRFCookie() bool

CheckXSRFCookie checks xsrf token in this request is valid or not. the token can provided in request header "X-Xsrftoken" and "X-CsrfToken" or in form field value named as "_xsrf".

func (*Controller) CustomAbort added in v1.4.0 

func (c *Controller) CustomAbort(status int, body string)

CustomAbort stops controller handler and show the error data, it's similar Aborts, but support status code and body.

func (*Controller) DelSession 

func (c *Controller) DelSession(name interface{})

DelSession removes value from session.

func (*Controller) Delete 

func (c *Controller) Delete()

Delete adds a request function to handle DELETE request.

func (*Controller) DestroySession 

func (c *Controller) DestroySession()

DestroySession cleans session data and session cookie.

func (*Controller) Finish 

func (c *Controller) Finish()

Finish runs after request function execution.

func (*Controller) Get 

func (c *Controller) Get()

Get adds a request function to handle GET request.

func (*Controller) GetBool 

func (c *Controller) GetBool(key string, def ...bool) (bool, error)

GetBool returns input value as bool or the default value while it's present and input is blank.

func (*Controller) GetControllerAndAction 

func (c *Controller) GetControllerAndAction() (string, string)

GetControllerAndAction gets the executing controller name and action name.

func (*Controller) GetFile 

func (c *Controller) GetFile(key string) (multipart.File, *multipart.FileHeader, error)

GetFile returns the file data in file upload field named as key. it returns the first one of multi-uploaded files.

func (*Controller) GetFiles added in v1.5.0 

func (c *Controller) GetFiles(key string) ([]*multipart.FileHeader, error)

GetFiles return multi-upload files files, err:=c.GetFiles("myfiles") 

if err != nil {
	http.Error(w, err.Error(), http.StatusNoContent)
	return
}

for i, _ := range files {
	//for each fileheader, get a handle to the actual file
	file, err := files[i].Open()
	defer file.Close()
	if err != nil {
		http.Error(w, err.Error(), http.StatusInternalServerError)
		return
	}
	//create destination file making sure the path is writeable.
	dst, err := os.Create("upload/" + files[i].Filename)
	defer dst.Close()
	if err != nil {
		http.Error(w, err.Error(), http.StatusInternalServerError)
		return
	}
	//copy the uploaded file to the destination file
	if _, err := io.Copy(dst, file); err != nil {
		http.Error(w, err.Error(), http.StatusInternalServerError)
		return
	}
}

func (*Controller) GetFloat 

func (c *Controller) GetFloat(key string, def ...float64) (float64, error)

GetFloat returns input value as float64 or the default value while it's present and input is blank.

func (*Controller) GetInt 

func (c *Controller) GetInt(key string, def ...int) (int, error)

GetInt returns input as an int or the default value while it's present and input is blank

func (*Controller) GetInt8 added in v1.4.2 

func (c *Controller) GetInt8(key string, def ...int8) (int8, error)

GetInt8 return input as an int8 or the default value while it's present and input is blank

func (*Controller) GetInt16 added in v1.4.2 

func (c *Controller) GetInt16(key string, def ...int16) (int16, error)

GetInt16 returns input as an int16 or the default value while it's present and input is blank

func (*Controller) GetInt32 added in v1.4.2 

func (c *Controller) GetInt32(key string, def ...int32) (int32, error)

GetInt32 returns input as an int32 or the default value while it's present and input is blank

func (*Controller) GetInt64 added in v1.4.2 

func (c *Controller) GetInt64(key string, def ...int64) (int64, error)

GetInt64 returns input value as int64 or the default value while it's present and input is blank.

func (*Controller) GetSecureCookie 

func (c *Controller) GetSecureCookie(Secret, key string) (string, bool)

GetSecureCookie returns decoded cookie value from encoded browser cookie values.

func (*Controller) GetSession 

func (c *Controller) GetSession(name interface{}) interface{}

GetSession gets value from session.

func (*Controller) GetString 

func (c *Controller) GetString(key string, def ...string) string

GetString returns the input value by key string or the default value while it's present and input is blank

func (*Controller) GetStrings 

func (c *Controller) GetStrings(key string, def ...[]string) []string

GetStrings returns the input string slice by key string or the default value while it's present and input is blank it's designed for multi-value input field such as checkbox(input[type=checkbox]), multi-selection.

func (*Controller) GetUint8 added in v1.7.2 

func (c *Controller) GetUint8(key string, def ...uint8) (uint8, error)

GetUint8 return input as an uint8 or the default value while it's present and input is blank

func (*Controller) GetUint16 added in v1.7.2 

func (c *Controller) GetUint16(key string, def ...uint16) (uint16, error)

GetUint16 returns input as an uint16 or the default value while it's present and input is blank

func (*Controller) GetUint32 added in v1.7.2 

func (c *Controller) GetUint32(key string, def ...uint32) (uint32, error)

GetUint32 returns input as an uint32 or the default value while it's present and input is blank

func (*Controller) GetUint64 added in v1.7.2 

func (c *Controller) GetUint64(key string, def ...uint64) (uint64, error)

GetUint64 returns input value as uint64 or the default value while it's present and input is blank.

func (*Controller) HandlerFunc added in v1.3.0 

func (c *Controller) HandlerFunc(fnname string) bool

HandlerFunc call function with the name

func (*Controller) Head 

func (c *Controller) Head()

Head adds a request function to handle HEAD request.

func (*Controller) Init 

func (c *Controller) Init(ctx *context.Context, controllerName, actionName string, app interface{})

Init generates default values of controller operations.

func (*Controller) Input 

func (c *Controller) Input() url.Values

Input returns the input data map from POST or PUT request body and query string.

func (*Controller) IsAjax 

func (c *Controller) IsAjax() bool

IsAjax returns this request is ajax or not.

func (*Controller) Mapping added in v1.3.0 

func (c *Controller) Mapping(method string, fn func())

Mapping the method to function

func (*Controller) Options 

func (c *Controller) Options()

Options adds a request function to handle OPTIONS request.

func (*Controller) ParseForm 

func (c *Controller) ParseForm(obj interface{}) error

ParseForm maps input data map to obj struct.

func (*Controller) Patch 

func (c *Controller) Patch()

Patch adds a request function to handle PATCH request.

func (*Controller) Post 

func (c *Controller) Post()

Post adds a request function to handle POST request.

func (*Controller) Prepare 

func (c *Controller) Prepare()

Prepare runs after Init before request function execution.

func (*Controller) Put 

func (c *Controller) Put()

Put adds a request function to handle PUT request.

func (*Controller) Redirect 

func (c *Controller) Redirect(url string, code int)

Redirect sends the redirection response to url with status code.

func (*Controller) Render 

func (c *Controller) Render() error

Render sends the response with rendered template bytes as text/html type.

func (*Controller) RenderBytes 

func (c *Controller) RenderBytes() ([]byte, error)

RenderBytes returns the bytes of rendered template string. Do not send out response.

func (*Controller) RenderString 

func (c *Controller) RenderString() (string, error)

RenderString returns the rendered template string. Do not send out response.

func (*Controller) SaveToFile 

func (c *Controller) SaveToFile(fromfile, tofile string) error

SaveToFile saves uploaded file to new path. it only operates the first one of mutil-upload form file field.

func (*Controller) ServeFormatted 

func (c *Controller) ServeFormatted()

ServeFormatted serve Xml OR Json, depending on the value of the Accept header

func (*Controller) ServeJSON added in v1.6.0 

func (c *Controller) ServeJSON(encoding ...bool)

ServeJSON sends a json response with encoding charset.

func (*Controller) ServeJSONP added in v1.6.0 

func (c *Controller) ServeJSONP()

ServeJSONP sends a jsonp response.

func (*Controller) ServeXML added in v1.6.0 

func (c *Controller) ServeXML()

ServeXML sends xml response.

func (*Controller) ServeYAML added in v1.10.0 

func (c *Controller) ServeYAML()

ServeXML sends xml response.

func (*Controller) SessionRegenerateID 

func (c *Controller) SessionRegenerateID()

SessionRegenerateID regenerates session id for this session. the session data have no changes.

func (*Controller) SetData added in v1.10.0 

func (c *Controller) SetData(data interface{})

Set the data depending on the accepted

func (*Controller) SetSecureCookie 

func (c *Controller) SetSecureCookie(Secret, name, value string, others ...interface{})

SetSecureCookie puts value into cookie after encoded the value.

func (*Controller) SetSession 

func (c *Controller) SetSession(name interface{}, value interface{})

SetSession puts value into session.

func (*Controller) StartSession 

func (c *Controller) StartSession() session.Store

StartSession starts session and load old session data info this controller.

func (*Controller) StopRun 

func (c *Controller) StopRun()

StopRun makes panic of USERSTOPRUN error and go to recover function if defined.

func (*Controller) URLFor added in v1.6.0 

func (c *Controller) URLFor(endpoint string, values ...interface{}) string

URLFor does another controller handler in this request function. it goes to this controller method if endpoint is not clear.

func (*Controller) URLMapping added in v1.3.0 

func (c *Controller) URLMapping()

URLMapping register the internal Controller router.

func (*Controller) XSRFFormHTML added in v1.6.0 

func (c *Controller) XSRFFormHTML() string

XSRFFormHTML writes an input field contains xsrf token value.

func (*Controller) XSRFToken added in v1.6.0 

func (c *