Beego 架構學習(一)

Beego官網本身已經整理的非常詳細了，但是作為一個學習者，我還是決定自己好好整理一下，這樣在後面使用的時候自己對每部分才能非常熟悉，即使忘記了，也可以迅速定位自己要用的知識在哪裡。當然也是對官網的一個精簡整理，同時結合一些例子，更好的了解和學習Beego

Beego官網位址：https://beego.me

這次整理也是一個初步的整理，正好在這個之後把之前通過net/http實作的短url項目通過beego架構實作一遍

Beego的安裝

go get github.com/astaxie/beego

bee 工具是一個為了協助快速開發 beego 項目而建立的項目，通過 bee 您可以很容易的進行 beego 項目的建立、熱編譯、開發、測試、和部署。

go get github.com/beego/bee

當我們安裝好bee之後，bee指令預設是放在GOPATH/bin裡面，是以需要把GOPATH/bin裡面，是以需要把GOPATH/bin 添加到您的環境變量中

bee常用的指令

bee new <項目名> ：建立一個項目,這樣的項目一般是web項目

需要注意的是這個指令須在 $GOPATH/src 下執行，最後生成的目錄結構為：

├── conf
│   └── app.conf
├── controllers
│   └── default.go
├── main.go
├── models
├── routers
│   └── router.go
├── static
│   ├── css
│   ├── img
│   └── js
│       └── reload.min.js
├── tests
│   └── default_test.go
└── views
    └── index.tpl

bee api myapi : 建立一個api項目，生成的目錄結構為

├── conf
│   └── app.conf
├── controllers
│   ├── object.go
│   └── user.go
├── main.go
├── models
│   ├── object.go
│   └── user.go
├── routers
│   └── router.go
└── tests
    └── default_test.go

bee run 指令是監控 beego 的項目，通過 fsnotify監控檔案系統。但是注意該指令必須在 $GOPATH/src/appname 下執行。這樣當我們在開發過程中，beego可以實時監測我們的代碼檔案發生變化，這樣我們就不用重新編譯運作，非常友善我們調試，我們可以将上面的myweb2項目通過bee run運作起來

localhost:myweb2 zhaofan$ go run
go run: no go files listed
localhost:myweb2 zhaofan$ bee run
______
| ___ \
| |_/ /  ___   ___
| ___ \ / _ \ / _ \
| |_/ /|  __/|  __/
\____/  \___| \___| v1.9.1
2018/03/19 23:59:20 INFO     ▶ 0001 Using 'myweb2' as 'appname'
2018/03/19 23:59:20 INFO     ▶ 0002 Initializing watcher...
myweb2/controllers
myweb2/routers
myweb2
2018/03/19 23:59:22 SUCCESS  ▶ 0003 Built Successfully!
2018/03/19 23:59:22 INFO     ▶ 0004 Restarting 'myweb2'...
2018/03/19 23:59:22 SUCCESS  ▶ 0005 './myweb2' is running...
2018/03/19 23:59:22.572 [I] [asm_amd64.s:2337] http server Running on http://:8080

我們通過打開浏覽器通路：http://127.0.0.1:8080,可以看到如圖：

Beego 架構了解

Beego架構圖如：

這就是Beegode 八大獨立的子產品

Beego的執行邏輯，beego 是一個典型的 MVC 架構

我們從上面myweb2的目錄接口也可以看出來：

M（models 目錄）、V（views 目錄）和 C（controllers 目錄）的結構

Beego路由設定

我們看一下Beego的入口函數：

package main

import (
    _ "myweb2/routers"
    "github.com/astaxie/beego"
)

func main() {
    beego.Run()
}

引入了一個包 _ "myweb2/routers 我們看一下這個包的内容

package routers

import (
    "myweb2/controllers"
    "github.com/astaxie/beego"
)

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

這裡僅僅做了一個初始化，路由包裡面我們看到執行了路由注冊 beego.Router, 這個函數的功能是映射 URL 到 controller，第一個參數是 URL (使用者請求的位址)，這裡我們注冊的是 /，也就是我們通路的不帶任何參數的 URL，第二個參數是對應的 Controller，也就是我們即将把請求分發到那個控制器來執行相應的邏輯。這裡對路由設定的一個小結：

