Interface RawQuery

src/main/java/com/codeslap/persistence/RawQuery.java:27–101

Methods in this interface will work like the findAll methods in the SqlAdapter interface, but instead of returning a java.util.List of beans it will return a cursor. @author cristian

 * @author cristian
 */
public interface RawQuery {
    /**
     * Retrieves all elements from the database of the specified type
     *
     * @param theClass the class of the object that we want to retrieve
     * @return a Cursor pointing to the filter rows
     */
    Cursor findAll(Class<?> theClass);

    /**
     * Retrieves all elements from the database that matches the specified sample
     *
     * @param where sample object
     * @return a Cursor pointing to the filter rows
     */
    Cursor findAll(Object where);

    /**
     * Retrieves all elements from the database that matches the specified sample. And follows the specified constraint.
     *
     * @param where      sample object
     * @param constraint constrains for this query
     * @return a Cursor pointing to the filter rows
     */
    Cursor findAll(Object where, Constraint constraint);

    /**
     * Retrieves all elements from the database that are attached to the specified object
     *
     * @param where      the sample object
     * @param attachedTo the object that is attached to the sample object
     * @return a Cursor pointing to the filter rows
     */
    Cursor findAll(Object where, Object attachedTo);

    /**
     * Retrieves all elements from the database that matches the specified sample
     *
     * @param theClass  the class to find all items
     * @param where     a SQL query. It is recommended to use wildcards like: <code>something = ? AND another = ?</code>
     * @param whereArgs the list of values used in the wildcards
     * @return a Cursor pointing to the filter rows
     */
    Cursor findAll(Class<?> theClass, String where, String[] whereArgs);

    /**
     * @param rawQuery an SQL query to execute
     * @return A Cursor object, which is positioned before the first entry. Note that Cursors are not synchronized,
     *         see the documentation for more details.
     */
    Cursor rawQuery(String rawQuery);

    /**
     * @param table         The table name to compile the query against.
     * @param projection    A list of which columns to return. Passing null will return all columns, which is
     *                      discouraged to prevent reading data from storage that isn't going to be used.
     * @param selection     A filter declaring which rows to return, formatted as an SQL WHERE clause (excluding the
     *                      WHERE itself). Passing null will return all rows for the given table.