Introducción de esta sección:

En esta sección presentamos el último de los cuatro componentes principales de Android: ContentProvider (proveedor de contenido). Algunos lectores pueden tener dudas: "¿Android no tiene cinco componentes principales? ¿Y qué pasa con Intent?" Sí, Intent también es muy importante, pero solo es el vínculo que mantiene unidos estos componentes. ¡Explicaremos Intent en el próximo capítulo! En cuanto a ContentProvider, ¿cuándo lo usamos? Tenemos las siguientes dos situaciones:

  • 1.Queremos acceder desde nuestra propia aplicación a otras aplicaciones, o a algunos datos que ciertos ContentProvider nos exponen, como contactos del teléfono, mensajes de texto, etc. Si queremos leer o modificar estos datos, ¡necesitamos usar ContentProvider!
  • 2.Si nuestra propia aplicación quiere exponer algunos datos para que otras aplicaciones los lean o manipulen, también podemos usar ContentProvider. Además, podemos elegir qué datos exponer, evitando así la filtración de nuestros datos privados.

Parece muy impresionante, pero en realidad es muy sencillo de usar. A continuación, vamos a aprender sobre ContentProvider.Documentación oficial:ContentProviderEn esta sección explicaremos el concepto de ContentProvider, mostraremos algunos ejemplos comunes de uso del ContentProvider del sistema y el ContentProvider personalizado.


1. Explicación del concepto de ContentProvider:


2. Usar el ContentProvider proporcionado por el sistema

En realidad, muchas veces cuando usamos ContentProvider no es para exponer nuestros propios datos, sino más a menudo, a través de él,ContentResolverleemos información de otras aplicaciones. Lo más común es leer las aplicaciones del sistema, mensajes, contactos, información multimedia, etc. Si quieres llamar a estos ContentProvider, necesitas consultar la documentación de la API correspondiente por tu cuenta. Además, diferentes versiones pueden corresponder a diferentes URL. Aquí te mostramos cómo obtener la URL y los campos de las tablas de la base de datos correspondientes. Tomemos como ejemplo los contactos, que es lo más común; para el resto, buscad en Google.
① Ve al archivo de código fuente del sistema: all-src.rar -> TeleponeProvider -> AndroidManifest.xml para buscar la API correspondiente.
② Abre el explorador de archivos del emulador en data/data/com.android.providers.contacts/databases/contact2.db. Después de exportarlo, usa una herramienta gráfica SQLite para verlo. Las tres tablas principales:tabla raw_contact,tabla data,tabla mimetypes!
A continuación se muestran algunos ejemplos de operaciones básicas:


1) Leer simplemente la información de la bandeja de entrada:

Código principal:

private void getMsgs(){
    Uri uri = Uri.parse("content://sms/");
    ContentResolver resolver = getContentResolver();
    //获取的是哪些列的信息
    Cursor cursor = resolver.query(uri, new String[]{"address","date","type","body"}, null, null, null);
    while(cursor.moveToNext())
    {
        String address = cursor.getString(0);
        String date = cursor.getString(1);
        String type = cursor.getString(2);
        String body = cursor.getString(3);
        System.out.println("地址:" + address);
        System.out.println("时间:" + date);
        System.out.println("类型:" + type);
        System.out.println("内容:" + body);
        System.out.println("======================");
    }
    cursor.close();
}

No olvides añadir el permiso de lectura de la bandeja de entrada en AndroidManifest.xml:

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

Resultado de la ejecución:

Parte del resultado de la ejecución es el siguiente:


2) Insertar simplemente un mensaje en la bandeja de entrada

Código principal:

private void insertMsg() {
    ContentResolver resolver = getContentResolver();
    Uri uri = Uri.parse("content://sms/");
    ContentValues conValues = new ContentValues();
    conValues.put("address", "123456789");
    conValues.put("type", 1);
    conValues.put("date", System.currentTimeMillis());
    conValues.put("body", "no zuo no die why you try!");
    resolver.insert(uri, conValues);
    Log.e("HeHe", "短信插入完毕~");
}

Resultado de la ejecución:

Notas:

