Android 开发 ContentProvider 获取歌曲列表和联系人的例子

ContentProvider（内容提供者）是Android中的四大组件之一。主要用于对外共享数据，也就是通过ContentProvider把应用中的数据共享给其他应用访问，其他应用可以通过ContentProvider对指定应用中的数据进行操作。ContentProvider分为系统的和自定义的，系统的也就是例如联系人，图片等数据。

以下这段是Google Doc中对ContentProvider的大致概述。
内容提供者将一些特定的应用程序数据供给其它应用程序使用。数据可以存储于文件系统、SQLite数据库或其它方式。内容提供者继承于ContentProvider 基类，为其它应用程序取用和存储它管理的数据实现了一套标准方法。然而，应用程序并不直接调用这些方法，而是使用一个 ContentResolver 对象，调用它的方法作为替代。ContentResolver可以与任意内容提供者进行会话，与其合作来对所有相关交互通讯进行管理。

1.ContentProvider
Android提供了一些主要数据类型的ContentProvider，比如音频、视频、图片和私人通讯录等。可在android.provider包下面找到一些Android提供的ContentProvider。通过获得这些ContentProvider可以查询它们包含的数据，当然前提是已获得适当的读取权限。
主要方法：
public boolean onCreate() 在创建ContentProvider时调用
public Cursor query(Uri, String[], String, String[], String) 用于查询指定Uri的ContentProvider，返回一个Cursor
public Uri insert(Uri, ContentValues) 用于添加数据到指定Uri的ContentProvider中
public int update(Uri, ContentValues, String, String[]) 用于更新指定Uri的ContentProvider中的数据
public int delete(Uri, String, String[]) 用于从指定Uri的ContentProvider中删除数据
public String getType(Uri) 用于返回指定的Uri中的数据的MIME类型
*如果操作的数据属于集合类型，那么MIME类型字符串应该以vnd.android.cursor.dir/开头。
例如：要得到所有person记录的Uri为content://contacts/person，那么返回的MIME类型字符串为"vnd.android.cursor.dir/person"。
*如果要操作的数据属于非集合类型数据，那么MIME类型字符串应该以vnd.android.cursor.item/开头。
例如：要得到id为10的person记录的Uri为content://contacts/person/10，那么返回的MIME类型字符串应为"vnd.android.cursor.item/person"。

2.ContentResolver
当外部应用需要对ContentProvider中的数据进行添加、删除、修改和查询操作时，可以使用ContentResolver类来完成，要获取ContentResolver对象，可以使用Context提供的getContentResolver()方法。

view plaincopy to clipboardprint?

ContentResolver cr = getContentResolver();

ContentResolver提供的方法和ContentProvider提供的方法对应的有以下几个方法。
public Uri insert(Uri uri, ContentValues values) 用于添加数据到指定Uri的ContentProvider中。
public int delete(Uri uri, String selection, String[] selectionArgs) 用于从指定Uri的ContentProvider中删除数据。
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) 用于更新指定Uri的ContentProvider中的数据。
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) 用于查询指定Uri的ContentProvider。

3.Uri
Uri指定了将要操作的ContentProvider，其实可以把一个Uri看作是一个网址，我们把Uri分为三部分。
第一部分是"content://"。可以看作是网址中的"http://"。
第二部分是主机名或authority，用于唯一标识这个ContentProvider，外部应用需要根据这个标识来找到它。可以看作是网址中的主机名，比如"blog.csdn.net"。
第三部分是路径名，用来表示将要操作的数据。可以看作网址中细分的内容路径。

// 查找sdcard卡上的所有歌曲信息
public List

// 加入封装音乐信息的代码
// 查询所有歌曲
ContentResolver musicResolver = this.getContentResolver();
Cursor musicCursor = musicResolver.query(
MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, null, null, null,
null);

int musicColumnIndex;

if (null != musicCursor && musicCursor.getCount() > 0) {
for (musicCursor.moveToFirst(); !musicCursor.isAfterLast(); musicCursor
.moveToNext()) {
Map musicDataMap = new HashMap();

Random random = new Random();
int musicRating = Math.abs(random.nextInt()) % 10;

musicDataMap.put("musicRating", musicRating);

// 取得音乐播放路径
musicColumnIndex = musicCursor
.getColumnIndex(MediaStore.Audio.AudioColumns.DATA);
musicPath = musicCursor.getString(musicColumnIndex);
musicDataMap.put("musicPath", musicPath);

// 取得音乐的名字
musicColumnIndex = musicCursor
.getColumnIndex(MediaStore.Audio.AudioColumns.TITLE);
musicName = musicCursor.getString(musicColumnIndex);
musicDataMap.put("musicName", musicName);

// 取得音乐的专辑名称
musicColumnIndex = musicCursor
.getColumnIndex(MediaStore.Audio.AudioColumns.ALBUM);
musicAlbum = musicCursor.getString(musicColumnIndex);
musicDataMap.put("musicAlbum", musicAlbum);

// 取得音乐的演唱者
musicColumnIndex = musicCursor
.getColumnIndex(MediaStore.Audio.AudioColumns.ARTIST);
musicArtist = musicCursor.getString(musicColumnIndex);
musicDataMap.put("musicArtist", musicArtist);

// 取得歌曲对应的专辑对应的Key
musicColumnIndex = musicCursor
.getColumnIndex(MediaStore.Audio.AudioColumns.ALBUM_KEY);
musicAlbumKey = musicCursor.getString(musicColumnIndex);

String[] argArr = { musicAlbumKey };
ContentResolver albumResolver = this.getContentResolver();
Cursor albumCursor = albumResolver.query(
MediaStore.Audio.Albums.EXTERNAL_CONTENT_URI, null,
MediaStore.Audio.AudioColumns.ALBUM_KEY + " = ?",
argArr, null);

if (null != albumCursor && albumCursor.getCount() > 0) {
albumCursor.moveToFirst();
int albumArtIndex = albumCursor
.getColumnIndex(MediaStore.Audio.AlbumColumns.ALBUM_ART);
musicAlbumArtPath = albumCursor.getString(albumArtIndex);
if (null != musicAlbumArtPath
&& !"".equals(musicAlbumArtPath)) {
musicDataMap.put("musicAlbumImage", musicAlbumArtPath);
} else {
musicDataMap.put("musicAlbumImage",
"file:///mnt/sdcard/alb.jpg");
}
} else {
// 没有专辑定义，给默认图片
musicDataMap.put("musicAlbumImage",
"file:///mnt/sdcard/alb.jpg");
}
musicList.add(musicDataMap);
}
}
return musicList;
}

