2. 程式人生 > >Android ContentProvider基本用法

Android ContentProvider基本用法

阿新 • • 發佈：2018-02-23
truct 數據共享 implement notify username 資源 per mime類型 exc

轉自：https://www.jianshu.com/p/601086916c8f

一、基本概念

ContentProvider是Android系統中提供的專門用戶不同應用間進行數據共享的組件，提供了一套標準的接口用來獲取以及操作數據，準許開發者把自己的應用數據根據需求開放給其他應用進行增刪改查，而無須擔心直接開放數據庫權限而帶來的安全問題。系統預置了許多ContentProvider用於獲取用戶數據，比如消息、聯系人、日程表等。

二、ContentResolver

在ContentProvider的使用過程中，需要借用ContentResolver來控制ContentProvider所暴露處理的接口，作為代理來間接操作ContentProvider以獲取數據。

在 Context.java 的源碼中如下抽象方法

    /** Return a ContentResolver instance for your application‘s package. */
    public abstract ContentResolver getContentResolver();

所以可以在所有繼承Context的類中通過 getContentResovler() 方法獲取ContentResolver

ContentResolver contentResolver = getContentResovler();

ContentProvider中的幾個抽象方法在ContentResolver中均有著一一對應的同名方法

三、繼承ContentProvider

創建一個自定義ContentProvider的方式是繼承ContentProvider類並實現其六個抽象方法
例如

public class MyContentProvider extends ContentProvider {

    public MyContentProvider() {
    }

    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        // Implement this to handle requests to delete one or more rows.
        throw new UnsupportedOperationException("Not yet implemented");
    }

    @Override
    public String getType(Uri uri) {
        // TODO: Implement this to handle requests for the MIME type of the data
        // at the given URI.
        throw new UnsupportedOperationException("Not yet implemented");
    }

    @Override
    public Uri insert(Uri uri, ContentValues values) {
        // TODO: Implement this to handle requests to insert a new row.
        throw new UnsupportedOperationException("Not yet implemented");
    }

    @Override
    public boolean onCreate() {
        // TODO: Implement this to initialize your content provider on startup.
        return false;
    }

    @Override
    public Cursor query(Uri uri, String[] projection, String selection,
                        String[] selectionArgs, String sortOrder) {
        // TODO: Implement this to handle query requests from clients.
        throw new UnsupportedOperationException("Not yet implemented");
    }

    @Override
    public int update(Uri uri, ContentValues values, String selection,
                      String[] selectionArgs) {
        // TODO: Implement this to handle requests to update one or more rows.
        throw new UnsupportedOperationException("Not yet implemented");
    }
    
}

之後，需要在AdnroidManifest.xml中對ContentProvider進行註冊

        <provider
            android:name=".MyContentProvider"
            android:authorities="com.czy.contentprovideremo.MyContentProvider"
            android:exported="true" />
  • name：ContentProvider的全稱類名
  • authorities：唯一標識了一個ContentProvider，外部應用通過該屬性值來訪問我們的ContentProvider。因此該屬性值必須是唯一的，建議在命名時以包名為前綴
  • exported：表明是否允許其他應用調用ContentProvider，true表示支持，false表示不支持。默認值根據開發者的屬性設置而會有所不同，如果包含 Intent-Filter 則默認值為true，否則為false

ContentProvider的六個抽象方法的含義分別是：

  • onCreate()：代表ContentProvider的創建，可以用來進行一些初始化操作
  • getType(Uri uri)：用來返回一個Uri請求所對應的MIME類型
  • insert(Uri uri, ContentValues values)：插入數據
  • query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)：查詢數據
  • update(Uri uri, ContentValues values, String selection, String[] selectionArgs)：更新數據
  • delete(Uri uri, String selection, String[] selectionArgs)：刪除數據

四、URI

