使用Golang快速構建WEB應用

我們從來都不開發程式碼，我們只是程式碼的搬運工。— 阿飛

希望大家都變卡卡西。 — 啊賤

大家copy愉快，文件只做參考。如果發現問題或者有好的建議請回復我我回及時更正。

1.Abstract

在學習web開發的過程中會遇到很多困難，因此寫了一篇類似綜述類的文章。作為路線圖從web開發要素的index出發來介紹golang開發的學習流程以及Example程式碼。

在描述中多是使用程式碼來描述使用方法不會做過多的說明。最後可以方便的copy程式碼來實現自己的需求。

本文適應物件：

1. 對web開發有一定經驗的人
2. 能夠靈活使用ajax的人（至少懂得前後分離）
3. golang web 開發有一定了解，至少略讀過一些golang web開發的書籍

看完本文之後您會收穫：

1. golang web開發的一些技巧
2. golang web開發的一些實用API

本文在描述的時候為了解釋儘量詳細，已經把解釋寫到程式碼註釋中。

2.golang web 開發check list

略過的部分：基本流程控制，OOP等基礎語法知識。

3.路由器

路由器是整個網站對外的靈魂，如果路由做的不好URL會非常噁心。所以這部分設計成第一個要說的內容。

路由分兩種一種是手動路由為了透過tul排程固定的功能，另外一點就是資源的獲取，透過url的分析來模仿靜態頁的方式來獲取資源（類似get）

自動路由，主要使用OOP的COMMAND模式來實現。所有功能使用post，統一入口，方便許可權管理，安全管理，跨域管理。但是如此強大的功能還是交給框架來做吧。這裡就不給新手做參考了。

3.1手動路由

package main
import (
  "log"
  "net/http"
  )
  func main() {
    RouterBinding() // 路由繫結函式
    err := http.ListenAndServe(":9090", nil) //設定監聽的埠
    if err != nil {
      log.Fatal("ListenAndServe: ", err)
    }
  }

在httpserver執行之前先繫結路由

3.2 手動路由的繫結

3.2.1 靜態檔案

http.Handle("/pages/", http.StripPrefix("/pages/", http.FileServer(http.Dir("./pages"))))

3.2.2 固定函式與資源獲取

他們都是一樣的

http.HandleFunc("/images/", fileUpload.DownloadPictureAction)

4.頁面載入

4.1 純靜態頁（HTML）

直接交給路由就行了。自動就訪問那個資料夾了。不過生產環境果然還得是cdn，如果自己伺服器比較多。可以nginx反向代理。

主要好處前後分離，能上CDN就是通訊次數多了。不過透過最佳化改善之類的都還ok啦。

4.2 模板頁面的載入

commonPage, err := template.ParseFiles("pages/common/head.gtpl", //載入模板
"pages/common/navbar.gtpl", "pages/common/tail.gtpl")
if err != nil {
  panic(err.Error())
}
navArgs := map[string]string{"Home": "home", "User": "yupengfei"}//複雜的引數開始往裡塞
knowledgePage, err := template.ParseFiles("pages/knowledge/knowledge.gtpl")
knowledgeArgs := map[string]interface{}{"Head": "This is a test title",
"Author": "kun.wang", "PublishDatetime": "2014-09-14",
"Content": template.HTML("<p style=\"text-indent: 2em\">為什麼要用語義呢？</p>")}//不是不好，只是做字串分析會影響工程效率
commonPage.ExecuteTemplate(w, "header", nil)// render 開始
commonPage.ExecuteTemplate(w, "navbar", navArgs)
knowledgePage.ExecuteTemplate(w, "knowledge", knowledgeArgs)
commonPage.ExecuteTemplate(w, "tail", nil)

僅提供關鍵程式碼。

• 其他的都還挺好，就是頁面渲染用伺服器是不是有點太奢侈了。
• 字串陣列作為輸入引數差錯比較困難
• 總結：雖然減少的通訊次數，但是沒辦法上CDN蛋疼，另外，模板的mapping蛋疼。

5.表示層指令碼

表示層指令碼做的比較困難也不是很好學。但是一旦搞定了，程式碼的複用性會有非常可觀的提升。

