热门标签 | HotTags
当前位置:  开发笔记 > 前端 > 正文

android基础总结篇之八:创建及调用自己的ContentProvider

这篇文章主要介绍了android基础总结篇之八:创建及调用自己的ContentProvider,有兴趣的可以了解一下。

今天我们来讲解一下如何创建及调用自己的ContentProvider。

在前面两篇文章中我们分别讲了如何读写联系人和短消息,相信大家对于ContentProvider的操作方法已经有了一定程度的了解。在有些场合,除了操作ContentProvider之外,我们还有可能需要创建自己的ContentProvider,来提供信息共享的服务,这就要求我们很好的掌握ContentProvider的创建及使用技巧。下面我们就由表及里的逐步讲解每个步骤。

在正式开始实例演示之前,我们先来了解以下两个知识点:

授权:

在Android中,每一个ContentProvider都会用类似于域名的字符串来注册自己,我们成为授权(authority)。这个唯一标识的字符串是此ContentProvider可提供的一组URI的基础,有了这个基础,才能够向外界提供信息的共享服务。

授权是在AndroidManifest.xml中完成的,每一个ContentProvider必须在此声明并授权,方式如下:

 

上面的元素指明了ContentProvider的提供者是“SomeProvider”这个类,并为其授权,授权的基础URI为“com.your-company.SomeProvider”。有了这个授权信息,系统可以准确的定位到具体的ContentProvider,从而使访问者能够获取到指定的信息。这和浏览Web页面的方式很相似,“SomeProvider”就像一台具体的服务器,而“com.your-company.SomeProvider”就像注册的域名,相信大家对这个概念并不陌生,由此联想一下就可以了解ContentProvider授权的作用了。(需要注意的是,除了Android内置应用程序之外,第三方程序应尽量使用以上方式的完全限定的授权名。)

MIME类型:

就像网站返回给定URL的MIME(Multipurpose Internet Mail Extensions,多用途Internet邮件扩展)类型一样(这使浏览器能够用正确的程序来查看内容),ContentProvider还负责返回给定URI的MIME类型。根据MIME类型规范,MIME类型包含两部分:类型和子类型。例如:text/html,text/css,text/xml等等。

Android也遵循类似的约定来定义MIME类型。

对于单条记录,MIME类型类似于:

vnd.android.cursor.item/vnd.your-company.content-type

而对于记录的集合,MIME类型类似于:

vnd.android.cursor.dir/vnd.your-company.comtent-type

其中的vnd表示这些类型和子类型具有非标准的、供应商特定的形式;content-type可以根据ContentProvider的功能来定,比如日记的ContentProvider可以为note,日程安排的ContentProvider可以为schedule,等等。

了解了以上两个知识点之后,我们就结合实例来演示一下具体的过程。

我们将会创建一个记录person信息的ContentProvider,实现对person的CRUD操作,访问者可以通过下面路径操作我们的ContentProvider:

访问者可以通过“[BASE_URI]/persons”来操作person集合,也可以通过“[BASE_URI]/persons/#”的形式操作单个person。
我们创建一个person的ContentProvider需要两个步骤:

1.创建PersonProvider类:

我们需要继承ContentProvider类,实现onCreate、query、insert、update、delete和getType这几个方法。具体代码如下:

package com.scott.provider; 
 
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; 
 
public class PersonProvider extends ContentProvider { 
 
  private static final UriMatcher matcher; 
  private DBHelper helper; 
  private SQLiteDatabase db; 
   
  private static final String AUTHORITY = "com.scott.provider.PersonProvider"; 
  private static final int PERSON_ALL = 0; 
  private static final int PERSON_OnE= 1; 
   
  public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd.scott.person"; 
  public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/vnd.scott.person"; 
   
  //数据改变后立即重新查询 
  private static final Uri NOTIFY_URI = Uri.parse("content://" + AUTHORITY + "/persons"); 
   
  static { 
    matcher = new UriMatcher(UriMatcher.NO_MATCH); 
     
    matcher.addURI(AUTHORITY, "persons", PERSON_ALL);  //匹配记录集合 
    matcher.addURI(AUTHORITY, "persons/#", PERSON_ONE); //匹配单条记录 
  } 
   
