Android学习笔记（二十一）——实战：程序数据共享

　　//此系列博文是《第一行Android代码》的学习笔记，如有错漏，欢迎指正！

　　我们继续在Database项目的基础上继续开发，通过内容提供器来给它加入外部访问接口。首先将 MyDatabaseHelper 中使用 Toast弹出创建数据库成功的提示去除掉，因为跨程序访问时我们不能直接使用 Toast。

一、添加一个 DatabaseProvider 类：

  1 public class DatabaseProvider extends ContentProvider {
  2     public static final int BOOK_DIR = 0;
  3     public static final int BOOK_ITEM = 1;
  4     public static final int CATEGORY_DIR = 2;
  5     public static final int CATEGORY_ITEM = 3;
  6     public static final String AUTHORITY = "com.mycompany.database.provider";
  7     private static UriMatcher uriMatcher;
  8     private MyDatabaseHelper dbHelper;
  9     static {
 10         uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
 11         uriMatcher.addURI(AUTHORITY, "book", BOOK_DIR);
 12         uriMatcher.addURI(AUTHORITY, "book/#", BOOK_ITEM);
 13         uriMatcher.addURI(AUTHORITY, "category", CATEGORY_DIR);
 14         uriMatcher.addURI(AUTHORITY, "category/#", CATEGORY_ITEM);
 15     }
 16     @Override
 17     public boolean onCreate() {
 18         dbHelper = new MyDatabaseHelper(getContext(), "BookStore.db", null, 2);
 19         return true;
 20     }
 21     @Override
 22     public Cursor query(Uri uri, String[] projection, String selection,
 23                         String[] selectionArgs, String sortOrder) {
 24     // 查询数据
 25         SQLiteDatabase db = dbHelper.getReadableDatabase();
 26         Cursor cursor = null;
 27         switch (uriMatcher.match(uri)) {
 28             case BOOK_DIR:
 29                 cursor = db.query("Book", projection, selection, selectionArgs,
 30                         null, null, sortOrder);
 31                 break;
 32             case BOOK_ITEM:
 33                 String bookId = uri.getPathSegments().get(1);
 34                 cursor = db.query("Book", projection, "id = ?", new String[]
 35                         { bookId }, null, null, sortOrder);
 36                 break;
 37             case CATEGORY_DIR:
 38                 cursor = db.query("Category", projection, selection,
 39                         selectionArgs, null, null, sortOrder);
 40                 break;
 41             case CATEGORY_ITEM:
 42                 String categoryId = uri.getPathSegments().get(1);
 43                 cursor = db.query("Category", projection, "id = ?", new String[]
 44                         { categoryId }, null, null, sortOrder);
 45                 break;
 46             default:
 47                 break;
 48         }
 49         return cursor;
 50     }
 51     @Override
 52     public Uri insert(Uri uri, ContentValues values) {
 53     // 添加数据
 54         SQLiteDatabase db = dbHelper.getWritableDatabase();
 55         Uri uriReturn = null;
 56         switch (uriMatcher.match(uri)) {
 57             case BOOK_DIR:
 58             case BOOK_ITEM:
 59                 long newBookId = db.insert("Book", null, values);
 60                 uriReturn = Uri.parse("content://" + AUTHORITY + "/book/" + newBookId);
 61                 break;
 62             case CATEGORY_DIR:
 63             case CATEGORY_ITEM:
 64                 long newCategoryId = db.insert("Category", null, values);
 65                 uriReturn = Uri.parse("content://" + AUTHORITY + "/category/" +
 66                         newCategoryId);
 67                 break;
 68             default:
 69                 break;
 70         }
 71         return uriReturn;
 72     }
 73     @Override
 74     public int update(Uri uri, ContentValues values, String selection,
 75                       String[] selectionArgs) {
 76     // 更新数据
 77         SQLiteDatabase db = dbHelper.getWritableDatabase();
 78         int updatedRows = 0;
 79         switch (uriMatcher.match(uri)) {
 80             case BOOK_DIR:
 81                 updatedRows = db.update("Book", values, selection, selectionArgs);
 82                 break;
 83             case BOOK_ITEM:
 84                 String bookId = uri.getPathSegments().get(1);
 85                 updatedRows = db.update("Book", values, "id = ?", new String[]
 86                         { bookId });
 87                 break;
 88             case CATEGORY_DIR:
 89                 updatedRows = db.update("Category", values, selection,
 90                         selectionArgs);
 91                 break;
 92             case CATEGORY_ITEM:
 93                 String categoryId = uri.getPathSegments().get(1);
 94                 updatedRows = db.update("Category", values, "id = ?", new String[]
 95                         { categoryId });
 96                 break;
 97             default:
 98                 break;
 99         }
100         return updatedRows;
101     }
102     @Override
103     public int delete(Uri uri, String selection, String[] selectionArgs) {
104     // 删除数据
105         SQLiteDatabase db = dbHelper.getWritableDatabase();
106         int deletedRows = 0;
107         switch (uriMatcher.match(uri)) {
108             case BOOK_DIR:
109                 deletedRows = db.delete("Book", selection, selectionArgs);
110                 break;
111             case BOOK_ITEM:
112                 String bookId = uri.getPathSegments().get(1);
113                 deletedRows = db.delete("Book", "id = ?", new String[] { bookId });
114                 break;
115             case CATEGORY_DIR:
116                 deletedRows = db.delete("Category", selection, selectionArgs);
117                 break;
118             case CATEGORY_ITEM:
119                 String categoryId = uri.getPathSegments().get(1);
120                 deletedRows = db.delete("Category", "id = ?", new String[]
121                         { categoryId });
122                 break;
123             default:
124                 break;
125         }
126         return deletedRows;
127     }
128     @Override
129     public String getType(Uri uri) {
130         switch (uriMatcher.match(uri)) {
131             case BOOK_DIR:
132                 return "vnd.android.cursor.dir/vnd.com.mycompany.database.provider.book";
133             case BOOK_ITEM:
134                 return "vnd.android.cursor.item/vnd.com.mycompany.database.provider.book";
135             case CATEGORY_DIR:
136                 return "vnd.android.cursor.dir/vnd.com.mycompany.database.provider.category";
137             case CATEGORY_ITEM:
138                 return "vnd.android.cursor.item/vnd.com.mycompany.database.provider.category";
139         }
140         return null;
141     }
142 }

