利用Go语言初步搭建一个web应用的教程
1.Abstract
在学习web开发的过程中会遇到很多困难,因此写了一篇类似综述类的文章。作为路线图从web开发要素的index出发来介绍golang开发的学习流程以及Example代码。
在描述中多是使用代码来描述使用方法不会做过多的说明。最后可以方便的copy代码来实现自己的需求。
本文适应对象:
- 对web开发有一定经验的人
- 能够灵活使用ajax的人(至少懂得前后分离)
- golangweb开发有一定了解,至少略读过一些golangweb开发的书籍
看完本文之后您会收获:
- golangweb开发的一些技巧
- golangweb开发的一些实用API
本文在描述的时候为了解释尽量详细,已经把解释写到代码注释中。
2.golangweb开发checklist
略过的部分:基本流程控制,OOP等基础语法知识。
3.路由器
路由器是整个网站对外的灵魂,如果路由做的不好URL会非常恶心。所以这部分设计成第一个要说的内容。
路由分两种一种是手动路由为了通过tul调度固定的功能,另外一点就是资源的获取,通过url的分析来模仿静态页的方式来获取资源(类似get)
自动路由,主要使用OOP的COMMAND模式来实现。所有功能使用post,统一入口,方便权限管理,安全管理,跨域管理。但是如此强大的功能还是交给框架来做吧。这里就不给新手做参考了。
3.1手动路由
packagemain
import(
"log"
"net/http"
)
funcmain(){
RouterBinding()//路由绑定函数
err:=http.ListenAndServe(":9090",nil)//设置监听的端口
iferr!=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")
iferr!=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":"Thisisatesttitle",
"Author":"kun.wang","PublishDatetime":"2014-09-14",
"Content":template.HTML("<pstyle=\"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.1require.js
5.1.1加载
<scriptdata-main="/reqmod/login_main"language="JavaScript"deferasync="true"src="js/r.js"></script>
整个网页之留这么一个加载脚本的入口(每个页面最好只有一个js文件)
好处
js是延迟加载。不会出现网页卡死的情况
最大化使用缓存。(HTTP304)
一个网页只用一个js
dom事件绑定,不用在html控件上写js绑定了
坏处
学习比较难
网站更新始终有缓存没更新的浏览器。造成错误(所以有些情况客户自己就知道多刷新几次了,已经成用户习惯了)
参数解释
`data-main`业务逻辑入口,载入当前字符串.js这个文件
`language`不解释
`deferasync`字面意思
`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配置。不然会死的很惨,报错的时候不会说缺少什么什么地方错了。
varnav_load=function(){//注意函数定义的方式copy就行
$.get('/nav.html',function(result){
varnewNode=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.2JQuery
JQ的功能只要require.js引用了之后基本上都是一样的。
如果有需要可以到w3school上学习一下。
6.业务层
Post分析
funcXXXAction(whttp.ResponseWriter,r*http.Request){
r.parseForm()//有这个才能获取参数
r.Form["Email"]//获取Email参数(String)
//写接下来的业务。
}
资源入口函数资源require分析(url分析固定写法)
funcFoo(whttp.ResponseWriter,r*http.Request){
queryFile:=strings.Split(r.URL.Path,"/")
queryResource:=queryFile[len(queryFile)-1]//解析文件
}
//完成字符串分割之后,按照需求来获取资源就可以了。
直接输入object
data,err:=ioutil.ReadAll(r.Body)//直接读取form为json字符串
iferr!=nil{
utility.SimpleFeedBack(w,10,"failedtoreadbody")
pillarsLog.PillarsLogger.Print("failedtoreadbody")
return
}
k:=【BUSINESSOBJECT】
err=json.Unmarshal(data,&k)
iferr!=nil{
utility.SimpleFeedBack(w,13,"Pramatersfailed!")
pillarsLog.PillarsLogger.Print("Pramatersfailed!")
return
}
//方便快捷。再访问参数的时候,直接调用结构体参数就可以了。
//注意ajax调用函数的时候需要做出一些调整代码如下:
$.ajax([dist],JSON.stringify([data]),function(){},'json');//注意JSON
7.持久层
7.1Mysql
其实不管什么语言的Mysql驱动都是从PRO*C来的,所以会PRO*\C之后,啥都好说
Insert/Delete/Update
stmt,err:=mysqlUtility.DBConn.Prepare("INSERTINTOcredit(credit_code,user_code,credit_rank)VALUES(?,?,?)")
iferr!=nil{
pillarsLog.PillarsLogger.Print(err.Error())
returnfalse,err
}
deferstmt.Close()
_,err=stmt.Exec(credit.CreditCode,credit.UserCode,credit.CreditRank)
iferr !=nil{
returnfalse,err
}else{
returntrue,err
}
//还是比较方便的
Query
stmt,err:=mysqlUtility.DBConn.Prepare(`SELECTcommodity_code,commodity_name,description,picture,
price,storage,count,status,
insert_datetime,update_datetimeFROMcommodityWHEREcommodity_code=?`)
iferr!=nil{
returnnil,err
}
deferstmt.Close()
result,err:=stmt.Query(commodityCode)
iferr!=nil{
returnnil,err
}
deferresult.Close()
varcommodityutility.Commodity
ifresult.Next(){
err=result.Scan(&(commodity.CommodityCode),&(commodity.CommodityName),&(commodity.Description),
&(commodity.Picture),&(commodity.Price),&(commodity.Storage),&(commodity.Count),&(commodity.Status),
&(commodity.InsertDatetime),&(commodity.UpdateDatetime))
iferr!=nil{
pillarsLog.PillarsLogger.Print(err.Error())
returnnil,err
}
}
return&commodity,err
7.2Mongodb
err:= mongoUtility.PictureCollection.Find(bson.M{"picturecode":*pictureCode}).One(&picture)
这里只给出最简单的例子。具体的看mgo的开发文档就ok。还是比较简单的。
8.单元测试注意事项
测试命令gotest-v(没有其他参数了!!!)如果不带-v只显示结果,不显示调试过程,主要是调试开发的时候用
文件格式xxx_test.go但是建议改成xxx_test0.go或者喜欢改成别的也可以。
由于测试先行的原则,在开发的时候一次测试也就一两个函数。
这样相当于把其他测试注释掉
测试的时候的配置文件要放到测试目录下面。别忘了。
心态,错误太多一个一个来,要有个好心态。
9.LOG
注意在调试中Log的不可缺失性。
下面api如果不知道从何而来直接doc搜索就可以了。
packageutility
import"log"
import"os"
import"fmt"
//LoggerModelminvariable.
varLogger*log.Logger
varoutFile*os.File
//initfunctionifLoggerifnotinitedwillinvokethisfunction
funcinit(){
ifLogger==nil{
propertyMap:=ReadProperty("pic.properties")
logFileName:=propertyMap["LogFile"]
fmt.Println("InitialandOpenlogfile",logFileName)
varerrerror
outFile,err=os.OpenFile(logFileName,os.O_CREATE|os.O_APPEND|os.O_RDWR,0666)
iferr!=nil{
panic(err.Error())
}
Logger=log.New(outFile,"",log.Ldate|log.Ltime|log.Llongfile)
}
}
//CloseLogFilefunction:closeLoggerinvokefile.
funcCloseLogFile(){
outFile.Close()
}
使用方法:
utility.Logger.Println("Logtest")