用戶(hù)注冊(cè)、登錄和注銷(xiāo)是任何一個(gè)網(wǎng)站都必然會(huì)有的功能，可以說(shuō)，這是重新造輪子做多的領(lǐng)域，每個(gè)做網(wǎng)站的人應(yīng)該都做過(guò)很多遍。見(jiàn)微知著，從這么一個(gè)小功能其實(shí)就可以看到所使用的web框架中的大部分東西。

今天就讓我們用這個(gè)基本模塊來(lái)看看revel吧。

先整理一下我們選用的技術(shù)框架和組件：

web框架：revel

數(shù)據(jù)庫(kù)：mongodb

數(shù)據(jù)庫(kù)driver：mgo

工欲善其事，必先利其器，這里著重推薦一個(gè)mongodb的GUI客戶(hù)端 – mongovue，可以說(shuō)，如果沒(méi)有這個(gè)工具，在開(kāi)發(fā)的過(guò)程中我們會(huì)痛苦許多許多。

這里假設(shè)你已經(jīng)有了對(duì)Go語(yǔ)言最基本的知識(shí)，已經(jīng)配置好GOROOT和GOPATH。

首先，在GOPATH下面運(yùn)行下面的命令安裝revel，并且把revel的工具編譯出來(lái)。

go get github.com/robfig/revel go build –o bin/revel.exe github.com/robfig/revel/revel

完成之后去GOPATHbin下面看看是否已經(jīng)編譯出來(lái)了revel.exe。為了方便使用，我把GOPATHbin添加到了環(huán)境變量PATH中。

到你希望存放工程文件的地方運(yùn)行

revel new myapp

整個(gè)工程的框架就建立好了，看下面的文件夾結(jié)構(gòu)就可以看出，revel是一個(gè)MVC框架。

此時(shí)整個(gè)工程就可以運(yùn)行了，運(yùn)行下面的命令行啟動(dòng)站點(diǎn)。

revel run myapp

打開(kāi)瀏覽器 http://127.0.0.1:9000，就可以看到下面的結(jié)果

內(nèi)部的細(xì)節(jié)暫時(shí)不多說(shuō)，來(lái)吧，先讓用戶(hù)可以注冊(cè)。注意，在整個(gè)開(kāi)發(fā)過(guò)程中大部分時(shí)候不需要重新啟動(dòng)revel。

1、準(zhǔn)備Model

按照MVC的開(kāi)發(fā)節(jié)奏，我們先準(zhǔn)備model。在app目錄下新建一個(gè)models目錄，然后在里面新建entity.go（這個(gè)文件的命名大家可自便），打開(kāi)entity.go加入U(xiǎn)ser的實(shí)體定義。

type User struct {   Email    string   Nickname string   Password []byte } type MockUser struct {   Email           string   Nickname        string   Password        string   ConfirmPassword string }

內(nèi)部的細(xì)節(jié)暫時(shí)不多說(shuō)，來(lái)吧，先讓用戶(hù)可以注冊(cè)。注意，在整個(gè)開(kāi)發(fā)過(guò)程中大部分時(shí)候不需要重新啟動(dòng)revel。

1、準(zhǔn)備Model

按照MVC的開(kāi)發(fā)節(jié)奏，我們先準(zhǔn)備model。在app目錄下新建一個(gè)models目錄，然后在里面新建entity.go（這個(gè)文件的命名大家可自便），打開(kāi)entity.go加入U(xiǎn)ser的實(shí)體定義。

type User struct {   Email    string   Nickname string   Password []byte } type MockUser struct {   Email           string   Nickname        string   Password        string   ConfirmPassword string }

為什么定義MockUser呢？原因后面會(huì)提到。

現(xiàn)在寫(xiě)dal（數(shù)據(jù)訪問(wèn)層），在appmodels目錄下新建dal.go。dal的寫(xiě)法其實(shí)可以用revel的插件機(jī)制，這里為了避免一下子引入太多概念，先用這種簡(jiǎn)單的方式。

package models import (   "github.com/robfig/revel"   "labix.org/v2/mgo" ) const (   DbName                         = "myapp"   UserCollection                 = "user" ) type Dal struct {   session *mgo.Session } func NewDal() (*Dal, error) {   revel.Config.SetSection("db")   ip, found := revel.Config.String("ip")   if !found {     revel.ERROR.Fatal("Cannot load database ip from app.conf")   }   session, err := mgo.Dial(ip)   if err != nil {     return nil, err   }   return &Dal{session}, nil } func (d *Dal) Close() {   d.session.Close() }

revel已經(jīng)提供了配置系統(tǒng)，打開(kāi)confapp.conf，添加下面內(nèi)容

[db] ip = 127.0.0.1

現(xiàn)在實(shí)現(xiàn)注冊(cè)需要用到的方法，在appmodels目錄下添加文件dal_account.go，代碼如下。

