手把手教你做音乐播放器（五）音乐列表的存储（上）

第5节 播放列表的存取

关于播放列表的存取需要三个组件的协同配合，

1. MusicListActivity：让用户选择多首或一首音乐，将用户的选择项，传递给MusicService；
2. MusicService：接收到添加列表的请求后，把数据交给PlayListContentProvider，进行存储；
3. PlayListContentProvider：将播放列表存储到SQLite数据库中；

5.1 PlayListContentProvider的实现

自定义的ContentProvider与系统自带的ContentProvider在设计和用法上都是一样的。

5.1.1 地址设计

我们首先来学习一下ContentProvider的Uri地址。

任何对数据的操作范围无外乎，

• 单条数据的操作：每一次操作增加一条数据，删除一条数据，修改一条数据，查询特定一条数据的详细内容；
• 多条数据的操作：每一次操作增加多条数据，删除多条数据，修改多条数据，查询符合某个特征的多条数据；

例如，我们可能会向书架上“一次放一本书”－单条增，“一次取下一本书”－单条删，“一次问书架上有多少书”－多条查。

因此，仿照网站地址的设计方式，我们可以用如下的“网络地址”来表达我们希望进行的对ContentProvider的操作是针对单一一条数据还是同时多条数据：

• xxx.xxx.xxx/items/1：针对单一一条数据，最后的数字代表特定一本书的编号（也可以使用书的名字来代替）；
• xxx.xxx.xxx/items：针对多条数据；

“网站”只要看到以上的格式就知道，要操作的是一条数据还是多条数据了。

每个ContentProvider就是一个“网站”，每个网站都有自己的“网址”。安卓系统为这个“网址”设计了如下的结构，

scheme://authority/path

1. scheme：固定为“content”，相当于一个网址的“http”；
2. authority：由开发者自己确定，通常把它写成这个ContentProvider的包名，例如“com.anddle.mycontentprovider”，它就相当于网址的地址“www.google.com”;
3. path：根据查询内容的逻辑，由开发者自己决定，通常要分成多条数据和单一数据两类；

典型的例子就像这样，

多条数据content://com.anddle.mycontentprovider/items单一数据content://com.anddle.mycontentprovider/items/1

这里面，
scheme：“content”
authority：“com.anddle.mycontentprovider”
path：“items”或者“items/1”

只要定义好了前面两种原则，外界（其他组件或者其他应用）就可以获取到ContentProvider中的内容了。

Uri的scheme字段是固定的，使用content:。

authority定义成程序的包名com.anddle.mycontentprovider。

path就像是网站内部的分类，依据网站的逻辑进行划分。
假设我们的ContentProvider提供书籍book和文件file两种内容的查询操作。而每种类型都可以进行单一数据的操作和多条数据的操作。

例如，

• 操作所有书的信息：content://com.anddle.mycontentprovider/books;
• 操作某本特定书的信息：content://com.anddle.mycontentprovider/books/8

针对我们这个音乐的例子，它的URI地址可能就是，

• 操作多首音乐：content://com.anddle.anddlemusicprovider/songs;
• 操作某首特定音乐：content://com.anddle.anddlemusicprovider/songs/8

5.1.2 创建ContentProvider

1. 继承ContentProvider类，会要求我们实现getType() insert() delete() update() query() onCreate()等接口，

   public class PlayListContentProvider extends ContentProvider {    @Override    public boolean onCreate() {        return true;    }    @Override    public String getType(Uri uri) {        throw new UnsupportedOperationException("Not yet implemented");    }    @Override    public Uri insert(Uri uri, ContentValues values) {        throw new UnsupportedOperationException("Not yet implemented");    }    @Override    public int delete(Uri uri, String selection, String[] selectionArgs) {        throw new UnsupportedOperationException("Not yet implemented");    }    @Override    public int update(Uri uri, ContentValues values, String selection,                      String[] selectionArgs) {        throw new UnsupportedOperationException("Not yet implemented");    }    @Override    public Cursor query(Uri uri, String[] projection, String selection,                        String[] selectionArgs, String sortOrder) {        throw new UnsupportedOperationException("Not yet implemented");    }}

