From 9f0dff7e50a36c9657695f52b08f0a9ab7460fdd Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Sun, 11 Nov 2012 22:37:47 +0800 Subject: [PATCH 01/49] =?UTF-8?q?=E4=BB=8B=E7=BB=8D=E4=BA=86=E6=97=A5?= =?UTF-8?q?=E5=BF=97=E8=BF=99=E4=B8=80=E5=9D=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 12.1.md | 9 +++++++++ 12.3.md | 2 ++ 12.md | 2 ++ 3 files changed, 13 insertions(+) diff --git a/12.1.md b/12.1.md index 9786c643..13cf8579 100644 --- a/12.1.md +++ b/12.1.md @@ -1,4 +1,13 @@ # 12.1 应用日志 +我们期望开发的Web应用程序能够把整个程序运行过程中出现的各种事件一一记录下来，Go语言中提供了一个简易的log包，我们使用该包可以方便的实现日志记录的功能，这些日志都是基本的给予fmt包的打印再结合panic之类的一些函数来处理我们一般的打印抛出错误之类的。如果我们想把我们的应用日志保存到文件，然后又能够结合日志实现很多复杂的功能，编写过Java或者C++的读者应该都使用过log4j和log4cpp之类的日志工具，Go目前标准包就如前面介绍的只是包含了一个简单的包，但是目前第三方开发的一个日志系统实现了很强大的日志功能，`https://github.com/cihub/seelog`，接下来我们介绍如何该日志系统来实现我们应用的日志功能。 + +## seelog介绍 + + +## 发生错误发送邮件 +## 使用应用日志 + +## 小结 ## links * [目录]() diff --git a/12.3.md b/12.3.md index b587e7eb..213503a6 100644 --- a/12.3.md +++ b/12.3.md @@ -1,5 +1,7 @@ # 12.3 应用部署 +http://code.google.com/p/go/issues/detail?id=227 + ## links * [目录]() * 上一章: [网站错误处理](<12.2.md>) diff --git a/12.md b/12.md index a59312e0..a074b376 100644 --- a/12.md +++ b/12.md @@ -1,5 +1,7 @@ # 12 部署与维护 +到目前为止，我们前面已经介绍了如何开发程序、调试程序以及测试程序，正如人们常说的：开发最后的10%需要花费90%的时间，所以这一章我们将强调这最后的10%部分，要真正成为让人信任并使用的优秀应用，需要考虑到一些细节，以上所说的10%就是指这些小细节。 +本章我们将通过四个小节来介绍这些小细节的处理，第一小节介绍如何在生产服务上记录程序产生的日志，如何记录日志，第二小节介绍发生错误时我们的程序如何处理，如何保证尽量少的影响到用户的访问，第三小节介绍如何来部署Go的独立程序，由于目前Go程序还无法像C那样写成daemon，那么我们如何管理这样的进程程序后台运行呢？第四小节讲介绍应用数据的备份和恢复，尽量保证应用在奔溃的情况能够保持数据的完整性。 ## 目录 * 1 [应用日志](12.1.md) * 2 [网站错误处理](12.2.md) From 9aa3e50854349188fb836e8a7981eea69855a92a Mon Sep 17 00:00:00 2001 From: astaxie Date: Mon, 12 Nov 2012 11:32:49 +0800 Subject: [PATCH 02/49] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E4=BA=86=E5=AF=B9?= =?UTF-8?q?=E5=BA=94=E7=9A=84liteide=E9=83=A8=E5=88=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 1.4.md | 604 +++++++++++++++++++++++++++++---------------------------- 1 file changed, 303 insertions(+), 301 deletions(-) diff --git a/1.4.md b/1.4.md index cd68e901..99fae557 100644 --- a/1.4.md +++ b/1.4.md @@ -1,301 +1,303 @@ -# 1.4 Go开发工具 - -本节我将介绍几个开发工具，它们都具有自动化提示，自动化fmt功能。因为它们都是跨平台的，所以安装步骤之类的都是通用的。 - -## LiteIDE - - LiteIDE是一款专门为Go语言开发的集成开发环境（IDE），由visualfc编写。支持项目管理、集成构建、GDB调试、语法高亮、自动补全、大纲显示等功能。下载地址: [http://code.google.com/p/golangide/downloads/list](http://code.google.com/p/golangide/downloads/list)，根据自己的系统下载相应的发行版本。Windows和Ubuntu系统可直接打开bin下面的liteide；Mac则需通过LaunchPad打开LiteIDE.app。 - - ![](images/1.4.liteide.png?raw=true) - - LiteIDE配置需要按照前面几个小节配置了相应的go和`$GOPATH`（LiteIDE中也可以图形化配置LiteIDE专用的GOPATH）。LiteIDE当前的编译环境可以通过编译工具栏上的环境配置来切换，如切换32位和64位，针对自己的系统，可能需要修改相应的LiteEnv环境变量，如64位版本，LiteIDE => 查看 => 选项 => LiteEnv => Win64.env => GOROOT=c:\go-w64 为你的`$GOROOT`，不然会无法使用`build`命令。 - - 配置好LiteIDE后，可以打开或拖动任何目录到LiteIDE中作为项目，LiteIDE的编译是针对当前编辑文档所属目录来执行相应的go命令，所以编译时要先打开相应的Go文件。LiteIDE仿IDEA界面，支持项目浏览、文件系统，Package浏览、Golang文档检索、类视图、大纲显示等多个工具窗口的切换。 - - 代码补全需要安装gocode，目前LiteIDE的自动化提示只支持本文件中函数的提示，还没有做到整个项目中函数的提示。 - - -## Sublime Text - - 这里将介绍Sublime Text 2（以下简称Sublime）+GoSublime+gocode+MarGo的组合，那么为什么选择这个组合呢？ - - - 自动化提示代码,如下图所示 - ![](images/1.4.sublime1.png?raw=true) - - - 保存的时候自动格式化代码，让您编写的代码更加美观，符合Go的标准。 - - 支持项目管理 - ![](images/1.4.sublime2.png?raw=true) - - 支持语法高亮 - - Sublime Text 2可免费使用，只是保存次数达到一定数量之后就会提示是否购买，点击取消继续用，和正式注册版本没有任何区别。 - - 接下来就开始讲如何安装，下载[Sublime](http://www.sublimetext.com/) - - 根据自己相应的系统下载相应的版本，然后打开Sublime，对于不熟悉Sublime的同学可以先看一下这篇文章[Sublime Text 2 入门及技巧](http://lucifr.com/139225/sublime-text-2-tricks-and-tips/) - - 1. 打开之后安装 Package Control：Ctrl+` 打开命令行，执行如下代码： - - import urllib2,os; pf='Package Control.sublime-package'; ipp=sublime.installed_packages_path(); os.makedirs(ipp) if not os.path.exists(ipp) else None; urllib2.install_opener(urllib2.build_opener(urllib2.ProxyHandler())); open(os.path.join(ipp,pf),'wb').write(urllib2.urlopen('http://sublime.wbond.net/'+pf.replace(' ','%20')).read()); print 'Please restart Sublime Text to finish installation' - - 这个时候重启一下Sublime，可以发现在在菜单栏多了一个如下的栏目，说明Package Control已经安装成功了。 - - ![](images/1.4.sublime3.png?raw=true) - - 2. 接下来安装gocode和MarGo。 - 打开终端运行如下代码（需要git） - - go get -u github.com/nsf/gocode - go get -u github.com/DisposaBoy/MarGo - - 这个时候我们会发现在`$GOPATH/bin`下面多了两个可执行文件，gocode和MarGo，这两个文件会在GoSublime加载时自动启动。 - - 3. 安装完之后就可以安装Sublime的插件了。需安装GoSublime、SidebarEnhancements和Go Build，安装插件之后记得重启Sublime生效，Ctrl+Shift+p打开Package Controll 输入`pcip`（即“Package Control: Install Package”的缩写）。 - - 这个时候看左下角显示正在读取包数据，完成之后出现如下界面 - - ![](images/1.4.sublime4.png?raw=true) - - 这个时候输入GoSublime，按确定就开始安装了。同理应用于SidebarEnhancements和Go Build。 - - 4. 验证是否安装成功，你可以打开Sublime，打开main.go，看看语法是不是高亮了，输入`import`是不是自动化提示了，`import "fmt"`之后，输入`fmt.`是不是自动化提示有函数了。 - - 如果已经出现这个提示，那说明你已经安装完成了，并且完成了自动提示。 - - 如果没有出现这样的提示，一般就是你的`$PATH`没有配置正确。你可以打开终端，输入gocode，是不是能够正确运行，如果不行就说明`$PATH`没有配置正确。 - - -## Vim -Vim是从vi发展出来的一个文本编辑器, 代码补全、编译及错误跳转等方便编程的功能特别丰富，在程序员中被广泛使用。 - - ![](images/1.4.vim.png?raw=true) - - 1. 配置vim高亮显示 - - cp -r $GOROOT/misc/vim/* ~/.vim/ - - 2. 在~/.vimrc文件中增加语法高亮显示 - - filetype plugin indent on - syntax on - - 3. 安装[Gocode](https://github.com/nsf/gocode/) - - go get -u github.com/nsf/gocode - - gocode默认安装到`$GOPATH/bin`下面，需要把`$GOPATH/bin`路径设置到系统`$PATH`里面。 - - 4. 配置[Gocode](https://github.com/nsf/gocode/) - - ~ cd $GOPATH/src/github.com/nsf/gocode/vim - ~ ./update.bash - ~ gocode set propose-builtins true - propose-builtins true - ~ gocode set lib-path "/home/border/gocode/pkg/linux_amd64" - lib-path "/home/border/gocode/pkg/linux_amd64" - ~ gocode set - propose-builtins true - lib-path "/home/border/gocode/pkg/linux_amd64" - ->gocode set里面的两个参数的含意说明： -> ->propose-builtins：是否自动提示Go的内置函数、类型和常量，默认为false，不提示。 -> ->lib-path:默认情况下，gocode只会搜索**$GOPATH/pkg/$GOOS_$GOARCH** 和 **$GOROOT/pkg/$GOOS_$GOARCH**目录下的包，当然这个设置就是可以设置我们额外的lib能访问的路径 - - - - 5. 恭喜你，安装完成，你现在可以使用`:e main.go`体验一下开发Go的乐趣。 - - -## Emacs -Emacs传说中的神器，她不仅仅是一个编辑器，它是一个整合环境，或可称它为集成开发环境，这些功能如让使用者置身于全功能的操作系统中。 - - ![](images/1.4.emacs.png?raw=true) - - 1. 配置Emacs高亮显示 - - cp $GOROOT/misc/emacs/* ~/.emacs.d/ - - 2. 安装[Gocode](https://github.com/nsf/gocode/) - - go get -u github.com/nsf/gocode - - gocode默认安装到`$GOPATH/bin`里面下面，需要把`$GOPATH/bin`路径设置到系统`$PATH`里面。 - - 3. 配置[Gocode](https://github.com/nsf/gocode/) - - - ~ cd $GOPATH/src/github.com/nsf/gocode/emacs - ~ cp go-autocomplete.el ~/.emacs.d/ - ~ gocode set propose-builtins true - propose-builtins true - ~ gocode set lib-path "/home/border/gocode/pkg/linux_amd64" // 换为你自己的路径 - lib-path "/home/border/gocode/pkg/linux_amd64" - ~ gocode set - propose-builtins true - lib-path "/home/border/gocode/pkg/linux_amd64" - - 4. 需要安装 [Auto Completion](http://www.emacswiki.org/emacs/AutoComplete) - - 下载AutoComplete并解压 - - ~ make install DIR=$HOME/.emacs.d/auto-complete - - 配置~/.emacs文件 - - ;;auto-complete - (require 'auto-complete-config) - (add-to-list 'ac-dictionary-directories "~/.emacs.d/auto-complete/ac-dict") - (ac-config-default) - (local-set-key (kbd "M-/") 'semantic-complete-analyze-inline) - (local-set-key "." 'semantic-complete-self-insert) - (local-set-key ">" 'semantic-complete-self-insert) - - 详细信息参考: http://www.emacswiki.org/emacs/AutoComplete - - 5. 配置.emacs - - ;; golang mode - (require 'go-mode-load) - (require 'go-autocomplete) - ;; speedbar - ;; (speedbar 1) - (speedbar-add-supported-extension ".go") - (add-hook - 'go-mode-hook - '(lambda () - ;; gocode - (auto-complete-mode 1) - (setq ac-sources '(ac-source-go)) - ;; Imenu & Speedbar - (setq imenu-generic-expression - '(("type" "^type *\\([^ \t\n\r\f]*\\)" 1) - ("func" "^func *\\(.*\\) {" 1))) - (imenu-add-to-menubar "Index") - ;; Outline mode - (make-local-variable 'outline-regexp) - (setq outline-regexp "//\\.\\|//[^\r\n\f][^\r\n\f]\\|pack\\|func\\|impo\\|cons\\|var.\\|type\\|\t\t*....") - (outline-minor-mode 1) - (local-set-key "\M-a" 'outline-previous-visible-heading) - (local-set-key "\M-e" 'outline-next-visible-heading) - ;; Menu bar - (require 'easymenu) - (defconst go-hooked-menu - '("Go tools" - ["Go run buffer" go t] - ["Go reformat buffer" go-fmt-buffer t] - ["Go check buffer" go-fix-buffer t])) - (easy-menu-define - go-added-menu - (current-local-map) - "Go tools" - go-hooked-menu) - - ;; Other - (setq show-trailing-whitespace t) - )) - ;; helper function - (defun go () - "run current buffer" - (interactive) - (compile (concat "go run " (buffer-file-name)))) - - ;; helper function - (defun go-fmt-buffer () - "run gofmt on current buffer" - (interactive) - (if buffer-read-only - (progn - (ding) - (message "Buffer is read only")) - (let ((p (line-number-at-pos)) - (filename (buffer-file-name)) - (old-max-mini-window-height max-mini-window-height)) - (show-all) - (if (get-buffer "*Go Reformat Errors*") - (progn - (delete-windows-on "*Go Reformat Errors*") - (kill-buffer "*Go Reformat Errors*"))) - (setq max-mini-window-height 1) - (if (= 0 (shell-command-on-region (point-min) (point-max) "gofmt" "*Go Reformat Output*" nil "*Go Reformat Errors*" t)) - (progn - (erase-buffer) - (insert-buffer-substring "*Go Reformat Output*") - (goto-char (point-min)) - (forward-line (1- p))) - (with-current-buffer "*Go Reformat Errors*" - (progn - (goto-char (point-min)) - (while (re-search-forward "" nil t) - (replace-match filename)) - (goto-char (point-min)) - (compilation-mode)))) - (setq max-mini-window-height old-max-mini-window-height) - (delete-windows-on "*Go Reformat Output*") - (kill-buffer "*Go Reformat Output*")))) - ;; helper function - (defun go-fix-buffer () - "run gofix on current buffer" - (interactive) - (show-all) - (shell-command-on-region (point-min) (point-max) "go tool fix -diff")) - - 6. 恭喜你，你现在可以体验在神器中开发Go的乐趣。默认speedbar是关闭的，如果打开需要把 ;; (speedbar 1) 前面的注释去掉，或者也可以通过 *M-x speedbar* 手动开启。 - -## Eclipse -Eclipse也是非常常用的开发利器，以下介绍如何使用Eclipse来编写Go程序。 - - ![](images/1.4.eclipse1.png?raw=true) - - 1.首先下载并安装好[Eclipse](http://www.eclipse.org/) - - 2.下载[goeclipse](https://code.google.com/p/goclipse/)插件 - - http://code.google.com/p/goclipse/wiki/InstallationInstructions - - 3.下载gocode，用于go的代码补全提示 - -gocode的github地址： - - https://github.com/nsf/gocode - -在windows下要安装git，通常用[msysgit](https://code.google.com/p/msysgit/) - -再在cmd下安装： - - go get -u github.com/nsf/gocode - -也可以下载代码，直接用go build来编译，会生成gocode.exe - - 4.下载[MinGW](http://sourceforge.net/projects/mingw/files/MinGW/)并按要求装好 - - 5.配置插件 - - Windows->Reference->Go - - (1).配置Go的编译器 - - ![](images/1.4.eclipse2.png?raw=true) - - (2).配置Gocode（可选，代码补全），设置Gocode路径为之前生成的gocode.exe文件 - - ![](images/1.4.eclipse3.png?raw=true) - - (3).配置GDB（可选，做调试用），设置GDB路径为MingW安装目录下的gdb.exe文件 - - ![](images/1.4.eclipse4.png?raw=true) - - 6.测试是否成功 - -新建一个go工程，再建立一个hello.go。如下图： - - ![](images/1.4.eclipse5.png?raw=true) - -调试如下（要在console中用输入命令来调试）： - - ![](images/1.4.eclipse6.png?raw=true) - - -## links - * [目录]() - * 上一节: [Go 命令](<1.3.md>) - * 下一节: [总结](<1.5.md>) +# 1.4 Go开发工具 + +本节我将介绍几个开发工具，它们都具有自动化提示，自动化fmt功能。因为它们都是跨平台的，所以安装步骤之类的都是通用的。 + +## LiteIDE + + LiteIDE是一款专门为Go语言开发的集成开发环境（IDE），由visualfc编写。支持项目管理、集成构建、GDB调试、语法高亮、自动补全、大纲显示等功能。下载地址: [http://code.google.com/p/golangide/downloads/list](http://code.google.com/p/golangide/downloads/list)，根据自己的系统下载相应的发行版本。Windows和Ubuntu系统可直接打开bin下面的liteide；Mac则需通过LaunchPad打开LiteIDE.app。 + + ![](images/1.4.liteide.png?raw=true) + + LiteIDE配置需要按照前面几个小节配置了相应的go和`$GOPATH`（LiteIDE中也可以图形化配置LiteIDE专用的GOPATH）。LiteIDE当前的编译环境可以通过编译工具栏上的环境配置来切换，如切换32位和64位，针对自己的系统，可能需要修改相应的LiteEnv环境变量，如64位版本，LiteIDE => 查看 => 选项 => LiteEnv => Win64.env => GOROOT=c:\go-w64 为你的`$GOROOT`，不然会无法使用`build`命令。 + + 配置好LiteIDE后，可以打开或拖动任何目录到LiteIDE中作为项目，LiteIDE的编译是针对当前编辑文档所属目录来执行相应的go命令，所以编译时要先打开相应的Go文件。LiteIDE仿IDEA界面，支持项目浏览、文件系统，Package浏览、Golang文档检索、类视图、大纲显示等多个工具窗口的切换。 + + 代码补全需要安装gocode: + + go get github.com/nsf/gocode + + +## Sublime Text + + 这里将介绍Sublime Text 2（以下简称Sublime）+GoSublime+gocode+MarGo的组合，那么为什么选择这个组合呢？ + + - 自动化提示代码,如下图所示 + ![](images/1.4.sublime1.png?raw=true) + + - 保存的时候自动格式化代码，让您编写的代码更加美观，符合Go的标准。 + - 支持项目管理 + ![](images/1.4.sublime2.png?raw=true) + - 支持语法高亮 + - Sublime Text 2可免费使用，只是保存次数达到一定数量之后就会提示是否购买，点击取消继续用，和正式注册版本没有任何区别。 + + 接下来就开始讲如何安装，下载[Sublime](http://www.sublimetext.com/) + + 根据自己相应的系统下载相应的版本，然后打开Sublime，对于不熟悉Sublime的同学可以先看一下这篇文章[Sublime Text 2 入门及技巧](http://lucifr.com/139225/sublime-text-2-tricks-and-tips/) + + 1. 打开之后安装 Package Control：Ctrl+` 打开命令行，执行如下代码： + + import urllib2,os; pf='Package Control.sublime-package'; ipp=sublime.installed_packages_path(); os.makedirs(ipp) if not os.path.exists(ipp) else None; urllib2.install_opener(urllib2.build_opener(urllib2.ProxyHandler())); open(os.path.join(ipp,pf),'wb').write(urllib2.urlopen('http://sublime.wbond.net/'+pf.replace(' ','%20')).read()); print 'Please restart Sublime Text to finish installation' + + 这个时候重启一下Sublime，可以发现在在菜单栏多了一个如下的栏目，说明Package Control已经安装成功了。 + + ![](images/1.4.sublime3.png?raw=true) + + 2. 接下来安装gocode和MarGo。 + 打开终端运行如下代码（需要git） + + go get github.com/nsf/gocode + go get github.com/DisposaBoy/MarGo + + 这个时候我们会发现在`$GOPATH/bin`下面多了两个可执行文件，gocode和MarGo，这两个文件会在GoSublime加载时自动启动。 + + 3. 安装完之后就可以安装Sublime的插件了。需安装GoSublime、SidebarEnhancements和Go Build，安装插件之后记得重启Sublime生效，Ctrl+Shift+p打开Package Controll 输入`pcip`（即“Package Control: Install Package”的缩写）。 + + 这个时候看左下角显示正在读取包数据，完成之后出现如下界面 + + ![](images/1.4.sublime4.png?raw=true) + + 这个时候输入GoSublime，按确定就开始安装了。同理应用于SidebarEnhancements和Go Build。 + + 4. 验证是否安装成功，你可以打开Sublime，打开main.go，看看语法是不是高亮了，输入`import`是不是自动化提示了，`import "fmt"`之后，输入`fmt.`是不是自动化提示有函数了。 + + 如果已经出现这个提示，那说明你已经安装完成了，并且完成了自动提示。 + + 如果没有出现这样的提示，一般就是你的`$PATH`没有配置正确。你可以打开终端，输入gocode，是不是能够正确运行，如果不行就说明`$PATH`没有配置正确。 + + +## Vim +Vim是从vi发展出来的一个文本编辑器, 代码补全、编译及错误跳转等方便编程的功能特别丰富，在程序员中被广泛使用。 + + ![](images/1.4.vim.png?raw=true) + + 1. 配置vim高亮显示 + + cp -r $GOROOT/misc/vim/* ~/.vim/ + + 2. 在~/.vimrc文件中增加语法高亮显示 + + filetype plugin indent on + syntax on + + 3. 安装[Gocode](https://github.com/nsf/gocode/) + + go get -u github.com/nsf/gocode + + gocode默认安装到`$GOPATH/bin`下面，需要把`$GOPATH/bin`路径设置到系统`$PATH`里面。 + + 4. 配置[Gocode](https://github.com/nsf/gocode/) + + ~ cd $GOPATH/src/github.com/nsf/gocode/vim + ~ ./update.bash + ~ gocode set propose-builtins true + propose-builtins true + ~ gocode set lib-path "/home/border/gocode/pkg/linux_amd64" + lib-path "/home/border/gocode/pkg/linux_amd64" + ~ gocode set + propose-builtins true + lib-path "/home/border/gocode/pkg/linux_amd64" + +>gocode set里面的两个参数的含意说明： +> +>propose-builtins：是否自动提示Go的内置函数、类型和常量，默认为false，不提示。 +> +>lib-path:默认情况下，gocode只会搜索**$GOPATH/pkg/$GOOS_$GOARCH** 和 **$GOROOT/pkg/$GOOS_$GOARCH**目录下的包，当然这个设置就是可以设置我们额外的lib能访问的路径 + + + + 5. 恭喜你，安装完成，你现在可以使用`:e main.go`体验一下开发Go的乐趣。 + + +## Emacs +Emacs传说中的神器，她不仅仅是一个编辑器，它是一个整合环境，或可称它为集成开发环境，这些功能如让使用者置身于全功能的操作系统中。 + + ![](images/1.4.emacs.png?raw=true) + + 1. 配置Emacs高亮显示 + + cp $GOROOT/misc/emacs/* ~/.emacs.d/ + + 2. 安装[Gocode](https://github.com/nsf/gocode/) + + go get -u github.com/nsf/gocode + + gocode默认安装到`$GOPATH/bin`里面下面，需要把`$GOPATH/bin`路径设置到系统`$PATH`里面。 + + 3. 配置[Gocode](https://github.com/nsf/gocode/) + + + ~ cd $GOPATH/src/github.com/nsf/gocode/emacs + ~ cp go-autocomplete.el ~/.emacs.d/ + ~ gocode set propose-builtins true + propose-builtins true + ~ gocode set lib-path "/home/border/gocode/pkg/linux_amd64" // 换为你自己的路径 + lib-path "/home/border/gocode/pkg/linux_amd64" + ~ gocode set + propose-builtins true + lib-path "/home/border/gocode/pkg/linux_amd64" + + 4. 需要安装 [Auto Completion](http://www.emacswiki.org/emacs/AutoComplete) + + 下载AutoComplete并解压 + + ~ make install DIR=$HOME/.emacs.d/auto-complete + + 配置~/.emacs文件 + + ;;auto-complete + (require 'auto-complete-config) + (add-to-list 'ac-dictionary-directories "~/.emacs.d/auto-complete/ac-dict") + (ac-config-default) + (local-set-key (kbd "M-/") 'semantic-complete-analyze-inline) + (local-set-key "." 'semantic-complete-self-insert) + (local-set-key ">" 'semantic-complete-self-insert) + + 详细信息参考: http://www.emacswiki.org/emacs/AutoComplete + + 5. 配置.emacs + + ;; golang mode + (require 'go-mode-load) + (require 'go-autocomplete) + ;; speedbar + ;; (speedbar 1) + (speedbar-add-supported-extension ".go") + (add-hook + 'go-mode-hook + '(lambda () + ;; gocode + (auto-complete-mode 1) + (setq ac-sources '(ac-source-go)) + ;; Imenu & Speedbar + (setq imenu-generic-expression + '(("type" "^type *\\([^ \t\n\r\f]*\\)" 1) + ("func" "^func *\\(.*\\) {" 1))) + (imenu-add-to-menubar "Index") + ;; Outline mode + (make-local-variable 'outline-regexp) + (setq outline-regexp "//\\.\\|//[^\r\n\f][^\r\n\f]\\|pack\\|func\\|impo\\|cons\\|var.\\|type\\|\t\t*....") + (outline-minor-mode 1) + (local-set-key "\M-a" 'outline-previous-visible-heading) + (local-set-key "\M-e" 'outline-next-visible-heading) + ;; Menu bar + (require 'easymenu) + (defconst go-hooked-menu + '("Go tools" + ["Go run buffer" go t] + ["Go reformat buffer" go-fmt-buffer t] + ["Go check buffer" go-fix-buffer t])) + (easy-menu-define + go-added-menu + (current-local-map) + "Go tools" + go-hooked-menu) + + ;; Other + (setq show-trailing-whitespace t) + )) + ;; helper function + (defun go () + "run current buffer" + (interactive) + (compile (concat "go run " (buffer-file-name)))) + + ;; helper function + (defun go-fmt-buffer () + "run gofmt on current buffer" + (interactive) + (if buffer-read-only + (progn + (ding) + (message "Buffer is read only")) + (let ((p (line-number-at-pos)) + (filename (buffer-file-name)) + (old-max-mini-window-height max-mini-window-height)) + (show-all) + (if (get-buffer "*Go Reformat Errors*") + (progn + (delete-windows-on "*Go Reformat Errors*") + (kill-buffer "*Go Reformat Errors*"))) + (setq max-mini-window-height 1) + (if (= 0 (shell-command-on-region (point-min) (point-max) "gofmt" "*Go Reformat Output*" nil "*Go Reformat Errors*" t)) + (progn + (erase-buffer) + (insert-buffer-substring "*Go Reformat Output*") + (goto-char (point-min)) + (forward-line (1- p))) + (with-current-buffer "*Go Reformat Errors*" + (progn + (goto-char (point-min)) + (while (re-search-forward "" nil t) + (replace-match filename)) + (goto-char (point-min)) + (compilation-mode)))) + (setq max-mini-window-height old-max-mini-window-height) + (delete-windows-on "*Go Reformat Output*") + (kill-buffer "*Go Reformat Output*")))) + ;; helper function + (defun go-fix-buffer () + "run gofix on current buffer" + (interactive) + (show-all) + (shell-command-on-region (point-min) (point-max) "go tool fix -diff")) + + 6. 恭喜你，你现在可以体验在神器中开发Go的乐趣。默认speedbar是关闭的，如果打开需要把 ;; (speedbar 1) 前面的注释去掉，或者也可以通过 *M-x speedbar* 手动开启。 + +## Eclipse +Eclipse也是非常常用的开发利器，以下介绍如何使用Eclipse来编写Go程序。 + + ![](images/1.4.eclipse1.png?raw=true) + + 1.首先下载并安装好[Eclipse](http://www.eclipse.org/) + + 2.下载[goeclipse](https://code.google.com/p/goclipse/)插件 + + http://code.google.com/p/goclipse/wiki/InstallationInstructions + + 3.下载gocode，用于go的代码补全提示 + +gocode的github地址： + + https://github.com/nsf/gocode + +在windows下要安装git，通常用[msysgit](https://code.google.com/p/msysgit/) + +再在cmd下安装： + + go get -u github.com/nsf/gocode + +也可以下载代码，直接用go build来编译，会生成gocode.exe + + 4.下载[MinGW](http://sourceforge.net/projects/mingw/files/MinGW/)并按要求装好 + + 5.配置插件 + + Windows->Reference->Go + + (1).配置Go的编译器 + + ![](images/1.4.eclipse2.png?raw=true) + + (2).配置Gocode（可选，代码补全），设置Gocode路径为之前生成的gocode.exe文件 + + ![](images/1.4.eclipse3.png?raw=true) + + (3).配置GDB（可选，做调试用），设置GDB路径为MingW安装目录下的gdb.exe文件 + + ![](images/1.4.eclipse4.png?raw=true) + + 6.测试是否成功 + +新建一个go工程，再建立一个hello.go。如下图： + + ![](images/1.4.eclipse5.png?raw=true) + +调试如下（要在console中用输入命令来调试）： + + ![](images/1.4.eclipse6.png?raw=true) + + +## links + * [目录]() + * 上一节: [Go 命令](<1.3.md>) + * 下一节: [总结](<1.5.md>) From 6fa49599107855827781e14bbcce0c15354ab8fc Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Mon, 12 Nov 2012 22:29:44 +0800 Subject: [PATCH 03/49] =?UTF-8?q?=E5=AE=8C=E6=88=90=E4=BA=86=E6=97=A5?= =?UTF-8?q?=E5=BF=97=E7=9A=84=E4=B9=A6=E5=86=99=EF=BC=8C=E9=94=99=E8=AF=AF?= =?UTF-8?q?=E5=A4=84=E7=90=86=E8=B5=B7=E4=BA=86=E4=B8=80=E4=B8=AA=E5=A4=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 12.1.md | 152 +++++++++++++++++++++++++++++++++++++++++++++++++++++++- 12.2.md | 13 +++++ 2 files changed, 164 insertions(+), 1 deletion(-) diff --git a/12.1.md b/12.1.md index 13cf8579..79992397 100644 --- a/12.1.md +++ b/12.1.md @@ -2,12 +2,162 @@ 我们期望开发的Web应用程序能够把整个程序运行过程中出现的各种事件一一记录下来，Go语言中提供了一个简易的log包，我们使用该包可以方便的实现日志记录的功能，这些日志都是基本的给予fmt包的打印再结合panic之类的一些函数来处理我们一般的打印抛出错误之类的。如果我们想把我们的应用日志保存到文件，然后又能够结合日志实现很多复杂的功能，编写过Java或者C++的读者应该都使用过log4j和log4cpp之类的日志工具，Go目前标准包就如前面介绍的只是包含了一个简单的包，但是目前第三方开发的一个日志系统实现了很强大的日志功能，`https://github.com/cihub/seelog`，接下来我们介绍如何该日志系统来实现我们应用的日志功能。 ## seelog介绍 +seelog是用Go语言实现的一个日志系统，他提供了一些简单的函数来实现复杂的日志分配、过滤和格式化。他主要有如下特性： +- XML配置文件，可以不用重新编译程序而动态的加载配置信息 +- 能够动态改变配置而不需要重启应用 +- 能够同时把日志输出到多种流中 +- 支持不同的日志输出 + + - 命令行输出 + - 文件输出 + - 缓存输出 + - 支持log rotate + - SMTP邮件 + +上面介绍的只是部分特性，其他seelog是一个特别强大的日志处理系统，详细的可以参考官方网站的wiki。接下来介绍一下如何在项目中使用： + +首先安装seelog + + go get -u github.com/cihub/seelog + +然后我们来看一个简单的例子： + + package main + + import log "github.com/cihub/seelog" + + func main() { + defer log.Flush() + log.Info("Hello from Seelog!") + } + +我们编译之后可以正常的输出日志了，说明seelog日志系统已经成功安装并且可以正常运行了。 + +## 基于seelog的自定义日志处理 +seelog支持让我们给予seelog自定义日志处理，下面这个是我目前基于seelog日志系统做的自定义的日志处理包： + + package logs + + import ( + "errors" + "fmt" + seelog "github.com/cihub/seelog" + "io" + ) + + var Logger seelog.LoggerInterface + + func loadAppConfig() { + appConfig := ` + + + + + + + + + + + + + + + + + ` + logger, err := seelog.LoggerFromConfigAsBytes([]byte(appConfig)) + if err != nil { + fmt.Println(err) + return + } + UseLogger(logger) + } + + func init() { + DisableLog() + loadAppConfig() + } + + // DisableLog disables all library log output + func DisableLog() { + Logger = seelog.Disabled + } + + // UseLogger uses a specified seelog.LoggerInterface to output library log. + // Use this func if you are using Seelog logging system in your app. + func UseLogger(newLogger seelog.LoggerInterface) { + Logger = newLogger + } + +上面主要实现了三个函数， + +- `DisableLog` + + 初始化全局变量Logger为目前seelog的禁用状态，主要防止Logger初始化多次 +- `loadAppConfig` + + 根据配置文件初始化seelog的配置信息，这里我们把配置文件通过字符串读取设置好了，当然也可以通过读取XML文件。里面的配置说明如下： + + - seelog + + minlevel可有可无，有的话设置最小级别的日志级别需要记录，还有maxlevel也是类似的原理 + - outputs + + 输出信息到那些地方，这里分成了两个数据，一个记录到log rotate文件里面。第二设置了一个filter，如果这个错误级别是critical，那么发送邮件。 + + - formats + + 定义了各种日志的格式 + +- `UseLogger` + + 设置当前的日志器为相应的日志处理 + +上面我们定义了一个自定义的日志处理包，下面就是使用示例： + + package main + + import ( + "net/http" + "project/logs" + "project/configs" + "project/routes" + ) + + func main() { + addr, _ := configs.MainConfig.String("server", "addr") + logs.Logger.Info("Start server at:%v", addr) + err := http.ListenAndServe(addr, routes.NewMux()) + logs.Logger.Critical("Server err:%v", err) + } ## 发生错误发送邮件 -## 使用应用日志 +上面的例子解释了如何设置发送邮件，我们通过如下的smtp配置用来发送邮件： + + + + +邮件的格式通过criticalemail配置，然后通过其他的配置发送邮件服务器的配置，通过recipient配置接收邮件的用户，如果有多个用户可以再添加一行。 + +要测试这个代码是否正常工作，可以在代码中增加类似下面的一个假消息。不过记住过后要把它删除，否则上线之后就会收到很多垃圾邮件。 + + logs.Logger.Critical("test Critical message") + +现在，只要我们的应用在线上记录一个Critical的信息，你的邮箱就会收到一个Email，这样一旦线上的系统出现问题，你就能立马通过邮件获知，就能及时的进行处理。 +## 使用应用日志 +对于应用日志，每个人的应用场景可能会各不相同，有些人利用应用日志来做数据分析，有些人利用应用日志来做性能分析，有些人来做用户行为分析，还有些就是纯粹的记录方便应用出现问题的时候可以查找问题。 + +举一个例子，我们需要跟踪用户尝试登陆系统的操作。这里会把成功与不成功的尝试都记录下来。记录成功的使用"Info"日志级别，而不成功的使用"warn"级别。如果想查找所有不成功的登陆，我们可以利用linux的grep之类的命令工具，如下： + + # cat /data/logs/roll.log | grep "failed login" + 2012-12-11 11:12:00 WARN : failed login attempt from 11.22.33.44 username password + +通过这种方式我们就可以很方便的查找相应的信息，这样有利于我们针对应用日志做一些统计和分析。另外我们还需要考虑日志的大小，对于一个高流量的Web应用来说，日志的增长是相当可怕的，所以我们在seelog的配置文件里面设置了logrotate，这样就能保证日志文件不会因为不断变大而导致我们的磁盘空间不够引起问题。 ## 小结 +通过上面对seelog系统的介绍，以及如何开发基于seelog的日志处理包，我们现在可以很轻松的就搭建起来一个功能强大的日志处理系统，日志处理系统对于我们的数据分析提供可靠的数据源，通过分析可以进一步优化我们的系统，而且一旦应用出现问题也方便我们查找问题，而同时seelog也提供了调试输出的功能，这样对于开发阶段来说就可以很方便的来调试各种数据，上线的时候通过设置minlevel可以很方便的屏蔽这些调试级别的信息。 ## links * [目录]() diff --git a/12.2.md b/12.2.md index 683cd3ae..3736ebf7 100644 --- a/12.2.md +++ b/12.2.md @@ -1,4 +1,17 @@ # 12.2 网站错误处理 +我们的Web应用一旦上线之后，那么各种错误出现的概率都有，Web应用日常运行中可能出现多种错误，具体如下所示： + +- 数据库错误 +- 应用运行时错误 +- HTTP错误 +- 操作系统出错 +- 网络出错 + +## 错误处理的目标 + +## 如何处理错误 + +## 小结 ## links * [目录]() From 9298e0b9c3b1f2adc2376bc54cad5b4327281e2a Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Tue, 13 Nov 2012 23:27:48 +0800 Subject: [PATCH 04/49] =?UTF-8?q?=E9=94=99=E8=AF=AF=E5=A4=84=E7=90=86?= =?UTF-8?q?=E5=B0=8F=E8=8A=82=E5=AE=8C=E6=88=90=E4=BA=86=E4=B8=80=E9=83=A8?= =?UTF-8?q?=E5=88=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 12.2.md | 24 +++++++++++++++++++----- 1 file changed, 19 insertions(+), 5 deletions(-) diff --git a/12.2.md b/12.2.md index 3736ebf7..32f025f0 100644 --- a/12.2.md +++ b/12.2.md @@ -1,14 +1,28 @@ # 12.2 网站错误处理 我们的Web应用一旦上线之后，那么各种错误出现的概率都有，Web应用日常运行中可能出现多种错误，具体如下所示： -- 数据库错误 -- 应用运行时错误 -- HTTP错误 -- 操作系统出错 -- 网络出错 +- 数据库错误：指与访问数据库服务器或数据相关的错误。例如，以下可能出现的一些数据库错误。 + + - 连接错误：这一类错误可能是数据库服务器网络断开、用户名密码不正确、或者数据库不存在。 + - 查询错误：使用的SQL非法导致错误，这样SQL错误如果程序经过严格的测试应该可以避免。 + - 数据错误：数据库中的约束冲突，例如一个唯一字段中插入一条重复主键的值就会报错，但是如果你的应用程序在上线之前经过了严格的测试也是可以避免这类问题。 +- 应用运行时错误：这类错误范围很广，涵盖了代码中出现的几乎所有错误。可能的应用错误的情况如下： + + - 文件系统和权限：应用读取不存在的文件，或者读取没有权限的文件、或者写入一个不允许写入的文件，这些都会导致一个错误。应用读取的文件如果格式不正确也会报错，例如配置文件应该是ini的配置格式，而设置成了json格式就会报错。 + - 第三方应用：如果我们的应用程序耦合了其他第三方接口程序，例如应用程序发表文章之后自动调用接发微博的接口，所以这个接口必须正常运行才能完成我们发表一篇文章的功能。 + +- HTTP错误：这些错误是根据用户的请求出现的错误，最常见的就是404请求，虽然可能会出现很多不同的错误，但其中比较常见的错误还有401未授权错误(需要认证才能访问的资源)、403禁止错误(不允许用户访问的资源)和503错误(程序内部出错)。 +- 操作系统出错：这类错误都是由于应用程序上的操作系统出现错误引起的，主要有操作系统的资源被分配完了，导致死机，还有操作系统的磁盘满了，导致无法写入，这样就会引起很多错误。 +- 网络出错：指两方便的错误，一方面是用户请求应用程序的时候出现网络断开，这样就导致连接中断，这种错误不会造成应用程序的崩溃，但是会影响用户访问的效果，另一方面是应用程序读取其他网络上的数据，这种网络断开会导致读取失败，这种需要对应用程序做有效的测试，能够避免这类问题出现的情况下程序崩溃。 ## 错误处理的目标 +在实现错误处理之前，我们必须明确错误处理想要达到的目标是什么，错误处理系统应该完成一下工作： +- 通知访问用户出现错误了 +- 记录错误 +- 回滚当前的请求 +- 根据错误级别发送邮件 +- 保证现有程序可运行可服务 ## 如何处理错误 ## 小结 From 820fde30b72f7a4c765c93ea831e68e4267d82b0 Mon Sep 17 00:00:00 2001 From: maxupeng Date: Thu, 15 Nov 2012 21:57:22 +0800 Subject: [PATCH 05/49] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E4=B8=A4=E5=A4=84?= =?UTF-8?q?=E4=B8=8D=E9=80=9A=E9=A1=BA=E7=9A=84=E5=9C=B0=E6=96=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 1.3.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/1.3.md b/1.3.md index cf51e55c..088812df 100644 --- a/1.3.md +++ b/1.3.md @@ -35,7 +35,7 @@ ## go clean - 这个命令是用来移除当前源码包里面编译的文件的。这些文件包括 + 这个命令是用来移除当前源码包里面编译生成的文件。这些文件包括 _obj/ 旧的object目录，由Makefiles遗留 _test/ 旧的test目录，由Makefiles遗留 @@ -48,7 +48,7 @@ DIR.test(.exe) 由go test -c产生 MAINFILE(.exe) 由go build MAINFILE.go产生 - 我一般都是利用这个命令进行清除编译文件，然后github递交源码，在本机测试的时候这些编译文件都是和系统相关的，但是对于源码管理来说没必要 + 我一般都是利用这个命令清除编译文件，然后github递交源码，在本机测试的时候这些编译文件都是和系统相关的，但是对于源码管理来说没必要 ## go fmt From dc05aa3371f4aabf7f7bac1e57d7f917ef1328ae Mon Sep 17 00:00:00 2001 From: maxupeng Date: Thu, 15 Nov 2012 22:33:37 +0800 Subject: [PATCH 06/49] =?UTF-8?q?gocode=E9=BB=98=E8=AE=A4=E5=AE=89?= =?UTF-8?q?=E8=A3=85=E5=9C=A8GOBIN=E7=9B=AE=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 1.4.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/1.4.md b/1.4.md index 99fae557..5b30cb69 100644 --- a/1.4.md +++ b/1.4.md @@ -83,7 +83,7 @@ Vim是从vi发展出来的一个文本编辑器, 代码补全、编译及错误 go get -u github.com/nsf/gocode - gocode默认安装到`$GOPATH/bin`下面，需要把`$GOPATH/bin`路径设置到系统`$PATH`里面。 + gocode默认安装到`$GOBIN`下面。 4. 配置[Gocode](https://github.com/nsf/gocode/) @@ -121,7 +121,7 @@ Emacs传说中的神器，她不仅仅是一个编辑器，它是一个整合环 go get -u github.com/nsf/gocode - gocode默认安装到`$GOPATH/bin`里面下面，需要把`$GOPATH/bin`路径设置到系统`$PATH`里面。 + gocode默认安装到`$GOBIN`里面下面。 3. 配置[Gocode](https://github.com/nsf/gocode/) From 7a90b12e34edf783d48b74e019b9bab49c0e711d Mon Sep 17 00:00:00 2001 From: WangYulong Date: Sun, 18 Nov 2012 21:43:42 +0800 Subject: [PATCH 07/49] =?UTF-8?q?=E6=A0=BC=E5=BC=8F=E8=B0=83=E6=95=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 缺少tab，该行应该为代码而不是正文 --- 5.2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/5.2.md b/5.2.md index cfc2fbe2..82542f4d 100644 --- a/5.2.md +++ b/5.2.md @@ -34,7 +34,7 @@ Go中支持MySQL的驱动目前比较多，有如下几种，有些是支持data 如下示例将示范如何使用database/sql接口对数据库表进行增删改查操作 -package main + package main import ( _ "code.google.com/p/go-mysql-driver/mysql" From a249ee0e768754168ee70710a7092ae2e9d76350 Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Sun, 18 Nov 2012 22:50:03 +0800 Subject: [PATCH 08/49] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E4=BB=A3=E7=A0=81?= =?UTF-8?q?=E7=9A=84=E6=A0=BC=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 2.6.md | 60 +++++++++++++++++++++++++++++----------------------------- 1 file changed, 30 insertions(+), 30 deletions(-) diff --git a/2.6.md b/2.6.md index a4c9b8c7..85f0ed93 100644 --- a/2.6.md +++ b/2.6.md @@ -234,44 +234,44 @@ interface的变量可以持有任意实现该interface类型的对象，这给 让我们通过一个例子来更加深入的理解。 - package main + package main - import ( - "fmt" - "strconv" - ) + import ( + "fmt" + "strconv" + ) - type Element interface{} - type List [] Element + type Element interface{} + type List [] Element - type Person struct { - name string - age int - } + type Person struct { + name string + age int + } - //定义了String方法，实现了fmt.Stringer - func (p Person) String() string { - return "(name: " + p.name + " - age: "+strconv.Itoa(p.age)+ " years)" - } + //定义了String方法，实现了fmt.Stringer + func (p Person) String() string { + return "(name: " + p.name + " - age: "+strconv.Itoa(p.age)+ " years)" + } - func main() { - list := make(List, 3) - list[0] = 1 // an int - list[1] = "Hello" // a string - list[2] = Person{"Dennis", 70} + func main() { + list := make(List, 3) + list[0] = 1 // an int + list[1] = "Hello" // a string + list[2] = Person{"Dennis", 70} - for index, element := range list { - if value, ok := element.(int); ok { - fmt.Printf("list[%d] is an int and its value is %d\n", index, value) - } else if value, ok := element.(string); ok { - fmt.Printf("list[%d] is a string and its value is %s\n", index, value) - } else if value, ok := element.(Person); ok { - fmt.Printf("list[%d] is a Person and its value is %s\n", index, value) - } else { - fmt.Println("list[%d] is of a different type", index) + for index, element := range list { + if value, ok := element.(int); ok { + fmt.Printf("list[%d] is an int and its value is %d\n", index, value) + } else if value, ok := element.(string); ok { + fmt.Printf("list[%d] is a string and its value is %s\n", index, value) + } else if value, ok := element.(Person); ok { + fmt.Printf("list[%d] is a Person and its value is %s\n", index, value) + } else { + fmt.Println("list[%d] is of a different type", index) + } } } - } 是不是很简单啊，同时你是否注意到了多个ifs里面，还记得我前面介绍流程里面讲过，if里面允许初始化变量。 From ef8a74557d6601ad1b32fe8ce21e9668539e1cf6 Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Sun, 18 Nov 2012 22:53:44 +0800 Subject: [PATCH 09/49] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E6=A0=BC=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 2.6.md | 68 +++++++++++++++++++++++++++++----------------------------- 1 file changed, 34 insertions(+), 34 deletions(-) diff --git a/2.6.md b/2.6.md index 85f0ed93..9e748108 100644 --- a/2.6.md +++ b/2.6.md @@ -273,52 +273,52 @@ interface的变量可以持有任意实现该interface类型的对象，这给 } } -是不是很简单啊，同时你是否注意到了多个ifs里面，还记得我前面介绍流程里面讲过，if里面允许初始化变量。 + 是不是很简单啊，同时你是否注意到了多个ifs里面，还记得我前面介绍流程里面讲过，if里面允许初始化变量。 -也许你注意到了，我们断言的类型越多，那么ifelse也就越多，所以才引出了下面要介绍的switch。 + 也许你注意到了，我们断言的类型越多，那么ifelse也就越多，所以才引出了下面要介绍的switch。 - switch测试 -最好的讲解就是代码例子，现在让我们重写上面的这个实现 + 最好的讲解就是代码例子，现在让我们重写上面的这个实现 - package main + package main - import ( - "fmt" - "strconv" - ) + import ( + "fmt" + "strconv" + ) - type Element interface{} - type List [] Element + type Element interface{} + type List [] Element - type Person struct { - name string - age int - } + type Person struct { + name string + age int + } - //打印 - func (p Person) String() string { - return "(name: " + p.name + " - age: "+strconv.Itoa(p.age)+ " years)" - } + //打印 + func (p Person) String() string { + return "(name: " + p.name + " - age: "+strconv.Itoa(p.age)+ " years)" + } - func main() { - list := make(List, 3) - list[0] = 1 //an int - list[1] = "Hello" //a string - list[2] = Person{"Dennis", 70} + func main() { + list := make(List, 3) + list[0] = 1 //an int + list[1] = "Hello" //a string + list[2] = Person{"Dennis", 70} - for index, element := range list{ - switch value := element.(type) { - case int: - fmt.Printf("list[%d] is an int and its value is %d\n", index, value) - case string: - fmt.Printf("list[%d] is a string and its value is %s\n", index, value) - case Person: - fmt.Printf("list[%d] is a Person and its value is %s\n", index, value) - default: - fmt.Println("list[%d] is of a different type", index) + for index, element := range list{ + switch value := element.(type) { + case int: + fmt.Printf("list[%d] is an int and its value is %d\n", index, value) + case string: + fmt.Printf("list[%d] is a string and its value is %s\n", index, value) + case Person: + fmt.Printf("list[%d] is a Person and its value is %s\n", index, value) + default: + fmt.Println("list[%d] is of a different type", index) + } } } - } 这里有一点需要强调的是：`element.(type)`语法不能在switch外的任何逻辑里面使用，如果你要在switch外面判断一个类型就使用`comma-ok`。 From e865cc609bb1842f20c241be4996a164ee355b89 Mon Sep 17 00:00:00 2001 From: astaxie Date: Mon, 19 Nov 2012 14:48:53 +0800 Subject: [PATCH 10/49] =?UTF-8?q?review=20by=20=E5=9B=9B=E6=9C=88=E4=BB=BD?= =?UTF-8?q?=E5=B9=B3=E6=B0=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 11.3.md | 9 +- 12.1.md | 329 ++++++++++++++++++++++++++++---------------------------- 2 files changed, 169 insertions(+), 169 deletions(-) diff --git a/11.3.md b/11.3.md index 639437b7..45ee14e4 100644 --- a/11.3.md +++ b/11.3.md @@ -27,7 +27,6 @@ Go语言中自带有一个轻量级的测试框架`testing`和自带的`go test` 2. gotest_test.go:这是我们的单元测试文件，但是记住下面的这些原则： - 文件名必须是`_test.go`结尾的，这样在执行`go test`的时候才会执行到相应的代码 - - 包名必须和被测试文件的包名一致，例如上面的包名是gotest，那么test文件的包名也必须是gotest - 你必须import `testing`这个包 - 所有的测试用例函数必须是`Test`开头 - 测试用例会按照源代码中写的顺序依次执行 @@ -94,14 +93,14 @@ Go语言中自带有一个轻量级的测试框架`testing`和自带的`go test` ok gotest 0.013s ## 如何编写压力测试 -压力测试是用来检测我们写的函数是否有足够好的性能，和写单元功能测试类似，需要注意以下几点： +压力测试用来检测函数(方法）的性能，和编写单元功能测试的方法类似,此处不再赘述，但需要注意以下几点： -- 压力测试函数必须如下格式，其中`XXX`可以是任意字母数字的组合，但是首字母不能是小写字母 +- 压力测试用例必须遵循如下格式，其中XXX可以是任意字母数字的组合，但是首字母不能是小写字母 func BenchmarkXXX(b *testing.B) { ... } - `go test`不会默认执行压力测试的函数，如果要执行压力测试需要带上参数`-test.bench`，语法:`-test.bench="test_name_regex"`,例如`go test -test.bench=".*"`表示测试全部的压力测试函数 -- 压力测试函数中记得在循环中使用`testing.B.N`从而使得压力测试可以正常的运行 +- 在压力测试用例中,请记得在循环体内使用`testing.B.N`,以使测试可以正常的运行 - 文件名也必须以`_test.go`结尾 下面我们新建一个压力测试文件webbench_test.go，代码如下所示： @@ -141,7 +140,7 @@ Go语言中自带有一个轻量级的测试框架`testing`和自带的`go test` 上面的结果显示我们没有执行任何`TestXXX`的单元测试函数，显示的结果只执行了压力测试函数，第一条显示了`Benchmark_Division`执行了500000000次，每次的执行平均时间是7.76纳秒，第二条显示了`Benchmark_TimeConsumingFunction`执行了500000000，每次的平均执行时间是7.80纳秒。最后一条显示总过的执行时间。 ## 小结 -通过上面对单元测试和压力测试的编写，我们知道Go语言里面的`testing`包虽然轻量，但是编写测试用例和压力测试非常简单，而且使用内置的命令`go test`就可以非常方便的执行这些单元测试和压力测试，这样我们每次修改完函数执行一下单元测试和压力测试，可以简单的做回归测试。 +通过上面对单元测试和压力测试的学习，我们可以看到`testing`包很轻量，编写单元测试和压力测试用例非常简单，配合内置的`go test`命令就可以非常方便的进行测试，这样在我们每次修改完代码,执行一下go test就可以简单的完成回归测试了。 ## links diff --git a/12.1.md b/12.1.md index 79992397..ffeea4b9 100644 --- a/12.1.md +++ b/12.1.md @@ -1,165 +1,166 @@ -# 12.1 应用日志 -我们期望开发的Web应用程序能够把整个程序运行过程中出现的各种事件一一记录下来，Go语言中提供了一个简易的log包，我们使用该包可以方便的实现日志记录的功能，这些日志都是基本的给予fmt包的打印再结合panic之类的一些函数来处理我们一般的打印抛出错误之类的。如果我们想把我们的应用日志保存到文件，然后又能够结合日志实现很多复杂的功能，编写过Java或者C++的读者应该都使用过log4j和log4cpp之类的日志工具，Go目前标准包就如前面介绍的只是包含了一个简单的包，但是目前第三方开发的一个日志系统实现了很强大的日志功能，`https://github.com/cihub/seelog`，接下来我们介绍如何该日志系统来实现我们应用的日志功能。 - -## seelog介绍 -seelog是用Go语言实现的一个日志系统，他提供了一些简单的函数来实现复杂的日志分配、过滤和格式化。他主要有如下特性： - -- XML配置文件，可以不用重新编译程序而动态的加载配置信息 -- 能够动态改变配置而不需要重启应用 -- 能够同时把日志输出到多种流中 -- 支持不同的日志输出 - - - 命令行输出 - - 文件输出 - - 缓存输出 - - 支持log rotate - - SMTP邮件 - -上面介绍的只是部分特性，其他seelog是一个特别强大的日志处理系统，详细的可以参考官方网站的wiki。接下来介绍一下如何在项目中使用： - -首先安装seelog - - go get -u github.com/cihub/seelog - -然后我们来看一个简单的例子： - - package main - - import log "github.com/cihub/seelog" - - func main() { - defer log.Flush() - log.Info("Hello from Seelog!") - } - -我们编译之后可以正常的输出日志了，说明seelog日志系统已经成功安装并且可以正常运行了。 - -## 基于seelog的自定义日志处理 -seelog支持让我们给予seelog自定义日志处理，下面这个是我目前基于seelog日志系统做的自定义的日志处理包： - - package logs - - import ( - "errors" - "fmt" - seelog "github.com/cihub/seelog" - "io" - ) - - var Logger seelog.LoggerInterface - - func loadAppConfig() { - appConfig := ` - - - - - - - - - - - - - - - - - ` - logger, err := seelog.LoggerFromConfigAsBytes([]byte(appConfig)) - if err != nil { - fmt.Println(err) - return - } - UseLogger(logger) - } - - func init() { - DisableLog() - loadAppConfig() - } - - // DisableLog disables all library log output - func DisableLog() { - Logger = seelog.Disabled - } - - // UseLogger uses a specified seelog.LoggerInterface to output library log. - // Use this func if you are using Seelog logging system in your app. - func UseLogger(newLogger seelog.LoggerInterface) { - Logger = newLogger - } - -上面主要实现了三个函数， - -- `DisableLog` - - 初始化全局变量Logger为目前seelog的禁用状态，主要防止Logger初始化多次 -- `loadAppConfig` - - 根据配置文件初始化seelog的配置信息，这里我们把配置文件通过字符串读取设置好了，当然也可以通过读取XML文件。里面的配置说明如下： - - - seelog - - minlevel可有可无，有的话设置最小级别的日志级别需要记录，还有maxlevel也是类似的原理 - - outputs - - 输出信息到那些地方，这里分成了两个数据，一个记录到log rotate文件里面。第二设置了一个filter，如果这个错误级别是critical，那么发送邮件。 - - - formats - - 定义了各种日志的格式 - -- `UseLogger` - - 设置当前的日志器为相应的日志处理 - -上面我们定义了一个自定义的日志处理包，下面就是使用示例： - - package main - - import ( - "net/http" - "project/logs" - "project/configs" - "project/routes" - ) - - func main() { - addr, _ := configs.MainConfig.String("server", "addr") - logs.Logger.Info("Start server at:%v", addr) - err := http.ListenAndServe(addr, routes.NewMux()) - logs.Logger.Critical("Server err:%v", err) - } - -## 发生错误发送邮件 -上面的例子解释了如何设置发送邮件，我们通过如下的smtp配置用来发送邮件： - - - - - -邮件的格式通过criticalemail配置，然后通过其他的配置发送邮件服务器的配置，通过recipient配置接收邮件的用户，如果有多个用户可以再添加一行。 - -要测试这个代码是否正常工作，可以在代码中增加类似下面的一个假消息。不过记住过后要把它删除，否则上线之后就会收到很多垃圾邮件。 - - logs.Logger.Critical("test Critical message") - -现在，只要我们的应用在线上记录一个Critical的信息，你的邮箱就会收到一个Email，这样一旦线上的系统出现问题，你就能立马通过邮件获知，就能及时的进行处理。 -## 使用应用日志 -对于应用日志，每个人的应用场景可能会各不相同，有些人利用应用日志来做数据分析，有些人利用应用日志来做性能分析，有些人来做用户行为分析，还有些就是纯粹的记录方便应用出现问题的时候可以查找问题。 - -举一个例子，我们需要跟踪用户尝试登陆系统的操作。这里会把成功与不成功的尝试都记录下来。记录成功的使用"Info"日志级别，而不成功的使用"warn"级别。如果想查找所有不成功的登陆，我们可以利用linux的grep之类的命令工具，如下： - - # cat /data/logs/roll.log | grep "failed login" - 2012-12-11 11:12:00 WARN : failed login attempt from 11.22.33.44 username password - -通过这种方式我们就可以很方便的查找相应的信息，这样有利于我们针对应用日志做一些统计和分析。另外我们还需要考虑日志的大小，对于一个高流量的Web应用来说，日志的增长是相当可怕的，所以我们在seelog的配置文件里面设置了logrotate，这样就能保证日志文件不会因为不断变大而导致我们的磁盘空间不够引起问题。 -## 小结 -通过上面对seelog系统的介绍，以及如何开发基于seelog的日志处理包，我们现在可以很轻松的就搭建起来一个功能强大的日志处理系统，日志处理系统对于我们的数据分析提供可靠的数据源，通过分析可以进一步优化我们的系统，而且一旦应用出现问题也方便我们查找问题，而同时seelog也提供了调试输出的功能，这样对于开发阶段来说就可以很方便的来调试各种数据，上线的时候通过设置minlevel可以很方便的屏蔽这些调试级别的信息。 - -## links - * [目录]() - * 上一章: [部署与维护](<12.md>) +# 12.1 应用日志 +我们期望开发的Web应用程序能够把整个程序运行过程中出现的各种事件一一记录下来，Go语言中提供了一个简易的log包，我们使用该包可以方便的实现日志记录的功能，这些日志都是基本的给予fmt包的打印再结合panic之类的一些函数来处理我们一般的打印抛出错误之类的。如果我们想把我们的应用日志保存到文件，然后又能够结合日志实现很多复杂的功能，编写过Java或者C++的读者应该都使用过log4j和log4cpp之类的日志工具，Go目前标准包就如前面介绍的只是包含了一个简单的包，但是目前第三方开发的一个日志系统实现了很强大的日志功能，`https://github.com/cihub/seelog`，接下来我们介绍如何该日志系统来实现我们应用的日志功能。 + +## seelog介绍 +seelog是用Go语言实现的一个日志系统，它提供了一些简单的函数来实现复杂的日志分配、过滤和格式化。主要有如下特性： + +- XML的动态配置，可以不用重新编译程序而动态的加载配置信息 +- 支持热更新，能够动态改变配置而不需要重启应用 +- 支持多输出流，能够同时把日志输出到多种流中、例如文件流、网络流等 +- 支持不同的日志输出 + + - 命令行输出 + - 文件输出 + - 缓存输出 + - 支持log rotate + - SMTP邮件 + +上面只列举了部分特性，seelog是一个特别强大的日志处理系统，详细的内容请参看官方wiki。接下来我将简要介绍一下如何在项目中使用它： + +首先安装seelog + + go get -u github.com/cihub/seelog + +然后我们来看一个简单的例子： + + package main + + import log "github.com/cihub/seelog" + + func main() { + defer log.Flush() + log.Info("Hello from Seelog!") + } + +编译后运行如果出现了`Hello from seelog`，说明seelog日志系统已经成功安装并且可以正常运行了。 + +## 基于seelog的自定义日志处理 +seelog支持自定义日志处理，下面是我基于它自定义的日志处理包的部分内容： + + package logs + + import ( + "errors" + "fmt" + seelog "github.com/cihub/seelog" + "io" + ) + + var Logger seelog.LoggerInterface + + func loadAppConfig() { + appConfig := ` + + + + + + + + + + + + + + + + + ` + logger, err := seelog.LoggerFromConfigAsBytes([]byte(appConfig)) + if err != nil { + fmt.Println(err) + return + } + UseLogger(logger) + } + + func init() { + DisableLog() + loadAppConfig() + } + + // DisableLog disables all library log output + func DisableLog() { + Logger = seelog.Disabled + } + + // UseLogger uses a specified seelog.LoggerInterface to output library log. + // Use this func if you are using Seelog logging system in your app. + func UseLogger(newLogger seelog.LoggerInterface) { + Logger = newLogger + } + +上面主要实现了三个函数， + +- `DisableLog` + + 初始化全局变量Logger为seelog的禁用状态，主要为了防止Logger被多次初始化 +- `loadAppConfig` + + 根据配置文件初始化seelog的配置信息，这里我们把配置文件通过字符串读取设置好了，当然也可以通过读取XML文件。里面的配置说明如下： + + - seelog + + minlevel参数可选，如果被配置,高于或等于此级别的日志会被记录，同理maxlevel。 + - outputs + + 输出信息的目的地，这里分成了两份数据，一份记录到log rotate文件里面。另一份设置了filter，如果这个错误级别是critical，那么将发送报警邮件。 + + - formats + + 定义了各种日志的格式 + +- `UseLogger` + + 设置当前的日志器为相应的日志处理 + +上面我们定义了一个自定义的日志处理包，下面就是使用示例： + + package main + + import ( + "net/http" + "project/logs" + "project/configs" + "project/routes" + ) + + func main() { + addr, _ := configs.MainConfig.String("server", "addr") + logs.Logger.Info("Start server at:%v", addr) + err := http.ListenAndServe(addr, routes.NewMux()) + logs.Logger.Critical("Server err:%v", err) + } + +## 发生错误发送邮件 +上面的例子解释了如何设置发送邮件，我们通过如下的smtp配置用来发送邮件： + + + + + +邮件的格式通过criticalemail配置，然后通过其他的配置发送邮件服务器的配置，通过recipient配置接收邮件的用户，如果有多个用户可以再添加一行。 + +要测试这个代码是否正常工作，可以在代码中增加类似下面的一个假消息。不过记住过后要把它删除，否则上线之后就会收到很多垃圾邮件。 + + logs.Logger.Critical("test Critical message") + +现在，只要我们的应用在线上记录一个Critical的信息，你的邮箱就会收到一个Email，这样一旦线上的系统出现问题，你就能立马通过邮件获知，就能及时的进行处理。 +## 使用应用日志 +对于应用日志，每个人的应用场景可能会各不相同，有些人利用应用日志来做数据分析，有些人利用应用日志来做性能分析，有些人来做用户行为分析，还有些就是纯粹的记录，以方便应用出现问题的时候辅助查找问题。 + +举一个例子，我们需要跟踪用户尝试登陆系统的操作。这里会把成功与不成功的尝试都记录下来。记录成功的使用"Info"日志级别，而不成功的使用"warn"级别。如果想查找所有不成功的登陆，我们可以利用linux的grep之类的命令工具，如下： + + # cat /data/logs/roll.log | grep "failed login" + 2012-12-11 11:12:00 WARN : failed login attempt from 11.22.33.44 username password + +通过这种方式我们就可以很方便的查找相应的信息，这样有利于我们针对应用日志做一些统计和分析。另外我们还需要考虑日志的大小，对于一个高流量的Web应用来说，日志的增长是相当可怕的，所以我们在seelog的配置文件里面设置了logrotate，这样就能保证日志文件不会因为不断变大而导致我们的磁盘空间不够引起问题。 + +## 小结 +通过上面对seelog系统及如何基于它进行自定义日志系统的学习，现在我们可以很轻松的随需构建一个合适的功能强大的日志处理系统了。日志处理系统为数据分析提供了可靠的数据源，比如通过对日志的分析，我们可以进一步优化系统，或者应用出现问题时方便查找定位问题，另外seelog也提供了日志分级功能，通过对minlevel的配置,我们可以很方便的测试或发布版本的输出消息。 + +## links + * [目录]() + * 上一章: [部署与维护](<12.md>) * 下一节: [网站错误处理](<12.2.md>) \ No newline at end of file From da4f7097a25f07a7f0c51b8a20967c41ee32d3a6 Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Mon, 19 Nov 2012 22:34:21 +0800 Subject: [PATCH 11/49] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E5=8F=8B=E6=83=85?= =?UTF-8?q?=E9=93=BE=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index d96f8019..c98fd8cc 100644 --- a/README.md +++ b/README.md @@ -46,6 +46,11 @@ - [BianJiang](https://github.com/border) (编写go开发工具Vim和Emacs的设置) - [Oling Cat](https://github.com/OlingCat)(review代码) - [Wenlei Wu](mailto:spadesacn@gmail.com)(提供一些图片展示) + +##友情链接 +目前Go开发的比较成熟的一个框架是由我们国人开发的，目前版本已经比较成熟，而且提供了很多的应用demo，方便快速开发Web应用，该框架是由海意和BianJiang开发维护，推荐大家看看： + +[golangers框架](https://github.com/golangers/framework) ## 授权许可 除特别声明外，本书中的内容使用[CC BY-SA 3.0 License](http://creativecommons.org/licenses/by-sa/3.0/)（创作共用 署名-相同方式共享3.0许可协议）授权，代码遵循[BSD 3-Clause License]()（3项条款的BSD许可协议）。 From b2d830685757d4b205c807dba84bd7e3672fa30f Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Mon, 19 Nov 2012 22:56:36 +0800 Subject: [PATCH 12/49] =?UTF-8?q?=E5=88=A0=E9=99=A4=E5=A4=9A=E4=BD=99?= =?UTF-8?q?=E7=9A=84readme?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/README.md b/README.md index c98fd8cc..e9266167 100644 --- a/README.md +++ b/README.md @@ -30,9 +30,6 @@ 这样读者就可以把相应的Markdown文件编译成html文件，执行`go build build.go`，执行生成的文件，就会在底目录下生成相应的html文件 -## 如何编译 -目前可以把相应的Markdown编译成html文件，执行`go build build.go`，执行生成的文件，就会在底目录下生成相应的html文件。 - ## 交流 欢迎大家加入QQ群：259316004 《Go Web编程》专用交流群 From 80c847a1225f5c53bb96dc79c4fdee8354d8869f Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Tue, 20 Nov 2012 23:43:15 +0800 Subject: [PATCH 13/49] =?UTF-8?q?=E5=AE=8C=E6=88=90=E4=BA=86=E7=AC=AC?= =?UTF-8?q?=E4=BA=8C=E5=B0=8F=E8=8A=82=EF=BC=8C=E7=AC=AC=E4=B8=89=E5=B0=8F?= =?UTF-8?q?=E8=8A=82=E5=BC=80=E4=BA=86=E4=B8=80=E4=B8=AA=E5=A4=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 12.2.md | 104 ++++++++++++++++++++++++++++++++++++++++++++++++++++---- 12.3.md | 9 +++++ 2 files changed, 106 insertions(+), 7 deletions(-) diff --git a/12.2.md b/12.2.md index 32f025f0..85fffafb 100644 --- a/12.2.md +++ b/12.2.md @@ -16,17 +16,107 @@ - 网络出错：指两方便的错误，一方面是用户请求应用程序的时候出现网络断开，这样就导致连接中断，这种错误不会造成应用程序的崩溃，但是会影响用户访问的效果，另一方面是应用程序读取其他网络上的数据，这种网络断开会导致读取失败，这种需要对应用程序做有效的测试，能够避免这类问题出现的情况下程序崩溃。 ## 错误处理的目标 -在实现错误处理之前，我们必须明确错误处理想要达到的目标是什么，错误处理系统应该完成一下工作： +在实现错误处理之前，我们必须明确错误处理想要达到的目标是什么，错误处理系统应该完成以下工作： -- 通知访问用户出现错误了 -- 记录错误 -- 回滚当前的请求 -- 根据错误级别发送邮件 -- 保证现有程序可运行可服务 +- 通知访问用户出现错误了：不论出现的是一个系统错误还是用户错误，用户都应当知道Web应用出了问题，用户的这次请求无法正确的完成了。例如用户的错误请求我们显示一个统一的错误页面(404.html)，出现系统错误我们通过自定义的错误页面显示系统暂时不可用之类的错误页面(error.html) +- 记录错误：系统出错错误时，一般就是我们调用函数的时候返回err不为nil的情况下，使用前面小节介绍的日志系统记录到日志文件，如果是一些致命错误通过邮件通知系统管理员，例如一般404之类的错误不需要发送邮件，只需要记录到日志系统。 +- 回滚当前的请求：如果一个用户请求过程中出现了一个服务器错误，那么已完成的操作需要回滚。下面来看一个例子：一个系统讲用户递交的表单保存到数据库，并将这个数据递交到一个第三方服务器，但是第三方服务器挂了，这就导致一个错误，那么先前存储到数据库的表单数据应该删除，而且应该通知用户系统出现错误了。 +- 保证现有程序可运行可服务：我们知道没有人能保证程序一定能够一直正常的运行着，万一哪一天程序崩溃了，那么我们就需要记录错误，然后立刻让程序重新运行起来，让程序继续提供服务，然后再通知系统管理员，通过日志等找出问题。 ## 如何处理错误 +错误处理其实我们已经在十一章第一小节里面有过介绍如何设计错误处理，这里我们再从一个例子详细的讲解一下，如何来处理不同的错误： + +- 通知用户出现错误： + + 通知用户在访问页面的时候我们可以有两种错误：404.html和error.html，下面分别显示了错误页面的源码： + + + + + 找不到页面 + + + + +
+
+
+
+

404!

+

{{.ErrorInfo}}

+
+
+
+
+ + + 另一个源码： + + + + + 系统错误页面 + + + + +
+
+
+
+

系统暂时不可用!

+

{{.ErrorInfo}}

+
+
+
+
+ + + + 404的错误处理逻辑，如果是系统的错误也是类似的操作，同时我们看到在： + + func (p *MyMux) ServeHTTP(w http.ResponseWriter, r *http.Request) { + if r.URL.Path == "/" { + sayhelloName(w, r) + return + } + NotFound404(w, r) + return + } + + func NotFound404(w http.ResponseWriter, r *http.Request) { + log.Error("页面找不到") //记录错误日志 + t, _ = t.ParseFiles("tmpl/404.html", nil) //解析模板文件 + ErrorInfo := "文件找不到" //获取当前用户信息 + t.Execute(w, ErrorInfo) //执行模板的merger操作 + } + + func SystemError(w http.ResponseWriter, r *http.Request) { + log.Critical("系统错误") //系统错误触发了Critical，那么不仅会记录日志还会发送邮件 + t, _ = t.ParseFiles("tmpl/error.html", nil) //解析模板文件 + ErrorInfo := "系统暂时不可用" //获取当前用户信息 + t.Execute(w, ErrorInfo) //执行模板的merger操作 + } + +## 如何处理异常 +我们知道在很多其他语言中有try...catch操作，可以捕获异常情况，但是其实很多的错误我们都是可以预期的，而不是异常处理，应该当做错误来处理，这也是为什么Go语言采用了函数返回错误的设计，这些函数不会panic，例如如果一个文件找不到，os.Open返回一个错误，它不会panic；如果你向一个中断的网络连接写数据，net.Conn系列类型的Write函数返回一个错误，它们不会panic。这些状态在这样的程序里都是可以预期的。你知道这些操作可能会失败，因为设计者已经用返回错误清楚地表明了这一点。这就是上面所讲的可以预期的错误。 + +但是还有一种情况，有一些操作几乎不可能失败，而且在一些特定的情况下也没有办法返回错误，也无法继续执行，这样情况就应该panic。举个例子：如果一个程序计算x[j]，但是j越界了，这部分代码就会导致panic，像这样的一个不可预期严重错误就会引起panic，在默认情况下它会杀掉进程，它允许一个正在运行这部分代码的goroutine从发生错误的panic中恢复运行，发生panic之后，这部分代码后面的函数和代码都不会继续执行，这是Go特意这样设计的，因为要区别于错误和异常，panic其实就是异常处理。如下代码，我们期望通过uid来获取User中的username信息，但是如果uid越界了就会抛出异常，这个时候如果我们没有recover机制，进程就会被杀死，从而导致程序不可服务。因此为了我们程序的健壮性，在一些地方我们需要建立recover机制。 + + func GetUser(uid int) (username string) { + defer func() { + if x := recover(); x != nil { + username = "" + } + }() + + username = User[uid] + return + } + +上面我们介绍了错误和异常的区别，那么我们在开发程序的时候如何来设计呢？规则很简单：如果你的函数无论如何有可能失败，它就应该返回一个错误。当我调用其他package的函数时，如果这个函数实现的很好，我不需要担心它会panic，除非有真正的异常情况发生，即使那样也不应该是我去处理它。而panic和recover是针对自己开发package里面实现的逻辑，针对一些特殊情况来设计。 ## 小结 - +本小节总结了当我们的Web应用部署之后如何处理各种错误：网络错误、数据库错误、操作系统错误等，当错误发生时，我们的程序如何来正确的处理，显示友好的出错界面、回滚操作、记录日志、通知管理员等操作，最后介绍了如何来正确的处理错误和异常，一般的程序中错误和异常都是混淆的，但是在Go程序中错误和异常是有区分的，所以最后介绍了程序设计的时候如何来遵循这样的原则。 ## links * [目录]() * 上一章: [应用日志](<12.1.md>) diff --git a/12.3.md b/12.3.md index 213503a6..92299517 100644 --- a/12.3.md +++ b/12.3.md @@ -1,6 +1,15 @@ # 12.3 应用部署 +程序开发完毕之后，我们现在要部署Web应用程序了，但是我们如何来部署这些应用程序呢？因为Go程序编译之后是一个可执行文件，编写过C程序的读者一定知道使用demon就可以完美的实现程序后台运行，但是目前Go还无法完美的实现demon，因此，针对Go的应用程序部署，我们可以利用第三方工具来管理，第三方的工具有很多，例如Supervisord、upstart、daemontools等，这小节我介绍目前自己系统中采用的工具Supervisord。 +## deamon +我们可以看到很多网上的一些实现demon的方法，例如下面两种方式： http://code.google.com/p/go/issues/detail?id=227 +## Supervisord +Supervisord是用Python实现的一款非常实用的进程管理工具。 + +## 小结 + + ## links * [目录]() From 9da945f2c8f107f1609e268a05f98880161313f5 Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Tue, 20 Nov 2012 23:45:11 +0800 Subject: [PATCH 14/49] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E4=BA=86=E4=B8=80?= =?UTF-8?q?=E4=B8=8B=E6=A0=BC=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 12.2.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/12.2.md b/12.2.md index 85fffafb..7a146efa 100644 --- a/12.2.md +++ b/12.2.md @@ -22,6 +22,7 @@ - 记录错误：系统出错错误时，一般就是我们调用函数的时候返回err不为nil的情况下，使用前面小节介绍的日志系统记录到日志文件，如果是一些致命错误通过邮件通知系统管理员，例如一般404之类的错误不需要发送邮件，只需要记录到日志系统。 - 回滚当前的请求：如果一个用户请求过程中出现了一个服务器错误，那么已完成的操作需要回滚。下面来看一个例子：一个系统讲用户递交的表单保存到数据库，并将这个数据递交到一个第三方服务器，但是第三方服务器挂了，这就导致一个错误，那么先前存储到数据库的表单数据应该删除，而且应该通知用户系统出现错误了。 - 保证现有程序可运行可服务：我们知道没有人能保证程序一定能够一直正常的运行着，万一哪一天程序崩溃了，那么我们就需要记录错误，然后立刻让程序重新运行起来，让程序继续提供服务，然后再通知系统管理员，通过日志等找出问题。 + ## 如何处理错误 错误处理其实我们已经在十一章第一小节里面有过介绍如何设计错误处理，这里我们再从一个例子详细的讲解一下，如何来处理不同的错误： @@ -96,7 +97,7 @@ ErrorInfo := "系统暂时不可用" //获取当前用户信息 t.Execute(w, ErrorInfo) //执行模板的merger操作 } - + ## 如何处理异常 我们知道在很多其他语言中有try...catch操作，可以捕获异常情况，但是其实很多的错误我们都是可以预期的，而不是异常处理，应该当做错误来处理，这也是为什么Go语言采用了函数返回错误的设计，这些函数不会panic，例如如果一个文件找不到，os.Open返回一个错误，它不会panic；如果你向一个中断的网络连接写数据，net.Conn系列类型的Write函数返回一个错误，它们不会panic。这些状态在这样的程序里都是可以预期的。你知道这些操作可能会失败，因为设计者已经用返回错误清楚地表明了这一点。这就是上面所讲的可以预期的错误。 From 322ea61a677fb7d7ba12ce15b6e10a80faa50047 Mon Sep 17 00:00:00 2001 From: astaxie Date: Wed, 21 Nov 2012 17:40:13 +0800 Subject: [PATCH 15/49] =?UTF-8?q?=E6=94=B9=E8=BF=9B=E4=BA=86=E5=AE=89?= =?UTF-8?q?=E8=A3=85=E5=A6=82=E6=9E=9C=E4=BA=8C=E8=BF=9B=E5=88=B6=E5=8C=85?= =?UTF-8?q?=E6=94=B9=E5=8F=98=E9=BB=98=E8=AE=A4=E4=BD=8D=E7=BD=AE=E9=9C=80?= =?UTF-8?q?=E8=A6=81=E8=AE=BE=E7=BD=AEgoroot?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 9 -- 1.1.md | 273 +++++++++++++++++++++++++++-------------------------- 2 files changed, 139 insertions(+), 143 deletions(-) delete mode 100644 .gitignore diff --git a/.gitignore b/.gitignore deleted file mode 100644 index d87c27bd..00000000 --- a/.gitignore +++ /dev/null @@ -1,9 +0,0 @@ -# Compiled files. -*.exe -*.html -*.ps -*.eps -*.pdf -*.aux -*.log -.gitignore \ No newline at end of file diff --git a/1.1.md b/1.1.md index fba93b98..6495ae10 100644 --- a/1.1.md +++ b/1.1.md @@ -1,134 +1,139 @@ -# 1.1 Go 安装 - -## Go的三种安装方式 -Go有多种安装方式，你可以选择自己喜欢的。这里我们介绍三种最常见的安装方式： - -- 从编译源码安装：这是一种标准的软件安装方式。对于经常使用Unix类系统的用户，尤其对于开发者来说，从源码安装是最方便而熟悉的。 -- 安装Go标准包：Go提供了方便的安装包，支持Windows、Linux、Mac等系统。这种方式适合初学者，可根据自己的系统位数下载好相应的安装包，一路next就可以轻松安装了。 -- 用软件包管理工具：目前有很多方便的第三方软件包工具，例如Ubuntu的apt-get、Mac的homebrew等。这种安装方式适合那些熟悉相应系统的用户。 - -最后，如果你想在同一个系统中安装多个版本的Go，你可以参考第三方工具[GVM](https://github.com/moovweb/gvm)，这是目前在这方面做得最好的工具，除非你知道怎么处理。 - -### Go源码安装 -在Go的源代码中，有些部分是用Plan 9 C和AT&T汇编写的，因此假如你要想从源码安装，就必须安装C的编译工具。 - -在Mac系统中，只要你安装了Xcode，就已经包含了相应的编译工具。 - -在类Unix系统中，需要安装gcc等工具。例如Ubuntu系统可通过在终端中执行`sudo apt-get install gcc libc6-dev`来安装编译工具。 - -在Windows系统中，你需要安装MinGW，然后通过MinGW安装gcc，并设置相应的环境变量。 - -Go使用[Mercurial][hg]进行版本管理，首先你必须安装了Mercurial，然后才能下载。假设你已经安装好Mercurial，执行如下代码： - -假设已经位于Go的安装目录 `$GO_INSTALL_DIR`下 - - hg clone -u release https://code.google.com/p/go - cd go/src - ./all.bash - -运行all.bash后出现"ALL TESTS PASSED"字样时才算安装成功。 - -上面是Unix风格的命令，Windows下的安装方式类似，只不过是运行all.bat，调用的编译器是MinGW的gcc。 - -然后设置几个环境变量， - - export GOROOT=$HOME/go - export GOBIN=$GOROOT/bin - export PATH=$PATH:$GOBIN - -看到如下图片即说明你已经安装成功 - -![](images/1.1.mac.png?raw=true) - -如果出现Go的Usage信息，那么说明Go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境变中是否包含了Go的安装目录。 - - -## Go标准包安装 - -### 如何判断自己的操作系统是32位还是64位？ - -我们接下来的Go安装需要判断操作系统的位数，所以这小节我们先确定自己的系统类型。 - -Windows系统用户请按Win+R运行cmd，输入`systeminfo`后回车，稍等片刻，会出现一些系统信息。在“系统类型”一行中，若显示“x64-based PC”，即为64位系统；若显示“X86-based PC”，则为32位系统。 - -Mac系统用户建议直接使用64位的，因为Go所支持的Mac OS X版本已经不支持纯32位处理器了。 - -Linux系统用户可通过在Terminal中执行命令`uname -a`来查看系统信息： - -64位系统显示 - - <一段描述> x86_64 x86_64 x86_64 GNU/Linux - //有些机器显示如下，例如ubuntu10.04 - x86_64 GNU/Linux - -32位系统显示 - - <一段描述> i686 i686 i386 GNU/Linux - -### Mac 安装 - -访问[下载地址][downlink]，32位系统下载go1.0.3.darwin-386.pkg，64位系统下载go1.0.3.darwin-amd64.pkg，双击下载文件，一路默认安装点击下一步，这个时候go已经安装到你的系统中，默认已经在PATH中增加了相应的`~/go/bin`,这个时候打开终端，输入`go` - -看到如下图片说明已经安装成功 - -![](images/1.1.mac.png?raw=true) - -如果出现go的Usage信息，那么说明go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境变中是否包含了go的安装目录。 - -### Linux 安装 - -访问[下载地址][downlink]，32位系统下载go1.0.3.linux-386.tar.gz，64位系统下载go1.0.3.linux-amd64.tar.gz， - -假定你想要安装Go的目录为 `$GO_INSTALL_DIR`，后面替换为相应的目录路径。 - -解压缩`tar.gz`包到安装目录下：`tar zxvf go1.0.3.linux-amd64.tar.gz -C $GO_INSTALL_DIR`。 - -设置PATH，`export PATH=$PATH:$GO_INSTALL_DIR/go/bin` - -然后执行`go` - -看到类似上面mac安装成功的图片说明已经安装成功 - -如果出现go的Usage信息，那么说明go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境变中是否包含了go的安装目录。 - -### Windows 安装 - -访问[下载地址][downlink]，32位系统下载go1.0.3.windows-386.msi，64位系统下载go1.0.3.windows-amd64.msi。双击打开下载的文件，一路按照默认点击下一步，这个时候go已经安装到你的系统中，默认安装之后已经在你的系统环境变量中加入了`c:/go/bin`，这个时候打开cmd，输入`go` - -看到类似上面mac安装成功的图片说明已经安装成功 - -如果出现Go的Usage信息，那么说明Go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境变中是否包含了Go的安装目录。 - -## 第三方工具安装 -### GVM -gvm是第三方开发的Go多版本管理工具，类似ruby里面的rvm工具。使用起来相当的方便，安装gvm使用如下命令： - - bash < <(curl -s https://raw.github.com/moovweb/gvm/master/binscripts/gvm-installer) - -安装完成后我们就可以安装go了： - - gvm install go1.0.3 - gvm use go1.0.3 - -执行完上面的命令之后GOPATH、GOROOT等环境变量会自动设置好，这样就可以直接使用了。 - -### apt-get -Ubuntu是目前使用最多的Linux桌面系统，使用`apt-get`命令来管理软件包，我们可以通过下面的命令来安装Go： - - sudo add-apt-repository ppa:gophers/go - sudo apt-get update - sudo apt-get install golang-stable - -### homebrew -homebrew是Mac系统下面目前使用最多的管理软件的工具，目前已支持Go，可以通过命令直接安装Go： - - brew install go - - -## links - * [目录]() - * 上一节: [Go环境配置](<1.md>) - * 下一节: [GOPATH 与工作空间](<1.2.md>) - -[downlink]: http://code.google.com/p/go/downloads/list "Go安装包下载" -[hg]: http://mercurial.selenic.com/downloads/ "Mercurial下载" +# 1.1 Go 安装 + +## Go的三种安装方式 +Go有多种安装方式，你可以选择自己喜欢的。这里我们介绍三种最常见的安装方式： + +- 从编译源码安装：这是一种标准的软件安装方式。对于经常使用Unix类系统的用户，尤其对于开发者来说，从源码安装是最方便而熟悉的。 +- 安装Go标准包：Go提供了方便的安装包，支持Windows、Linux、Mac等系统。这种方式适合初学者，可根据自己的系统位数下载好相应的安装包，一路next就可以轻松安装了。 +- 用软件包管理工具：目前有很多方便的第三方软件包工具，例如Ubuntu的apt-get、Mac的homebrew等。这种安装方式适合那些熟悉相应系统的用户。 + +最后，如果你想在同一个系统中安装多个版本的Go，你可以参考第三方工具[GVM](https://github.com/moovweb/gvm)，这是目前在这方面做得最好的工具，除非你知道怎么处理。 + +### Go源码安装 +在Go的源代码中，有些部分是用Plan 9 C和AT&T汇编写的，因此假如你要想从源码安装，就必须安装C的编译工具。 + +在Mac系统中，只要你安装了Xcode，就已经包含了相应的编译工具。 + +在类Unix系统中，需要安装gcc等工具。例如Ubuntu系统可通过在终端中执行`sudo apt-get install gcc libc6-dev`来安装编译工具。 + +在Windows系统中，你需要安装MinGW，然后通过MinGW安装gcc，并设置相应的环境变量。 + +Go使用[Mercurial][hg]进行版本管理，首先你必须安装了Mercurial，然后才能下载。假设你已经安装好Mercurial，执行如下代码： + +假设已经位于Go的安装目录 `$GO_INSTALL_DIR`下 + + hg clone -u release https://code.google.com/p/go + cd go/src + ./all.bash + +运行all.bash后出现"ALL TESTS PASSED"字样时才算安装成功。 + +上面是Unix风格的命令，Windows下的安装方式类似，只不过是运行all.bat，调用的编译器是MinGW的gcc。 + +然后设置几个环境变量， + + export GOROOT=$HOME/go + export GOBIN=$GOROOT/bin + export PATH=$PATH:$GOBIN + +看到如下图片即说明你已经安装成功 + +![](images/1.1.mac.png?raw=true) + +如果出现Go的Usage信息，那么说明Go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境变中是否包含了Go的安装目录。 + + +## Go标准包安装 + +Go提供了每个平台打好包的一键安装，这些包默认会安装到如下目录：/usr/local/go (Windows系统：c:\Go)，当然你可以改变他们的安装位置，但是改变之后你必须在你的环境变量中设置如下信息： + + export GOROOT=$HOME/go + export PATH=$PATH:$GOROOT/bin + +### 如何判断自己的操作系统是32位还是64位？ + +我们接下来的Go安装需要判断操作系统的位数，所以这小节我们先确定自己的系统类型。 + +Windows系统用户请按Win+R运行cmd，输入`systeminfo`后回车，稍等片刻，会出现一些系统信息。在“系统类型”一行中，若显示“x64-based PC”，即为64位系统；若显示“X86-based PC”，则为32位系统。 + +Mac系统用户建议直接使用64位的，因为Go所支持的Mac OS X版本已经不支持纯32位处理器了。 + +Linux系统用户可通过在Terminal中执行命令`uname -a`来查看系统信息： + +64位系统显示 + + <一段描述> x86_64 x86_64 x86_64 GNU/Linux + //有些机器显示如下，例如ubuntu10.04 + x86_64 GNU/Linux + +32位系统显示 + + <一段描述> i686 i686 i386 GNU/Linux + +### Mac 安装 + +访问[下载地址][downlink]，32位系统下载go1.0.3.darwin-386.pkg，64位系统下载go1.0.3.darwin-amd64.pkg，双击下载文件，一路默认安装点击下一步，这个时候go已经安装到你的系统中，默认已经在PATH中增加了相应的`~/go/bin`,这个时候打开终端，输入`go` + +看到如下图片说明已经安装成功 + +![](images/1.1.mac.png?raw=true) + +如果出现go的Usage信息，那么说明go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境变中是否包含了go的安装目录。 + +### Linux 安装 + +访问[下载地址][downlink]，32位系统下载go1.0.3.linux-386.tar.gz，64位系统下载go1.0.3.linux-amd64.tar.gz， + +假定你想要安装Go的目录为 `$GO_INSTALL_DIR`，后面替换为相应的目录路径。 + +解压缩`tar.gz`包到安装目录下：`tar zxvf go1.0.3.linux-amd64.tar.gz -C $GO_INSTALL_DIR`。 + +设置PATH，`export PATH=$PATH:$GO_INSTALL_DIR/go/bin` + +然后执行`go` + +看到类似上面mac安装成功的图片说明已经安装成功 + +如果出现go的Usage信息，那么说明go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境变中是否包含了go的安装目录。 + +### Windows 安装 + +访问[下载地址][downlink]，32位系统下载go1.0.3.windows-386.msi，64位系统下载go1.0.3.windows-amd64.msi。双击打开下载的文件，一路按照默认点击下一步，这个时候go已经安装到你的系统中，默认安装之后已经在你的系统环境变量中加入了`c:/go/bin`，这个时候打开cmd，输入`go` + +看到类似上面mac安装成功的图片说明已经安装成功 + +如果出现Go的Usage信息，那么说明Go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境变中是否包含了Go的安装目录。 + +## 第三方工具安装 +### GVM +gvm是第三方开发的Go多版本管理工具，类似ruby里面的rvm工具。使用起来相当的方便，安装gvm使用如下命令： + + bash < <(curl -s https://raw.github.com/moovweb/gvm/master/binscripts/gvm-installer) + +安装完成后我们就可以安装go了： + + gvm install go1.0.3 + gvm use go1.0.3 + +执行完上面的命令之后GOPATH、GOROOT等环境变量会自动设置好，这样就可以直接使用了。 + +### apt-get +Ubuntu是目前使用最多的Linux桌面系统，使用`apt-get`命令来管理软件包，我们可以通过下面的命令来安装Go： + + sudo add-apt-repository ppa:gophers/go + sudo apt-get update + sudo apt-get install golang-stable + +### homebrew +homebrew是Mac系统下面目前使用最多的管理软件的工具，目前已支持Go，可以通过命令直接安装Go： + + brew install go + + +## links + * [目录]() + * 上一节: [Go环境配置](<1.md>) + * 下一节: [GOPATH 与工作空间](<1.2.md>) + +[downlink]: http://code.google.com/p/go/downloads/list "Go安装包下载" +[hg]: http://mercurial.selenic.com/downloads/ "Mercurial下载" From c90ff9750893d23cc2b0a825aa4da1a41e24f5fc Mon Sep 17 00:00:00 2001 From: astaxie Date: Wed, 21 Nov 2012 17:57:32 +0800 Subject: [PATCH 16/49] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E6=95=B0=E6=8D=AE?= =?UTF-8?q?=E5=BA=93db.Close()?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 5.2.md | 272 +++++++++++++++++++++++++++++---------------------------- 5.3.md | 234 +++++++++++++++++++++++++------------------------ 5.4.md | 246 +++++++++++++++++++++++++-------------------------- 3 files changed, 379 insertions(+), 373 deletions(-) diff --git a/5.2.md b/5.2.md index 82542f4d..e7575459 100644 --- a/5.2.md +++ b/5.2.md @@ -1,135 +1,137 @@ -# 5.2使用MySQL数据库 -目前Internet上流行的网站构架方式是LAMP，其中的M即MySQL, 作为数据库，MySQL以免费、开源、使用方便为优势成为了很多Web开发的后端数据库存储引擎。 - -## MySQL驱动 -Go中支持MySQL的驱动目前比较多，有如下几种，有些是支持database/sql标准，而有些是采用了自己的实现接口,常用的有如下几种: - -- http://code.google.com/p/go-mysql-driver/ 支持database/sql，全部采用go写。 -- https://github.com/ziutek/mymysql 支持database/sql，也支持自定义的接口，全部采用go写。 -- https://github.com/Philio/GoMySQL 不支持database/sql，自定义接口，全部采用go写。 - -接下来的例子我主要以第一个驱动为例(我目前项目中也是采用它来驱动)，也推荐大家采用它，主要理由： - -- 这个驱动比较新，维护的比较好 -- 完全支持database/sql接口 -- 支持keepalive，保持长连接,虽然[星星](http://www.mikespook.com)fork的mymysql也支持keepalive，但不是线程安全的，这个从底层就支持了keepalive。 - -## 示例代码 -接下来的几个小节里面我们都将采用同一个数据库表结构：数据库test，用户表userinfo，关联用户信息表userdetail。 - - CREATE TABLE `userinfo` ( - `uid` INT(10) NOT NULL AUTO_INCREMENT, - `username` VARCHAR(64) NULL DEFAULT NULL, - `departname` VARCHAR(64) NULL DEFAULT NULL, - `created` DATE NULL DEFAULT NULL, - PRIMARY KEY (`uid`) - ) - - CREATE TABLE `userdetail` ( - `uid` INT(10) NOT NULL DEFAULT '0', - `intro` TEXT NULL, - `profile` TEXT NULL, - PRIMARY KEY (`uid`) - ) - -如下示例将示范如何使用database/sql接口对数据库表进行增删改查操作 - - package main - - import ( - _ "code.google.com/p/go-mysql-driver/mysql" - "database/sql" - "fmt" - //"time" - ) - - func main() { - db, err := sql.Open("mysql", "astaxie:astaxie@/test?charset=utf8") - checkErr(err) - - //插入数据 - stmt, err := db.Prepare("INSERT userinfo SET username=?,departname=?,created=?") - checkErr(err) - - res, err := stmt.Exec("astaxie", "研发部门", "2012-12-09") - checkErr(err) - - id, err := res.LastInsertId() - checkErr(err) - - fmt.Println(id) - //更新数据 - stmt, err = db.Prepare("update userinfo set username=? where uid=?") - checkErr(err) - - res, err = stmt.Exec("astaxieupdate", id) - checkErr(err) - - affect, err := res.RowsAffected() - checkErr(err) - - fmt.Println(affect) - - //查询数据 - rows, err := db.Query("SELECT * FROM userinfo") - checkErr(err) - - for rows.Next() { - var uid int - var username string - var department string - var created string - err = rows.Scan(&uid, &username, &department, &created) - checkErr(err) - fmt.Println(uid) - fmt.Println(username) - fmt.Println(department) - fmt.Println(created) - } - - //删除数据 - stmt, err = db.Prepare("delete from userinfo where uid=?") - checkErr(err) - - res, err = stmt.Exec(id) - checkErr(err) - - affect, err = res.RowsAffected() - checkErr(err) - - fmt.Println(affect) - - } - - func checkErr(err error) { - if err != nil { - panic(err) - } - } - - -通过上面的代码我们可以看出，Go操作Mysql数据库是很方便的。 - -关键的几个函数我解释一下： - -sql.Open()函数用来打开一个注册过的数据库驱动，go-mysql-driver中注册了mysql这个数据库驱动，第二个参数是DNS(Data Source Name)，它是go-mysql-drivev定义的一些数据库链接和配置信息。它支持如下格式： - - user@unix(/path/to/socket)/dbname?charset=utf8 - user:password@tcp(localhost:5555)/dbname?charset=utf8&keepalive=1 - user:password@/dbname - user:password@tcp([de:ad:be:ef::ca:fe]:80)/dbname - -db.Prepare()函数用来返回准备要执行的sql操作，然后返回准备完毕的执行状态。 - -db.Query()函数用来直接执行Sql返回Rows结果。 - -stmt.Exec()函数用来执行stmt准备好的SQL语句 - -我们可以看到我们传入的参数都是=?对应的数据，这样做的方式可以一定程度上防止SQL注入。 - - - -## links - * [目录]() - * 上一节: [database/sql接口](<5.1.md>) - * 下一节: [使用SQLite数据库](<5.3.md>) +# 5.2使用MySQL数据库 +目前Internet上流行的网站构架方式是LAMP，其中的M即MySQL, 作为数据库，MySQL以免费、开源、使用方便为优势成为了很多Web开发的后端数据库存储引擎。 + +## MySQL驱动 +Go中支持MySQL的驱动目前比较多，有如下几种，有些是支持database/sql标准，而有些是采用了自己的实现接口,常用的有如下几种: + +- http://code.google.com/p/go-mysql-driver/ 支持database/sql，全部采用go写。 +- https://github.com/ziutek/mymysql 支持database/sql，也支持自定义的接口，全部采用go写。 +- https://github.com/Philio/GoMySQL 不支持database/sql，自定义接口，全部采用go写。 + +接下来的例子我主要以第一个驱动为例(我目前项目中也是采用它来驱动)，也推荐大家采用它，主要理由： + +- 这个驱动比较新，维护的比较好 +- 完全支持database/sql接口 +- 支持keepalive，保持长连接,虽然[星星](http://www.mikespook.com)fork的mymysql也支持keepalive，但不是线程安全的，这个从底层就支持了keepalive。 + +## 示例代码 +接下来的几个小节里面我们都将采用同一个数据库表结构：数据库test，用户表userinfo，关联用户信息表userdetail。 + + CREATE TABLE `userinfo` ( + `uid` INT(10) NOT NULL AUTO_INCREMENT, + `username` VARCHAR(64) NULL DEFAULT NULL, + `departname` VARCHAR(64) NULL DEFAULT NULL, + `created` DATE NULL DEFAULT NULL, + PRIMARY KEY (`uid`) + ) + + CREATE TABLE `userdetail` ( + `uid` INT(10) NOT NULL DEFAULT '0', + `intro` TEXT NULL, + `profile` TEXT NULL, + PRIMARY KEY (`uid`) + ) + +如下示例将示范如何使用database/sql接口对数据库表进行增删改查操作 + + package main + + import ( + _ "code.google.com/p/go-mysql-driver/mysql" + "database/sql" + "fmt" + //"time" + ) + + func main() { + db, err := sql.Open("mysql", "astaxie:astaxie@/test?charset=utf8") + checkErr(err) + + //插入数据 + stmt, err := db.Prepare("INSERT userinfo SET username=?,departname=?,created=?") + checkErr(err) + + res, err := stmt.Exec("astaxie", "研发部门", "2012-12-09") + checkErr(err) + + id, err := res.LastInsertId() + checkErr(err) + + fmt.Println(id) + //更新数据 + stmt, err = db.Prepare("update userinfo set username=? where uid=?") + checkErr(err) + + res, err = stmt.Exec("astaxieupdate", id) + checkErr(err) + + affect, err := res.RowsAffected() + checkErr(err) + + fmt.Println(affect) + + //查询数据 + rows, err := db.Query("SELECT * FROM userinfo") + checkErr(err) + + for rows.Next() { + var uid int + var username string + var department string + var created string + err = rows.Scan(&uid, &username, &department, &created) + checkErr(err) + fmt.Println(uid) + fmt.Println(username) + fmt.Println(department) + fmt.Println(created) + } + + //删除数据 + stmt, err = db.Prepare("delete from userinfo where uid=?") + checkErr(err) + + res, err = stmt.Exec(id) + checkErr(err) + + affect, err = res.RowsAffected() + checkErr(err) + + fmt.Println(affect) + + db.Close() + + } + + func checkErr(err error) { + if err != nil { + panic(err) + } + } + + +通过上面的代码我们可以看出，Go操作Mysql数据库是很方便的。 + +关键的几个函数我解释一下： + +sql.Open()函数用来打开一个注册过的数据库驱动，go-mysql-driver中注册了mysql这个数据库驱动，第二个参数是DNS(Data Source Name)，它是go-mysql-drivev定义的一些数据库链接和配置信息。它支持如下格式： + + user@unix(/path/to/socket)/dbname?charset=utf8 + user:password@tcp(localhost:5555)/dbname?charset=utf8&keepalive=1 + user:password@/dbname + user:password@tcp([de:ad:be:ef::ca:fe]:80)/dbname + +db.Prepare()函数用来返回准备要执行的sql操作，然后返回准备完毕的执行状态。 + +db.Query()函数用来直接执行Sql返回Rows结果。 + +stmt.Exec()函数用来执行stmt准备好的SQL语句 + +我们可以看到我们传入的参数都是=?对应的数据，这样做的方式可以一定程度上防止SQL注入。 + + + +## links + * [目录]() + * 上一节: [database/sql接口](<5.1.md>) + * 下一节: [使用SQLite数据库](<5.3.md>) diff --git a/5.3.md b/5.3.md index 5029aec7..c18e8455 100644 --- a/5.3.md +++ b/5.3.md @@ -1,116 +1,118 @@ -# 5.3使用SQLite数据库 - -SQLite 是一个开源的嵌入式关系数据库，实现自包容、零配置、支持事务的SQL数据库引擎。其特点是高度便携、使用方便、结构紧凑、高效、可靠。 与其他数据库管理系统不同，SQLite 的安装和运行非常简单，在大多数情况下,只要确保SQLite的二进制文件存在即可开始创建、连接和使用数据库。如果您正在寻找一个嵌入式数据库项目或解决方案，SQLite是绝对值得考虑。SQLite可以是说开源的Access。 - -## 驱动 -Go支持sqlite的驱动也比较多，但是好多都是不支持database/sql接口的 - -- https://github.com/mattn/go-sqlite3 支持database/sql接口，基于cgo(关于cgo的知识请参看官方文档或者本书后面的章节)写的 -- https://github.com/feyeleanor/gosqlite3 不支持database/sql接口，基于cgo写的 -- https://github.com/phf/go-sqlite3 不支持database/sql接口，基于cgo写的 - -目前支持database/sql的SQLite数据库驱动只有第一个，我目前也是采用它来开发项目的。采用标准接口有利于以后出现更好的驱动的时候做迁移。 - -## 实例代码 -示例的数据库表结构如下所示，相应的建表SQL： - - CREATE TABLE `userinfo` ( - `uid` INTEGER PRIMARY KEY AUTOINCREMENT, - `username` VARCHAR(64) NULL, - `departname` VARCHAR(64) NULL, - `created` DATE NULL - ); - - CREATE TABLE `userdeatail` ( - `uid` INT(10) NULL, - `intro` TEXT NULL, - `profile` TEXT NULL, - PRIMARY KEY (`uid`) - ); - -看下面Go程序是如何操作数据库表数据:增删改查 - - package main - - import ( - "database/sql" - "fmt" - _ "github.com/mattn/go-sqlite3" - ) - - func main() { - db, err := sql.Open("sqlite3", "./foo.db") - checkErr(err) - - //插入数据 - stmt, err := db.Prepare("INSERT INTO userinfo(username, departname, created) values(?,?,?)") - checkErr(err) - - res, err := stmt.Exec("astaxie", "研发部门", "2012-12-09") - checkErr(err) - - id, err := res.LastInsertId() - checkErr(err) - - fmt.Println(id) - //更新数据 - stmt, err = db.Prepare("update userinfo set username=? where uid=?") - checkErr(err) - - res, err = stmt.Exec("astaxieupdate", id) - checkErr(err) - - affect, err := res.RowsAffected() - checkErr(err) - - fmt.Println(affect) - - //查询数据 - rows, err := db.Query("SELECT * FROM userinfo") - checkErr(err) - - for rows.Next() { - var uid int - var username string - var department string - var created string - err = rows.Scan(&uid, &username, &department, &created) - checkErr(err) - fmt.Println(uid) - fmt.Println(username) - fmt.Println(department) - fmt.Println(created) - } - - //删除数据 - stmt, err = db.Prepare("delete from userinfo where uid=?") - checkErr(err) - - res, err = stmt.Exec(id) - checkErr(err) - - affect, err = res.RowsAffected() - checkErr(err) - - fmt.Println(affect) - - } - - func checkErr(err error) { - if err != nil { - panic(err) - } - } - - -我们可以看到上面的代码和MySQL例子里面的代码几乎是一模一样的，唯一改变的就是导入的驱动改变了，然后调用`sql.Open`是采用了SQLite的方式打开。 - - ->sqlite管理工具：http://sqliteadmin.orbmu2k.de/ - ->可以方便的新建数据库管理。 - -## links - * [目录]() - * 上一节: [使用MySQL数据库](<5.2.md>) - * 下一节: [使用PostgreSQL数据库](<5.4.md>) +# 5.3使用SQLite数据库 + +SQLite 是一个开源的嵌入式关系数据库，实现自包容、零配置、支持事务的SQL数据库引擎。其特点是高度便携、使用方便、结构紧凑、高效、可靠。 与其他数据库管理系统不同，SQLite 的安装和运行非常简单，在大多数情况下,只要确保SQLite的二进制文件存在即可开始创建、连接和使用数据库。如果您正在寻找一个嵌入式数据库项目或解决方案，SQLite是绝对值得考虑。SQLite可以是说开源的Access。 + +## 驱动 +Go支持sqlite的驱动也比较多，但是好多都是不支持database/sql接口的 + +- https://github.com/mattn/go-sqlite3 支持database/sql接口，基于cgo(关于cgo的知识请参看官方文档或者本书后面的章节)写的 +- https://github.com/feyeleanor/gosqlite3 不支持database/sql接口，基于cgo写的 +- https://github.com/phf/go-sqlite3 不支持database/sql接口，基于cgo写的 + +目前支持database/sql的SQLite数据库驱动只有第一个，我目前也是采用它来开发项目的。采用标准接口有利于以后出现更好的驱动的时候做迁移。 + +## 实例代码 +示例的数据库表结构如下所示，相应的建表SQL： + + CREATE TABLE `userinfo` ( + `uid` INTEGER PRIMARY KEY AUTOINCREMENT, + `username` VARCHAR(64) NULL, + `departname` VARCHAR(64) NULL, + `created` DATE NULL + ); + + CREATE TABLE `userdeatail` ( + `uid` INT(10) NULL, + `intro` TEXT NULL, + `profile` TEXT NULL, + PRIMARY KEY (`uid`) + ); + +看下面Go程序是如何操作数据库表数据:增删改查 + + package main + + import ( + "database/sql" + "fmt" + _ "github.com/mattn/go-sqlite3" + ) + + func main() { + db, err := sql.Open("sqlite3", "./foo.db") + checkErr(err) + + //插入数据 + stmt, err := db.Prepare("INSERT INTO userinfo(username, departname, created) values(?,?,?)") + checkErr(err) + + res, err := stmt.Exec("astaxie", "研发部门", "2012-12-09") + checkErr(err) + + id, err := res.LastInsertId() + checkErr(err) + + fmt.Println(id) + //更新数据 + stmt, err = db.Prepare("update userinfo set username=? where uid=?") + checkErr(err) + + res, err = stmt.Exec("astaxieupdate", id) + checkErr(err) + + affect, err := res.RowsAffected() + checkErr(err) + + fmt.Println(affect) + + //查询数据 + rows, err := db.Query("SELECT * FROM userinfo") + checkErr(err) + + for rows.Next() { + var uid int + var username string + var department string + var created string + err = rows.Scan(&uid, &username, &department, &created) + checkErr(err) + fmt.Println(uid) + fmt.Println(username) + fmt.Println(department) + fmt.Println(created) + } + + //删除数据 + stmt, err = db.Prepare("delete from userinfo where uid=?") + checkErr(err) + + res, err = stmt.Exec(id) + checkErr(err) + + affect, err = res.RowsAffected() + checkErr(err) + + fmt.Println(affect) + + db.Close() + + } + + func checkErr(err error) { + if err != nil { + panic(err) + } + } + + +我们可以看到上面的代码和MySQL例子里面的代码几乎是一模一样的，唯一改变的就是导入的驱动改变了，然后调用`sql.Open`是采用了SQLite的方式打开。 + + +>sqlite管理工具：http://sqliteadmin.orbmu2k.de/ + +>可以方便的新建数据库管理。 + +## links + * [目录]() + * 上一节: [使用MySQL数据库](<5.2.md>) + * 下一节: [使用PostgreSQL数据库](<5.4.md>) diff --git a/5.4.md b/5.4.md index bf0980bb..0e48b539 100644 --- a/5.4.md +++ b/5.4.md @@ -1,122 +1,124 @@ -# 5.4使用PostgreSQL数据库 - -PostgreSQL 是一个自由的对象-关系数据库服务器(数据库管理系统)，它在灵活的 BSD-风格许可证下发行。它提供了相对其他开放源代码数据库系统(比如 MySQL 和 Firebird)，和对专有系统比如 Oracle、Sybase、IBM 的 DB2 和 Microsoft SQL Server的一种选择。 - -PostgreSQL和MySQL比较，它更加庞大一点，因为它是用来替代Oracle而设计的。所以在企业应用中采用PostgreSQL是一个明智的选择。 - -现在MySQL被Oracle收购之后，有传闻Oracle正在逐步的封闭MySQL,,鉴于此，将来我们也许会选择PostgreSQL而不是MySQL作为项目的后端数据库。 - -## 驱动 -Go实现的支持PostgreSQL的驱动也很多，因为国外很多人在开发中使用了这个数据库。 - -- https://github.com/bmizerany/pq 支持database/sql驱动，纯Go写的 -- https://github.com/jbarham/gopgsqldriver 支持database/sql驱动，纯Go写的 -- https://github.com/lxn/go-pgsql 支持database/sql驱动，纯Go写的 - -在下面的示例中我采用了第一个驱动，因为它目前使用的人最多，在github上也比较活跃。 - -## 实例代码 -数据库建表语句： - - CREATE TABLE userinfo - ( - uid serial NOT NULL, - username character varying(100) NOT NULL, - departname character varying(500) NOT NULL, - Created date, - CONSTRAINT userinfo_pkey PRIMARY KEY (uid) - ) - WITH (OIDS=FALSE); - - CREATE TABLE userdeatail - ( - uid integer, - intro character varying(100), - profile character varying(100) - ) - WITH(OIDS=FALSE); - -看下面这个Go如何操作数据库表数据:增删改查 - -package main - - import ( - "database/sql" - "fmt" - _ "github.com/bmizerany/pq" - ) - - func main() { - db, err := sql.Open("postgres", "user=astaxie password=astaxie dbname=test sslmode=disable") - checkErr(err) - - //插入数据 - stmt, err := db.Prepare("INSERT INTO userinfo(username,departname,created) VALUES($1,$2,$3) RETURNING uid") - checkErr(err) - - res, err := stmt.Exec("astaxie", "研发部门", "2012-12-09") - checkErr(err) - - //pg不支持这个函数，因为他没有类似MySQL的自增ID - id, err := res.LastInsertId() - checkErr(err) - - fmt.Println(id) - - //更新数据 - stmt, err = db.Prepare("update userinfo set username=$1 where uid=$2") - checkErr(err) - - res, err = stmt.Exec("astaxieupdate", 1) - checkErr(err) - - affect, err := res.RowsAffected() - checkErr(err) - - fmt.Println(affect) - - //查询数据 - rows, err := db.Query("SELECT * FROM userinfo") - checkErr(err) - - for rows.Next() { - var uid int - var username string - var department string - var created string - err = rows.Scan(&uid, &username, &department, &created) - checkErr(err) - fmt.Println(uid) - fmt.Println(username) - fmt.Println(department) - fmt.Println(created) - } - - //删除数据 - stmt, err = db.Prepare("delete from userinfo where uid=$1") - checkErr(err) - - res, err = stmt.Exec(1) - checkErr(err) - - affect, err = res.RowsAffected() - checkErr(err) - - fmt.Println(affect) - - } - - func checkErr(err error) { - if err != nil { - panic(err) - } - } - -从上面的代码我们可以看到，PostgreSQL是通过`$1`,`$2`这种方式来指定要传递的参数，而不是MySQL中的`?`，另外在sql.Open中的dsn信息的格式也与MySQL的驱动中的dsn格式不一样，所以在使用时请注意它们的差异。 - -还有pg不支持LastInsertId函数，因为PostgreSQL内部没有实现类似MySQL的自增ID返回，其他的代码几乎是一模一样。 - -## links - * [目录]() - * 上一节: [使用SQLite数据库](<5.3.md>) - * 下一节: [使用beedb库进行ORM开发](<5.5.md>) +# 5.4使用PostgreSQL数据库 + +PostgreSQL 是一个自由的对象-关系数据库服务器(数据库管理系统)，它在灵活的 BSD-风格许可证下发行。它提供了相对其他开放源代码数据库系统(比如 MySQL 和 Firebird)，和对专有系统比如 Oracle、Sybase、IBM 的 DB2 和 Microsoft SQL Server的一种选择。 + +PostgreSQL和MySQL比较，它更加庞大一点，因为它是用来替代Oracle而设计的。所以在企业应用中采用PostgreSQL是一个明智的选择。 + +现在MySQL被Oracle收购之后，有传闻Oracle正在逐步的封闭MySQL,,鉴于此，将来我们也许会选择PostgreSQL而不是MySQL作为项目的后端数据库。 + +## 驱动 +Go实现的支持PostgreSQL的驱动也很多，因为国外很多人在开发中使用了这个数据库。 + +- https://github.com/bmizerany/pq 支持database/sql驱动，纯Go写的 +- https://github.com/jbarham/gopgsqldriver 支持database/sql驱动，纯Go写的 +- https://github.com/lxn/go-pgsql 支持database/sql驱动，纯Go写的 + +在下面的示例中我采用了第一个驱动，因为它目前使用的人最多，在github上也比较活跃。 + +## 实例代码 +数据库建表语句： + + CREATE TABLE userinfo + ( + uid serial NOT NULL, + username character varying(100) NOT NULL, + departname character varying(500) NOT NULL, + Created date, + CONSTRAINT userinfo_pkey PRIMARY KEY (uid) + ) + WITH (OIDS=FALSE); + + CREATE TABLE userdeatail + ( + uid integer, + intro character varying(100), + profile character varying(100) + ) + WITH(OIDS=FALSE); + +看下面这个Go如何操作数据库表数据:增删改查 + +package main + + import ( + "database/sql" + "fmt" + _ "github.com/bmizerany/pq" + ) + + func main() { + db, err := sql.Open("postgres", "user=astaxie password=astaxie dbname=test sslmode=disable") + checkErr(err) + + //插入数据 + stmt, err := db.Prepare("INSERT INTO userinfo(username,departname,created) VALUES($1,$2,$3) RETURNING uid") + checkErr(err) + + res, err := stmt.Exec("astaxie", "研发部门", "2012-12-09") + checkErr(err) + + //pg不支持这个函数，因为他没有类似MySQL的自增ID + id, err := res.LastInsertId() + checkErr(err) + + fmt.Println(id) + + //更新数据 + stmt, err = db.Prepare("update userinfo set username=$1 where uid=$2") + checkErr(err) + + res, err = stmt.Exec("astaxieupdate", 1) + checkErr(err) + + affect, err := res.RowsAffected() + checkErr(err) + + fmt.Println(affect) + + //查询数据 + rows, err := db.Query("SELECT * FROM userinfo") + checkErr(err) + + for rows.Next() { + var uid int + var username string + var department string + var created string + err = rows.Scan(&uid, &username, &department, &created) + checkErr(err) + fmt.Println(uid) + fmt.Println(username) + fmt.Println(department) + fmt.Println(created) + } + + //删除数据 + stmt, err = db.Prepare("delete from userinfo where uid=$1") + checkErr(err) + + res, err = stmt.Exec(1) + checkErr(err) + + affect, err = res.RowsAffected() + checkErr(err) + + fmt.Println(affect) + + db.Close() + + } + + func checkErr(err error) { + if err != nil { + panic(err) + } + } + +从上面的代码我们可以看到，PostgreSQL是通过`$1`,`$2`这种方式来指定要传递的参数，而不是MySQL中的`?`，另外在sql.Open中的dsn信息的格式也与MySQL的驱动中的dsn格式不一样，所以在使用时请注意它们的差异。 + +还有pg不支持LastInsertId函数，因为PostgreSQL内部没有实现类似MySQL的自增ID返回，其他的代码几乎是一模一样。 + +## links + * [目录]() + * 上一节: [使用SQLite数据库](<5.3.md>) + * 下一节: [使用beedb库进行ORM开发](<5.5.md>) From 79a9ee9557a6b944fdb94857d61c83f7f2ebcd3d Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Wed, 21 Nov 2012 23:44:10 +0800 Subject: [PATCH 17/49] =?UTF-8?q?=E5=AE=8C=E6=88=90=E4=BA=86=E7=AC=AC?= =?UTF-8?q?=E4=B8=89=E5=B0=8F=E8=8A=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 12.3.md | 172 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 168 insertions(+), 4 deletions(-) diff --git a/12.3.md b/12.3.md index 92299517..93bcefe3 100644 --- a/12.3.md +++ b/12.3.md @@ -1,14 +1,178 @@ # 12.3 应用部署 程序开发完毕之后，我们现在要部署Web应用程序了，但是我们如何来部署这些应用程序呢？因为Go程序编译之后是一个可执行文件，编写过C程序的读者一定知道使用demon就可以完美的实现程序后台运行，但是目前Go还无法完美的实现demon，因此，针对Go的应用程序部署，我们可以利用第三方工具来管理，第三方的工具有很多，例如Supervisord、upstart、daemontools等，这小节我介绍目前自己系统中采用的工具Supervisord。 ## deamon -我们可以看到很多网上的一些实现demon的方法，例如下面两种方式： +目前Go程序如果要实现deamon还不行，详细的见这个Go语言的bug：http://code.google.com/p/go/issues/detail?id=227，大概的意思说很难从现有的使用的线程中fork一个出来，因为没有一种简单的方法来确保所有已经使用的线程的状态一致性问题。 + +但是我们可以看到很多网上的一些实现deamon的方法，例如下面两种方式： + +- MarGo的一个实现思路，使用Commond来执行自身的应用，如果真想实现，那么推荐这种方案 + + d := flag.Bool("d", false, "Whether or not to launch in the background(like a daemon)") + if *d { + cmd := exec.Command(os.Args[0], + "-close-fds", + "-addr", *addr, + "-call", *call, + ) + serr, err := cmd.StderrPipe() + if err != nil { + log.Fatalln(err) + } + err = cmd.Start() + if err != nil { + log.Fatalln(err) + } + s, err := ioutil.ReadAll(serr) + s = bytes.TrimSpace(s) + if bytes.HasPrefix(s, []byte("addr: ")) { + fmt.Println(string(s)) + cmd.Process.Release() + } else { + log.Printf("unexpected response from MarGo: `%s` error: `%v`\n", s, err) + cmd.Process.Kill() + } + } + +- 另一种是利用syscall的方案，但是这个方案并不完善： + + package main + + import ( + "log" + "os" + "syscall" + ) + + func daemon(nochdir, noclose int) int { + var ret, ret2 uintptr + var err uintptr + + darwin := syscall.OS == "darwin" + + // already a daemon + if syscall.Getppid() == 1 { + return 0 + } + + // fork off the parent process + ret, ret2, err = syscall.RawSyscall(syscall.SYS_FORK, 0, 0, 0) + if err != 0 { + return -1 + } + + // failure + if ret2 < 0 { + os.Exit(-1) + } + + // handle exception for darwin + if darwin && ret2 == 1 { + ret = 0 + } + + // if we got a good PID, then we call exit the parent process. + if ret > 0 { + os.Exit(0) + } + + /* Change the file mode mask */ + _ = syscall.Umask(0) + + // create a new SID for the child process + s_ret, s_errno := syscall.Setsid() + if s_errno != 0 { + log.Printf("Error: syscall.Setsid errno: %d", s_errno) + } + if s_ret < 0 { + return -1 + } + + if nochdir == 0 { + os.Chdir("/") + } + + if noclose == 0 { + f, e := os.OpenFile("/dev/null", os.O_RDWR, 0) + if e == nil { + fd := f.Fd() + syscall.Dup2(fd, os.Stdin.Fd()) + syscall.Dup2(fd, os.Stdout.Fd()) + syscall.Dup2(fd, os.Stderr.Fd()) + } + } + + return 0 + } + +上面提出了两种实现Go的deamon方案，但是我还是不推荐大家这样去实现，因为官方还没有正式的宣布支持deamon，当然第一种方案目前来看是比较可行的，而且目前开源库skynet也在采用这个方案做deamon。 -http://code.google.com/p/go/issues/detail?id=227 ## Supervisord -Supervisord是用Python实现的一款非常实用的进程管理工具。 +上面已经介绍了Go目前是有两种方案来实现他的deamon，但是官方本身还不支持这一块，所以还是建议大家采用第三方成熟工具来管理我们的应用程序，这里我给大家介绍一款目前使用比较广泛的进程管理软件：Supervisord。Supervisord是用Python实现的一款非常实用的进程管理工具。supervisord会帮你把管理的应用程序转成daemon程序，而且可以方便的通过命令开启、关闭、重启等操作，而且它管理的进程一旦奔溃会自动再次重新开启，这样就可以保证程序中断的情况下有自我修复功能。 + +>我前面在应用中踩过一个坑，就是因为所有的应用程序都是由Supervisord父进程生出来的，那么当你修改了操作系统的文件描述符之后，别忘记重启Supervisord，光重启下面的应用程序没用。当初我就是系统安装好之后就先装了Supervisord，然后开始部署程序，修改文件描述符，重启程序，以为文件描述符已经是100000了，其实Supervisord这个时候还是默认的1024个，导致他管理的进程所有的描述符也是1024.开放之后压力一上来里面狂暴文件描述符用光了，查了很久才找到这个坑。 + +### Supervisord安装 +Supervisord可以通过`sudo easy_install supervisor`安装，当然也可以通过Supervisord官网下载后`setup.py install`安装。 + +- 使用easy_install必须安装setuptools + + 打开http://pypi.python.org/pypi/setuptools#files，根据你系统的python的版本下载相应的文件，然后执行`sh setuptoolsxxxx.egg`，这样就可以使用easy_install命令来安装Supervisord。 + +### Supervisord配置 +Supervisord默认的配置文件路径为/etc/supervisord.conf，通过文本编辑器修改这个文件，下面是一个示例的配置文件： + + ;/etc/supervisord.conf + [unix_http_server] + file = /var/run/supervisor.sock + chmod = 0777 + chown= root:root + + [inet_http_server] + # Web管理界面设定 + port=9001 + username = admin + password = yourpassword + + [supervisorctl] + ; 必须和'unix_http_server'里面的设定匹配 + serverurl = unix:///var/run/supervisord.sock + + [supervisord] + logfile=/var/log/supervisord/supervisord.log ; (main log file;default $CWD/supervisord.log) + logfile_maxbytes=50MB ; (max main logfile bytes b4 rotation;default 50MB) + logfile_backups=10 ; (num of main logfile rotation backups;default 10) + loglevel=info ; (log level;default info; others: debug,warn,trace) + pidfile=/var/run/supervisord.pid ; (supervisord pidfile;default supervisord.pid) + nodaemon=true ; (start in foreground if true;default false) + minfds=1024 ; (min. avail startup file descriptors;default 1024) + minprocs=200 ; (min. avail process descriptors;default 200) + user=root ; (default is current user, required if root) + childlogdir=/var/log/supervisord/ ; ('AUTO' child log dir, default $TEMP) + + [rpcinterface:supervisor] + supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface + + ; 管理的单个进程的配置，可以添加多个program + [program:blogdemon] + command=/data/blog/blogdemon + autostart = true + startsecs = 5 + user = root + redirect_stderr = true + stdout_logfile = /var/log/supervisord/blogdemon.log + +### Supervisord管理 +Supervisord安装完成后有两个可用的命令行supervisor和supervisorctl，命令使用解释如下： + +- supervisord，初始启动Supervisord，启动、管理配置中设置的进程。 +- supervisorctl stop programxxx，停止某一个进程(programxxx)，programxxx为[program:blogdemon]里配置的值，这个示例就是blogdemon。 +- supervisorctl start programxxx，启动某个进程 +- supervisorctl restart programxxx，重启某个进程 +- supervisorctl stop all，停止全部进程，注：start、restart、stop都不会载入最新的配置文件。 +- supervisorctl reload，载入最新的配置文件，并按新的配置启动、管理所有进程。 ## 小结 - +这小节我们介绍了如何实现Go的deamon，但是我们知道由于目前Go的deamon实现不是很完美，我们需要依靠第三方工具来实现应用程序的deamon管理，这里介绍了一个python写的进程管理工具Supervisord，通过Supervisord可以很方便的把我们的Go应用程序管理起来。 ## links From 85f11b8436cc5a310641e386a0174eebd23e920d Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Thu, 22 Nov 2012 22:15:37 +0800 Subject: [PATCH 18/49] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E4=BA=86=E4=B8=80?= =?UTF-8?q?=E4=B8=8B=E9=94=99=E5=88=AB=E5=AD=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 3.3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/3.3.md b/3.3.md index 4e78daf0..ae1ad63f 100644 --- a/3.3.md +++ b/3.3.md @@ -33,7 +33,7 @@ Handler：处理请求和生成返回信息的处理逻辑 前面小节的代码里面我们可以看到，Go是通过一个函数来操作这个事情的`ListenAndServe`来监听起来的，这个底层其实这样处理的：初始化一个server对象，然后调用了`net.Listen("tcp", addr)`，也就是底层用TCP协议搭建了一个服务，然后监控我们设置的端口。 -监控之后如何接收客户端的请求呢？上面代码执行监控端口之后，调用了`srv.Sere(net.Listener)`函数，这个函数就是处理接收客户端的请求信息。这个函数里面起了一个`for{}`，首先通过Listener接收请求，其次创建一个Conn，最后单独开了一个goroutine，把这个请求的数据当做参数扔给这个conn去服务：`go c.serve()`。这个就是高并发体现了，用户的每一次请求都是在一个新的goroutine去服务，相互不影响。 +监控之后如何接收客户端的请求呢？上面代码执行监控端口之后，调用了`srv.Serve(net.Listener)`函数，这个函数就是处理接收客户端的请求信息。这个函数里面起了一个`for{}`，首先通过Listener接收请求，其次创建一个Conn，最后单独开了一个goroutine，把这个请求的数据当做参数扔给这个conn去服务：`go c.serve()`。这个就是高并发体现了，用户的每一次请求都是在一个新的goroutine去服务，相互不影响。 那么如何具体分配到相应的函数来处理请求呢？conn首先会解析request:`c.readRequest()`,然后获取相应的handler:`handler := c.server.Handler`，也就是我们刚才在调用函数`ListenAndServe`时候的第二个参数，我们前面例子传递的是nil，也就是为空，那么默认获取`handler = DefaultServeMux`,那么这个变量用来做什么的呢？对，这个变量就是一个路由器，它用来匹配url跳转到其相应的handle函数，那么这个我们有设置过吗?有，我们调用的代码里面第一句不是调用了`http.HandleFunc("/", sayhelloName)`嘛。这个作用就是注册了请求`/`的路由规则，当请求uri为"/"，路由就会转到函数sayhelloName，DefaultServeMux会调用ServeHTTP方法，这个方法内部其实就是调用sayhelloName本身，最后通过写入response的信息反馈到客户端。 From 55b3cbf7cd32a7b86069d39c50aea9137ec0192b Mon Sep 17 00:00:00 2001 From: astaxie Date: Fri, 23 Nov 2012 18:00:31 +0800 Subject: [PATCH 19/49] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E4=BA=86=E6=97=B6?= =?UTF-8?q?=E9=97=B4=E6=A0=BC=E5=BC=8F=E9=94=99=E8=AF=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 8.1.md | 652 ++++++++++++++++++++++++++++----------------------------- 1 file changed, 326 insertions(+), 326 deletions(-) diff --git a/8.1.md b/8.1.md index f323aaa9..211f3e41 100644 --- a/8.1.md +++ b/8.1.md @@ -1,326 +1,326 @@ -# 8.1 Socket编程 -在很多底层网络应用开发者的眼里一切编程都是Socket，话虽然有点夸张，但却也几乎如此了，现在的网络编程几乎都是用Socket来编程。你想过这些情景么？我们每天打开浏览器浏览网页时，浏览器进程怎么和Web服务器进行通信的呢？当你用QQ聊天时，QQ进程怎么和服务器或者是你的好友所在的QQ进程进行通信的呢？当你打开PPstream观看视频时，PPstream进程如何与视频服务器进行通信的呢？ 如此种种，都是靠Socket来进行通信的，以一斑窥全豹，可见Socket编程在现代编程中占据了多么重要的地位，这一节我们将介绍Go语言中如何进行Socket编程。 - -## 什么是Socket？ -Socket起源于Unix，而Unix基本哲学之一就是“一切皆文件”，都可以用“打开open –> 读写write/read –> 关闭close”模式来操作。Socket就是该模式的一个实现，网络的Socket数据传输是一种特殊的I/O，Socket也是一种文件描述符。Socket也具有一个类似于打开文件的函数调用：Socket()，该函数返回一个整型的Socket描述符，随后的连接建立、数据传输等操作都是通过该Socket实现的。 - -常用的Socket类型有两种：流式Socket（SOCK_STREAM）和数据报式Socket（SOCK_DGRAM）。流式是一种面向连接的Socket，针对于面向连接的TCP服务应用；数据报式Socket是一种无连接的Socket，对应于无连接的UDP服务应用。 -## Socket如何通信 -网络中的进程之间如何通过Socket通信呢？首要解决的问题是如何唯一标识一个进程，否则通信无从谈起！在本地可以通过进程PID来唯一标识一个进程，但是在网络中这是行不通的。其实TCP/IP协议族已经帮我们解决了这个问题，网络层的“ip地址”可以唯一标识网络中的主机，而传输层的“协议+端口”可以唯一标识主机中的应用程序（进程）。这样利用三元组（ip地址，协议，端口）就可以标识网络的进程了，网络中需要互相通信的进程，就可以利用这个标志在他们之间进行交互。请看下面这个TCP/IP协议结构图 - -![](images/8.1.socket.png?raw=true) - -使用TCP/IP协议的应用程序通常采用应用编程接口：UNIX BSD的套接字（socket）和UNIX System V的TLI（已经被淘汰），来实现网络进程之间的通信。就目前而言，几乎所有的应用程序都是采用socket，而现在又是网络时代，网络中进程通信是无处不在，这就是为什么说“一切皆Socket”。 - -## Socket基础知识 -通过上面的介绍我们知道Socket有两种：TCP Socket和UDP Socket，TCP和UDP是协议，而要确定一个进程的需要三元组，需要IP地址和端口。 - -### IPv4地址 -目前的全球因特网所采用的协议族是TCP/IP协议。IP是TCP/IP协议中网络层的协议，是TCP/IP协议族的核心协议。目前主要采用的IP协议的版本号是4(简称为IPv4)，发展至今已经使用了30多年。 - -IPv4的地址位数为32位，也就是最多有2的32次方的网络设备可以联到Internet上。近十年来由于互联网的蓬勃发展，IP位址的需求量愈来愈大，使得IP位址的发放愈趋紧张，前一段时间，据报道IPV4的地址已经发放完毕，我们公司目前很多服务器的IP都是一个宝贵的资源。 - -地址格式类似这样：127.0.0.1 172.122.121.111 - -### IPv6地址 -IPv6是下一版本的互联网协议，也可以说是下一代互联网的协议，它是为了解决IPv4在实施过程中遇到的各种问题而被提出的，IPv6采用128位地址长度，几乎可以不受限制地提供地址。按保守方法估算IPv6实际可分配的地址，整个地球的每平方米面积上仍可分配1000多个地址。在IPv6的设计过程中除了一劳永逸地解决了地址短缺问题以外，还考虑了在IPv4中解决不好的其它问题，主要有端到端IP连接、服务质量（QoS）、安全性、多播、移动性、即插即用等。 - -地址格式类似这样：2002:c0e8:82e7:0:0:0:c0e8:82e7 - -### Go支持的IP类型 -在Go的`net`包中定义了很多类型、函数和方法用来网络编程，其中IP的定义如下： - - type IP []byte - -在`net`包中有很多函数来操作IP，但是其中比较有用的也就几个，其中`ParseIP(s string) IP`函数会把一个IPv4或者IPv6的地址转化成IP类型，请看下面的例子: - - package main - import ( - "net" - "os" - "fmt" - ) - func main() { - if len(os.Args) != 2 { - fmt.Fprintf(os.Stderr, "Usage: %s ip-addr\n", os.Args[0]) - os.Exit(1) - } - name := os.Args[1] - addr := net.ParseIP(name) - if addr == nil { - fmt.Println("Invalid address") - } else { - fmt.Println("The address is ", addr.String()) - } - os.Exit(0) - } - -执行之后你就会发现只要你输入一个IP地址就会给出相应的IP格式 - -## TCP Socket -当我们知道如何通过网络端口访问一个服务时，那么我们能够做什么呢？作为客户端来说，我们可以通过向远端某台机器的的某个网络端口发送一个请求，然后得到在机器的此端口上监听的服务反馈的信息。作为服务端，我们需要把服务绑定到某个指定端口，并且在此端口上监听，当有客户端来访问时能够读取信息并且写入反馈信息。 - -在Go语言的`net`包中有一个类型`TCPConn`，这个类型可以用来作为客户端和服务器端交互的通道，他有两个主要的函数： - - func (c *TCPConn) Write(b []byte) (n int, err os.Error) - func (c *TCPConn) Read(b []byte) (n int, err os.Error) - -`TCPConn`可以用在客户端和服务器端来读写数据。 - -还有我们需要知道一个`TCPAddr`类型，他表示一个TCP的地址信息，他的定义如下： - - type TCPAddr struct { - IP IP - Port int - } -在Go语言中通过`ResolveTCPAddr`获取一个`TCPAddr` - - func ResolveTCPAddr(net, addr string) (*TCPAddr, os.Error) - -- net参数是"tcp4"、"tcp6"、"tcp"中的任意一个，分别表示TCP(IPv4-only),TCP(IPv6-only)或者TCP(IPv4,IPv6的任意一个). -- addr表示域名或者IP地址，例如"www.google.com:80" 或者"127.0.0.1:22". - - -### TCP client -Go语言中通过net包中的`DialTCP`函数来建立一个TCP连接，并返回一个`TCPConn`类型的对象，当连接建立时服务器端也创建一个同类型的对象，此时客户端和服务器段通过各自拥有的`TCPConn`对象来进行数据交换。一般而言，客户端通过`TCPConn`对象将请求信息发送到服务器端，读取服务器端响应的信息。服务器端读取并解析来自客户端的请求，并返回应答信息，这个连接只有当任一端关闭了连接之后才失效，不然这连接可以一直在使用。建立连接的函数定义如下： - - func DialTCP(net string, laddr, raddr *TCPAddr) (c *TCPConn, err os.Error) - -- net参数是"tcp4"、"tcp6"、"tcp"中的任意一个，分别表示TCP(IPv4-only)、TCP(IPv6-only)或者TCP(IPv4,IPv6的任意一个) -- laddr表示本机地址，一般设置为nil -- raddr表示远程的服务地址 - -接下来我们写一个简单的例子，模拟一个基于HTTP协议的客户端请求去连接一个Web服务端。我们要写一个简单的http请求头，格式类似如下： - - "HEAD / HTTP/1.0\r\n\r\n" - -从服务端接收到的响应信息格式可能如下： - - HTTP/1.0 200 OK - ETag: "-9985996" - Last-Modified: Thu, 25 Mar 2010 17:51:10 GMT - Content-Length: 18074 - Connection: close - Date: Sat, 28 Aug 2010 00:43:48 GMT - Server: lighttpd/1.4.23 - -我们的客户端代码如下所示： - - package main - - import ( - "fmt" - "io/ioutil" - "net" - "os" - ) - - func main() { - if len(os.Args) != 2 { - fmt.Fprintf(os.Stderr, "Usage: %s host:port ", os.Args[0]) - os.Exit(1) - } - service := os.Args[1] - tcpAddr, err := net.ResolveTCPAddr("tcp4", service) - checkError(err) - conn, err := net.DialTCP("tcp", nil, tcpAddr) - checkError(err) - _, err = conn.Write([]byte("HEAD / HTTP/1.0\r\n\r\n")) - checkError(err) - result, err := ioutil.ReadAll(conn) - checkError(err) - fmt.Println(string(result)) - os.Exit(0) - } - func checkError(err error) { - if err != nil { - fmt.Fprintf(os.Stderr, "Fatal error: %s", err.Error()) - os.Exit(1) - } - } - -通过上面的代码我们可以看出：首先程序将用户的输入作为参数`service`传入`net.ResolveTCPAddr`获取一个tcpAddr,然后把tcpAddr传入DialTCP后创建了一个TCP连接`conn`，通过`conn`来发送请求信息，最后通过`ioutil.ReadAll`从`conn`中读取全部的文本，也就是服务端响应反馈的信息。 - -### TCP server -上面我们编写了一个TCP的客户端程序，也可以通过net包来创建一个服务器端程序，在服务器端我们需要绑定服务到指定的非激活端口，并监听此端口，当有客户端请求到达的时候可以接收到来自客户端连接的请求。net包中有相应功能的函数，函数定义如下： - - func ListenTCP(net string, laddr *TCPAddr) (l *TCPListener, err os.Error) - func (l *TCPListener) Accept() (c Conn, err os.Error) - -参数说明同DialTCP的参数一样。下面我们实现一个简单的时间同步服务，监听7777端口 - - package main - - import ( - "fmt" - "net" - "os" - "time" - ) - - func main() { - service := ":7777" - tcpAddr, err := net.ResolveTCPAddr("ip4", service) - checkError(err) - listener, err := net.ListenTCP("tcp", tcpAddr) - checkError(err) - for { - conn, err := listener.Accept() - if err != nil { - continue - } - daytime := time.LocalTime().String() - conn.Write([]byte(daytime)) // don't care about return value - conn.Close() // we're finished with this client - } - } - func checkError(err error) { - if err != nil { - fmt.Fprintf(os.Stderr, "Fatal error: %s", err.Error()) - os.Exit(1) - } - } - -上面的服务跑起来之后，它将会一直在那里等待，直到有新的客户端请求到达。当有新的客户端请求到达并同意接受`Accept`该请求的时候他会反馈当前的时间信息。值得注意的是，在代码中`for`循环里，当有错误发生时，直接continue而不是退出，是因为在服务器端跑代码的时候，当有错误发生的情况下最好是由服务端记录错误，然后当前连接的客户端直接报错而退出，从而不会影响到当前服务端运行的整个服务。 - -上面的代码有个缺点，执行的时候是单任务的，不能同时接收多个请求，那么该如何改造以使它支持多并发呢？Go里面有一个goroutine机制，请看下面改造后的代码 - - package main - - import ( - "fmt" - "net" - "os" - "time" - ) - - func main() { - service := ":1200" - tcpAddr, err := net.ResolveTCPAddr("ip4", service) - checkError(err) - listener, err := net.ListenTCP("tcp", tcpAddr) - checkError(err) - for { - conn, err := listener.Accept() - if err != nil { - continue - } - go handlerClient(conn) - } - } - - func handleClient(conn net.Conn) { - defer conn.Close() - daytime := time.LocalTime().String() - conn.Write([]byte(daytime)) // don't care about return value - // we're finished with this client - } - func checkError(err error) { - if err != nil { - fmt.Fprintf(os.Stderr, "Fatal error: %s", err.Error()) - os.Exit(1) - } - } - -通过把业务处理分离到函数`handleClient`，我们就可以进一步地实现多并发执行了。看上去是不是很帅，增加`go`关键词就实现了服务端的多并发，从这个小例子也可以看出goroutine的强大之处。 - -### 控制TCP连接 -TCP有很多连接控制函数，我们平常用到比较多的有如下几个函数： - - func (c *TCPConn) SetTimeout(nsec int64) os.Error - func (c *TCPConn) SetKeepAlive(keepalive bool) os.Error - -第一个函数用来设置连接的超时时间，客户端和服务器端都适用，当超过设置的时间时该连接就会失效。 - -第二个函数用来设置客户端是否和服务器端一直保持着连接，即使没有任何的数据发送。 - -更多的内容请查看`net`包的文档。 -## UDP Socket -Go语言包中处理UDP Socket和TCP Socket不同的地方就是在服务器端处理多个客户端请求数据包的方式不同,UDP缺少了对客户端连接请求的Accept函数。其他基本几乎一模一样，只有TCP换成了UDP而已。UDP的几个主要函数如下所示： - - func ResolveUDPAddr(net, addr string) (*UDPAddr, os.Error) - func DialUDP(net string, laddr, raddr *UDPAddr) (c *UDPConn, err os.Error) - func ListenUDP(net string, laddr *UDPAddr) (c *UDPConn, err os.Error) - func (c *UDPConn) ReadFromUDP(b []byte) (n int, addr *UDPAddr, err os.Error - func (c *UDPConn) WriteToUDP(b []byte, addr *UDPAddr) (n int, err os.Error) - -一个UDP的客户端代码如下所示,我们可以看到不同的就是TCP换成了UDP而已： - - package main - - import ( - "fmt" - "net" - "os" - ) - - func main() { - if len(os.Args) != 2 { - fmt.Fprintf(os.Stderr, "Usage: %s host:port", os.Args[0]) - os.Exit(1) - } - service := os.Args[1] - udpAddr, err := net.ResolveUDPAddr("udp4", service) - checkError(err) - conn, err := net.DialUDP("udp", nil, udpAddr) - checkError(err) - _, err = conn.Write([]byte("anything")) - checkError(err) - var buf [512]byte - n, err := conn.Read(buf[0:]) - checkError(err) - fmt.Println(string(buf[0:n])) - os.Exit(0) - } - func checkError(err error) { - if err != nil { - fmt.Fprintf(os.Stderr, "Fatal error ", err.Error()) - os.Exit(1) - } - } - -我们来看一下UDP服务器端如何来处理： - - package main - - import ( - "fmt" - "net" - "os" - "time" - ) - - func main() { - service := ":1200" - udpAddr, err := net.ResolveUDPAddr("udp4", service) - checkError(err) - conn, err := net.ListenUDP("udp", udpAddr) - checkError(err) - for { - handleClient(conn) - } - } - func handleClient(conn *net.UDPConn) { - var buf [512]byte - _, addr, err := conn.ReadFromUDP(buf[0:]) - if err != nil { - return - } - daytime := time.LocalTime().String() - conn.WriteToUDP([]byte(daytime), addr) - } - func checkError(err error) { - if err != nil { - fmt.Fprintf(os.Stderr, "Fatal error ", err.Error()) - os.Exit(1) - } - } - -## 总结 -通过对TCP和UDP Socket编程的描述和实现，可见Go已经完备地支持了Socket编程，而且使用起来相当的方便，Go提供了很多函数，通过这些函数可以很容易就编写出高性能的Socket应用。 - - -## links - * [目录]() - * 上一节: [Web服务](<8.md>) - * 下一节: [WebSocket](<8.2.md>) +# 8.1 Socket编程 +在很多底层网络应用开发者的眼里一切编程都是Socket，话虽然有点夸张，但却也几乎如此了，现在的网络编程几乎都是用Socket来编程。你想过这些情景么？我们每天打开浏览器浏览网页时，浏览器进程怎么和Web服务器进行通信的呢？当你用QQ聊天时，QQ进程怎么和服务器或者是你的好友所在的QQ进程进行通信的呢？当你打开PPstream观看视频时，PPstream进程如何与视频服务器进行通信的呢？ 如此种种，都是靠Socket来进行通信的，以一斑窥全豹，可见Socket编程在现代编程中占据了多么重要的地位，这一节我们将介绍Go语言中如何进行Socket编程。 + +## 什么是Socket？ +Socket起源于Unix，而Unix基本哲学之一就是“一切皆文件”，都可以用“打开open –> 读写write/read –> 关闭close”模式来操作。Socket就是该模式的一个实现，网络的Socket数据传输是一种特殊的I/O，Socket也是一种文件描述符。Socket也具有一个类似于打开文件的函数调用：Socket()，该函数返回一个整型的Socket描述符，随后的连接建立、数据传输等操作都是通过该Socket实现的。 + +常用的Socket类型有两种：流式Socket（SOCK_STREAM）和数据报式Socket（SOCK_DGRAM）。流式是一种面向连接的Socket，针对于面向连接的TCP服务应用；数据报式Socket是一种无连接的Socket，对应于无连接的UDP服务应用。 +## Socket如何通信 +网络中的进程之间如何通过Socket通信呢？首要解决的问题是如何唯一标识一个进程，否则通信无从谈起！在本地可以通过进程PID来唯一标识一个进程，但是在网络中这是行不通的。其实TCP/IP协议族已经帮我们解决了这个问题，网络层的“ip地址”可以唯一标识网络中的主机，而传输层的“协议+端口”可以唯一标识主机中的应用程序（进程）。这样利用三元组（ip地址，协议，端口）就可以标识网络的进程了，网络中需要互相通信的进程，就可以利用这个标志在他们之间进行交互。请看下面这个TCP/IP协议结构图 + +![](images/8.1.socket.png?raw=true) + +使用TCP/IP协议的应用程序通常采用应用编程接口：UNIX BSD的套接字（socket）和UNIX System V的TLI（已经被淘汰），来实现网络进程之间的通信。就目前而言，几乎所有的应用程序都是采用socket，而现在又是网络时代，网络中进程通信是无处不在，这就是为什么说“一切皆Socket”。 + +## Socket基础知识 +通过上面的介绍我们知道Socket有两种：TCP Socket和UDP Socket，TCP和UDP是协议，而要确定一个进程的需要三元组，需要IP地址和端口。 + +### IPv4地址 +目前的全球因特网所采用的协议族是TCP/IP协议。IP是TCP/IP协议中网络层的协议，是TCP/IP协议族的核心协议。目前主要采用的IP协议的版本号是4(简称为IPv4)，发展至今已经使用了30多年。 + +IPv4的地址位数为32位，也就是最多有2的32次方的网络设备可以联到Internet上。近十年来由于互联网的蓬勃发展，IP位址的需求量愈来愈大，使得IP位址的发放愈趋紧张，前一段时间，据报道IPV4的地址已经发放完毕，我们公司目前很多服务器的IP都是一个宝贵的资源。 + +地址格式类似这样：127.0.0.1 172.122.121.111 + +### IPv6地址 +IPv6是下一版本的互联网协议，也可以说是下一代互联网的协议，它是为了解决IPv4在实施过程中遇到的各种问题而被提出的，IPv6采用128位地址长度，几乎可以不受限制地提供地址。按保守方法估算IPv6实际可分配的地址，整个地球的每平方米面积上仍可分配1000多个地址。在IPv6的设计过程中除了一劳永逸地解决了地址短缺问题以外，还考虑了在IPv4中解决不好的其它问题，主要有端到端IP连接、服务质量（QoS）、安全性、多播、移动性、即插即用等。 + +地址格式类似这样：2002:c0e8:82e7:0:0:0:c0e8:82e7 + +### Go支持的IP类型 +在Go的`net`包中定义了很多类型、函数和方法用来网络编程，其中IP的定义如下： + + type IP []byte + +在`net`包中有很多函数来操作IP，但是其中比较有用的也就几个，其中`ParseIP(s string) IP`函数会把一个IPv4或者IPv6的地址转化成IP类型，请看下面的例子: + + package main + import ( + "net" + "os" + "fmt" + ) + func main() { + if len(os.Args) != 2 { + fmt.Fprintf(os.Stderr, "Usage: %s ip-addr\n", os.Args[0]) + os.Exit(1) + } + name := os.Args[1] + addr := net.ParseIP(name) + if addr == nil { + fmt.Println("Invalid address") + } else { + fmt.Println("The address is ", addr.String()) + } + os.Exit(0) + } + +执行之后你就会发现只要你输入一个IP地址就会给出相应的IP格式 + +## TCP Socket +当我们知道如何通过网络端口访问一个服务时，那么我们能够做什么呢？作为客户端来说，我们可以通过向远端某台机器的的某个网络端口发送一个请求，然后得到在机器的此端口上监听的服务反馈的信息。作为服务端，我们需要把服务绑定到某个指定端口，并且在此端口上监听，当有客户端来访问时能够读取信息并且写入反馈信息。 + +在Go语言的`net`包中有一个类型`TCPConn`，这个类型可以用来作为客户端和服务器端交互的通道，他有两个主要的函数： + + func (c *TCPConn) Write(b []byte) (n int, err os.Error) + func (c *TCPConn) Read(b []byte) (n int, err os.Error) + +`TCPConn`可以用在客户端和服务器端来读写数据。 + +还有我们需要知道一个`TCPAddr`类型，他表示一个TCP的地址信息，他的定义如下： + + type TCPAddr struct { + IP IP + Port int + } +在Go语言中通过`ResolveTCPAddr`获取一个`TCPAddr` + + func ResolveTCPAddr(net, addr string) (*TCPAddr, os.Error) + +- net参数是"tcp4"、"tcp6"、"tcp"中的任意一个，分别表示TCP(IPv4-only),TCP(IPv6-only)或者TCP(IPv4,IPv6的任意一个). +- addr表示域名或者IP地址，例如"www.google.com:80" 或者"127.0.0.1:22". + + +### TCP client +Go语言中通过net包中的`DialTCP`函数来建立一个TCP连接，并返回一个`TCPConn`类型的对象，当连接建立时服务器端也创建一个同类型的对象，此时客户端和服务器段通过各自拥有的`TCPConn`对象来进行数据交换。一般而言，客户端通过`TCPConn`对象将请求信息发送到服务器端，读取服务器端响应的信息。服务器端读取并解析来自客户端的请求，并返回应答信息，这个连接只有当任一端关闭了连接之后才失效，不然这连接可以一直在使用。建立连接的函数定义如下： + + func DialTCP(net string, laddr, raddr *TCPAddr) (c *TCPConn, err os.Error) + +- net参数是"tcp4"、"tcp6"、"tcp"中的任意一个，分别表示TCP(IPv4-only)、TCP(IPv6-only)或者TCP(IPv4,IPv6的任意一个) +- laddr表示本机地址，一般设置为nil +- raddr表示远程的服务地址 + +接下来我们写一个简单的例子，模拟一个基于HTTP协议的客户端请求去连接一个Web服务端。我们要写一个简单的http请求头，格式类似如下： + + "HEAD / HTTP/1.0\r\n\r\n" + +从服务端接收到的响应信息格式可能如下： + + HTTP/1.0 200 OK + ETag: "-9985996" + Last-Modified: Thu, 25 Mar 2010 17:51:10 GMT + Content-Length: 18074 + Connection: close + Date: Sat, 28 Aug 2010 00:43:48 GMT + Server: lighttpd/1.4.23 + +我们的客户端代码如下所示： + + package main + + import ( + "fmt" + "io/ioutil" + "net" + "os" + ) + + func main() { + if len(os.Args) != 2 { + fmt.Fprintf(os.Stderr, "Usage: %s host:port ", os.Args[0]) + os.Exit(1) + } + service := os.Args[1] + tcpAddr, err := net.ResolveTCPAddr("tcp4", service) + checkError(err) + conn, err := net.DialTCP("tcp", nil, tcpAddr) + checkError(err) + _, err = conn.Write([]byte("HEAD / HTTP/1.0\r\n\r\n")) + checkError(err) + result, err := ioutil.ReadAll(conn) + checkError(err) + fmt.Println(string(result)) + os.Exit(0) + } + func checkError(err error) { + if err != nil { + fmt.Fprintf(os.Stderr, "Fatal error: %s", err.Error()) + os.Exit(1) + } + } + +通过上面的代码我们可以看出：首先程序将用户的输入作为参数`service`传入`net.ResolveTCPAddr`获取一个tcpAddr,然后把tcpAddr传入DialTCP后创建了一个TCP连接`conn`，通过`conn`来发送请求信息，最后通过`ioutil.ReadAll`从`conn`中读取全部的文本，也就是服务端响应反馈的信息。 + +### TCP server +上面我们编写了一个TCP的客户端程序，也可以通过net包来创建一个服务器端程序，在服务器端我们需要绑定服务到指定的非激活端口，并监听此端口，当有客户端请求到达的时候可以接收到来自客户端连接的请求。net包中有相应功能的函数，函数定义如下： + + func ListenTCP(net string, laddr *TCPAddr) (l *TCPListener, err os.Error) + func (l *TCPListener) Accept() (c Conn, err os.Error) + +参数说明同DialTCP的参数一样。下面我们实现一个简单的时间同步服务，监听7777端口 + + package main + + import ( + "fmt" + "net" + "os" + "time" + ) + + func main() { + service := ":7777" + tcpAddr, err := net.ResolveTCPAddr("ip4", service) + checkError(err) + listener, err := net.ListenTCP("tcp", tcpAddr) + checkError(err) + for { + conn, err := listener.Accept() + if err != nil { + continue + } + daytime := time.LocalTime().String() + conn.Write([]byte(daytime)) // don't care about return value + conn.Close() // we're finished with this client + } + } + func checkError(err error) { + if err != nil { + fmt.Fprintf(os.Stderr, "Fatal error: %s", err.Error()) + os.Exit(1) + } + } + +上面的服务跑起来之后，它将会一直在那里等待，直到有新的客户端请求到达。当有新的客户端请求到达并同意接受`Accept`该请求的时候他会反馈当前的时间信息。值得注意的是，在代码中`for`循环里，当有错误发生时，直接continue而不是退出，是因为在服务器端跑代码的时候，当有错误发生的情况下最好是由服务端记录错误，然后当前连接的客户端直接报错而退出，从而不会影响到当前服务端运行的整个服务。 + +上面的代码有个缺点，执行的时候是单任务的，不能同时接收多个请求，那么该如何改造以使它支持多并发呢？Go里面有一个goroutine机制，请看下面改造后的代码 + + package main + + import ( + "fmt" + "net" + "os" + "time" + ) + + func main() { + service := ":1200" + tcpAddr, err := net.ResolveTCPAddr("ip4", service) + checkError(err) + listener, err := net.ListenTCP("tcp", tcpAddr) + checkError(err) + for { + conn, err := listener.Accept() + if err != nil { + continue + } + go handlerClient(conn) + } + } + + func handleClient(conn net.Conn) { + defer conn.Close() + daytime := time.Now().String() + conn.Write([]byte(daytime)) // don't care about return value + // we're finished with this client + } + func checkError(err error) { + if err != nil { + fmt.Fprintf(os.Stderr, "Fatal error: %s", err.Error()) + os.Exit(1) + } + } + +通过把业务处理分离到函数`handleClient`，我们就可以进一步地实现多并发执行了。看上去是不是很帅，增加`go`关键词就实现了服务端的多并发，从这个小例子也可以看出goroutine的强大之处。 + +### 控制TCP连接 +TCP有很多连接控制函数，我们平常用到比较多的有如下几个函数： + + func (c *TCPConn) SetTimeout(nsec int64) os.Error + func (c *TCPConn) SetKeepAlive(keepalive bool) os.Error + +第一个函数用来设置连接的超时时间，客户端和服务器端都适用，当超过设置的时间时该连接就会失效。 + +第二个函数用来设置客户端是否和服务器端一直保持着连接，即使没有任何的数据发送。 + +更多的内容请查看`net`包的文档。 +## UDP Socket +Go语言包中处理UDP Socket和TCP Socket不同的地方就是在服务器端处理多个客户端请求数据包的方式不同,UDP缺少了对客户端连接请求的Accept函数。其他基本几乎一模一样，只有TCP换成了UDP而已。UDP的几个主要函数如下所示： + + func ResolveUDPAddr(net, addr string) (*UDPAddr, os.Error) + func DialUDP(net string, laddr, raddr *UDPAddr) (c *UDPConn, err os.Error) + func ListenUDP(net string, laddr *UDPAddr) (c *UDPConn, err os.Error) + func (c *UDPConn) ReadFromUDP(b []byte) (n int, addr *UDPAddr, err os.Error + func (c *UDPConn) WriteToUDP(b []byte, addr *UDPAddr) (n int, err os.Error) + +一个UDP的客户端代码如下所示,我们可以看到不同的就是TCP换成了UDP而已： + + package main + + import ( + "fmt" + "net" + "os" + ) + + func main() { + if len(os.Args) != 2 { + fmt.Fprintf(os.Stderr, "Usage: %s host:port", os.Args[0]) + os.Exit(1) + } + service := os.Args[1] + udpAddr, err := net.ResolveUDPAddr("udp4", service) + checkError(err) + conn, err := net.DialUDP("udp", nil, udpAddr) + checkError(err) + _, err = conn.Write([]byte("anything")) + checkError(err) + var buf [512]byte + n, err := conn.Read(buf[0:]) + checkError(err) + fmt.Println(string(buf[0:n])) + os.Exit(0) + } + func checkError(err error) { + if err != nil { + fmt.Fprintf(os.Stderr, "Fatal error ", err.Error()) + os.Exit(1) + } + } + +我们来看一下UDP服务器端如何来处理： + + package main + + import ( + "fmt" + "net" + "os" + "time" + ) + + func main() { + service := ":1200" + udpAddr, err := net.ResolveUDPAddr("udp4", service) + checkError(err) + conn, err := net.ListenUDP("udp", udpAddr) + checkError(err) + for { + handleClient(conn) + } + } + func handleClient(conn *net.UDPConn) { + var buf [512]byte + _, addr, err := conn.ReadFromUDP(buf[0:]) + if err != nil { + return + } + daytime := time.Now().String() + conn.WriteToUDP([]byte(daytime), addr) + } + func checkError(err error) { + if err != nil { + fmt.Fprintf(os.Stderr, "Fatal error ", err.Error()) + os.Exit(1) + } + } + +## 总结 +通过对TCP和UDP Socket编程的描述和实现，可见Go已经完备地支持了Socket编程，而且使用起来相当的方便，Go提供了很多函数，通过这些函数可以很容易就编写出高性能的Socket应用。 + + +## links + * [目录]() + * 上一节: [Web服务](<8.md>) + * 下一节: [WebSocket](<8.2.md>) From 54860888d3ca65dc2d03d84f2ae54fe73d60ba3c Mon Sep 17 00:00:00 2001 From: astaxie Date: Fri, 23 Nov 2012 18:09:48 +0800 Subject: [PATCH 20/49] =?UTF-8?q?=E4=BF=AE=E6=94=B9tcp4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 8.1.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/8.1.md b/8.1.md index 211f3e41..9c758d7e 100644 --- a/8.1.md +++ b/8.1.md @@ -160,7 +160,7 @@ Go语言中通过net包中的`DialTCP`函数来建立一个TCP连接，并返回 func main() { service := ":7777" - tcpAddr, err := net.ResolveTCPAddr("ip4", service) + tcpAddr, err := net.ResolveTCPAddr("tcp4", service) checkError(err) listener, err := net.ListenTCP("tcp", tcpAddr) checkError(err) @@ -196,7 +196,7 @@ Go语言中通过net包中的`DialTCP`函数来建立一个TCP连接，并返回 func main() { service := ":1200" - tcpAddr, err := net.ResolveTCPAddr("ip4", service) + tcpAddr, err := net.ResolveTCPAddr("tcp4", service) checkError(err) listener, err := net.ListenTCP("tcp", tcpAddr) checkError(err) From 2fe09fc130f91f4ec67e3496a5d02c76eb788308 Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Sun, 25 Nov 2012 23:25:13 +0800 Subject: [PATCH 21/49] =?UTF-8?q?=E5=AE=8C=E6=88=90=E4=BA=86=E7=AC=AC12?= =?UTF-8?q?=E7=AB=A0=E7=9A=84=E5=86=99=E4=BD=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 12.4.md | 168 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 12.5.md | 12 ++++ 2 files changed, 180 insertions(+) diff --git a/12.4.md b/12.4.md index 406a3920..0cf69a5a 100644 --- a/12.4.md +++ b/12.4.md @@ -1,5 +1,173 @@ # 12.4 备份和恢复 +这小节我们要讨论应用程序管理的另一个方面：生成服务器上数据的备份和恢复。我们经常会遇到生成服务器的网络断了、硬盘坏了、操作系统奔溃、或者数据库不可用了等各种情况，所以我需要对我们的生成服务器上的应用、数据做异地灾备，冷备热备。在下面的介绍中，将讲解如何备份应用、如何备份Mysql数据库以及将其恢复，如何备份redis数据库以及恢复。 +## 应用备份 +在大多数集群坏境下，Web应用程序基本不需要备份，因为这个其实就是一个代码副本，我们在本地开发环境中，或者版本控制系统中已经保持了这些代码。但是很多时候，我们开发的站点需要用户动态来上传文件，那么我们需要对这些上传的文件进行备份，目前其实一种合适的做法是把和网站相关的需要存储的文件存储到云储存，这样即使系统奔溃我们的文件还在云储存，至少数据不会丢失。 + +如果我们没有采用云储存的情况下，如何做到网站的备份呢？这里我们介绍一个文件同步工具rsync：rsync能够实现网站的备份，文件的同步，不同系统的文件的同步，如果是windows的话，需要windows版本cwrsync。 + +### rsync安装 +rysnc的官方网站：http://rsync.samba.org/ 可以从上面获取最新版本的源码。当然，因为rsync是一款如此有用的软件，所以很多Linux的发行版本都将它收录在内了。 + +软件包安装 + + # sudo apt-get install rsync 注：在debian、ubuntu 等在线安装方法； + # yum install rsync 注：Fedora、Redhat、CentOS 等在线安装方法； + # rpm -ivh rsync 注：Fedora、Redhat、CentOS 等rpm包安装方法； + +其它Linux发行版，请用相应的软件包管理方法来安装。源码包安装 + + tar xvf rsync-xxx.tar.gz + cd rsync-xxx + ./configure --prefix=/usr ;make ;make install 注：在用源码包编译安装之前，您得安装gcc等编译开具才行； + +### rsync配置 +rsync主要有以下三个配置文件rsyncd.conf(主配置文件)、rsyncd.secrets(密码文件)、rsyncd.motd(rysnc服务器信息)。 + +关于这几个文件的配置大家可以参考官方网站或者其他介绍rsync的网站，下面介绍服务器端和客户端如何开启 + +- 服务端开启： + + #/usr/bin/rsync --daemon --config=/etc/rsyncd/rsyncd.conf + + --daemon参数方式，是让rsync以服务器模式运行。把rsync加入开机启动 + + echo 'rsync --daemon' >> /etc/rc.d/rc.local + + 设置rsync密码 + + echo '你的用户名:你的密码' > /etc/rsyncd.secrets + chmod 600 /etc/rsyncd.secrets + + +- 客户端同步： + + 客户端可以通过如下命令同步服务器但的文件： + + rsync -avzP --delete --password-file=rsyncd.secrets 用户名@192.168.145.5::www /var/rsync/backup + + 这条命令，简要的说明一下几个要点： + + 1. -avzP是啥，读者可以使用--help查看 + 2. --delete 是为了比如A上删除了一个文件，同步的时候，B会自动删除那个文件 + 3. --password-file 客户端中/etc/rsyncd.secrets设置的密码，要和服务端的 /etc/rsyncd.secrets 中的密码一样，这样cron运行的时候，就不需要密码了 + 4. 这条命令中的"用户名"为服务端的 /etc/rsyncd.secrets中的用户名 + 5. 这条命令中的 192.168.0.100 为服务端的IP地址 + 6. ::www，注意是2个 : 号，www为服务端的配置文件 /etc/rsyncd.conf 中的[www]，意思是根据服务端上的/etc/rsyncd.conf来同步其中的[www]段内容，一个 : 号的时候，用于不根据配置文件，直接同步指定目录。 + + 为了让同步实时性，可以设置crontab，保持rsync每分钟同步，当然用户也可以根据文件的重要程度设置不同的同步频率。 + + +## MySQL备份 +应用数据库目前还是MySQL为主流，目前MySQL的备份有两种方式：热备份和冷备份，热备份目前主要是采用master/slave方式，关于如何配置这方面的资料，大家可以找到很多。master/slave方式的同步目前主要用于读写分离，其实也可以用于热备份数据。冷备份的话就是数据有一定的延迟，但是可以保证该时间段之前的数据完整，例如有些时候可能我们的误操作引起了数据的丢失，那么master/slave模式是无法找回丢失数据的，但是通过冷备份可以部分恢复数据。 + +冷备份一般使用shell脚本定时的备份数据库，然后通过上面介绍rsync同步到异地机房的一台服务器。 + +下面这个是定时备份mysql的备份脚本，我们使用了mysqldump程序，这个命令可以把数据库导出到一个文件中。 + + #!/bin/bash + + # 以下配置信息请自己修改 + mysql_user="USER" #MySQL备份用户 + mysql_password="PASSWORD" #MySQL备份用户的密码 + mysql_host="localhost" + mysql_port="3306" + mysql_charset="utf8" #MySQL编码 + backup_db_arr=("db1" "db2") #要备份的数据库名称，多个用空格分开隔开 如("db1" "db2" "db3") + backup_location=/var/www/mysql #备份数据存放位置，末尾请不要带"/",此项可以保持默认，程序会自动创建文件夹 + expire_backup_delete="ON" #是否开启过期备份删除 ON为开启 OFF为关闭 + expire_days=3 #过期时间天数 默认为三天，此项只有在expire_backup_delete开启时有效 + + # 本行开始以下不需要修改 + backup_time=`date +%Y%m%d%H%M` #定义备份详细时间 + backup_Ymd=`date +%Y-%m-%d` #定义备份目录中的年月日时间 + backup_3ago=`date -d '3 days ago' +%Y-%m-%d` #3天之前的日期 + backup_dir=$backup_location/$backup_Ymd #备份文件夹全路径 + welcome_msg="Welcome to use MySQL backup tools!" #欢迎语 + + # 判断MYSQL是否启动,mysql没有启动则备份退出 + mysql_ps=`ps -ef |grep mysql |wc -l` + mysql_listen=`netstat -an |grep LISTEN |grep $mysql_port|wc -l` + if [ [$mysql_ps == 0] -o [$mysql_listen == 0] ]; then + echo "ERROR:MySQL is not running! backup stop!" + exit + else + echo $welcome_msg + fi + + # 连接到mysql数据库，无法连接则备份退出 + mysql -h$mysql_host -P$mysql_port -u$mysql_user -p$mysql_password < $backup_dir/$dbname-$backup_time.sql.gz` + flag=`echo $?` + if [ $flag == "0" ];then + echo "database $dbname success backup to $backup_dir/$dbname-$backup_time.sql.gz" + else + echo "database $dbname backup fail!" + fi + + done + else + echo "ERROR:No database to backup! backup stop" + exit + fi + # 如果开启了删除过期备份，则进行删除操作 + if [ "$expire_backup_delete" == "ON" -a "$backup_location" != "" ];then + #`find $backup_location/ -type d -o -type f -ctime +$expire_days -exec rm -rf {} \;` + `find $backup_location/ -type d -mtime +$expire_days | xargs rm -rf` + echo "Expired backup data delete complete!" + fi + echo "All database backup success! Think you!" + exit + fi + +修改shell脚本的属性： + + chmod 600 /root/mysql_backup.sh + chmod +x /root/mysql_backup.sh + +设置好属性之后，把命令加入crontab，我们设置了每天00:00定时自动备份，然后把备份的脚本目录/var/www/mysql设置为rsync同步目录。 + + 00 00 * * * /root/mysql_backup.sh + +## MySQL恢复 +前面介绍MySQL备份分为热备份和冷备份，热备份主要是目的是为了能够实时的恢复，例如应用服务器出现了硬盘故障，那么我们可以通过修改配置文件把数据库的读取和写入改成slave，这样就可以尽量少时间的中断服务。 + +但是有时候我们需要通过冷备份的SQL会进行数据恢复，既然有了数据库的备份，就可以通过命令导入： + + mysql -u username -p databse < backup.sql + +可以看到，导出和导入数据库数据都是相当简单，不过如果还需要管理权限，或者其他的一些字符集的设置的话，可能会稍微复杂一些，但是这些都是可以通过一些命令来完成的。 + +## redis备份 +redis是目前我们使用最多的NOSQL，它的备份也分为两种：热备份和冷备份，redis也支持master/slave模式，所以我们的热备份可以通过这种方式实现，相应的配置大家可以参考官方的文档配置，相当的简单。我们这里介绍冷备份的方式：redis其实会定时的把内存里面的缓存数据保存到数据库文件里面，我们备份只要备份相应的文件就可以，然后利用前面介绍的rsync备份到异地机房就可以实现。 + +## redis恢复 +redis的恢复分为热备份恢复和冷备份恢复，热备份恢复的目的和方法同MySQL的恢复一样，只要修改应用的相应的数据库连接即可。 + +但是有时候我们需要根据冷备份来恢复数据，redis的冷备份恢复其实就是只要把保存的数据库文件copy到redis的编译目录，然后启动redis就可以了，redis在启动的时候会自动加载数据库文件到内存中，启动的速度根据数据库的文件大小来决定。 + +## 小结 +本小节介绍了当我们应用部分完毕之后，如何做好灾备，包括文件的备份、数据库的备份，这里我们介绍了rsync如何同步文件，MySQL数据库和redis数据库如何备份和恢复，希望通过本小节的介绍，能够让作为开发的你对于线上产品的灾备方案提供一个参考。 + ## links * [目录]() * 上一章: [应用部署](<12.3.md>) diff --git a/12.5.md b/12.5.md index 2b3296b8..8bd84a26 100644 --- a/12.5.md +++ b/12.5.md @@ -1,4 +1,16 @@ # 12.5 小结 +本章讨论了如何部署和维护我们开发的Web应用相关的一些话题。这些内容非常重要，要创建一个能够基于最小维护平滑运行的应用，必须考虑这些问题。 + +具体而言，本章讨论的内容包括： + +- 创建一个强健的日志系统，可以在出现问题时记录错误并且通知系统管理员 +- 处理运行时可能出现的错误，包括记录日志，并如何友好的显示给用户系统出现了问题 +- 处理404错误，告诉用户请求的页面找不到 +- 将应用部署到一个生产环境中(包括如何部署更新) +- 如何让部署的应用程序具有高可用 +- 备份和恢复文件以及数据库 + +读完本章内容后，对于从头开始开发一个Web应用需要考虑那些问题，你应该已经有了全面的了解。本章内容将有助于你在实际环境中管理前面各章介绍开发的代码。 ## links * [目录]() From abcc9578ccdf89c44e14a5f776bb1013e8c7a840 Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Mon, 26 Nov 2012 23:44:15 +0800 Subject: [PATCH 22/49] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E4=BA=86=E5=8D=9A?= =?UTF-8?q?=E5=AE=A2=E7=9A=84=E7=9B=AE=E5=BD=95=E7=BB=93=E6=9E=84=EF=BC=8C?= =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E4=BA=86=E7=AC=AC=E5=8D=81=E4=B8=89=E7=AB=A0?= =?UTF-8?q?=E7=9A=84=E9=93=BE=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- preface.md | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/preface.md b/preface.md index d2523971..be699065 100644 --- a/preface.md +++ b/preface.md @@ -76,16 +76,17 @@ - 12.3 [应用部署](12.3.md) - 12.4 [备份和恢复](12.4.md) - 12.5 [小结](12.5.md) -* 13.构建博客系统　 - - 13.1 创建数据库表　 - - 13.2 建立对象类 - - 13.3 创建控制器管理博客帖子 - - 13.4 创建和编辑博客帖子　 - - 13.5 预览博客帖子 - - 13.6 更新博客帖子的状态 - - 13.7 小结　 -* 14.扩展博客管理系统　 - - 14.1 在博客管理系统索引页面上列出帖子 - - 14.2 为博客各月概要增加Ajax功能 - - 14.3 集成WYSIWYG编辑器 - - 14.4 小结　 \ No newline at end of file +* 13.[构建博客系统](13.md)　 + - 13.1 [项目规划](13.1.md)　 + - 13.2 [数据库设计](13.2.md) + - 13.3 [自定义路由器设计](13.3.md) + - 13.4 [controller设计](13.4.md) + - 13.5 [数据库操作](13.5.md) + - 13.6 [实现博客的增删改](13.6.md) + - 13.7 [小结](13.7.md)　 +* 14.扩展博客管理系统 + - 14.1 博客系统集成bootstrap + - 14.2 博客集成留言功能 + - 14.3 博客增加后台管理 + - 14.4 博客实现多模板设计 + - 14.5 小结 \ No newline at end of file From 96ac31bae27eaa2e5bbdcfd93d7afa2cfb601845 Mon Sep 17 00:00:00 2001 From: astaxie Date: Wed, 28 Nov 2012 18:22:57 +0800 Subject: [PATCH 23/49] =?UTF-8?q?=E5=BC=80=E5=A7=8B=E5=86=99=E7=AC=AC?= =?UTF-8?q?=E5=8D=81=E4=B8=89=E7=AB=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 13.1.md | 6 ++++++ 13.2.md | 6 ++++++ 13.3.md | 6 ++++++ 13.4.md | 6 ++++++ 13.5.md | 6 ++++++ 13.6.md | 6 ++++++ 13.7.md | 6 ++++++ 13.md | 18 ++++++++++++++++++ 8 files changed, 60 insertions(+) create mode 100644 13.1.md create mode 100644 13.2.md create mode 100644 13.3.md create mode 100644 13.4.md create mode 100644 13.5.md create mode 100644 13.6.md create mode 100644 13.7.md create mode 100644 13.md diff --git a/13.1.md b/13.1.md new file mode 100644 index 00000000..b61ad772 --- /dev/null +++ b/13.1.md @@ -0,0 +1,6 @@ +# 13.1 项目规划 + +## links + * [目录]() + * 上一章: [构建博客系统](<13.md>) + * 下一节: [数据库设计](<13.2.md>) \ No newline at end of file diff --git a/13.2.md b/13.2.md new file mode 100644 index 00000000..f98a79e7 --- /dev/null +++ b/13.2.md @@ -0,0 +1,6 @@ +# 13.2 数据库设计 + +## links + * [目录]() + * 上一章: [项目规划](<13.1.md>) + * 下一节: [自定义路由器设计](<13.3.md>) \ No newline at end of file diff --git a/13.3.md b/13.3.md new file mode 100644 index 00000000..13ec372d --- /dev/null +++ b/13.3.md @@ -0,0 +1,6 @@ +# 13.3 自定义路由器设计 + +## links + * [目录]() + * 上一章: [数据库设计](<13.2.md>) + * 下一节: [controller设计](<13.4.md>) \ No newline at end of file diff --git a/13.4.md b/13.4.md new file mode 100644 index 00000000..4848a591 --- /dev/null +++ b/13.4.md @@ -0,0 +1,6 @@ +# 13.4 controller设计 + +## links + * [目录]() + * 上一章: [自定义路由器设计](<13.3.md>) + * 下一节: [数据库操作](<13.5.md>) \ No newline at end of file diff --git a/13.5.md b/13.5.md new file mode 100644 index 00000000..ffb11496 --- /dev/null +++ b/13.5.md @@ -0,0 +1,6 @@ +# 13.5 数据库操作 + +## links + * [目录]() + * 上一章: [controller设计](<13.4.md>) + * 下一节: [实现博客的增删改](<13.6.md>) \ No newline at end of file diff --git a/13.6.md b/13.6.md new file mode 100644 index 00000000..650885b7 --- /dev/null +++ b/13.6.md @@ -0,0 +1,6 @@ +# 13.6 实现博客的增删改 + +## links + * [目录]() + * 上一章: [数据库操作](<13.5.md>) + * 下一节: [小结](<13.7.md>) \ No newline at end of file diff --git a/13.7.md b/13.7.md new file mode 100644 index 00000000..e5bdc66d --- /dev/null +++ b/13.7.md @@ -0,0 +1,6 @@ +# 13.7 小结 + +## links + * [目录]() + * 上一章: [实现博客的增删改](<13.6.md>) + * 下一节: [扩展博客管理系统](<14.md>) \ No newline at end of file diff --git a/13.md b/13.md new file mode 100644 index 00000000..44ad48b8 --- /dev/null +++ b/13.md @@ -0,0 +1,18 @@ +# 13 构建博客系统 +前面十二章介绍了如何通过Go来开发Web应用，介绍了很多基础知识、开发工具和开发技巧，那么我们这一章通过这些知识来实现一个简易的博客系统。通过Go语言来实现一个完整的项目，这项目中主要内容有第一小节介绍的项目的结构规划，例如采用MVC模式来进行开发，程序的执行流程设计等内容；第二小节介绍博客系统的一些数据库结构设计，如何存储博客评论之类的信息；第三小节介绍项目的第一个功能：路由，如何让访问的URL映射到相应的处理逻辑；第四小节介绍处理逻辑，如何设计一个公共的controller，对象继承之后处理函数中如何处理response和request；第五小节介绍如何处理业务逻辑的数据库，这里会采用beedb库进行数据库的操作；第六小节介绍整体的博客的发表、修改、删除、显示列表等操作。 + +通过这么一个完整的项目例子，我期望能够让读者了解如何开发Web应用，如何搭建自己的目录结构，如何实现路由，如何实现MVC模式等各方面的开发内容。在框架盛行的今天，MVC也不再是神话。经常听到很多程序员讨论哪个框架好，哪个框架不好， 其实框架只是工具，没有好与不好，只有适合与不适合，适合自己的就是最好的，所以教会大家自己动手写框架，那么不同的需求都可以用自己的思路去实现。 + +## 目录 + * 1 [项目规划](13.1.md)　 + * 2 [数据库设计](13.2.md) + * 3 [自定义路由器设计](13.3.md) + * 4 [controller设计](13.4.md) + * 5 [数据库操作](13.5.md) + * 6 [实现博客的增删改](13.6.md) + * 7 [小结](13.7.md)　 + +## links + * [目录]() + * 上一章: [第十一章总结](<11.4.md>) + * 下一节: [应用日志](<12.1.md>) \ No newline at end of file From 01a2a0ad54a58dbebf40b7d9e9876a3ce2d67a90 Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Wed, 28 Nov 2012 23:26:29 +0800 Subject: [PATCH 24/49] =?UTF-8?q?=E7=AC=AC=E5=8D=81=E4=B8=89=E7=AB=A0?= =?UTF-8?q?=E7=9A=84=E8=A7=84=E5=88=92?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 13.1.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/13.1.md b/13.1.md index b61ad772..45080b40 100644 --- a/13.1.md +++ b/13.1.md @@ -1,4 +1,11 @@ -# 13.1 项目规划 +# 13.1 项目规划 +## gopath以及项目设置 + +## 目录结构 + +## 应用程序流程图 + +## 总结 ## links * [目录]() From 2213bda20dee7de14da0ccee9c3d95206ddb7043 Mon Sep 17 00:00:00 2001 From: astaxie Date: Thu, 29 Nov 2012 17:23:41 +0800 Subject: [PATCH 25/49] =?UTF-8?q?=E5=AE=8C=E6=88=90=E4=BA=86=E7=AC=AC?= =?UTF-8?q?=E4=B8=80=E5=B0=8F=E8=8A=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 13.1.md | 36 ++++++++++++++++++++++++++++++++++-- images/13.1.flow.png | Bin 0 -> 17361 bytes images/13.1.gopath.png | Bin 0 -> 35302 bytes images/13.1.gopath2.png | Bin 0 -> 14374 bytes 4 files changed, 34 insertions(+), 2 deletions(-) create mode 100644 images/13.1.flow.png create mode 100644 images/13.1.gopath.png create mode 100644 images/13.1.gopath2.png diff --git a/13.1.md b/13.1.md index 45080b40..137401cf 100644 --- a/13.1.md +++ b/13.1.md @@ -1,12 +1,44 @@ # 13.1 项目规划 +做任何事情都需要做好规划，那么我们在开发博客系统之前，也需要多好项目的规划，如何设置目录结构，如何理解整个的流程图，当我们理解了应用的执行过程，那么接下来的设计编码就会变得相对容易了 ## gopath以及项目设置 +gopath是一个文件系统的目录，我们可以随便设置一个目录为gopath，前面介绍过gopath可以是多个目录，在window系统设置环境变量，在linux/MacOS系统只要`export gopath=/home/astaxie/gopath`，但是必须保证gopath目录下面有三个目录pkg、bin、src目录。我们新建的项目放在src目录下面，我们暂定我们的博客目录叫做beeblog，下面是我在window下的环境变量和目录结构的截图： -## 目录结构 +![](images/13.1.gopath.png?raw=true) + +![](images/13.1.gopath2.png?raw=true) ## 应用程序流程图 +博客系统是基于模型-视图-控制器这一设计模式的。MVC是一种将应用程序的逻辑层和表现层进行分离的方法。在实践中，由于表现层从Go中分离了出来，所以它允许你的网页中只包含很少的脚本。 + +- 模型 (Model) 代表你的数据结构。通常来说，你的模型类将包含取出、插入、更新你的数据库资料这些功能。 +- 视图 (View) 是展示给用户的信息。一个视图通常是一个网页，但是在Go中，一个视图也可以是一个页面片段，如页头、页尾。它还可以是一个 RSS 页面，或任何其它类型的“页面”，Go实现的template包已经很好的体现了View这个概念。 +- 控制器 (Controller) 是模型、视图以及其他任何处理HTTP请求所必须的资源之间的中介，并生成网页。 + +下图设计了我们接下来的博客系统数据流如何贯穿整个系统: + +![](images/13.1.flow.png?raw=true) + +1. main.go作为应用入口，初始化运行博客所需要的基本资源，配置信息，监听端口。 +2. 路由功能检查HTTP请求，根据URL以及method来确定谁来处理请求。 +3. 如果缓存文件存在，它将绕过通常的系统执行顺序，被直接发送给浏览器。 +4. 安全检测：应用程序控制器调用之前，HTTP请求和任何用户提交的数据将被过滤。 +5. 控制器装载模型、核心库、辅助函数，以及任何处理特定请求所需的其它资源，控制器主要处理业务逻辑。 +6. 输出视图用来渲染需要发送到Web浏览器中的内容。如果开启缓存，视图首先被缓存，所以将可用于以后的请求。 + +## 目录结构 +根据上面的应用程序流程设计，博客的目录结构设计如下： + + |——main.go 入口文件 + |——configs 配置文件和处理模块 + |——controllers 控制器入口 + |——core 最小化的MVC框架 + |——logs 日志处理模块 + |——models 数据库处理模块 + |——utils 辅助函数库 + |——views 视图库 ## 总结 - +本小节介绍了博客系统从设置gopath到目录建立这样的基础信息，也介绍了将要采用的MVC模式，博客系统中数据流的执行流程，最后通过这些流程设计了博客系统的目录结构，至此我们完成了一个大框架的搭建，接下来的几个小节我们将会逐个实现。 ## links * [目录]() * 上一章: [构建博客系统](<13.md>) diff --git a/images/13.1.flow.png b/images/13.1.flow.png new file mode 100644 index 0000000000000000000000000000000000000000..b47e5bfc57c87358f6db72b123f9285b737156cd GIT binary patch literal 17361 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 literal 0 HcmV?d00001 diff --git a/images/13.1.gopath2.png b/images/13.1.gopath2.png new file mode 100644 index 0000000000000000000000000000000000000000..450b410486aba5a91854cdafa2475ba05606bf6c GIT binary patch literal 14374 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 literal 0 HcmV?d00001 From d1e0da5f253eb0b0c6aab3ed5ac63abd23869579 Mon Sep 17 00:00:00 2001 From: magicx Date: Sat, 1 Dec 2012 16:20:11 +0800 Subject: [PATCH 26/49] Update 2.1.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit "Hello, world or 你好，世界 or καλημ ́ρα κóσμ or こんにちは世界\n" or "Hello, world or 你好，世界\n" or "Hello, world\n" ? --- 2.1.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/2.1.md b/2.1.md index a5031428..d68fc43b 100644 --- a/2.1.md +++ b/2.1.md @@ -13,12 +13,12 @@ import "fmt" func main() { - fmt.Printf("Hello, world or καλημ ́ρα κóσμ or こんにちは世界\n") + fmt.Printf("Hello, world or 你好，世界 or καλημ ́ρα κóσμ or こんにちは世界\n") } 输出如下： - Hello, world or καλημ ́ρα κóσμ or こんにちは世界 + Hello, world or 你好，世界 or καλημ ́ρα κóσμ or こんにちは世界 ## 详解 首先我们要了解一个概念，Go程序是通过`package`来组织的 From c0940a326dfdf08e5427b40b760c5f2e7d86d05d Mon Sep 17 00:00:00 2001 From: maxupeng Date: Tue, 4 Dec 2012 16:29:57 +0800 Subject: [PATCH 27/49] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E9=94=99=E5=88=AB?= =?UTF-8?q?=E5=AD=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 3.4.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/3.4.md b/3.4.md index 59738931..bca74e83 100644 --- a/3.4.md +++ b/3.4.md @@ -22,7 +22,7 @@ Go在等待客户端请求里面是这样写的： 它的结构如下： type ServeMux struct { - mu sync.RWMutex //锁，由于请求设计到并发处理，因此这里需要一个锁机制 + mu sync.RWMutex //锁，由于请求涉及到并发处理，因此这里需要一个锁机制 m map[string]muxEntry // 路由规则，一个string对应一个mux实体，这里的string就是注册的路由表达式 } From 2948f20eddc4093c9da8c7ab18e7e6e8a9713e62 Mon Sep 17 00:00:00 2001 From: maxupeng Date: Tue, 4 Dec 2012 16:31:22 +0800 Subject: [PATCH 28/49] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E8=A1=A8=E5=8D=95?= =?UTF-8?q?=E8=A7=A3=E6=9E=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 4.1.md | 1 + 1 file changed, 1 insertion(+) diff --git a/4.1.md b/4.1.md index 956de5ef..f855e196 100644 --- a/4.1.md +++ b/4.1.md @@ -45,6 +45,7 @@ http包里面有一个很简单的方式就可以获取，我们在前面web的 } func login(w http.ResponseWriter, r *http.Request) { + r.ParseForm() fmt.Println("method:", r.Method) //获取请求的方法 if r.Method == "GET" { t, _ := template.ParseFiles("login.gtpl") From 0dd4c79fb0e87e8a9bfe9ef45fd653e56aaa5a3d Mon Sep 17 00:00:00 2001 From: gan weiliang Date: Tue, 4 Dec 2012 21:25:52 +0800 Subject: [PATCH 29/49] =?UTF-8?q?=E5=BA=94=E8=AF=A5=E5=8A=A0=E4=B8=80?= =?UTF-8?q?=E8=A1=8Ccd=20mathapp?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 1.2.md | 1 + 1 file changed, 1 insertion(+) diff --git a/1.2.md b/1.2.md index 1f5db4c7..1800954b 100644 --- a/1.2.md +++ b/1.2.md @@ -70,6 +70,7 @@ GOPATH允许多个目录，当有多个目录时，请注意分隔符，多个GO cd $GOPATH/src mkdir mathapp + cd mathapp vim main.go // `$GOPATH/src/mathapp/main.go`源码： From e5885ebfd4a6cacbfb22dd7028b14ca150f0177c Mon Sep 17 00:00:00 2001 From: gan weiliang Date: Wed, 5 Dec 2012 01:22:19 +0800 Subject: [PATCH 30/49] =?UTF-8?q?=E8=BF=99=E9=87=8C=E5=BA=94=E8=AF=A5?= =?UTF-8?q?=E6=9C=89=E6=96=AD=E8=A1=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 2.2.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/2.2.md b/2.2.md index 80bab5ad..0da3c61b 100644 --- a/2.2.md +++ b/2.2.md @@ -104,7 +104,9 @@ Go对于已声明但未使用的变量会在编译阶段报错，比如下面的 >如下的代码会产生错误 > >> var a int8 + >> var b int32 + >> c:=a + b > >另外，尽管int的长度是32 bit, 但int 与 int32并不可以互用。 From d2aca883eb3af42423ec876b787c8da55fcaee95 Mon Sep 17 00:00:00 2001 From: astaxie Date: Thu, 6 Dec 2012 17:33:09 +0800 Subject: [PATCH 31/49] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E4=BA=86=E5=8D=81?= =?UTF-8?q?=E4=B8=89=E7=AB=A0=E7=9A=84=E4=B8=80=E4=BA=9B=E5=86=85=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 13.1.md | 18 ++-- 13.2.md | 308 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 318 insertions(+), 8 deletions(-) diff --git a/13.1.md b/13.1.md index 137401cf..d1727dd9 100644 --- a/13.1.md +++ b/13.1.md @@ -29,17 +29,19 @@ gopath是一个文件系统的目录，我们可以随便设置一个目录为go 根据上面的应用程序流程设计，博客的目录结构设计如下： |——main.go 入口文件 - |——configs 配置文件和处理模块 + |——conf 配置文件和处理模块 |——controllers 控制器入口 - |——core 最小化的MVC框架 - |——logs 日志处理模块 |——models 数据库处理模块 |——utils 辅助函数库 + |——static 静态文件目录 |——views 视图库 -## 总结 -本小节介绍了博客系统从设置gopath到目录建立这样的基础信息，也介绍了将要采用的MVC模式，博客系统中数据流的执行流程，最后通过这些流程设计了博客系统的目录结构，至此我们完成了一个大框架的搭建，接下来的几个小节我们将会逐个实现。 -## links - * [目录]() - * 上一章: [构建博客系统](<13.md>) +## 框架设计 +为了实现博客的快速搭建，打算基于上面的流程设计开发一个最小化的框架，框架包括路由功能、支持REST的控制器、自动化的模板渲染，日志系统、配置管理。 + +## 总结 +本小节介绍了博客系统从设置gopath到目录建立这样的基础信息，也介绍了将要采用的MVC模式，博客系统中数据流的执行流程，最后通过这些流程设计了博客系统的目录结构，至此我们完成了一个大框架的搭建，接下来的几个小节我们将会逐个实现。 +## links + * [目录]() + * 上一章: [构建博客系统](<13.md>) * 下一节: [数据库设计](<13.2.md>) \ No newline at end of file diff --git a/13.2.md b/13.2.md index f98a79e7..541cc920 100644 --- a/13.2.md +++ b/13.2.md @@ -1,5 +1,313 @@ # 13.2 数据库设计 +我们设计的博客是一个单用户的博客，目前很多用户都采用wordpress作为自己的博客系统，包括我自己也在使用wordpress,我们知道wordpress系统的一个主页乐观的估计也有20余次查询，但这依然无法阻挡这款程序的流行,在去年对全球top10 blogger所使用的系统调查中,wordpress比其他系统有着明显的优势。 +但是我们这次演示的博客系统是一个单用户的系统所以查询肯定不需要20余次，数据库的结构也相对的简单很多，因此单用户系统设计重点在于灵活性和结构化,当我们集中地暴露系统瓶颈,从另一个方面也可以集中精力去解决它。例如把数据库从MySQL改成redis。 + +博客主要分为博文、分类、页面、评论、用户、友情链接、tag，那么我们可以采用内容表存储一些实体相关的信息：文章内容、草稿、页面等信息，meta表保存分类、tag等信息，关系表维护两者的关系，评论表存储用户的评论，用户表存储博客用户的信息。 + +## 内容表 +这张表主要用来存储内容实体信息,主要的表结构如下所示 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
键名类型属性解释
cidint(10)主键,非负,自增post表主键
titlevarchar(200)可为空内容标题
slugvarchar(200)索引,可为空内容缩略名
createdint(10)索引,非负,可为空内容生成时的GMT unix时间戳
modifiedint(10)非负,可为空内容更改时的GMT unix时间戳
texttext可为空内容文字
orderint(10)非负,可为空排序
orderint(10)非负,可为空排序
authorIdint(10)非负,可为空内容所属用户id
typevarchar(16)可为空内容类别
statusvarchar(16)可为空内容状态
passwordvarchar(32)可为空受保护内容,此字段对应内容保护密码
commentsNumint(10)非负,可为空内容所属评论数,冗余字段
+ +## 关系表 +这张表维护着内容表和扩展表之间的关系 + + + + + + + + + + + + + + + + + + + + +
键名类型属性解释
cidint(10)主键,非负内容主键
midint(10)主键,非负扩展表主键
+ +## meta表 +这张表主要用来存储和内容相关联的一些扩展信息，包括tag、分类之类的信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
键名类型属性解释
midint(10)主键,非负扩展表主键
namevarchar(200)可为空名称
slugvarchar(200)索引,可为空扩展缩略名
typevarchar(32)可为空扩展类型
descriptionvarchar(200)可为空扩展描述
countint(10)非负,可为空扩展所属内容个数，冗余字段
orderint(10)非负,可为空扩展排序
+ + +## 评论表 +实体内容表相应的评论信息表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
键名类型属性解释
coidint(10)主键,非负,自增comment表主键
cidint(10)索引,非负post表主键,关联字段
cidint(10)索引,非负post表主键,关联字段
createdint(10)非负,可为空评论生成时的GMT unix时间戳
texttext可为空评论内容
typevarchar(16)可为空评论类型
statusvarchar(16)可为空评论状态
authorvarchar(200)可为空评论用户
+ +## 用户表 +存储博客系统中用户的信息： + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
键名类型属性解释
uidint(10)主键,非负,自增user表主键
usernamevarchar(32)唯一用户名
passwordvarchar(32)可为空用户密码
createdint(10)非负,可为空用户注册时的GMT unix时间戳
lastloginint(10)非负,可为空最后登录时间
+## 配置表 +网站的配置信息表： + + + + + + + + + + + + + + + + + + + + + + + + + + +
键名类型属性解释
namevarchar(32)主键配置名称
uidint(10)主键,非负配置所属用户,默认为0(全局配置)
valuetext主键,非负,自增配置值
+ +上面设计了一个完整的博客系统所拥有的一些功能的表，基于这些表我们可以设计出来一个强大的单用户博客，基本能够实现wordpress的一些基础单用户博客的功能。 ## links * [目录]() * 上一章: [项目规划](<13.1.md>) From 03f9b2a801d4e029914c489551bad608926bd397 Mon Sep 17 00:00:00 2001 From: Lonre Wang Date: Fri, 7 Dec 2012 00:57:46 +0800 Subject: [PATCH 32/49] =?UTF-8?q?=E5=88=A0=E9=99=A4=E5=86=85=E5=AE=B9?= =?UTF-8?q?=E8=A1=A8=E4=B8=AD=E9=87=8D=E5=A4=8D=E5=AE=9A=E4=B9=89=E7=9A=84?= =?UTF-8?q?=20order=20=E5=AD=97=E6=AE=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 13.2.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/13.2.md b/13.2.md index 541cc920..fdb0a29b 100644 --- a/13.2.md +++ b/13.2.md @@ -58,12 +58,6 @@ 排序 -order -int(10) -非负,可为空 -排序 - - authorId int(10) 非负,可为空 From 31025b56ef7ac6e143288064e6beb0f69dc93b89 Mon Sep 17 00:00:00 2001 From: JessonChan Date: Fri, 7 Dec 2012 09:26:24 +0800 Subject: [PATCH 33/49] =?UTF-8?q?=E6=8E=AA=E8=BE=9E=E5=92=8C=E5=91=BD?= =?UTF-8?q?=E5=90=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit RT --- 4.1.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/4.1.md b/4.1.md index 956de5ef..00035562 100644 --- a/4.1.md +++ b/4.1.md @@ -1,6 +1,6 @@ # 4.1处理表单的输入 -我们先来看一个表单递交的例子，我们有如下的表单内容，命名成文件login.gtpl(放入当前新建项目的目录里面) +先来看一个表单递交的例子，我们有如下的表单内容，命名成文件login.gtpl(放入当前新建项目的目录里面) @@ -32,7 +32,7 @@ http包里面有一个很简单的方式就可以获取，我们在前面web的 func sayhelloName(w http.ResponseWriter, r *http.Request) { r.ParseForm() //解析url传递的参数，对于POST则解析响应包的主体（request body） - //注意:如果没有调用parseForm方法，下面无法获取表单的数据 + //注意:如果没有调用ParseForm方法，下面无法获取表单的数据 fmt.Println(r.Form) //这些信息是输出到服务器端的打印信息 fmt.Println("path", r.URL.Path) fmt.Println("scheme", r.URL.Scheme) From edc41d01e20470c9534ab4dc5622390b18393c81 Mon Sep 17 00:00:00 2001 From: JessonChan Date: Fri, 7 Dec 2012 09:34:39 +0800 Subject: [PATCH 34/49] modified --- 4.2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4.2.md b/4.2.md index 9113fb05..fdd6455e 100644 --- a/4.2.md +++ b/4.2.md @@ -1,6 +1,6 @@ # 4.2验证表单的输入 -我们开发Web的一个原则就是，不能信任用户输入的任何信息，所以验证和过滤用户的输入信息就变得非常重要，我们经常会在微博、新闻中听到某某网站被入侵了，存在什么漏洞，这些大多是是因为网站对于用户输入的信息没有做严格的验证引起的，所以为了编写出安全可靠的Web程序，验证表单输入的意义重大。 +开发Web的一个原则就是，不能信任用户输入的任何信息，所以验证和过滤用户的输入信息就变得非常重要，我们经常会在微博、新闻中听到某某网站被入侵了，存在什么漏洞，这些大多是是因为网站对于用户输入的信息没有做严格的验证引起的，所以为了编写出安全可靠的Web程序，验证表单输入的意义重大。 我们平常编写Web应用主要有两方面的数据验证，一个是在页面端的js验证(目前在这方面有很多的插件库，比如ValidationJS插件)，一个是在服务器端的验证，我们这小节讲解的是如何在服务器端验证。 From 4674fae3512f1f6c9e1d5d205352feebbd8a4c50 Mon Sep 17 00:00:00 2001 From: astaxie Date: Fri, 7 Dec 2012 10:59:53 +0800 Subject: [PATCH 35/49] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E4=BB=A3=E7=A0=81?= =?UTF-8?q?=E7=9A=84bug?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 7.1.md | 442 ++++++++++++++++++++++++++++----------------------------- 1 file changed, 221 insertions(+), 221 deletions(-) diff --git a/7.1.md b/7.1.md index ca7096fd..4ccb6e0c 100644 --- a/7.1.md +++ b/7.1.md @@ -1,221 +1,221 @@ -# 7.1 XML处理 -XML作为一种数据交换和信息传递的格式已经十分普及。而随着Web服务日益广泛的应用，现在XML在日常的开发工作中也扮演了愈发重要的角色。这一小节， 我们将就Go语言标准包中的XML相关处理的包进行介绍。 - -这个小节不会涉及XML规范相关的内容（如需了解相关知识请参考其他文献），而是介绍如何用Go语言来编解码XML文件相关的知识。 - -假如你是一名运维人员，你为你所管理的所有服务器生成了如下内容的xml的配置文件： - - - - - Shanghai_VPN - 127.0.0.1 - - - Beijing_VPN - 127.0.0.2 - - - -上面的XML文档描述了两个服务器的信息，包含了服务器名和服务器的IP信息，接下来的Go例子以此XML描述的信息进行操作。 - -## 解析XML -如何解析如上这个XML文件喃呢？ 我们可以通过xml包的`Unmarshal`函数来达到我们的目的 - - func Unmarshal(data []byte, v interface{}) error - -data接收的是XML数据流，v是需要输出的结构，定义为interface，也就是可以把XML转换为任意的格式。我们这里主要介绍struct的转换，因为struct和XML都有类似树结构的特征。 - -示例代码如下： - - package main - - import ( - "encoding/xml" - "fmt" - "io/ioutil" - "os" - ) - - type Recurlyservers struct { - XMLName xml.Name `xml:"servers"` - Version string `xml:"version,attr"` - Svs []server `xml:"server"` - Description string `xml:",innerxml"` - } - - type server struct { - XMLName xml.Name `xml:"server"` - ServerName string `xml:"serverName"` - ServerIP string `xml:"serverIP"` - } - - func main() { - file, err := os.Open("servers.xml") // For read access. - defer file.Close() - if err != nil { - fmt.Printf("error: %v", err) - return - } - data, err := ioutil.ReadAll(file) - if err != nil { - fmt.Printf("error: %v", err) - return - } - v := Recurlyservers{} - err = xml.Unmarshal(data, &v) - if err != nil { - fmt.Printf("error: %v", err) - return - } - - fmt.Println(v) - } - - -XML本质上是一种树形的数据格式，而我们可以定义与之匹配的go 语言的 struct类型，然后通过xml.Unmarshal来将xml中的数据解析成对应的struct对象。如上例子输出如下数据 - - {{ servers} 1 [{{ server} Shanghai_VPN 127.0.0.1} {{ server} Beijing_VPN 127.0.0.2}] - - Shanghai_VPN - 127.0.0.1 - - - Beijing_VPN - 127.0.0.2 - - } - - -上面的例子中，将xml文件解析成对应的strcut对象是通过`xml.Unmarshal`来完成的，这个过程是如何实现的？可以看到我们的struct定义后面多了一些类似于`xml:"serverName"`这样的内容,这个是strcut的一个特性，它们被称为 strcut tag，它们是用来辅助反射的。我们来看一下`Unmarshal`的定义： - - func Unmarshal(data []byte, v interface{}) error - -我们看到函数定义了两个参数，第一个是XML数据流，第二个是存储的对应类型，目前支持struct、slice和string，XML包内部采用了反射来进行数据的映射，所以v里面的字段必须是导出的。`Unmarshal`解析的时候XML元素和字段怎么对应起来的呢？这是有一个优先级读取流程的，首先会读取struct tag，如果没有，那么就会对应字段名。必须注意一点的是解析的时候tag、字段名、XML元素都是大小写敏感的，所以必须一一对应字段。 - -Go语言的反射机制，可以利用这些tag信息来将来自XML文件中的数据反射成对应的struct对象，关于反射如何利用struct tag的更多内容请参阅reflect中的相关内容。 - -解析XML到struct的时候遵循如下的规则： - -- 如果struct的一个字段是string或者[]byte类型且它的tag含有`",innerxml"`，Unmarshal将会将此字段所对应的元素内所有内嵌的原始xml累加到此字段上，如上面例子Description定义。最后的输出是 - - - Shanghai_VPN - 127.0.0.1 - - - Beijing_VPN - 127.0.0.2 - - -- 如果struct中有一个叫做XMLName，且类型为xml.Name字段，那么在解析的时候就会保存这个element的名字到该字段,如上面例子中的servers。 -- 如果某个struct字段的tag定义中含有XML结构中element的名称，那么解析的时候就会把相应的element值赋值给该字段，如上servername和serverip定义。 -- 如果某个struct字段的tag定义了中含有`",attr"`，那么解析的时候就会将该结构所对应的element的与字段同名的属性的值赋值给该字段，如上version定义。 -- 如果某个struct字段的tag定义 型如`"a>b>c"`,则解析的时候，会将xml结构a下面的b下面的c元素的值赋值给该字段。 -- 如果某个struct字段的tag定义了`"-"`,那么不会为该字段解析匹配任何xml数据。 -- 如果struct字段后面的tag定义了`",any"`，如果他的子元素在不满足其他的规则的时候就会匹配到这个字段。 -- 如果某个XML元素包含一条或者多条注释，那么这些注释将被累加到第一个tag含有",comments"的字段上，这个字段的类型可能是[]byte或string,如果没有这样的字段存在，那么注释将会被抛弃。 - -上面详细讲述了如何定义struct的tag。 只要设置对了tag，那么XML解析就如上面示例般简单，tag和XML的element是一一对应的关系，如上所示，我们还可以通过slice来表示多个同级元素。 - ->注意： 为了正确解析，go语言的xml包要求struct定义中的所有字段必须是可导出的（即首字母大写） - -## 输出XML -假若我们不是要解析如上所示的XML文件，而是生成它，那么在go语言中又该如何实现呢？ xml包中提供了`Marshal`和`MarshalIndent`两个函数，来满足我们的需求。这两个函数主要的区别是第二个函数会增加前缀和缩进，函数的定义如下所示： - - func Marshal(v interface{}) ([]byte, error) - func MarshalIndent(v interface{}, prefix, indent string) ([]byte, error) - -两个函数第一个参数是用来生成XML的结构定义类型数据，都是返回生成的XML数据流。 - -下面我们来看一下如何输出如上的XML： - - package main - - import ( - "encoding/xml" - "fmt" - "os" - ) - - type Servers struct { - XMLName xml.Name `xml:"servers"` - Version string `xml:"version,attr"` - Svs []server `xml:"server"` - } - - type server struct { - ServerName string `xml:"serverName"` - ServerIP string `xml:"serverIP"` - } - - func main() { - v := &Servers{Version: "1"} - v.Svs = append(v.Svs, server{"Shanghai_VPN", "127.0.0.1"}) - v.Svs = append(v.Svs, server{"Beijing_VPN", "127.0.0.2"}) - output, err := xml.MarshalIndent(v, " ", " ") - if err != nil { - fmt.Printf("error: %v\n", err) - } - os.Stdout.Write([]byte(xml.Header)) - - os.Stdout.Write(output) - } -上面的代码输出如下信息： - - - - - Shanghai_VPN - 127.0.0.1 - - - Beijing_VPN - 127.0.0.2 - - - -和我们之前定义的文件的格式一模一样，之所以会有`os.Stdout.Write([]byte(xml.Header))` 这句代码的出现，是因为`xml.MarshalIndent`或者`xml.Marshal`输出的信息都是不带XML头的，为了生成正确的xml文件，我们使用了xml包预定义的Header变量。 - -我们看到`Marshal`函数接收的参数v是interface{}类型的，即它可以接受任意类型的参数，那么xml包，根据什么规则来生成相应的XML文件呢？ - -- 如果v是 array或者slice，那么输出每一个元素，类似value -- 如果v是指针，那么会Marshal指针指向的内容，如果指针为空，什么都不输出 -- 如果v是interface，那么就处理interface所包含的数据 -- 如果v是其他数据类型，就会输出这个数据类型所拥有的字段信息 - -生成的XML文件中的element的名字又是根据什么决定的呢？元素名按照如下优先级从struct中获取： - -- 如果v是struct，XMLName的tag中定义的名称 -- 类型为xml.Name的名叫XMLName的字段的值 -- 通过strcut中字段的tag来获取 -- 通过strcut的字段名用来获取 -- marshall的类型名称 - -我们应如何设置struct 中字段的tag信息以控制最终xml文件的生成呢？ - -- XMLName不会被输出 -- tag中含有`"-"`的字段不会输出 -- tag中含有`"name,attr"`，会以name作为属性名，字段值作为值输出为这个XML元素的属性，如上version字段所描述 -- tag中含有`",attr"`，会以这个struct的字段名作为属性名输出为XML元素的属性，类似上一条，只是这个name默认是字段名了。 -- tag中含有`",chardata"`，输出为xml的 character data而非element。 -- tag中含有`",innerxml"`，将会被原样输出，而不会进行常规的编码过程 -- tag中含有`",comment"`，将被当作xml注释来输出，而不会进行常规的编码过程，字段值中不能含有"--"字符串 -- tag中含有`"omitempty"`,如果该字段的值为空值那么该字段就不会被输出到XML，空值包括：false、0、nil指针或nil接口，任何长度为0的array, slice, map或者string -- tag中含有`"a>b>c"`，那么就会循环输出三个元素a包含b，b包含c，例如如下代码就会输出 - - FirstName string `xml:"name>first"` - LastName string `xml:"name>last"` - - - Asta - Xie - - - -上面我们介绍了如何使用Go语言的xml包来编/解码XML文件，重要的一点是对XML的所有操作都是通过struct tag来实现的，所以学会对struct tag的运用变得非常重要，在文章中我们简要的列举了如何定义tag。更多内容或tag定义请参看相应的官方资料。 - -## links - * [目录]() - * 上一节: [文本处理](<7.md>) - * 下一节: [Json处理](<7.2.md>) +# 7.1 XML处理 +XML作为一种数据交换和信息传递的格式已经十分普及。而随着Web服务日益广泛的应用，现在XML在日常的开发工作中也扮演了愈发重要的角色。这一小节， 我们将就Go语言标准包中的XML相关处理的包进行介绍。 + +这个小节不会涉及XML规范相关的内容（如需了解相关知识请参考其他文献），而是介绍如何用Go语言来编解码XML文件相关的知识。 + +假如你是一名运维人员，你为你所管理的所有服务器生成了如下内容的xml的配置文件： + + + + + Shanghai_VPN + 127.0.0.1 + + + Beijing_VPN + 127.0.0.2 + + + +上面的XML文档描述了两个服务器的信息，包含了服务器名和服务器的IP信息，接下来的Go例子以此XML描述的信息进行操作。 + +## 解析XML +如何解析如上这个XML文件喃呢？ 我们可以通过xml包的`Unmarshal`函数来达到我们的目的 + + func Unmarshal(data []byte, v interface{}) error + +data接收的是XML数据流，v是需要输出的结构，定义为interface，也就是可以把XML转换为任意的格式。我们这里主要介绍struct的转换，因为struct和XML都有类似树结构的特征。 + +示例代码如下： + + package main + + import ( + "encoding/xml" + "fmt" + "io/ioutil" + "os" + ) + + type Recurlyservers struct { + XMLName xml.Name `xml:"servers"` + Version string `xml:"version,attr"` + Svs []server `xml:"server"` + Description string `xml:",innerxml"` + } + + type server struct { + XMLName xml.Name `xml:"server"` + ServerName string `xml:"serverName"` + ServerIP string `xml:"serverIP"` + } + + func main() { + file, err := os.Open("servers.xml") // For read access. + if err != nil { + fmt.Printf("error: %v", err) + return + } + defer file.Close() + data, err := ioutil.ReadAll(file) + if err != nil { + fmt.Printf("error: %v", err) + return + } + v := Recurlyservers{} + err = xml.Unmarshal(data, &v) + if err != nil { + fmt.Printf("error: %v", err) + return + } + + fmt.Println(v) + } + + +XML本质上是一种树形的数据格式，而我们可以定义与之匹配的go 语言的 struct类型，然后通过xml.Unmarshal来将xml中的数据解析成对应的struct对象。如上例子输出如下数据 + + {{ servers} 1 [{{ server} Shanghai_VPN 127.0.0.1} {{ server} Beijing_VPN 127.0.0.2}] + + Shanghai_VPN + 127.0.0.1 + + + Beijing_VPN + 127.0.0.2 + + } + + +上面的例子中，将xml文件解析成对应的strcut对象是通过`xml.Unmarshal`来完成的，这个过程是如何实现的？可以看到我们的struct定义后面多了一些类似于`xml:"serverName"`这样的内容,这个是strcut的一个特性，它们被称为 strcut tag，它们是用来辅助反射的。我们来看一下`Unmarshal`的定义： + + func Unmarshal(data []byte, v interface{}) error + +我们看到函数定义了两个参数，第一个是XML数据流，第二个是存储的对应类型，目前支持struct、slice和string，XML包内部采用了反射来进行数据的映射，所以v里面的字段必须是导出的。`Unmarshal`解析的时候XML元素和字段怎么对应起来的呢？这是有一个优先级读取流程的，首先会读取struct tag，如果没有，那么就会对应字段名。必须注意一点的是解析的时候tag、字段名、XML元素都是大小写敏感的，所以必须一一对应字段。 + +Go语言的反射机制，可以利用这些tag信息来将来自XML文件中的数据反射成对应的struct对象，关于反射如何利用struct tag的更多内容请参阅reflect中的相关内容。 + +解析XML到struct的时候遵循如下的规则： + +- 如果struct的一个字段是string或者[]byte类型且它的tag含有`",innerxml"`，Unmarshal将会将此字段所对应的元素内所有内嵌的原始xml累加到此字段上，如上面例子Description定义。最后的输出是 + + + Shanghai_VPN + 127.0.0.1 + + + Beijing_VPN + 127.0.0.2 + + +- 如果struct中有一个叫做XMLName，且类型为xml.Name字段，那么在解析的时候就会保存这个element的名字到该字段,如上面例子中的servers。 +- 如果某个struct字段的tag定义中含有XML结构中element的名称，那么解析的时候就会把相应的element值赋值给该字段，如上servername和serverip定义。 +- 如果某个struct字段的tag定义了中含有`",attr"`，那么解析的时候就会将该结构所对应的element的与字段同名的属性的值赋值给该字段，如上version定义。 +- 如果某个struct字段的tag定义 型如`"a>b>c"`,则解析的时候，会将xml结构a下面的b下面的c元素的值赋值给该字段。 +- 如果某个struct字段的tag定义了`"-"`,那么不会为该字段解析匹配任何xml数据。 +- 如果struct字段后面的tag定义了`",any"`，如果他的子元素在不满足其他的规则的时候就会匹配到这个字段。 +- 如果某个XML元素包含一条或者多条注释，那么这些注释将被累加到第一个tag含有",comments"的字段上，这个字段的类型可能是[]byte或string,如果没有这样的字段存在，那么注释将会被抛弃。 + +上面详细讲述了如何定义struct的tag。 只要设置对了tag，那么XML解析就如上面示例般简单，tag和XML的element是一一对应的关系，如上所示，我们还可以通过slice来表示多个同级元素。 + +>注意： 为了正确解析，go语言的xml包要求struct定义中的所有字段必须是可导出的（即首字母大写） + +## 输出XML +假若我们不是要解析如上所示的XML文件，而是生成它，那么在go语言中又该如何实现呢？ xml包中提供了`Marshal`和`MarshalIndent`两个函数，来满足我们的需求。这两个函数主要的区别是第二个函数会增加前缀和缩进，函数的定义如下所示： + + func Marshal(v interface{}) ([]byte, error) + func MarshalIndent(v interface{}, prefix, indent string) ([]byte, error) + +两个函数第一个参数是用来生成XML的结构定义类型数据，都是返回生成的XML数据流。 + +下面我们来看一下如何输出如上的XML： + + package main + + import ( + "encoding/xml" + "fmt" + "os" + ) + + type Servers struct { + XMLName xml.Name `xml:"servers"` + Version string `xml:"version,attr"` + Svs []server `xml:"server"` + } + + type server struct { + ServerName string `xml:"serverName"` + ServerIP string `xml:"serverIP"` + } + + func main() { + v := &Servers{Version: "1"} + v.Svs = append(v.Svs, server{"Shanghai_VPN", "127.0.0.1"}) + v.Svs = append(v.Svs, server{"Beijing_VPN", "127.0.0.2"}) + output, err := xml.MarshalIndent(v, " ", " ") + if err != nil { + fmt.Printf("error: %v\n", err) + } + os.Stdout.Write([]byte(xml.Header)) + + os.Stdout.Write(output) + } +上面的代码输出如下信息： + + + + + Shanghai_VPN + 127.0.0.1 + + + Beijing_VPN + 127.0.0.2 + + + +和我们之前定义的文件的格式一模一样，之所以会有`os.Stdout.Write([]byte(xml.Header))` 这句代码的出现，是因为`xml.MarshalIndent`或者`xml.Marshal`输出的信息都是不带XML头的，为了生成正确的xml文件，我们使用了xml包预定义的Header变量。 + +我们看到`Marshal`函数接收的参数v是interface{}类型的，即它可以接受任意类型的参数，那么xml包，根据什么规则来生成相应的XML文件呢？ + +- 如果v是 array或者slice，那么输出每一个元素，类似value +- 如果v是指针，那么会Marshal指针指向的内容，如果指针为空，什么都不输出 +- 如果v是interface，那么就处理interface所包含的数据 +- 如果v是其他数据类型，就会输出这个数据类型所拥有的字段信息 + +生成的XML文件中的element的名字又是根据什么决定的呢？元素名按照如下优先级从struct中获取： + +- 如果v是struct，XMLName的tag中定义的名称 +- 类型为xml.Name的名叫XMLName的字段的值 +- 通过strcut中字段的tag来获取 +- 通过strcut的字段名用来获取 +- marshall的类型名称 + +我们应如何设置struct 中字段的tag信息以控制最终xml文件的生成呢？ + +- XMLName不会被输出 +- tag中含有`"-"`的字段不会输出 +- tag中含有`"name,attr"`，会以name作为属性名，字段值作为值输出为这个XML元素的属性，如上version字段所描述 +- tag中含有`",attr"`，会以这个struct的字段名作为属性名输出为XML元素的属性，类似上一条，只是这个name默认是字段名了。 +- tag中含有`",chardata"`，输出为xml的 character data而非element。 +- tag中含有`",innerxml"`，将会被原样输出，而不会进行常规的编码过程 +- tag中含有`",comment"`，将被当作xml注释来输出，而不会进行常规的编码过程，字段值中不能含有"--"字符串 +- tag中含有`"omitempty"`,如果该字段的值为空值那么该字段就不会被输出到XML，空值包括：false、0、nil指针或nil接口，任何长度为0的array, slice, map或者string +- tag中含有`"a>b>c"`，那么就会循环输出三个元素a包含b，b包含c，例如如下代码就会输出 + + FirstName string `xml:"name>first"` + LastName string `xml:"name>last"` + + + Asta + Xie + + + +上面我们介绍了如何使用Go语言的xml包来编/解码XML文件，重要的一点是对XML的所有操作都是通过struct tag来实现的，所以学会对struct tag的运用变得非常重要，在文章中我们简要的列举了如何定义tag。更多内容或tag定义请参看相应的官方资料。 + +## links + * [目录]() + * 上一节: [文本处理](<7.md>) + * 下一节: [Json处理](<7.2.md>) From b091c8dc5413b7651abe1fcc97c771ae241a812b Mon Sep 17 00:00:00 2001 From: maxupeng Date: Fri, 7 Dec 2012 17:08:22 +0800 Subject: [PATCH 36/49] =?UTF-8?q?=E7=89=88=E6=9C=AC=E5=9B=9E=E6=BB=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 4.1.md | 1 - 1 file changed, 1 deletion(-) diff --git a/4.1.md b/4.1.md index f855e196..956de5ef 100644 --- a/4.1.md +++ b/4.1.md @@ -45,7 +45,6 @@ http包里面有一个很简单的方式就可以获取，我们在前面web的 } func login(w http.ResponseWriter, r *http.Request) { - r.ParseForm() fmt.Println("method:", r.Method) //获取请求的方法 if r.Method == "GET" { t, _ := template.ParseFiles("login.gtpl") From 43a9aca356fbf959f7b25f9d24a64401da35bd21 Mon Sep 17 00:00:00 2001 From: gan weiliang Date: Sat, 8 Dec 2012 01:52:13 +0800 Subject: [PATCH 37/49] =?UTF-8?q?=E7=AC=AC=E5=8D=81=E4=B8=89=E7=AB=A0?= =?UTF-8?q?=E6=9C=80=E6=9C=AB=E5=B0=BE=E7=9A=84=E7=AB=A0=E8=8A=82=E5=90=8D?= =?UTF-8?q?=E5=87=BA=E9=94=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 改了几处错误,包括章节名和链接 --- 13.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/13.md b/13.md index 44ad48b8..031c9d40 100644 --- a/13.md +++ b/13.md @@ -14,5 +14,5 @@ ## links * [目录]() - * 上一章: [第十一章总结](<11.4.md>) - * 下一节: [应用日志](<12.1.md>) \ No newline at end of file + * 上一章: [第十二章总结](<12.5.md>) + * 下一节: [项目规划](<13.1.md>) \ No newline at end of file From dd977f591f0cd3f608bd0a0d2d381f621b05b69d Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Sun, 9 Dec 2012 23:04:18 +0800 Subject: [PATCH 38/49] =?UTF-8?q?=E8=87=AA=E5=AE=9A=E4=B9=89=E8=B7=AF?= =?UTF-8?q?=E7=94=B1=E7=9A=84=E5=AE=9E=E7=8E=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 13.3.md | 256 +++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 255 insertions(+), 1 deletion(-) diff --git a/13.3.md b/13.3.md index 13ec372d..0ed81a49 100644 --- a/13.3.md +++ b/13.3.md @@ -1,4 +1,258 @@ -# 13.3 自定义路由器设计 +# 13.3 自定义路由器设计 + +## HTTP路由 +HTTP路由组件负责将HTTP请求交到对应的函数处理(或者是一个struct的方法)，如前面小节所描述的结构图，路由在框架中相当于一个事件处理器，而这个事件包括： + +- 用户请求的路径(例如:/user/123,/article/123)，当然还有查询串信息(例如?id=11) +- HTTP的请求method(GET、POST、PUT、DELETE、PATCH等) + +路由器就是根据用户请求的这个信息定位到相应的处理函数。 +## 默认的路由实现 +在3.4小节有过介绍Go的http包的详解，里面介绍了Go的http包如何设计和实现路由，这里继续以一个例子来说明： + + func fooHandler(w http.ResponseWriter, r *http.Request) { + fmt.Fprintf(w, "Hello, %q", html.EscapeString(r.URL.Path)) + } + + http.Handle("/foo", fooHandler) + + http.HandleFunc("/bar", func(w http.ResponseWriter, r *http.Request) { + fmt.Fprintf(w, "Hello, %q", html.EscapeString(r.URL.Path)) + }) + + log.Fatal(http.ListenAndServe(":8080", nil)) + +上面的例子调用了http默认的DefaultServeMux来添加路由，两个参数，第一个参数是前面所讲的用户请求的路径(Go中保存在r.URL.Path)，第二参数是定位要执行的函数，路由的思路主要集中在两点： + +- 添加路由信息 +- 根据用户请求转发到要执行的函数 + +Go默认的包添加是通过函数`http.Handle`和`http.HandleFunc`等来添加，底层都是调用了`DefaultServeMux.Handle(pattern string, handler Handler)`,这个函数会把路由信息存储在一个map信息中`map[string]muxEntry`，这就解决了上面说的第一点。 + +Go的监听端口，然后接收到tcp连接会扔给Handler来处理，上面的例子默认nil即为`http.DefaultServeMux`，通过`DefaultServeMux.ServeHTTP`函数来进行调度，循环上面存储的map信息，和访问url进行比对查询注册的处理函数，这样就实现了上面所说的第二点。 + + for k, v := range mux.m { + if !pathMatch(k, path) { + continue + } + if h == nil || len(k) > n { + n = len(k) + h = v.h + } + } + + +## beego框架路由实现 +目前几乎所有的Web应用路由实现都是基于http默认的路由器，但是默认的路由器有几个限制点： + +- 不支持参数设定，例如/user/:uid 这种泛类型匹配 +- 无法很好的支持REST模式，无法限制访问的方法，例如上面的例子中，用户访问/foo，可以用GET、POST、DELETE、HEAD等方式访问 +- 默认的路由规则太多了，我前面自己开发了一个API的应用，路由规则有三十几条，这种路由多了之后其实可以进一步简化，通过struct的方法进行一种简化 + +beego框架的路由器基于上面的几点限制考虑设计了一种REST方式的路由实现，路由设计也是基于上面的默认设计的两点来考虑：存储路由和转发路由 + +### 存储路由 +针对前面所说的限制点，我们首先要解决参数支持就需要用到正则，第二和第三点我们通过一种变通的方法来解决，REST的方法对应到struct的方法中去，然后路由到struct而不是函数，这样在转发路由的时候就可以根据method来执行不同的方法。 + +根据上面的思路，我们设计了两个数据类型controllerInfo(保存路径和对应的struct，这里是一个reflect.Type类型)和ControllerRegistor(routers是一个slice用来保存用户添加的路由信息，已经beego框架的信息) + + type controllerInfo struct { + regex *regexp.Regexp + params map[int]string + controllerType reflect.Type + } + + type ControllerRegistor struct { + routers []*controllerInfo + Application *App + } + + +ControllerRegistor对外的接口函数有 + + func (p *ControllerRegistor) Add(pattern string, c ControllerInterface) + +详细的实现如下所示： + + func (p *ControllerRegistor) Add(pattern string, c ControllerInterface) { + parts := strings.Split(pattern, "/") + + j := 0 + params := make(map[int]string) + for i, part := range parts { + if strings.HasPrefix(part, ":") { + expr := "([^/]+)" + //a user may choose to override the defult expression + // similar to expressjs: ‘/user/:id([0-9]+)’ + if index := strings.Index(part, "("); index != -1 { + expr = part[index:] + part = part[:index] + } + params[j] = part + parts[i] = expr + j++ + } + } + + //recreate the url pattern, with parameters replaced + //by regular expressions. then compile the regex + pattern = strings.Join(parts, "/") + regex, regexErr := regexp.Compile(pattern) + if regexErr != nil { + //TODO add error handling here to avoid panic + panic(regexErr) + return + } + + //now create the Route + t := reflect.Indirect(reflect.ValueOf(c)).Type() + route := &controllerInfo{} + route.regex = regex + route.params = params + route.controllerType = t + + p.routers = append(p.routers, route) + + } + +### 静态路由实现 +上面我们实现的动态路由的实现，Go的http包默认支持静态文件处理FileServer，由于我们实现了自定义的路由器，那么静态文件也需要自己设定，beego的静态文件夹保存在全局变量StaticDir中，StaticDir是一个map类型，实现如下： + + func (app *App) SetStaticPath(url string, path string) *App { + StaticDir[url] = path + return app + } + +应用中设置静态路径可以使用如下方式实现： + + beego.SetStaticPath("/img","/static/img") + + +### 转发路由 +转发路由是基于ControllerRegistor的路由信息来进行转发的，详细的实现如下代码所示： + + // AutoRoute + func (p *ControllerRegistor) ServeHTTP(w http.ResponseWriter, r *http.Request) { + defer func() { + if err := recover(); err != nil { + if !RecoverPanic { + // go back to panic + panic(err) + } else { + Critical("Handler crashed with error", err) + for i := 1; ; i += 1 { + _, file, line, ok := runtime.Caller(i) + if !ok { + break + } + Critical(file, line) + } + } + } + }() + var started bool + for prefix, staticDir := range StaticDir { + if strings.HasPrefix(r.URL.Path, prefix) { + file := staticDir + r.URL.Path[len(prefix):] + http.ServeFile(w, r, file) + started = true + return + } + } + requestPath := r.URL.Path + + //find a matching Route + for _, route := range p.routers { + + //check if Route pattern matches url + if !route.regex.MatchString(requestPath) { + continue + } + + //get submatches (params) + matches := route.regex.FindStringSubmatch(requestPath) + + //double check that the Route matches the URL pattern. + if len(matches[0]) != len(requestPath) { + continue + } + + params := make(map[string]string) + if len(route.params) > 0 { + //add url parameters to the query param map + values := r.URL.Query() + for i, match := range matches[1:] { + values.Add(route.params[i], match) + params[route.params[i]] = match + } + + //reassemble query params and add to RawQuery + r.URL.RawQuery = url.Values(values).Encode() + "&" + r.URL.RawQuery + //r.URL.RawQuery = url.Values(values).Encode() + } + //Invoke the request handler + vc := reflect.New(route.controllerType) + init := vc.MethodByName("Init") + in := make([]reflect.Value, 2) + ct := &Context{ResponseWriter: w, Request: r, Params: params} + in[0] = reflect.ValueOf(ct) + in[1] = reflect.ValueOf(route.controllerType.Name()) + init.Call(in) + in = make([]reflect.Value, 0) + method := vc.MethodByName("Prepare") + method.Call(in) + if r.Method == "GET" { + method = vc.MethodByName("Get") + method.Call(in) + } else if r.Method == "POST" { + method = vc.MethodByName("Post") + method.Call(in) + } else if r.Method == "HEAD" { + method = vc.MethodByName("Head") + method.Call(in) + } else if r.Method == "DELETE" { + method = vc.MethodByName("Delete") + method.Call(in) + } else if r.Method == "PUT" { + method = vc.MethodByName("Put") + method.Call(in) + } else if r.Method == "PATCH" { + method = vc.MethodByName("Patch") + method.Call(in) + } else if r.Method == "OPTIONS" { + method = vc.MethodByName("Options") + method.Call(in) + } + if AutoRender { + method = vc.MethodByName("Render") + method.Call(in) + } + method = vc.MethodByName("Finish") + method.Call(in) + started = true + break + } + + //if no matches to url, throw a not found exception + if started == false { + http.NotFound(w, r) + } + } + +### 使用入门 +基于这样的路由设计之后就可以解决前面所说的三个限制点，使用的方式如下所示： + +基本的使用注册路由： + + beego.BeeApp.RegisterController("/", &controllers.MainController{}) + +参数注册： + + beego.BeeApp.RegisterController("/:param", &controllers.UserController{}) + +正则匹配： + + beego.BeeApp.RegisterController("/users/:uid([0-9]+)", &controllers.UserController{}) ## links * [目录]() From 6a327f7a42286cba63ea4ffa06b5447bfbfcc621 Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Sun, 9 Dec 2012 23:26:36 +0800 Subject: [PATCH 39/49] =?UTF-8?q?=E5=AE=8C=E6=88=90=E4=BA=86controller?= =?UTF-8?q?=E7=9A=84=E4=B8=80=E5=B0=8F=E9=83=A8=E5=88=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 13.4.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/13.4.md b/13.4.md index 4848a591..aaaab9b4 100644 --- a/13.4.md +++ b/13.4.md @@ -1,4 +1,13 @@ -# 13.4 controller设计 +# 13.4 controller设计 + +传统的MVC框架大多数是基于Action设计的后缀式映射，然而目前流行的Web趋势是REST风格的架构。尽管使用Filter或者rewrite能够通过URL重写实现REST风格的URL，但是为什么不直接设计一个全新的REST风格的 MVC框架呢？本小节就是基于这种思路来讲述如何从头设计一个基于REST风格的MVC框架中的controller，最大限度地简化Web应用的开发，您甚至编写一行代码就可以实现“Hello, world”。 + +## controller作用 +MVC设计模式是目前Web应用开发中最常见的一种架构模式，通过分离 Model（模型）、View（视图）和 Controller（控制器），可以更容易实现易于扩展的UI。Model指后台返回的数据；View指需要渲染的页面，通常是模板页面，渲染后的结果通常是HTML；Controller指Web开发人员编写的处理不同URL的控制器，如前面小节讲述的路由就是转发到控制器的过程，controller在整个的MVC框架中起到了一个核心的作用，处理业务逻辑，因此控制器是整个框架中必不可少的一部分，Model和View会更具不同的业务可以不写，例如没有数据处理的逻辑处理，没有页面输出的302调整之类的就不需要Model和View，但是controller是必不可少的。 + +## beego的REST设计 + +## 应用指南 ## links * [目录]() From 2ab314ae0c5fe3ac0261f6c6abcc6523d894a30c Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Tue, 11 Dec 2012 00:06:35 +0800 Subject: [PATCH 40/49] =?UTF-8?q?=E5=AE=8C=E6=88=90=E4=BA=86=E6=A1=86?= =?UTF-8?q?=E6=9E=B6=E7=9A=84=E5=9F=BA=E6=9C=AC=E6=9E=B6=E6=9E=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 13.4.md | 149 +++++++++++++++++++++++++- 13.5.md | 244 +++++++++++++++++++++++++++++++++++++++++- 13.md | 2 +- README.md | 5 - images/13.4.beego.png | Bin 0 -> 46977 bytes preface.md | 2 +- 6 files changed, 393 insertions(+), 9 deletions(-) create mode 100644 images/13.4.beego.png diff --git a/13.4.md b/13.4.md index aaaab9b4..037d17ea 100644 --- a/13.4.md +++ b/13.4.md @@ -6,10 +6,157 @@ MVC设计模式是目前Web应用开发中最常见的一种架构模式，通过分离 Model（模型）、View（视图）和 Controller（控制器），可以更容易实现易于扩展的UI。Model指后台返回的数据；View指需要渲染的页面，通常是模板页面，渲染后的结果通常是HTML；Controller指Web开发人员编写的处理不同URL的控制器，如前面小节讲述的路由就是转发到控制器的过程，controller在整个的MVC框架中起到了一个核心的作用，处理业务逻辑，因此控制器是整个框架中必不可少的一部分，Model和View会更具不同的业务可以不写，例如没有数据处理的逻辑处理，没有页面输出的302调整之类的就不需要Model和View，但是controller是必不可少的。 ## beego的REST设计 +前面小节介绍了路由实现了注册struct的功能，而struct中实现了REST方式，因此我们需要设计一个用于逻辑处理controller的基类，这里主要设计了两个类型，一个struct、一个interface + + type Controller struct { + Ct *Context + Tpl *template.Template + Data map[interface{}]interface{} + ChildName string + TplNames string + Layout []string + TplExt string + } + + type ControllerInterface interface { + Init(ct *Context, cn string) //初始化上下文和子类名称 + Prepare() //开始执行之前的一些处理 + Get() //method=GET的处理 + Post() //method=POST的处理 + Delete() //method=DELETE的处理 + Put() //method=PUT的处理 + Head() //method=HEAD的处理 + Patch() //method=PATCH的处理 + Options() //method=OPTIONS的处理 + Finish() //执行完成之后的处理 Render() error //执行完method对应的方法之后渲染页面 + } + +那么前面介绍的路由add的时候是定义了ControllerInterface类型，因此，只要我们实现这个接口就可以，所以我们的基类Controller实现如下的方法： + + func (c *Controller) Init(ct *Context, cn string) { + c.Data = make(map[interface{}]interface{}) + c.Layout = make([]string, 0) + c.TplNames = "" + c.ChildName = cn + c.Ct = ct + c.TplExt = "tpl" + } + + func (c *Controller) Prepare() { + + } + + func (c *Controller) Finish() { + + } + + func (c *Controller) Get() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Post() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Delete() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Put() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Head() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Patch() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Options() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Render() error { + if len(c.Layout) > 0 { + var filenames []string + for _, file := range c.Layout { + filenames = append(filenames, path.Join(ViewsPath, file)) + } + t, err := template.ParseFiles(filenames...) + if err != nil { + Trace("template ParseFiles err:", err) + } + err = t.ExecuteTemplate(c.Ct.ResponseWriter, c.TplNames, c.Data) + if err != nil { + Trace("template Execute err:", err) + } + } else { + if c.TplNames == "" { + c.TplNames = c.ChildName + "/" + c.Ct.Request.Method + "." + c.TplExt + } + t, err := template.ParseFiles(path.Join(ViewsPath, c.TplNames)) + if err != nil { + Trace("template ParseFiles err:", err) + } + err = t.Execute(c.Ct.ResponseWriter, c.Data) + if err != nil { + Trace("template Execute err:", err) + } + } + return nil + } + + func (c *Controller) Redirect(url string, code int) { + c.Ct.Redirect(code, url) + } + +上面的controller基类完成了接口定义的函数，通过路由根据url执行相应的controller的原则，会以此执行如下的函数： + + Init() 初始化 + Prepare() 执行之前的初始化，每个继承的子类可以来实现该函数 + method() 根据不同的method执行不同的函数：GET、POST、PUT、HEAD等，子类来实现这些函数，如果没实现，那么默认都是403 + Render() 可选，根据全局变量AutoRender来判断是否执行 + Finish() 执行完之后执行的操作，每个继承的子类可以来实现该函数 ## 应用指南 +上面beego框架中完成了controller基类的设计，那么我们在我们的应用中可以这样来设计我们的方法： + + package controllers + + import ( + "github.com/astaxie/beego" + ) + + type MainController struct { + beego.Controller + } + + func (this *MainController) Get() { + this.Data["Username"] = "astaxie" + this.Data["Email"] = "astaxie@gmail.com" + this.TplNames = "index.tpl" + } + +上面的方式我们实现了子类MainController，实现了Get方法，那么如果用户通过其他的方式(POST/HEAD等)来访问该资源都将返回403，而如果是Get来访问，因为我们设置了AutoRender=true，那么在执行玩Get方法之后会自动执行Render函数，就会显示如下界面： + +![](images/13.4.beego.png?raw=true) + +index.tpl的代码如下所示，我们可以看到数据的设置和显示都是相当的简单方便： + + + + + beego welcome template + + +

Hello, world!{{.Username}},{{.Email}}

+ + + ## links * [目录]() * 上一章: [自定义路由器设计](<13.3.md>) - * 下一节: [数据库操作](<13.5.md>) \ No newline at end of file + * 下一节: [日志和配置设计](<13.5.md>) \ No newline at end of file diff --git a/13.5.md b/13.5.md index ffb11496..8349a538 100644 --- a/13.5.md +++ b/13.5.md @@ -1,4 +1,246 @@ -# 13.5 数据库操作 +# 13.5 日志和配置设计 + +## 日志和配置的重要性 +前面已经介绍过日志在我们程序开发中起着很重要的作用，通过日志我们可以记录调试我们的信息，当初介绍过一个日志系统seelog，根据不同的level输出不同的日志，这个对于程序开发和程序部署来说至关重要。我们可以在程序开发中设置level低一点，部署的时候把level设置高，这样我们开发中的调试信息可以屏蔽掉。 + +配置模块对于应用部署牵涉到服务器不同的一些配置信息非常有用，例如一些数据库配置信息、监听端口、监听地址等都是可以通过配置文件来配置，这样我们的应用程序就具有很强的灵活性，可以通过配置文件的配置部署在不同的机器上，可以连接不同的数据库之类的。 + +## beego的日志设计 +beego的日志设计部署思路来自于seelog，根据不同的level来记录日志，但是beego设计的日志系统比较轻量级，采用了系统的log.Logger接口，默认输出到os.Stdout,用户可以实现这个接口然后通过beego.SetLogger设置自定义的输出，详细的实现如下所示： + + + // Log levels to control the logging output. + const ( + LevelTrace = iota + LevelDebug + LevelInfo + LevelWarning + LevelError + LevelCritical + ) + + // logLevel controls the global log level used by the logger. + var level = LevelTrace + + // LogLevel returns the global log level and can be used in + // own implementations of the logger interface. + func Level() int { + return level + } + + // SetLogLevel sets the global log level used by the simple + // logger. + func SetLevel(l int) { + level = l + } + +上面这一段实现了日志系统的日志分级，默认的级别是Trace，用户通过SetLevel可以设置不同的分级。 + + // logger references the used application logger. + var BeeLogger = log.New(os.Stdout, "", log.Ldate|log.Ltime) + + // SetLogger sets a new logger. + func SetLogger(l *log.Logger) { + BeeLogger = l + } + + // Trace logs a message at trace level. + func Trace(v ...interface{}) { + if level <= LevelTrace { + BeeLogger.Printf("[T] %v\n", v) + } + } + + // Debug logs a message at debug level. + func Debug(v ...interface{}) { + if level <= LevelDebug { + BeeLogger.Printf("[D] %v\n", v) + } + } + + // Info logs a message at info level. + func Info(v ...interface{}) { + if level <= LevelInfo { + BeeLogger.Printf("[I] %v\n", v) + } + } + + // Warning logs a message at warning level. + func Warn(v ...interface{}) { + if level <= LevelWarning { + BeeLogger.Printf("[W] %v\n", v) + } + } + + // Error logs a message at error level. + func Error(v ...interface{}) { + if level <= LevelError { + BeeLogger.Printf("[E] %v\n", v) + } + } + + // Critical logs a message at critical level. + func Critical(v ...interface{}) { + if level <= LevelCritical { + BeeLogger.Printf("[C] %v\n", v) + } + } + +上面这一段代码默认初始化了一个BeeLogger对象，默认输出到os.Stdout，用户可以通过beego.SetLogger来设置实现了logger的接口输出。这里面实现了六个函数： + +- Trace（一般的记录信息，举例如下：） + - "Entered parse function validation block" + - "Validation: entered second 'if'" + - "Dictionary 'Dict' is empty. Using default value" +- Debug（调试信息，举例如下：） + - "Web page requested: http://somesite.com Params='...'" + - "Response generated. Response size: 10000. Sending." + - "New file received. Type:PNG Size:20000" +- Info（打印信息，举例如下：） + - "Web server restarted" + - "Hourly statistics: Requested pages: 12345 Errors: 123 ..." + - "Service paused. Waiting for 'resume' call" +- Warn（警告信息，举例如下：） + - "Cache corrupted for file='test.file'. Reading from back-end" + - "Database 192.168.0.7/DB not responding. Using backup 192.168.0.8/DB" + - "No response from statistics server. Statistics not sent" +- Error（错误信息，举例如下：） + - "Internal error. Cannot process request #12345 Error:...." + - "Cannot perform login: credentials DB not responding" +- Critical（致命错误，举例如下：） + - "Critical panic received: .... Shutting down" + - "Fatal error: ... App is shutting down to prevent data corruption or loss" + +可以看到每个函数里面都有对level的判断，所以如果我们在部署的时候设置了level=LevelWarning，那么Trace、Debug、Info这三个函数都不会有任何的输出，以此类推。 + +## beego的配置设计 +配置信息的解析，beego实现了一个key=value的配置文件读取，类似ini配置文件的格式，就是一个文件解析的过程，然后把解析的数据保存到map中，最后在调用的时候通过几个string、int之类的函数调用返回相应的值，具体的实现请看下面： + +首先定义了一些ini配置文件的一些全局性常量 ： + + var ( + bComment = []byte{'#'} + bEmpty = []byte{} + bEqual = []byte{'='} + bDQuote = []byte{'"'} + ) + +定义了配置文件的格式： + + // A Config represents the configuration. + type Config struct { + filename string + comment map[int][]string // id: []{comment, key...}; id 1 is for main comment. + data map[string]string // key: value + offset map[string]int64 // key: offset; for editing. + sync.RWMutex + } + +定义了解析文件的函数，解析文件的过程是打开文件，然后一行一行的读取，解析注释、空行和key=value数据： + + // ParseFile creates a new Config and parses the file configuration from the + // named file. + func LoadConfig(name string) (*Config, error) { + file, err := os.Open(name) + if err != nil { + return nil, err + } + + cfg := &Config{ + file.Name(), + make(map[int][]string), + make(map[string]string), + make(map[string]int64), + sync.RWMutex{}, + } + cfg.Lock() + defer cfg.Unlock() + defer file.Close() + + var comment bytes.Buffer + buf := bufio.NewReader(file) + + for nComment, off := 0, int64(1); ; { + line, _, err := buf.ReadLine() + if err == io.EOF { + break + } + if bytes.Equal(line, bEmpty) { + continue + } + + off += int64(len(line)) + + if bytes.HasPrefix(line, bComment) { + line = bytes.TrimLeft(line, "#") + line = bytes.TrimLeftFunc(line, unicode.IsSpace) + comment.Write(line) + comment.WriteByte('\n') + continue + } + if comment.Len() != 0 { + cfg.comment[nComment] = []string{comment.String()} + comment.Reset() + nComment++ + } + + val := bytes.SplitN(line, bEqual, 2) + if bytes.HasPrefix(val[1], bDQuote) { + val[1] = bytes.Trim(val[1], `"`) + } + + key := strings.TrimSpace(string(val[0])) + cfg.comment[nComment-1] = append(cfg.comment[nComment-1], key) + cfg.data[key] = strings.TrimSpace(string(val[1])) + cfg.offset[key] = off + } + return cfg, nil + } + +下面实现了一些读取配置文件的函数，返回的值确定为bool、int、float64或string： + + // Bool returns the boolean value for a given key. + func (c *Config) Bool(key string) (bool, error) { + return strconv.ParseBool(c.data[key]) + } + + // Int returns the integer value for a given key. + func (c *Config) Int(key string) (int, error) { + return strconv.Atoi(c.data[key]) + } + + // Float returns the float value for a given key. + func (c *Config) Float(key string) (float64, error) { + return strconv.ParseFloat(c.data[key], 64) + } + + // String returns the string value for a given key. + func (c *Config) String(key string) string { + return c.data[key] + } + +## 应用指南 +下面这个函数是我一个应用中的例子，用来获取远程url地址的json数据，实现如下： + + func GetJson() { + resp, err := http.Get(beego.AppConfig.String("url")) + if err != nil { + beego.Critical("http get info error") + return + } + defer resp.Body.Close() + body, err := ioutil.ReadAll(resp.Body) + err = json.Unmarshal(body, &AllInfo) + if err != nil { + beego.Critical("error:", err) + } + } + +函数中调用了框架的日志函数`beego.Critical`函数用来报错，调用了`beego.AppConfig.String("url")`用来获取配置文件中的信息，配置文件的信息如下(app.conf)： + + appname = hs + url ="http://www.api.com/api.html" + ## links * [目录]() diff --git a/13.md b/13.md index 031c9d40..1184efa3 100644 --- a/13.md +++ b/13.md @@ -8,7 +8,7 @@ * 2 [数据库设计](13.2.md) * 3 [自定义路由器设计](13.3.md) * 4 [controller设计](13.4.md) - * 5 [数据库操作](13.5.md) + * 5 [日志和配置设计](13.5.md) * 6 [实现博客的增删改](13.6.md) * 7 [小结](13.7.md)　 diff --git a/README.md b/README.md index e9266167..0e540c8c 100644 --- a/README.md +++ b/README.md @@ -43,11 +43,6 @@ - [BianJiang](https://github.com/border) (编写go开发工具Vim和Emacs的设置) - [Oling Cat](https://github.com/OlingCat)(review代码) - [Wenlei Wu](mailto:spadesacn@gmail.com)(提供一些图片展示) - -##友情链接 -目前Go开发的比较成熟的一个框架是由我们国人开发的，目前版本已经比较成熟，而且提供了很多的应用demo，方便快速开发Web应用，该框架是由海意和BianJiang开发维护，推荐大家看看： - -[golangers框架](https://github.com/golangers/framework) ## 授权许可 除特别声明外，本书中的内容使用[CC BY-SA 3.0 License](http://creativecommons.org/licenses/by-sa/3.0/)（创作共用 署名-相同方式共享3.0许可协议）授权，代码遵循[BSD 3-Clause License]()（3项条款的BSD许可协议）。 diff --git a/images/13.4.beego.png b/images/13.4.beego.png new file mode 100644 index 0000000000000000000000000000000000000000..96a9d27432677c13a5e051cc5a5ba2d4f36f6074 GIT binary patch literal 46977 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 qz+Vsf|5wr9EcV;v_+R}LJ^8M`W%L Date: Tue, 11 Dec 2012 09:38:33 +0800 Subject: [PATCH 41/49] =?UTF-8?q?=E8=AF=AD=E5=8F=A5=E9=80=9A=E9=A1=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 6.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/6.1.md b/6.1.md index 439f55e5..7b04f056 100644 --- a/6.1.md +++ b/6.1.md @@ -11,7 +11,7 @@ cookie，简而言之就是在本地计算机保存一些用户操作的历史 ![](images/6.1.cookie2.png?raw=true) -session，简而言之就是在服务器上保存用户操作的历史信息。但该方式下，仍然需要将发送请求的客户端与session对象进行对应，所以可以借助cookie机制来获取客户端的标识（即session id），也可以通过GET方式将id提交给服务器。session id，即服务器上session对象文件的名称，由服务器负责产生，保证随机性与唯一性，相当于一个随机密钥，避免在握手或传输中暴露用户真实密码。 +session，简而言之就是在服务器上保存用户操作的历史信息。服务器使用session id来标识session，session id由服务器负责产生，保证随机性与唯一性，相当于一个随机密钥，避免在握手或传输中暴露用户真实密码。但该方式下，仍然需要将发送请求的客户端与session进行对应，所以可以借助cookie机制来获取客户端的标识（即session id），也可以通过GET方式将id提交给服务器。 ![](images/6.1.session.png?raw=true) From 1238b4d52b46e0d36703ab642268d93ca051121e Mon Sep 17 00:00:00 2001 From: "apaye.com" Date: Wed, 12 Dec 2012 14:20:10 +0800 Subject: [PATCH 42/49] Update 2.2.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit aSlice = array[5:] // 等价于aSlice = array[5:10] aSlice包含元素: f,g,h,i,j --- 2.2.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/2.2.md b/2.2.md index 80bab5ad..5c7fa226 100644 --- a/2.2.md +++ b/2.2.md @@ -326,8 +326,8 @@ slice有一些简便的操作 // 演示一些简便操作 aSlice = array[:3] // 等价于aSlice = array[0:3] aSlice包含元素: a,b,c - aSlice = array[5:] // 等价于aSlice = array[5:9] aSlice包含元素: f,g,h,i,j - aSlice = array[:] // 等价于aSlice = array[0:9] 这样aSlice包含了全部的元素 + aSlice = array[5:] // 等价于aSlice = array[5:10] aSlice包含元素: f,g,h,i,j + aSlice = array[:] // 等价于aSlice = array[0:10] 这样aSlice包含了全部的元素 // 从slice中获取slice aSlice = array[3:7] // aSlice包含元素: d,e,f,g，len=4，cap=7 From d15042b9de4b4035dbdc2e079bb226f5e1e2840b Mon Sep 17 00:00:00 2001 From: astaxie Date: Wed, 12 Dec 2012 17:48:59 +0800 Subject: [PATCH 43/49] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E4=B8=80=E4=BA=9B?= =?UTF-8?q?=E9=94=99=E5=88=AB=E5=AD=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 13.4.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/13.4.md b/13.4.md index 037d17ea..acf6f9d8 100644 --- a/13.4.md +++ b/13.4.md @@ -3,7 +3,7 @@ 传统的MVC框架大多数是基于Action设计的后缀式映射，然而目前流行的Web趋势是REST风格的架构。尽管使用Filter或者rewrite能够通过URL重写实现REST风格的URL，但是为什么不直接设计一个全新的REST风格的 MVC框架呢？本小节就是基于这种思路来讲述如何从头设计一个基于REST风格的MVC框架中的controller，最大限度地简化Web应用的开发，您甚至编写一行代码就可以实现“Hello, world”。 ## controller作用 -MVC设计模式是目前Web应用开发中最常见的一种架构模式，通过分离 Model（模型）、View（视图）和 Controller（控制器），可以更容易实现易于扩展的UI。Model指后台返回的数据；View指需要渲染的页面，通常是模板页面，渲染后的结果通常是HTML；Controller指Web开发人员编写的处理不同URL的控制器，如前面小节讲述的路由就是转发到控制器的过程，controller在整个的MVC框架中起到了一个核心的作用，处理业务逻辑，因此控制器是整个框架中必不可少的一部分，Model和View会更具不同的业务可以不写，例如没有数据处理的逻辑处理，没有页面输出的302调整之类的就不需要Model和View，但是controller是必不可少的。 +MVC设计模式是目前Web应用开发中最常见的一种架构模式，通过分离 Model（模型）、View（视图）和 Controller（控制器），可以更容易实现易于扩展的UI。Model指后台返回的数据；View指需要渲染的页面，通常是模板页面，渲染后的结果通常是HTML；Controller指Web开发人员编写的处理不同URL的控制器，如前面小节讲述的路由就是转发到控制器的过程，controller在整个的MVC框架中起到了一个核心的作用，处理业务逻辑，因此控制器是整个框架中必不可少的一部分，Model和View会根据不同的业务可以不写，例如没有数据处理的逻辑处理，没有页面输出的302调整之类的就不需要Model和View，但是controller是必不可少的。 ## beego的REST设计 前面小节介绍了路由实现了注册struct的功能，而struct中实现了REST方式，因此我们需要设计一个用于逻辑处理controller的基类，这里主要设计了两个类型，一个struct、一个interface @@ -112,7 +112,7 @@ MVC设计模式是目前Web应用开发中最常见的一种架构模式，通 c.Ct.Redirect(code, url) } -上面的controller基类完成了接口定义的函数，通过路由根据url执行相应的controller的原则，会以此执行如下的函数： +上面的controller基类完成了接口定义的函数，通过路由根据url执行相应的controller的原则，会依次执行如下的函数： Init() 初始化 Prepare() 执行之前的初始化，每个继承的子类可以来实现该函数 From 4749de5ad1fd5fc11f785c44f97581fb30e170ef Mon Sep 17 00:00:00 2001 From: astaxie Date: Thu, 13 Dec 2012 09:41:25 +0800 Subject: [PATCH 44/49] =?UTF-8?q?=E4=BF=AE=E6=AD=A3=E9=94=99=E5=88=AB?= =?UTF-8?q?=E5=AD=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 12.3.md | 360 ++++++++++++++++++++++++++++---------------------------- 1 file changed, 180 insertions(+), 180 deletions(-) diff --git a/12.3.md b/12.3.md index 93bcefe3..c5b3c23b 100644 --- a/12.3.md +++ b/12.3.md @@ -1,181 +1,181 @@ -# 12.3 应用部署 -程序开发完毕之后，我们现在要部署Web应用程序了，但是我们如何来部署这些应用程序呢？因为Go程序编译之后是一个可执行文件，编写过C程序的读者一定知道使用demon就可以完美的实现程序后台运行，但是目前Go还无法完美的实现demon，因此，针对Go的应用程序部署，我们可以利用第三方工具来管理，第三方的工具有很多，例如Supervisord、upstart、daemontools等，这小节我介绍目前自己系统中采用的工具Supervisord。 -## deamon -目前Go程序如果要实现deamon还不行，详细的见这个Go语言的bug：http://code.google.com/p/go/issues/detail?id=227，大概的意思说很难从现有的使用的线程中fork一个出来，因为没有一种简单的方法来确保所有已经使用的线程的状态一致性问题。 - -但是我们可以看到很多网上的一些实现deamon的方法，例如下面两种方式： - -- MarGo的一个实现思路，使用Commond来执行自身的应用，如果真想实现，那么推荐这种方案 - - d := flag.Bool("d", false, "Whether or not to launch in the background(like a daemon)") - if *d { - cmd := exec.Command(os.Args[0], - "-close-fds", - "-addr", *addr, - "-call", *call, - ) - serr, err := cmd.StderrPipe() - if err != nil { - log.Fatalln(err) - } - err = cmd.Start() - if err != nil { - log.Fatalln(err) - } - s, err := ioutil.ReadAll(serr) - s = bytes.TrimSpace(s) - if bytes.HasPrefix(s, []byte("addr: ")) { - fmt.Println(string(s)) - cmd.Process.Release() - } else { - log.Printf("unexpected response from MarGo: `%s` error: `%v`\n", s, err) - cmd.Process.Kill() - } - } - -- 另一种是利用syscall的方案，但是这个方案并不完善： - - package main - - import ( - "log" - "os" - "syscall" - ) - - func daemon(nochdir, noclose int) int { - var ret, ret2 uintptr - var err uintptr - - darwin := syscall.OS == "darwin" - - // already a daemon - if syscall.Getppid() == 1 { - return 0 - } - - // fork off the parent process - ret, ret2, err = syscall.RawSyscall(syscall.SYS_FORK, 0, 0, 0) - if err != 0 { - return -1 - } - - // failure - if ret2 < 0 { - os.Exit(-1) - } - - // handle exception for darwin - if darwin && ret2 == 1 { - ret = 0 - } - - // if we got a good PID, then we call exit the parent process. - if ret > 0 { - os.Exit(0) - } - - /* Change the file mode mask */ - _ = syscall.Umask(0) - - // create a new SID for the child process - s_ret, s_errno := syscall.Setsid() - if s_errno != 0 { - log.Printf("Error: syscall.Setsid errno: %d", s_errno) - } - if s_ret < 0 { - return -1 - } - - if nochdir == 0 { - os.Chdir("/") - } - - if noclose == 0 { - f, e := os.OpenFile("/dev/null", os.O_RDWR, 0) - if e == nil { - fd := f.Fd() - syscall.Dup2(fd, os.Stdin.Fd()) - syscall.Dup2(fd, os.Stdout.Fd()) - syscall.Dup2(fd, os.Stderr.Fd()) - } - } - - return 0 - } - -上面提出了两种实现Go的deamon方案，但是我还是不推荐大家这样去实现，因为官方还没有正式的宣布支持deamon，当然第一种方案目前来看是比较可行的，而且目前开源库skynet也在采用这个方案做deamon。 - -## Supervisord -上面已经介绍了Go目前是有两种方案来实现他的deamon，但是官方本身还不支持这一块，所以还是建议大家采用第三方成熟工具来管理我们的应用程序，这里我给大家介绍一款目前使用比较广泛的进程管理软件：Supervisord。Supervisord是用Python实现的一款非常实用的进程管理工具。supervisord会帮你把管理的应用程序转成daemon程序，而且可以方便的通过命令开启、关闭、重启等操作，而且它管理的进程一旦奔溃会自动再次重新开启，这样就可以保证程序中断的情况下有自我修复功能。 - ->我前面在应用中踩过一个坑，就是因为所有的应用程序都是由Supervisord父进程生出来的，那么当你修改了操作系统的文件描述符之后，别忘记重启Supervisord，光重启下面的应用程序没用。当初我就是系统安装好之后就先装了Supervisord，然后开始部署程序，修改文件描述符，重启程序，以为文件描述符已经是100000了，其实Supervisord这个时候还是默认的1024个，导致他管理的进程所有的描述符也是1024.开放之后压力一上来里面狂暴文件描述符用光了，查了很久才找到这个坑。 - -### Supervisord安装 -Supervisord可以通过`sudo easy_install supervisor`安装，当然也可以通过Supervisord官网下载后`setup.py install`安装。 - -- 使用easy_install必须安装setuptools - - 打开http://pypi.python.org/pypi/setuptools#files，根据你系统的python的版本下载相应的文件，然后执行`sh setuptoolsxxxx.egg`，这样就可以使用easy_install命令来安装Supervisord。 - -### Supervisord配置 -Supervisord默认的配置文件路径为/etc/supervisord.conf，通过文本编辑器修改这个文件，下面是一个示例的配置文件： - - ;/etc/supervisord.conf - [unix_http_server] - file = /var/run/supervisor.sock - chmod = 0777 - chown= root:root - - [inet_http_server] - # Web管理界面设定 - port=9001 - username = admin - password = yourpassword - - [supervisorctl] - ; 必须和'unix_http_server'里面的设定匹配 - serverurl = unix:///var/run/supervisord.sock - - [supervisord] - logfile=/var/log/supervisord/supervisord.log ; (main log file;default $CWD/supervisord.log) - logfile_maxbytes=50MB ; (max main logfile bytes b4 rotation;default 50MB) - logfile_backups=10 ; (num of main logfile rotation backups;default 10) - loglevel=info ; (log level;default info; others: debug,warn,trace) - pidfile=/var/run/supervisord.pid ; (supervisord pidfile;default supervisord.pid) - nodaemon=true ; (start in foreground if true;default false) - minfds=1024 ; (min. avail startup file descriptors;default 1024) - minprocs=200 ; (min. avail process descriptors;default 200) - user=root ; (default is current user, required if root) - childlogdir=/var/log/supervisord/ ; ('AUTO' child log dir, default $TEMP) - - [rpcinterface:supervisor] - supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface - - ; 管理的单个进程的配置，可以添加多个program - [program:blogdemon] - command=/data/blog/blogdemon - autostart = true - startsecs = 5 - user = root - redirect_stderr = true - stdout_logfile = /var/log/supervisord/blogdemon.log - -### Supervisord管理 -Supervisord安装完成后有两个可用的命令行supervisor和supervisorctl，命令使用解释如下： - -- supervisord，初始启动Supervisord，启动、管理配置中设置的进程。 -- supervisorctl stop programxxx，停止某一个进程(programxxx)，programxxx为[program:blogdemon]里配置的值，这个示例就是blogdemon。 -- supervisorctl start programxxx，启动某个进程 -- supervisorctl restart programxxx，重启某个进程 -- supervisorctl stop all，停止全部进程，注：start、restart、stop都不会载入最新的配置文件。 -- supervisorctl reload，载入最新的配置文件，并按新的配置启动、管理所有进程。 - -## 小结 -这小节我们介绍了如何实现Go的deamon，但是我们知道由于目前Go的deamon实现不是很完美，我们需要依靠第三方工具来实现应用程序的deamon管理，这里介绍了一个python写的进程管理工具Supervisord，通过Supervisord可以很方便的把我们的Go应用程序管理起来。 - - -## links - * [目录]() - * 上一章: [网站错误处理](<12.2.md>) +# 12.3 应用部署 +程序开发完毕之后，我们现在要部署Web应用程序了，但是我们如何来部署这些应用程序呢？因为Go程序编译之后是一个可执行文件，编写过C程序的读者一定知道使用daemon就可以完美的实现程序后台运行，但是目前Go还无法完美的实现daemon，因此，针对Go的应用程序部署，我们可以利用第三方工具来管理，第三方的工具有很多，例如Supervisord、upstart、daemontools等，这小节我介绍目前自己系统中采用的工具Supervisord。 +## deamon +目前Go程序如果要实现daemon还不行，详细的见这个Go语言的bug：http://code.google.com/p/go/issues/detail?id=227，大概的意思说很难从现有的使用的线程中fork一个出来，因为没有一种简单的方法来确保所有已经使用的线程的状态一致性问题。 + +但是我们可以看到很多网上的一些实现deamon的方法，例如下面两种方式： + +- MarGo的一个实现思路，使用Commond来执行自身的应用，如果真想实现，那么推荐这种方案 + + d := flag.Bool("d", false, "Whether or not to launch in the background(like a daemon)") + if *d { + cmd := exec.Command(os.Args[0], + "-close-fds", + "-addr", *addr, + "-call", *call, + ) + serr, err := cmd.StderrPipe() + if err != nil { + log.Fatalln(err) + } + err = cmd.Start() + if err != nil { + log.Fatalln(err) + } + s, err := ioutil.ReadAll(serr) + s = bytes.TrimSpace(s) + if bytes.HasPrefix(s, []byte("addr: ")) { + fmt.Println(string(s)) + cmd.Process.Release() + } else { + log.Printf("unexpected response from MarGo: `%s` error: `%v`\n", s, err) + cmd.Process.Kill() + } + } + +- 另一种是利用syscall的方案，但是这个方案并不完善： + + package main + + import ( + "log" + "os" + "syscall" + ) + + func daemon(nochdir, noclose int) int { + var ret, ret2 uintptr + var err uintptr + + darwin := syscall.OS == "darwin" + + // already a daemon + if syscall.Getppid() == 1 { + return 0 + } + + // fork off the parent process + ret, ret2, err = syscall.RawSyscall(syscall.SYS_FORK, 0, 0, 0) + if err != 0 { + return -1 + } + + // failure + if ret2 < 0 { + os.Exit(-1) + } + + // handle exception for darwin + if darwin && ret2 == 1 { + ret = 0 + } + + // if we got a good PID, then we call exit the parent process. + if ret > 0 { + os.Exit(0) + } + + /* Change the file mode mask */ + _ = syscall.Umask(0) + + // create a new SID for the child process + s_ret, s_errno := syscall.Setsid() + if s_errno != 0 { + log.Printf("Error: syscall.Setsid errno: %d", s_errno) + } + if s_ret < 0 { + return -1 + } + + if nochdir == 0 { + os.Chdir("/") + } + + if noclose == 0 { + f, e := os.OpenFile("/dev/null", os.O_RDWR, 0) + if e == nil { + fd := f.Fd() + syscall.Dup2(fd, os.Stdin.Fd()) + syscall.Dup2(fd, os.Stdout.Fd()) + syscall.Dup2(fd, os.Stderr.Fd()) + } + } + + return 0 + } + +上面提出了两种实现Go的daemon方案，但是我还是不推荐大家这样去实现，因为官方还没有正式的宣布支持daemon，当然第一种方案目前来看是比较可行的，而且目前开源库skynet也在采用这个方案做daemon。 + +## Supervisord +上面已经介绍了Go目前是有两种方案来实现他的daemon，但是官方本身还不支持这一块，所以还是建议大家采用第三方成熟工具来管理我们的应用程序，这里我给大家介绍一款目前使用比较广泛的进程管理软件：Supervisord。Supervisord是用Python实现的一款非常实用的进程管理工具。supervisord会帮你把管理的应用程序转成daemon程序，而且可以方便的通过命令开启、关闭、重启等操作，而且它管理的进程一旦奔溃会自动再次重新开启，这样就可以保证程序中断的情况下有自我修复功能。 + +>我前面在应用中踩过一个坑，就是因为所有的应用程序都是由Supervisord父进程生出来的，那么当你修改了操作系统的文件描述符之后，别忘记重启Supervisord，光重启下面的应用程序没用。当初我就是系统安装好之后就先装了Supervisord，然后开始部署程序，修改文件描述符，重启程序，以为文件描述符已经是100000了，其实Supervisord这个时候还是默认的1024个，导致他管理的进程所有的描述符也是1024.开放之后压力一上来系统就开发报文件描述符用光了，查了很久才找到这个坑。 + +### Supervisord安装 +Supervisord可以通过`sudo easy_install supervisor`安装，当然也可以通过Supervisord官网下载后`setup.py install`安装。 + +- 使用easy_install必须安装setuptools + + 打开http://pypi.python.org/pypi/setuptools#files，根据你系统的python的版本下载相应的文件，然后执行`sh setuptoolsxxxx.egg`，这样就可以使用easy_install命令来安装Supervisord。 + +### Supervisord配置 +Supervisord默认的配置文件路径为/etc/supervisord.conf，通过文本编辑器修改这个文件，下面是一个示例的配置文件： + + ;/etc/supervisord.conf + [unix_http_server] + file = /var/run/supervisor.sock + chmod = 0777 + chown= root:root + + [inet_http_server] + # Web管理界面设定 + port=9001 + username = admin + password = yourpassword + + [supervisorctl] + ; 必须和'unix_http_server'里面的设定匹配 + serverurl = unix:///var/run/supervisord.sock + + [supervisord] + logfile=/var/log/supervisord/supervisord.log ; (main log file;default $CWD/supervisord.log) + logfile_maxbytes=50MB ; (max main logfile bytes b4 rotation;default 50MB) + logfile_backups=10 ; (num of main logfile rotation backups;default 10) + loglevel=info ; (log level;default info; others: debug,warn,trace) + pidfile=/var/run/supervisord.pid ; (supervisord pidfile;default supervisord.pid) + nodaemon=true ; (start in foreground if true;default false) + minfds=1024 ; (min. avail startup file descriptors;default 1024) + minprocs=200 ; (min. avail process descriptors;default 200) + user=root ; (default is current user, required if root) + childlogdir=/var/log/supervisord/ ; ('AUTO' child log dir, default $TEMP) + + [rpcinterface:supervisor] + supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface + + ; 管理的单个进程的配置，可以添加多个program + [program:blogdemon] + command=/data/blog/blogdemon + autostart = true + startsecs = 5 + user = root + redirect_stderr = true + stdout_logfile = /var/log/supervisord/blogdemon.log + +### Supervisord管理 +Supervisord安装完成后有两个可用的命令行supervisor和supervisorctl，命令使用解释如下： + +- supervisord，初始启动Supervisord，启动、管理配置中设置的进程。 +- supervisorctl stop programxxx，停止某一个进程(programxxx)，programxxx为[program:blogdemon]里配置的值，这个示例就是blogdemon。 +- supervisorctl start programxxx，启动某个进程 +- supervisorctl restart programxxx，重启某个进程 +- supervisorctl stop all，停止全部进程，注：start、restart、stop都不会载入最新的配置文件。 +- supervisorctl reload，载入最新的配置文件，并按新的配置启动、管理所有进程。 + +## 小结 +这小节我们介绍了如何实现Go的daemon，但是我们知道由于目前Go的daemon实现不是很完美，我们需要依靠第三方工具来实现应用程序的daemon管理，这里介绍了一个python写的进程管理工具Supervisord，通过Supervisord可以很方便的把我们的Go应用程序管理起来。 + + +## links + * [目录]() + * 上一章: [网站错误处理](<12.2.md>) * 下一节: [备份和恢复](<12.4.md>) \ No newline at end of file From a0214d310d22e1b0afc6542d3738bcec0b82fcca Mon Sep 17 00:00:00 2001 From: windows1430 Date: Fri, 14 Dec 2012 16:30:43 +0800 Subject: [PATCH 45/49] Update 9.1.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 描述有错误 --- 9.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/9.1.md b/9.1.md index d74c537c..ddcec004 100644 --- a/9.1.md +++ b/9.1.md @@ -15,7 +15,7 @@ CSRF（Cross-site request forgery），中文名称：跨站请求伪造，也 从上图可以看出，要完成一次CSRF攻击，受害者必须依次完成两个步骤 ： - 1.登录受信任网站A，并在本地生成Cookie 。 -- 2.在不登出A的情况下，访问危险网站B。 +- 2.在不退出A的情况下，访问危险网站B。 看到这里，读者也许会问：“如果我不满足以上两个条件中的任意一个，就不会受到CSRF的攻击”。是的，确实如此，但你不能保证以下情况不会发生： From 5100708ecd951df121106918f0ed7ac33c3b5d3b Mon Sep 17 00:00:00 2001 From: gan weiliang Date: Fri, 14 Dec 2012 21:13:54 +0800 Subject: [PATCH 46/49] =?UTF-8?q?=E8=BF=99=E9=87=8C=E5=BA=94=E8=AF=A5?= =?UTF-8?q?=E6=9C=89=E9=80=97=E5=8F=B7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 2.7.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/2.7.md b/2.7.md index ea296df1..006be415 100644 --- a/2.7.md +++ b/2.7.md @@ -80,7 +80,7 @@ channel通过操作符`<-`来接收和发送数据 fmt.Println(x, y, x + y) } -默认情况下，channel接收和发送数据都是阻塞的除非另一端已经准备好，这样就使得Goroutines同步变的更加的简单，而不需要显式的lock。所谓阻塞，也就是如果读取（value := <-ch）它将会被阻塞，直到有数据接收。其次，任何发送（ch<-5）将会被阻塞，直到数据被读出。无缓冲channel 是在多个goroutine之间同步很棒的工具。 +默认情况下，channel接收和发送数据都是阻塞的，除非另一端已经准备好，这样就使得Goroutines同步变的更加的简单，而不需要显式的lock。所谓阻塞，也就是如果读取（value := <-ch）它将会被阻塞，直到有数据接收。其次，任何发送（ch<-5）将会被阻塞，直到数据被读出。无缓冲channel 是在多个goroutine之间同步很棒的工具。 ## Buffered Channels 上面我们介绍了默认的非缓存类型的channel，不过Go也允许指定channel的缓冲大小，很简单，就是channel可以存储多少元素。ch:= make(chan bool, 4)，创建了可以存储4个元素的bool 型channel。在这个channel 中，前4个元素可以无阻塞的写入。当写入第5个元素时，代码将会阻塞，直到其他goroutine从channel 中读取一些元素，腾出空间。 From 49008f3d7c680a996dcd8fc2e3ff20bd3b3068ee Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Tue, 25 Dec 2012 00:02:50 +0800 Subject: [PATCH 47/49] =?UTF-8?q?=E5=AE=8C=E6=88=90=E7=AC=AC=E5=8D=81?= =?UTF-8?q?=E4=B8=89=E7=AB=A0=E7=9A=84=E4=B9=A6=E5=86=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 13.1.md | 2 +- 13.2.md | 568 ++++++++++++++++++++++++----------------------------- 13.3.md | 376 +++++++++++++---------------------- 13.4.md | 380 +++++++++++++++++++++-------------- 13.5.md | 499 +++++++++++++++++++++++----------------------- 13.6.md | 7 +- 13.7.md | 6 - 13.md | 15 +- preface.md | 11 +- 9 files changed, 904 insertions(+), 960 deletions(-) delete mode 100644 13.7.md diff --git a/13.1.md b/13.1.md index d1727dd9..ced462af 100644 --- a/13.1.md +++ b/13.1.md @@ -44,4 +44,4 @@ gopath是一个文件系统的目录，我们可以随便设置一个目录为go ## links * [目录]() * 上一章: [构建博客系统](<13.md>) - * 下一节: [数据库设计](<13.2.md>) \ No newline at end of file + * 下一节: [自定义路由器设计](<13.2.md>) \ No newline at end of file diff --git a/13.2.md b/13.2.md index fdb0a29b..a6988183 100644 --- a/13.2.md +++ b/13.2.md @@ -1,308 +1,260 @@ -# 13.2 数据库设计 -我们设计的博客是一个单用户的博客，目前很多用户都采用wordpress作为自己的博客系统，包括我自己也在使用wordpress,我们知道wordpress系统的一个主页乐观的估计也有20余次查询，但这依然无法阻挡这款程序的流行,在去年对全球top10 blogger所使用的系统调查中,wordpress比其他系统有着明显的优势。 - -但是我们这次演示的博客系统是一个单用户的系统所以查询肯定不需要20余次，数据库的结构也相对的简单很多，因此单用户系统设计重点在于灵活性和结构化,当我们集中地暴露系统瓶颈,从另一个方面也可以集中精力去解决它。例如把数据库从MySQL改成redis。 - -博客主要分为博文、分类、页面、评论、用户、友情链接、tag，那么我们可以采用内容表存储一些实体相关的信息：文章内容、草稿、页面等信息，meta表保存分类、tag等信息，关系表维护两者的关系，评论表存储用户的评论，用户表存储博客用户的信息。 - -## 内容表 -这张表主要用来存储内容实体信息,主要的表结构如下所示 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
键名类型属性解释
cidint(10)主键,非负,自增post表主键
titlevarchar(200)可为空内容标题
slugvarchar(200)索引,可为空内容缩略名
createdint(10)索引,非负,可为空内容生成时的GMT unix时间戳
modifiedint(10)非负,可为空内容更改时的GMT unix时间戳
texttext可为空内容文字
orderint(10)非负,可为空排序
authorIdint(10)非负,可为空内容所属用户id
typevarchar(16)可为空内容类别
statusvarchar(16)可为空内容状态
passwordvarchar(32)可为空受保护内容,此字段对应内容保护密码
commentsNumint(10)非负,可为空内容所属评论数,冗余字段
- -## 关系表 -这张表维护着内容表和扩展表之间的关系 - - - - - - - - - - - - - - - - - - - - -
键名类型属性解释
cidint(10)主键,非负内容主键
midint(10)主键,非负扩展表主键
- -## meta表 -这张表主要用来存储和内容相关联的一些扩展信息，包括tag、分类之类的信息 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
键名类型属性解释
midint(10)主键,非负扩展表主键
namevarchar(200)可为空名称
slugvarchar(200)索引,可为空扩展缩略名
typevarchar(32)可为空扩展类型
descriptionvarchar(200)可为空扩展描述
countint(10)非负,可为空扩展所属内容个数，冗余字段
orderint(10)非负,可为空扩展排序
- - -## 评论表 -实体内容表相应的评论信息表 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
键名类型属性解释
coidint(10)主键,非负,自增comment表主键
cidint(10)索引,非负post表主键,关联字段
cidint(10)索引,非负post表主键,关联字段
createdint(10)非负,可为空评论生成时的GMT unix时间戳
texttext可为空评论内容
typevarchar(16)可为空评论类型
statusvarchar(16)可为空评论状态
authorvarchar(200)可为空评论用户
- -## 用户表 -存储博客系统中用户的信息： - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
键名类型属性解释
uidint(10)主键,非负,自增user表主键
usernamevarchar(32)唯一用户名
passwordvarchar(32)可为空用户密码
createdint(10)非负,可为空用户注册时的GMT unix时间戳
lastloginint(10)非负,可为空最后登录时间
-## 配置表 -网站的配置信息表： - - - - - - - - - - - - - - - - - - - - - - - - - - -
键名类型属性解释
namevarchar(32)主键配置名称
uidint(10)主键,非负配置所属用户,默认为0(全局配置)
valuetext主键,非负,自增配置值
- -上面设计了一个完整的博客系统所拥有的一些功能的表，基于这些表我们可以设计出来一个强大的单用户博客，基本能够实现wordpress的一些基础单用户博客的功能。 -## links - * [目录]() - * 上一章: [项目规划](<13.1.md>) - * 下一节: [自定义路由器设计](<13.3.md>) \ No newline at end of file +# 13.2 自定义路由器设计 + +## HTTP路由 +HTTP路由组件负责将HTTP请求交到对应的函数处理(或者是一个struct的方法)，如前面小节所描述的结构图，路由在框架中相当于一个事件处理器，而这个事件包括： + +- 用户请求的路径(例如:/user/123,/article/123)，当然还有查询串信息(例如?id=11) +- HTTP的请求method(GET、POST、PUT、DELETE、PATCH等) + +路由器就是根据用户请求的这个信息定位到相应的处理函数。 +## 默认的路由实现 +在3.4小节有过介绍Go的http包的详解，里面介绍了Go的http包如何设计和实现路由，这里继续以一个例子来说明： + + func fooHandler(w http.ResponseWriter, r *http.Request) { + fmt.Fprintf(w, "Hello, %q", html.EscapeString(r.URL.Path)) + } + + http.Handle("/foo", fooHandler) + + http.HandleFunc("/bar", func(w http.ResponseWriter, r *http.Request) { + fmt.Fprintf(w, "Hello, %q", html.EscapeString(r.URL.Path)) + }) + + log.Fatal(http.ListenAndServe(":8080", nil)) + +上面的例子调用了http默认的DefaultServeMux来添加路由，两个参数，第一个参数是前面所讲的用户请求的路径(Go中保存在r.URL.Path)，第二参数是定位要执行的函数，路由的思路主要集中在两点： + +- 添加路由信息 +- 根据用户请求转发到要执行的函数 + +Go默认的包添加是通过函数`http.Handle`和`http.HandleFunc`等来添加，底层都是调用了`DefaultServeMux.Handle(pattern string, handler Handler)`,这个函数会把路由信息存储在一个map信息中`map[string]muxEntry`，这就解决了上面说的第一点。 + +Go的监听端口，然后接收到tcp连接会扔给Handler来处理，上面的例子默认nil即为`http.DefaultServeMux`，通过`DefaultServeMux.ServeHTTP`函数来进行调度，循环上面存储的map信息，和访问url进行比对查询注册的处理函数，这样就实现了上面所说的第二点。 + + for k, v := range mux.m { + if !pathMatch(k, path) { + continue + } + if h == nil || len(k) > n { + n = len(k) + h = v.h + } + } + + +## beego框架路由实现 +目前几乎所有的Web应用路由实现都是基于http默认的路由器，但是默认的路由器有几个限制点： + +- 不支持参数设定，例如/user/:uid 这种泛类型匹配 +- 无法很好的支持REST模式，无法限制访问的方法，例如上面的例子中，用户访问/foo，可以用GET、POST、DELETE、HEAD等方式访问 +- 默认的路由规则太多了，我前面自己开发了一个API的应用，路由规则有三十几条，这种路由多了之后其实可以进一步简化，通过struct的方法进行一种简化 + +beego框架的路由器基于上面的几点限制考虑设计了一种REST方式的路由实现，路由设计也是基于上面的默认设计的两点来考虑：存储路由和转发路由 + +### 存储路由 +针对前面所说的限制点，我们首先要解决参数支持就需要用到正则，第二和第三点我们通过一种变通的方法来解决，REST的方法对应到struct的方法中去，然后路由到struct而不是函数，这样在转发路由的时候就可以根据method来执行不同的方法。 + +根据上面的思路，我们设计了两个数据类型controllerInfo(保存路径和对应的struct，这里是一个reflect.Type类型)和ControllerRegistor(routers是一个slice用来保存用户添加的路由信息，已经beego框架的信息) + + type controllerInfo struct { + regex *regexp.Regexp + params map[int]string + controllerType reflect.Type + } + + type ControllerRegistor struct { + routers []*controllerInfo + Application *App + } + + +ControllerRegistor对外的接口函数有 + + func (p *ControllerRegistor) Add(pattern string, c ControllerInterface) + +详细的实现如下所示： + + func (p *ControllerRegistor) Add(pattern string, c ControllerInterface) { + parts := strings.Split(pattern, "/") + + j := 0 + params := make(map[int]string) + for i, part := range parts { + if strings.HasPrefix(part, ":") { + expr := "([^/]+)" + //a user may choose to override the defult expression + // similar to expressjs: ‘/user/:id([0-9]+)’ + if index := strings.Index(part, "("); index != -1 { + expr = part[index:] + part = part[:index] + } + params[j] = part + parts[i] = expr + j++ + } + } + + //recreate the url pattern, with parameters replaced + //by regular expressions. then compile the regex + pattern = strings.Join(parts, "/") + regex, regexErr := regexp.Compile(pattern) + if regexErr != nil { + //TODO add error handling here to avoid panic + panic(regexErr) + return + } + + //now create the Route + t := reflect.Indirect(reflect.ValueOf(c)).Type() + route := &controllerInfo{} + route.regex = regex + route.params = params + route.controllerType = t + + p.routers = append(p.routers, route) + + } + +### 静态路由实现 +上面我们实现的动态路由的实现，Go的http包默认支持静态文件处理FileServer，由于我们实现了自定义的路由器，那么静态文件也需要自己设定，beego的静态文件夹保存在全局变量StaticDir中，StaticDir是一个map类型，实现如下： + + func (app *App) SetStaticPath(url string, path string) *App { + StaticDir[url] = path + return app + } + +应用中设置静态路径可以使用如下方式实现： + + beego.SetStaticPath("/img","/static/img") + + +### 转发路由 +转发路由是基于ControllerRegistor的路由信息来进行转发的，详细的实现如下代码所示： + + // AutoRoute + func (p *ControllerRegistor) ServeHTTP(w http.ResponseWriter, r *http.Request) { + defer func() { + if err := recover(); err != nil { + if !RecoverPanic { + // go back to panic + panic(err) + } else { + Critical("Handler crashed with error", err) + for i := 1; ; i += 1 { + _, file, line, ok := runtime.Caller(i) + if !ok { + break + } + Critical(file, line) + } + } + } + }() + var started bool + for prefix, staticDir := range StaticDir { + if strings.HasPrefix(r.URL.Path, prefix) { + file := staticDir + r.URL.Path[len(prefix):] + http.ServeFile(w, r, file) + started = true + return + } + } + requestPath := r.URL.Path + + //find a matching Route + for _, route := range p.routers { + + //check if Route pattern matches url + if !route.regex.MatchString(requestPath) { + continue + } + + //get submatches (params) + matches := route.regex.FindStringSubmatch(requestPath) + + //double check that the Route matches the URL pattern. + if len(matches[0]) != len(requestPath) { + continue + } + + params := make(map[string]string) + if len(route.params) > 0 { + //add url parameters to the query param map + values := r.URL.Query() + for i, match := range matches[1:] { + values.Add(route.params[i], match) + params[route.params[i]] = match + } + + //reassemble query params and add to RawQuery + r.URL.RawQuery = url.Values(values).Encode() + "&" + r.URL.RawQuery + //r.URL.RawQuery = url.Values(values).Encode() + } + //Invoke the request handler + vc := reflect.New(route.controllerType) + init := vc.MethodByName("Init") + in := make([]reflect.Value, 2) + ct := &Context{ResponseWriter: w, Request: r, Params: params} + in[0] = reflect.ValueOf(ct) + in[1] = reflect.ValueOf(route.controllerType.Name()) + init.Call(in) + in = make([]reflect.Value, 0) + method := vc.MethodByName("Prepare") + method.Call(in) + if r.Method == "GET" { + method = vc.MethodByName("Get") + method.Call(in) + } else if r.Method == "POST" { + method = vc.MethodByName("Post") + method.Call(in) + } else if r.Method == "HEAD" { + method = vc.MethodByName("Head") + method.Call(in) + } else if r.Method == "DELETE" { + method = vc.MethodByName("Delete") + method.Call(in) + } else if r.Method == "PUT" { + method = vc.MethodByName("Put") + method.Call(in) + } else if r.Method == "PATCH" { + method = vc.MethodByName("Patch") + method.Call(in) + } else if r.Method == "OPTIONS" { + method = vc.MethodByName("Options") + method.Call(in) + } + if AutoRender { + method = vc.MethodByName("Render") + method.Call(in) + } + method = vc.MethodByName("Finish") + method.Call(in) + started = true + break + } + + //if no matches to url, throw a not found exception + if started == false { + http.NotFound(w, r) + } + } + +### 使用入门 +基于这样的路由设计之后就可以解决前面所说的三个限制点，使用的方式如下所示： + +基本的使用注册路由： + + beego.BeeApp.RegisterController("/", &controllers.MainController{}) + +参数注册： + + beego.BeeApp.RegisterController("/:param", &controllers.UserController{}) + +正则匹配： + + beego.BeeApp.RegisterController("/users/:uid([0-9]+)", &controllers.UserController{}) + +## links + * [目录]() + * 上一章: [数据库设计](<13.2.md>) + * 下一节: [controller设计](<13.4.md>) \ No newline at end of file diff --git a/13.3.md b/13.3.md index 0ed81a49..5997c640 100644 --- a/13.3.md +++ b/13.3.md @@ -1,260 +1,162 @@ -# 13.3 自定义路由器设计 +# 13.3 controller设计 -## HTTP路由 -HTTP路由组件负责将HTTP请求交到对应的函数处理(或者是一个struct的方法)，如前面小节所描述的结构图，路由在框架中相当于一个事件处理器，而这个事件包括： +传统的MVC框架大多数是基于Action设计的后缀式映射，然而目前流行的Web趋势是REST风格的架构。尽管使用Filter或者rewrite能够通过URL重写实现REST风格的URL，但是为什么不直接设计一个全新的REST风格的 MVC框架呢？本小节就是基于这种思路来讲述如何从头设计一个基于REST风格的MVC框架中的controller，最大限度地简化Web应用的开发，您甚至编写一行代码就可以实现“Hello, world”。 -- 用户请求的路径(例如:/user/123,/article/123)，当然还有查询串信息(例如?id=11) -- HTTP的请求method(GET、POST、PUT、DELETE、PATCH等) +## controller作用 +MVC设计模式是目前Web应用开发中最常见的一种架构模式，通过分离 Model（模型）、View（视图）和 Controller（控制器），可以更容易实现易于扩展的UI。Model指后台返回的数据；View指需要渲染的页面，通常是模板页面，渲染后的结果通常是HTML；Controller指Web开发人员编写的处理不同URL的控制器，如前面小节讲述的路由就是转发到控制器的过程，controller在整个的MVC框架中起到了一个核心的作用，处理业务逻辑，因此控制器是整个框架中必不可少的一部分，Model和View会根据不同的业务可以不写，例如没有数据处理的逻辑处理，没有页面输出的302调整之类的就不需要Model和View，但是controller是必不可少的。 -路由器就是根据用户请求的这个信息定位到相应的处理函数。 -## 默认的路由实现 -在3.4小节有过介绍Go的http包的详解，里面介绍了Go的http包如何设计和实现路由，这里继续以一个例子来说明： +## beego的REST设计 +前面小节介绍了路由实现了注册struct的功能，而struct中实现了REST方式，因此我们需要设计一个用于逻辑处理controller的基类，这里主要设计了两个类型，一个struct、一个interface - func fooHandler(w http.ResponseWriter, r *http.Request) { - fmt.Fprintf(w, "Hello, %q", html.EscapeString(r.URL.Path)) - } - - http.Handle("/foo", fooHandler) - - http.HandleFunc("/bar", func(w http.ResponseWriter, r *http.Request) { - fmt.Fprintf(w, "Hello, %q", html.EscapeString(r.URL.Path)) - }) - - log.Fatal(http.ListenAndServe(":8080", nil)) - -上面的例子调用了http默认的DefaultServeMux来添加路由，两个参数，第一个参数是前面所讲的用户请求的路径(Go中保存在r.URL.Path)，第二参数是定位要执行的函数，路由的思路主要集中在两点： - -- 添加路由信息 -- 根据用户请求转发到要执行的函数 - -Go默认的包添加是通过函数`http.Handle`和`http.HandleFunc`等来添加，底层都是调用了`DefaultServeMux.Handle(pattern string, handler Handler)`,这个函数会把路由信息存储在一个map信息中`map[string]muxEntry`，这就解决了上面说的第一点。 - -Go的监听端口，然后接收到tcp连接会扔给Handler来处理，上面的例子默认nil即为`http.DefaultServeMux`，通过`DefaultServeMux.ServeHTTP`函数来进行调度，循环上面存储的map信息，和访问url进行比对查询注册的处理函数，这样就实现了上面所说的第二点。 - - for k, v := range mux.m { - if !pathMatch(k, path) { - continue - } - if h == nil || len(k) > n { - n = len(k) - h = v.h - } - } - - -## beego框架路由实现 -目前几乎所有的Web应用路由实现都是基于http默认的路由器，但是默认的路由器有几个限制点： - -- 不支持参数设定，例如/user/:uid 这种泛类型匹配 -- 无法很好的支持REST模式，无法限制访问的方法，例如上面的例子中，用户访问/foo，可以用GET、POST、DELETE、HEAD等方式访问 -- 默认的路由规则太多了，我前面自己开发了一个API的应用，路由规则有三十几条，这种路由多了之后其实可以进一步简化，通过struct的方法进行一种简化 - -beego框架的路由器基于上面的几点限制考虑设计了一种REST方式的路由实现，路由设计也是基于上面的默认设计的两点来考虑：存储路由和转发路由 - -### 存储路由 -针对前面所说的限制点，我们首先要解决参数支持就需要用到正则，第二和第三点我们通过一种变通的方法来解决，REST的方法对应到struct的方法中去，然后路由到struct而不是函数，这样在转发路由的时候就可以根据method来执行不同的方法。 - -根据上面的思路，我们设计了两个数据类型controllerInfo(保存路径和对应的struct，这里是一个reflect.Type类型)和ControllerRegistor(routers是一个slice用来保存用户添加的路由信息，已经beego框架的信息) - - type controllerInfo struct { - regex *regexp.Regexp - params map[int]string - controllerType reflect.Type - } - - type ControllerRegistor struct { - routers []*controllerInfo - Application *App + type Controller struct { + Ct *Context + Tpl *template.Template + Data map[interface{}]interface{} + ChildName string + TplNames string + Layout []string + TplExt string } - -ControllerRegistor对外的接口函数有 - - func (p *ControllerRegistor) Add(pattern string, c ControllerInterface) - -详细的实现如下所示： - - func (p *ControllerRegistor) Add(pattern string, c ControllerInterface) { - parts := strings.Split(pattern, "/") + type ControllerInterface interface { + Init(ct *Context, cn string) //初始化上下文和子类名称 + Prepare() //开始执行之前的一些处理 + Get() //method=GET的处理 + Post() //method=POST的处理 + Delete() //method=DELETE的处理 + Put() //method=PUT的处理 + Head() //method=HEAD的处理 + Patch() //method=PATCH的处理 + Options() //method=OPTIONS的处理 + Finish() //执行完成之后的处理 Render() error //执行完method对应的方法之后渲染页面 + } - j := 0 - params := make(map[int]string) - for i, part := range parts { - if strings.HasPrefix(part, ":") { - expr := "([^/]+)" - //a user may choose to override the defult expression - // similar to expressjs: ‘/user/:id([0-9]+)’ - if index := strings.Index(part, "("); index != -1 { - expr = part[index:] - part = part[:index] - } - params[j] = part - parts[i] = expr - j++ - } - } +那么前面介绍的路由add的时候是定义了ControllerInterface类型，因此，只要我们实现这个接口就可以，所以我们的基类Controller实现如下的方法： + + func (c *Controller) Init(ct *Context, cn string) { + c.Data = make(map[interface{}]interface{}) + c.Layout = make([]string, 0) + c.TplNames = "" + c.ChildName = cn + c.Ct = ct + c.TplExt = "tpl" + } - //recreate the url pattern, with parameters replaced - //by regular expressions. then compile the regex - pattern = strings.Join(parts, "/") - regex, regexErr := regexp.Compile(pattern) - if regexErr != nil { - //TODO add error handling here to avoid panic - panic(regexErr) - return - } - - //now create the Route - t := reflect.Indirect(reflect.ValueOf(c)).Type() - route := &controllerInfo{} - route.regex = regex - route.params = params - route.controllerType = t - - p.routers = append(p.routers, route) + func (c *Controller) Prepare() { } -### 静态路由实现 -上面我们实现的动态路由的实现，Go的http包默认支持静态文件处理FileServer，由于我们实现了自定义的路由器，那么静态文件也需要自己设定，beego的静态文件夹保存在全局变量StaticDir中，StaticDir是一个map类型，实现如下： - - func (app *App) SetStaticPath(url string, path string) *App { - StaticDir[url] = path - return app + func (c *Controller) Finish() { + } - -应用中设置静态路径可以使用如下方式实现： - - beego.SetStaticPath("/img","/static/img") - -### 转发路由 -转发路由是基于ControllerRegistor的路由信息来进行转发的，详细的实现如下代码所示： - - // AutoRoute - func (p *ControllerRegistor) ServeHTTP(w http.ResponseWriter, r *http.Request) { - defer func() { - if err := recover(); err != nil { - if !RecoverPanic { - // go back to panic - panic(err) - } else { - Critical("Handler crashed with error", err) - for i := 1; ; i += 1 { - _, file, line, ok := runtime.Caller(i) - if !ok { - break - } - Critical(file, line) - } - } + func (c *Controller) Get() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Post() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Delete() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Put() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Head() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Patch() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Options() { + http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) + } + + func (c *Controller) Render() error { + if len(c.Layout) > 0 { + var filenames []string + for _, file := range c.Layout { + filenames = append(filenames, path.Join(ViewsPath, file)) } - }() - var started bool - for prefix, staticDir := range StaticDir { - if strings.HasPrefix(r.URL.Path, prefix) { - file := staticDir + r.URL.Path[len(prefix):] - http.ServeFile(w, r, file) - started = true - return + t, err := template.ParseFiles(filenames...) + if err != nil { + Trace("template ParseFiles err:", err) + } + err = t.ExecuteTemplate(c.Ct.ResponseWriter, c.TplNames, c.Data) + if err != nil { + Trace("template Execute err:", err) + } + } else { + if c.TplNames == "" { + c.TplNames = c.ChildName + "/" + c.Ct.Request.Method + "." + c.TplExt + } + t, err := template.ParseFiles(path.Join(ViewsPath, c.TplNames)) + if err != nil { + Trace("template ParseFiles err:", err) + } + err = t.Execute(c.Ct.ResponseWriter, c.Data) + if err != nil { + Trace("template Execute err:", err) } } - requestPath := r.URL.Path + return nil + } - //find a matching Route - for _, route := range p.routers { - - //check if Route pattern matches url - if !route.regex.MatchString(requestPath) { - continue - } - - //get submatches (params) - matches := route.regex.FindStringSubmatch(requestPath) - - //double check that the Route matches the URL pattern. - if len(matches[0]) != len(requestPath) { - continue - } - - params := make(map[string]string) - if len(route.params) > 0 { - //add url parameters to the query param map - values := r.URL.Query() - for i, match := range matches[1:] { - values.Add(route.params[i], match) - params[route.params[i]] = match - } - - //reassemble query params and add to RawQuery - r.URL.RawQuery = url.Values(values).Encode() + "&" + r.URL.RawQuery - //r.URL.RawQuery = url.Values(values).Encode() - } - //Invoke the request handler - vc := reflect.New(route.controllerType) - init := vc.MethodByName("Init") - in := make([]reflect.Value, 2) - ct := &Context{ResponseWriter: w, Request: r, Params: params} - in[0] = reflect.ValueOf(ct) - in[1] = reflect.ValueOf(route.controllerType.Name()) - init.Call(in) - in = make([]reflect.Value, 0) - method := vc.MethodByName("Prepare") - method.Call(in) - if r.Method == "GET" { - method = vc.MethodByName("Get") - method.Call(in) - } else if r.Method == "POST" { - method = vc.MethodByName("Post") - method.Call(in) - } else if r.Method == "HEAD" { - method = vc.MethodByName("Head") - method.Call(in) - } else if r.Method == "DELETE" { - method = vc.MethodByName("Delete") - method.Call(in) - } else if r.Method == "PUT" { - method = vc.MethodByName("Put") - method.Call(in) - } else if r.Method == "PATCH" { - method = vc.MethodByName("Patch") - method.Call(in) - } else if r.Method == "OPTIONS" { - method = vc.MethodByName("Options") - method.Call(in) - } - if AutoRender { - method = vc.MethodByName("Render") - method.Call(in) - } - method = vc.MethodByName("Finish") - method.Call(in) - started = true - break - } - - //if no matches to url, throw a not found exception - if started == false { - http.NotFound(w, r) - } - } + func (c *Controller) Redirect(url string, code int) { + c.Ct.Redirect(code, url) + } -### 使用入门 -基于这样的路由设计之后就可以解决前面所说的三个限制点，使用的方式如下所示： +上面的controller基类完成了接口定义的函数，通过路由根据url执行相应的controller的原则，会依次执行如下的函数： -基本的使用注册路由： + Init() 初始化 + Prepare() 执行之前的初始化，每个继承的子类可以来实现该函数 + method() 根据不同的method执行不同的函数：GET、POST、PUT、HEAD等，子类来实现这些函数，如果没实现，那么默认都是403 + Render() 可选，根据全局变量AutoRender来判断是否执行 + Finish() 执行完之后执行的操作，每个继承的子类可以来实现该函数 - beego.BeeApp.RegisterController("/", &controllers.MainController{}) +## 应用指南 +上面beego框架中完成了controller基类的设计，那么我们在我们的应用中可以这样来设计我们的方法： + + package controllers -参数注册： - - beego.BeeApp.RegisterController("/:param", &controllers.UserController{}) + import ( + "github.com/astaxie/beego" + ) -正则匹配： + type MainController struct { + beego.Controller + } + + func (this *MainController) Get() { + this.Data["Username"] = "astaxie" + this.Data["Email"] = "astaxie@gmail.com" + this.TplNames = "index.tpl" + } + +上面的方式我们实现了子类MainController，实现了Get方法，那么如果用户通过其他的方式(POST/HEAD等)来访问该资源都将返回403，而如果是Get来访问，因为我们设置了AutoRender=true，那么在执行玩Get方法之后会自动执行Render函数，就会显示如下界面： - beego.BeeApp.RegisterController("/users/:uid([0-9]+)", &controllers.UserController{}) - -## links - * [目录]() - * 上一章: [数据库设计](<13.2.md>) - * 下一节: [controller设计](<13.4.md>) \ No newline at end of file +![](images/13.4.beego.png?raw=true) + +index.tpl的代码如下所示，我们可以看到数据的设置和显示都是相当的简单方便： + + + + + beego welcome template + + +

Hello, world!{{.Username}},{{.Email}}

+ + + + +## links + * [目录]() + * 上一章: [自定义路由器设计](<13.2.md>) + * 下一节: [日志和配置设计](<13.4.md>) \ No newline at end of file diff --git a/13.4.md b/13.4.md index acf6f9d8..8289e0af 100644 --- a/13.4.md +++ b/13.4.md @@ -1,162 +1,248 @@ -# 13.4 controller设计 +# 13.4 日志和配置设计 -传统的MVC框架大多数是基于Action设计的后缀式映射，然而目前流行的Web趋势是REST风格的架构。尽管使用Filter或者rewrite能够通过URL重写实现REST风格的URL，但是为什么不直接设计一个全新的REST风格的 MVC框架呢？本小节就是基于这种思路来讲述如何从头设计一个基于REST风格的MVC框架中的controller，最大限度地简化Web应用的开发，您甚至编写一行代码就可以实现“Hello, world”。 +## 日志和配置的重要性 +前面已经介绍过日志在我们程序开发中起着很重要的作用，通过日志我们可以记录调试我们的信息，当初介绍过一个日志系统seelog，根据不同的level输出不同的日志，这个对于程序开发和程序部署来说至关重要。我们可以在程序开发中设置level低一点，部署的时候把level设置高，这样我们开发中的调试信息可以屏蔽掉。 -## controller作用 -MVC设计模式是目前Web应用开发中最常见的一种架构模式，通过分离 Model（模型）、View（视图）和 Controller（控制器），可以更容易实现易于扩展的UI。Model指后台返回的数据；View指需要渲染的页面，通常是模板页面，渲染后的结果通常是HTML；Controller指Web开发人员编写的处理不同URL的控制器，如前面小节讲述的路由就是转发到控制器的过程，controller在整个的MVC框架中起到了一个核心的作用，处理业务逻辑，因此控制器是整个框架中必不可少的一部分，Model和View会根据不同的业务可以不写，例如没有数据处理的逻辑处理，没有页面输出的302调整之类的就不需要Model和View，但是controller是必不可少的。 +配置模块对于应用部署牵涉到服务器不同的一些配置信息非常有用，例如一些数据库配置信息、监听端口、监听地址等都是可以通过配置文件来配置，这样我们的应用程序就具有很强的灵活性，可以通过配置文件的配置部署在不同的机器上，可以连接不同的数据库之类的。 -## beego的REST设计 -前面小节介绍了路由实现了注册struct的功能，而struct中实现了REST方式，因此我们需要设计一个用于逻辑处理controller的基类，这里主要设计了两个类型，一个struct、一个interface +## beego的日志设计 +beego的日志设计部署思路来自于seelog，根据不同的level来记录日志，但是beego设计的日志系统比较轻量级，采用了系统的log.Logger接口，默认输出到os.Stdout,用户可以实现这个接口然后通过beego.SetLogger设置自定义的输出，详细的实现如下所示： - type Controller struct { - Ct *Context - Tpl *template.Template - Data map[interface{}]interface{} - ChildName string - TplNames string - Layout []string - TplExt string - } - type ControllerInterface interface { - Init(ct *Context, cn string) //初始化上下文和子类名称 - Prepare() //开始执行之前的一些处理 - Get() //method=GET的处理 - Post() //method=POST的处理 - Delete() //method=DELETE的处理 - Put() //method=PUT的处理 - Head() //method=HEAD的处理 - Patch() //method=PATCH的处理 - Options() //method=OPTIONS的处理 - Finish() //执行完成之后的处理 Render() error //执行完method对应的方法之后渲染页面 - } - -那么前面介绍的路由add的时候是定义了ControllerInterface类型，因此，只要我们实现这个接口就可以，所以我们的基类Controller实现如下的方法： - - func (c *Controller) Init(ct *Context, cn string) { - c.Data = make(map[interface{}]interface{}) - c.Layout = make([]string, 0) - c.TplNames = "" - c.ChildName = cn - c.Ct = ct - c.TplExt = "tpl" - } - - func (c *Controller) Prepare() { - - } - - func (c *Controller) Finish() { - - } - - func (c *Controller) Get() { - http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) - } - - func (c *Controller) Post() { - http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) - } - - func (c *Controller) Delete() { - http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) - } - - func (c *Controller) Put() { - http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) - } - - func (c *Controller) Head() { - http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) - } - - func (c *Controller) Patch() { - http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) - } - - func (c *Controller) Options() { - http.Error(c.Ct.ResponseWriter, "Method Not Allowed", 405) - } - - func (c *Controller) Render() error { - if len(c.Layout) > 0 { - var filenames []string - for _, file := range c.Layout { - filenames = append(filenames, path.Join(ViewsPath, file)) - } - t, err := template.ParseFiles(filenames...) - if err != nil { - Trace("template ParseFiles err:", err) - } - err = t.ExecuteTemplate(c.Ct.ResponseWriter, c.TplNames, c.Data) - if err != nil { - Trace("template Execute err:", err) - } - } else { - if c.TplNames == "" { - c.TplNames = c.ChildName + "/" + c.Ct.Request.Method + "." + c.TplExt - } - t, err := template.ParseFiles(path.Join(ViewsPath, c.TplNames)) - if err != nil { - Trace("template ParseFiles err:", err) - } - err = t.Execute(c.Ct.ResponseWriter, c.Data) - if err != nil { - Trace("template Execute err:", err) - } - } - return nil - } - - func (c *Controller) Redirect(url string, code int) { - c.Ct.Redirect(code, url) - } - -上面的controller基类完成了接口定义的函数，通过路由根据url执行相应的controller的原则，会依次执行如下的函数： - - Init() 初始化 - Prepare() 执行之前的初始化，每个继承的子类可以来实现该函数 - method() 根据不同的method执行不同的函数：GET、POST、PUT、HEAD等，子类来实现这些函数，如果没实现，那么默认都是403 - Render() 可选，根据全局变量AutoRender来判断是否执行 - Finish() 执行完之后执行的操作，每个继承的子类可以来实现该函数 - -## 应用指南 -上面beego框架中完成了controller基类的设计，那么我们在我们的应用中可以这样来设计我们的方法： - - package controllers - - import ( - "github.com/astaxie/beego" + // Log levels to control the logging output. + const ( + LevelTrace = iota + LevelDebug + LevelInfo + LevelWarning + LevelError + LevelCritical ) - type MainController struct { - beego.Controller + // logLevel controls the global log level used by the logger. + var level = LevelTrace + + // LogLevel returns the global log level and can be used in + // own implementations of the logger interface. + func Level() int { + return level } - func (this *MainController) Get() { - this.Data["Username"] = "astaxie" - this.Data["Email"] = "astaxie@gmail.com" - this.TplNames = "index.tpl" + // SetLogLevel sets the global log level used by the simple + // logger. + func SetLevel(l int) { + level = l } -上面的方式我们实现了子类MainController，实现了Get方法，那么如果用户通过其他的方式(POST/HEAD等)来访问该资源都将返回403，而如果是Get来访问，因为我们设置了AutoRender=true，那么在执行玩Get方法之后会自动执行Render函数，就会显示如下界面： +上面这一段实现了日志系统的日志分级，默认的级别是Trace，用户通过SetLevel可以设置不同的分级。 + + // logger references the used application logger. + var BeeLogger = log.New(os.Stdout, "", log.Ldate|log.Ltime) + + // SetLogger sets a new logger. + func SetLogger(l *log.Logger) { + BeeLogger = l + } + + // Trace logs a message at trace level. + func Trace(v ...interface{}) { + if level <= LevelTrace { + BeeLogger.Printf("[T] %v\n", v) + } + } + + // Debug logs a message at debug level. + func Debug(v ...interface{}) { + if level <= LevelDebug { + BeeLogger.Printf("[D] %v\n", v) + } + } + + // Info logs a message at info level. + func Info(v ...interface{}) { + if level <= LevelInfo { + BeeLogger.Printf("[I] %v\n", v) + } + } + + // Warning logs a message at warning level. + func Warn(v ...interface{}) { + if level <= LevelWarning { + BeeLogger.Printf("[W] %v\n", v) + } + } + + // Error logs a message at error level. + func Error(v ...interface{}) { + if level <= LevelError { + BeeLogger.Printf("[E] %v\n", v) + } + } + + // Critical logs a message at critical level. + func Critical(v ...interface{}) { + if level <= LevelCritical { + BeeLogger.Printf("[C] %v\n", v) + } + } -![](images/13.4.beego.png?raw=true) +上面这一段代码默认初始化了一个BeeLogger对象，默认输出到os.Stdout，用户可以通过beego.SetLogger来设置实现了logger的接口输出。这里面实现了六个函数： -index.tpl的代码如下所示，我们可以看到数据的设置和显示都是相当的简单方便： +- Trace（一般的记录信息，举例如下：） + - "Entered parse function validation block" + - "Validation: entered second 'if'" + - "Dictionary 'Dict' is empty. Using default value" +- Debug（调试信息，举例如下：） + - "Web page requested: http://somesite.com Params='...'" + - "Response generated. Response size: 10000. Sending." + - "New file received. Type:PNG Size:20000" +- Info（打印信息，举例如下：） + - "Web server restarted" + - "Hourly statistics: Requested pages: 12345 Errors: 123 ..." + - "Service paused. Waiting for 'resume' call" +- Warn（警告信息，举例如下：） + - "Cache corrupted for file='test.file'. Reading from back-end" + - "Database 192.168.0.7/DB not responding. Using backup 192.168.0.8/DB" + - "No response from statistics server. Statistics not sent" +- Error（错误信息，举例如下：） + - "Internal error. Cannot process request #12345 Error:...." + - "Cannot perform login: credentials DB not responding" +- Critical（致命错误，举例如下：） + - "Critical panic received: .... Shutting down" + - "Fatal error: ... App is shutting down to prevent data corruption or loss" - - - - beego welcome template - - -

Hello, world!{{.Username}},{{.Email}}

- - +可以看到每个函数里面都有对level的判断，所以如果我们在部署的时候设置了level=LevelWarning，那么Trace、Debug、Info这三个函数都不会有任何的输出，以此类推。 - -## links - * [目录]() - * 上一章: [自定义路由器设计](<13.3.md>) - * 下一节: [日志和配置设计](<13.5.md>) \ No newline at end of file +## beego的配置设计 +配置信息的解析，beego实现了一个key=value的配置文件读取，类似ini配置文件的格式，就是一个文件解析的过程，然后把解析的数据保存到map中，最后在调用的时候通过几个string、int之类的函数调用返回相应的值，具体的实现请看下面： + +首先定义了一些ini配置文件的一些全局性常量 ： + + var ( + bComment = []byte{'#'} + bEmpty = []byte{} + bEqual = []byte{'='} + bDQuote = []byte{'"'} + ) + +定义了配置文件的格式： + + // A Config represents the configuration. + type Config struct { + filename string + comment map[int][]string // id: []{comment, key...}; id 1 is for main comment. + data map[string]string // key: value + offset map[string]int64 // key: offset; for editing. + sync.RWMutex + } + +定义了解析文件的函数，解析文件的过程是打开文件，然后一行一行的读取，解析注释、空行和key=value数据： + + // ParseFile creates a new Config and parses the file configuration from the + // named file. + func LoadConfig(name string) (*Config, error) { + file, err := os.Open(name) + if err != nil { + return nil, err + } + + cfg := &Config{ + file.Name(), + make(map[int][]string), + make(map[string]string), + make(map[string]int64), + sync.RWMutex{}, + } + cfg.Lock() + defer cfg.Unlock() + defer file.Close() + + var comment bytes.Buffer + buf := bufio.NewReader(file) + + for nComment, off := 0, int64(1); ; { + line, _, err := buf.ReadLine() + if err == io.EOF { + break + } + if bytes.Equal(line, bEmpty) { + continue + } + + off += int64(len(line)) + + if bytes.HasPrefix(line, bComment) { + line = bytes.TrimLeft(line, "#") + line = bytes.TrimLeftFunc(line, unicode.IsSpace) + comment.Write(line) + comment.WriteByte('\n') + continue + } + if comment.Len() != 0 { + cfg.comment[nComment] = []string{comment.String()} + comment.Reset() + nComment++ + } + + val := bytes.SplitN(line, bEqual, 2) + if bytes.HasPrefix(val[1], bDQuote) { + val[1] = bytes.Trim(val[1], `"`) + } + + key := strings.TrimSpace(string(val[0])) + cfg.comment[nComment-1] = append(cfg.comment[nComment-1], key) + cfg.data[key] = strings.TrimSpace(string(val[1])) + cfg.offset[key] = off + } + return cfg, nil + } + +下面实现了一些读取配置文件的函数，返回的值确定为bool、int、float64或string： + + // Bool returns the boolean value for a given key. + func (c *Config) Bool(key string) (bool, error) { + return strconv.ParseBool(c.data[key]) + } + + // Int returns the integer value for a given key. + func (c *Config) Int(key string) (int, error) { + return strconv.Atoi(c.data[key]) + } + + // Float returns the float value for a given key. + func (c *Config) Float(key string) (float64, error) { + return strconv.ParseFloat(c.data[key], 64) + } + + // String returns the string value for a given key. + func (c *Config) String(key string) string { + return c.data[key] + } + +## 应用指南 +下面这个函数是我一个应用中的例子，用来获取远程url地址的json数据，实现如下： + + func GetJson() { + resp, err := http.Get(beego.AppConfig.String("url")) + if err != nil { + beego.Critical("http get info error") + return + } + defer resp.Body.Close() + body, err := ioutil.ReadAll(resp.Body) + err = json.Unmarshal(body, &AllInfo) + if err != nil { + beego.Critical("error:", err) + } + } + +函数中调用了框架的日志函数`beego.Critical`函数用来报错，调用了`beego.AppConfig.String("url")`用来获取配置文件中的信息，配置文件的信息如下(app.conf)： + + appname = hs + url ="http://www.api.com/api.html" + + +## links + * [目录]() + * 上一章: [controller设计](<13.3.md>) + * 下一节: [实现博客的增删改](<13.5.md>) \ No newline at end of file diff --git a/13.5.md b/13.5.md index 8349a538..f0be299d 100644 --- a/13.5.md +++ b/13.5.md @@ -1,248 +1,259 @@ -# 13.5 日志和配置设计 - -## 日志和配置的重要性 -前面已经介绍过日志在我们程序开发中起着很重要的作用，通过日志我们可以记录调试我们的信息，当初介绍过一个日志系统seelog，根据不同的level输出不同的日志，这个对于程序开发和程序部署来说至关重要。我们可以在程序开发中设置level低一点，部署的时候把level设置高，这样我们开发中的调试信息可以屏蔽掉。 - -配置模块对于应用部署牵涉到服务器不同的一些配置信息非常有用，例如一些数据库配置信息、监听端口、监听地址等都是可以通过配置文件来配置，这样我们的应用程序就具有很强的灵活性，可以通过配置文件的配置部署在不同的机器上，可以连接不同的数据库之类的。 - -## beego的日志设计 -beego的日志设计部署思路来自于seelog，根据不同的level来记录日志，但是beego设计的日志系统比较轻量级，采用了系统的log.Logger接口，默认输出到os.Stdout,用户可以实现这个接口然后通过beego.SetLogger设置自定义的输出，详细的实现如下所示： - - - // Log levels to control the logging output. - const ( - LevelTrace = iota - LevelDebug - LevelInfo - LevelWarning - LevelError - LevelCritical - ) - - // logLevel controls the global log level used by the logger. - var level = LevelTrace - - // LogLevel returns the global log level and can be used in - // own implementations of the logger interface. - func Level() int { - return level - } - - // SetLogLevel sets the global log level used by the simple - // logger. - func SetLevel(l int) { - level = l - } - -上面这一段实现了日志系统的日志分级，默认的级别是Trace，用户通过SetLevel可以设置不同的分级。 - - // logger references the used application logger. - var BeeLogger = log.New(os.Stdout, "", log.Ldate|log.Ltime) - - // SetLogger sets a new logger. - func SetLogger(l *log.Logger) { - BeeLogger = l - } - - // Trace logs a message at trace level. - func Trace(v ...interface{}) { - if level <= LevelTrace { - BeeLogger.Printf("[T] %v\n", v) - } - } - - // Debug logs a message at debug level. - func Debug(v ...interface{}) { - if level <= LevelDebug { - BeeLogger.Printf("[D] %v\n", v) - } - } - - // Info logs a message at info level. - func Info(v ...interface{}) { - if level <= LevelInfo { - BeeLogger.Printf("[I] %v\n", v) - } - } - - // Warning logs a message at warning level. - func Warn(v ...interface{}) { - if level <= LevelWarning { - BeeLogger.Printf("[W] %v\n", v) - } - } - - // Error logs a message at error level. - func Error(v ...interface{}) { - if level <= LevelError { - BeeLogger.Printf("[E] %v\n", v) - } - } - - // Critical logs a message at critical level. - func Critical(v ...interface{}) { - if level <= LevelCritical { - BeeLogger.Printf("[C] %v\n", v) - } - } - -上面这一段代码默认初始化了一个BeeLogger对象，默认输出到os.Stdout，用户可以通过beego.SetLogger来设置实现了logger的接口输出。这里面实现了六个函数： - -- Trace（一般的记录信息，举例如下：） - - "Entered parse function validation block" - - "Validation: entered second 'if'" - - "Dictionary 'Dict' is empty. Using default value" -- Debug（调试信息，举例如下：） - - "Web page requested: http://somesite.com Params='...'" - - "Response generated. Response size: 10000. Sending." - - "New file received. Type:PNG Size:20000" -- Info（打印信息，举例如下：） - - "Web server restarted" - - "Hourly statistics: Requested pages: 12345 Errors: 123 ..." - - "Service paused. Waiting for 'resume' call" -- Warn（警告信息，举例如下：） - - "Cache corrupted for file='test.file'. Reading from back-end" - - "Database 192.168.0.7/DB not responding. Using backup 192.168.0.8/DB" - - "No response from statistics server. Statistics not sent" -- Error（错误信息，举例如下：） - - "Internal error. Cannot process request #12345 Error:...." - - "Cannot perform login: credentials DB not responding" -- Critical（致命错误，举例如下：） - - "Critical panic received: .... Shutting down" - - "Fatal error: ... App is shutting down to prevent data corruption or loss" - -可以看到每个函数里面都有对level的判断，所以如果我们在部署的时候设置了level=LevelWarning，那么Trace、Debug、Info这三个函数都不会有任何的输出，以此类推。 - -## beego的配置设计 -配置信息的解析，beego实现了一个key=value的配置文件读取，类似ini配置文件的格式，就是一个文件解析的过程，然后把解析的数据保存到map中，最后在调用的时候通过几个string、int之类的函数调用返回相应的值，具体的实现请看下面： - -首先定义了一些ini配置文件的一些全局性常量 ： - - var ( - bComment = []byte{'#'} - bEmpty = []byte{} - bEqual = []byte{'='} - bDQuote = []byte{'"'} - ) - -定义了配置文件的格式： - - // A Config represents the configuration. - type Config struct { - filename string - comment map[int][]string // id: []{comment, key...}; id 1 is for main comment. - data map[string]string // key: value - offset map[string]int64 // key: offset; for editing. - sync.RWMutex - } - -定义了解析文件的函数，解析文件的过程是打开文件，然后一行一行的读取，解析注释、空行和key=value数据： - - // ParseFile creates a new Config and parses the file configuration from the - // named file. - func LoadConfig(name string) (*Config, error) { - file, err := os.Open(name) - if err != nil { - return nil, err - } - - cfg := &Config{ - file.Name(), - make(map[int][]string), - make(map[string]string), - make(map[string]int64), - sync.RWMutex{}, - } - cfg.Lock() - defer cfg.Unlock() - defer file.Close() - - var comment bytes.Buffer - buf := bufio.NewReader(file) - - for nComment, off := 0, int64(1); ; { - line, _, err := buf.ReadLine() - if err == io.EOF { - break - } - if bytes.Equal(line, bEmpty) { - continue - } - - off += int64(len(line)) - - if bytes.HasPrefix(line, bComment) { - line = bytes.TrimLeft(line, "#") - line = bytes.TrimLeftFunc(line, unicode.IsSpace) - comment.Write(line) - comment.WriteByte('\n') - continue - } - if comment.Len() != 0 { - cfg.comment[nComment] = []string{comment.String()} - comment.Reset() - nComment++ - } - - val := bytes.SplitN(line, bEqual, 2) - if bytes.HasPrefix(val[1], bDQuote) { - val[1] = bytes.Trim(val[1], `"`) - } - - key := strings.TrimSpace(string(val[0])) - cfg.comment[nComment-1] = append(cfg.comment[nComment-1], key) - cfg.data[key] = strings.TrimSpace(string(val[1])) - cfg.offset[key] = off - } - return cfg, nil - } - -下面实现了一些读取配置文件的函数，返回的值确定为bool、int、float64或string： - - // Bool returns the boolean value for a given key. - func (c *Config) Bool(key string) (bool, error) { - return strconv.ParseBool(c.data[key]) - } - - // Int returns the integer value for a given key. - func (c *Config) Int(key string) (int, error) { - return strconv.Atoi(c.data[key]) - } - - // Float returns the float value for a given key. - func (c *Config) Float(key string) (float64, error) { - return strconv.ParseFloat(c.data[key], 64) - } - - // String returns the string value for a given key. - func (c *Config) String(key string) string { - return c.data[key] - } - -## 应用指南 -下面这个函数是我一个应用中的例子，用来获取远程url地址的json数据，实现如下： - - func GetJson() { - resp, err := http.Get(beego.AppConfig.String("url")) - if err != nil { - beego.Critical("http get info error") - return - } - defer resp.Body.Close() - body, err := ioutil.ReadAll(resp.Body) - err = json.Unmarshal(body, &AllInfo) - if err != nil { - beego.Critical("error:", err) - } - } - -函数中调用了框架的日志函数`beego.Critical`函数用来报错，调用了`beego.AppConfig.String("url")`用来获取配置文件中的信息，配置文件的信息如下(app.conf)： - - appname = hs - url ="http://www.api.com/api.html" +# 13.5 实现博客的增删改 + +前面介绍了beego框架实现的整体构思以及部分实现的伪代码，这小节介绍通过beego建立一个博客系统，包括博客浏览、添加、修改、删除等操作。 +## 博客目录 +博客目录如下所示： + + /main.go + /views: + /view.tpl + /new.tpl + /layout.tpl + /index.tpl + /edit.tpl + /models/model.go + /controllers: + /index.go + /view.go + /new.go + /delete.go + /edit.go + + +## 博客路由 +博客主要的路由规则如下所示： + + //显示博客首页 + beego.RegisterController("/", &controllers.IndexController{}) + //查看博客详细信息 + beego.RegisterController("/view/:id([0-9]+)", &controllers.ViewController{}) + //新建博客博文 + beego.RegisterController("/new", &controllers.NewController{}) + //删除博文 + beego.RegisterController("/delete/:id([0-9]+)", &controllers.DeleteController{}) + //编辑博文 + beego.RegisterController("/edit/:id([0-9]+)", &controllers.EditController{}) + + +## 数据库结构 +数据库设计最简单的博客信息 + + CREATE TABLE entries ( + id INT AUTO_INCREMENT, + title TEXT, + content TEXT, + created DATETIME, + primary key (id) + ); + +## 控制器 +IndexController: + + type IndexController struct { + beego.Controller + } + func (this *IndexController) Get() { + this.Data["blogs"] = models.GetAll() + this.Layout = "layout.tpl" + this.TplNames = "index.tpl" + } + +ViewController: + + type ViewController struct { + beego.Controller + } + + func (this *ViewController) Get() { + inputs := this.Input() + id, _ := strconv.Atoi(this.Ctx.Params[":id"]) + this.Data["Post"] = models.GetBlog(id) + this.Layout = "layout.tpl" + this.TplNames = "view.tpl" + } + +NewController + + type NewController struct { + beego.Controller + } + + func (this *NewController) Get() { + this.Layout = "layout.tpl" + this.TplNames = "new.tpl" + } + + func (this *NewController) Post() { + inputs := this.Input() + var blog models.Blog + blog.Title = inputs.Get("title") + blog.Content = inputs.Get("content") + blog.Created = time.Now() + models.SaveBlog(blog) + this.Ctx.Redirect(302, "/") + } + +EditController + + type EditController struct { + beego.Controller + } + + func (this *EditController) Get() { + inputs := this.Input() + id, _ := strconv.Atoi(this.Ctx.Params[":id"]) + this.Data["Post"] = models.GetBlog(id) + this.Layout = "layout.tpl" + this.TplNames = "new.tpl" + } + + func (this *EditController) Post() { + inputs := this.Input() + var blog models.Blog + blog.Id, _ = strconv.Atoi(inputs.Get("id")) + blog.Title = inputs.Get("title") + blog.Content = inputs.Get("content") + blog.Created = time.Now() + models.SaveBlog(blog) + this.Ctx.Redirect(302, "/") + } + +DeleteController + + type DeleteController struct { + beego.Controller + } + + func (this *DeleteController) Get() { + inputs := this.Input() + id, _ := strconv.Atoi(this.Ctx.Params[":id"]) + this.Data["Post"] = models.DelBlog(id) + this.Ctx.Redirect(302, "/") + } + +## model层 + + package models + + import ( + "database/sql" + "github.com/astaxie/beedb" + _ "github.com/ziutek/mymysql/godrv" + "time" + ) + + type Blog struct { + Id int `PK` + Title string + Content string + Created time.Time + } + + func GetLink() beedb.Model { + db, err := sql.Open("mymysql", "blog/astaxie/123456") + if err != nil { + panic(err) + } + orm := beedb.New(db) + return orm + } + + func GetAll() (blogs []Blog) { + db := GetLink() + db.FindAll(&blogs) + return + } + + func GetBlog(id int) (blog Blog) { + db := GetLink() + db.Where("id=?", id).Find(&blogs) + return + } + + func SaveBlog(blog Blog) (bg Blog) { + db := GetLink() + db.Save(&blog) + return bg + } + + func DelBlog(blog Blog) { + db := GetLink() + db.Delete(&blog) + return + } + + +## view层 + +layout.tpl + + + + My Blog + + + + + + + {{.LayoutContent}} + + + + +index.tpl + +

Blog posts

+ + + +view.tpl + +

{{.Post.Title}}

+ {{.Post.Created}}
+ + {{.Post.Content}} + +new.tpl + +

New Blog Post

+
+ 标题:
+ 内容： + +
+ +edit.tpl + +

Edit {{.Post.Title}}

+ +

New Blog Post

+
+ 标题:
+ 内容： + + +
## links * [目录]() - * 上一章: [controller设计](<13.4.md>) - * 下一节: [实现博客的增删改](<13.6.md>) \ No newline at end of file + * 上一章: [数据库操作](<13.4.md>) + * 下一节: [小结](<13.6.md>) \ No newline at end of file diff --git a/13.6.md b/13.6.md index 650885b7..b9041ce3 100644 --- a/13.6.md +++ b/13.6.md @@ -1,6 +1,7 @@ -# 13.6 实现博客的增删改 +# 13.6 小结 +这一章我们主要介绍了如何实现一个基础的Go语言框架，框架包含有路由设计，由于Go内置的http包中路由的一些不足点，我们设计了动态路由规则，然后介绍了MVC模式中的Controller设计，controller实现了REST的实现，这个主要思路来源于tornado框架，然后设计实现了模板的layout以及自动化渲染等技术，主要采用了Go内置的模板引擎，最后我们介绍了一些辅助的日志、配置等信息的设计，通过这些设计我们实现了一个基础的框架beego，目前该框架已经开源在github，最后我们通过beego实现了一个博客系统，通过实例代码详细的展现了如何快速的开发一个站点。 ## links * [目录]() - * 上一章: [数据库操作](<13.5.md>) - * 下一节: [小结](<13.7.md>) \ No newline at end of file + * 上一章: [实现博客的增删改](<13.5.md>) + * 下一节: [扩展博客管理系统](<14.md>) \ No newline at end of file diff --git a/13.7.md b/13.7.md deleted file mode 100644 index e5bdc66d..00000000 --- a/13.7.md +++ /dev/null @@ -1,6 +0,0 @@ -# 13.7 小结 - -## links - * [目录]() - * 上一章: [实现博客的增删改](<13.6.md>) - * 下一节: [扩展博客管理系统](<14.md>) \ No newline at end of file diff --git a/13.md b/13.md index 1184efa3..a0befe2d 100644 --- a/13.md +++ b/13.md @@ -1,16 +1,15 @@ -# 13 构建博客系统 -前面十二章介绍了如何通过Go来开发Web应用，介绍了很多基础知识、开发工具和开发技巧，那么我们这一章通过这些知识来实现一个简易的博客系统。通过Go语言来实现一个完整的项目，这项目中主要内容有第一小节介绍的项目的结构规划，例如采用MVC模式来进行开发，程序的执行流程设计等内容；第二小节介绍博客系统的一些数据库结构设计，如何存储博客评论之类的信息；第三小节介绍项目的第一个功能：路由，如何让访问的URL映射到相应的处理逻辑；第四小节介绍处理逻辑，如何设计一个公共的controller，对象继承之后处理函数中如何处理response和request；第五小节介绍如何处理业务逻辑的数据库，这里会采用beedb库进行数据库的操作；第六小节介绍整体的博客的发表、修改、删除、显示列表等操作。 +# 13 如何设计一个Web框架 +前面十二章介绍了如何通过Go来开发Web应用，介绍了很多基础知识、开发工具和开发技巧，那么我们这一章通过这些知识来实现一个简易的Web框架。通过Go语言来实现一个完整的框架设计，这框架中主要内容有第一小节介绍的Web框架的结构规划，例如采用MVC模式来进行开发，程序的执行流程设计等内容；第二小节介绍框架的第一个功能：路由，如何让访问的URL映射到相应的处理逻辑；第三小节介绍处理逻辑，如何设计一个公共的controller，对象继承之后处理函数中如何处理response和request；第四小节介绍如何框架的一些辅助功能，例如日志处理、配置信息等；第五小节介绍如何基于Web框架实现一个博客，包括博文的发表、修改、删除、显示列表等操作。 通过这么一个完整的项目例子，我期望能够让读者了解如何开发Web应用，如何搭建自己的目录结构，如何实现路由，如何实现MVC模式等各方面的开发内容。在框架盛行的今天，MVC也不再是神话。经常听到很多程序员讨论哪个框架好，哪个框架不好， 其实框架只是工具，没有好与不好，只有适合与不适合，适合自己的就是最好的，所以教会大家自己动手写框架，那么不同的需求都可以用自己的思路去实现。 ## 目录 * 1 [项目规划](13.1.md)　 - * 2 [数据库设计](13.2.md) - * 3 [自定义路由器设计](13.3.md) - * 4 [controller设计](13.4.md) - * 5 [日志和配置设计](13.5.md) - * 6 [实现博客的增删改](13.6.md) - * 7 [小结](13.7.md)　 + * 2 [自定义路由器设计](13.2.md) + * 3 [controller设计](13.3.md) + * 4 [日志和配置设计](13.4.md) + * 5 [实现博客的增删改](13.5.md) + * 6 [小结](13.6.md)　 ## links * [目录]() diff --git a/preface.md b/preface.md index 022aaad0..7a7d0c2c 100644 --- a/preface.md +++ b/preface.md @@ -78,12 +78,11 @@ - 12.5 [小结](12.5.md) * 13.[构建博客系统](13.md)　 - 13.1 [项目规划](13.1.md)　 - - 13.2 [数据库设计](13.2.md) - - 13.3 [自定义路由器设计](13.3.md) - - 13.4 [controller设计](13.4.md) - - 13.5 [日志和配置设计](13.5.md) - - 13.6 [实现博客的增删改](13.6.md) - - 13.7 [小结](13.7.md)　 + - 13.2 [自定义路由器设计](13.2.md) + - 13.3 [controller设计](13.3.md) + - 13.4 [日志和配置设计](13.4.md) + - 13.5 [实现博客的增删改](13.5.md) + - 13.6 [小结](13.6.md)　 * 14.扩展博客管理系统 - 14.1 博客系统集成bootstrap - 14.2 博客集成留言功能 From 7ece0329e8b04c23eea45c5b64c5a20c1e752f64 Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Tue, 25 Dec 2012 00:04:27 +0800 Subject: [PATCH 48/49] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E5=8D=81=E4=B8=89?= =?UTF-8?q?=E7=AB=A0=E6=A0=87=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- preface.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/preface.md b/preface.md index 7a7d0c2c..ff26afb5 100644 --- a/preface.md +++ b/preface.md @@ -76,7 +76,7 @@ - 12.3 [应用部署](12.3.md) - 12.4 [备份和恢复](12.4.md) - 12.5 [小结](12.5.md) -* 13.[构建博客系统](13.md)　 +* 13.[如何设计一个Web框架](13.md)　 - 13.1 [项目规划](13.1.md)　 - 13.2 [自定义路由器设计](13.2.md) - 13.3 [controller设计](13.3.md) From 1341e6430422279ca4ecd2485ef2e13f002a480f Mon Sep 17 00:00:00 2001 From: xiemengjun Date: Tue, 25 Dec 2012 00:12:42 +0800 Subject: [PATCH 49/49] =?UTF-8?q?=E7=AC=AC=E5=8D=81=E5=9B=9B=E7=AB=A0?= =?UTF-8?q?=E8=A7=84=E5=88=92?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 14.1.md | 0 14.2.md | 0 14.3.md | 0 14.4.md | 0 14.5.md | 0 14.6.md | 0 14.md | 14 ++++++++++++++ preface.md | 13 +++++++------ 8 files changed, 21 insertions(+), 6 deletions(-) create mode 100644 14.1.md create mode 100644 14.2.md create mode 100644 14.3.md create mode 100644 14.4.md create mode 100644 14.5.md create mode 100644 14.6.md create mode 100644 14.md diff --git a/14.1.md b/14.1.md new file mode 100644 index 00000000..e69de29b diff --git a/14.2.md b/14.2.md new file mode 100644 index 00000000..e69de29b diff --git a/14.3.md b/14.3.md new file mode 100644 index 00000000..e69de29b diff --git a/14.4.md b/14.4.md new file mode 100644 index 00000000..e69de29b diff --git a/14.5.md b/14.5.md new file mode 100644 index 00000000..e69de29b diff --git a/14.6.md b/14.6.md new file mode 100644 index 00000000..e69de29b diff --git a/14.md b/14.md new file mode 100644 index 00000000..8bd98946 --- /dev/null +++ b/14.md @@ -0,0 +1,14 @@ +# 14 扩展Web框架 + +## 目录 + * 1 [静态文件支持](14.1.md) + * 2 [Session支持](14.2.md) + * 3 [表单支持](14.3.md) + * 4 [用户认证](14.4.md) + * 5 [多语言支持](14.5.md) + * 6 [小结](14.6.md) + +## links + * [目录]() + * 上一章: [第十三章总结](<13.6.md>) + * 下一节: [静态文件支持](<14.1.md>) \ No newline at end of file diff --git a/preface.md b/preface.md index ff26afb5..4c15541d 100644 --- a/preface.md +++ b/preface.md @@ -83,9 +83,10 @@ - 13.4 [日志和配置设计](13.4.md) - 13.5 [实现博客的增删改](13.5.md) - 13.6 [小结](13.6.md)　 -* 14.扩展博客管理系统 - - 14.1 博客系统集成bootstrap - - 14.2 博客集成留言功能 - - 14.3 博客增加后台管理 - - 14.4 博客实现多模板设计 - - 14.5 小结 \ No newline at end of file +* 14.[扩展Web框架](14.md) + - 14.1 [静态文件支持](14.1.md) + - 14.2 [Session支持](14.2.md) + - 14.3 [表单支持](14.3.md) + - 14.4 [用户认证](14.4.md) + - 14.5 [多语言支持](14.5.md) + - 14.6 [小结](14.6.md) \ No newline at end of file