Router方法設定url和處理url的controller
程式啟動時，路由配置加載好，儲存在map中
請求處理時，通過請求的url進行查找對應的controller,把處理路由到controller進行執行
我們就隻需要編寫自己的controller就好啦

我們看一下controller的代碼：

package controllers

import (
    "github.com/astaxie/beego"
)

type MainController struct {
    beego.Controller  // 這裡可以看做是其他語言中的繼承
}

func (c *MainController) Get() {
    c.Data["Website"] = "beego.me"
    c.Data["Email"] = "[email protected]"
    c.TplName = "index.tpl"
}

對上述代碼進行簡單分析：

使用者的controller嵌套bee.Controller，繼承bee.Controller所有屬性和
方法
Controller預設使用restful的風格，Get請求對應Get方法
請求處理時，通過請求的url進行查找對應的controller，把處理路由到 controller進行執行
通過業務邏輯處理之後，把資料指派給Controller.Data這個map即可

上述代碼中：c.TplName = "index.tpl"預設回去views下面去找模闆檔案

除了上面的C.Data這種方法之外，還有很多方法，如常用的c.ServerJson()這樣就會去c.Data中尋找key為json的值

使用者設定了模闆之後系統會自動的調用 Render 函數（這個函數是在 beego.Controller 中實作的），是以無需使用者自己來調用渲染。

當然也可以不使用模版，直接用 this.Ctx.WriteString 輸出字元串，如：

func (c *MainController) Get() {
        c.Ctx.WriteString("hello")
}

正則路由

beego.Router(“/api/?:id”, &controllers.RController{}) 預設比對 //比對 /api/123 :id = 123 可以比對 /api/ 這個URL

beego.Router(“/api/:id”, &controllers.RController{}) 預設比對 //比對 /api/123 :id = 123 不可以比對 /api/ 這個URL

beego.Router(“/api/:id([0-9]+)“, &controllers.RController{}) 自定義正則比對 //比對 /api/123 :id = 123

beego.Router(“/user/:username([\w]+)“, &controllers.RController{}) 正則字元串比對 //比對 /user/astaxie :username = astaxie

