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

首先我们假设我们有如下表格，表格名称“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基本格式如下：

 SELECT  列名称  FROM  表名称

 SELECT 列名称 FROM 表名称

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

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

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

 

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

 SELECT  FirstName, LastName  FROM  Employees

 SELECT FirstName, LastName FROM Employees

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

 SELECT  *  FROM  Employees  WHERE  City= 'Beijing'

 SELECT * FROM Employees WHERE City='Beijing'

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

 String selection = ”City=?";

 String selection = ”City=?";

 这时我们必须在selectionArgs中赋值

 String[] selectionArgs = { "Beijing" };

 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语句应当是：

 SELECT  CustomerName,  SUM (OrderPrice)  FROM  Orders  WHERE  Country=?
 GROUP   BY  CustomerName
 HAVING   SUM (OrderPrice)>500
 ORDER   BY  CustomerName

 SELECT CustomerName, SUM(OrderPrice) FROM Orders WHERE Country=?
 GROUP BY CustomerName
 HAVING SUM(OrderPrice)>500
 ORDER BY CustomerName

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

 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);

 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