即时通信之Bmob开发08

cn.bmob.v3 
类 BmobQuery<T>

java.lang.Object
  cn.bmob.v3.BmobQuery<T>

---

public class BmobQuery<T>
   
   
    
    extends java.lang.Object
   
   

查询数据

作者：

BmobTeam

---

嵌套类摘要
static class	BmobQuery.CachePolicy            数据缓存模式的枚举类型

 

构造方法摘要
BmobQuery()
BmobQuery(java.lang.String tableName)

 

方法摘要
BmobQuery<T>	addQueryKeys(java.lang.String keys)            指定查询某列的数据，指定多列时用（,）号分隔
BmobQuery<T>	addWhereContainedIn(java.lang.String key, java.util.Collection<? extends java.lang.Object> values)            查询某字段的值包含在XX范围内的数据
BmobQuery<T>	addWhereContains(java.lang.String key, java.lang.String value)            查询包含XX字符串的值
BmobQuery<T>	addWhereContainsAll(java.lang.String key, java.util.Collection<?> values)            查询数据列为数组Array类型的值中包含有x,x,x的对象
BmobQuery<T>	addWhereDoesNotExists(java.lang.String key)            查询不存在指定字段的数据
<E> BmobQuery<T>	addWhereDoesNotMatchQuery(java.lang.String key, java.lang.String className, BmobQuery<E> innerQuery)            查询的对象中的某个列不符合另一个查询
BmobQuery<T>	addWhereEndsWith(java.lang.String key, java.lang.String suffix)            查询以XX字符串结尾的值
BmobQuery<T>	addWhereEqualTo(java.lang.String key, java.lang.Object value)            添加查询条件：例 （name == ?）
BmobQuery<T>	addWhereExists(java.lang.String key)            查询存在指定字段的数据
BmobQuery<T>	addWhereGreaterThan(java.lang.String key, java.lang.Object value)            添加查询条件：例（score > ?）
BmobQuery<T>	addWhereGreaterThanOrEqualTo(java.lang.String key, java.lang.Object value)            添加查询条件：例（score >= ?）
BmobQuery<T>	addWhereLessThan(java.lang.String key, java.lang.Object value)            添加查询条件：例（score < ?）
BmobQuery<T>	addWhereLessThanOrEqualTo(java.lang.String key, java.lang.Object value)            添加查询条件：例（score <= ?）
BmobQuery<T>	addWhereMatches(java.lang.String key, java.lang.String regex)            regex为正则表达式字符串，key为字段名。
<E> BmobQuery<T>	addWhereMatchesQuery(java.lang.String key, java.lang.String className, BmobQuery<E> innerQuery)            查询的对象中的某个列符合另一个查询
BmobQuery<T>	addWhereNear(java.lang.String key, BmobGeoPoint point)            查询最接近用户地点的数据 注意：该方法最好结合setLimit一起使用
BmobQuery<T>	addWhereNotContainedIn(java.lang.String key, java.util.Collection<? extends java.lang.Object> values)            查询某字段的值不包含在XX范围内的数据
BmobQuery<T>	addWhereNotEqualTo(java.lang.String key, java.lang.Object value)            添加查询条件：例（name !
BmobQuery<T>	addWhereRelatedTo(java.lang.String key, BmobPointer pointer)            例：查询某帖子的所有评论
BmobQuery<T>	addWhereStartsWith(java.lang.String key, java.lang.String prefix)            查询以XX字符串开头的值
BmobQuery<T>	addWhereWithinGeoBox(java.lang.String key, BmobGeoPoint southwest, BmobGeoPoint northeast)            查询一个矩形范围内的信息
BmobQuery<T>	addWhereWithinKilometers(java.lang.String key, BmobGeoPoint point, double maxDistance)            查询多少公里之内的信息
BmobQuery<T>	addWhereWithinMiles(java.lang.String key, BmobGeoPoint point, double maxDistance)            查询多少英里之内的信息
BmobQuery<T>	addWhereWithinRadians(java.lang.String key, BmobGeoPoint point, double maxDistance)            查询一个圆形范围内的信息
BmobQuery<T>	and(java.util.List<BmobQuery<T>> where)            复合查询条件and
static void	clearAllCachedResults(Context context)            清除所有查询结果的缓存数据
void	clearCachedResult(Context context)            清除当前查询的缓存数据
void	count(Context context, java.lang.Class<?> clazz, CountListener listener)            计算对象个数
void	findObjects(Context context, FindCallback callback)            查询多条数据(通常在使用自定义表名的情况下使用此方法)
void	findObjects(Context context, FindListener<T> findListener)            查询多条数据
BmobQuery.CachePolicy	getCachePolicy()            获取当前BmobQuery对象的缓存策略
int	getLimit()            获取设置的查询结果数量
long	getMaxCacheAge()            获取当前BmobQuery对象的最大缓存时间
void	getObject(Context context, java.lang.String objectId, GetCallback callback)            获取单条数据(通常在使用自定义表名的情况下使用此方法)
void	getObject(Context context, java.lang.String objectId, GetListener<T> listener)            获取单条数据
int	getSkip()            获取数据页数
boolean	hasCachedResult(Context context)            检查是否存在当前查询条件的缓存数据
void	include(java.lang.String fieldName)            关联查询，该方法用在字段为Pointer类型时（例："post"）
BmobQuery<T>	or(java.util.List<BmobQuery<T>> where)            复合查询条件or
BmobQuery<T>	order(java.lang.String order)            排序(例:"score"或"-score")
void	postError(GetListener<T> listener, int statuscode, java.lang.String errormsg)
void	postResponse(java.lang.Runnable runnable)            将回调放到主线程中
void	setCachePolicy(BmobQuery.CachePolicy newCachePolicy)            设置缓存策略
void	setLimit(int newLimit)            限制查询的结果数量
void	setMaxCacheAge(long maxAgeInMilliseconds)            设置最大缓存时间
void	setSkip(int newSkip)            跳过第多少条数据，分页时用到，获取下一页数据

