Android - CommonsWare

Managing and Accessing Local Databases
If your queries are pretty much "baked into" your application, this is a very
straightforward way to use them. However, it gets complicated if parts of
the query are dynamic, beyond what positional parameters can really
handle. For example, if the set of columns you need to retrieve is not
known at compile time, puttering around concatenating column names
into a comma-delimited list can be annoying...which is where query()
comes in.
Regular Queries
The query() method takes the discrete pieces of a SELECT statement and
builds the query from them. The pieces, in order that they appear as
parameters to query(), are:
• The name of the table to query against
• The list of columns to retrieve
• The WHERE clause, optionally including positional parameters
• The list of values to substitute in for those positional parameters
• The GROUP BY clause, if any
• The ORDER BY clause, if any
• The HAVING clause, if any
These can be null when they are not needed (except the table name, of
course):
String[] columns={"ID", "inventory"};
String[] parms={"snicklefritz"};
Cursor result=db.query("widgets", columns, "name=?",
parms, null, null, null);
Building with Builders
Yet another option is to use SQLiteQueryBuilder, which offers much richer
query-building options, particularly for nasty queries involving things like
the union of multiple sub-query results. More importantly, the
306
Subscribe to updates at http://commonsware.com Special Creative Commons BY-SA 3.0 License Edition