View Code

　　代码中我们主要重写了CRUD操作：

　　1）query()方法：在这个方法中先获取到了 SQLiteDatabase 的实例，然后根据传入的 Uri参数判断出用户想要访问哪张表，再调用 SQLiteDatabase 的 query()进行查询，并将 Cursor 对象返回就好了。注意当访问单条数据的时候有一个细节，这里调用了 Uri 对象的getPathSegments()方法，它会将内容 URI权限之后的部分以“/”符号进行分割，并把分割后的结果放入到一个字符串列表中，那这个列表的第 0 个位置存放的就是路径，第 1个位置存放的就是 id 了。得到了 id 之后，再通过 selection 和 selectionArgs 参数进行约束，就实现了查询单条数据的功能。

　　2）insert()方法：同样先获取到了 SQLiteDatabase 的实例，然后根据传入的 Uri参数判断出用户想要往哪张表里添加数据，再调用 SQLiteDatabase 的 insert()方法进行添加。注意 insert()方法要求返回一个能够表示这条新增数据的 URI，所以我们还需要调用 Uri.parse()方法来将一个内容 URI解析成 Uri对象，当然这个内容 URI是以新增数据的 id 结尾的。

　　3）update()方法：先获取SQLiteDatabase 的实例，然后根据传入的 Uri 参数判断出用户想要更新哪张表里的数据，再调用 SQLiteDatabase的 update()方法进行更新，最后将受影响的行数作为返回值返回。

　　4）delete()方法：仍然是先获取到 SQLiteDatabase 的实例，然后根据传入的 Uri 参数判断出用户想要删除哪张表里的数据，再调用 SQLiteDatabase 的 delete()方法进行删除就好了，被删除的行数将作为返回值返回。

二、在AndroidManifest.xml文件中进行注册：

 1 <?xml version="1.0" encoding="utf-8"?>
 2 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
 3     package="com.mycompany.database" >
 4 
 5     <application
 6         android:allowBackup="true"
 7         android:icon="@mipmap/ic_launcher"
 8         android:label="@string/app_name"
 9         android:supportsRtl="true"
