topics/providers/content-provider-basics.jd

page.title=
@jd:body
<div id="qv-wrapper">
<div id="qv">
<!-- In this document -->
<h2></h2>
<ol>
    <li>
        <a href="#Basics"></a>
        <ol>
            <li>
                <a href="#ClientProvider"></a>
            </li>
            <li>
                <a href="#ContentURIs"> URI</a>
            </li>
        </ol>
    </li>
    <li>
        <a href="#SimpleQuery"></a>
        <ol>
            <li>
                <a href="#RequestPermissions"></a>
            </li>
            <li>
                <a href="#Query"></a>
            </li>
            <li>
                <a href="#DisplayResults"></a>
            </li>
            <li>
                <a href="#GettingResults"></a>
            </li>
        </ol>
    </li>
    <li>
        <a href="#Permissions"></a>
    </li>
    <li>
        <a href="#Modifications"></a>
        <ol>
            <li>
                <a href="#Inserting"></a>
            </li>
            <li>
                <a href="#Updating"></a>
            </li>
            <li>
                <a href="#Deleting"></a>
            </li>
        </ol>
    </li>
    <li>
        <a href="#DataTypes"></a>
    </li>
    <li>
        <a href="#AltForms"></a>
        <ol>
            <li>
                <a href="#Batch"></a>
            </li>
            <li>
                <a href="#Intents"> Intent </a>
            </li>
        </ol>
    </li>
    <li>
        <a href="#ContractClasses"></a>
    </li>
    <li>
        <a href="#MIMETypeReference">MIME </a>
    </li>
</ol>

    <!-- Key Classes -->
<h2></h2>
    <ol>
        <li>
            {@link android.content.ContentProvider}
        </li>
        <li>
            {@link android.content.ContentResolver}
        </li>
        <li>
            {@link android.database.Cursor}
        </li>
        <li>
            {@link android.net.Uri}
        </li>
    </ol>

    <!-- Related Samples -->
<h2></h2>
    <ol>
        <li>
        <a href="{@docRoot}resources/samples/ApiDemos/src/com/example/android/apis/view/List2.html">
</a>
        </li>
        <li>
        <a href="{@docRoot}resources/samples/ApiDemos/src/com/example/android/apis/view/List7.html">
</a>
        </li>
    </ol>

    <!-- See also -->
<h2></h2>
    <ol>
        <li>
            <a href="{@docRoot}guide/topics/providers/content-provider-creating.html">
</a>
        </li>
        <li>
            <a href="{@docRoot}guide/topics/providers/calendar-provider.html">
</a>
        </li>
    </ol>
</div>
</div>

    <!-- Intro paragraphs -->
<p>
     Android  UI


</p>
<p>

</p>
    <ul>
        <li></li>
        <li> API</li>
        <li> API</li>
        <li> API </li>
    </ul>

    <!-- Basics -->
<h2 id="Basics"></h2>
<p>


</p>
<p>
    Android
 1

</p>
<p class="table-caption">
    <strong> 1</strong>
</p>
<table id="table1" style="width: 50%;">
    <tr>
        <th style="width:20%" align="center" scope="col"></th>
        <th style="width:20%" align="center" scope="col"> id</th>
        <th style="width:20%" align="center" scope="col"></th>
        <th style="width:20%" align="center" scope="col"></th>
        <th style="width:20%" align="center" scope="col">_ID</th>
    </tr>
    <tr>
        <td align="center" scope="row">mapreduce</td>
        <td align="center">user1</td>
        <td align="center">100</td>
        <td align="center">en_US</td>
        <td align="center">1</td>
    </tr>
    <tr>
        <td align="center" scope="row">precompiler</td>
        <td align="center">user14</td>
        <td align="center">200</td>
        <td align="center">fr_FR</td>
        <td align="center">2</td>
    </tr>
    <tr>
        <td align="center" scope="row">applet</td>
        <td align="center">user2</td>
        <td align="center">225</td>
        <td align="center">fr_CA</td>
        <td align="center">3</td>
    </tr>
    <tr>
        <td align="center" scope="row">const</td>
        <td align="center">user1</td>
        <td align="center">255</td>
        <td align="center">pt_BR</td>
        <td align="center">4</td>
    </tr>
    <tr>
        <td align="center" scope="row">int</td>
        <td align="center">user5</td>
        <td align="center">100</td>
        <td align="center">en_UK</td>
        <td align="center">5</td>
    </tr>
