Android - 內容提供者(Content Provider)

內容提供者組件通過請求從一個應用程式向其他的應用程式提供數據。這些請求由類 ContentResolver 的方法來處理。內容提供者可以使用不同的方式來存儲數據。數據可以被存放在資料庫，檔，甚至是網路。

有時候需要在應用程式之間共用數據。這時內容提供者變得非常有用。

內容提供者可以讓內容集中，必要時可以有多個不同的應用程式來訪問。內容提供者的行為和數據庫很像。你可以查詢，編輯它的內容，使用 insert()， update()， delete() 和 query() 來添加或者刪除內容。多數情況下數據被存儲在 SQLite 資料庫。

內容提供者被實現為類 ContentProvider 類的子類。需要實現一系列標準的 API，以便其他的應用程式來執行事務。

public class MyApplication extends  ContentProvider {

}

內容URI

要查詢內容提供者，你需要以如下格式的URI的形式來指定查詢字串：

<prefix>://<authority>/<data_type>/<id>

以下是URI中各部分的具體說明：

部分	說明
prefix	首碼：一直被設置為content://
authority	授權：指定內容提供者的名稱，例如聯繫人，流覽器等。第三方的內容提供者可以是全名，如：cn.programmer.statusprovider
data_type	數據類型：這個表明這個特殊的內容提供者中的數據的類型。例如：你要通過內容提供者Contacts來獲取所有的通訊錄，數據路徑是people，那麼URI將是下麵這樣：content://contacts/people
id	這個指定特定的請求記錄。例如：你在內容提供者Contacts中查找聯繫人的ID號為5，那麼URI看起來是這樣：content://contacts/people/5

創建內容提供者

這裏描述創建自己的內容提供者的簡單步驟。

首先，你需要繼承類 ContentProviderbase 來創建一個內容提供者類。
其次，你需要定義用於訪問內容的你的內容提供者URI地址。
接下來，你需要創建資料庫來保存內容。通常，Android 使用 SQLite 資料庫，並在框架中重寫 onCreate() 方法來使用 SQLiteOpenHelper 的方法創建或者打開提供者的資料庫。當你的應用程式被啟動，它的每個內容提供者的 onCreate() 方法將在應用程式主線程中被調用。
最後，使用<provider.../>標籤在 AndroidManifest.xml 中註冊內容提供者。

以下是讓你的內容提供者正常工作，你需要在類 ContentProvider 中重寫的一些方法：

onCreate():當提供者被啟動時調用。
query():該方法從客戶端接受請求。結果是返回指針(Cursor)對象。
insert():該方法向內容提供者插入新的記錄。
delete():該方法從內容提供者中刪除已存在的記錄。
update():該方法更新內容提供者中已存在的記錄。
getType():該方法為給定的URI返回元數據類型。

實例

該實例解釋如何創建自己的內容提供者。讓我們按照下麵的步驟：

步驟	描述
1	使用 Android Studio 創建 Android 應用程式並命名為 Content Provider，在包com.zaixian.contentprovider 下，並建立空活動。
2	修改主要活動檔 MainActivity.java 來添加兩個新的方法 onClickAddName() 和 onClickRetrieveStudents()。
3	在包 com.zaixian.contentprovider 下創建新的 Java 檔 StudentsProvider.java 來定義實際的提供者，並關聯方法。
4	使用<provider.../>標籤在 AndroidManifest.xml 中註冊內容提供者。
5	修改 res/layout/activity_main.xml 檔的默認內容來包含添加學生記錄的簡單介面。
6	無需修改 strings.xml，Android Studio 會注意 strings.xml 檔。
7	啟動 Android 模擬器來運行應用程式，並驗證應用程式所做改變的結果。

下麵是修改的主要活動檔 src/com.zaixian.contentprovider/MainActivity.java 的內容。該檔包含每個基礎的生命週期方法。我們添加了兩個新的方法，onClickAddName() 和 onClickRetrieveStudents() 來讓應用程式處理用戶交互。

package com.zaixian.contentprovider;