func (d *Dal) RegisterUser(mu *MockUser) error {   uc := d.session.DB(DbName).C(UserCollection)   //先檢查email和nickname是否已經(jīng)被使用   i, _ := uc.Find(M{"nickname": mu.Nickname}).Count()   if i != 0 {     return errors.New("用戶(hù)昵稱(chēng)已經(jīng)被使用")   }   i, _ = uc.Find(M{"email": mu.Email}).Count()   if i != 0 {     return errors.New("郵件地址已經(jīng)被使用")   }   var u User   u.Email = mu.Email   u.Nickname = mu.Nickname   u.Password, _ = bcrypt.GenerateFromPassword([]byte(mu.Password), bcrypt.DefaultCost)   err := uc.Insert(u)   return err }

看出來(lái)MockUser存在的意義了嗎？用戶(hù)在頁(yè)面上填寫(xiě)的是明文的密碼，這可不能直接存入數(shù)據(jù)庫(kù)，需要先加密，這里用到了"code.google.com/p/go.crypto/bcrypt"這個(gè)庫(kù)。

2、準(zhǔn)備Controller

準(zhǔn)備controller，在appcontrollers新建一個(gè)文件account.go，在里面實(shí)現(xiàn)Account控制器，代碼如下。

package controllers import (   "github.com/robfig/revel"   "myapp/app/models" ) type Account struct {   *revel.Controller } func (c *Account) Register() revel.Result {   return c.Render() } func (c *Account) PostRegister(user *models.MockUser) revel.Result {   return c.Render() }

3、添加Route

準(zhǔn)備route，打開(kāi)confroutes，添加Register的URL映射。

# Routes # This file defines all application routes (Higher priority routes first) # ~~~~ module:testrunner GET     /                                          App.Index GET     /register                                Account.Register POST   /register                                Account.PostRegister # Ignore favicon requests GET     /favicon.ico                           404 # Map static resources from the /app/public folder to the /public path GET     /public/*filepath                     Static.Serve("public") # Catch all *       /:controller/:action                   :controller.:action

假定大家都知道Restful是啥意思，這里就是把兩個(gè)url映射到了Controller的兩個(gè)Action。

可以看到，這里定義了所有的URL到Controller之間的映射，很方便。這個(gè)文件在運(yùn)行前會(huì)被revel轉(zhuǎn)換成approutesroutes.go文件參與編譯。后面在講到ReverseRedirect的時(shí)候需要用到這個(gè)文件里的內(nèi)容。

4、準(zhǔn)備View

準(zhǔn)備view，在appviews下面新建文件Register.html，關(guān)鍵內(nèi)容如下

<form action="{{url "Account.PostRegister"}}" method="POST">     {{with $field := field "user.Email" .}}     <div class="control-group {{$field.ErrorClass}}">       <label class="control-label" for="{{$field.Id}}">電子郵件</label>       <div class="controls">         <input type="email" id="{{$field.Id}}" name="{{$field.Name}}" value="{{$field.Flash}}" required>         {{if $field.Error}}         <span class="help-inline">{{$field.Error}}</span>         {{end}}       </div>     </div>     {{end}}     …

一點(diǎn)一點(diǎn)解釋一下上面藍(lán)色部分關(guān)鍵字的含義。

url是revel提供的一個(gè)template function，可以很方便的把Controller的Action變成與之相對(duì)的url，它的運(yùn)作原理實(shí)際上就是去剛才定義好的routes映射里面查找。

field是revel提供的一個(gè)template function，專(zhuān)門(mén)方便生成form，還記得PostRegister方法的簽名嗎？

func (c *Account) PostRegister(user *models.MockUser) revel.Result

它接受一個(gè)名為user的*models.User類(lèi)型的參數(shù)，所以，使用{{with $field := field “user.Email”}}就可以通知revel將form的參數(shù)封裝到user結(jié)構(gòu)中再傳遞給PostRegister。

我們都知道用戶(hù)注冊(cè)的時(shí)候填寫(xiě)的值是需要做有效性檢驗(yàn)的，當(dāng)用戶(hù)填寫(xiě)的值不符合標(biāo)準(zhǔn)時(shí)需要出現(xiàn)錯(cuò)誤提示，通常來(lái)說(shuō)會(huì)是下面這樣

$field.ErrorClass的作用就是當(dāng)這個(gè)參數(shù)出現(xiàn)錯(cuò)誤的時(shí)候可以方便的通過(guò)添加class的方式在頁(yè)面上顯示錯(cuò)誤狀態(tài)。ErrorClass的值可以通過(guò)下面的代碼修改。

revel.ERROR_CLASS = "error"

$field.Id和$field.Name就不解釋了，大家待會(huì)兒打開(kāi)瀏覽器中看看生成的源代碼就明白了。

$field.Flash這里就需要解釋一下Flash的概念了。

Flash是一個(gè)字典，適用于在兩個(gè)Request中間傳遞數(shù)據(jù)，數(shù)據(jù)存儲(chǔ)在cookie中。

大家都知道，HTTP協(xié)議本身是無(wú)狀態(tài)的，所以，考慮一下這個(gè)用例，用戶(hù)在注冊(cè)的時(shí)候輸入了一個(gè)無(wú)效的email地址，點(diǎn)擊注冊(cè)之后頁(yè)面刷新了一下，“電子郵件”下面出現(xiàn)一行紅字“你輸入的Email地址無(wú)效”，此刻文本框里面需要出現(xiàn)上次用戶(hù)輸入的值。那么，$field.Flash就是在Flash里去找以$field.Name為Key的值。

$field.Error就是在Flash里找以$field.Name_error為Key的值，也就是上圖中紅色的“密碼必須大于等于6位”這個(gè)錯(cuò)誤信息。

好了，現(xiàn)在大家就按照這個(gè)節(jié)奏在view中添加“昵稱(chēng)”，“密碼”和“確認(rèn)密碼”吧。

添加完成之后就去訪問(wèn)http://127.0.0.1/register看看吧。是不是這樣呢？

revel會(huì)通過(guò)Controller.Action的名稱(chēng)去查找同名的view文件，例如，Register方法對(duì)應(yīng)的就是Register.html。這里需要注意的一點(diǎn)是，revel是通過(guò)反射去查找Controller.Render方法的調(diào)用者，而且只向上查找一層。

例如，下面這段代碼是不能工作的。

func (c *Account) someMethod() revel.Result {   ...   return c.Render() } func (c *Account) Register() revel.Result {   return c.someMethod() }

5. 實(shí)現(xiàn)Controller

現(xiàn)在讓我們?yōu)镻ostRegister添加處理注冊(cè)的邏輯。

