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

比眉伴天荒 2022-07-17 15:26 183阅读 0赞

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

<table style="color:rgb(51,51,51); font-family:Arial; font-size:14px; line-height:26px; border:1px solid rgb(0,0,0); height:82px; width:377px"> 
 <tbody> 
  <tr> 
   <th>Id</th> 
   <th>LastName</th> 
   <th>FirstName</th> 
   <th>Address</th> 
   <th>City</th> 
  </tr> 
  <tr> 
   <td>1</td> 
   <td>Adams</td> 
   <td>John</td> 
   <td>Oxford Street</td> 
   <td>London</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>Bush</td> 
   <td>George</td> 
   <td>Fifth Avenue</td> 
   <td>New York</td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td>Carter</td> 
   <td>Thomas</td> 
   <td>Changan Street</td> 
   <td>Beijing</td> 
  </tr> 
 </tbody> 
</table>

SQL基本格式如下：

Sql代码   ![收藏代码][icon_star.png]

1.  **SELECT**  列名称  **FROM**  表名称

**\[sql\]**  [view plain][]   [copy][view plain]

1.  **SELECT** 列名称 **FROM** 表名称

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

Java代码   ![收藏代码][icon_star.png]

1.  **public** Cursor   query  (String table, String\[\] columns, String selection, String\[\] selectionArgs,   
2.  String groupBy, String having, String orderBy, String limit)

**\[java\]**  [view plain][]   [copy][view plain]

1.  **public** Cursor   query  (String table, String\[\] columns, String selection, String\[\] selectionArgs,   
2.  String groupBy, String having, String orderBy, String limit)

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

Sql代码   ![收藏代码][icon_star.png]

1.  **SELECT**  FirstName, LastName  **FROM**  Employees

**\[sql\]**  [view plain][]   [copy][view plain]

1.  **SELECT** FirstName, LastName **FROM** Employees

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

Sql代码   ![收藏代码][icon_star.png]

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

**\[sql\]**  [view plain][]   [copy][view plain]

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

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

Java代码   ![收藏代码][icon_star.png]

1.  String selection = ”City=?";

**\[java\]**  [view plain][]   [copy][view plain]

1.  String selection = ”City=?";

这时我们必须在selectionArgs中赋值

Java代码   ![收藏代码][icon_star.png]

1.  String\[\] selectionArgs = \{  "Beijing" \};

**\[java\]**  [view plain][]   [copy][view plain]

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

<table style="color:rgb(51,51,51); font-family:Arial; font-size:14px; line-height:26px; border:0pt solid rgb(0,0,0)"> 
 <tbody> 
  <tr> 
   <td>Id</td> 
   <td>CustomerName</td> 
   <td>OrderPrice</td> 
   <td>Country</td> 
   <td>OrderDate</td> 
  </tr> 
  <tr> 
   <td>1</td> 
   <td>Arc</td> 
   <td>100</td> 
   <td>China</td> 
   <td>2010/1/2</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>Bor</td> 
   <td>200</td> 
   <td>USA</td> 
   <td>2010/3/20</td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td>Cut</td> 
   <td>500</td> 
   <td>Japan</td> 
   <td>2010/2/20</td> 
  </tr> 
  <tr> 
   <td>4</td> 
   <td>Bor</td> 
   <td>300</td> 
   <td>USA</td> 
   <td>2010/3/2</td> 
  </tr> 
  <tr> 
   <td>5</td> 
   <td>Arc</td> 
   <td>600</td> 
   <td>China</td> 
   <td>2010/3/25</td> 
  </tr> 
  <tr> 
   <td>6</td> 
   <td>Doom</td> 
   <td>200</td> 
   <td>China</td> 
   <td>2010/3/26</td> 
  </tr> 
 </tbody> 
</table>

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

Sql代码   ![收藏代码][icon_star.png]

1.  **SELECT**  CustomerName,  SUM (OrderPrice)  **FROM**  Orders  **WHERE**  Country=?   
2.  **GROUP**   **BY**  CustomerName   
3.  **HAVING**   SUM (OrderPrice)>500  
4.  **ORDER**   **BY**  CustomerName

**\[sql\]**  [view plain][]   [copy][view plain]

1.  **SELECT** CustomerName, SUM(OrderPrice) **FROM** Orders **WHERE** Country=?   
2.  **GROUP** **BY** CustomerName   
3.  **HAVING** SUM(OrderPrice)>500  
4.  **ORDER** **BY** CustomerName

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

Java代码   ![收藏代码][icon_star.png]

1.  String table =  "Orders" ;  
2.  String\[\] columns = **new**  String\[\] \{  "CustomerName" ,  "SUM(OrderPrice)" \};  
3.  String selection = "Country=?" ;  
4.  String\[\] selectionArgs = **new**  String\[\]\{  "China" \};  
5.  String groupBy = "CustomerName" ;  
6.  String having = "SUM(OrderPrice)>500" ;  
7.  String orderBy = "CustomerName" ;  
8.  Cursor c = db.query(table, columns, selection, selectionArgs, groupBy, having, orderBy, **null**);

**\[java\]**  [view plain][]   [copy][view plain]

1.  String table = "Orders";  
2.  String\[\] columns = **new** String\[\] \{ "CustomerName", "SUM(OrderPrice)"\};  
3.  String selection = "Country=?";  
4.  String\[\] selectionArgs = **new** String\[\]\{ "China"\};  
5.  String groupBy = "CustomerName";  
6.  String having = "SUM(OrderPrice)>500";  
7.  String orderBy = "CustomerName";  
8.  Cursor c = db.query(table, columns, selection, selectionArgs, groupBy, having, orderBy, **null**);

查询的结果应该是：

<table style="color:rgb(51,51,51); font-family:Arial; font-size:14px; line-height:26px"> 
 <tbody> 
  <tr> 
   <td>CustomerName</td> 
   <td>SUM(OrderPrice)</td> 
  </tr> 
  <tr> 
   <td>Arc</td> 
   <td> <p>700</p> </td> 
  </tr> 
 </tbody> 
</table>

[icon_star.png]: /images/20220717/dc2c4949b1ab4d97a1274af509d33291.png
[view plain]: http://blog.csdn.net/scorplopan/article/details/6303559#