import android.net.Uri;
import android.os.Bundle;
import android.app.Activity;
import android.content.ContentValues;
import android.content.CursorLoader;
import android.database.Cursor;
import android.view.Menu;
import android.view.View;
import android.widget.EditText;
import android.widget.Toast;
import com.zaixian.contentprovider.R;

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        getMenuInflater().inflate(R.menu.menu_main, menu);
        return true;
    }

    public void onClickAddName(View view) {
        // Add a new student record
        ContentValues values = new ContentValues();

        values.put(StudentsProvider.NAME,
                ((EditText)findViewById(R.id.editText2)).getText().toString());

        values.put(StudentsProvider.GRADE,
                ((EditText)findViewById(R.id.editText3)).getText().toString());

        Uri uri = getContentResolver().insert(
                StudentsProvider.CONTENT_URI, values);

        Toast.makeText(getBaseContext(),
                uri.toString(), Toast.LENGTH_LONG).show();
    }

    public void onClickRetrieveStudents(View view) {

        // Retrieve student records
        String URL = "content://com.example.provider.College/students";

        Uri students = Uri.parse(URL);
        Cursor c = managedQuery(students, null, null, null, "name");

        if (c.moveToFirst()) {
            do{
                Toast.makeText(this,
                        c.getString(c.getColumnIndex(StudentsProvider._ID)) +
                                ", " +  c.getString(c.getColumnIndex( StudentsProvider.NAME)) +
                                ", " + c.getString(c.getColumnIndex( StudentsProvider.GRADE)),
                        Toast.LENGTH_SHORT).show();
            } while (c.moveToNext());
        }
    }
}

在包com.zaixian.contentprovider下創建新的檔StudentsProvider.java。以下是src/com.zaixian.contentprovider/StudentsProvider.java的內容。

package com.zaixian.contentprovider;

import java.util.HashMap;

import android.content.ContentProvider;
import android.content.ContentUris;
import android.content.ContentValues;
import android.content.Context;
import android.content.UriMatcher;

import android.database.Cursor;
import android.database.SQLException;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
import android.database.sqlite.SQLiteQueryBuilder;

import android.net.Uri;
import android.text.TextUtils;

public class StudentsProvider extends ContentProvider {

    static final String PROVIDER_NAME = "com.example.provider.College";
    static final String URL = "content://" + PROVIDER_NAME + "/students";
    static final Uri CONTENT_URI = Uri.parse(URL);

    static final String _ID = "_id";
    static final String NAME = "name";
    static final String GRADE = "grade";

    private static HashMap<String, String> STUDENTS_PROJECTION_MAP;

    static final int STUDENTS = 1;
    static final int STUDENT_ID = 2;

    static final UriMatcher uriMatcher;
    static{
        uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
        uriMatcher.addURI(PROVIDER_NAME, "students", STUDENTS);
        uriMatcher.addURI(PROVIDER_NAME, "students/#", STUDENT_ID);
    }

    /**
     * 資料庫特定常量聲明

     */
    private SQLiteDatabase db;
    static final String DATABASE_NAME = "College";
    static final String STUDENTS_TABLE_NAME = "students";
    static final int DATABASE_VERSION = 1;
    static final String CREATE_DB_TABLE =
            " CREATE TABLE " + STUDENTS_TABLE_NAME +
                    " (_id INTEGER PRIMARY KEY AUTOINCREMENT, " +
                    " name TEXT NOT NULL, " +
                    " grade TEXT NOT NULL);";

    /**
     * 創建和管理提供者內部數據源的幫助類.
     */
    private static class DatabaseHelper extends SQLiteOpenHelper {
        DatabaseHelper(Context context){
            super(context, DATABASE_NAME, null, DATABASE_VERSION);
        }

        @Override
        public void onCreate(SQLiteDatabase db)
        {
            db.execSQL(CREATE_DB_TABLE);
        }