El código anterior puede escribir SMS en versiones anteriores a 4.4, pero no en 5.0. La razón es que, a partir de 5.0, el software fuera de la aplicación de SMS predeterminada no puede enviar SMS escribiendo en la base de datos de SMS.


3) Leer simplemente los contactos del teléfono

Código principal:

private void getContacts(){
    //①查询raw_contacts表获得联系人的id
    ContentResolver resolver = getContentResolver();
    Uri uri = ContactsContract.CommonDataKinds.Phone.CONTENT_URI;
    //查询联系人数据
    cursor = resolver.query(uri, null, null, null, null);
    while(cursor.moveToNext())
    {
        //获取联系人姓名,手机号码
        String cName = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
        String cNum = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
        System.out.println("姓名:" + cName);
        System.out.println("号码:" + cNum);
        System.out.println("======================");
    }
    cursor.close();
}

No olvides añadir el permiso de lectura de contactos:

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

Resultado de la ejecución:

Parte del resultado de la ejecución es el siguiente:


4) Consultar la información de contacto de un teléfono específico

Código principal:

private void queryContact(String number){
        Uri uri = Uri.parse("content://com.android.contacts/data/phones/filter/" + number);
        ContentResolver resolver = getContentResolver();
        Cursor cursor = resolver.query(uri, new String[]{"display_name"}, null, null, null);
        if (cursor.moveToFirst()) {
            String name = cursor.getString(0);
            System.out.println(number + "对应的联系人名称:" + name);
        }
    cursor.close();
}

Resultado de la ejecución:


5) Añadir un nuevo contacto

Código principal:

private void AddContact() throws RemoteException, OperationApplicationException {
    //使用事务添加联系人
    Uri uri = Uri.parse("content://com.android.contacts/raw_contacts");
    Uri dataUri =  Uri.parse("content://com.android.contacts/data");

    ContentResolver resolver = getContentResolver();
    ArrayList<ContentProviderOperation> operations = new ArrayList<ContentProviderOperation>();
    ContentProviderOperation op1 = ContentProviderOperation.newInsert(uri)
            .withValue("account_name", null)
            .build();
    operations.add(op1);

    //依次是姓名,号码,邮编
    ContentProviderOperation op2 = ContentProviderOperation.newInsert(dataUri)
            .withValueBackReference("raw_contact_id", 0)
            .withValue("mimetype", "vnd.android.cursor.item/name")
            .withValue("data2", "Coder-pig")
            .build();
    operations.add(op2);

    ContentProviderOperation op3 = ContentProviderOperation.newInsert(dataUri)
            .withValueBackReference("raw_contact_id", 0)
            .withValue("mimetype", "vnd.android.cursor.item/phone_v2")
            .withValue("data1", "13798988888")
            .withValue("data2", "2")
            .build();
    operations.add(op3);

    ContentProviderOperation op4 = ContentProviderOperation.newInsert(dataUri)
            .withValueBackReference("raw_contact_id", 0)
            .withValue("mimetype", "vnd.android.cursor.item/email_v2")
            .withValue("data1", "779878443@qq.com")
            .withValue("data2", "2")
            .build();
    operations.add(op4);
    //将上述内容添加到手机联系人中~
    resolver.applyBatch("com.android.contacts", operations);
    Toast.makeText(getApplicationContext(), "添加成功", Toast.LENGTH_SHORT).show();
}

Resultado de la ejecución:

No olvides los permisos:

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

3. ContentProvider personalizado

Rara vez definimos nuestro propio ContentProvider, porque muchas veces no queremos exponer los datos de nuestra aplicación a otras aplicaciones. Aun así, aprender a crear un ContentProvider es necesario; es una forma adicional de transmisión de datos, ¿verdad?
Este es un diagrama de flujo que dibujé antes:

A continuación, lo implementaremos paso a paso:

Antes de comenzar, primero debemos crear una clase de creación de base de datos (el contenido de la base de datos se explicará más adelante):

DBOpenHelper.java

public class DBOpenHelper extends SQLiteOpenHelper {

    final String CREATE_SQL = "CREATE TABLE test(_id INTEGER PRIMARY KEY AUTOINCREMENT,name)";
    
    public DBOpenHelper(Context context, String name, CursorFactory factory,
            int version) {
        super(context, name, null, 1);
    }

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

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        // TODO Auto-generated method stub

    }

}

