2. 程式人生 > >Android四大元件之ContentProvider（一）

Android四大元件之ContentProvider（一）

阿新 • • 發佈：2018-11-23

1.什麼是ContentProvider?

內容提供程式管理對資料結構化資料集的訪問。它們封裝資料，並提供用於定義資料安全性的機制。內容提供者是連線一個程序中的資料與另一個程序中執行的程式碼的標準介面。
是不同應用程式之間進行資料交換的標準API，以某種Uri的形式對外提供資料，允許其他應用訪問或修改資料；其他程式使用ContentResolver根據Uri去訪問操作指定的資料。

是IPC通訊的一種。

2.ContentProvider和ContentResolver

  1. 建立ContentProvider的派生類，重寫必要的方法，方法有：(ContentResolve
    r的方法與它類似)
  • onCreate():當其他程式第一個訪問ContentProvider時回撥此方法。
  • String getType(Uri uri):用於返回當前Uri所代表的MIME型別，如果包含多條資料則返回“vnd.android.cursor.dir/開頭”,單條資料則返回“vnd.android.cursor.item/開頭”，開頭部分格式：vnd.<authority>.<path>
  • insert(Uri uri,ContentValue values):根據該uri插入對應的value值
  • update(Uri uri,…)
    :根據uri修改對應引數條件的所有值
  • delete(Uri uri):根據uri刪除符合引數條件的所有值
  • query(Uri uri):根據uri查詢符合條件的所有值
  1. AndroidManifest.xml檔案中為其註冊
 <provider
            android:name=".contentProvider.MyContentProvider"
            android:authorities="org.wdl.book"
            android:enabled="true"
            android:exported="true"
           />
屬性 意義
android:name 類名
android:authorities 指定相應的域名
android:exported 是否提供給外部程式使用
  1. 客戶端程式通過ContentResolver的一系列方法呼叫ContentProvider提供的API進行資料的CRUD

相對應的流程如圖：
在這裡插入圖片描述
ContentResolver.query()。 query() 方法會某某提供程式所定義的 ContentProvider.query() 方法。 以下程式碼行顯示了 ContentResolver.query() 呼叫：（其他方法類似）

// 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