觀察MyContentProvider中的幾個方法，可以發現除了 onCreate() 方法外，其它五個抽象方法都包含了一個Uri（統一資源標識符）參數，通過這個對象可以來匹配對應的請求。
URI 代表了要操作的數據對象，主要包含了兩部分信息：

  • 需要操作的哪個ContentProvider
  • 對ContentProvider中的哪些數據進行操作

一個URI由以下幾個部分組成：

  • Scheme：ContentProvider的Scheme被規定為“content://”
  • Authority：用於唯一標識某個ContentProvider，外部調用者根據這個標識來指定要操作的ContentProvider
  • Path：用來標識要操作的具體數據

比如，ContentProvider中操作的數據可以都是從SQLite數據庫中獲取的，而數據庫中可能存在許多張表，這時候就需要用到Uri來表明是要操作哪個數據庫、操作數據庫的哪張表了
那麽如何確定一個Uri是要執行哪項操作呢？這裏需要用到UriMatcher來幫助ContentProvider匹配Uri，它僅包含了兩個方法：

  • addURI(String authority, String path, int code)：用於向UriMatcher對象註冊Uri。authtity是在AndroidManifest.xml中註冊的ContentProvider的authority屬性值；path表示一個路徑，可以設置為通配符，#表示任意數字，*表示任意字符；兩者組合成一個Uri，而code則代表該Uri對應的標識碼
  • match(Uri uri)：匹配傳入的Uri。返回addURI()方法中傳遞的code參數，如果找不到匹配的標識碼則返回-1

五、小Demo

這裏來做一個小Demo，自定義一個ContentProvider，然後向其寫入和讀取數據
使用SQLite作為ContentProvider的數據存儲地址和數據來源，因此需要先建立一個SQLiteOpenHelper
創建一個名為"book.db"的數據庫，包含“book”和“user”兩張表

/**
 * 作者： 葉應是葉
 * 時間： 2017/4/3 12:07
 * 描述：
 */
public class DbOpenHelper extends SQLiteOpenHelper {

    //數據庫名
    private static final String DATA_BASE_NAME = "book.db";

    //數據庫版本號
    private static final int DATE_BASE_VERSION = 1;

    //表名-書
    public static final String BOOK_TABLE_NAME = "book";

    //表名-用戶
    public static final String USER_TABLE_NAME = "user";

    //創建表-書（兩列：主鍵自增長、書名）
    private final String CREATE_BOOK_TABLE = "create table " + BOOK_TABLE_NAME
            + "(_id integer primary key autoincrement, bookName text)";

    //創建表-用戶（三列：主鍵自增長、用戶名、性別）
    private final String CREATE_USER_TABLE = "create table " + USER_TABLE_NAME
            + "(_id integer primary key autoincrement, userName text, sex text)";

    public DbOpenHelper(Context context) {
        super(context, DATA_BASE_NAME, null, DATE_BASE_VERSION);
    }

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

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

    }

}

自定義ContentProvider
當中，getTableName(Uri uri)方法用於判定Uri指向的數據庫表名
然後在initProviderData()方法中向數據庫插入一些原始數據

public class BookProvider extends ContentProvider {

    private Context context;

    private SQLiteDatabase sqLiteDatabase;

    public static final String AUTHORITY = "com.czy.contentproviderdemo.BookProvider";

    public static final int BOOK_URI_CODE = 0;

    public static final int USER_URI_CODE = 1;