        @Override
        public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
            db.execSQL("DROP TABLE IF EXISTS " +  STUDENTS_TABLE_NAME);
            onCreate(db);
        }
    }

    @Override
    public boolean onCreate() {
        Context context = getContext();
        DatabaseHelper dbHelper = new DatabaseHelper(context);

        /**
         * 如果不存在，則創建一個可寫的資料庫。

         */
        db = dbHelper.getWritableDatabase();
        return (db == null)? false:true;
    }

    @Override
    public Uri insert(Uri uri, ContentValues values) {
        /**
         * 添加新學生記錄

         */
        long rowID = db.insert( STUDENTS_TABLE_NAME, "", values);

        /**
         * 如果記錄添加成功
         */

        if (rowID > 0)
        {
            Uri _uri = ContentUris.withAppendedId(CONTENT_URI, rowID);
            getContext().getContentResolver().notifyChange(_uri, null);
            return _uri;
        }
        throw new SQLException("Failed to add a record into " + uri);
    }

    @Override
    public Cursor query(Uri uri, String[] projection, String selection,String[] selectionArgs, String sortOrder) {
        SQLiteQueryBuilder qb = new SQLiteQueryBuilder();
        qb.setTables(STUDENTS_TABLE_NAME);

        switch (uriMatcher.match(uri)) {
            case STUDENTS:
                qb.setProjectionMap(STUDENTS_PROJECTION_MAP);
                break;

            case STUDENT_ID:
                qb.appendWhere( _ID + "=" + uri.getPathSegments().get(1));
                break;

            default:
                throw new IllegalArgumentException("Unknown URI " + uri);
        }

        if (sortOrder == null || sortOrder == ""){
            /**
             * 默認按照學生姓名排序
             */
            sortOrder = NAME;
        }
        Cursor c = qb.query(db, projection, selection, selectionArgs,null, null, sortOrder);

        /**
         * 註冊內容URI變化的監聽器
         */
        c.setNotificationUri(getContext().getContentResolver(), uri);
        return c;
    }

    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        int count = 0;

        switch (uriMatcher.match(uri)){
            case STUDENTS:
                count = db.delete(STUDENTS_TABLE_NAME, selection, selectionArgs);
                break;

            case STUDENT_ID:
                String id = uri.getPathSegments().get(1);
                count = db.delete( STUDENTS_TABLE_NAME, _ID +  " = " + id +
                        (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : ""), selectionArgs);
                break;

            default:
                throw new IllegalArgumentException("Unknown URI " + uri);
        }

        getContext().getContentResolver().notifyChange(uri, null);
        return count;
    }

    @Override
    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
        int count = 0;

        switch (uriMatcher.match(uri)){
            case STUDENTS:
                count = db.update(STUDENTS_TABLE_NAME, values, selection, selectionArgs);
                break;

            case STUDENT_ID:
                count = db.update(STUDENTS_TABLE_NAME, values, _ID + " = " + uri.getPathSegments().get(1) +
                        (!TextUtils.isEmpty(selection) ? " AND (" +selection + ')' : ""), selectionArgs);
                break;

            default:
                throw new IllegalArgumentException("Unknown URI " + uri );
        }
        getContext().getContentResolver().notifyChange(uri, null);
        return count;
    }

    @Override
    public String getType(Uri uri) {
        switch (uriMatcher.match(uri)){
            /**
             * 獲取所有學生記錄

             */
            case STUDENTS:
                return "vnd.android.cursor.dir/vnd.example.students";

            /**
             * 獲取一個特定的學生
             */
            case STUDENT_ID:
                return "vnd.android.cursor.item/vnd.example.students";

            default:
                throw new IllegalArgumentException("Unsupported URI: " + uri);
        }
    }
}

以下是修改後的AndroidManifest.xml檔。這裏添加了<provider.../>標籤來包含我們的內容提供者：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.zaixian.contentprovider"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="8"
        android:targetSdkVersion="22" />

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >

        <activity
            android:name="com.zaixian.contentprovider.MainActivity"
            android:label="@string/app_name" >

            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>

        </activity>

        <provider android:name="StudentsProvider"
            android:authorities="com.example.provider.College" >
        </provider>

    </application>

</manifest>