  @Override 
  public boolean onCreate() { 
    helper = new DBHelper(getContext()); 
    return true; 
  } 
 
  @Override 
  public String getType(Uri uri) { 
    int match = matcher.match(uri); 
    switch (match) { 
    case PERSON_ALL: 
      return CONTENT_TYPE; 
    case PERSON_ONE: 
      return CONTENT_ITEM_TYPE; 
    default: 
      throw new IllegalArgumentException("Unknown URI: " + uri); 
    } 
  } 
   
  @Override 
  public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { 
    db = helper.getReadableDatabase(); 
    int match = matcher.match(uri); 
    switch (match) { 
    case PERSON_ALL: 
      //doesn't need any code in my provider. 
      break; 
    case PERSON_ONE: 
      long _id = ContentUris.parseId(uri); 
      selection = "_id = ?"; 
      selectiOnArgs= new String[]{String.valueOf(_id)}; 
      break; 
    default: 
      throw new IllegalArgumentException("Unknown URI: " + uri); 
    } 
    return db.query("person", projection, selection, selectionArgs, null, null, sortOrder); 
  } 
 
  @Override 
  public Uri insert(Uri uri, ContentValues values) { 
    int match = matcher.match(uri); 
    if (match != PERSON_ALL) { 
      throw new IllegalArgumentException("Wrong URI: " + uri); 
    } 
    db = helper.getWritableDatabase(); 
    if (values == null) { 
      values = new ContentValues(); 
      values.put("name", "no name"); 
      values.put("age", "1"); 
      values.put("info", "no info."); 
    } 
    long rowId = db.insert("person", null, values); 
    if (rowId > 0) { 
      notifyDataChanged(); 
      return ContentUris.withAppendedId(uri, rowId); 
    } 
    return null; 
  } 
 
  @Override 
  public int delete(Uri uri, String selection, String[] selectionArgs) { 
    db = helper.getWritableDatabase(); 
    int match = matcher.match(uri); 
    switch (match) { 
    case PERSON_ALL: 
      //doesn't need any code in my provider. 
      break; 
    case PERSON_ONE: 
      long _id = ContentUris.parseId(uri); 
      selection = "_id = ?"; 
      selectiOnArgs= new String[]{String.valueOf(_id)}; 
    } 
    int count = db.delete("person", selection, selectionArgs); 
    if (count > 0) { 
      notifyDataChanged(); 
    } 
    return count; 
  } 
 
  @Override 
  public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { 
    db = helper.getWritableDatabase(); 
    int match = matcher.match(uri); 
    switch (match) { 
    case PERSON_ALL: 
      //doesn't need any code in my provider. 
      break; 
    case PERSON_ONE: 
      long _id = ContentUris.parseId(uri); 
      selection = "_id = ?"; 
      selectiOnArgs= new String[]{String.valueOf(_id)}; 
      break; 
    default: 
      throw new IllegalArgumentException("Unknown URI: " + uri); 
    } 
    int count = db.update("person", values, selection, selectionArgs); 
    if (count > 0) { 
      notifyDataChanged(); 
    } 
    return count; 
  } 
 
  //通知指定URI数据已改变 
  private void notifyDataChanged() { 
    getContext().getContentResolver().notifyChange(NOTIFY_URI, null);     
  } 
} 

在PersonProvider中,我们定义了授权地址为“com.scott.provider.PersonProvider”,相信大家在前面也有所了解了。基于这个授权,我们使用了一个UriMatcher对其路径进行匹配,“[BASE_URI]/persons"和“[BASE_URI]/persons/#”这两种路径我们在上面也介绍过,分别对应记录集合和单个记录的操作。在query、insert、update和delete方法中我们根据UriMatcher匹配结果来判断该URI是操作记录集合还是单条记录,从而采取不同的处理方法。在getType方法中,我们会根据匹配的结果返回不同的MIME类型,这一步是不能缺少的,比如我们在query方法中有可能是查询全部集合,有可能是查询单条记录,那么我们返回的Cursor或是集合类型,或是单条记录,这个跟getType返回的MIME类型是一致的,就好像浏览网页一样,指定的url返回的信息是什么类型,那么浏览器就应该接收到对应的MIME类型。另外,我们注意到,上面代码中,在insert、update、delete方法中都调用了notifyDataChanged方法,这个方法中仅有的一步操作就是通知“[BASE_URI]/persons"的访问者,数据发生改变了,应该重新加载了。

