Bmob 开发Android程序快速入门--小demo
注册Bmob帐号
在网址栏输入www.bmob.cn或者在百度输入Bmob进行搜索，打开Bmob官网后，点击右上角的“注册”，在跳转页面填入你的姓名、邮箱、设置密码，确认后到你的邮箱激活Bmob账户，你就可以用Bmob轻松开发应用了。
网站后台创建应用
登录账号进入bmob后台后，点击后台界面左上角“创建应用”，在弹出框输入你应用的名称，然后确认，你就拥有了一个等待开发的应用。
获取应用密钥和下载SDK
选择你要开发的应用，点击该应用下方对应的“应用密钥”
在跳转页面，获取Application ID，此ID将会在初始化SDK中使用到。
获取Application ID后，下载SDK，开发者可以根据自己的需求选择相应的iOS SDK 或Android SDK，点击下载即可。
安装BmobSDK
一、在你的项目根目录下创建"libs"目录，将下载的BmobSDK文件放入该目录下。
二、在你的应用程序中添加相应的权限：
<uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <uses-permission android:name="android.permission.READ_PHONE_STATE"/> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> <uses-permission android:name="android.permission.READ_LOGS"/><?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="cn.bmob.example" android:versionCode="1" android:versionName="1.0"> <uses-sdk android:minSdkVersion="8" android:targetSdkVersion="17"/> <uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> <uses-permission android:name="android.permission.READ_PHONE_STATE"/> <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> <uses-permission android:name="android.permission.READ_LOGS"/> <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme"> <activity android:name="cn.bmob.example.MainActivity" android:screenOrientation="portrait" android:label="@string/app_name"> <action android:name="android.intent.action.MAIN"/> <category android:name="android.intent.category.LAUNCHER"/> <activity android:name=".CreateActivity" android:screenOrientation="portrait"> <activity android:name=".DeleteActivity" android:screenOrientation="portrait"> <activity android:name=".UpdateActivity" android:screenOrientation="portrait"> <activity android:name=".FindActivity" android:screenOrientation="portrait"> </application> </manifest>初始化BmobSDK
在你应用程序启动的Activity的onCreate()方法中初始化Bmob功能。代码如下所示：
package com.bmob.example; import cn.bmob.Bmob; import android.app.Activity; import android.os.Bundle; public class MainActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { // TODO Auto-generated method stub super.onCreate(savedInstanceState); // 初始化 Bmob SDK // 使用时请将第二个参数Application ID替换成你在Bmob服务器端创建的Application ID Bmob.initialize(this, "Your Application ID"); } }
简介
Bmob平台为您的移动应用提供了一个完整的后端解决方案，我们提供轻量级的SDK开发包，让开发者以最小的配置和最简单的方式使用Bmob平台提供的服务，进而完全消除开发者编写服务器代码以及维护服务器的操作。
开源案例
Bmob致力于为开发者提供快速开发服务，为方便大家更好的理解Bmob SDK能够做的事情，我们特意为大家提供了一些源码，大家可以下载之后，嵌入Bmob的AppKey，再打包运行。
阅读源码是一种良好的习惯！！
即时聊天案例源码：https://github.com/bmob/BmobIMSDK4Android
图文社区案例源码：https://github.com/bmob/Wonderful2 这个案例是猿圈媛圈开发团队提供的。
校园小菜案例源码：https://github.com/bmob/Shop 这个案例是湖工大的朋友提供的。
社交分享案例源码：https://github.com/bmob/bmob-android-social-share 这个是金刚锁开发者提供的
第三方登录案例源码：https://github.com/bmob/bmob-android-demo-thirdpartylogin 包含第三方登录和登录后获取用户信息的源码
应用程序
在Bmob平台注册后，每个账户可创建多个应用程序，创建的每个应用程序都有其独自的应用程序ID，此后所有的应用程序将凭其ID进行Bmob SDK的使用。即使只有一个应用程序，也可以以不同的版本进行测试和生产。
应用安全
请大家在使用Bmob开发应用程序之前，认真阅读我们给大家提供的“数据与安全”的文档，确保你的应用在发布时安全。文档的链接地址是：http://docs.bmob.cn/datasafety/index.html?menukey=otherdoc&key=datasafety
数据类型
目前为止，我们支持的数据类型有String、Integer、Boolean、ArrayList以及BmobObject对象类型。同时Bmob也支持BmobDate、BmobGeoPoint、 BmobFile数据类型。
对象
一个对象对应了数据表中的一条数据，也可以理解为应用程序中的JavaBean.
数据对象
Bmob存储的数据是建立在BmobObject基础上的，所以任何要保存的数据对象必须继承自BmobObject类。BmobObject对象包含objectId、createdAt、updatedAt、ACL四个默认的属性，objectId为对象的唯一标示，可以理解为数据表中的主键，createdAt为对象的创建时间，updatedAt为对象的最后修改时间，ACL为这条数据的操作权限控制。例如，游戏中可能会用到的分数对象GameScore,它可能包含score、playerName、cheatMode等属性，那么这个数据对象创建的示例代码如下：
public class GameScore extends BmobObject{ private String playerName; private Integer score; private Boolean cheatMode; private BmobFile pic; public String getPlayerName() { return playerName; } public void setPlayerName(String playerName) { this.playerName = playerName; } public Integer getScore() { return score; } public void setScore(Integer score) { this.score = score; } public Boolean getCheatMode() { return cheatMode; } public void setCheatMode(Boolean cheatMode) { this.cheatMode = cheatMode; } public BmobFile getPic() { return pic; } public void setPic(BmobFile pic) { this.pic = pic; } }类名和表名的关系
- 默认情况下，Bmob提供了类名和表名完全一致的简单方式，实现类名和表名的映射。如，上面的GameScore类对应Web后台的表名是GameScore（区分大小写），如果创建一个数据对象名称为T_a_b，那么这个类名对应的Web后台的表名也是T_a_b。
- 但很多时候，你希望在后台创建的表名和类名并不相同，如表名为T_a_b，而类名还是GameScore，那么你可以使用BmobObject提供的setTableName("表名")的方法，示例代码如下：
//这时候实际操作的表是T_a_b public class GameScore extends BmobObject{ private String playerName; private Integer score; private Boolean cheatMode; private BmobFile pic; public GameScore() { this.setTableName("T_a_b"); } public String getPlayerName() { return playerName; } //其他方法，见上面的代码 }当然了，你也可以在GameScore实例中动态调用setTableName方法，实现操作可变表（如根据日期建立表来存储信息）的可能。
查询自定义表名的数据
如果您使用了setTableName方法来自定义表名，那么在对该表进行数据查询的时候必须使用以下方法来进行查询。需要注意的是查询的结果是一个JSONArray,您需要自行解析JSONArray中的数据来进行使用。
/** * 查询数据 */ public void queryData(){ BmobQuery query = new BmobQuery("T_a_b"); query.findObjects(this, new FindCallback() { @Override public void onSuccess(JSONArray arg0) { // TODO Auto-generated method stub showToast("查询成功:"+arg0.length()); } @Override public void onFailure(int arg0, String arg1) { // TODO Auto-generated method stub showToast("查询失败:"+arg1); } }); }自定义表名情况下的更新、删除数据和普通的更新、删除数据方式一样，没有变化。尽管如此，我们还是提供了一个关于自定义表名情况下增删改查数据的Demo供开发者朋友参照源码来学习，下载地址是：https://github.com/bmob/bmob-android-demo-dynamic-tablename。
特殊对象
为了提供更好的服务，BmobSDK中提供了BmobUser、BmobInstallation两个特殊的BmobObject对象来完成不同的功能，在这里我们统一称为特殊对象。 BmobUser对象主要是针对应用中的用户功能而提供的，它对应着web端的User表，使用BmobUser对象可以很方便的在应用中实现用户的注册、登录、邮箱验证等功能，具体的使用方法可查看文档的用户部分。 BmobInstallation对象主要用于应用的安装设备管理中，它对应着web端的Installation表，任何安装了你应用的设备都会在此表中产生一条数据标示该设备。结合Bmob提供的推送功能，还可以实现将自定义的消息推送给不同的设备终端，具体的使用方法可查看文档的消息推送部分。
添加数据
添加数据非常简单，任何BmobObject对象都具有save方法可以用于将当前对象的内容保存到服务端。 例如，你现在要保存一条游戏分数的记录，可以这样做：
GameScore gameScore = new GameScore(); gameScore.setPlayerName("Barbie"); gameScore.setScore(89); gameScore.setCheatMode(false); gameScore.save(mContext, new SaveListener() { @Override public void onSuccess() { // TODO Auto-generated method stub toast("添加数据成功，返回objectId为："+gameScore.getObjectId()); } @Override public void onFailure(int code, String arg0) { // TODO Auto-generated method stub // 添加失败 } });运行完以上代码后，数据即可保存到服务器端。为了确认数据是否真的已经保存成功，你可以在Bmob服务器端你应用程序的数据浏览项目中进行查看。你应该看到类似这样的结果：
objectId: "0c6db13c", score: 89, playerName: "Barbie", cheatMode: false,createdAt:"2013-09-27 10:32:54", updatedAt:"2013-09-27 10:32:54"注：
-
在运行以上代码时，如果服务器端你创建的应用程序中已经存在GameScore数据表和相应的score、playerName、cheatMode字段，那么你此时添加的数据和数据类型也应该和服务器端的表结构一致，否则将保存数据失败。
-
如果服务器端不存在GameScore数据表，那么Bmob将根据你第一次(也就是运行的以上代码)保存的GameSocre对象在服务器为你创建此数据表并插入相应数据。
-
每个BmobObject对象都有几个默认的键(数据列)是不需要开发者指定的，
objectId是每个保存成功数据的唯一标识符。createdAt和updatedAt代表每个对象(每条数据)在服务器上创建和最后修改的时间。这些键(数据列)的创建和数据内容是由服务器端自主来完成的。因此，使用save和insert方法时,不需要调用setObjectId方法，否则会出现提示：“It is a reserved field: objectId(105)”--表明objectId为系统保留字段，不允许修改。。
查询数据
数据的查询可能是每个应用都会频繁使用到的，BmobSDK中提供了BmobQuery类，它提供了多样的方法来实现不同条件的查询，同时它的使用也是非常的简单和方便的。
查询所有数据
查询某个数据表中的所有数据是非常简单的查询操作，例如：查询所有人员的信息。
BmobQuery<GameScore> query = new BmobQuery<GameScore>(); query.findObjects(this, new FindListener<GameScore>() { @Override public void onSuccess(List<GameScore> object) { // TODO Auto-generated method stub toast("查询成功：共"+object.size()+"条数据。"); } @Override public void onError(int code, String msg) { // TODO Auto-generated method stub toast("查询失败："+msg); } });怎么样，是不是很简单，而且查询的结果不需要进行任何处理，BmobSDK已经为你封装成相应的JavaBean集合了，你直接使用即可。
这里需要注意一点的是： 默认情况下，系统实际上并不会返回所有的数据，而是默认返回10条数据记录，你可以通过setLimit方法设置返回的记录数量。更多细节可点击查看分页查询一节。
查询单条数据
当我们知道某条数据的objectId时，就可以根据objectId直接获取单条数据对象。例如：查询objectId为a203eba875的人员信息。
BmobQuery<GameScore> query = new BmobQuery<GameScore>(); query.getObject(this, "a203eba875", new GetListener<GameScore>() { @Override public void onSuccess(GameScore object) { // TODO Auto-generated method stub toast("查询成功："); } @Override public void onFailure(int code, String arg0) { // TODO Auto-generated method stub toast("查询失败："+arg0); } });条件查询
在查询的使用过程中，基于不同条件的查询是非常常见的，BmobQuery同样也支持不同条件的查询。
例如：如果要过滤掉特定键的值可以使用addWhereNotEqualTo方法。比如需要查询playerName不等于“Barbie”的数据时可以这样写：
query.addWhereNotEqualTo("playerName", "Barbie");当然，你可以在你的查询操作中添加多个约束条件，来查询符合要求的数据。
query.addWhereNotEqualTo("playerName", "Barbie"); //名字不等于Barbie query.addWhereGreaterThan("score", 60); //条件：分数大于60岁各种不同条件的比较查询：
// 分数 < 50 query.addWhereLessThan("score", 50); //分数 <= 50 query.addWhereLessThanOrEqualTo("score", 50); //分数 > 50 query.addWhereGreaterThan("score", 50); //分数 >= 50 query.addWhereGreaterThanOrEqualTo("score", 50);如果你想查询匹配几个不同值的数据，如：要查询“Barbie”,“Joe”,“Julia”三个人的成绩时，你可以使用addWhereContainedIn方法来实现。
String[] names = {"Barbie", "Joe", "Julia"}; query.addWhereContainedIn("playerName", Arrays.asList(names));相反，如果你想查询排除“Barbie”,“Joe”,“Julia”这三个人的其他同学的信息，你可以使用addWhereNotContainedIn方法来实现。
String[] names = {"Barbie", "Joe", "Julia"}; query.addWhereNotContainedIn("playerName", Arrays.asList(names));注：时间查询比较特殊，我们需要结合BmobDate这个类来查询某个指定日期时间前后的数据，这里也给出示例供大家参考：
比如，你想查询2015年2月11号之前的Person数据，那么可以使用addWhereLessThan或者addWhereLessThanOrEqualTo（包含当天）来查询。如果想查询之后的数据，则可以使用addWhereGreaterThan或addWhereGreaterThanOrEqualTo（包含当天）来查询。
BmobQuery<Person> query = new BmobQuery<Person>("Person"); String dateString = "2015-02-11"; SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); Date date = null; try { date = sdf.parse(dateString); } catch (ParseException e) { e.printStackTrace(); } //这是查询2015年2月11之前的Person数据 query.addWhereLessThan("createdAt",new BmobDate(date)); //这是查询2015年2月11之后的Person数据 //query.addWhereGreaterThan("createdAt",new BmobDate(date)); ```java ### 模糊查询 如果你想实现类似数据库的模糊查询，比如，你想查询用户表中用户名中含有“a”的用户，那么你可以使用`addWhereContains`方法来实现。 ```java String value = "a"; query.addWhereContains("username", value);分页查询
有时，在数据比较多的情况下，你希望查询出的符合要求的所有数据能按照多少条为一页来显示，这时可以使用setLimit方法来限制查询结果的数据条数来进行分页。默认情况下，Limit的值为10，最大有效设置值1000（设置的数值超过1000还是视为1000）。
query.setLimit(10); // 限制最多10条数据结果作为一页在数据较多的情况下，在setLimit的基础上分页显示数据是比较合理的解决办法，setSKip方法可以做到跳过查询的前多少条数据来实现分页查询的功能。默认情况下Skip的值为10。
query.setSkip(10); // 忽略前10条数据（即第一页数据结果）大家也可以直接下载我们提供的Demo源码（https://github.com/bmob/bmob-android-demo-paging），查看如何使用分页查询，结合ListView开发下拉刷新查看更多内容的应用。
结果排序
对应数据的排序，如数字或字符串，你可以使用升序或降序的方式来控制查询数据的结果顺序：
// 根据score字段升序显示数据 query.order("score"); // 根据score字段降序显示数据 query.order("-score"); // 多个排序字段可以用（，）号分隔 query.order("-score,createdAt");说明：多个字段排序时，先按第一个字段进行排序，再按第二个字段进行排序，依次进行。
统计对象数量
如果你只是想统计满足查询对象的数量，你并不需要获取所有匹配对象的具体数据信息，可以直接使用count替代findObjects。例如，查询一个特定玩家玩的游戏场数：
BmobQuery<GameSauce> query = new BmobQuery<GameSauce>(); query.addWhereEqualTo("playerName", "Barbie"); query.count(this, GameSauce.class, new CountListener() { @Override public void onSuccess(int count) { // TODO Auto-generated method stub toast("Barbie has played" + count + "games"); } @Override public void onFailure(int code, String msg) { // TODO Auto-generated method stub toast("count failure："+msg); } });复杂查询
复合与查询(and)
有些查询需要使用到复合“与”的查询条件，例如：你想查询出Person表中年龄在6-29岁之间且姓名以"y"或者"e"结尾的人，那么，可以采用and查询，示例代码如下：
//查询年龄6-29岁之间的人，每一个查询条件都需要New一个BmobQuery对象 //--and条件1 BmobQuery<Person> eq1 = new BmobQuery<Person>(); eq1.addWhereLessThanOrEqualTo("age", 29);//年龄<=29 //--and条件2 BmobQuery<Person> eq2 = new BmobQuery<Person>(); eq2.addWhereGreaterThanOrEqualTo("age", 6);//年龄>=6 //查询姓名以"y"或者"e"结尾的人--这个需要使用到复合或查询（or） //--and条件3 BmobQuery<Person> eq3 = new BmobQuery<Person>(); eq3.addWhereEndsWith("name", "y"); BmobQuery<Person> eq4 = new BmobQuery<Person>(); eq4.addWhereEndsWith("name", "e"); List<BmobQuery<Person>> queries = new ArrayList<BmobQuery<Person>>(); queries.add(eq3); queries.add(eq4); BmobQuery<Person> mainQuery = new BmobQuery<Person>(); BmobQuery<Person> or = mainQuery.or(queries); //最后组装完整的and条件 List<BmobQuery<Person>> andQuerys = new ArrayList<BmobQuery<Person>>(); andQuerys.add(eq1); andQuerys.add(eq1); andQuerys.add(or); //查询符合整个and条件的人 BmobQuery<Person> query = new BmobQuery<Person>(); query.and(andQuerys); query.findObjects(this, new FindListener<Person>() { @Override public void onSuccess(List<