10         android:theme="@style/AppTheme" >
11         <activity android:name=".MainActivity" >
12             <intent-filter>
13                 <action android:name="android.intent.action.MAIN" />
14 
15                 <category android:name="android.intent.category.LAUNCHER" />
16             </intent-filter>
17         </activity>
18         <provider
19             android:name="com.mycompany.database.DatabaseProvider"
20             android:authorities="com.mycompany.database.provider" >
21         </provider>
22     </application>
23 
24 </manifest>

View Code

　　这里我们使用了<provider>标签来对 DatabaseProvider 这个内容提供器进行注册，在 android:name 属性中指定了该类的全名，又在 android:authorities 属性中指定了该内容提供器的权限。现在 Database这个项目就已经拥有了跨程序共享数据的功能了。接着我们需要将 Database 程序从手机中删除掉，以防止上次中产生的遗留数据对我们造成干扰。然后运行一下项目，将Database程序重新安装在手机了。接着关闭掉Databaset 这个项目，并创建一个新项目 ProviderTest，我们就将通过这个程序去访问Database中的数据。

三、编写ProviderTest的布局文件：

 1 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
 2     xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent"
 3     android:orientation="vertical"
 4     android:layout_height="match_parent" android:paddingLeft="@dimen/activity_horizontal_margin"
 5     android:paddingRight="@dimen/activity_horizontal_margin"
 6     android:paddingTop="@dimen/activity_vertical_margin"
 7     android:paddingBottom="@dimen/activity_vertical_margin" tools:context=".MainActivity">
 8 
 9     <Button
10         android:id="@+id/add_data"
11         android:layout_width="match_parent"
12         android:layout_height="wrap_content"
13         android:text="Add To Book" />
14     <Button
15         android:id="@+id/query_data"
16         android:layout_width="match_parent"
17         android:layout_height="wrap_content"
18         android:text="Query From Book" />
19     <Button
20         android:id="@+id/update_data"
21         android:layout_width="match_parent"
22         android:layout_height="wrap_content"
23         android:text="Update Book" />
24     <Button
25         android:id="@+id/delete_data"
26         android:layout_width="match_parent"
27         android:layout_height="wrap_content"
28         android:text="Delete From Book" />
29 </LinearLayout>

View Code

　　布局文件比较简单，里面放置了四个按钮，分别用于添加、查询、修改和删除数据的。

四、修改ProviderTest主代码：

 1 public class MainActivity extends AppCompatActivity {
 2 
 3     private String newId;
 4     @Override
 5     protected void onCreate(Bundle savedInstanceState) {
 6         super.onCreate(savedInstanceState);
 7         setContentView(R.layout.activity_main);
 8         Button addData = (Button) findViewById(R.id.add_data);
 9         addData.setOnClickListener(new View.OnClickListener() {
10             @Override
11             public void onClick(View v) {
12             // 添加数据
13                 Uri uri = Uri.parse("content://com.mycompany.database.provider/book");
14                 ContentValues values = new ContentValues();
15                 values.put("name", "A Clash of Kings");
16                 values.put("author", "George Martin");
17                 values.put("pages", 1040);
18                 values.put("price", 22.85);
19                 Uri newUri = getContentResolver().insert(uri, values);
20                 newId = newUri.getPathSegments().get(1);
21             }
22         });
23         Button queryData = (Button) findViewById(R.id.query_data);
24         queryData.setOnClickListener(new View.OnClickListener() {
25             @Override
26             public void onClick(View v) {
27                 // 查询数据
28                 Uri uri = Uri.parse("content://com.mycompany.database.provider/book");
29                         Cursor cursor = getContentResolver().query(uri, null, null, null, null);
30                 if (cursor != null) {
31                     while (cursor.moveToNext()) {
32                         String name = cursor.getString(cursor.
33                                 getColumnIndex("name"));
34                         String author = cursor.getString(cursor.
35                                 getColumnIndex("author"));
36                         int pages = cursor.getInt(cursor.getColumnIndex
37                                 ("pages"));
38                         double price = cursor.getDouble(cursor.
39                                 getColumnIndex("price"));
40                         Log.d("MainActivity", "book name is " + name);
41                         Log.d("MainActivity", "book author is " + author);
42                         Log.d("MainActivity", "book pages is " + pages);
43                         Log.d("MainActivity", "book price is " + price);
44                     }
45                     cursor.close();
46                 }
47             }
48         });
49         Button updateData = (Button) findViewById(R.id.update_data);
50         updateData.setOnClickListener(new View.OnClickListener() {
51             @Override
52             public void onClick(View v) {
53             // 更新数据
54                 Uri uri = Uri.parse("content://com.mycompany.database.provider/book/" + newId);
55                         ContentValues values = new ContentValues();
56                 values.put("name", "A Storm of Swords");
57                 values.put("pages", 1216);
58                 values.put("price", 24.05);
59                 getContentResolver().update(uri, values, null, null);
60             }
61         });
62         Button deleteData = (Button) findViewById(R.id.delete_data);
63         deleteData.setOnClickListener(new View.OnClickListener() {
64             @Override
65             public void onClick(View v) {
66             // 删除数据
67                 Uri uri = Uri.parse("content://com.mycompany.database.provider/book/" + newId);
68                         getContentResolver().delete(uri, null, null);
69             }
70         });
71     }
72 }