在我们的PersonProvider中,我们用到了Person、DBHelper类,代码如下:

package com.scott.provider; 
 
public class Person { 
  public int _id; 
  public String name; 
  public int age; 
  public String info; 
   
  public Person() { 
  } 
   
  public Person(String name, int age, String info) { 
    this.name = name; 
    this.age = age; 
    this.info = info; 
  } 
} 
[java] view plain copy
package com.scott.provider; 
 
import android.content.Context; 
import android.database.sqlite.SQLiteDatabase; 
import android.database.sqlite.SQLiteOpenHelper; 
 
public class DBHelper extends SQLiteOpenHelper { 
 
  private static final String DATABASE_NAME = "provider.db"; 
  private static final int DATABASE_VERSION = 1; 
   
  public DBHelper(Context context) { 
    super(context, DATABASE_NAME, null, DATABASE_VERSION); 
  } 
 
  @Override 
  public void onCreate(SQLiteDatabase db) { 
    String sql = "CREATE TABLE IF NOT EXISTS person" + 
        "(_id INTEGER PRIMARY KEY AUTOINCREMENT, name VARCHAR, age INTEGER, info TEXT)"; 
    db.execSQL(sql); 
  } 
 
  @Override 
  public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
    db.execSQL("DROP TABLE IF EXISTS person"); 
    onCreate(db); 
  } 
} 

最后,要想让这个ContentProvider生效,我们需要在AndroidManifest.xml中声明并为其授权,如下所示:

 

其中,android:multiprocess代表是否允许多进程操作。另外我们也可以为其声明相应的权限,对应的属性是:android:permission。

2.调用PersonProvider类:

完成了person的ContentProvider后,下面我们来看一下如何访问它。这一步我们在MainActivity中完成,看下面代码:

package com.scott.provider; 
 
import java.util.ArrayList; 
 
import android.app.Activity; 
import android.content.ContentResolver; 
import android.content.ContentUris; 
import android.content.ContentValues; 
import android.database.Cursor; 
import android.database.CursorWrapper; 
import android.net.Uri; 
import android.os.Bundle; 
import android.os.Handler; 
import android.os.Message; 
import android.view.View; 
import android.widget.ListView; 
import android.widget.SimpleCursorAdapter; 
 
 
public class MainActivity extends Activity { 
   
  private ContentResolver resolver; 
  private ListView listView; 
   
  private static final String AUTHORITY = "com.scott.provider.PersonProvider"; 
  private static final Uri PERSON_ALL_URI = Uri.parse("content://" + AUTHORITY + "/persons"); 
   
  private Handler handler = new Handler() { 
    public void handleMessage(Message msg) { 
      //update records. 
      requery(); 
    }; 
  }; 
   
  @Override 
  public void onCreate(Bundle savedInstanceState) { 
    super.onCreate(savedInstanceState); 
    setContentView(R.layout.main); 
 
    resolver = getContentResolver(); 
    listView = (ListView) findViewById(R.id.listView); 
     
    //为PERSON_ALL_URI注册变化通知 
    getContentResolver().registerContentObserver(PERSON_ALL_URI, true, new PersonObserver(handler)); 
  } 
   
  /** 
   * 初始化 
   * @param view 
   */ 
  public void init(View view) { 
    ArrayList persOns= new ArrayList(); 
     
    Person person1 = new Person("Ella", 22, "lively girl"); 
    Person person2 = new Person("Jenny", 22, "beautiful girl"); 
    Person person3 = new Person("Jessica", 23, "sexy girl"); 
    Person person4 = new Person("Kelly", 23, "hot baby"); 
    Person person5 = new Person("Jane", 25, "pretty woman"); 
     
    persons.add(person1); 
    persons.add(person2); 
    persons.add(person3); 
    persons.add(person4); 
    persons.add(person5); 
 
    for (Person person : persons) { 
      ContentValues values = new ContentValues(); 
      values.put("name", person.name); 
      values.put("age", person.age); 
      values.put("info", person.info); 
      resolver.insert(PERSON_ALL_URI, values); 
    } 
  } 
   
