diff --git a/8.3.md b/8.3.md index 349af76b..a7b2b17d 100644 --- a/8.3.md +++ b/8.3.md @@ -20,6 +20,75 @@ Web应用程序最重要的REST原则是,客户端和服务器之间的交互 ![](images/8.3.rest.png?raw=true) ##RESTful的实现 +Go语言对于REST没有标准包直接支持,但是因为RESTful是基于HTTP协议实现的,所以我们可以利用Go语言的`net/http`包来实现,当然需要针对REST需要做一些改造,REST是根据不通的method来处理相应的资源,我们先来看一下REST的几个分级,请看下图: + +![](images/8.3.rest3.png?raw=true) + +上图展示了我们目前实现REST的三个level,我们在应用开发的时候也不一定全部按照RESTful的规则全部实现他的方式,因为有些时候完全按照RESTful的方式未必是可行的,RESTful服务充分利用每一个HTTP方法,包括`DELETE`和`PUT`。可有时,HTTP客户端只能发出`GET`和`POST`请求: + +- HTML标准只能通过链接和表单支持`GET`和`POST`。在没有Ajax支持的网页浏览器中不能发出`PUT`或`DELETE`命令 + +- 有些防火墙会挡住HTTP `PUT`和`DELETE`请求要绕过这个限制,客户端需要把实际的`PUT`和`DELETE`请求通过 POST 请求穿透过来。RESTful 服务则要负责在收到的 POST 请求中找到原始的 HTTP 方法并还原。 + +我们现在可以通过`POST`里面增加隐藏字段`_method`这种方式可以来模拟`PUT`、`DELETE`等方式,但是服务器端需要做转换。我现在的项目里面就按照这种方式来做的REST接口。当然Go语言里面完全按照RSETful来实现是很容易的,我们通过下面的例子来说明如何实现RESTful的应用设计。 + + package main + + import ( + "fmt" + "github.com/drone/routes" + "net/http" + ) + + func getuser(w http.ResponseWriter, r *http.Request) { + params := r.URL.Query() + uid := params.Get(":uid") + fmt.Fprintf(w, "you are get user %s", uid) + } + + func modifyuser(w http.ResponseWriter, r *http.Request) { + params := r.URL.Query() + uid := params.Get(":uid") + fmt.Fprintf(w, "you are modify user %s", uid) + } + + func deleteuser(w http.ResponseWriter, r *http.Request) { + params := r.URL.Query() + uid := params.Get(":uid") + fmt.Fprintf(w, "you are delete user %s", uid) + } + + func adduser(w http.ResponseWriter, r *http.Request) { + fmt.Fprint(w, "you are add user %s", uid) + } + + func main() { + mux := routes.New() + mux.Get("/user/:uid", getuser) + mux.Post("/user/:uid", modifyuser) + mux.Del("/user/:uid", deleteuser) + mux.Put("/user/", adduser) + http.Handle("/", mux) + http.ListenAndServe(":8088", nil) + } + + + +上面的代码我们演示如何编写一个REST的应用,我们访问的资源是用户,然后我们通过不同的method来访问不同的函数,这里我们使用了一个第三方库`github.com/drone/routes`,这个库实现了方便的路由规则映射,我们在上面章节也介绍过可以实现自定义的路由器,这个库就实现了自定义的路由,我们可以很方便的实现REST的架构。通过上面的代码我们知道REST就是根据不同的method访问同一个资源的时候实现不同的逻辑处理。一般这些method的定义如下: + +- Get表示获取请求的资源信息 +- Post表示修改相应的资源信息 +- Put表示添加一个新的资源 +- Delete表示删除请求的资源信息 +- Patch表示对资源进行部分更新的一个特殊方法 + +通过上面的代码演示我们知道:资源是通过URI来确定的,然后通过不同的方式执行不同的操作方式,这就是RESTful的实现。 + +##总结 +REST是一种架构风格,汲取了WWW的成功经验:无状态,以资源为中心,充分利用HTTP协议和URI协议,提供统一的接口定义,使得它作为一种设计Web服务的方法而变得流行。在某种意义上,通过强调URI和HTTP等早期Internet标准,REST是对大型应用程序服务器时代之前的Web方式的回归。目前Go对于REST的支持还是很简单的,通过实现自定义的路由规则,我们就可以实现不同的method实现不同的handle,这样就实现了REST的架构。 + + + ## links * [目录]() diff --git a/README.md b/README.md index 718d03fe..a75f2617 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,10 @@ 这样读者就可以把相应的Markdown文件编译成html文件,执行`go build build.go`,执行生成的文件,就会在底目录下生成相应的html文件 ##如何编译 -目前可以把相应的Markdown编译成html文件,执行`go build build.go`,执行生成的文件,就会在底目录下生成相应的html文件。 +目前可以把相应的Markdown编译成html文件,执行`go build build.go`,执行生成的文件,就会在底目录下生成相应的html文件。 + +##交流 +欢迎大家加入QQ群:259316004 《Go Web编程》专用交流群 ##致谢 首先要感谢Golang-China的QQ群102319854,里面的每一个人都很热心,同时要特别感谢几个人 diff --git a/images/8.3.rest3.png b/images/8.3.rest3.png new file mode 100644 index 00000000..00ab03e8 Binary files /dev/null and b/images/8.3.rest3.png differ