Go语言之高级篇beego框架之config、httplib、context

一、httplib

1、配置文件解析

这是一个用来解析文件的库，它的设计思路来自于 database/sql，目前支持解析的文件格式有 ini、json、xml、yaml，可以通过如下方式进行安装：

go get github.com/astaxie/beego/config

如果你使用xml 或者 yaml 驱动就需要手工安装引入包

go get -u github.com/astaxie/beego/config/xml

2、始何使用

首先初始化一个解析器对象

iniconf, err := NewConfig("ini", "testini.conf")

if err != nil {

    t.Fatal(err)

}

然后通过对象获取数据

iniconf.String("appname")

解析器对象支持的函数有如下：

Set(key, val string) error
String(key string) string
Int(key string) (int, error)
Int64(key string) (int64, error)
Bool(key string) (bool, error)
Float(key string) (float64, error)
DIY(key string) (interface{}, error)

ini 配置文件支持 section 操作，key通过 section::key 的方式获取

例如下面这样的配置文件

[demo]

key1 = "asta"

key2 = "xie"

那么可以通过 iniconf.String("demo::key2") 获取值.

如何获取环境变量

config 模块支持环境变量配置，对应配置项 Key 格式为 ${环境变量名} ，则 Value = os.Getenv(‘环境变量名’)。
同时可配置默认值，当环境变量无此配置或者环境变量值为空时，则优先使用默认值。包含默认值的 Key 格式为 ${GOPATH||/home/workspace/go/} ，使用||分割环境变量和默认值。

注意获取环境变量值仅仅是在配置文件解析时处理，而不会在调用函数获取配置项时实时处理。

示例：

controllers/testHttpLib.go

package controllers

import (

	"github.com/astaxie/beego"

	"github.com/astaxie/beego/httplib"

)

type TestHttpLibController struct {

	beego.Controller

}

func (c *TestHttpLibController) Get() {

	req := httplib.Get("http://www.baidu.com")

	str, err := req.String()

	if err != nil {

		panic(err)

	}

	//获取网站源代码

	//c.Ctx.WriteString("start")

	//直接打开网站

	c.Ctx.WriteString(str)

}

routers/router.go

package routers

import (

	"web/controllers"

	"github.com/astaxie/beego"

)

func init() {

	beego.Router("/", &controllers.MainController{})

	beego.Router("/test_httplib", &controllers.TestHttpLibController{}, "get:Get;post:Post")

}

执行结果：直接打开网站

二、context

1、上下文模块

上下文模块主要是针对 HTTP 请求中，request 和 response 的进一步封装，他包括用户的输入和输出，用户的输入即为 request，context 模块中提供了 Input 对象进行解析，用户的输出即为 response，context 模块中提供了 Output 对象进行输出。

2、context对象

context 对象是对 Input 和 Output 的封装，里面封装了几个方法：

Redirect
Abort
WriteString
GetCookie
SetCookie

context 对象是 Filter 函数的参数对象，这样你就可以通过 filter 来修改相应的数据，或者提前结束整个的执行过程。

Output 对象

Output 是针对 Response 的封装，里面提供了很多方便的方法：

Header

设置输出的 header 信息，例如 Header("Server","beego")
Body

设置输出的内容信息，例如 Body([]byte("astaxie"))
Cookie

设置输出的 cookie 信息，例如 Cookie("sessionID","beegoSessionID")
Json

把 Data 格式化为 Json，然后调用 Body 输出数据
Jsonp

把 Data 格式化为 Jsonp，然后调用 Body 输出数据
Xml

把 Data 格式化为 Xml，然后调用 Body 输出数据
Download

把 file 路径传递进来，然后输出文件给用户
ContentType

设置输出的 ContentType
SetStatus

设置输出的 status
Session

设置在服务器端保存的值，例如 Session("username","astaxie")，这样用户就可以在下次使用的时候读取
IsCachable

根据 status 判断，是否为缓存类的状态
IsEmpty

根据 status 判断，是否为输出内容为空的状态
IsOk

根据 status 判断，是否为 200 的状态
IsSuccessful

根据 status 判断，是否为正常的状态
IsRedirect

根据 status 判断，是否为跳转类的状态
IsForbidden

根据 status 判断，是否为禁用类的状态
IsNotFound

根据 status 判断，是否为找不到资源类的状态
IsClientError

根据 status 判断，是否为请求客户端错误的状态
IsServerError

根据 status 判断，是否为服务器端错误的状态

获取IP地址和端口

示例：

controllers/testContext.go

package controllers

import (

	"strconv"

	"github.com/astaxie/beego"

)

type TestContextController struct {

	beego.Controller

}

func (c *TestContextController) Get() {

	c.Ctx.WriteString(c.Ctx.Input.IP() + ":" + strconv.Itoa(c.Ctx.Input.Port()))

}

routers/router.go

package routers

