Android 學習之《第一行代碼》第二版 筆記（十六）內容提供器之訪問其他程序中的數據

一、概要

內容提供器的用法：

A. 使用現有的內容提供器來讀取和操作相應程序中的數據。
B. 創建自己的內容提供器給我們程序的數據提供外部訪問接口。

二、ContentResolver的基本用法

1. 藉助ContentResolver類訪問內容提供器中共享的數據。（通過Context的getContentResolver()方法獲得該類的實例）。
2. ContentResolver類中的CRUD方法都不接受表名，而是使用一個Uri參數來代替：
   A. Uri – 內容URI，給內容提供器中的數據建立唯一標識符。
   B. Uri = content:// + authority + path ; 頭部協議；authority: 區分不同的應用程序，一般採用程序包名來命名；path: 區分同一應用程序的不同表，常放在authority後面。
   C. 得到內容URI字符串後需要將它解析成Uri對象：
   Uri uri = Uri.parse(“URI字符串”);
3. 這個類提供了一系列的方法對數據進行CRUD操作：
   A. 插入操作： insert(Uri,ContentValues);
   B. 更新操作： update(Uri,ContentValues,WHERE,佔位符的值);
   C. 刪除操作： delete(Uri,WHERE,佔位符的值);
   D. 查詢操作： query(Uri,要查詢的列名,WHERE,佔位符的值,ORDERBY);

三、讀取系統聯繫人

1. 效果圖
   
   
2. 知識點儲備
   A. 運行時權限的使用
   B. ListView組件的回顧
3. 佈局（activity_main.xml）

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.example.thinkpad.contactstest.MainActivity">

    <ListView
        android:id="@+id/contacts_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent">
    </ListView>

</android.support.constraint.ConstraintLayout>

5. 主活動（MainActivity.java）

import android.Manifest;
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.provider.ContactsContract;
import android.support.annotation.NonNull;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.Toast;

import java.util.ArrayList;
import java.util.List;

public class MainActivity extends AppCompatActivity {

    ArrayAdapter<String> adapter;
    List<String> contactsList = new ArrayList<>();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //獲取控件實例，創建適配器，並且將其設置進ListView
        ListView contactsView = (ListView)findViewById(R.id.contacts_view);
        adapter = new ArrayAdapter<String>(this,android.R.layout.simple_list_item_1,contactsList);
        contactsView.setAdapter(adapter);
        //運行時權限，檢查是否授權
        if(ContextCompat.checkSelfPermission(this, Manifest.permission.READ_CONTACTS)
                != PackageManager.PERMISSION_GRANTED){
            ActivityCompat.requestPermissions(this,new String[]{Manifest.permission.READ_CONTACTS},1);
        }else{
            readContacts();
        }
    }

    private void readContacts(){
        Cursor cursor = null;
        try{
            //查詢聯繫人數據
            //此處的URI是ContactsContract.CommonDataKinds.Phone類幫我們做好了封裝
            cursor = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
                    null,null,null,null);
            if(cursor != null){
                while(cursor.moveToNext()){
                    //獲取聯繫人姓名
                    String displayName = cursor.getString(cursor.getColumnIndex
                            (ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
                    //獲取聯繫人手機號
                    String number = cursor.getString(cursor.getColumnIndex
                            (ContactsContract.CommonDataKinds.Phone.NUMBER));
                    //將聯繫人的姓名和電話加入到ListView列表當中
                    contactsList.add(displayName+"\n"+number);
                }
                adapter.notifyDataSetChanged();
            }
        }catch(Exception e){
            e.printStackTrace();
        }finally {
            if (cursor != null){
                cursor.close();
            }
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        switch (requestCode){
            case 1:
                if(grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED){
                    readContacts();
                }else {
                    Toast.makeText(this,"你選的嘛偶像！",Toast.LENGTH_SHORT).show();
                }
                break;
            default:
        }
    }
}

4. 聲明權限（AndroidManifest.xml）

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.thinkpad.contactstest">
    <!--讀取聯繫人的權限聲明-->
    <uses-permission android:name="android.permission.READ_CONTACTS"/>
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

---

整理學習自郭霖大佬的《第一行代碼》
目前小白一名，持續學習Android中，如有錯誤請批評指正！