简介

Bmob平台为您的移动应用提供了一个完整的后端解决方案，我们提供轻量级的SDK开发包，让开发者以最小的配置和最简单的方式使用Bmob平台提供的服务，进而完全消除开发者编写服务器代码以及维护服务器的操作。
Go SDK封装了Bmob RESTful API，但并不包含功能封装，如果需要调用具体的功能，请参考官方RESTful API开发文档http://docs.bmob.cn/data/Restful/b_developdoc/doc/index.html

快速入门

建议您在阅读本开发文档之前，先阅读我们提供的 go快速入门文档，便于您后续的开发。

应用程序

在Bmob平台注册后，每个账户可创建多个应用程序，创建的每个应用程序有各自的Application ID，应用程序将凭其Application ID使用Bmob SDK。

应用安全

请大家在使用Bmob开发应用程序之前，仔细阅读“数据与安全”的文档：http://docs.bmob.cn/other/Other/m_bql/doc/index.html

数据类型

除了JSON标准里定义的数据类型外，还支持Bmob自定义的数据类型：http://docs.bmob.cn/data/Restful/b_developdoc/doc/index.html#对象
这些类型操作相关的基本数据结构在types.go中定义，由于JSON是schema-less的，你可以只填充必要的字段来完成操作

RESTful请求

一次典型的RESTFul请求如下：

  1.   header, err := bmob.DoRestReq(appConfig,
  2.     bmob.RestRequest{
  3.       bmob.BaseReq{
  4.         "GET",
  5.         bmob.ApiRestURL("GameScore") + "/",
  6.         ""},
  7.       "application/json",
  8.       nil},
  9.     &respDst}
  10.   if err == nil {
  11.     log.Println(header}
  12.     log.Println(respDst}
  13.   } else {
  14.     log.Panic(err}
  15.   }

参数：

  • appConfig - 保存了APP相关的key等信息
  • RestRequest - 使用Bmob RESTful API 所需的信息： {方法， url， sessionToken}， 数据类型， body
  • respDst - 用于保存解析后的response
    返回值：
  • header - http.Header， 请求返回的标准HTTP头
  • err - 错误信息
  1. curl -X GET \
  2.     -H "X-Bmob-Application-Id: Your Application ID" \
  3.     -H "X-Bmob-REST-API-Key: Your REST API Key" \
  4.     -G \
  5.     --data-urlencode 'where={"createdAt":{"$gte":{"__type":"Date","iso":"2011-08-21 18:02:52"}}}' \
  6.     https://api.bmob.cn/1/classes/GameScore

再一次请求中，你需要指定的HTTP方法，URL，sessionToken等均可以在BaseReq中指定，
APP验证需要的KEY等在RestConfig中指定
数据段则在转成[]byte类型后传入
上传不同类型的格式时，需要指定编码格式，默认为text/plain，

数据对象

Bmob请求格式化数据时，body为JSON格式，用户可以自定义需要的字段，但是由于返回的数据会附加Bmob预定义的字段，所以需要单独处理。 SDK中采取的写法如下：

  1. type TestDataType struct {
  2.   Score string
  3.   data  DataType
  4. }
  6. type TestDataRes struct {
  7.   TestData
  8.   bmob.RestResponse
  9. }

通过继承自定义的Response结构体，我们可以同时解析返回的数据里的用户定义数据和系统定义数据。

RestResponse包含了解析最常用的请求响应所需的字段，如果需要其他解析其他请求的响应，可以继承SDK中提供的相应的结构体，如ImageResponse

  1. type MyRes struct {
  2.   bmob.RestResponse
  3.   bmob.ImageResponse
  4. }

这个结构体可以解析标准的RESTful响应和Image请求相关的响应