Android數據庫高手秘籍(七)——體驗LitePal的查詢藝術

經過了多篇文章的學習，我們已經把LitePal中的絕大部分內容都掌握了。現在回想起來了，增刪改查四種操作中的前三種我們都已經學完了，不知道現在使用起數據庫來，你有沒有感覺到格外的輕松和簡單。但是呢，我們都知道，在所有的數據庫操作當中，查詢操作肯定是最復雜的，用法也是最多的，因此LitePal在查詢方面提供的API也是比較豐富，而且LitePal在查詢方面的API設計也是頗為藝術的。那麼今天我們就專門使用一篇博客來講解一下查詢操作的用法，體驗一下LitePal查詢的藝術。還沒有看過前面一篇文章的朋友建議先去參考 Android數據庫高手秘籍(六)——LitePal的修改和刪除操作 。

傳統的查詢數據方式

其實最傳統的查詢數據的方式當然是使用SQL語句了，Android當中也提供了直接使用原生SQL語句來查詢數據庫表的方法，即SQLiteDatabase中的rawQuery()方法，方法定義如下：

public Cursor rawQuery(String sql, String[] selectionArgs)

當然這種用法其實並不是很常用，因為相信大多數人都還是不喜歡編寫SQL語句的。所以，Android專門提供了一種封裝好的API，使得我們不用編寫SQL語句也能查詢出數據，即SQLiteDatabase中的query()方法。query()提供了三個方法重載，其中參數最少的一個也有七個參數，我們來看下方法定義：

public Cursor query(String table, String[] columns, String selection,
            String[] selectionArgs, String groupBy, String having,
            String orderBy)

其中第一參數是表名，表示我們希望從哪張表中查詢數據。第二個參數用於指定去查詢哪幾列，如果不指定則默認查詢所有列。第三、第四個參數用於去約束查詢某一行或某幾行的數據，不指定則默認是查詢所有行的數據。第五個參數用於指定需要去group by的列，不指定則表示不對查詢結果進行group by操作。第六個參數用於對group by之後的數據進行進一步的過濾，不指定則表示不進行過濾。第七個參數用於指定查詢結果的排序方式，不指定則表示使用默認的排序方式。

這個方法是query()方法最少的一個方法重載了，另外還有兩個方法重載分別是八個和九個參數。雖說這個方法在Android數據庫表查詢的時候非常常用，但重多的參數讓我們在理解這個方法的時候可能會很費力，另外使用起來的時候也會相當的不爽。比如說，我們想查詢news表中的所有數據，就應該要這樣寫：

SQLiteDatabase db = dbHelper.getWritableDatabase();
Cursor cursor = db.query(news, null, null, null, null, null, null);

可以看到，將第一個表名參數指定成news，然後後面的六個參數我們都用不到，就全部指定成null。

那如果是我們想查詢news表中所有評論數大於零的新聞該怎麼寫呢？代碼如下所示：

SQLiteDatabase db = dbHelper.getWritableDatabase();
Cursor cursor = db.query(news, null, commentcount>?, new String[]{0}, null, null, null);

然後我們可以看到，query()方法的返回值是一個Cursor對象，所有查詢到的數據都是封裝在這個對象中的，所以我們還需要將數據逐一從Cursor對象中取出，然後設置到News實體類當中，如下所示：

List newsList = new ArrayList();
if (cursor != null && cursor.moveToFirst()) {
	do {
		int id = cursor.getInt(cursor.getColumnIndex(id));
		String title = cursor.getString(cursor.getColumnIndex(title));
		String content = cursor.getString(cursor.getColumnIndex(content));
		Date publishDate = new Date(cursor.getLong(cursor.getColumnIndex(publishdate)));
		int commentCount = cursor.getInt(cursor.getColumnIndex(commentcount));
		News news = new News();
		news.setId(id);
		news.setTitle(title);
		news.setContent(content);
		news.setPublishDate(publishDate);
		news.setCommentCount(commentCount);
		newsList.add(news);
	} while (cursor.moveToNext());
}

這大概就是傳統查詢數據方式的用法了，總體來看，用法確實非常不友好，尤其是query()方法冗長的參數列表，即使我們用不到那些參數，也必須要傳入許多個null。另外，查詢到的數據還都只是封裝到了一個Cursor對象中，我們還需要將數據一一取出然後再set到實體類對象當中。麻煩嗎？可能你覺得不麻煩，因為你已經習慣了這種用法。但是習慣總是可以改變的，也許當你體驗了LitePal中查詢API給我們帶來的便利之後，就會有了新的看法了，那麼下面我們就一起來體驗一下LitePal的查詢藝術。