cn.bmob.v3.datatype 
类 BmobGeoPoint

java.lang.Object
  cn.bmob.v3.datatype.BmobGeoPoint

所有已实现的接口：

java.io.Serializable

---

public class BmobGeoPoint
   
   
    
    extends java.lang.Object
   
   
   
   
    
    implements java.io.Serializable
   
   

地理位置类型 BmobGeoPoint 是一个用于保存地理位置信息的Bmob数据对象,也可以用于查询地理位置信息的参考点。 注意：一个BmobObject对象中只能有一个键的值可以为BmobGeoPoint类型。

作者：

BmobTeam

另请参见：

序列化表格

---

字段摘要
static double	EARTH_MEAN_RADIUS_KM
static double	EARTH_MEAN_RADIUS_MILE

 

构造方法摘要
BmobGeoPoint()            BmobGeoPoint 默认构造方法
BmobGeoPoint(double longitude, double latitude)            BmobGeoPoint 构造方法

 

方法摘要
double	distanceInKilometersTo(BmobGeoPoint point)            获取point这个坐标点与BmobGeoPoint对象之间的距离（单位：千米，公里）
double	distanceInMilesTo(BmobGeoPoint point)            获取poing这个坐标点与BmobGeoPoing对象之间的距离（单位：英里）
double	distanceInRadiansTo(BmobGeoPoint point)            获取point这个坐标点与BmobGeoPoint对象的弧度距离
double	getLatitude()            获取纬度坐标值
double	getLongitude()            获取经度坐标值
void	setLatitude(double latitude)            设置纬度坐标
void	setLongitude(double longitude)            设置经度坐标

 

从类 java.lang.Object 继承的方法
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

字段详细信息

EARTH_MEAN_RADIUS_KM

public static double EARTH_MEAN_RADIUS_KM

---

EARTH_MEAN_RADIUS_MILE

public static double EARTH_MEAN_RADIUS_MILE

构造方法详细信息

BmobGeoPoint

public BmobGeoPoint()

BmobGeoPoint 默认构造方法

---

BmobGeoPoint

public BmobGeoPoint(double longitude,
                    double latitude)

BmobGeoPoint 构造方法

参数：

longitude - 经度坐标

latitude - 纬度坐标

方法详细信息

setLatitude

public void setLatitude(double latitude)

设置纬度坐标

参数：

latitude - 纬度坐标值（范围：90.0D -- -90.0D）

---

getLatitude

public double getLatitude()

获取纬度坐标值

返回：

返回当前BmobGeoPoint对象的纬度值

---

setLongitude

public void setLongitude(double longitude)

设置经度坐标

参数：

longitude - 经度坐标值（范围：180.0D -- -180.0D）

---

getLongitude

public double getLongitude()

获取经度坐标值

返回：

返回当前BmobGeoPoint对象的经度值

---

distanceInRadiansTo

public double distanceInRadiansTo(BmobGeoPoint point)

获取point这个坐标点与BmobGeoPoint对象的弧度距离

参数：

point - 坐标点

返回：

返回两点之间的弧度距离

---

distanceInKilometersTo

public double distanceInKilometersTo(BmobGeoPoint point)

获取point这个坐标点与BmobGeoPoint对象之间的距离（单位：千米，公里）

参数：

point - 坐标点

返回：

返回两点之间的距离（单位：千米，公里）

---

distanceInMilesTo

public double distanceInMilesTo(BmobGeoPoint point)

获取poing这个坐标点与BmobGeoPoing对象之间的距离（单位：英里）

参数：

point - 坐标点

返回：

返回两点之间的距离（单位：万里）

cn.bmob.v3.listener 
接口 FindCallback

---

public interface FindCallback

---

方法摘要
void	onFailure(int code, java.lang.String msg)            查询失败
void	onSuccess(JSONArray objects)            查询成功

 

cn.bmob.v3 
枚举 BmobQuery.CachePolicy

java.lang.Object
  java.lang.Enum<BmobQuery.CachePolicy>
      cn.bmob.v3.BmobQuery.CachePolicy

所有已实现的接口：

java.io.Serializable, java.lang.Comparable< BmobQuery.CachePolicy>

包容类：

BmobQuery< T>

---

public static enum BmobQuery.CachePolicy
   
   
    
    extends java.lang.Enum<
    
    BmobQuery.CachePolicy>
   
   

数据缓存模式的枚举类型

---

枚举常量摘要
CACHE_ELSE_NETWORK            先从缓存取数据，如果没有的话，再从网络取。
CACHE_ONLY            只从缓存取数据。
CACHE_THEN_NETWORK            先从缓存取数据，无论结果如何都会再次从网络获取数据。
IGNORE_CACHE            只从网络获取数据，且不会将数据缓存在本地。
NETWORK_ELSE_CACHE            先从网络取数据, 没有的话再从缓存取。
NETWORK_ONLY            只从网络取数据，同时保存在缓存。