  /** 
   * 查询所有记录 
   * @param view 
   */ 
  public void query(View view) { 
//   Uri persOnOneUri= ContentUris.withAppendedId(PERSON_ALL_URI, 1);查询_id为1的记录 
    Cursor c = resolver.query(PERSON_ALL_URI, null, null, null, null); 
     
    CursorWrapper cursorWrapper = new CursorWrapper(c) { 
       
      @Override 
      public String getString(int columnIndex) { 
        //将简介前加上年龄 
        if (getColumnName(columnIndex).equals("info")) { 
          int age = getInt(getColumnIndex("age")); 
          return age + " years old, " + super.getString(columnIndex); 
        } 
        return super.getString(columnIndex); 
      } 
    }; 
     
    //Cursor须含有"_id"字段 
    SimpleCursorAdapter adapter = new SimpleCursorAdapter(this, android.R.layout.simple_list_item_2, 
        cursorWrapper, new String[]{"name", "info"}, new int[]{android.R.id.text1, android.R.id.text2}); 
    listView.setAdapter(adapter); 
     
    startManagingCursor(cursorWrapper); //管理Cursor 
  } 
   
  /** 
   * 插入一条记录 
   * @param view 
   */ 
  public void insert(View view) { 
    Person person = new Person("Alina", 26, "attractive lady"); 
    ContentValues values = new ContentValues(); 
    values.put("name", person.name); 
    values.put("age", person.age); 
    values.put("info", person.info); 
    resolver.insert(PERSON_ALL_URI, values); 
  } 
   
  /** 
   * 更新一条记录 
   * @param view 
   */ 
  public void update(View view) { 
    Person person = new Person(); 
    person.name = "Jane"; 
    person.age = 30; 
    //将指定name的记录age字段更新为30 
    ContentValues values = new ContentValues(); 
    values.put("age", person.age); 
    resolver.update(PERSON_ALL_URI, values, "name = ?", new String[]{person.name}); 
     
    //将_id为1的age更新为30 
//   Uri updateUri = ContentUris.withAppendedId(PERSON_ALL_URI, 1); 
//   resolver.update(updateUri, values, null, null); 
  } 
   
  /** 
   * 删除一条记录 
   * @param view 
   */ 
  public void delete(View view) { 
    //删除_id为1的记录 
    Uri delUri = ContentUris.withAppendedId(PERSON_ALL_URI, 1); 
    resolver.delete(delUri, null, null); 
     
    //删除所有记录 
//   resolver.delete(PERSON_ALL_URI, null, null); 
  } 
   
  /** 
   * 重新查询 
   */ 
  private void requery() { 
    //实际操作中可以查询集合信息后Adapter.notifyDataSetChanged(); 
    query(null); 
  } 
} 

我们看到,在上面的代码中,分别对应每一种情况进行测试,相对较为简单。我们主要讲一下registerContentObserver这一环节。

在前面的PersonProvider我们也提到,在数据更改后,会向指定的URI访问者发出通知,以便于更新查询记录。大家注意,仅仅是ContentProvider出力还不够,我们还需要在访问者中注册一个ContentObserver,才能够接收到这个通知。下面我们创建一个

PersonObserver:
package com.scott.provider; 
 
import android.database.ContentObserver; 
import android.os.Handler; 
import android.os.Message; 
import android.util.Log; 
 
public class PersonObserver extends ContentObserver { 
 
  public static final String TAG = "PersonObserver"; 
  private Handler handler; 
   
  public PersonObserver(Handler handler) { 
    super(handler); 
    this.handler = handler; 
  } 
   
  @Override 
  public void onChange(boolean selfChange) { 
    super.onChange(selfChange); 
    Log.i(TAG, "data changed, try to requery."); 
    //向handler发送消息,更新查询记录 
    Message msg = new Message(); 
    handler.sendMessage(msg); 
  } 
} 

这样一来,当ContentProvider发来通知之后,我们就能立即接收到,从而向handler发送一条消息,重新查询记录,使我们能够看到最新的记录信息。

