[TOC]
# 獲取參數
我們經常需要獲取用戶傳遞的數據,包括 Get、POST 等方式的請求,beego 里面會自動解析這些數據,你可以通過如下方式獲取數據:
- GetString(key string) string
- GetStrings(key string) []string
- GetInt(key string) (int64, error)
- GetBool(key string) (bool, error)
- GetFloat(key string) (float64, error)
使用例子如下:
```go
func (this *MainController) Post() {
jsoninfo := this.GetString("jsoninfo")
if jsoninfo == "" {
this.Ctx.WriteString("jsoninfo is empty")
return
}
}
```
如果你需要的數據可能是其他類型的,例如是 int 類型而不是 int64,那么你需要這樣處理:
```go
func (this *MainController) Post() {
id := this.Input().Get("id")
intid, err := strconv.Atoi(id)
}
```
更多其他的 request 的信息,用戶可以通過 `this.Ctx.Request` 獲取信息,關于該對象的屬性和方法參考手冊[Request](http://gowalker.org/net/http#Request)。
## 直接解析到 struct
如果要把表單里的內容賦值到一個 struct 里,除了用上面的方法一個一個獲取再賦值外,beego 提供了通過另外一個更便捷的方式,就是通過 struct 的字段名或 tag 與表單字段對應直接解析到 struct。
定義struct:
```go
type user struct {
Id int `form:"-"`
Name interface{} `form:"username"`
Age int `form:"age"`
Email string
}
```
表單:
<form id="user">
名字:<input name="username" type="text" />
年齡:<input name="age" type="text" />
郵箱:<input name="Email" type="text" />
<input type="submit" value="提交" />
</form>
Controller 里解析:
```go
func (this *MainController) Post() {
u := user{}
if err := this.ParseForm(&u); err != nil {
//handle error
}
}
```
注意:
* StructTag form 的定義和 [renderform方法](../view/view.md#renderform-%E4%BD%BF%E7%94%A8) 共用一個標簽
* 定義 struct 時,字段名后如果有 form 這個 tag,則會以把 form 表單里的 name 和 tag 的名稱一樣的字段賦值給這個字段,否則就會把 form 表單里與字段名一樣的表單內容賦值給這個字段。如上面例子中,會把表單中的 username 和 age 分別賦值給 user 里的 Name 和 Age 字段,而 Email 里的內容則會賦給 Email 這個字段。
* 調用 Controller ParseForm 這個方法的時候,傳入的參數必須為一個 struct 的指針,否則對 struct 的賦值不會成功并返回 `xx must be a struct pointer` 的錯誤。
* 如果要忽略一個字段,有兩種辦法,一是:字段名小寫開頭,二是:`form` 標簽的值設置為 `-`
## 獲取 Request Body 里的內容
在 API 的開發中,我們經常會用到 `JSON` 或 `XML` 來作為數據交互的格式,如何在 beego 中獲取 Request Body 里的 JSON 或 XML 的數據呢?
1. 在配置文件里設置 `copyrequestbody = true`
2. 在 Controller 中
```go
func (this *ObjectController) Post() {
var ob models.Object
json.Unmarshal(this.Ctx.Input.RequestBody, &ob)
objectid := models.AddOne(ob)
this.Data["json"] = "{\"ObjectId\":\"" + objectid + "\"}"
this.ServeJson()
}
```
## 文件上傳
在 beego 中你可以很容易的處理文件上傳,就是別忘記在你的 form 表單中增加這個屬性 `enctype="multipart/form-data"`,否則你的瀏覽器不會傳輸你的上傳文件。
文件上傳之后一般是放在系統的內存里面,如果文件的 size 大于設置的緩存內存大小,那么就放在臨時文件中,默認的緩存內存是 64M,你可以通過如下來調整這個緩存內存大小:
beego.MaxMemory = 1<<22
或者在配置文件中通過如下設置:
maxmemory = 1<<22
Beego 提供了兩個很方便的方法來處理文件上傳:
- GetFile(key string) (multipart.File, *multipart.FileHeader, error)
該方法主要用于用戶讀取表單中的文件名 `the_file`,然后返回相應的信息,用戶根據這些變量來處理文件上傳:過濾、保存文件等。
- SaveToFile(fromfile, tofile string) error
該方法是在 GetFile 的基礎上實現了快速保存的功能
fromfile 是提交時候的html表單中的name
```html
<form enctype="multipart/form-data" method="post">
<input type="file" name="uploadname" />
<input type="submit">
</form>
```
保存的代碼例子如下:
```go
func (c *FormController) Post() {
f, h, err := c.GetFile("uploadname")
defer f.Close()
if err != nil {
fmt.Println("getfile err ", err)
} else {
c.SaveToFile("uploadname", "/www/"+h.Filename)
}
}
```
## 數據綁定
支持從用戶請求中直接數據bind到指定的對象,例如請求地址如下
?id=123&isok=true&ft=1.2&ol[0]=1&ol[1]=2&ul[]=str&ul[]=array&user.Name=astaxie
```
var id int
ctx.Input.Bind(&id, "id") //id ==123
var isok bool
ctx.Input.Bind(&isok, "isok") //isok ==true
var ft float64
ctx.Input.Bind(&ft, "ft") //ft ==1.2
ol := make([]int, 0, 2)
ctx.Input.Bind(&ol, "ol") //ol ==[1 2]
ul := make([]string, 0, 2)
ctx.Input.Bind(&ul, "ul") //ul ==[str array]
user struct{Name}
ctx.Input.Bind(&user, "user") //user =={Name:"astaxie"}
```
- 寫在前面的話
- 第0章 beego 簡介
- 0.1 為beego貢獻
- 0.2 發布版本
- 0.3 升級指南
- 第1章 安裝升級
- 1.1 bee工具的使用
- 第2章 快速入門
- 2.1 新建項目
- 2.2 路由設置
- 2.3 Controller運行機制
- 2.4 Model邏輯
- 2.5 View編寫
- 2.6 靜態文件處理
- 第3章 beego的MVC架構
- 3.1 Model設計
- 3.1.1 概述
- 3.1.2 ORM使用
- 3.1.3 CRUD操作
- 3.1.4 高級查詢
- 3.1.5 原生SQL查詢
- 3.1.6 構造查詢
- 3.1.7 事物處理
- 3.1.8 模型定義
- 3.1.9 命令模式
- 3.1.10 測試用例
- 3.1.11 自定義字段
- 3.1.12 FAQ
- 3.2 View設計
- 3.2.1 模板語法指南
- 3.2.2 模板處理
- 3.2.3 模板函數
- 3.2.4 靜態文件處理
- 3.2.5 模板分頁處理
- 3.3 Controller設計
- 3.3.1 參數配置
- 3.3.2 路由設置
- 3.3.3 控制器函數
- 3.3.4 XSRF過濾
- 3.3.5 請求數據處理
- 3.3.6 session 控制
- 3.3.7 過濾器
- 3.3.8 flash 數據
- 3.3.9 URL構建
- 3.3.10 多種格式數據輸出
- 3.3.11 表單數據驗證
- 3.3.12 錯誤處理
- 3.3.13 日志處理
- 第4章 beego的模塊設計
- 4.1 session 模塊
- 4.2 grace 模塊
- 4.3 cache 模塊
- 4.4 logs 模塊
- 4.5 httplib 模塊
- 4.6 context 模塊
- 4.7 toolbox 模塊
- 4.8 config 模塊
- 4.9 i18n 模塊
- 第5章 beego高級編程
- 5.1 進程內監控
- 5.2 API自動化文檔
- 第6章 應用部署
- 6.1 獨立部署
- 6.2 Supervisor部署
- 6.3 Nginx 部署
- 6.4 Apache 部署
- 第7章 第三方庫
- 第8章 應用例子
- 8.1 在線聊天室
- 8.2 短域名服務
- 8.3 Todo列表
- 第9章 FAQ