Android学习技术馆之：Android - 内容提供者

我会带着你远行 2022-01-21 05:51 256阅读 0赞

目前，Android - 内容提供者普遍被大众认识和使用，当我们处于新时代背景的浪潮下，就必须依靠自己的努力来为技术的再一次革新做出贡献，哪怕辛苦也是值得的，大家一起努力吧！！！

内容提供者组件通过请求从一个应用程序向其他的应用程序提供数据。这些请求由类 ContentResolver 的方法来处理。内容提供者可以使用不同的方式来存储数据。数据可以被存放在数据库，文件，甚至是网络。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5cTE5OTU_size_16_color_FFFFFF_t_70][]

有时候需要在应用程序之间共享数据。这时内容提供者变得非常有用。

内容提供者可以让内容集中，必要时可以有多个不同的应用程序来访问。内容提供者的行为和数据库很像。你可以查询，编辑它的内容，使用 insert()， update()， delete() 和 query() 来添加或者删除内容。多数情况下数据被存储在 SQLite 数据库。

内容提供者被实现为类 ContentProvider 类的子类。需要实现一系列标准的 API，以便其他的应用程序来执行事务。

public class MyApplication extends  ContentProvider {
    
    }

## 内容URI ##

要查询内容提供者，你需要以如下格式的URI的形式来指定查询字符串：

以下是URI中各部分的具体说明：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5cTE5OTU_size_16_color_FFFFFF_t_70 1][]

## 创建内容提供者 ##

这里描述创建自己的内容提供者的简单步骤。

*  首先，你需要继承类 ContentProviderbase 来创建一个内容提供者类。
 *  其次，你需要定义用于访问内容的你的内容提供者URI地址。
 *  接下来，你需要创建数据库来保存内容。通常，Android 使用 SQLite 数据库，并在框架中重写 onCreate() 方法来使用 SQLiteOpenHelper 的方法创建或者打开提供者的数据库。当你的应用程序被启动，它的每个内容提供者的 onCreate() 方法将在应用程序主线程中被调用。
 *  最后，使用<provider.../>标签在 AndroidManifest.xml 中注册内容提供者。

以下是让你的内容提供者正常工作，你需要在类 ContentProvider 中重写的一些方法：

![20190608144406304.png][]

*  onCreate():当提供者被启动时调用。
 *  query():该方法从客户端接受请求。结果是返回指针(Cursor)对象。
 *  insert():该方法向内容提供者插入新的记录。
 *  delete():该方法从内容提供者中删除已存在的记录。
 *  update():该方法更新内容提供者中已存在的记录。
 *  getType():该方法为给定的URI返回元数据类型。

## 实例 ##

该实例解释如何创建自己的内容提供者。让我们按照下面的步骤：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5cTE5OTU_size_16_color_FFFFFF_t_70 2][]

下面是修改的主要活动文件 src/cn.uprogrammer.contentprovider/MainActivity.java 的内容。该文件包含每个基础的生命周期方法。我们添加了两个新的方法，onClickAddName() 和 onClickRetrieveStudents() 来让应用程序处理用户交互。

package cn.uprogrammer.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 cn.uprogrammer.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());
            }
        }
    }

在包cn.uprogrammer.contentprovider下创建新的文件StudentsProvider.java。以下是src/cn.uprogrammer.contentprovider/StudentsProvider.java的内容。

package cn.uprogrammer.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="cn.uprogrammer.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="cn.uprogrammer.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文件的内容：

确保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。打开你的项目中的活动文件，点击工具栏中的![图片][eclipse_run.png]图标来在 Android Studio 中运行应用程序。Android Studio 在 AVD 上安装应用程序并启动它。如果一切顺利，将在模拟器窗口上显示如下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5cTE5OTU_size_16_color_FFFFFF_t_70 3][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5cTE5OTU_size_16_color_FFFFFF_t_70 4][]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5cTE5OTU_size_16_color_FFFFFF_t_70]: /images/20220121/8d1d400011864f22a140febe93ec1bd3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5cTE5OTU_size_16_color_FFFFFF_t_70 1]: /images/20220121/72dcc103ebbd43698a1123451fdf65f4.png
[20190608144406304.png]: /images/20220121/8501ffe2d4d44fc69548650c5b55d511.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5cTE5OTU_size_16_color_FFFFFF_t_70 2]: /images/20220121/2421022dd8dd43fb9ea5e26cb7155105.png
[eclipse_run.png]: /images/20220121/bb5182bf941048359001983b05334c39.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5cTE5OTU_size_16_color_FFFFFF_t_70 3]: /images/20220121/3e825fc230204716bd05d5cbfe2a623c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5cTE5OTU_size_16_color_FFFFFF_t_70 4]: /images/20220121/0d58cd7d66664fceb73d606bf1683ec5.png