    private static final UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);

    static {
        uriMatcher.addURI(AUTHORITY, DbOpenHelper.BOOK_TABLE_NAME, BOOK_URI_CODE);
        uriMatcher.addURI(AUTHORITY, DbOpenHelper.USER_TABLE_NAME, USER_URI_CODE);
    }

    private String getTableName(Uri uri) {
        String tableName = null;
        switch (uriMatcher.match(uri)) {
            case BOOK_URI_CODE:
                tableName = DbOpenHelper.BOOK_TABLE_NAME;
                break;
            case USER_URI_CODE:
                tableName = DbOpenHelper.USER_TABLE_NAME;
                break;
        }
        return tableName;
    }

    public BookProvider() {

    }

    @Override
    public boolean onCreate() {
        context = getContext();
        initProviderData();
        return false;
    }

    //初始化原始數據
    private void initProviderData() {
        sqLiteDatabase = new DbOpenHelper(context).getWritableDatabase();
        sqLiteDatabase.beginTransaction();
        ContentValues contentValues = new ContentValues();
        contentValues.put("bookName", "數據結構");
        sqLiteDatabase.insert(DbOpenHelper.BOOK_TABLE_NAME, null, contentValues);
        contentValues.put("bookName", "編譯原理");
        sqLiteDatabase.insert(DbOpenHelper.BOOK_TABLE_NAME, null, contentValues);
        contentValues.put("bookName", "網絡原理");
        sqLiteDatabase.insert(DbOpenHelper.BOOK_TABLE_NAME, null, contentValues);
        contentValues.clear();

        contentValues.put("userName", "葉");
        contentValues.put("sex", "女");
        sqLiteDatabase.insert(DbOpenHelper.USER_TABLE_NAME, null, contentValues);
        contentValues.put("userName", "葉葉");
        contentValues.put("sex", "男");
        sqLiteDatabase.insert(DbOpenHelper.USER_TABLE_NAME, null, contentValues);
        contentValues.put("userName", "葉應是葉");
        contentValues.put("sex", "男");
        sqLiteDatabase.insert(DbOpenHelper.USER_TABLE_NAME, null, contentValues);
        sqLiteDatabase.setTransactionSuccessful();
        sqLiteDatabase.endTransaction();
    }

    @Override
    public String getType(Uri uri) {
        return null;
    }

    @Override
    public Uri insert(Uri uri, ContentValues values) {
        String tableName = getTableName(uri);
        if (tableName == null) {
            throw new IllegalArgumentException("Unsupported URI:" + uri);
        }
        sqLiteDatabase.insert(tableName, null, values);
        context.getContentResolver().notifyChange(uri, null);
        return uri;
    }

    @Override
    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
        String tableName = getTableName(uri);
        if (tableName == null) {
            throw new IllegalArgumentException("Unsupported URI:" + uri);
        }
        return sqLiteDatabase.query(tableName, projection, selection, selectionArgs, null, null, sortOrder, null);
    }

    @Override
    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
        String tableName = getTableName(uri);
        if (tableName == null) {
            throw new IllegalArgumentException("Unsupported URI:" + uri);
        }
        int row = sqLiteDatabase.update(tableName, values, selection, selectionArgs);
        if (row > 0) {
            context.getContentResolver().notifyChange(uri, null);
        }
        return row;
    }

    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        String tableName = getTableName(uri);
        if (tableName == null) {
            throw new IllegalArgumentException("Unsupported URI:" + uri);
        }
        int count = sqLiteDatabase.delete(tableName, selection, selectionArgs);
        if (count > 0) {
            context.getContentResolver().notifyChange(uri, null);
        }
        return count;
    }

}

註冊ContentProvider

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

然後分別操作book和user兩張表，向其插入一條數據後Log輸出所有的數據

public class MainActivity extends AppCompatActivity {

    private final String TAG = "MainActivity";

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

        Uri bookUri = Uri.parse("content://com.czy.contentproviderdemo.BookProvider/book");
        ContentValues contentValues = new ContentValues();
        contentValues.put("bookName", "叫什麽名字好呢");
        getContentResolver().insert(bookUri, contentValues);
        Cursor bookCursor = getContentResolver().query(bookUri, new String[]{"_id", "bookName"}, null, null, null);
        if (bookCursor != null) {
            while (bookCursor.moveToNext()) {
                Log.e(TAG, "ID:" + bookCursor.getInt(bookCursor.getColumnIndex("_id"))
                        + "  BookName:" + bookCursor.getString(bookCursor.getColumnIndex("bookName")));
            }
            bookCursor.close();
        }