使用LitePal查詢數據

LitePal在查詢方面提供了非常豐富的API，功能多種多樣，基本上已經能夠滿足我們平時所有的查詢需求了。不僅如此，LitePal在查詢API的設計方面也是非常用心，摒棄了原生query()方法中繁瑣的參數列表，而是改用了一種更為靈巧的方式——連綴查詢。除此之外，LitePal查詢的結果也不再返回Cursor對象，然後再由開發者自己去逐個取出，而是直接返回封裝好的對象。這些改變都使得查詢數據變得更加簡單，也更加合理，那麼下面我們就來完整地學習一下LitePal中查詢數據的所有用法。

簡單查詢

比如說現在我們想實現一個最簡單的功能，查詢news表中id為1的這條記錄，使用LitePal就可以這樣寫：

News news = DataSupport.find(News.class, 1);

天吶！有沒有覺得太輕松了？僅僅一行代碼，就可以把news表中id為1的記錄查出來了，而且結果還是自動封裝到News對象裡的，也不需要我們手動再從Cursor中去解析。如果是用原生的SQL語句，或者query()方法來寫，至少要20行左右的代碼才能完成同樣的功能！

那我們先冷靜一下，來分析分析這個find()方法。可以看到，它的參數列表也比較簡單，只接收兩個參數，第一個參數是一個泛型類，也就是說我們在這裡指定什麼類，返回的對象就是什麼類，所以這裡傳入News.class，那麼返回的對象也就是News了。第二個參數就更簡單了，就是一個id值，如果想要查詢id為1的記錄就傳1，想查id為2的記錄就傳2，以此類推。

本來一個還算頗為復雜的功能，通過LitePal之後就變得這麼簡單了！那麼你可能已經迫不及待地想要學習更多LitePal中更多的查詢用法了，別著急，我們一個個來看。

你也許遇到過以下場景，在某些情況下，你需要取出表中的第一條數據，那麼傳統的做法是怎麼樣的呢？在SQL語句中指定一個limit值，然後獲取返回結果的第一條記錄。但是在LitePal中不用這麼麻煩，比如我們想要獲取news表中的第一條數據，只需要這樣寫：

News firstNews = DataSupport.findFirst(News.class);

那我們舉一翻三，如果是想要獲取News表中的最後一條數據該怎麼寫呢？同樣簡單，如下所示：

News lastNews = DataSupport.findLast(News.class);

那麼我們看到這裡，目前都只是查詢單條數據的功能，如果想要查詢多條數據該怎麼辦呢？比如說，我們想把news表中id為1、3、5、7的數據都查出來，該怎麼寫呢？也許有的朋友會比較聰明，立馬就想到可以一個個去查，就調用四次find()方法嘛，然後把1、3、5、7這四個id分別傳進去不就可以了。沒錯，這樣做完全是可以的，而且效率也並不低，但是LitePal給我們提供了一個更簡便的方法——findAll()。這個方法的用法和find()方法是非常類似的，只不過它可以指定多個id，並且返回值也不再是一個泛型類對象，而是一個泛型類集合，如下所示：

List newsList = DataSupport.findAll(News.class, 1, 3, 5, 7);

long[] ids = new long[] { 1, 3, 5, 7 };
List newsList = DataSupport.findAll(News.class, ids);

List allNews = DataSupport.findAll(News.class);

List newsList = DataSupport.where(commentcount > ?, 0).find(News.class);

select * from users where commentcount > 0;

List newsList = DataSupport.select(title, content)
		.where(commentcount > ?, 0).find(News.class);

select title,content from users where commentcount > 0;

List newsList = DataSupport.select(title, content)
		.where(commentcount > ?, 0)
		.order(publishdate desc).find(News.class);

select title,content from users where commentcount > 0 order by publishdate desc;

List newsList = DataSupport.select(title, content)
		.where(commentcount > ?, 0)
		.order(publishdate desc).limit(10).find(News.class);

select title,content from users where commentcount > 0 order by publishdate desc limit 10;

List newsList = DataSupport.select(title, content)
		.where(commentcount > ?, 0)
		.order(publishdate desc).limit(10).offset(10)
		.find(News.class);

select title,content from users where commentcount > 0 order by publishdate desc limit 10,10;

News news = DataSupport.find(News.class, 1, true);
List commentList = news.getCommentList();

public class News extends DataSupport{
	
	...

	public List getComments() {
		return DataSupport.where(news_id = ?, String.valueOf(id)).find(Comment.class);
	}
	
}

Cursor cursor = DataSupport.findBySQL(select * from news where commentcount>?, 0);