zoukankan      html  css  js  c++  java
  • 使用Golang+Mongodb打造你的第一个站点

     

    很多人推荐MEAN来开发站点。MEAN就是M:mongodb,E:expressjs、A:angular最后的N:nodejs。 但是如果你亲身的体会到了js的嵌套回调的话你就会想换换别的办法了。虽然说可以用promise等框架 破解深深的嵌套,但毕竟不是语言本身支持的。

    为什么说用Golang呢?因为Golang是一个有着动态语言的特点的静态语言。语法简单,语法糖就是尽量减少语法。 编译的时候就可以把错误排查掉很多。不用像动态语言那样运行的时候才掉进坑里。

    在Golang众多的Web框架中发现了Martini。 他后来觉得这个框架用了太多反射影响了效率,就有写了另一个框架或者按照作者的说法“中间件”, 叫做Negroni。具体的开发原因看这里。 可能是这个作者爱喝酒把他写的框架都叫了个酒水的名字。Margini这个框架是作者受了Expressjs的启发写出来的。 所以在很多使用上的东西非常类似,比如route的绑定语法,支持类中间件的绑定语法等。也看过Golang的其他框架比如Revel, 有很多的酷炫的功能,和一站式的很多的支持,但是因为Martini的灵活决定选用Margini。

    数据库MongoDB

    数据库方面,对于事物和数据的一致性要求没有那么强的话,还是选用比较简单的NoSQL数据库比较合适。所以,就用MongoDB了。 也许在严谨的工作中不应该这么用。但是MongoDB可以简单到,只要把Http POST过来的json数据直接写入数据库中。 如果json比较简单的话,完全不用做什么设计!当然,实际工作的时候是不可以这样的。我们讨论的只是这样的一个可行性。

    那么我们就开始用Martini(golang)和MongoDB来打造一个web APP。这个app的名称就叫做navigator(领航者)。 是用来接受、存储和分析用户反馈以及用户的各种问题的,比如各种客户反馈回来的用户问题。这些问题的上下文信息十分有限。 所以我们让用户通过手机客户端来调用navigator的接口来同时提交相关的上下文信息。 关于Golang的一些基础的东西就不在这里探讨了。 go get获取Martini,下载MongoDB。之后使用命令run起来MongoDB。给DB起一个名字:NDB。然后在里面填充一个document。 MongoDB如果没有insert一个Document的话,那么这个数据库其实是没有创建的。这个Document就是一个Json。格式为:

    {
    	"feedbackcode" : "123",
    	"username" : "",
    	"phonenum" : "",
    	"deviceinfo" : {
    		"systemtype" : "",
    		"systemver" : "",
    		"appver" : ""
    	},
    	"imagelist" : [ ],
    	"desc" : "testing",
    	"feedbacktype" : "",
    	"other" : ""
    }
    

    使用feedbackCode来标示一个唯一的feedback。数据库的问题就彻底解决了。

    站点的目录结构

    下面开始我们的站点部分。首先了解一下目录结构:

    navigator
    |———conf
    |-————–Conf.go # 配置信息
    |—————–ConfigError.go # 错误名称
    |———controllers
    |—————–FeedbackController.go
    |—————–IndexController.go
    |–––models
    |––––––FeedbackModel.go
    server.go

    这个目录结构式典型的REST API的MVC模式体现。我们这里不需要处理View,也就是Html的东西。但是, 还是显示的区分了Model和Controller。view其实还是有的,只不过是最后render后的json。

    RUN起来

    首先,让我们的web app跑起来。 给server.go添加如下的代码:

    package main
    
    import "github.com/go-martini/martini"
    
    func main() {
      m := martini.Classic()
      m.Get("/", func() string {
        return "Hello world!"
      })
      m.Run()
    }

    go run server.go命令就可以让这个web app运行起来了。默认的是运行在3000端口上的。 在页面上也只能看到光秃秃的几个字Hello world! martini.Classic()调用之后,Martini会为你默认提供一些工具。其中最重要的一个就是路由。 在这之后就可以使用m.Get("/", func()string{return "Hello, world!"}来指定什么路径映射到什么处理方法上。 最后调用m.Run()方法在3000端口上运行整个app。

    现在开始要真正的开发这个app了。首先我们需要有一个简单的需求分析,我们到底是要做什么。 如前所述,用户可以用这个API发送feedback上来,然后在另外一个接口里把这些内容以列表的形式展示出来。 需求就是这么简单。我们下面来一步一步实现这些功能。

    Controllers

    由于insert一个feedback,需要的信息量还是很大的。我们用POST得方法发送所需要的feedback数据。 所以,我们需要一个POST的路径和处理函数Handler(以后都叫做Handler)。

    m.Post("/", func(req *http.Request) string{
        // 从req中取出参数,插入到数据库
    })

    现实feedback的列表的接口只需要响应一个GET请求。所以是一个GET的路径和Handler。 看起来应该是这样的:

    m.Get("/", func() string {
    	// 假设最后的字典会被转换成Json串
    	return []map[string]string{map[string]string{"feedbackcode": "1", "username": "John"}, 
    							   map[string]string{"feedbackcode": "2", "username": "Tony"}}
    }

    以上列出的Handler都是对于API添加数据和数据列表的一些模拟。下面开始开始正式写Controller。

    列表Controller

    先看代码,然后再来详细说明:

    package controllers
    
    import (
    	// "fmt"
    	"fmt"
    	"github.com/martini-contrib/render"
    	"navigator/conf"
    	"navigator/models"
    	"net/http"
    )
    
    type FeedbackController struct {
    }
    
    func (c *FeedbackController) FeedbackList(req *http.Request, r render.Render) {
    
    	f := new(models.FeedbackModel)
    	r.JSON(200, map[string]interface{}{"data": f.ModelList(nil)})
    }

    引入github.com/martini-contrib/renderrender是一个渲染的包。 如果有html的视图的话,可以把数据转换成html模板可用的数据。我们这里用这个包来把字典转换成json数据。 r.JSON(200, map[string]interface{}{"data": f.ModelList(nil)})中200,是状态码。 需要转换的字典是一个string为key,Model列表为值的字典。

    这里可以先了解一部分feedback的Model类:

    type DeviceInfo struct {
    	SystemType string `json: "systemType"`    // ios or android
    	SystemVer  string `json: "systemVersion"` // system version eg, ios 9.1
    	AppVer     string `json: "appVersion"`    // app version eg, 2.9.0
    }
    
    type FeedbackModel struct {
    	FeedbackCode string     `json: "feedbackCode"`
    	UserName     string     `json: "userName"`
    	PhoneNum     string     `json: "phoneNum"`
    	DeviceInfo   DeviceInfo `json: "deviceInfo"`
    	ImageList    []string   `json: "imageList"`
    	Desc         string     `json: "description"`
    	FeedbackType string     `json: "feedbackType"` // normal feedback or a problem in use
    	Other        string     `json: "other"`        // other infomation
    }

    在最开始的json数据定义,在Golang的Model类定义中可以定义为上面的代码。 用"``"标示出来的,是在Model转换为json字符串的过程中Model字段和json串的key值得对应关系。 最后Controller的功能是需要处理请求过来的数据的, 也就是Controller的方法会作为Get或者Post的Handler的。这两者之间需要关联起来:

    package main 
    
    import (
        // other packages
        "navigator/controllers"
    )
    
    func main() {
        var m = martini.Classic()
        var r = martini.NewRouter()
        
        feedbackController := new(controllers.FeedbackController)
        
        r.Get("/nav/feedback", feedbackController.FeedbackList)
        r.Post("/nav/feedback", feedbackController.Feedback)
        m.Action(r.Handle)
        
        m.RunOnAddr(":9090")
    }

    这里r.Get("/nav/feedback", feedbackController.FeedbackList),修改了之前的访问路径。/nav/feedback是在路径上加了一个项目的名称简写作为限定。因为直接叫做feedback有可能会和其他的同名接口混了。 也就是接口的污染。所以加一个项目名称来避免这个问题。feedbackController := new(controllers.FeedbackController)初始化FeedbackController。 把feedbackController的方法FeedbackList和访问的路径绑定到一起。 GET的Http访问和FeedbackList方法绑定,POST的Http访问和Feedback方法绑定。 最后m.RunOnAddr(":9090")代替了之前使用的m.Run()。之前app是运行在3000端口上的。 现在通过m.RunOnAddr(":9090")则app将运行在9090端口上。也就是可以用这一语句来制定app的运行端口。

    Models和MongoDB

    处理MongoDB我们用mgo这个库。Golang虽然这么多年了已经。还出了这么多的明星产品。 但是,处理MongoDB的成熟的库还是可以说没有。完全没有想python、nodejs等语言的库那么丰富。 有标准的,还有很多github上的其他开发者开发的库。Golang里也就是mgo相对来说这个库比较可用的了。

    当POST请求的feedback的json字符串传上来的时候,会被转换为一个FeedbackModel的对象。 Golang的json库会帮助我们做到这一点。 json.Unmarshal([]byte(dict), &f)这里的Unmarshal方法会把一个json字符串转化为FeedbackModel对象。 这里需要用到一个工厂方法。生成一个Model对象,并且这个对象应该是一个富Model对象。 后面这个Model对象将具有可以操作操作数据库,增、删、改、查的方法。代码:

    func NewFeedbackModel(dict string) *FeedbackModel {
        var f FeedbackModel
        err := json.Unmarshal([]byte(dict), &f)
        if err != nil {
            return nil
        }
    
        return &f
    }

    以上代码会用到库"encoding/json"。当收到feedback的json串的时候就用这个方法将其转换为FeedbackModel对象。 上文说过,会给这个Model增加数据库操作的方法。那么我们就可以通过json串得到的Model来执行数据的操作。 代码:

    func (m *FeedbackModel) ModelList(conditions map[string]string) []FeedbackModel {
        confInstance := conf.ConfigInstance()
        mgoUri := conf.ConfigInstance().MongoDBConnectionString()
        // var f FeedbackModel
        session, err := mgo.Dial(mgoUri)
        if err != nil {
            fmt.Printf("can not connect to server %v
    ", err)
            panic(err)
        }
        defer session.Close()
    
        var feedbackModelList []FeedbackModel
    
        collection := session.DB(confInstance.DBName).C("feedback")
        err = collection.Find(conditions).All(&feedbackModelList)
    
        return feedbackModelList
    }
    
    func (m *FeedbackModel) GetModel(modelId string) (*FeedbackModel, error) {
        //此处省略一部分代码
        collection := session.DB(confInstance.DBName).C("feedback")
        err = collection.Find(bson.M{"feedbackcode": modelId}).One(&f)
        
        return &f, nil
    }
    
    func (m *FeedbackModel) InsertModel(model *FeedbackModel) error {
        //此处省略一部分代码
        f := session.DB(confInstance.DBName).C("feedback")
        err = f.Insert(model)
    
        return err
    }

    这里需要稍微的提到一部分MongoDB的知识。在MongoDB中,库还是库,但是表不叫做表,叫做Collection。 关键字不翻译。翻译出来的看着太烂,还不能清楚表达意思。每一条记录也不叫记录,叫做Document。 一个Document的大小不能超过2M。

    在MongoDB里查找是这样的:

    db.feedback.find({"feedbackCode": "1"}) //查找条件就是{"feedbackCode":"1"}) //查找条件就是

    如果在find里什么都不写,那么就是无条件的全部查找。插入是这样的:

    db.feedback.insert({"feedbackCode": "2"})

    Golang的mgo当然在具体操作数据库方面和MongoDB本身是不会差太多了,除了这是Go语法的封装。

    collection := session.DB(confInstance.DBName).C("feedback")

    这样就得到了一个Collection。查找、插入、修改等动作都是在Collection上执行的。所以,查找就是这样的:

    collection.Find(conditions).All(&feedbackModelList)

    查找到的列表会存放在一个事先声明好的feedback的Model列表里。查找一个可以这样:

    collection.Find(bson.M{"feedbackcode": modelId}).One(&f)

    插入:

    collection.Insert(model)

    insert的时候,这个model需要是指针类型的,也就是:var model *FeedbackModel

    到这里就可以把整个的feedback从请求到返回的过程都串联起来了。

    全部串联起来

    在整个的app入口处。请求的路径和具体的Controller处理函数绑定在了一起。每一个请求来了之后 ,如果路径和绑定的路径是对应好了的。就会被发送给Controller的某个绑定好的函数里处理。

    这个负责处理http请求的Controller方法会把http请求发送上来的json字符串发送给Model模块处理。 Model模块会把json字符串转换为一个Model实例。这个Model是一个富Model, 可以调用其函数把Model本身的数据插入到Mongo数据库中,当然也可以从数据库中查询这些数据。

    到这里

    到这里你已经熟悉了如何用Martini这个Golang框架开发一个简单地站点,好吧,其实是一个REST Api。 使用我们文中提到的Render框架,你可以非常非常容易的把Model数据转换之后并显示在html的template中。 而且你已经熟悉了MongoDB数据库。一个非常简单易用的数据库。无论你是要开发一个REST Api还是要开发一个html的站点。 需要存储的东西都可以存如MongoDB数据库中。到这里你已经可以顺利的继续下面的功能的开发了。

  • 相关阅读:
    【今日CV 视觉论文速览】 19 Nov 2018
    【numpy求和】numpy.sum()求和
    【今日CV 视觉论文速览】16 Nov 2018
    【今日CV 视觉论文速览】15 Nov 2018
    poj 2454 Jersey Politics 随机化
    poj 3318 Matrix Multiplication 随机化算法
    hdu 3400 Line belt 三分法
    poj 3301 Texas Trip 三分法
    poj 2976 Dropping tests 0/1分数规划
    poj 3440 Coin Toss 概率问题
  • 原文地址:https://www.cnblogs.com/sunshine-anycall/p/4967432.html
Copyright © 2011-2022 走看看