        Uri userUri = Uri.parse("content://com.czy.contentproviderdemo.BookProvider/user");
        contentValues.clear();
        contentValues.put("userName", "葉葉葉");
        contentValues.put("sex", "男");
        getContentResolver().insert(userUri, contentValues);
        Cursor userCursor = getContentResolver().query(userUri, new String[]{"_id", "userName", "sex"}, null, null, null);
        if (userCursor != null) {
            while (userCursor.moveToNext()) {
                Log.e(TAG, "ID:" + userCursor.getInt(userCursor.getColumnIndex("_id"))
                        + "  UserName:" + userCursor.getString(userCursor.getColumnIndex("userName"))
                        + "  Sex:" + userCursor.getString(userCursor.getColumnIndex("sex")));
            }
            userCursor.close();
        }
    }

}

得到的輸出結果是：

04-03 16:54:34.010 25151-25151/com.czy.contentproviderdemo E/MainActivity: ID:1  BookName:數據結構
04-03 16:54:34.010 25151-25151/com.czy.contentproviderdemo E/MainActivity: ID:2  BookName:編譯原理
04-03 16:54:34.010 25151-25151/com.czy.contentproviderdemo E/MainActivity: ID:3  BookName:網絡原理
04-03 16:54:34.010 25151-25151/com.czy.contentproviderdemo E/MainActivity: ID:4  BookName:叫什麽名字好呢
04-03 16:54:34.018 25151-25151/com.czy.contentproviderdemo E/MainActivity: ID:1  UserName:葉  Sex:女
04-03 16:54:34.018 25151-25151/com.czy.contentproviderdemo E/MainActivity: ID:2  UserName:葉葉  Sex:男
04-03 16:54:34.018 25151-25151/com.czy.contentproviderdemo E/MainActivity: ID:3  UserName:葉應是葉  Sex:男
04-03 16:54:34.018 25151-25151/com.czy.contentproviderdemo E/MainActivity: ID:4  UserName:葉葉葉  Sex:男

六、獲取聯系人信息

獲取聯系人列表

public void showContacts(View view) {
        ContentResolver contentResolver = getContentResolver();
        Cursor cursor = contentResolver.query(ContactsContract.Contacts.CONTENT_URI, null, null, null, null);
        if (cursor == null) {
            tv_contacts.setText("顯示聯系人錯誤");
            return;
        }
        StringBuilder stringBuilder = new StringBuilder();
        while (cursor.moveToNext()) {
            stringBuilder.append("ID：");
            String contactId = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts._ID));
            stringBuilder.append(contactId);

            stringBuilder.append("\t\t");
            stringBuilder.append("名字：");
            String contactName = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
            stringBuilder.append(contactName);

            // 根據聯系人ID查詢對應的電話號碼
            Cursor phonesCursor = contentResolver.query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
                    null, ContactsContract.CommonDataKinds.Phone.CONTACT_ID + " = " + contactId, null, null);
            // 取得電話號碼(可能會存在多個號碼)
            if (phonesCursor != null) {
                stringBuilder.append("\t\t");
                stringBuilder.append("號碼：");
                while (phonesCursor.moveToNext()) {
                    String phoneNumber = phonesCursor.getString(phonesCursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
                    stringBuilder.append(phoneNumber);
                    stringBuilder.append("\n");
                }
                phonesCursor.close();
            }
        }
        cursor.close();
        tv_contacts.setText(stringBuilder.toString());
    }

