Android數據共享機制ContentProvider

一、簡介
Android使用一種稱爲ContentProvider的概念來將數據抽象爲服務，這種內容提供程序的理念看起來像啓用了REST的數據提供程序。
要從ContentProvider檢索數據或將數據保存到ContentProvider,需要使用一組類似REST的URI。例如，要從封裝圖書數據庫的ContentProvider獲取一組圖書，需要使用以下形式的URI:

content://com.android.book.BookProvider/books

要從圖書數據庫獲得指定圖書（如編號爲：88圖書），則要使用以下類似URI:

content://com.android.book.BookProvider/books/88

設備上的任何應用程序都可以通過這些URI來訪問或操作數據，所以在應用程序之間的數據共享上ContentProvider扮演着非常主要的角色。
二、Android內置的ContentProvider
Android中存在大量的內置ContentProvider,他們記錄在SDK的android.provider包中，如：
Browser
Calllog
Contacts
People
Phones
Photos
Groups
MediaStore
Audio
     Albums
     Artists
     Playlists
Images
Video
Settings
其中頂級項數據庫，較低級的項是表。所以Browser、CAllog,MediaStore和Settings都是封裝爲ContentProvider的獨立SQLite數據庫.這些數據庫通常具有擴展名.db。僅能從實現包訪問，任何來自外部的訪問都要通過ContentProvider接口。
三、ContentProvider架構
與網站一樣，設備上的每個ContentProvider都會使用字符串註冊本身，這個字符串類似網站域名，但稱爲：授權(Authority)。授權的註冊則AndroidManifest.xml中進行。如：

<provider android:name="BookProvider" android:authorities="com.myCompany.BookProvider"/>

在進行了授權後，ContentProvider就擁有了以授權前綴開頭的URI:

content://com.myCompany.BookProvider/

注意：Android內置的ContentProvider可能沒有完全限定的授權名，只有在使用第三方提供的時才使用完全限定名。這也就是爲什麼有時候僅使用Contacts來引用聯繫人ContentProvider。
1、Android內容URI的結構
Android中的內容URI類似於Http URL,但他們以content://開頭具有一下通用形式：

Content://*/*/
或
content://authority-name/path-segment1/path-segment2/etc......

2、Android MIME類型的結構
就像網站返回給指定URI的MIME類型一樣，ContentProvider也負責返回給URI的MIME類型。MIME類型包括兩部分：類型和子類型。如：

text/html
text/css
text/xml
application/pdf
application/vnd.ms-excel

類型和子類型對於他們所表示的內容必須是唯一的，且如果類型和子類型不是標準的，則需要在他們前面加上vnd。
3、使用URI讀取數據
要從ContentProvider獲取數據，需要使用該ContentProvider提供的URI。
如下：爲從聯繫人提供程序獲取單行聯繫人信息

Uri baseUri = Contacts.People.CONTENT_URI;
uri myPersonUri = baseUri.withAppendedPath(Contacts.People.CONTENT_URI,"80");
Cursor cur = manageQuery(myPersonUri,null,null,null);

在上面的基礎上我們來看看，如何獲取一個遊標，這個遊標包含來自contactsContentProvider的People表的一組特定的列。

String[] projection = new String[]{
    People._ID,
    People.NAME,
    People.NUMBER
};

Uri mContactsURi = Contacts.People.CONTENT_URI;
Cursor managedCursor = managedQuery(
    projection,
    null,
    Contacts.People.NAME + "ASC"
);

4、使用遊標
在使用Android遊標前，先了解一些關於遊標的的知識。
遊標是一個行集合；
讀取數據之前，需要使用moveToFirst()，因爲遊標放在第一行之前；
需要知道列的名稱和類型；
所有字段訪問都基於列編號，所以必須首先將列名稱轉換爲列編號；
遊標可以隨意移動；
可以使用遊標獲取行計數；
使用while循環導航遊標：

if (cur.moveToFirst == false){
    return;
}
int nameColumnIndex = cur.getColumnIndex(People.NAME);
String name = cur.getString(nameColumnIndex);

while (cur.moveToNext()){
    //獲取屬性值
}

使用for循環導航遊標

int nameColumn = cur.getColumnIndex(People.NAME);
int ploneColumn = cur.getColumnIndex(People.NUMBER);

for(cur.moveToFirst();!cur.isAfterLast();cur.moveToNext()){
    String name = cur.getString(nameColumn);
    String phoneNumber = cur.getString(phoneColumn);
}

5、使用Where子句
ContentProvider提供兩種方式來傳遞where子句：
通過URI;

String noteUri = "content://com.google.provider.NotePad.notes.80";
Cursor managedCursor = managedQuery(noteUri,
    projection,//返回的列
    null,//where子句
    Contacts.People.NAME + "ASC"//排序方式
);

通過String子句與一組可替換的字符串數組參數的組合。

String noteUri = "content://com.google.provider.NotePad.notes";
Cursor managedCursor = managedQuery(noteUri,
    projection,//返回的列
    "_id=?",//where子句
    new String[]{80},
    Contacts.People.NAME + "ASC"//排序方式
);

