Android开源项目-Jamendo音乐播放器研究与优化-基于Builder模式的数据库操作
【一个音符的时值按二等分的原则，成偶数细分下去，称为音符时值的基本划分】
--- 《五线谱基础教程》
对于一个完整的应用来说，数据库操作往往是避免不来的，Jamendo基于生成器模式（Builder Pattern）构建数据库操作的整个框架。那么首先看下生成器模式的定义：将一个复杂对象的构建与它的表示分离，使得同样的构建过程可以创建不同的表示。
典型结构图如下所示：
主要涉及四个角色，分别是：
1）Builder：生成器接口，定义创建一个Product对象所需的各个部件的操作；
2）ConcreteBuilder：具体的生成器实现，实现各个部件的创建，并负责组装Product对象的各个部件，同时提供给用户一个获取组装完成后的Product对象的方法；
3）Director：指导者，主要用于调用Builder接口，以一个统一的过程来构建所需的Product对象；
4）Product：产品，表示被生成器创建的复杂对象，包含各个部件。
接下来看下Jamendo中怎样使用Builder模式实现数据库相关操作：
一 Builder角色
Jamendo中Builder角色由DatabaseBuilder来充当，由于不知道具体的Product对象是什么类型，所以使用泛型表示，如下所示，改抽象类中定义了两个接口，是一个相反的过程，分别是由数据库游标Cursor对象创建出Product对象，以及从Product对象构造出适合数据库操作的ContentValues对象。
public abstract class DatabaseBuilder<T> {// 根据传入的Cursor对象构建Product对象public abstract T build(Cursor c);// 和build方法相反的过程，从Product对象得到适合数据库操作的ContentValues对象public abstract ContentValues deconstruct(T t);}二 ConcreteBuilder角色以及Product角色
在Eclipse的Type Hierarchy视图中可以看出ConcreteBuilder角色有四个，如图所示：
下面重点结合音乐播放的业务逻辑分别进行介绍：
1）TrackDatabaseBuilder类和Track产品类
Track类维护专辑的音轨信息，主要包括ID、名称、持续时间、歌词链接、数据流链接、评分、序号等信息，如下图所示：
TrackDatabaseBuilder类的职责就是将Track产品类的信息和数据库关联起来，如代码所示：
/** * 音轨信息的数据库生成类 * */public class TrackDatabaseBuilder extends DatabaseBuilder<Track> {private static final String TRACK_ID = "track_id"; // IDprivate static final String TRACK_NAME = "track_name"; // 名称private static final String TRACK_DURATION = "track_duration"; // 持续时间private static final String TRACK_URL = "track_url"; // 歌词的链接private static final String TRACK_STREAM = "track_stream"; // 数据流的链接private static final String TRACK_RATING = "track_rating"; // 评分private static final String ALBUM_TRACK_NUM = "album_track_num"; // 序号@Overridepublic Track build(Cursor query) {int columnName = query.getColumnIndex(TRACK_NAME);int columnStream = query.getColumnIndex(TRACK_STREAM);int columnUrl = query.getColumnIndex(TRACK_URL);int columnDuration = query.getColumnIndex(TRACK_DURATION);int columnId = query.getColumnIndex(TRACK_ID);int columnRating = query.getColumnIndex(TRACK_RATING);int columnAlbumTrackNum = query.getColumnIndex(ALBUM_TRACK_NUM);Track track = new Track();track.setDuration(query.getInt(columnDuration));track.setId(query.getInt(columnId));track.setName(query.getString(columnName));track.setRating(query.getDouble(columnRating));track.setStream(query.getString(columnStream));track.setUrl(query.getString(columnUrl));track.setNumAlbum(query.getInt(columnAlbumTrackNum));return track;}@Overridepublic ContentValues deconstruct(Track track) {ContentValues values = new ContentValues();values.put(TRACK_NAME, track.getName());values.put(TRACK_STREAM, track.getStream());values.put(TRACK_URL, track.getUrl());values.put(TRACK_DURATION, track.getDuration());values.put(TRACK_ID, track.getId());values.put(TRACK_RATING, track.getRating());values.put(ALBUM_TRACK_NUM, track.getNumAlbum());return values;}}2）AlbumDatabaseBuilder类和Album产品类
Album类表示专辑对象，主要包括专辑ID、专辑名称、专辑的封面、专辑的评分、艺术家的名称以及专辑的曲目，类定义的截图如下所示：
AlbumDatabaseBuilder类的职责就是继承DatabaseBuilder类，将上述Album类的主要信息存储到数据库中，实现数据库相关操作，如下代码所示：
/** * 专辑的数据库生成器类 */public class AlbumDatabaseBuilder extends DatabaseBuilder<Album> {private static final String ALBUM_ID = "album_id"; // 专辑IDprivate static final String ALBUM_NAME = "album_name"; // 专辑的名称private static final String ALBUM_IMAGE = "album_image"; // 专辑的封面private static final String ALBUM_RATING = "album_rating"; // 专辑的星级private static final String ARTIST_NAME = "artist_name"; // 艺术家的名字@Overridepublic Album build(Cursor query) {int columnArtistName = query.getColumnIndex(ARTIST_NAME);int columnName = query.getColumnIndex(ALBUM_NAME);int columnImage = query.getColumnIndex(ALBUM_IMAGE);int columnId = query.getColumnIndex(ALBUM_ID);int columnRating = query.getColumnIndex(ALBUM_RATING);Album album = new Album();album.setId(query.getInt(columnId));album.setArtistName(query.getString(columnArtistName));album.setName(query.getString(columnName));album.setRating(query.getDouble(columnRating));album.setImage(query.getString(columnImage));return album;}@Overridepublic ContentValues deconstruct(Album album) {ContentValues values = new ContentValues();values.put(ARTIST_NAME, album.getArtistName());values.put(ALBUM_IMAGE, album.getImage());values.put(ALBUM_NAME, album.getName());values.put(ALBUM_ID, album.getId());values.put(ALBUM_RATING, album.getRating());return values;}}3）RadioDatabaseBuilder类和Radio产品类
Radio类表示广播收音相关的信息，主要是ID、名称和对应的图像标识，代码如图所示：
RadioDatabaseBuilder类的实现方式跟上面几种类似，直接看代码：
/** * 广播信息的数据库生成类 * */public class RadioDatabaseBuilder extends DatabaseBuilder<Radio> {private static final String RADIO_ID = "radio_id"; // 广播IDprivate static final String RADIO_IDSTR = "radio_idstr"; // 广播ID的字符串形式private static final String RADIO_NAME = "radio_name"; // 广播的名称private static final String RADIO_IMAGE = "radio_image"; // 广播的图像标识private static final String RADIO_DATE = "radio_date"; // 广播信息的存库时间@Overridepublic Radio build(Cursor query) {int columnId = query.getColumnIndex(RADIO_ID);int columnIdstr = query.getColumnIndex(RADIO_IDSTR);int columnName = query.getColumnIndex(RADIO_NAME);int columnImage = query.getColumnIndex(RADIO_IMAGE);Radio radio = new Radio();radio.setId(query.getInt(columnId));radio.setIdstr(query.getString(columnIdstr));radio.setImage(query.getString(columnImage));radio.setName(query.getString(columnName));return radio;}@Overridepublic ContentValues deconstruct(Radio radio) {ContentValues values = new ContentValues();values.put(RADIO_ID, radio.getId());values.put(RADIO_IDSTR, radio.getIdstr());values.put(RADIO_NAME, radio.getName());values.put(RADIO_IMAGE, radio.getImage());values.put(RADIO_DATE, System.currentTimeMillis());return values;}}4）DownloadJobBuilder类和DownloadJob产品类
DownloadJob产品类跟之前的三个产品类不大一样，它不是纯粹的包含数据库信息，还维护了下载相关的信息，本文只分析数据库相关部分，下载部分放到后面文章分析。如下图所示，DownloadJob类中和数据库相关的只有其中的PlaylistEntry：
PlaylistEntry类是对Album类和Track类的简单封装，对外体现为播放列表信息类，定义如下所示：
DownloadJobBuilder类自然就是负责构建与反构建DownloadJob中的PlaylistEntruy信息部分，代码如下：
/** * 下载信息的数据库生成类 * */public class DownloadJobBuilder extends DatabaseBuilder<DownloadJob> {private static final String DOWNLOADED = "downloaded"; // 是否下载完成标志位(下载完成-1，下载未完成-0)@Overridepublic DownloadJob build(Cursor query) {Track track = new TrackDatabaseBuilder().build(query);Album album = new AlbumDatabaseBuilder().build(query);// 封装成播放列表类PlaylistEntry pEntry = new PlaylistEntry();pEntry.setAlbum(album);pEntry.setTrack(track);DownloadJob dJob = new DownloadJob(pEntry,DownloadHelper.getDownloadPath(), 0, JamendoApplication.getInstance().getDownloadFormat());// 查询下载进度int progress = query.getInt(query.getColumnIndex(DOWNLOADED));if (progress == 1) {dJob.setProgress(100);}return dJob;}@Overridepublic ContentValues deconstruct(DownloadJob t) {ContentValues values = new ContentValues();values.putAll(new TrackDatabaseBuilder().deconstruct(t.getPlaylistEntry().getTrack()));values.putAll(new AlbumDatabaseBuilder().deconstruct(t.getPlaylistEntry().getAlbum()));values.put(DOWNLOADED, (t.getProgress() == 100) ? 1 : 0);return values;}}三 Director角色
Director角色调用Builder角色提供的接口，以统一的方式来构建所需要的Product角色，Jamendo中操作数据库Builder角色的Director角色有两个，分别是DatabaseImpl类和DownloadDatabaseImpl类，类图如下所示：
其中DatabaseImpl类是AlbumDatabaseBuilder、TrackDatabaseBuilder和RadioDatabaseBuilder类的指导者；
DownloadDatabaseImpl类是AlbumDatabaseBuilder和TrackDatabaseBuilder和DownloadJobBuilder类的指导者。
下面简单看下DatabaseImpl中调用Builder角色类的部分代码：
