mirror of
https://github.com/astaxie/beego.git
synced 2024-12-23 23:00:49 +00:00
107 lines
2.6 KiB
Markdown
107 lines
2.6 KiB
Markdown
|
# API应用开发入门
|
|||
|
|
Go是非常适合用来开发API应用的，而且我认为也是Go相对于其他动态语言的最大优势应用。beego在开发API应用方面提供了非常强大和快速的工具，方便用户快速的建立API应用原型，专心业务逻辑就行了。
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 快速建立原型
|
|||
|
|
bee快速开发工具提供了一个API应用建立的工具，在gopath/src下的任意目录执行如下命令就可以快速的建立一个API应用：
|
|||
|
|
|
|||
|
|
`bee api beeapi`
|
|||
|
|
|
|||
|
|
## 应用的目录结构
|
|||
|
|
应用的目录结构如下所示：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
├── conf
|
|||
|
|
│ └── app.conf
|
|||
|
|
├── controllers
|
|||
|
|
│ └── default.go
|
|||
|
|
├── models
|
|||
|
|
│ └── object.go
|
|||
|
|
└── main.go
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 源码解析
|
|||
|
|
|
|||
|
|
- app.conf里面主要针对API的配置如下：
|
|||
|
|
|
|||
|
|
autorender = false //API应用不需要模板渲染，所以关闭自动渲染
|
|||
|
|
|
|||
|
|
copyrequestbody = true //RESTFul应用发送信息的时候是raw body，而不是普通的form表单，所以需要额外的读取body信息
|
|||
|
|
|
|||
|
|
- main.go文件主要针对RESTFul的路由注册
|
|||
|
|
|
|||
|
|
`beego.RESTRouter("/object", &controllers.ObejctController{})`
|
|||
|
|
|
|||
|
|
这个路由可以匹配如下的规则
|
|||
|
|
|
|||
|
|
<table>
|
|||
|
|
<tr>
|
|||
|
|
<th>URL</th> <th>HTTP Verb</th> <th>Functionality</th>
|
|||
|
|
</tr>
|
|||
|
|
<tr>
|
|||
|
|
<td>/object</td> <td>POST</td> <td>Creating Objects</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr>
|
|||
|
|
<td>/object/objectId</td> <td>GET</td> <td>Retrieving Objects</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr>
|
|||
|
|
<td>/object/objectId</td> <td>PUT</td> <td>Updating Objects</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr>
|
|||
|
|
<td>/object</td> <td>GET</td> <td>Queries</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr>
|
|||
|
|
<td>/object/objectId</td> <td>DELETE</td> <td>Deleting Objects</td>
|
|||
|
|
</tr>
|
|||
|
|
</table>
|
|||
|
|
|
|||
|
|
- ObejctController实现了对应的方法：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
type ObejctController struct {
|
|||
|
|
beego.Controller
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
func (this *ObejctController) Post(){
|
|||
|
|
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
func (this *ObejctController) Get(){
|
|||
|
|
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
func (this *ObejctController) Put(){
|
|||
|
|
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
func (this *ObejctController) Delete(){
|
|||
|
|
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- models里面实现了对应操作对象的增删改取等操作
|
|||
|
|
|
|||
|
|
## 测试
|
|||
|
|
|
|||
|
|
- 添加一个对象：
|
|||
|
|
|
|||
|
|
`curl -X POST -d '{"Score":1337,"PlayerName":"Sean Plott"}' http://127.0.0.1:8080/object`
|
|||
|
|
|
|||
|
|
返回一个相应的objectID:astaxie1373349756660423900
|
|||
|
|
|
|||
|
|
- 查询一个对象
|
|||
|
|
|
|||
|
|
`curl -X GET http://127.0.0.1:8080/object/astaxie1373349756660423900`
|
|||
|
|
|
|||
|
|
- 查询全部的对象
|
|||
|
|
|
|||
|
|
`curl -X GET http://127.0.0.1:8080/object`
|
|||
|
|
|
|||
|
|
- 更新一个对象
|
|||
|
|
|
|||
|
|
`curl -X PUT -d '{"Score":10000}'http://127.0.0.1:8080/object/astaxie1373349756660423900`
|
|||
|
|
|
|||
|
|
- 删除一个对象
|
|||
|
|
|
|||
|
|
`curl -X DELETE http://127.0.0.1:8080/object/astaxie1373349756660423900`
|