6、插入記錄
android使用ContentValues來保存將插入的單一記錄的值，要插入記錄，由android.content.ContentResolver使用URI插入記錄。下面是個例子：

ContentValues values = new ContentValues();
values.put("title","new Note");
values.put("note","this is a new Note");
ContentResolver cr = activity.getContentResolver();
Uri uri = cr.insert(Notepad.Notes.CONTENT_URI,values);

7、更新和刪除
更新類似插入，方法簽名爲：

int numberOfRowsUpdated = activity.getContentResolver().update(
   Uri uri,
   ContentValues values,
   String whereClause,
   String[] selectionArgs
);

類似的刪除的方法爲：

int numberOfRowsDeleted = activity.getContentResolver().delete(
   Uri uri,
   String whereClause,
   String[] selectionArgs
);

8、下面我們自己實現一個ContentProvider,並進行CRUD操作；
我們將按如下流程來實現：
（1）計劃數據庫、URI、列名稱，創建元數據類來定義所有的這些元數據元素的常量；
（2）擴展抽象類ContentProvider
（3）實現方法：query、insert、update、delete和getType
（4）在描述文件中註冊提供程序
具體代碼如下：
佈局文件：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
<TextView  
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/hello"
    />
</LinearLayout>

元數據類：(NotePad.java)

public class NotePad {
    //授權
    public static final String AUTHORITY = "com.google.provider.NotePad";
    private NotePad(){
        
    }
    public static final class Notes implements BaseColumns{
        private Notes(){
            
        }
        //uri = "content://" + AUTHORITY + "/notes"
        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/notes");
        
        //新的MiMe類型-多個
        public static final String CONTENT_ITEM = "vnd.android.cursor.dir/vnd.google.note";
        //新的MiMe類型-單個
        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/vnd.google.note";
        
        //排序方式
        public static final String DEFAULT_SORT_ORDER = "modified DESC";
        
        //字段
        public static final String TITLE = "title";
        public static final String NOTE = "note";
        public static final String CREATEDDATE = "created";
        public static final String MODIFIEDDATE = "modified";
    }
}

擴展ContentProvider類(NotePadProvider.java)

public class NotePadProvider extends ContentProvider{
    private static final String TAG = "NotePadProvider";
    
    //數據庫名
    private static final String DATABASE_NAME = "notepad.db";
    private static final int DATABASE_VERSION = 2;
    
    //表名
    private static final String TABLE_NAME = "notes";
    private static HashMap<String,String> noteProjectionMap;
    private static final int NOTES = 1;
    private static final int NOTE_ID = 2;
    
    //uri匹配器
    private static final  UriMatcher urimatcher;
    private DatabaseHelper openHelper;
    private static final String CREATE_TABLE = "CREATE TABLE "
                                                    + TABLE_NAME
                                                    + "(" +Notes._ID
                                                    + " INTEGER PRIMARY KEY,"
                                                    + Notes.TITLE + " TEXT,"
                                                    + Notes.NOTE + " TEXT,"
                                                    + Notes.CREATEDDATE + " INTEGER,"
                                                    + Notes.MODIFIEDDATE + " INTEGER" + ")";
    static{
        urimatcher = new UriMatcher(UriMatcher.NO_MATCH);
        urimatcher.addURI(NotePad.AUTHORITY, "notes",NOTES);
        urimatcher.addURI(NotePad.AUTHORITY, "notes/#", NOTE_ID);
        
        //列別名
        noteProjectionMap = new HashMap<String,String>();
        noteProjectionMap.put(Notes._ID,Notes._ID);
        noteProjectionMap.put(Notes.TITLE, Notes.TITLE);
        noteProjectionMap.put(Notes.NOTE, Notes.NOTE);
        noteProjectionMap.put(Notes.CREATEDDATE, Notes.CREATEDDATE);
        noteProjectionMap.put(Notes.MODIFIEDDATE,Notes.MODIFIEDDATE);
    }
    