View Code

　　我们分别在这四个按钮的点击事件里面处理了增删改查的逻辑。

　　1）Add To Book：添加数据的时候，首先调用了 Uri.parse()方法将一个内容 URI解析成 Uri对象，然后把要添加的数据都存放到 ContentValues对象中，接着调用 ContentResolver 的 insert()方法执行添加操作就可以了。注意 insert()方法会返回一个 Uri 对象，这个对象中包含了新增数据的 id，我们通过getPathSegments()方法将这个 id 取出，稍后会用到它。
　　2）Query From Book：查询数据的时候，同样是调用了 Uri.parse()方法将一个内容 URI解析成 Uri对象，然后调用 ContentResolver 的 query()方法去查询数据，查询的结果当然还是存放在 Cursor对象中的。之后对 Cursor 进行遍历，从中取出查询结果，并一一打印出来。
　　3）Update Book：更新数据的时候，也是先将内容 URI 解析成 Uri 对象，然后把想要更新的数据存放到ContentValues对象中，再调用 ContentResolver 的 update()方法执行更新操作就可以了。注意这里我们为了不想让 Book 表中其他的行受到影响，在调用 Uri.parse()方法时，给内容 URI的尾部增加了一个 id，而这个 id 正是添加数据时所返回的。这就表示我们只希望更新刚刚添加的那条数据，Book 表中的其他行都不会受影响。
　　4）Delete From Book：删除数据的时候，也是使用同样的方法解析了一个以 id 结尾的内容 URI，然后调用ContentResolver 的 delete()方法执行删除操作就可以了。由于我们在内容 URI 里指定了一个id，因此只会删掉拥有相应 id 的那行数据，Book 表中的其他数据都不会受影响。

　　程序运行效果如下：

　　按下Add按钮后，再按下查询，在Android Monitor中可看到：

04-25 21:49:18.327 31285-31285/com.mycompany.database D/MainActivity: book name is A Clash of Kings
04-25 21:49:18.327 31285-31285/com.mycompany.database D/MainActivity: book author is George Martin
04-25 21:49:18.327 31285-31285/com.mycompany.database D/MainActivity: book pages is 1040
04-25 21:49:18.337 31285-31285/com.mycompany.database D/MainActivity: book price is 22.85

　　按下Update后，再按下查询，可看到：

04-25 22:11:10.768 31285-31285/com.mycompany.database D/MainActivity: book name is A Storm of Swords
04-25 22:11:10.768 31285-31285/com.mycompany.database D/MainActivity: book author is George Martin
04-25 22:11:10.768 31285-31285/com.mycompany.database D/MainActivity: book pages is 1216
04-25 22:11:10.768 31285-31285/com.mycompany.database D/MainActivity: book price is 24.05

　　当按下Delete后，再按下查询，此时已没有数据显示了。

　　//End.