Android 数据查询query函数参数解析

转自：http://notfatboy.iteye.com/blog/653357

首先我们假设我们有如下表格，表格名称“Employees”：

 

Id	LastName	FirstName	Address	City
1	Adams	John	Oxford Street	London
2	Bush	George	Fifth Avenue	New York
3	Carter	Thomas	Changan Street	Beijing

 

SQL基本格式如下：

Sql代码  


SELECT  列名称  FROM  表名称  

[sql] view
plaincopy

SELECT 列名称 FROM 表名称  

 最基本SQL语句，就是从表中选取要返回的列数据，不加任何过滤条件。当然如果我们的“列名称”是"*"，那么将返回整个表格数据。在 Android上，SQL相关的method通常有一个参数就是String[] columns，而这个参数对应的就是SQL语句中的“列名称”。我们可以看一个Android中的method - query：

Java代码  


public Cursor   query  (String table, String[] columns, String selection, String[] selectionArgs,   

String groupBy, String having, String orderBy, String limit)  

[java] view
plaincopy

public Cursor   query  (String table, String[] columns, String selection, String[] selectionArgs,   

String groupBy, String having, String orderBy, String limit)  

 

假设我们想获取人员的全名，那么SQL语句如下：

Sql代码  


SELECT  FirstName, LastName  FROM  Employees  

[sql] view
plaincopy

SELECT FirstName, LastName FROM Employees  

 当然一般地我们会有条件的过滤我们想要的结果，例如我只想返回city为Beijing的人员信息，那么我就需要用WHERE来过滤：

Sql代码  


SELECT  *  FROM  Employees  WHERE  City= 'Beijing'   

[sql] view
plaincopy

SELECT * FROM Employees WHERE City='Beijing'  

 这里where后面跟的字符串就是Android的method中对应得参数String selection。Android的method中通常还有个参数与此相关就是 String[] selectionArgs，当 selection参数中包含问号"?"时，那么selectionArgs才会用到。举个例子假设selection参数赋值如下：

Java代码  


String selection = ”City=?";  

[java] view
plaincopy

String selection = ”City=?";  

 这时我们必须在selectionArgs中赋值

Java代码  


String[] selectionArgs = { "Beijing" };  

[java] view
plaincopy

String[] selectionArgs = {"Beijing"};  

 也就是说selectionArgs中的字符串就是对应selection中的问号所代表的变量。实际上就是让selection中的过滤条件City可以动态的赋值，而不是写死在程序当中。在 query() 执行时会对 selectionArgs 中的字符串正确转义并替换到对应的 ? 处以构成完整的 selection 字符串。 有点像 String.format()。

那么很显然参数String groupBy就是对应SQL语句中GROUP BY后面的字符串，GROUP BY是与合计函数（Aggregate Functions）如SUM()一起使用的。详细的用法大家可以从网上查查。

参数String having对应SQL语句HAVING后面的字符串，也是要与合计函数一起使用的。

参数String orderBy对应SQL语句ORDER BY后面的字符串。

参数limit指明返回的rows的数量。

我们下面举个例子，假设有如下数据表，表名"Orders"：

Id	CustomerName	OrderPrice	Country	OrderDate
1	Arc	100	China	2010/1/2
2	Bor	200	USA	2010/3/20
3	Cut	500	Japan	2010/2/20
4	Bor	300	USA	2010/3/2
5	Arc	600	China	2010/3/25
6	Doom	200	China	2010/3/26

假设我们想查询客户总的订单数在500元以上的，且County在中国的客户的名称和订单总数，且按照CustomerName来排序，默认ASC排序，那么SQL语句应当是：

Sql代码  


SELECT  CustomerName,  SUM (OrderPrice)  FROM  Orders  WHERE  Country=?   

GROUP   BY  CustomerName   

HAVING   SUM (OrderPrice)>500  

ORDER   BY  CustomerName  

[sql] view
plaincopy

SELECT CustomerName, SUM(OrderPrice) FROM Orders WHERE Country=?   

GROUP BY CustomerName   

HAVING SUM(OrderPrice)>500  

ORDER BY CustomerName  

 那么对应Android的query函数的参数如下：

Java代码  


String table =  "Orders" ;  

String[] columns = new  String[] { "CustomerName" ,  "SUM(OrderPrice)" };  

String selection = "Country=?" ;  

String[] selectionArgs = new  String[]{ "China" };  

String groupBy = "CustomerName" ;  

String having = "SUM(OrderPrice)>500" ;  

String orderBy = "CustomerName" ;  

Cursor c = db.query(table, columns, selection, selectionArgs, groupBy, having, orderBy, null );   

[java] view
plaincopy

String table = "Orders";  

String[] columns = new String[] {"CustomerName", "SUM(OrderPrice)"};  

String selection = "Country=?";  

String[] selectionArgs = new String[]{"China"};  

String groupBy = "CustomerName";  

String having = "SUM(OrderPrice)>500";  

String orderBy = "CustomerName";  

Cursor c = db.query(table, columns, selection, selectionArgs, groupBy, having, orderBy, null);   

 查询的结果应该是：

CustomerName	SUM(OrderPrice)
Arc	700