其中引數與之前SQLite儲存提到的類似，詳見](https://blog.csdn.net/qq_34341338/article/details/84069391)

由上圖可以看出URI在這資料互動的過程中起到了關鍵性(進行資料交換的標識)的作用，因此，該URI所對應的要求如下：`

  1. 以content://開頭，固定不變的
  2. 中間部分為之前xml檔案中配置的android:authorities，固定不變的
  3. 第三部分代表資源部份。這個部分是動態改變，根據訪問者的需求更改
  4. content://authorities/source/#,#代表萬用字元，可以為1，2，3等；content://authorities/*,*代表任意長度字元，表示所有表

分析：
例：
content://org.wdl.provider/books
意味訪問books資料
content://org.wdl.provider/book/2
意味訪問books資料中ID為2的資料
content://org.wdl.provider/book/2/name
意味訪問books資料中ID為2的資料中的name欄位

Uri工具類提供了parse靜態方法，用於將字串轉為Uri

  1. ContentResolver呼叫方法中傳遞的Uri必須能夠與ContentProvider中所暴露Uri的相匹配，否則會丟擲異常。為了確保正常進行資料CRUD，Android提供了UriMatcher工具類：
    void addURI(String authority,String path,int code):向UriMatcher中註冊Uri，authority+path構成Uri，code表示標識碼，根據它來判斷是否能夠進行資料操作
    int match(Uri uri):根據註冊的Uri判斷指定Uri對應的標識碼，匹配不到返回-1
    例：
		matcher = new UriMatcher(UriMatcher.NO_MATCH);
        matcher.addURI(Books.AUTHORITY, "books", MyContentProvider.BOOKS);
        matcher.addURI(Books.AUTHORITY, "book/#", MyContentProvider.BOOK);

		code = matcher.match(uri)

假如現在我有一個需求：
查詢Books中id為2的資料，需對原始的Uri進行拼接，Android為此提供了另一個工具類ContentUris，主要方法如下：

  • withAppendedId(Uri uri,int id):在路徑上拼接ID部分
  • parseId(Uri uri):解析出指定Uri所包含的ID值

例：

ContentUris.withAppendedId(Books.Book.BOOK_CONTENT_URI,1)
拼接後的uri為：content://org.wdl.provider/book/1

 long id = ContentUris.parseId(uri);
 id值為：1

3.詳細使用

MyContentProvider.class

package com.wdl.crazyandroiddemo.contentProvider;

import android.content.ContentProvider;
import android.content.ContentUris;
import android.content.ContentValues;
import android.content.UriMatcher;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.net.Uri;
import android.support.annotation.NonNull;
import android.text.TextUtils;
import android.util.Log;

import com.wdl.crazyandroiddemo.MySQLiteHelper;

import java.util.Objects;

public class MyContentProvider extends ContentProvider {
    private MySQLiteHelper helper;
    private static UriMatcher matcher;
    private static final int BOOKS = 1;
    private static final int BOOK = 2;

    static {
        matcher = new UriMatcher(UriMatcher.NO_MATCH);
        matcher.addURI(Books.AUTHORITY, "books", MyContentProvider.BOOKS);
        matcher.addURI(Books.AUTHORITY, "book/#", MyContentProvider.BOOK);
    }

    public MyContentProvider() {
    }

    @Override
    public boolean onCreate() {
        Log.e("wdl", "----------onCreate----------");
        helper = new MySQLiteHelper(getContext(), "demo.db", null, 3);
        return true;
    }

    @Override
    public int delete(@NonNull Uri uri, String where, String[] whereArgs) {
        Log.e("wdl", "----------delete----------");
        SQLiteDatabase db = helper.getReadableDatabase();
        int num = 0;
        switch (matcher.match(uri)) {
            case BOOKS:
                num = db.delete("book", where, whereArgs);
                break;
            case BOOK:
                long id = ContentUris.parseId(uri);
                String whereClause = Books.Book.ID + "=" + id;
                if (!TextUtils.isEmpty(where)) {
                    whereClause = whereClause + " and " + where;
                }
                num = db.delete("book", whereClause, whereArgs);
                break;
            default:
                throw new IllegalArgumentException("未知uri");
        }
        Objects.requireNonNull(getContext()).getContentResolver().notifyChange(uri, null);
        return num;
    }

    @Override
    public String getType(@NonNull Uri uri) {
        Log.e("wdl", "----------getType----------");
        switch (matcher.match(uri)) {
            case BOOKS:
                return "vnd.android.cursor.dir/wdl.books";
            case BOOK:
                return "vnd.android.cursor.item/wdl.book";
            default:
                throw new IllegalArgumentException("未知uri");
        }

    }

    @Override
    public Uri insert(@NonNull Uri uri, ContentValues values) {
        Log.e("wdl", "----------insert----------");
        //獲取資料庫例項
        SQLiteDatabase db = helper.getReadableDatabase();
        switch (matcher.match(uri)) {
            case BOOKS:
                //插入
                long rowId = db.insert("book", Books.Book.ID, values);
                if (rowId > 0) {
                    //uri末尾新增id
                    Uri bookUri = ContentUris.withAppendedId(uri, rowId);
                    //通知資料已經改變
                    Objects.requireNonNull(getContext()).getContentResolver().notifyChange(bookUri, null);
                    return bookUri;
                }
                break;
            default:
                throw new IllegalArgumentException("Not yet implemented");
        }
        return null;
    }

    @Override
    public Cursor query(@NonNull Uri uri, String[] projection, String selection,
                        String[] selectionArgs, String sortOrder) {
        Log.e("wdl", "----------query----------");
        SQLiteDatabase db = helper.getReadableDatabase();
        switch (matcher.match(uri)) {
            case BOOKS:
                return db.query("book",
                        projection,
                        selection,
                        selectionArgs,
                        null,
                        null, sortOrder);
            case BOOK:
                long id = ContentUris.parseId(uri);
                String whereClause = Books.Book.ID + "=" + id;
                if (!TextUtils.isEmpty(selection)) {
                    whereClause = whereClause + " and " + selection;
                }
                return db.query("book", projection, whereClause, selectionArgs, null, null, sortOrder);
            default:
                throw new IllegalArgumentException("未知uri");
        }
    }

    @Override
    public int update(@NonNull Uri uri, ContentValues values, String selection,
                      String[] selectionArgs) {
        Log.e("wdl", "----------update----------");
        SQLiteDatabase db = helper.getReadableDatabase();
        int num = 0;
        switch (matcher.match(uri)) {
            case BOOKS:
                num = db.update("book", values, selection, selectionArgs);
                break;
            case BOOK:
                long id = ContentUris.parseId(uri);
                String whereClause = Books.Book.ID + "=" + id;
                if (!TextUtils.isEmpty(selection)) {
                    whereClause = whereClause + " and " + selection;
                }
                num = db.update("book", values, whereClause, selectionArgs);
                break;
            default:
                throw new IllegalArgumentException("未知uri");
        }
        Objects.requireNonNull(getContext()).getContentResolver().notifyChange(uri, null);
        return num;
    }


}

Books.class，此類封裝了可訪問Uri以及可訪問的資料列：

package com.wdl.crazyandroiddemo.contentProvider;

import android.net.Uri;
import android.provider.BaseColumns;

/**
 * author：   wdl
 * time： 2018/11/17 13:43
 * des：    TODO
 */
@SuppressWarnings("unused")
public class Books {
    //定義contentProvider 的Authorities值
    public static final String AUTHORITY = "org.wdl.book";

    //定義靜態內部類，定義contentProvider所包含的資料列
    public static final class Book implements BaseColumns {
        //定義所允許操作的三個資料列
        public final static String ID = "id";
        public final static String NAME = "name";
        public final static String PRICE = "price";
        public final static String DATE = "publishdate";

        //定義提供服務的兩個Uri
        public final static Uri BOOKS_CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/books");
        public final static Uri BOOK_CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/book");
    }
}

在Client中呼叫：

package com.wdl.contentproviderclient

import android.content.ContentUris
import android.content.ContentValues
import android.content.Intent
import android.support.v7.app.AppCompatActivity
import android.os.Bundle
import android.util.Log
import kotlinx.android.synthetic.main.activity_main.*
import java.lang.StringBuilder

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        val contentResolver = contentResolver
        btnQuery.setOnClickListener {
            val intent = Intent("com.wdl.mime")
            intent.data = Books.Book.BOOKS_CONTENT_URI
            startActivity(intent)
            val cursor = contentResolver.query(Books.Book.BOOKS_CONTENT_URI
                    ,null,"price=?", arrayOf("50.2"),null)
            //cursor.close()
            val stringBuilder = StringBuilder()
            while (cursor.moveToNext()){
                val id = cursor.getInt(cursor.getColumnIndexOrThrow(Books.Book.ID))
                val name = cursor.getString(cursor.getColumnIndexOrThrow(Books.Book.NAME))
                val price = cursor.getInt(cursor.getColumnIndexOrThrow(Books.Book.PRICE))
                stringBuilder.append("id=$id,name=$name,price=$price \n")
            }
            cursor.close()
            Log.e("wdl",stringBuilder.toString())
        }
        btnDelete.setOnClickListener {
            //val index = contentResolver.delete(uri,null,null)
            val index = contentResolver.delete(Books.Book.BOOKS_CONTENT_URI,"price=?", arrayOf("55.2"))

            Log.e("wdl",""+index)
        }
        btnInsert.setOnClickListener {
            val value = ContentValues()
            value.put(Books.Book.NAME,"smwdl")
            value.put(Books.Book.PRICE,50.2)
            val uri = contentResolver.insert(Books.Book.BOOKS_CONTENT_URI,value)
            Log.e("wdl",uri.toString())
        }
        btnUpdate.setOnClickListener {
            val value = ContentValues()
            value.put(Books.Book.PRICE,55.2)
            val uri = ContentUris.withAppendedId(Books.Book.BOOK_CONTENT_URI,1)
            val index = contentResolver.update(uri
                    ,value,"name like ?", arrayOf("smwdl"))
            Log.e("wdl",""+index)
        }
    }
}

注意事項：

  1. 在MyContentPrivoder中實現的CRUD方法，都需要通過uri判斷，根據match返回值來執行對應的方法。例如：
switch (matcher.match(uri)) {
            case BOOKS:
                return db.query("book",
                        projection,
                        selection,
                        selectionArgs,
                        null,
                        null, sortOrder);
            case BOOK:
                long id = ContentUris.parseId(uri);
                String whereClause = Books.Book.ID + "=" + id;
                if (!TextUtils.isEmpty(selection)) {
                    whereClause = whereClause + " and " + selection;
                }
                return db.query("book", projection, whereClause, selectionArgs, null, null, sortOrder);
            default:
                throw new IllegalArgumentException("未知uri");
        }

上段程式碼中，對匹配碼做出了判斷，並進行區分處理：Books代表對所有資料進行操作，Book代表對單項資料進行操作。而單項資料進行操作的化需要進行SQL語句的拼接。通常為新增ID。

  1. 在static靜態程式碼塊中需進行UriMatcher的註冊
  2. 許可權宣告，在清單檔案中配置相對應的讀寫許可權。系統自帶的ContentProvider需進行其他許可權的宣告。在6.0之後需動態的申請所需許可權，否則無法進行資料的CRUD
  3. 在insert,update,delete之後都必須進行getContext().getContentResolver().notifyChange(uri, null)進行資料改變的響應

相關推薦

Android四大元件之ContentProvider（一）

1.什麼是ContentProvider? 內容提供程式管理對資料結構化資料集的訪問。它們封裝資料，並提供用於定義資料安全性的機制。內容提供者是連線一個程序中的資料與另一個程序中執行的程式碼的標準介面。 是不同應用程式之間進行資料交換的標準API，以某種Uri的形式對外提供資料，

Android--四大元件之Activity（一）

####1. Activity是什麼？ ####2. 生命週期 ######1). Activity跳轉 ######2). 從後臺啟動 ######3). 橫豎屏切換 ####3. 啟動模式 ######1). 任務棧 ######2). laucherMode ######3).

Android四大元件之ContentProvider（二）

上節提到的四大元件之ContentProvider的簡單使用，在這篇文章中詳細的介紹其中的一些方法。 1.String getType(Uri uri)方法 首先看看官方對它的解釋： /** * Implement this to handle requests

Android四大元件之ContentProvider（內容提供者）

ContentProvider是什麼 ContentProvider是Android中的四大元件之一，主要用於不用應用之間共享資料，通過ContentProvider把應用中的資料共享給其他應用訪問，其他應用可以通過ContentProvider對指定應用中

Android 控制元件之 RecyclerView（一）—— 載入檢視和佈局選擇

本文目錄 一、概述 二、列表檢視的處理 1. item 的佈局檔案 2. 構造 Adapter 類 3. 佈局管理器 1）LinearLayoutManager 2）GridLayoutManager

Android:四大元件之-----廣播（Broadcast）

相信很多讀者都與筆者一樣，在剛學安卓的時候就接觸到廣播。但是並不知道廣播其實也分好幾種，我們剛學習使用的只是廣播的其中一種：普通廣播 android的廣播分為： 普通廣播， 有序廣播， 本地廣播， sticky廣播， 下面就為大家介紹一下這四種廣播的區別與用法。 一.普通

Android四大元件之BroadcastReceiver（下）

（一）概述 上節我們對BroadcastReceiver已經有了一個初步的瞭解了，知道兩種廣播型別：標準與有序， 動態或靜態註冊廣播接收者，監聽系統廣播，自己傳送廣播！已經滿足我們的基本需求了~ 但是前面寫的廣播都是全域性廣播！這同樣意味著我們APP發出的廣播

Android四大元件之BroadcastReceiver（廣播）

什麼是廣播 廣播是一個全域性的監聽器，屬於Android四大元件之一，它分為兩個角色：廣播發送者、廣播接收者 廣播用於不同元件之間（應用內/不同應用之間），還有多執行緒之間的通訊 - 廣播的

Android四大元件之 Activity（上）

（一）概述 本節開始講解Android的四大元件之一的Activity(活動)； 官方文件： Activity是一個應用程式的元件，他在螢幕上提供了一個區域，允許使用者在上面做一些互動性的操作， 比如打電話，照相，傳送郵件，或者顯示一個地圖！Activit

Android--四大元件之BroadCastReceiver（生命週期、實現原理及使用等）

####1. BroadCastReceiver是什麼？ ####2. 廣播型別 ######1). 有序廣播 ######2). 無序廣播 ####3. 生命週期 ####4. 實現原理 ####5. 使用方法 ####6. 許可權問題(安全性) ####7. LocalBroad

Android 基礎知識——四大元件之Activity（二）

今天我們來探討一下activity有什麼啟動模式，都有什麼特點呢，且看下面分析 1.Task以及back stack     >Task(任務)  為了完成一個功能  多個Activity的集合,     當你的應用程式啟動時 系統會自動建立Task用於管理Activ

Android控制元件之ListView（初識）

ListView 控制元件可使用四種不同檢視顯示專案。通過此控制元件，可將專案組成帶有或不帶有列標頭的列，並顯示伴隨的圖示和文字。 ListView有四種模式： 其作用是新增選擇按鈕框。 設定單選框 Lv.setChoiceMode(ListView.CHOICE_MOD

Android四大元件之ContentProvider

關於ContentProvider ContentProvider，被稱為內容提供者，通過Binder向其他元件以及其他應用提供資料。以某種Uri的形式對外提供資料，允許其他應用訪問或修改資料。其他應用程式使用ContentResolver根據Uri去訪問操作

Android四大元件之ContentProvider詳解

1.適用場景 1) ContentProvider為儲存和讀取資料提供了統一的介面 2) 使用ContentProvider，應用程式可以實現資料共享 3) android內建的許多資料都是使用ContentProvider形式，供開發者呼叫的(如視訊，音訊，圖片，

Android 四大元件之" ContentProvider "

前言 ContentProvider作為Android的四大元件之一，是屬於需要掌握的基礎知識，可能在我們的應用中，對於Activity和Service這兩個元件用的很常見，瞭解的也很多，但是對ContentProvider所知卻甚少，所以有必要去整理歸納下其中的內容，講講為什麼要用ContentProvid

android M Launcher之LauncherModel （一）

眾所周知 LauncherModel在Launcher中所佔的位置，它相當於Launcher的資料中心，Launcher的桌面以及應用程式選單中所需的資料像 桌面小部件的資訊、快捷方式資訊、檔案資訊、以及一些比較特殊的桌面頁的資訊等都是由它提供，因此我們這裡來分析下LauncherMod

Android進階之路（一） -- AS 3.0NDK環境搭建及hello world

通過一段找實習的經歷，以及快應用、小程式、web app等移動開發模式的衝擊，深深為安卓原生開發的未來感到擔憂，希望接入人工智慧API和物聯網井噴能給安卓開發帶來新的生機吧。當然，作為小白我是不用擔心這麼多的，做自己喜歡的事就好了，於是拋開雜念，繼續學習安卓。NDK開發環境的

Android四大元件之ContentProvider內容提供器

public class MyProvider extends ContentProvider{ public static final int TABLE1_DIR = 0; public static final int TABLE1_ITEM = 1; public s

小談Android四大元件之ContentProvider

內容提供者的作用 1.應用程式建立的資料庫預設都是私有的,別的應用程式不可以訪問裡面的資料. 2.如果需要把自己應用程式私有的資料庫暴露給別的使用者增刪改查,就需要使用內容提供者. 3.作用: 一個應用程式訪問另外一個應用程式在硬碟上

Android四大元件之ContentProvider-劉志遠-專題視訊課程

Android四大元件之ContentProvider—4971人已學習 課程介紹        本課程向大家講述Android中的四大元件之一ContentProvider（內容提供者）課程收益    學員學習之後，能夠吃透ContentProvier講師介紹    劉志遠