Merge "docs: fix code snippets in SQL Databases page" into nyc-dev

<pre>

public final class FeedReaderContract {

    // To prevent someone from accidentally instantiating the contract class,

    // give it an empty constructor.

    public FeedReaderContract() {}

    // make the constructor private.

    private FeedReaderContract() {}

    /* Inner class that defines the table contents */

    public static abstract class FeedEntry implements BaseColumns {

    public static class FeedEntry implements BaseColumns {

        public static final String TABLE_NAME = "entry";

        public static final String COLUMN_NAME_ENTRY_ID = "entryid";

        public static final String COLUMN_NAME_TITLE = "title";

        public static final String COLUMN_NAME_SUBTITLE = "subtitle";

        ...

    }

}

</pre>

private static final String SQL_CREATE_ENTRIES =

    "CREATE TABLE " + FeedEntry.TABLE_NAME + " (" +

    FeedEntry._ID + " INTEGER PRIMARY KEY," +

    FeedEntry.COLUMN_NAME_ENTRY_ID + TEXT_TYPE + COMMA_SEP +

    FeedEntry.COLUMN_NAME_TITLE + TEXT_TYPE + COMMA_SEP +

    ... // Any other options for the CREATE command

    " )";

    FeedEntry.COLUMN_NAME_SUBTITLE + TEXT_TYPE + " )";

private static final String SQL_DELETE_ENTRIES =

    "DROP TABLE IF EXISTS " + FeedEntry.TABLE_NAME;

// Create a new map of values, where column names are the keys

ContentValues values = new ContentValues();

values.put(FeedEntry.COLUMN_NAME_ENTRY_ID, id);

values.put(FeedEntry.COLUMN_NAME_TITLE, title);

values.put(FeedEntry.COLUMN_NAME_CONTENT, content);

values.put(FeedEntry.COLUMN_NAME_SUBTITLE, subtitle);

// Insert the new row, returning the primary key value of the new row

long newRowId;

newRowId = db.insert(

         FeedEntry.TABLE_NAME,

         FeedEntry.COLUMN_NAME_NULLABLE,

         values);

long newRowId = db.insert(FeedEntry.TABLE_NAME, null, values);

</pre>

<p>The first argument for {@link android.database.sqlite.SQLiteDatabase#insert insert()}

is simply the table name. The second argument provides

the name of a column in which the framework can insert NULL in the event that the

{@link android.content.ContentValues} is empty (if you instead set this to {@code "null"},

then the framework will not insert a row when there are no values).</p>

is simply the table name. </p>

<p>The second argument tells the framework what to do in the event that the

{@link android.content.ContentValues} is empty (i.e., you did not

{@link android.content.ContentValues#put put} any values).

If you specify the name of a column, the framework inserts a row and sets

the value of that column to null. If you specify <code>null</code>, like in this

code sample, the framework does not insert a row when there are no values.</p>

String[] projection = {

    FeedEntry._ID,

    FeedEntry.COLUMN_NAME_TITLE,

    FeedEntry.COLUMN_NAME_UPDATED,

    ...

    FeedEntry.COLUMN_NAME_SUBTITLE

    };

// Filter results WHERE "title" = 'My Title'

String selection = FeedEntry.COLUMN_NAME_TITLE + " = ?";

String[] selectionArgs = { "My Title" };

// How you want the results sorted in the resulting Cursor

String sortOrder =

    FeedEntry.COLUMN_NAME_UPDATED + " DESC";

    FeedEntry.COLUMN_NAME_SUBTITLE + " DESC";

Cursor c = db.query(

    FeedEntry.TABLE_NAME,                     // The table to query

<pre>

// Define 'where' part of query.

String selection = FeedEntry.COLUMN_NAME_ENTRY_ID + " LIKE ?";

String selection = FeedEntry.COLUMN_NAME_TITLE + " LIKE ?";

// Specify arguments in placeholder order.

String[] selectionArgs = { String.valueOf(rowId) };

String[] selectionArgs = { "MyTitle" };

// Issue SQL statement.

db.delete(table_name, selection, selectionArgs);

db.delete(FeedEntry.TABLE_NAME, selection, selectionArgs);

</pre>

ContentValues values = new ContentValues();

values.put(FeedEntry.COLUMN_NAME_TITLE, title);

// Which row to update, based on the ID

String selection = FeedEntry.COLUMN_NAME_ENTRY_ID + " LIKE ?";

String[] selectionArgs = { String.valueOf(rowId) };

// Which row to update, based on the title

String selection = FeedEntry.COLUMN_NAME_TITLE + " LIKE ?";

String[] selectionArgs = { "MyTitle" };

int count = db.update(

    FeedReaderDbHelper.FeedEntry.TABLE_NAME,