Step 1Definir una clase ContentProvider personalizada, implementar onCreate(), getType() y, según las necesidades, sobrescribir los métodos correspondientes de agregar, eliminar, modificar y consultar:

NameContentProvider.java

public class NameContentProvider extends ContentProvider {

    //初始化一些常量
     private static UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);        
     private DBOpenHelper dbOpenHelper;
    
    //为了方便直接使用UriMatcher,这里addURI,下面再调用Matcher进行匹配
     
     static{  
         matcher.addURI("com.jay.example.providers.myprovider", "test", 1);
     }  
     
    @Override
    public boolean onCreate() {
        dbOpenHelper = new DBOpenHelper(this.getContext(), "test.db", null, 1);
        return true;
    }

    @Override
    public Cursor query(Uri uri, String[] projection, String selection,
            String[] selectionArgs, String sortOrder) {
        return null;
    }

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

    @Override
    public Uri insert(Uri uri, ContentValues values) {
        
        switch(matcher.match(uri))
        {
        //把数据库打开放到里面是想证明uri匹配完成
        case 1:
            SQLiteDatabase db = dbOpenHelper.getReadableDatabase();
            long rowId = db.insert("test", null, values);
            if(rowId > 0)
            {
                //在前面已有的Uri后面追加ID
                Uri nameUri = ContentUris.withAppendedId(uri, rowId);
                //通知数据已经发生改变
                getContext().getContentResolver().notifyChange(nameUri, null);
                return nameUri;
            }
        }
        return null;
    }

    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        return 0;
    }

    @Override
    public int update(Uri uri, ContentValues values, String selection,
            String[] selectionArgs) {
        return 0;
    }

}

Step 2Registrar el ContentProvider en AndroidManifest.xml:

<!--属性依次为:全限定类名,用于匹配的URI,是否共享数据 -->
<provider android:name="com.jay.example.bean.NameContentProvider"
            android:authorities="com.jay.example.providers.myprovider"
            android:exported="true" />

Bien, ¡la parte de ContentProvider está completa!


A continuación, crea un nuevo proyecto e implementaremos la parte de ContentResolver. Insertaremos un dato directamente haciendo clic en un botón:

MainActivity.java

public class MainActivity extends Activity {

    private Button btninsert;
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        btninsert = (Button) findViewById(R.id.btninsert);
        
        //读取contentprovider 数据  
        final ContentResolver resolver = this.getContentResolver();
        
        
        btninsert.setOnClickListener(new OnClickListener() {
            
            @Override
            public void onClick(View v) {
                 ContentValues values = new ContentValues();
                 values.put("name", "测试");
                 Uri uri = Uri.parse("content://com.jay.example.providers.myprovider/test");
                resolver.insert(uri, values);
                Toast.makeText(getApplicationContext(), "数据插入成功", Toast.LENGTH_SHORT).show();
                
            }
        });
       
    }
}

¿Cómo usarlo?Bien, el código sigue siendo bastante simple. Primero ejecuta el proyecto que actúa como ContentProvider, luego ejecuta el proyecto ContentResolver, haz clic en el botón para insertar un dato y, a continuación, abre el explorador de archivos para extraer la base de datos db del ContentProvider. Usa una herramienta de visualización gráfica para ver el dato insertado. Como no hay tiempo, no demostraré el resultado.


4. Escuchar los cambios de datos de ContentProvider mediante ContentObserver

Guía de uso:

Después de ejecutar el programa, déjalo a un lado. Cuando recibas un SMS, podrás ver el contenido del mensaje en logcat. Según tus necesidades, puedes cambiar Activity por Service y hacer esto en segundo plano.


Resumen de esta sección:

Bien, aquí terminamos el primer vistazo a ContentProvider. En esta sección hemos aprendido: el concepto y el flujo de ContentProvider, el uso de algunos ContentProvider proporcionados por el sistema, y la personalización de tu propio ContentProvider. Finalmente, también explicamos cómo escuchar los cambios de datos de ContentProvider mediante ContentObserver. Ya dominamos casi todo el contenido de ContentProvider. En la próxima sección revisaremos la documentación para ver qué más hay que saber. ¡Gracias!