就普通情況而言JS開發效率是非常高的靈活度高，並且使用的是客戶端的cpu效能好，免費資源多，學習的人也多，好招聘。

5.1 require.js

5.1.1 載入

<script data-main="/reqmod/login_main" language="JavaScript" defer async="true" src="js/r.js"></script>

整個網頁之留這麼一個載入指令碼的入口（每個頁面最好只有一個js檔案）

好處

• js是延遲載入。不會出現網頁卡死的情況
• 最大化使用快取。（HTTP 304）
• 一個網頁只用一個js
• dom事件繫結，不用在html控制元件上寫js繫結了

壞處

• 學習比較難
• 網站更新始終有快取沒更新的瀏覽器。造成錯誤（所以有些情況客戶自己就知道多重新整理幾次了，已經成使用者習慣了）

引數解釋

• `data-main` 業務邏輯入口，載入當前字串.js這個檔案
• `language` 不解釋
• `defer async` 字面意思
• `src` r.js就是require.js的意思。程式碼到處都能搞到。

5.1.2 頁面Business

載入依賴檔案

require.baseUrl = "/"
require.config({
  baseUrl: require.baseUrl,
  paths: {
    "jquery": "js/jquery-1.10.2.min",
    "domready" : "reqmod/domReady",
    "pm" : "reqmod/pmodal",
    "cookie":"reqmod/cookie",
    "user":"reqmod/user",
    "bootstrap": "reqmod/bootstrap.min",
    "nav":"reqmod/nav"
  },
  shim: {
    'bootstrap': {
      deps: ['jquery']
    }
  }
});
//直接copy全搞定。

執行頁面business

執行裡面做的最多的就是dom跟事件繫結而已。載入各種js庫直接引用。

程式碼美觀，開發效率，執行效率都是非常棒的。

require(['nav','domready', 'jquery', 'user','pm'], function (nav,doc, $, user,pm){
  //這個函式的第一個`陣列`引數是選擇的依賴的模組。1. 網站絕對路徑。 2. 使用載入依賴模組的時候選擇export的內容
  //陣列的順序要跟function順序一致，如果有兩個模組依賴比如說jquery外掛，就寫道最後不用變數，直接使用`$`
  doc(function () { // domReady
    pm.load();//載入各種外掛HTML模板之類的都ok
    $('#btn_login')[0].onclick = function(){user.login();}//button 事件繫結
  });
});

頁面MODEL

define(['jquery','reqmod/cookie','user','bootstrap'],function ($,cookie,user){
    //define 函式的引數內容require是一樣的。
    // 這裡依賴的模組要在呼叫此模組中的模組中有path配置。不然會死的很慘，報錯的時候不會說缺少什麼什麼地方錯了。
  var nav_load = function () { // 注意函式定義的方式copy就行
    $.get('/nav.html', function(result){
      var newNode = document.createElement("div");
      newNode.innerHTML = result;
      $('body')[0].insertBefore(newNode,$('body')[0].firstChild);
      //document.body.innerHTML = result + document.body.innerHTML;
      $('#btn_login')[0].onclick = function(){user.login();}
      $('#btn_reg')[0].onclick = function(){window.location='/register.html'}
      $.post('/login_check',{},function(data){
        if(data==0){
          Form_login.style.display=""
        }
        else{
          form_userInfo.style.display=""
        }
      })
    });
  }
  return {//這裡類似微型路由。非常靈活，非常方便
    load :nav_load
  };
});

5.2 JQuery

JQ的功能只要require.js引用了之後基本上都是一樣的。

如果有需要可以到w3school上學習一下。

6.業務層

Post分析

func XXXAction(w http.ResponseWriter, r *http.Request) {
  r.parseForm() //有這個才能獲取引數
  r.Form["Email"] // 獲取Email 引數（String）
  // 寫接下來的業務。
}

資源入口函式資源require分析（url分析固定寫法）

func Foo(w http.ResponseWriter, r *http.Request) {
  queryFile := strings.Split(r.URL.Path, "/")
  queryResource := queryFile[len(queryFile)-1] // 解析檔案
}
//完成字串分割之後，按照需求來獲取資源就可以了。

直接輸入object