beego.Router(“/download/*.*”, &controllers.RController{}) *比對方式 //比對 /download/file/api.xml :path= file/api :ext=xml

beego.Router(“/download/ceshi/*“, &controllers.RController{}) *全比對方式 //比對 /download/ceshi/file/api.json :splat=file/api.json

beego.Router(“/:id:int”, &controllers.RController{}) int 類型設定方式，比對 :id為int 類型，架構幫你實作了正則 ([0-9]+)

beego.Router(“/:hi:string”, &controllers.RController{}) string 類型設定方式，比對 :hi 為 string 類型。架構幫你實作了正則 ([\w]+)

beego.Router(“/cms_:id([0-9]+).html”, &controllers.CmsController{}) 帶有字首的自定義正則 //比對 :id 為正則類型。比對 cms_123.html 這樣的 url :id = 123

可以在 Controller 中通過如下方式擷取上面的變量：

this.Ctx.Input.Param(":id")

this.Ctx.Input.Param(":username")

this.Ctx.Input.Param(":splat")

this.Ctx.Input.Param(":path")

this.Ctx.Input.Param(":ext")

自定義方法及 RESTful 規則:

beego.Router("/",&IndexController{},"*:Index")

使用第三個參數，第三個參數就是用來設定對應 method 到函數名，定義如下

*表示任意的 method 都執行該函數
使用 httpmethod:funcname 格式來展示
多個不同的格式使用 ; 分割
多個 method 對應同一個 funcname，method 之間通過 , 來分割

beego.Router("/api",&RestController{},"get,post:ApiFunc")

可用的 HTTP Method：

*: 包含以下所有的函數
get: GET 請求
post: POST 請求
put: PUT 請求
delete: DELETE 請求
patch: PATCH 請求
options: OPTIONS 請求
head: HEAD 請求

如果同時存在 * 和對應的 HTTP Method，那麼優先執行 HTTP Method 的方法

Beego的model

我們知道 Web 應用中我們用的最多的就是資料庫操作，而 model 層一般用來做這些操作，我們的 bee new 例子不存在 Model 的示範，但是 bee api 應用中存在 model 的應用。說的簡單一點，如果您的應用足夠簡單，那麼 Controller 可以處理一切的邏輯，如果您的邏輯裡面存在着可以複用的東西，那麼就抽取出來變成一個子產品。是以 Model 就是逐漸抽象的過程，

Beego的views層

Beego模闆預設支援:.tpl和.html兩種字尾
beego.AddTemplateExt增加新的模闆字尾
Beego模闆用的就是Go官網自帶的模闆

靜态檔案

beego 預設注冊了 static 目錄為靜态處理的目錄，注冊樣式：URL 字首和映射的目錄（在/main.go檔案中beego.Run()之前加入）：StaticDir["/static"] = "static"

Beego預設使用static目錄作為靜态檔案目錄

beego.SetStaticPath增加新的靜态檔案目錄

配置檔案讀取

預設的配置檔案内容：

appname = myweb2
httpport = 8080
runmode = dev

當然前提是你已經在自己配置檔案中添加了下面這些字段：

beego.AppConfig.String("mysql_user")

beego.AppConfig.String("mysql_pwd")

如果我們将配置檔案更改為：

appname = myweb2
httpport = 8080
runmode = dev

[dbconfig]
mysqlhost = 127.0.0.1
mysqlport = 3308
username = root
passwd = 123

我們可以通過[命名]的方式将配置檔案進行分組

這樣當我們擷取變量的時候，可以通過下面方式擷取：

beego.AppConfig.String("dbconfig::mysql_user")

beego.AppConfig.String("dbconfig::mysql_port")

AppConfig 的方法如下：

Set(key, val string) error
String(key string) string
Strings(key string) []string
Int(key string) (int, error)
Int64(key string) (int64, error)
Bool(key string) (bool, error)
Float(key string) (float64, error)
DefaultString(key string, defaultVal string) string
DefaultStrings(key string, defaultVal []string)
DefaultInt(key string, defaultVal int) int
DefaultInt64(key string, defaultVal int64) int64
DefaultBool(key string, defaultVal bool) bool
DefaultFloat(key string, defaultVal float64) float64
DIY(key string) (interface{}, error)
GetSection(section string) (map[string]string, error)
SaveConfigFile(filename string) error

擷取使用者送出的參數

Controller中的方法擷取

GetString(key string) string
GetStrings(key string) []string
GetInt(key string) (int64, error)
GetBool(key string) (bool, error)
GetFloat(key string) (float64, error)

不管是post還是get的其他方式送出的資料都可以通過上面的方式擷取

如果在平常開發中肯定設計到和其他語言的對接資料，這個時候對方發過來的資料可能就是一個json格式的資料，如果想要擷取可以通過下面方法：

直接通過Ctx.Input.RequestBody擷取原始的資料
配置檔案裡設定 copyrequestbody = true

這樣就可以通過c.Ctx.Input.RequestBody 擷取

所有的努力都值得期許，每一份夢想都應該灌溉！

Beego 架構學習(一)

Beego的安裝

Beego 架構了解

Beego路由設定

Beego的model

Beego的views層

靜态檔案

配置檔案讀取

擷取使用者送出的參數

繼續閱讀

Go基礎--終端操作和檔案操作

Go基礎--goroutine和channel

Go基礎之--結構體和方法

Go基礎之--位操作中你所不知道的用法

Go基礎之--數組和切片

go基礎之--函數和map

Go 從入門到精通（三）字元串，時間，流程控制，函數

讓你成功安裝vscode中go的相關插件

初學者沒有搞明白的GOROOT,GOPATH,GOBIN,project目錄

Go從入門到精通（一）go語言初識

go 從入門到精通（二）基本資料類型和操作符

Golang之使用mgo連接配接MongoDB

Go之[]byte位元組數組與string字元串互相轉換Go位元組數組與字元串互相轉換

Go語言基礎：并發

Go語言基礎：if，goto，for，switch

Go安裝之linux下如何配置Go語言環境變量？1. 登入root 使用者，修改配置2. 修改内容3. 生效配置，并測試是否可用