添加指定名字的聯系人

 public void addContact(View view) {
        ContentValues values = new ContentValues();
        //首先向RawContacts.CONTENT_URI執行一個空值插入，目的是獲取系統返回的rawContactId
        Uri rawContactUri = getContentResolver().insert(ContactsContract.RawContacts.CONTENT_URI, values);
        long rawContactId = ContentUris.parseId(rawContactUri);
        //往data表入姓名數據
        values.clear();
        values.put(ContactsContract.Data.RAW_CONTACT_ID, rawContactId);
        values.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE);
        values.put(ContactsContract.CommonDataKinds.StructuredName.GIVEN_NAME, "葉應是葉");
        getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
        //往data表入電話數據
        values.clear();
        values.put(android.provider.ContactsContract.Contacts.Data.RAW_CONTACT_ID, rawContactId);
        values.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE);
        values.put(ContactsContract.CommonDataKinds.Phone.NUMBER, "19950724");
        values.put(ContactsContract.CommonDataKinds.Phone.TYPE, ContactsContract.CommonDataKinds.Phone.TYPE_MOBILE);
        getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
        //往data表入Email數據
        values.clear();
        values.put(android.provider.ContactsContract.Contacts.Data.RAW_CONTACT_ID, rawContactId);
        values.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE);
        values.put(ContactsContract.CommonDataKinds.Email.DATA, "[email protected]");
        values.put(ContactsContract.CommonDataKinds.Email.TYPE, ContactsContract.CommonDataKinds.Email.TYPE_WORK);
        getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
    }

需要添加聯系人讀寫權限

    <uses-permission android:name="android.permission.READ_CONTACTS" />
    <uses-permission android:name="android.permission.WRITE_CONTACTS" />

這裏提供示例代碼下載：Android ContentProvider基本用法



作者：葉應是葉
鏈接：https://www.jianshu.com/p/601086916c8f
來源：簡書
著作權歸作者所有。商業轉載請聯系作者獲得授權，非商業轉載請註明出處。

Android ContentProvider基本用法

相關推薦

Android ContentProvider基本用法

truct 數據共享 implement notify username 資源 per mime類型 exc 轉自：https://www.jianshu.com/p/601086916c8f 一、基本概念 ContentProvider是Android系統中提

Android startActivityForResult基本用法

startActivityForResult和startActivity的區別是一個是帶值傳輸，一個是直接跳轉 具體用法如下： activity_main： <RelativeLayout xm

Android ContentProvider 基本原理和使用詳解

ContentProvider（內容提供者）是 Android 的四大元件之一，管理 Android 以結構化方式存放的資料，以相對安全的方式封裝資料（表）並且提供簡易的處理機制和統一的訪問介面供其他程式呼叫。 Android 的資料儲存方式總共有五種，分別是：Shared Preferences、網路儲

Android屬性動畫完全解析(上)，初識屬性動畫的基本用法

fcm 操作 fad 擴展性 改變 內部使用 如果 轉載 @override 轉載請註明出處：http://blog.csdn.net/guolin_blog/article/details/43536355 在手機上去實現一些動畫效果算是件比較炫酷的事情，因此Andr

android AndoridManifest.xml 一些基本用法

AndoridManifest.xml 是一個xml 具體是什麼東西 百度比我解釋的好 我這邊只是一些常用的用法 首先上下程式碼 在這裡插入程式碼片 <application android:allowBackup="true"

Android 操作SQLite基本用法

一.SQLite的介紹 1.SQLite簡介 SQLite是一款輕型的資料庫，是遵守ACID的關聯式資料庫管理系統，它的設計目標是嵌入  式的，而且目前已經在很多嵌入式產品中使用了它，它佔用資源非常的低，在嵌入式裝置中，可能只需要幾百K的記憶體就夠了。它能夠支援 Window

Android-Toast（吐司）的基本用法

吐司(Toast) Android用於提示資訊的一個控制元件——Toast(吐司)！ Toast是一個包含小資訊的提示框。會自動消失。（並不干擾使用者操作） Toast繼承樹 java.lang.object 派生出 android.widget.Toast 建立T

Android中Gesture手勢的基本用法（總結）

應用場景： （1）左右上下滑動螢幕的事件監聽。比如，上拉彈出自定義的底部佈局之類的，換頁之類的等等。 （2）畫一些不規則的幾何圖形。 執行順序： 1.手指觸碰螢幕時，觸發MotionEvent事件！ 2.該事件被OnTouchListener監聽，可在它的onTo

