Package android.database.sqlite

Class SQLiteCursor

    • Constructor Detail

      • SQLiteCursor

        @Deprecated
public SQLiteCursor​(SQLiteDatabase db,
                    SQLiteCursorDriver driver,
                    String editTable,
                    SQLiteQuery query)
        Deprecated.
        use SQLiteCursor(SQLiteCursorDriver, String, SQLiteQuery) instead
        Execute a query and provide access to its result set through a Cursor interface. For a query such as: SELECT name, birth, phone FROM myTable WHERE ... LIMIT 1,20 ORDER BY... the column names (name, birth, phone) would be in the projection argument and everything from FROM onward would be in the params argument.
        Parameters:
        db - a reference to a Database object that is already constructed and opened. This param is not used any longer
        editTable - the name of the table used for this query
        query - the rest of the query terms cursor is finalized

      • SQLiteCursor

        public SQLiteCursor​(SQLiteCursorDriver driver,
                    String editTable,
                    SQLiteQuery query)
        Execute a query and provide access to its result set through a Cursor interface. For a query such as: SELECT name, birth, phone FROM myTable WHERE ... LIMIT 1,20 ORDER BY... the column names (name, birth, phone) would be in the projection argument and everything from FROM onward would be in the params argument.
        Parameters:
        editTable - the name of the table used for this query
        query - the SQLiteQuery object associated with this cursor object.

    • Method Detail

      • getDatabase

        public SQLiteDatabase getDatabase()
        Get the database that this cursor is associated with.
        Returns:
        the SQLiteDatabase that this cursor is associated with.

      • onMove

        public boolean onMove​(int oldPosition,
                      int newPosition)
        Description copied from class: AbstractCursor
        This function is called every time the cursor is successfully scrolled to a new position, giving the subclass a chance to update any state it may have. If it returns false the move function will also do so and the cursor will scroll to the beforeFirst position.
        Specified by:
        onMove in interface CrossProcessCursor
        Overrides:
        onMove in class AbstractCursor
        Parameters:
        oldPosition - the position that we're moving from
        newPosition - the position that we're moving to
        Returns:
        true if the move is successful, false otherwise

      • getCount

        public int getCount()
        Description copied from interface: Cursor
        Returns the numbers of rows in the cursor.
        Specified by:
        getCount in interface Cursor
        Specified by:
        getCount in class AbstractCursor
        Returns:
        the number of rows in the cursor.

      • getColumnNames

        public String[] getColumnNames()
        Description copied from interface: Cursor
        Returns a string array holding the names of all of the columns in the result set in the order in which they were listed in the result.
        Specified by:
        getColumnNames in interface Cursor
        Specified by:
        getColumnNames in class AbstractCursor
        Returns:
        the names of the columns returned in this query.

      • requery

        public boolean requery()
        Description copied from interface: Cursor
        Performs the query that created the cursor again, refreshing its contents. This may be done at any time, including after a call to Cursor.deactivate(). Since this method could execute a query on the database and potentially take a while, it could cause ANR if it is called on Main (UI) thread. A warning is printed if this method is being executed on Main thread.
        Specified by:
        requery in interface Cursor
        Overrides:
        requery in class AbstractCursor
        Returns:
        true if the requery succeeded, false if not, in which case the cursor becomes invalid.

      • setWindow

        public void setWindow​(CursorWindow window)
        Description copied from class: AbstractWindowedCursor
        Sets a new cursor window for the cursor to use.

        The cursor takes ownership of the provided cursor window; the cursor window will be closed when the cursor is closed or when the cursor adopts a new cursor window.

        If the cursor previously had a cursor window, then it is closed when the new cursor window is assigned.

        Overrides:
        setWindow in class AbstractWindowedCursor
        Parameters:
        window - The new cursor window, typically a remote cursor window.

      • setSelectionArguments

        public void setSelectionArguments​(String[] selectionArgs)
        Changes the selection arguments. The new values take effect after a call to requery().

      • finalize

        protected void finalize()
        Release the native resources, if they haven't been released yet.
        Overrides:
        finalize in class AbstractCursor