首先，驗(yàn)證參數(shù)的有效性。

func (c *Account) PostRegister(user *models.MockUser) revel.Result {   c.Validation.Required(user)   c.Validation.Email(user.Email)   c.Validation.Required(user.Nickname)   c.Validation.Required(user.Password)   c.Validation.Required(user.ConfirmPassword == user.Password)   if c.Validation.HasErrors() {     c.FlashParams()     return c.Redirect((*Account).Register)   }   return c.Render() }

revel提供了挺好用的Validation機(jī)制，上面的代碼應(yīng)該不需要太多解釋?zhuān)挥幸恍?/p>

c.FlashParams()

它的作用就是把form提交的參數(shù)原樣存入Flash中，還記得剛才的$field.Flash嗎？

現(xiàn)在去玩玩注冊(cè)頁(yè)面吧，填寫(xiě)一些錯(cuò)誤的值看看反應(yīng)吧，嗯，你應(yīng)該很快就會(huì)發(fā)現(xiàn)，錯(cuò)誤信息雖然已經(jīng)顯示出來(lái)，但可惜卻是英文的，修改一下吧。

func (c *Account) PostRegister(user *models.MockUser) revel.Result {   c.Validation.Email(user.Email).Message("電子郵件格式無(wú)效")   c.Validation.Required(user.Nickname).Message("用戶(hù)昵稱(chēng)不能為空")   c.Validation.Required(user.Password).Message("密碼不能為空")   c.Validation.Required(user.ConfirmPassword == user.Password).Message("兩次輸入的密碼不一致")   if c.Validation.HasErrors() {     c.FlashParams()     return c.Redirect((*Account).Register)   }   return c.Render() }

Validation提供了好幾個(gè)常用的驗(yàn)證方法，大家可以自己看看，應(yīng)該是簡(jiǎn)單易懂的。

繼續(xù)，當(dāng)所有參數(shù)檢查都通過(guò)之后，就調(diào)用dal.RegisterUser方法將用戶(hù)信息存入數(shù)據(jù)庫(kù)。

func (c *Account) PostRegister(user *models.MockUser) revel.Result {   c.Validation.Email(user.Email).Message("電子郵件格式無(wú)效")   c.Validation.Required(user.Nickname).Message("用戶(hù)昵稱(chēng)不能為空")   c.Validation.Required(user.Password).Message("密碼不能為空")   c.Validation.Required(user.ConfirmPassword == user.Password).Message("兩次輸入的密碼不一致")   if c.Validation.HasErrors() {     c.FlashParams()     return c.Redirect((*Account).Register)   }   dal, err := models.NewDal()   if err != nil {     c.Response.Status = 500     return c.RenderError(err)   }   defer dal.Close()   err = dal.RegisterUser(user)   if err != nil {     c.Flash.Error(err.Error())     return c.Redirect((*Account).Register)   }   return c.Redirect((*Account).RegisterSuccessful) } func (c *Account) RegisterSuccessful() revel.Result {   return c.Render() }

我增加了一個(gè)方法RegisterSuccessful，用于顯示注冊(cè)成功，大家別忘了在routes和view中添加相應(yīng)的東西。

至此，用戶(hù)注冊(cè)已經(jīng)完成。不知道大家注意到?jīng)]有，就算修改go代碼，依然不需要重新啟動(dòng)revel，直接刷新瀏覽器頁(yè)面就會(huì)發(fā)現(xiàn)新的代碼已經(jīng)自動(dòng)編譯并且啟用了。