Android之Retrofit基本用法篇

1.Retrofit基本用法 1.初始化 webInterface = new Retrofit.Builder() .baseUrl(hostname) .client(client)//這

Android資料庫高手祕籍 二 建立表和LitePal的基本用法

                上一篇文章中我們學習了一些Android資料庫相關的基礎知識，和幾個頗為有用的SQLite命令，都是直接在命令列操作的。但是我們都知道，資料庫是要和程式結合在一起使用的，單獨對一個數據庫去進行増刪改查操作並沒有什麼意義，因此今天我們就來學習一下如何在Android程式當中去操作

【Android】屬性動畫（基本用法）

1、前言 在我們體驗一款APP時，炫酷的動畫往往能讓使用者體驗大幅度提升。想當年我剛學Android的時候，無意中看到蘑菇街購物車的動畫效果，把我給激動得，非要在自己的APP中加入那動畫，記得當時用費了好大的勁...不提了，說多了都是淚... 先了解下，目前可以實現動畫的

Android開發——線性佈局和TextView基本用法

Android開發——線性佈局和TextView的基本用法 一、線性佈局－LinearLayout 在LinearLayout這個控制元件中，有這許多屬性可以設定，下面是最為基礎的屬性 <LinearLayout android:layout_wid

Contentprovider的基本用法

在前兩年的開發中我們是很少看到ContentProvider的情況，但隨著社會的進步資料化的東西越來越多，進而需要各種資料訪問也就越來越多。android提供了ContentProvider來應對不同應用間的資料訪問。下面我們就對ContentProvider進

Android圖片載入框架最全解析（一），Glide的基本用法

現在Android上的圖片載入框架非常成熟，從最早的老牌圖片載入框架UniversalImageLoader，到後來Google推出的Volley，再到後來的新興軍Glide和Picasso，當然還有Facebook的Fresco。每一個都非常穩定，功能也都十分強大。但是它們

Android圖片載入框架最全解析（一）Glide的基本用法

現在Android上的圖片載入框架非常成熟，從最早的老牌圖片載入框架UniversalImageLoader，到後來Google推出的Volley，再到後來的新興軍Glide和Picasso，當然還有Facebook的Fresco。每一個都非常穩定，功能也都

Android 屬性動畫詳解，屬性動畫基本用法！

Hello，大家好，今天要給大家講的是Android 屬性動畫詳解！ 在Tween動畫的討論中，我們提到在Android中動畫可以分為三類：①幀動畫②Tween(補間動畫)③Property Anim

Android ，SQLite基本用法

在Android開發中SQLite起著很重要的作用，網上SQLite的教程有很多很多，不過那些教程大多數都講得不是很全面。本人總結了一些SQLite的常用的方法，藉著論壇的大賽，跟大家分享分享的。 一.SQLite的介紹 1.SQLite簡介 SQLit

Android圖片載入框架Glide的基本用法

那麼本篇文章是這個系列的第一篇文章，我們先來了解一下Glide的基本用法吧。 開始 Glide是一款由Bump Technologies開發的圖片載入框架，使得我們可以在Android平臺上以極度簡單的方式載入和展示圖片。 目前，Glide最新的穩定版

（郭霖）Android圖片載入框架最全解析（一），Glide的基本用法

本文同步發表於我的微信公眾號，掃一掃文章底部的二維碼或在微信搜尋 郭霖 即可關注，每天都有文章更新。 現在Android上的圖片載入框架非常成熟，從最早的老牌圖片載入框架UniversalImageLoader，到後來Google推出的Volley，再到後來的新興軍Glide和Picas

Android控制元件RecyclerView的基本用法

　　RecyclerView是Android提供的一個功能強大的滾動控制元件，是增強版的ListView和GridView，不僅可以輕鬆實現和ListView相同的效果，還優化了ListView中存在的各種不足之處；目前Android官方更加推薦使用Recycl