    private static class DatabaseHelper extends SQLiteOpenHelper{
        public DatabaseHelper(Context context){
            super(context, DATABASE_NAME, null, DATABASE_VERSION);
        }
        //創建表
        @Override
        public void onCreate(SQLiteDatabase db) {
            Log.i(TAG, CREATE_TABLE);
            db.execSQL(CREATE_TABLE);
        }
        //更新數據庫
        @Override
        public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
            db.execSQL("drop table if exists notes");
            onCreate(db);
        }
        
    }
    //刪除數據
    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        
        return 0;
    }
    //獲取MIME類型
    @Override
    public String getType(Uri uri) {
        switch (urimatcher.match(uri)){
            case NOTES:
                return Notes.CONTENT_ITEM;
            case NOTE_ID:
                return Notes.CONTENT_ITEM_TYPE;
            default:
                throw new IllegalArgumentException("Unknow Uri" + uri);
        }
    }

    @Override
    public Uri insert(Uri uri, ContentValues values) {
        if (urimatcher.match(uri) != NOTES){
            throw new IllegalArgumentException("Unknow Uri" + uri);
        }
        ContentValues contentValues;
        if (null != values){
            contentValues = new ContentValues(values);
        }else{
            contentValues = new ContentValues();
        }
        Long now = Long.valueOf(System.currentTimeMillis());
        if (!contentValues.containsKey(NotePad.Notes.CREATEDDATE)){
            contentValues.put(NotePad.Notes.CREATEDDATE, now);
        }
        if (contentValues.containsKey(NotePad.Notes.MODIFIEDDATE) == false){
            contentValues.put(NotePad.Notes.MODIFIEDDATE, now);
        }
        if (contentValues.containsKey(NotePad.Notes.TITLE) == false){
            Resources r = Resources.getSystem();
            contentValues.put(NotePad.Notes.TITLE, r.getString(android.R.string.untitled));
        }
        if (contentValues.containsKey(NotePad.Notes.NOTE) == false){
            contentValues.put(NotePad.Notes.NOTE, "");
        }
        SQLiteDatabase db = openHelper.getWritableDatabase();
        long rowId = db.insert(TABLE_NAME, Notes.NOTE, contentValues);
        System.out.println(rowId);
        if (rowId > 0){
            Uri noteUri = ContentUris.withAppendedId(NotePad.Notes.CONTENT_URI, rowId);
            getContext().getContentResolver().notifyChange(noteUri, null);
            return noteUri;
        }
        throw new SQLException("insert row into failed " + uri);
    }

    @Override
    public boolean onCreate() {
        openHelper = new DatabaseHelper(getContext());
        return false;
    }

    @Override
    public Cursor query(Uri uri, String[] projection, String selection,
            String[] selectionArgs, String sortOrder) {
        SQLiteQueryBuilder qb = new SQLiteQueryBuilder();
        switch (urimatcher.match(uri)){
            case NOTES:
                qb.setTables(TABLE_NAME);
                qb.setProjectionMap(noteProjectionMap);
                break;
            case NOTE_ID:
                qb.setTables(TABLE_NAME);
                qb.setProjectionMap(noteProjectionMap);
                qb.appendWhere(Notes._ID + "=" + uri.getPathSegments().get(1));
                break;
            default:
                throw new IllegalArgumentException("Unknow Uri" + uri);
        }
        String orderBy;
        if (TextUtils.isEmpty(sortOrder)){
            orderBy = NotePad.Notes.DEFAULT_SORT_ORDER;
        }else{
            orderBy = sortOrder;
        }
        SQLiteDatabase db = openHelper.getReadableDatabase();
        Cursor cursor = qb.query(db, projection, selection, selectionArgs, null, null, orderBy);
        cursor.setNotificationUri(getContext().getContentResolver(),uri);
        return cursor;
    }

    @Override
    public int update(Uri uri, ContentValues values, String selection,
            String[] selectionArgs) {
        return 0;
    }
}
活動類(ContentProviderTest.java)
public class ContentProviderTest extends Activity {
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        
        //插入數據
        ContentValues contentValues = new ContentValues();
        contentValues.put(NotePad.Notes.TITLE, "title1");
        contentValues.put(NotePad.Notes.NOTE, "NOTENOTE1");
        getContentResolver().insert(NotePad.Notes.CONTENT_URI, contentValues);
        contentValues.clear();
        contentValues.put(NotePad.Notes.TITLE, "title2");
        contentValues.put(NotePad.Notes.NOTE, "NOTENOTE2");
        getContentResolver().insert(NotePad.Notes.CONTENT_URI, contentValues);
        displayNote();
    }
    private void displayNote(){
        String[] columns = new String[]{NotePad.Notes._ID
                ,NotePad.Notes.TITLE
                ,NotePad.Notes.NOTE
                ,NotePad.Notes.CREATEDDATE
                ,NotePad.Notes.MODIFIEDDATE};
        Uri myUri = NotePad.Notes.CONTENT_URI;
        Cursor cursor = managedQuery(myUri, columns, null, null, null);
        if (cursor.moveToFirst()){
            String id = null;
            String title = null;
            do{
                id = cursor.getString(cursor.getColumnIndex(NotePad.Notes._ID));
                title = cursor.getString(cursor.getColumnIndex(NotePad.Notes.TITLE));
                Toast toast = Toast.makeText(this, "TITLE:" + id + "NOTES" + title, Toast.LENGTH_SHORT);
                toast.setGravity(Gravity.TOP|Gravity.CENTER, 0, 40);
                toast.show();
            }while(cursor.moveToNext());
        }
    }
}

在描述文件中註冊提供程序:AndroidManifest.xml

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

    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <provider android:name="NotePadProvider"
                  android:authorities="com.google.provider.NotePad"/>
        <activity android:name=".ContentProviderTest"
                  android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            <intent-filter>
                <data android:mimeType="vnd.android.cursor.dir/vnd.google.note"></data>
            </intent-filter>
            <intent-filter>
                <data android:mimeType="vnd.android.cursor.item/vnd.google.note"></data>
            </intent-filter>
        </activity>

    </application>
</manifest>

運行結果如下圖所示：

Android數據共享機制ContentProvider

Android簡單聯繫人操作

Android Widget簡單應用之奧運會倒計時

Attributes and custom properties

開發者必須知道的HTML5十五大新特性

Android活動文件夾

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結