最后,我们要在AndroidManifest.xml中为MainActivity添加MIME类型过滤器,告诉系统MainActivity可以处理的信息类型:

 
 
   
 
 
   
 

这样就完成了访问者的代码,我们来看一下效果:

鉴于操作类型太多,我在这里就不再展示了,大家可以自己试一试。

原文链接:http://blog.csdn.net/liuhe688/article/details/7050868

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。


推荐阅读
  • 本文介绍了如何通过在数据库表中增加一个字段来记录文章的访问次数,并提供了一个示例方法用于更新该字段值。 ... [详细]
  • 本文详细介绍了如何解决 Microsoft SQL Server 中用户 'sa' 登录失败的问题。错误代码为 18470,提示该帐户已被禁用。我们将通过 Windows 身份验证方式登录,并启用 'sa' 帐户以恢复其访问权限。 ... [详细]
  • ListView简单使用
    先上效果:主要实现了Listview的绑定和点击事件。项目资源结构如下:先创建一个动物类,用来装载数据:Animal类如下:packagecom.example.simplelis ... [详细]
  • 本文详细介绍了 Android 开发中 layout_gravity 属性的使用方法及其在不同布局下的效果,旨在帮助开发者更好地理解和利用这一属性来精确控制视图的布局。 ... [详细]
  • 本文深入探讨了 Exchange Server 2010 中客户端访问的代理和重定向机制,特别是在跨站点环境中如何配置这些功能以确保用户能够顺利访问邮箱服务。通过详细解析不同场景下的应用,帮助管理员更好地理解和实施相关设置。 ... [详细]
  • TortoiseSVN与VisualSVN Server的安装及基本操作指南
    本文详细介绍了如何安装VisualSVN Server以及TortoiseSVN客户端,并提供了基本的操作步骤,包括配置仓库、用户管理及权限设置等关键环节。 ... [详细]
  • Servlet过滤器入门:实现与配置
    本文介绍如何在Java Web应用中实现和配置Servlet过滤器,通过实现`javax.servlet.Filter`接口来创建过滤器,并详细说明其在web.xml文件中的配置方法。 ... [详细]
  • 本文详细介绍了Java中实现异步调用的多种方式,包括线程创建、Future接口、CompletableFuture类以及Spring框架的@Async注解。通过代码示例和深入解析,帮助读者理解并掌握这些技术。 ... [详细]
  • 本文详细介绍了一种高效的算法——线性筛法,用于快速筛选出一定范围内的所有素数。通过该方法,可以显著提高求解素数问题的效率。 ... [详细]
  • 本文详细介绍了get和set方法的作用及其在编程中的实现方式,同时探讨了点语法的使用场景。通过具体示例,解释了属性声明与合成存取方法的概念,并补充了相关操作的最佳实践。 ... [详细]
  • 搭建Jenkins、Ant与TestNG集成环境
    本文详细介绍了如何在Ubuntu 16.04系统上配置Jenkins、Ant和TestNG的集成开发环境,涵盖从安装到配置的具体步骤,并提供了创建Windows Slave节点及项目构建的指南。 ... [详细]
  • Vue 开发与调试工具指南
    本文介绍了如何使用 Vue 调试工具,包括克隆仓库、安装依赖包、构建项目以及在 Chrome 浏览器中加载扩展的详细步骤。 ... [详细]
  • MySQL Debug 模式的实现与应用
    本文详细介绍了如何启用和使用 MySQL 的调试模式,包括编译选项、环境变量配置以及调试信息的解析。通过实际案例展示了如何利用调试模式解决客户端无法连接服务器的问题。 ... [详细]
  • 如何从python读取sql[mysql基础教程]
    从python读取sql的方法:1、利用python内置的open函数读入sql文件;2、利用第三方库pymysql中的connect函数连接mysql服务器;3、利用第三方库pa ... [详细]
  • 本文探讨了天才与疯子之间的微妙界限,介绍了如何利用巨人的工具提升自我,以及如何通过科学决策、数据洞察和智慧的尺度来指导我们的生活和工作。 ... [详细]
author-avatar
宝贝娜娜121_562
这个家伙很懒,什么也没留下!
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有