import (

	"web/controllers"

	"github.com/astaxie/beego"

)

func init() {

	beego.Router("/", &controllers.MainController{})

	beego.Router("/test_context", &controllers.TestContextController{}, "get:Get;post:Post")

}

执行结果：

http://127.0.0.1:8080/test_context

返回结果：

127.0.0.1:8080

Input 对象

Input 对象是针对 request 的封装，里面通过 reqeust 实现很多方便的方法，具体如下：

Protocol

获取用户请求的协议，例如 HTTP/1.0

Uri

用户请求的 RequestURI，例如 /hi?id=1001

Url

请求的 URL 地址，例如 /hi

Site

请求的站点地址,scheme+doamin 的组合，例如 http://beego.me

Scheme

请求的 scheme，例如 “http” 或者 “https”

Domain

请求的域名，例如 beego.me

Host

请求的域名，和 domain 一样

Method

请求的方法，标准的 HTTP 请求方法，例如 GET、POST 等

Is

判断是否是某一个方法，例如 Is("GET") 返回 true

IsAjax

判断是否是 AJAX 请求，如果是返回 true，不是返回 false

IsSecure

判断当前请求是否 HTTPS 请求，是返回 true，否返回 false

IsWebsocket

判断当前请求是否 Websocket 请求，如果是返回 true，否返回 false

IsUpload

判断当前请求是否有文件上传，有返回 true，否返回 false

IP

返回请求用户的 IP，如果用户通过代理，一层一层剥离获取真实的 IP

Proxy

返回用户代理请求的所有 IP

Refer

返回请求的 refer 信息

SubDomains

返回请求域名的根域名，例如请求是 blog.beego.me，那么调用该函数返回 beego.me

Port

返回请求的端口，例如返回 8080

UserAgent

返回请求的 UserAgent，例如 Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.57 Safari/537.36

Param

在路由设置的时候可以设置参数，这个是用来获取那些参数的，例如 Param(":id"),返回12

Query

该函数返回 Get 请求和 Post 请求中的所有数据，和 PHP 中 $_REQUEST 类似

Header

返回相应的 header 信息，例如 Header("Accept-Language")，就返回请求头中对应的信息 zh-CN,zh;q=0.8,en;q=0.6

Cookie

返回请求中的 cookie 数据，例如 Cookie("username")，就可以获取请求头中携带的 cookie 信息中 username 对应的值

Session

session 是用户可以初始化的信息，默认采用了 beego 的 session 模块中的 Session 对象，用来获取存储在服务器端中的数据。

Body

返回请求 Body 中数据，例如 API 应用中，很多用户直接发送 json 数据包，那么通过 Query 这种函数无法获取数据，就必须通过该函数获取数据。该函数已经 beego 1.5 版本之后删除，目前可以通过 RequestBody 获取数据。

GetData

用来获取 Input 中 Data 中的数据

SetData

用来设置 Input 中 Data 的值，上面 GetData 和这个函数都是用来方便用户在 Filter 中传递数据到 Controller 中来执行

Query方法

示例：

controllers/testContext.go

package controllers

import (

	"strconv"

	"github.com/astaxie/beego"

)

type TestContextController struct {

	beego.Controller

}

func (c *TestContextController) Get() {

	c.Ctx.WriteString(c.Ctx.Input.IP() + ":" + strconv.Itoa(c.Ctx.Input.Port()))

	//Query方法

	c.Ctx.WriteString(c.Ctx.Input.Query("name")) //等价于php中的 $_REQUEST["name"]

}

routers/router.go

package routers

import (

	"web/controllers"

	"github.com/astaxie/beego"

)

func init() {

	beego.Router("/", &controllers.MainController{})

	beego.Router("/test_context", &controllers.TestContextController{}, "get:Get;post:Post")

}

执行结果：

http://127.0.0.1:8080/test_context?name=nulige

返回结果：

127.0.0.1:8080nulige

另外一种方法：

示例：

controllers/testContext.go

package controllers

import (

	"strconv"

	"github.com/astaxie/beego"

)

type TestContextController struct {

	beego.Controller

}

func (c *TestContextController) Get() {

	c.Ctx.WriteString(c.Ctx.Input.IP() + ":" + strconv.Itoa(c.Ctx.Input.Port()))

	//Query方法

	c.Ctx.WriteString(c.Ctx.Input.Query("name")) //等价于php中的 $_REQUEST["name"]

	m := make(map[string]float64)

	m["zhangsan"] = 98.7

	c.Ctx.Output.JSON(m, false, false)

}

routers/router.go

package routers

import (

	"web/controllers"

	"github.com/astaxie/beego"

)

func init() {

	beego.Router("/", &controllers.MainController{})

	beego.Router("/test_context", &controllers.TestContextController{}, "get:Get;post:Post")

}

执行结果：

http://127.0.0.1:8080/test_context

返回结果：

127.0.0.1:8080{"zhangsan":98.7}