2. 定义提供给其他组件使用的“网络地址”URI，这里我们把它们定义成content://com.anddle.PlayListContentProvider/songs，

   public class PlayListContentProvider extends ContentProvider {    private static final String SCHEME = "content://";    private static final String PATH_SONGS = "/songs";    public static final String AUTHORITY = "com.anddle.PlayListContentProvider";    //"content://com.anddle.PlayListContentProvider/songs"    public static final Uri CONTENT_SONGS_URI = Uri.parse(SCHEME + AUTHORITY + PATH_SONGS);......｝

3. 在响应函数中，根据Uri，做对应的操作，例如insert()函数中，就要实现对数据增插入的真正操作，不过现在我们把操作数据库的操作留到后面来讲解

   @Overridepublic Uri insert(Uri uri, ContentValues values) {    Uri result = null;
    //从ContentValues中取出数据，保存起来；返回保存数据的Uri地址，例如    //content://com.anddle.PlayListContentProvider/songs/1    //具体的插入方式我们在后面讲解    return result;}

   类似的，其他delete() update() query()实现的函数做相同的处理。

4. 对于getType(), 需要为每一种类型的Uri返回一种数据类型－MIME type，告诉调用者，当前这种Uri可以处理什么类型的数据。

   它的格式型如type\subtype，有很多知名的MIME type类型，例如application/pdf image/jpeg等等，可以在网上查找到公开的MIME type类型有哪些。也可以自定义自己应用支持的特殊MIME type类型。

   这里我们就返回一个空值，

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

至此，一个ContentProvider的就完成了。不过它现在还没有添加上真正可以存储数据的功能。

5.1.3 声明ContentProvider

千万不要忘记，在应用的AndroidManifest.xml文件中，声明新添加的ContentProvider，

<provider    android:name=".MyContentProvider"    android:authorities="com.anddle.PlayListContentProvider"    android:enabled="true"    android:exported="true" />

这里的android:authorities属性值，就要填写定义MyContentProvider时，代码中的那个，

public static final String AUTHORITY = "com.anddle.PlayListContentProvider";

android:exported属性如何设置成true，说明这个ContentProvider可以被其他应用使用（就像一个公共网站，可以被任何人访问），如果设置成false，说明它只能被自己所在的应用使用（就像一个内部网站，只能在公司内部访问）。

5.1.4 使用Android Studio创建

上面介绍了创建ContentProvider的原理，如果使用Android Studio做开发，可以更加方便的为我们创建ContentProvider相关的代码，

1. 在项目上点击右键，选择New->other->ContentProvider

   

2. 在弹出的对话中，填写上ContentProvider的名字和自定义的authorities，并选择Finish，

   

创建成功后，自定义的ContentProvider框架就自动帮我们实现了；同时，替我们在AndroidManifest.xml文件中完成了对它的注册。剩下的就是要我们向里面添加自己的逻辑代码了。

从这里也能看到使用Android Studion开发环境的便利之处。

5.1.5 数据库存储

创建了ContentProvider后，它还只是虚有其表，不能保存任何数据。要保存数据，通常会让它使用数据库的方式实现。

1. 假设数据库的名字叫做playlist.db，播放列表将存储在该数据库名叫playlist_table的表中。

   该表的结构如下，

   id name last_play_time song_uri album_uri duration 1 国歌 0 xxxx xxxx 13908888 2 小苹果 0 xxxx xxxx 13908888 3 回家 0 xxxx xxxx 13908888

   其中，这些字段对应的数据类型分别是：
   id：自增的int型数据，作为每条数据的主键，每插入一条数据，该值将被数据库自动分配；
   name：字符类型的数据，存放歌曲的名称；
   last_play_time：long型数据，以毫秒为单位，记录该音乐上次播放到的时间；
   song_uri：字符型数据，记录每首音乐的uri地址，例如xxxxx；
   album_uri：字符型数据，记录每首音乐封面的uri地址，例如xxxxx；
   duration：long型数据，以毫秒为单位，记录该音乐一共可以播放的时长；

2. 安卓系统为我们提供了一个方便的使用SQLite数据库的工具类SQLiteOpenHelper，通过它来创建、更新或者删除SQLite数据库。

   1. 继承SQLiteOpenHelper，并定义数据库中使用的表名称和字段；继承的时候，需要我们一定实现onCreate()和onUpgrade()函数，前者实现对数据库的创建，后者告知开发者，数据库的版本有变化，让开发者有机会重新组织已存储的数据，

      public class DBHelper extends SQLiteOpenHelper {    private final static String DB_NAME = "playlist.db";    private final static int DB_VERSION = 1;    public final static String PLAYLIST_TABLE_NAME = "playlist_table";    public final static String ID = "id";    public final static String NAME = "name";    public final static String LAST_PLAY_TIME = "last_play_time";    public final static String SONG_URI = "song_uri";    public final static String ALBUM_URI = "album_uri";    public final static String DURATION = "duration";    public DBHelper(Context context) {        super(context, DB_NAME, null, DB_VERSION);    }    @Override    public void onCreate(SQLiteDatabase db) {    }    @Override    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {    }}

   2. 创建数据库和更新数据库；

      public class DBHelper extends SQLiteOpenHelper {    private final static String DB_NAME = "playlist.db";    private final static int DB_VERSION = 1;    public final static String PLAYLIST_TABLE_NAME = "playlist_table";    public final static String ID = "id";    public final static String NAME = "name";    public final static String LAST_PLAY_TIME = "last_play_time";    public final static String SONG_URI = "song_uri";    public final static String ALBUM_URI = "album_uri";    public final static String DURATION = "duration";    public DBHelper(Context context) {        super(context, DB_NAME, null, DB_VERSION);    }    @Override    public void onCreate(SQLiteDatabase db) {        //创建播放列表的存储表项        String PLAYLIST_TABLE_CMD = "CREATE TABLE " + PLAYLIST_TABLE_NAME        + "("        + ID + " INTEGER PRIMARY KEY AUTOINCREMENT,"        + NAME +" VARCHAR(256),"        + LAST_PLAY_TIME +" LONG,"        + SONG_URI +" VARCHAR(128),"        + ALBUM_URI +" VARCHAR(128),"        + DURATION + " LONG"        + ");" ;        db.execSQL(PLAYLIST_TABLE_CMD);    }    @Override    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {        //如果遇到数据库更新，我们简单的处理为删除以前的表，重新创建一张        db.execSQL("DROP TABLE IF EXISTS "+ PLAYLIST_TABLE_NAME);        onCreate(db);    }}

   3. PlayListContentProvider的增删改查工作，将依赖于我们刚创建的DBHelper，

      1. 创建DBHelper，

         public class PlayListContentProvider extends ContentProvider {    //声明成员变量，mDBHelper将帮助我们操作SQLite数据库    private DBHelper mDBHelper;    ......    @Override    public boolean onCreate() {        //ContentProvider被创建的时候，获取DBHelper对象        mDBHelper = new DBHelper(getContext());        return true;    }    ......}

      2. 添加播放列表的操作，每次向数据库插入一条信息，

         public class PlayListContentProvider extends ContentProvider {    ......    //实现insert函数    @Override    public Uri insert(Uri uri, ContentValues values) {        Uri result = null;        //通过DBHelper获取写数据库的方法        SQLiteDatabase db = mDBHelper.getWritableDatabase();        //将要数据ContentValues插入到数据库中        long id = db.insert(DBHelper.PLAYLIST_TABLE_NAME, null, values);        if(id > 0) {            //根据返回到id值组合成该数据项对应的Uri地址,            //假设id为8，那么这个Uri地址类似于content://com.anddle.PlayListContentProvider/songs/8            result = ContentUris.withAppendedId(CONTENT_SONGS_URI, id);        }        return result;    }    ......} 

      3. 删除播放列表的操作，我们的音乐播放器在批量添加歌曲到播放列表的时候，首先要清空所有的播放歌曲列表，并没有单独删除某一条歌曲的需要，所以在进行删除操作的时候，我们只需要将整个playlist_table清空就好了，

         public class PlayListContentProvider extends ContentProvider {    ......    //实现delete函数    @Override    public int delete(Uri uri, String selection, String[] selectionArgs) {        //通过DBHelper获取写数据库的方法        SQLiteDatabase db = mDBHelper.getWritableDatabase();        //清空playlist_table表，并将删除的数据条数返回        int count = db.delete(DBHelper.PLAYLIST_TABLE_NAME, selection, selectionArgs);        return count;    }    ......} 

      4. 修改播放列表的操作，当音乐在播放的时候，我们需要记录下档前音乐的播放进度，就要把这个信息更新到现有的数据库当中，

         public class PlayListContentProvider extends ContentProvider {    ......    //实现update函数    @Override    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {        //通过DBHelper获取写数据库的方法        SQLiteDatabase db = mDBHelper.getWritableDatabase();        //更新数据库的指定项        int count = db.update(DBHelper.PLAYLIST_TABLE_NAME, values, selection, selectionArgs);        return count;    }    ......} 

      5. 查询播放列表的操作，当用户想查看当前播放的音乐列表时，查询播放列表中有哪些音乐，

         public class PlayListContentProvider extends ContentProvider {    ......    //实现query函数    @Override    public Cursor query(Uri uri, String[] projection, String selection,                        String[] selectionArgs, String sortOrder) {        //通过DBHelper获取读数据库的方法        SQLiteDatabase db = mDBHelper.getReadableDatabase();        //查询数据库中的数据项        Cursor cursor = db.query(DBHelper.PLAYLIST_TABLE_NAME, projection, selection, selectionArgs, null, null, sortOrder);        return cursor;    }    ......} 

      ---

      至此，一个功能完整的ContentProvider就实现了。

5.1.6 使用自定义ContentProvider

无论是使用应用自己的ContentProvider还是使用其他应用提供的，它们的使用方式都和使用系统提供的ContentProvider一样，

1. 添加一条数据数据：通过ContentResolver获取访问ContentProvider的入口，使用ContentValues添加要插入的数据；

   //获取要插入的音乐信息MusicItem item = xxx;//准备要保存的数据ContentValues cv = new ContentValues();cv.put(DBHelper.NAME, item.name);cv.put(DBHelper.DURATION, item.duration);cv.put(DBHelper.LAST_PLAY_TIME, item.playedTime);cv.put(DBHelper.SONG_URI, item.songUri.toString());cv.put(DBHelper.ALBUM_URI, item.albumUri.toString());//通过ContentProvider插入数据Uri uri = getContentResolver().insert(PlayListContentProvider.CONTENT_SONGS_URI, cv);

   通常会返回指向刚成功插入的这条数据的Uri（内容就如content://com.anddle.PlayListContentProvider/songs/8）。

2. 删除一条数据：通过ContentResolver获取访问ContentProvider的入口，使用Uri删除指定的数据；

   Uri uri = PlayListContentProvider.CONTENT_SONGS_URI；String where = null;String [] keywords = null;ContentResolver cr = getContentResolver();cr.delete(uri, where, keywords);

3. 修改一条数据：通过ContentResolver获取访问ContentProvider的入口，使用Uri更新指定的数据，要修改的数据放在ContentValues当中；

   Uri uri = PlayListContentProvider.CONTENT_SONGS_URI；String where = “字段值满足的条件，是一条SQL语句”;String [] keywords = null;ContentResolver cr = getContentResolver();ContentValues cv = new ContentValues();cv.put("数据字段名称", "新数据内容",where,keywords);cr.update(Uri.parse(uri, cv, where, keywords);

4. 查询某一类的数据（或者特定某条数据），

   Uri uri = PlayListContentProvider.CONTENT_SONGS_URI；String[] searchKey = null;String where = null;String [] keywords = null;String sortOrder = null;ContentResolver resolver = getContentResolver();Cursor cursor = resolver.query(                    uri,                    searchKey,                     where,                     keywords,                     sortOrder);if(cursor != null) {    while(cursor.moveToNext()) {           ......      }    cursor.close();}

5. 在AndroidManifest.xml文件中，要添加上读写磁盘的权限，这样才能成功的读取和保存数据，

   <manifest xmlns:android="http://schemas.android.com/apk/res/android"    package="com.anddle.anddlemusic">    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />    <application>        ......    </application>    ......</manifest>

注意，在删改查的操作中，还会使用诸如where sortOrder keywords searchKey这样的参数，它们是辅助ContentProvider查询特定数据时用的。

---

/*******************************************************************/
* 版权声明
* 本教程只在CSDN和安豆网发布，其他网站出现本教程均属侵权。

*另外，我们还推出了Arduino智能硬件相关的教程，您可以在我们的网店跟我学Arduino编程中购买相关硬件。同时也感谢大家对我们这些码农的支持。

*最后再次感谢各位读者对安豆的支持，谢谢:)
/*******************************************************************/