下面是用ContentProvider读取联系人数据，属于系统数据。完整代码下载：android_contentprovider_system.rar

注意：这里的联系人操作有点乱，关键是我还不是很熟，SDK1.6和SDK2.1的联系人操作很有很大不同，希望哪位大侠指点一下。

view plaincopy to clipboardprint?

public class MainActivity extends Activity {

private EditText nameET;

private EditText numberET;

private Button insertBtn;

private Button deleteBtn;

private Button queryBtn;

private ListView contentView;

@Override

public void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.main);

nameET = (EditText) findViewById(R.id.name);

numberET = (EditText) findViewById(R.id.number);

insertBtn = (Button) findViewById(R.id.insert);

deleteBtn = (Button) findViewById(R.id.delete);

queryBtn = (Button) findViewById(R.id.query);

// 用于显示数据

contentView = (ListView) findViewById(R.id.content);

insertBtn.setOnClickListener(new OperateOnClickListener());

deleteBtn.setOnClickListener(new OperateOnClickListener());

queryBtn.setOnClickListener(new OperateOnClickListener());

}

class OperateOnClickListener implements OnClickListener {

@Override

public void onClick(View v) {

String name = nameET.getText().toString();

String number = numberET.getText().toString();

Person p = new Person(name, number);

switch (v.getId()) {

// 插入数据

case R.id.insert:

insert(p);

view();

break;

// 删除数据

case R.id.delete:

delete(name);

view();

break;

// 查询数据

case R.id.query:

view();

break;

}

}

}

// 显示数据

private void view() {

Cursor c = query("");

ListAdapter listAdapter = new SimpleCursorAdapter(this, R.layout.list,

c, new String[] { People._ID, People.NAME, People.NUMBER },

new int[] { R.id.id, R.id.name, R.id.number });

contentView.setAdapter(listAdapter);

}

// 插入联系人

private void insert(Person p) {

// 获得ContentResolver对象

ContentResolver cr = getContentResolver();

ContentValues values = new ContentValues();

values.put(People.NAME, p.name);

// 表示是否把联系人添加到收藏（加星），1表示加入，0表示不加入，这行代码注释默认是不加入。

values.put(Contacts.People.STARRED, 1);

Uri uri = Contacts.People.createPersonInMyContactsGroup(cr, values);

// 获得联系人People表的Uri

Uri url = Uri.withAppendedPath(uri,

Contacts.People.Phones.CONTENT_DIRECTORY);

values.clear();

values.put(Contacts.Phones.TYPE, Contacts.Phones.NUMBER);

values.put(Contacts.Phones.NUMBER, p.number);

// 插入操作

cr.insert(url, values);

}

// 插入联系人

private void delete(String name) {

// 获得ContentResolver对象

ContentResolver cr = getContentResolver();

Uri url = Contacts.People.CONTENT_URI;

// 设置删除条件

String where = People.NAME + "=?";

String[] selectionArgs = { name };

cr.delete(url, where, selectionArgs);

}

// 查询联系人

private Cursor query(String name) {

// 获得ContentResolver对象

ContentResolver cr = getContentResolver();

Uri uri = Contacts.People.CONTENT_URI;

// 查询对象

String[] projection = { People._ID, People.NAME, People.NUMBER };

// 设置查询条件，这里我把selection和selectionArgs参数都设为null，表示查询全部数据

String selection = null;

String[] selectionArgs = null;

if (!"".equals(name)) {

selection = People.NAME + "=?";

selectionArgs = new String[] { name };

}

// 设置排序条件

String sortOrder = Contacts.People._ID;

Cursor c = cr.query(uri, projection, selection, selectionArgs,

sortOrder);

// if (c.moveToFirst()) {

// for (int i = 0; i < c.getCount(); i++) {

// c.moveToPosition(i);

// String name = c.getString(c.getColumnIndexOrThrow(People.NAME));

// String number = c.getString(c

// .getColumnIndexOrThrow(People.NUMBER));

// }

// }

return c;

}

}