下麵是res/layout/activity_main.xml檔的內容：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent"
    android:layout_height="match_parent" android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    android:paddingBottom="@dimen/activity_vertical_margin" tools:context=".MainActivity">

    <TextView
        android:id="@+id/textView1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="內容提供者實例"
        android:layout_alignParentTop="true"
        android:layout_centerHorizontal="true"
        android:textSize="30dp" />

    <TextView
        android:id="@+id/textView2"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="www.xuhuhu.com"
        android:textColor="#ff87ff09"
        android:textSize="30dp"
        android:layout_below="@+id/textView1"
        android:layout_centerHorizontal="true" />

    <ImageButton
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:id="@+id/imageButton"
        android:src="@drawable/ic_launcher"
        android:layout_below="@+id/textView2"
        android:layout_centerHorizontal="true" />

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:id="@+id/button2"
        android:text="添加"
        android:layout_below="@+id/editText3"
        android:layout_alignRight="@+id/textView2"
        android:layout_alignEnd="@+id/textView2"
        android:layout_alignLeft="@+id/textView2"
        android:layout_alignStart="@+id/textView2"
        android:onClick="onClickAddName"/>

    <EditText
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:id="@+id/editText"
        android:layout_below="@+id/imageButton"
        android:layout_alignRight="@+id/imageButton"
        android:layout_alignEnd="@+id/imageButton" />

    <EditText
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:id="@+id/editText2"
        android:layout_alignTop="@+id/editText"
        android:layout_alignLeft="@+id/textView1"
        android:layout_alignStart="@+id/textView1"
        android:layout_alignRight="@+id/textView1"
        android:layout_alignEnd="@+id/textView1"
        android:hint="姓名"
        android:textColorHint="@android:color/holo_blue_light" />

    <EditText
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:id="@+id/editText3"
        android:layout_below="@+id/editText"
        android:layout_alignLeft="@+id/editText2"
        android:layout_alignStart="@+id/editText2"
        android:layout_alignRight="@+id/editText2"
        android:layout_alignEnd="@+id/editText2"
        android:hint="年級"
        android:textColorHint="@android:color/holo_blue_bright" />

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="查詢"
        android:id="@+id/button"
        android:layout_below="@+id/button2"
        android:layout_alignRight="@+id/editText3"
        android:layout_alignEnd="@+id/editText3"
        android:layout_alignLeft="@+id/button2"
        android:layout_alignStart="@+id/button2"
        android:onClick="onClickRetrieveStudents"/>

</RelativeLayout>

確保res/values/strings.xml檔中有以下內容：

<?xml version="1.0" encoding="utf-8"?>
<resources>

    <string name="app_name">Content Provider</string>
    <string name="action_settings">Settings</string>

</resources>

讓我們運行剛剛修改的 Content Provider 應用程式。我假設你已經在安裝環境時創建了 AVD。打開你的專案中的活動檔，點擊工具欄中的圖示來在 Android Studio 中運行應用程式。Android Studio 在 AVD 上安裝應用程式並啟動它。如果一切順利，將在模擬器窗口上顯示如下：

輸入姓名和年級，並點擊"添加"按鈕，這將在數據中添加一條學生記錄，並在底部刪除一條資訊。資訊內容顯示包含添加進資料庫的記錄數的內容提供者URI。這個操作使用了insert()方法。重複這個過程在我們的內容提供者的資料庫中添加更多的學生。

一旦你完成資料庫記錄的添加，是時候向內容提供者要求給回這些記錄。點擊"查詢"按鈕，這將通過實現的 query() 方法來獲取並顯示所有的數據記錄。

你可以在 MainActivity.java 中提供回調方法，來編寫更新和刪除的操作，並修改用戶介面來添加更新和刪除操作。

你可以通過這種方式使用已有的內容提供者，如通訊錄。你也可以通過這種方式來開發一個優秀的面向資料庫的應用，你可以像上面介紹的實例那樣來執行素有的資料庫操作，如讀、寫、更新和刪除。

Android - 內容提供者(Content Provider)

內容URI

創建內容提供者

實例

HTML / CSS

腳本語言

高級語言

Java技術

XML技術

大數據

開發工具

框架

軟體測試

前端技術

資料庫

其他技術