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







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

Id 

 LastName 

FirstName 

Address

City

Adams

John 

Oxford Street 

London

2

Bush 

George

Fifth Avenue 

 New York 

3

Carter  

Thomas

Changan Street 

Beijing

SQL基本格式如下:

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

Java代码   

1.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

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

Sql代码   

1.SELECT  *  FROM  Employees  WHERE  City= 'Beijing'


SELECT * FROM Employees WHERE City='Beijing' 这里where后面跟的字符串就是Android的query()中对应得参数String selection。Android的method中通常还有个参数与此相关就是 String[] selectionArgs,当 selection参数中包含问号"?"时,那么selectionArgs才会用到。举个例子假设selection参数赋值如下:

Java代码   

1.String selection = ”City=?";  
 String selection = ”City=?"; 这时我们必须在selectionArgs中赋值

Java代码   
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


 那么对应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);  查询的结果应该是:CustomerName SUM(OrderPrice)
 Arc 700