</table>
<p>
     1


 <code>locale</code> <code>_ID</code>


</p>
<p class="note">
    <strong></strong> <code>_ID</code>
 {@link android.widget.ListView}  <code>_ID</code>

<a href="#DisplayResults"></a>

</p>
<h3 id="ClientProvider"></h3>
<p>
     {@link android.content.ContentResolver}
{@link android.content.ContentProvider}


{@link android.content.ContentResolver} CRUD

</p>
<p>
     {@link android.content.ContentResolver}  {@link android.content.ContentProvider}
{@link android.content.ContentProvider}


</p>
<p class="note">
    <strong></strong>
<a href="#Permissions"></a>

</p>
<p>
     {@link android.content.ContentResolver#query ContentResolver.query()}

    {@link android.content.ContentResolver#query query()}
{@link android.content.ContentProvider#query ContentProvider.query()}

{@link android.content.ContentResolver#query ContentResolver.query()}
<p>
<pre>
// Queries the user dictionary and returns results
mCursor = getContentResolver().query(
    UserDictionary.Words.CONTENT_URI,   // The content URI of the words table
    mProjection,                        // The columns to return for each row
    mSelectionClause                    // Selection criteria
    mSelectionArgs,                     // Selection criteria
    mSortOrder);                        // The sort order for the returned rows
</pre>
<p>
     2
    {@link android.content.ContentResolver#query
    query(Uri,projection,selection,selectionArgs,sortOrder)}  SQL SELECT
</p>
<p class="table-caption">
    <strong> 2</strong>Query()  SQL
</p>
<table id="table2" style="width: 75%;">
    <tr>
        <th style="width:25%" align="center" scope="col">query() </th>
        <th style="width:25%" align="center" scope="col">SELECT /</th>
        <th style="width:50%" align="center" scope="col"></th>
    </tr>
    <tr>
        <td align="center"><code>Uri</code></td>
        <td align="center"><code>FROM <em>table_name</em></code></td>
        <td><code>Uri</code>  <em>table_name</em> </td>
    </tr>
    <tr>
        <td align="center"><code>projection</code></td>
        <td align="center"><code><em>col,col,col,...</em></code></td>
        <td>
            <code>projection</code>

        </td>
    </tr>
    <tr>
        <td align="center"><code>selection</code></td>
        <td align="center"><code>WHERE <em>col</em> = <em>value</em></code></td>
        <td><code>selection</code> </td>
    </tr>
    <tr>
        <td align="center"><code>selectionArgs</code></td>
        <td align="center">
             <code>?</code>

        </td>
    </tr>
    <tr>
        <td align="center"><code>sortOrder</code></td>
        <td align="center"><code>ORDER BY <em>col,col,...</em></code></td>
        <td>
            <code>sortOrder</code>
 {@link android.database.Cursor}
        </td>
    </tr>
</table>
<h3 id="ContentURIs"> URI</h3>
<p>
    <strong> URI</strong>  URI URI    <strong></strong><strong></strong>

 URI


</p>
<p>

 {@link android.provider.UserDictionary.Words#CONTENT_URI}  URI
{@link android.content.ContentResolver}
  URI

{@link android.content.ContentResolver}

</p>
<p>
    {@link android.content.ContentProvider}  URI
<strong></strong>
</p>
<p>
     URI
</p>
<pre>
content://user_dictionary/words
</pre>
<p>
    <code>user_dictionary</code>
<code>words</code>
 <code>content://</code><strong></strong> URI

</p>
<p>
     ID  URI  <code>_ID</code>
 <code>4</code>  URI

</p>
<pre>
Uri singleUri = ContentUris.withAppendedId(UserDictionary.Words.CONTENT_URI,4);
</pre>
<p>
     ID

</p>
<p class="note">
    <strong></strong>{@link android.net.Uri}  {@link android.net.Uri.Builder}
 URI
{@link android.content.ContentUris}  ID
 URI  {@link android.content.ContentUris#withAppendedId
    withAppendedId()}  ID  URI
</p>


    <!-- Retrieving Data from the Provider -->
<h2 id="SimpleQuery"></h2>
<p>


</p>
<p class="note">
    UI
 {@link android.content.ContentResolver#query ContentResolver.query()}
 {@link android.content.CursorLoader} <a href="{@docRoot}guide/components/loaders.html"></a>


</p>
<p>

</p>
<ol>
   <li>

   </li>
   <li>

   </li>
</ol>
<h3 id="RequestPermissions"></h3>
<p>

<code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html">&lt;uses-permission&gt;</a></code>


</p>
<p>


</p>
<p>
    <a href="#Permissions"></a>

</p>
<p>

 <code>android.permission.READ_USER_DICTIONARY</code>

</p>
<!-- Constructing the query -->
<h3 id="Query"></h3>
<p>


</p>
<pre class="prettyprint">

// A "projection" defines the columns that will be returned for each row
String[] mProjection =
{
    UserDictionary.Words._ID,    // Contract class constant for the _ID column name
    UserDictionary.Words.WORD,   // Contract class constant for the word column name
    UserDictionary.Words.LOCALE  // Contract class constant for the locale column name
};

// Defines a string to contain the selection clause
String mSelectionClause = null;

// Initializes an array to contain selection arguments
String[] mSelectionArgs = {""};

</pre>
<p>

 {@link android.content.ContentResolver#query ContentResolver.query()}
 SQL

</p>
<p>
    <strong></strong> <code>mProjection</code>

</p>
<p>

 <code>mSelectionClause</code>
 <code>?</code>  <code>mSelectionArgs</code>


</p>
<p>
     <code>null</code>
 <code>UserDictionary.Words.WORD + " = ?"</code>


</p>
<pre class="prettyprint">
/*
 * This defines a one-element String array to contain the selection argument.
 */
String[] mSelectionArgs = {""};

// Gets a word from the UI
mSearchString = mSearchWord.getText().toString();

// Remember to insert code here to check for invalid or malicious input.

// If the word is the empty string, gets everything
if (TextUtils.isEmpty(mSearchString)) {
    // Setting the selection clause to null will return all words
    mSelectionClause = null;
    mSelectionArgs[0] = "";

} else {
    // Constructs a selection clause that matches the word that the user entered.
    mSelectionClause = UserDictionary.Words.WORD + " = ?";

    // Moves the user's input string to the selection arguments.
    mSelectionArgs[0] = mSearchString;

}

// Does a query against the table and returns a Cursor object
mCursor = getContentResolver().query(
    UserDictionary.Words.CONTENT_URI,  // The content URI of the words table
    mProjection,                       // The columns to return for each row
    mSelectionClause                   // Either null, or the word the user entered
    mSelectionArgs,                    // Either empty, or the string the user entered
    mSortOrder);                       // The sort order for the returned rows

// Some providers return null if an error occurs, others throw an exception
if (null == mCursor) {
    /*
     * Insert code here to handle the error. Be sure not to use the cursor! You may want to
     * call android.util.Log.e() to log this error.
     *
     */
// If the Cursor is empty, the provider found no matches
} else if (mCursor.getCount() &lt; 1) {

    /*
     * Insert code here to notify the user that the search was unsuccessful. This isn't necessarily
     * an error. You may want to offer the user the option to insert a new row, or re-type the
     * search term.
     */

} else {
    // Insert code here to do something with the results

}
</pre>
<p>
     SQL
</p>
<pre>
SELECT _ID, word, locale FROM words WHERE word = &lt;userinput&gt; ORDER BY word ASC;
</pre>
<p>
     SQL
</p>
<h4 id="Injection"></h4>
<p>
     SQL  SQL  SQL

</p>
<p>

</p>
<pre>
// Constructs a selection clause by concatenating the user's input to the column name
String mSelectionClause =  "var = " + mUserInput;
</pre>
<p>
     SQL  SQL
     <code>mUserInput</code> nothing; DROP TABLE *; <code>var = nothing; DROP TABLE *;</code>
 SQL  SQLite  <a href="http://en.wikipedia.org/wiki/SQL_injection">SQL </a>


</p>
<p>
     <code>?</code>
 SQL

     SQL  SQL

</p>
<pre>
// Constructs a selection clause with a replaceable parameter
String mSelectionClause =  "var = ?";
</pre>
<p>

</p>
<pre>
// Defines an array to contain the selection arguments
String[] selectionArgs = {""};
</pre>
<p>

</p>
<pre>
// Sets the selection argument to the user's input
selectionArgs[0] = mUserInput;
</pre>
<p>
     <code>?</code>  SQL


</p>
<!-- Displaying the results -->
<h3 id="DisplayResults"></h3>
<p>
    {@link android.content.ContentResolver#query ContentResolver.query()}  {@link android.database.Cursor}


{@link android.database.Cursor}
 {@link android.database.Cursor}

 {@link android.database.Cursor} / {@link android.database.Cursor}


</p>
<p class="note">
    <strong></strong>
 Activity

</p>
<p>
     {@link android.database.Cursor#getCount Cursor.getCount()}  0 {@link android.database.Cursor}


</p>
<p>
     <code>null</code> {@link java.lang.Exception}

</p>
<p>
     {@link android.database.Cursor}  {@link android.database.Cursor}  {@link android.widget.SimpleCursorAdapter}  {@link android.widget.ListView}


</p>
<p>
     {@link android.database.Cursor}  {@link android.widget.SimpleCursorAdapter}  {@link android.widget.ListView}


</p>
<pre class="prettyprint">
// Defines a list of columns to retrieve from the Cursor and load into an output row
String[] mWordListColumns =
{
    UserDictionary.Words.WORD,   // Contract class constant containing the word column name
    UserDictionary.Words.LOCALE  // Contract class constant containing the locale column name
};

// Defines a list of View IDs that will receive the Cursor columns for each row
int[] mWordListItems = { R.id.dictWord, R.id.locale};

// Creates a new SimpleCursorAdapter
mCursorAdapter = new SimpleCursorAdapter(
    getApplicationContext(),               // The application's Context object
    R.layout.wordlistrow,                  // A layout in XML for one row in the ListView
    mCursor,                               // The result from the query
    mWordListColumns,                      // A string array of column names in the cursor
    mWordListItems,                        // An integer array of view IDs in the row layout
    0);                                    // Flags (usually none are needed)

// Sets the adapter for the ListView
mWordList.setAdapter(mCursorAdapter);
</pre>
<p class="note">
    <strong></strong> {@link android.database.Cursor}  {@link android.widget.ListView} <code>_ID</code>

     <code>_ID</code>  {@link android.widget.ListView}

     <code>_ID</code>

</p>

        <!-- Getting data from query results -->
<h3 id="GettingResults"></h3>
<p>


 {@link android.database.Cursor}
</p>
<pre class="prettyprint">

// Determine the column index of the column named "word"
int index = mCursor.getColumnIndex(UserDictionary.Words.WORD);

/*
 * Only executes if the cursor is valid. The User Dictionary Provider returns null if
 * an internal error occurs. Other providers may throw an Exception instead of returning null.
 */

if (mCursor != null) {
    /*
     * Moves to the next row in the cursor. Before the first movement in the cursor, the
     * "row pointer" is -1, and if you try to retrieve data at that position you will get an
     * exception.
     */
    while (mCursor.moveToNext()) {

        // Gets the value from the column.
        newWord = mCursor.getString(index);

        // Insert code here to process the retrieved word.

        ...

        // end of while loop
    }
} else {

    // Insert code here to report an error if the cursor is null or the provider threw an exception.
}
</pre>
<p>
    {@link android.database.Cursor}
 {@link android.database.Cursor#getString getString()}
 {@link android.database.Cursor#getType getType()}


</p>


    <!-- Requesting permissions -->
<h2 id="Permissions"></h2>
<p>


</p>
<p>


</p>
<p>

 <code>android.permission.READ_USER_DICTIONARY</code>
     <code>android.permission.WRITE_USER_DICTIONARY</code>

</p>
<p>

<code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html">&lt;uses-permission&gt;</a></code>
 Android


</p>
<p>

<code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html">&lt;uses-permission&gt;</a></code>

</p>
<pre>
    &lt;uses-permission android:name="android.permission.READ_USER_DICTIONARY"&gt;
</pre>
<p>

<a href="{@docRoot}guide/topics/security/security.html"></a>
</p>


<!-- Inserting, Updating, and Deleting Data -->
<h2 id="Modifications"></h2>
<p>
     {@link android.content.ContentProvider}

     {@link android.content.ContentProvider}  {@link android.content.ContentResolver}


</p>
<h3 id="Inserting"></h3>
<p>

 {@link android.content.ContentResolver#insert ContentResolver.insert()}
  URI

</p>
<pre class="prettyprint">
// Defines a new Uri object that receives the result of the insertion
Uri mNewUri;

...

// Defines an object to contain the new values to insert
ContentValues mNewValues = new ContentValues();

/*
 * Sets the values of each column and inserts the word. The arguments to the "put"
 * method are "column name" and "value"
 */
mNewValues.put(UserDictionary.Words.APP_ID, "example.user");
mNewValues.put(UserDictionary.Words.LOCALE, "en_US");
mNewValues.put(UserDictionary.Words.WORD, "insert");
mNewValues.put(UserDictionary.Words.FREQUENCY, "100");

mNewUri = getContentResolver().insert(
    UserDictionary.Word.CONTENT_URI,   // the user dictionary content URI
    mNewValues                          // the values to insert
);
</pre>
<p>
     {@link android.content.ContentValues}
 {@link android.content.ContentValues#putNull ContentValues.putNull()}  <code>null</code>


</p>
<p>
     <code>_ID</code>
 <code>_ID</code>

</p>
<p>
    <code>newUri</code>  URI

</p>
<pre>
content://user_dictionary/words/&lt;id_value&gt;
</pre>
<p>
    <code>&lt;id_value&gt;</code>  <code>_ID</code>
     URI

</p>
<p>
     {@link android.net.Uri}  <code>_ID</code>
 {@link android.content.ContentUris#parseId ContentUris.parseId()}
</p>
<h3 id="Updating"></h3>
<p>
     {@link android.content.ContentValues}


 {@link android.content.ContentResolver#update ContentResolver.update()} {@link android.content.ContentValues}
 <code>null</code>

</p>
<p>
    en <code>null</code>

</p>
<pre>
// Defines an object to contain the updated values
ContentValues mUpdateValues = new ContentValues();

// Defines selection criteria for the rows you want to update
String mSelectionClause = UserDictionary.Words.LOCALE +  "LIKE ?";
String[] mSelectionArgs = {"en_%"};

// Defines a variable to contain the number of updated rows
int mRowsUpdated = 0;

...

/*
 * Sets the updated value and updates the selected words.
 */
mUpdateValues.putNull(UserDictionary.Words.LOCALE);

mRowsUpdated = getContentResolver().update(
    UserDictionary.Words.CONTENT_URI,   // the user dictionary content URI
    mUpdateValues                       // the columns to update
    mSelectionClause                    // the column to select on
    mSelectionArgs                      // the value to compare to
);
</pre>
<p>

 {@link android.content.ContentResolver#update ContentResolver.update()} <a href="#Injection"></a>

</p>
<h3 id="Deleting"></h3>
<p>


     ID

</p>
<pre>

// Defines selection criteria for the rows you want to delete
String mSelectionClause = UserDictionary.Words.APP_ID + " LIKE ?";
String[] mSelectionArgs = {"user"};

// Defines a variable to contain the number of rows deleted
int mRowsDeleted = 0;

...

// Deletes the words that match the selection criteria
mRowsDeleted = getContentResolver().delete(
    UserDictionary.Words.CONTENT_URI,   // the user dictionary content URI
    mSelectionClause                    // the column to select on
    mSelectionArgs                      // the value to compare to
);
</pre>
<p>

 {@link android.content.ContentResolver#delete ContentResolver.delete()} <a href="#Injection"></a>

</p>
<!-- Provider Data Types -->
<h2 id="DataTypes"></h2>
<p>


</p>
    <ul>
        <li>

        </li>
        <li>

        </li>
        <li>

        </li>
        <li>

        </li>
    </ul>
<p>
     64KB  (BLOB)

 {@link android.database.Cursor}
</p>
<p>

     {@link android.provider.UserDictionary.Words} <a href="#ContractClasses"></a>


     {@link android.database.Cursor#getType
 Cursor.getType()}
</p>
<p>
     URI  MIME MIME  MIME

 MIME

 {@link android.provider.ContactsContract.Data}
  MIME
 URI  MIME
 {@link android.content.ContentResolver#getType ContentResolver.getType()}
</p>
<p>
    <a href="#MIMETypeReference">MIME </a> MIME

</p>


<!-- Alternative Forms of Provider Access -->
<h2 id="AltForms"></h2>
<p>

</p>
<ul>
    <li>
        <a href="#Batch"></a>
 {@link android.content.ContentProviderOperation}
 {@link android.content.ContentResolver#applyBatch ContentResolver.applyBatch()}
    </li>
    <li>
         {@link android.content.CursorLoader}
<a href="{@docRoot}guide/components/loaders.html"></a>


    </li>
    <li>
        <a href="#Intents"> Intent </a> Intent Intent


    </li>
</ul>
<p>

</p>
<h3 id="Batch"></h3>
<p>


</p>
<p>

 {@link android.content.ContentProviderOperation}  {@link android.content.ContentResolver#applyBatch ContentResolver.applyBatch()}

<em></em> URI {@link android.content.ContentProviderOperation}


 {@link android.content.ContentResolver#applyBatch
 ContentResolver.applyBatch()}
</p>
<p>
    {@link android.provider.ContactsContract.RawContacts}

<a href="{@docRoot}resources/samples/ContactManager/index.html"></a> <code>ContactAdder.java</code>


</p>
<div class="sidebox-wrapper">
<div class="sidebox">
<h2></h2>
<p>
    <em></em> Intent

 {@link android.content.Intent#ACTION_VIEW} Intent
     UI <a href="{@docRoot}guide/topics/providers/calendar-provider.html"></a>


</p>
<p>
     Intent
 URI  {@link android.content.Intent#ACTION_VIEW}  Intent


</p>
</div>
</div>
<h3 id="Intents"> Intent </h3>
<p>
     Intent  Intent


</p>
<h4></h4>
<p>
     Intent URI Intent


     URI  Activity
 Intent

</p>
<ul>
    <li>
        <strong></strong>
{@link android.content.Intent#FLAG_GRANT_READ_URI_PERMISSION}
    </li>
    <li>
        <strong></strong>
{@link android.content.Intent#FLAG_GRANT_WRITE_URI_PERMISSION}
    </li>
</ul>
<p class="note">
    <strong></strong> URI
 URI
</p>
<p>

<code><a href="{@docRoot}guide/topics/manifest/provider-element.html">&lt;provider&gt;</a></code>

<code><a href="{@docRoot}guide/topics/manifest/provider-element.html#gprmsn">android:grantUriPermission</a></code>

<code><a href="{@docRoot}guide/topics/manifest/provider-element.html">&lt;provider&gt;</a></code>

<code><a href="{@docRoot}guide/topics/manifest/grant-uri-permission-element.html">&lt;grant-uri-permission&gt;</a></code>
 URI  URI <a href="{@docRoot}guide/topics/security/security.html"></a>URI  URI


</p>
<p>

 {@link android.Manifest.permission#READ_CONTACTS}
 {@link android.Manifest.permission#READ_CONTACTS}


</p>
<ol>
    <li>
         {@link android.app.Activity#startActivityForResult
  startActivityForResult()}
 {@link android.content.Intent#ACTION_PICK} MIME
 {@link android.provider.ContactsContract.RawContacts#CONTENT_ITEM_TYPE}  Intent

    </li>
    <li>
         Intent  Activity  Intent  Activity

    </li>
    <li>
         Activity
 Activity
 {@link android.app.Activity#setResult setResult(resultcode, intent)}
  Intent Intent  URIextras
 {@link android.content.Intent#FLAG_GRANT_READ_URI_PERMISSION}
 URI  URI
  Activity  {@link android.app.Activity#finish()}


    </li>
    <li>
         Activity  Activity
 {@link android.app.Activity#onActivityResult onActivityResult()}
  Activity  Intent

    </li>
    <li>
         Intent  URI


    </li>
</ol>
<h4></h4>
<p>


</p>
<p>

 {@link android.content.Intent#ACTION_INSERT} Intent UI Intent Intent  UI
 {@link android.content.Intent#ACTION_INSERT}


</p>
<!-- Contract Classes -->
<h2 id="ContractClasses"></h2>
<p>
     URI Intent


Android
  {@link android.provider}
</p>
<p>
     URI  {@link android.provider.UserDictionary}

 URI
 {@link android.provider.UserDictionary.Words#CONTENT_URI UserDictionary.Words.CONTENT_URI}
    {@link android.provider.UserDictionary.Words}


</p>
<pre>
String[] mProjection =
{
    UserDictionary.Words._ID,
    UserDictionary.Words.WORD,
    UserDictionary.Words.LOCALE
};
</pre>
<p>
     {@link android.provider.ContactsContract}
     {@link android.provider.ContactsContract.Intents.Insert}  Intent  Intent


</p>


<!-- MIME Type Reference -->
<h2 id="MIMETypeReference">MIME </h2>
<p>
     MIME / MIME
</p>
<p>
    MIME
</p>
<pre>
<em>type</em>/<em>subtype</em>
</pre>
<p>
     MIME  <code>text/html</code>  <code>text</code>
 <code>html</code>  URI  URI  HTML

</p>
<p>
     MIME  MIME <em></em><em></em>
<em></em>
</p>
<pre>
vnd.android.cursor.<strong>dir</strong>
</pre>
<p>

</p>
<pre>
vnd.android.cursor.<strong>item</strong>
</pre>
<p>

</p>
<p>
    <em></em>Android
 MIME

</p>
<pre>
vnd.android.cursor.item/phone_v2
</pre>
<p>
     <code>phone_v2</code>
</p>
<p>


     <code>com.example.trains</code>
 Line1Line2  Line3 Line1  URI
</p>
<p>
<pre>
content://com.example.trains/Line1
</pre>
<p>
     MIME
</p>
<pre>
vnd.android.cursor.<strong>dir</strong>/vnd.example.line1
</pre>
<p>
      Line2  5  URI
</p>
<pre>
content://com.example.trains/Line2/5
</pre>
<p>
     MIME
</p>
<pre>
vnd.android.cursor.<strong>item</strong>/vnd.example.line2
</pre>
<p>
     MIME  {@link android.provider.ContactsContract.RawContacts}  MIME
 {@link android.provider.ContactsContract.RawContacts#CONTENT_ITEM_TYPE}


</p>
<p>

<a href="#ContentURIs"> URI</a>  URI
</p>