利用Go语言初步搭建一个web应用的教程

1.abstract

在学习web开发的过程中会遇到很多困难，因此写了一篇类似综述类的文章。作为路线图从web开发要素的index出发来介绍golang开发的学习流程以及example代码。

在描述中多是使用代码来描述使用方法不会做过多的说明。最后可以方便的copy代码来实现自己的需求。

本文适应对象：

•     对web开发有一定经验的人
•     能够灵活使用ajax的人（至少懂得前后分离）
•     golang web 开发有一定了解，至少略读过一些golang web开发的书籍

看完本文之后您会收获：

•     golang web开发的一些技巧
•     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")