com.stackmob.sdk.api
Class StackMobQuery

java.lang.Object
  com.stackmob.sdk.api.StackMobQuery

public class StackMobQuery
extends Object

A class that builds queries to execute on the StackMob platform. Example usage: //this code: StackMobQuery query = new StackMobQuery("user").field("age").isGreaterThan(20).isLessThanOrEqualTo(40).field("friend").in(Arrays.asList("joe", "bob", "alice").getQuery(); //is identical to this code: StackMobQuery query = new StackMobQuery("user").fieldIsGreaterThan("user", 20).fieldIsLessThanOrEqualTo("user", 40).fieldIsIn("user", Arrays.asList("joe", "bob", "alice"); A few helpful notes about this object:

• this class is not thread safe. make sure to synchronize all calls
• calling field("field") on a StackMobQuery will return a StackMobQueryWithField object, which helps you build up part of part of your query on a specific field
• you can chain together operators on a StackMobQueryWithField. when you're done, call field("field") or getQuery() to get a new StackMobQueryWithField object or the resulting StackMobQuery object (respectively)
• you can only operate on one field at a time, but you can call field("field") as many times as you want on either a StackMobQuery or StackMobQueryWithField object
• you can call methods like fieldIsGreaterThan("field", "value") or fieldIsLessThanOrEqualTo("field", "value") directly on a StackMobQuery object. the above code sample shows 2 queries that are equivalent. the first line uses StackMobQueryWithField objects, and the second uses direct calls on StackMobQuery

Nested Class Summary

static class

StackMobQuery.Operator

Constructor Summary

StackMobQuery(String objectName)

Method Summary

StackMobQuery	expandDepthIs(Integer i) set the expand depth of this query.
StackMobQueryWithField	field(String field)
StackMobQuery	fieldIsEqualTo(String field, String val) add an "=" to your query.
StackMobQuery	fieldIsGreaterThan(String field, String val) same as fieldIsLessThan(String, String), except applies ">" instead of "<"
StackMobQuery	fieldIsGreaterThanOrEqualTo(String field, String val) same as fieldIsLessThan(String, String), except applies ">=" instead of "<"
StackMobQuery	fieldIsIn(String field, List<String> values) add an "IN" to your query.
StackMobQuery	fieldIsLessThan(String field, String val) same as fieldIsLessThan(String, String), except works with Strings
StackMobQuery	fieldIslessThanOrEqualTo(String field, String val) same as fieldIsLessThan(String, String), except applies "<=" instead of "<"
Map<String,String>	getArguments()
String	getObjectName()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StackMobQuery

public StackMobQuery(String objectName)

Method Detail

getObjectName

public String getObjectName()

getArguments

public Map<String,String> getArguments()

field

public StackMobQueryWithField field(String field)

fieldIsIn

public StackMobQuery fieldIsIn(String field,
                               List<String> values)

add an "IN" to your query. test whether the given field's value is in the given list of possible values

Parameters:

field - the field whose value to test

values - the values against which to match

Returns:

the new query that resulted from adding this operation

fieldIsLessThan

public StackMobQuery fieldIsLessThan(String field,
                                     String val)

same as fieldIsLessThan(String, String), except works with Strings

Parameters:

field - the field whose value to test

val - the value against which to test

Returns:

the new query that resulted from adding this operation

fieldIslessThanOrEqualTo

public StackMobQuery fieldIslessThanOrEqualTo(String field,
                                              String val)

same as fieldIsLessThan(String, String), except applies "<=" instead of "<"

Parameters:

field - the field whose value to test

val - the value against which to test

Returns:

the new query that resulted from adding this operation

fieldIsGreaterThan

public StackMobQuery fieldIsGreaterThan(String field,
                                        String val)

same as fieldIsLessThan(String, String), except applies ">" instead of "<"

Parameters:

field - the field whose value to test

val - the value against which to test

Returns:

the new query that resulted from adding this operation

fieldIsGreaterThanOrEqualTo

public StackMobQuery fieldIsGreaterThanOrEqualTo(String field,
                                                 String val)

same as fieldIsLessThan(String, String), except applies ">=" instead of "<"

Parameters:

field - the field whose value to test

val - the value against which to test

Returns:

the new query that resulted from adding this operation

fieldIsEqualTo

public StackMobQuery fieldIsEqualTo(String field,
                                    String val)

add an "=" to your query. test whether the given field's value is equal to the given value

Parameters:

field - the field whose value to test

val - the value against which to test

Returns:

the new query that resulted from adding this operation

expandDepthIs

public StackMobQuery expandDepthIs(Integer i)

set the expand depth of this query. the expand depth instructs the StackMob platform to detect relationships and automatically replace those relationship IDs with the values that they point to.

Parameters:

i - the expand depth. at time of writing, StackMob restricts expand depth to maximum 3

Returns:

the new query that resulted from adding this operation