data, err := ioutil.ReadAll(r.Body) //直接讀取form為 json 字串
	if err != nil {
		utility.SimpleFeedBack(w, 10, "failed to read body")
		pillarsLog.PillarsLogger.Print("failed to read body")
		return
	}
	k := 【BUSINESS OBJECT】
	err = json.Unmarshal(data, &k)
	if err != nil {
		utility.SimpleFeedBack(w, 13, "Pramaters failed!")
		pillarsLog.PillarsLogger.Print("Pramaters failed!")
		return
	}
//方便快捷。再訪問引數的時候，直接呼叫結構體引數就可以了。
//注意ajax呼叫函式的時候需要做出一些調整程式碼如下：
$.ajax([dist],JSON.stringify([data]),function(){},'json');//注意JSON

7.持久層

7.1 Mysql

其實不管什麼語言的Mysql驅動都是從PRO*C來的，所以會PRO*\C之後，啥都好說

Insert/Delete/Update

stmt, err := mysqlUtility.DBConn.Prepare("INSERT INTO credit (credit_code, user_code, credit_rank) VALUES (?, ?, ?)")
if err != nil {
  pillarsLog.PillarsLogger.Print(err.Error())
  return false, err
}
defer stmt.Close()
_, err = stmt.Exec(credit.CreditCode, credit.UserCode, credit.CreditRank)
if err 	!= nil {
  return false, err
  } else {
    return true, err
  }
  //還是比較方便的

Query

stmt, err := mysqlUtility.DBConn.Prepare(`SELECT commodity_code, commodity_name, description, picture,
  price, storage, count, status,
  insert_datetime, update_datetime FROM commodity WHERE commodity_code = ?`)
  if err != nil {
    return nil, err
  }
  defer stmt.Close()
  result, err := stmt.Query(commodityCode)
  if err != nil {
    return nil, err
  }
  defer result.Close()
  var commodity utility.Commodity
  if result.Next() {
    err = result.Scan(&(commodity.CommodityCode), &(commodity.CommodityName), &(commodity.Description),
    &(commodity.Picture), &(commodity.Price), &(commodity.Storage), &(commodity.Count), &(commodity.Status),
    &(commodity.InsertDatetime), &(commodity.UpdateDatetime))
    if err != nil {
      pillarsLog.PillarsLogger.Print(err.Error())
      return nil, err
    }
  }
  return &commodity, err

7.2 Mongodb

err := 	mongoUtility.PictureCollection.Find(bson.M{"picturecode":*pictureCode}).One(&picture)

這裡只給出最簡單的例子。具體的看mgo的開發文件就ok。還是比較簡單的。

8.單元測試注意事項

• 測試命令 go test -v （沒有其他引數了！！！） 如果不帶-v只顯示結果，不顯示除錯過程，主要是除錯開發的時候用
• 檔案格式 xxx_test.go 但是建議改成 xxx_test0.go 或者喜歡改成別的也可以。
  • 由於測試先行的原則，在開發的時候一次測試也就一兩個函式。
  • 這樣相當於把其他測試註釋掉
• 測試的時候的配置檔案要放到測試目錄下面。別忘了。
• 心態，錯誤太多一個一個來，要有個好心態。

9.LOG

注意在除錯中Log的不可缺失性。

下面api如果不知道從何而來直接doc搜尋就可以了。

package utility
import "log"
import "os"
import "fmt"
// Logger Model min variable.
var Logger *log.Logger
var outFile *os.File
// init function if Logger if not inited will invoke this function
func init() {
  if Logger == nil {
    propertyMap := ReadProperty("pic.properties")
    logFileName := propertyMap["LogFile"]
    fmt.Println("Initial and Open log file ", logFileName)
    var err error
    outFile, err = os.OpenFile(logFileName, os.O_CREATE|os.O_APPEND|os.O_RDWR, 0666)
    if err != nil {
      panic(err.Error())
    }
    Logger = log.New(outFile, "", log.Ldate|log.Ltime|log.Llongfile)
  }
}
// CloseLogFile function : close Logger invoke file.
func CloseLogFile() {
  outFile.Close()
}

使用方法：

utility.Logger.Println("Log test")

總結

1. 看完這裡copy程式碼日常工作還是能好應付一點。
2. 如果是新手看完這個之後，看那麼厚的書就有一定的目標性了。能方便一點

AUTH:PHILO VERSION 2