Android Persistent Data Storage:: Douglas C. Schmidt

Android Persistent Data Storage:
Introduction
Douglas C. Schmidt
[email protected]
www.dre.vanderbilt.edu/~schmidt
Professor of Computer Science

Institute for Software
Integrated Systems
Vanderbilt University
Nashville, Tennessee, USA
Android Persistent Data Storage Douglas C. Schmidt
Data Storage Options on Android
• Android offers several ways to store

data
• SQLite database
• Files
• SharedPreferences
2
Android Persistent Data Storage:
Overview of SQLite
Douglas C. Schmidt
[email protected]

Integrated Systems
Learning Objectives in this Part of the Module

• Understand what SQLite is & how to use it in Android
4
Android SQLite
• Android supports SQLite, which provides
a relational database for a mobile device
• i.e., it contains tables (consisting of
rows & columns), indexes, etc. that
form a “schema”
www.drdobbs.com/database/using-sqlite-on-android/232900584
5
Android SQLite
• It’s designed to operate within a
small footprint (~350kB) within
a single cross-platform disk file
en.wikipedia.org/wiki/SQLite
6
Android SQLite
small footprint (<300kB) within
• Implements most of SQL92 &
supports so-called “ACID”
transactions
• Atomic, Consistent, Isolated, & Durable
en.wikipedia.org/wiki/SQL-92
7
Android SQLite
small footprint (<300kB) within
• Implements most of SQL92 &
supports so-called “ACID”
transactions
• Access to an SQLite database typically
involves accessing the Android filesystem
• Database operations are typically
asynchronous since filesystem access
can be slow
• e.g., access is often made via AsyncTask,
AsyncQueryHandler, CursorLoader, etc.
www.vogella.com/articles/AndroidSQLite/article.html
8
SQLiteDatabase
• SQLiteDatabase is the base class
for working with a SQLite database
in Android
• It provides the insert(),
update(), & delete() methods
developer.android.com/reference/android/database/sqlite/SQLiteDatabase.html
9
SQLiteDatabase
in Android
• It provides the insert(),
update(), & delete() methods
• It also provides the execSQL()
method that can execute an
SQL statement directly
10
SQLiteDatabase
in Android
• Queries can be created via
rawQuery() & query() methods or
via the SQLiteQueryBuilder class
developer.android.com/reference/android/database/sqlite/SQLiteQueryBuilder.html
11
ContentValues
• The ContentValues object is used
by SQLiteDatabase to define
key/values
• The “key” represents the table
column identifier & the “value”
represents the content for the
table record in this column
developer.android.com/reference/android/content/ContentValues.html
12
ContentValues
• The ContentValues object is used
by SQLiteDatabase to define
key/values
• ContentValues can be used for
inserts & updates of database
entries
developer.android.com/reference/android/content/ContentValues.html
13
SQLiteOpenHelper
• Recommended means of using
SQLiteDatabase is to subclass the
SQLiteOpenHelper class
• In constructor call the super()
method of SQLiteOpenHelper,
specifying database name &
current database version
developer.android.com/reference/android/database/sqlite/SQLiteOpenHelper.html
14
SQLiteOpenHelper
• Override onCreate(), which is
called by SQLite if the database
does not yet exist
• e.g., execute CREATE TABLE
command
15
SQLiteOpenHelper
• Override onCreate(), which is
called by SQLite if the database
does not yet exist
• Override onUpgrade(), which is
called if the database version
increases in App code to allow
database schema updates
16
SQLiteOpenHelper
• Use SQLiteOpenHelper methods to
open & return underlying database
• e.g., getReadableDatabase() &
getWriteableDatabase() to
access an SQLiteDatabase
object either in read or write
mode, respectively
17
Opening an SQLite Database

public class ArtistDatabaseHelper extends SQLiteOpenHelper {
final private static String CREATE_CMD =
"CREATE TABLE artists ("
+ "_id" + " INTEGER PRIMARY KEY AUTOINCREMENT, "
+ "name" + " TEXT NOT NULL)";
SQL commands to create a table of artists
public ArtistDatabaseHelper(Context context) {
super(context, "artists_db", null, 1);
}
Give a name to the table
public void onCreate(SQLiteDatabase db) {
db.execSQL(CREATE_CMD);
}
Create the SQL table
public void onUpgrade(SQLiteDatabase db,
int oldVersion, int newVersion) { /* ... */ }
...
Support schema evolution
It’s common to create an SQLiteOpenHelper

18 subclass for each SQL table
Using an SQLite Database Via an Activity

public class DatabaseExampleActivity extends ListActivity {
final static String[] columns ={"_id", "name"};
static SQLiteDatabase db = null;
public void onCreate(Bundle savedInstanceState) {

...
ArtistDatabaseHelper dbHelper =
new ArtistDatabaseHelper
(getActivity().getApplicationContext());
Make the SQLiteOpenHelper subclass instance
db = dbHelper.getWritableDatabase();
insertArtists();
deleteLadyGaga(); Create a read/write databse
Cursor c = readArtists();
displayArtists(c);
}
... Perform various operations
SQLiteDatabase is often put in an19

App singleton to simplify access
Inserting Values Into an SQLite Database

• Method for inserting a row into the database
public long insert (String table, String nullColHack, ContentValues values)
Parameters
table The table to insert the row into
nullColHack Optional (often null)
values Map containing initial col values for row; keys are col names
20
#insert(java.lang.String, java.lang.String, android.content.ContentValues)

• Method for inserting a row into the database
public long insert (String table, String nullColHack, ContentValues values)
21
#insert(java.lang.String, java.lang.String, android.content.ContentValues)

private void insertArtists() {
ContentValues values = new ContentValues();
“key” represents the table column identifier & the “value”
represents the content for the table record in this column
values.put("name", "Lady Gaga");

db.insert("artists", null, values);
values.clear();
values.put("name", "Johnny Cash");
values.clear();
values.put("name", "Sting");
...
}
22
Deleting a Row From an SQLite Database

• Method for deleting row(s) from the database
public int delete(String table, String whereClause, String[] whereArgs)
Parameters
table the table to delete from
whereClause optional WHERE clause to apply when deleting
whereArgs Passing null deletes all rows
23
#delete(java.lang.String, java.lang.String, java.lang.String[])

• Method for deleting row(s) from the database
public int delete(String table, String whereClause, String[] whereArgs)
24
#delete(java.lang.String, java.lang.String, java.lang.String[])
private int deleteLadyGaga() {
Remove Lady Gaga from the database of artists
return db.delete("artists",
"name" + "=?",
new String []
{"Lady Gaga"}); Note the use of
} the “whereArgs”
25
Querying an SQLite Database

• You can use rawQuery() or a query() on an SQLiteDatabase
public Cursor rawQuery(String sql, String[] selectionArgs)
Runs the provided SQL and returns a Cursor over the result set
Parameters
sql the SQL query. The SQL string must not be ; terminated
selectionArgs You may include ?’s in where clause in the query, which are
replaced by the values from selectionArgs (the values will be
bound as Strings)
Returns
A Cursor object, which is positioned before the first entry
Cursors aren’t synchronized, 26

see documentation for details
Querying an SQLite Database

• You can use rawQuery() or a query() on an SQLiteDatabase
public Cursor query(String table, String[] columns, String selection, String[]
selectionArgs, String groupBy, String having, String orderBy)
query() builds up a SQL SELECT statement from its component parts
Parameter
String table The table name to compile the query against
int[] columns A list of which table columns to return ("null" returns all columns)
String selection Where-clause filters for the selection of data (null selects all data)
String[] You may include ?s in the “selection” where-clause that get replaced
selectionArgs by the values from the selectionArgs array
String[] groupBy A filter declaring how to group rows (null means rows not grouped)
String[] having Filter for the groups (null means no filter)
String[] orderBy Table columns used to order the data (null means no ordering)
Returns
27 the first entry
A Cursor object, which is positioned before
Using Query() vs. rawQuery()

• Using rawQuery() on an SQLiteDatabase
private Cursor readArtists() {

// returns all rows
return db.rawQuery("SELECT _id, name FROM artists", null);
}
28
#rawQuery(java.lang.String, java.lang.String[])
Using Query() vs. rawQuery()

• Using rawQuery() on an SQLiteDatabase

// returns all rows
return db.rawQuery("SELECT _id, name FROM artists", null);
}
• Using query() on an SQLiteDatabase

// returns all rows
return db.query("artists", new String [] {"_id", "name"},
null, null, null, null, null);
}
#query(java.lang.String, java.lang.String[], java.lang.String, java.lang.String[],
29
java.lang.String, java.lang.String, java.lang.String)
Cursor Iterators
• Query() returns a Cursor Iterator
that represents result of a query &
points to one row of query result
• This allows buffering of query
results efficiently since all data
needn’t be loaded into memory
developer.android.com/reference/android/database/Cursor.html
30
Cursor Iterators
• getCount() returns # of elements
of the resulting query
31
Cursor Iterators
• moveToFirst() & moveToNext()
move between individual data rows
32
Cursor Iterators
• isAfterLast() checks if the end of
the query result has been reached
33
Cursor Iterators
• Provides typed get*() methods
• e.g., getLong(columnIndex) &
getString(columnIndex) to access
column data for current position
of result
34
Cursor Iterators
• Provides getColumnIndexOrThrow
(String) to get column index for a
column name of table
35
Cursor Iterators
• Provides getColumnIndexOrThrow
(String) to get column index for a
column name of table
• Must be closed via close()
36
Displaying an SQLite Database

• The SimpleCursorAdapter class maps the
columns to the Views based on
the Cursor passed to it
private void displayArtists (Cursor c) {

setListAdapter(
new SimpleCursorAdapter
(this, R.layout.list_layout, c,
new String [] {"_id", "name"},
new int[] { R.id._id, R.id.name }));
}
developer.android.com/reference/android/widget/SimpleCursorAdapter.html
37
Examining an SQLite Database

• If your App creates a database it is saved by default in a directory file
/DATA/data/APP_NAME/databases/FILENAME
• DATA is the path that the Environment. getDataDirectory() method returns
• APP_NAME is your app name
• FILENAME is the name you specify in your application code for the
database
38
Examining an SQLite Database

• If your App creates a database it is saved by default in a directory file
• You can examine this database with sqlite3
# adb shell
# sqlite3 /data/data/com.android.launcher/databases/launcher.db
39
Summary
• SQLite is embedded into every Android device

• Using an SQLite database in Android does not require a setup procedure or
administration of the database
40
Summary
• SQLite is embedded into every Android device

• You only have to define the SQL statements for creating & updating the
database
• Afterwards the database is automatically managed for you by the Android
platform
41
Android Content Providers:
Introduction
Douglas C. Schmidt
[email protected]

Integrated Systems
Developing Android Apps with Eclipse Douglas C. Schmidt
Overview of Content Providers

• ContentProviders manage access to a central
repository of structured data & can make an
App’s data available to other Apps
developer.android.com/guide/topics/providers/content-providers.html
43

• They encapsulate the data & provide
mechanisms for defining data security
44

• Content providers are the standard interface
that connects data in one process with code
running in another process
45

• Content providers support database “CRUD”
operations (Create, Read, Update, Delete),
where “read” is implemented as “query”
46

• Content providers support database “CRUD”
operations (Create, Read, Update, Delete),
where “read” is implemented as “query”
• Apps can provide Activities that allow
users to query & modify the data managed
by a provider
47
Example Android ContentProviders

• Android itself includes many Content
Providers that manage data for
• Browser – bookmarks, history
• Call log – telephone usage
• Contacts – contact data
• MMS/SMS – Stores messages sent
& received
• Media – media database
• UserDictionary – database for
predictive spelling
• Maps – previous searches
• YouTube – previous searches
• Many more
developer.android.com/reference/android/provider/package-summary.html
48
ContentProvider Data Model

• A content provider typically
presents data to external
Apps as one or more tables
• e.g., the tables found in
a relational SQL
database
49
ContentProvider Data Model

• A content provider typically
presents data to external One provider in Android is the
Apps as one or more tables user dictionary, which stores the
spellings of non-standard words
• A row represents an
that the user wants to keep
instance of some type of
data the provider collects
• Each column in a row word app id freq locale _ID
represents an individual mapreduce user1 100 en_US 1
piece of data collected
precompiler user14 200 fr_FR 2
for an instance
applet user2 225 fr_CA 3
const user1 255 pt_BR 4
int user5 100 en_UK 5
50
Overview of ContentResolver
• ContentProvider never accessed
directly, but accessed indirectly
via a ContentResolver
• ContentProvider not created
until a ContentResolver tries
to access it
developer.android.com/reference/android/content/ContentResolver.html
51
• ContentResolvers manage &
support ContentProviders
• Enables use of ContentProviders
across multiple Apps
52
• Enables use of ContentProviders
across multiple Apps
• Provides additional services, such
as change notification & IPC
53
• Context.getContentResolver()
accesses default ContentResolver
ContentResolver cr =
getContentResolver();
54
ContentResolver vs. ContentProvider

• When you query data via a
ContentProvider, you don't
communicate with the provider
directly
• Instead, you use a
ContentResolver object to
www.androiddesignpatterns.com/2012/06/content-resolvers-and-content-providers.html
55

directly
• A call to getContentResolver().
query() is made
• This method call invokes
ContentResolver.query(), not
ContentProvider.query()
56

directly
query() is made
• When this query method is
invoked, the Content Resolver
parses the uri argument & extracts
its authority
• The Content Resolver directs the
request to the content provider
registered with the (unique)
authority by calling the Content
Provider's query() method
57

directly
query() is made
• When this query method is invoked,
the Content Resolver parses the uri
argument & extracts its authority
• When the Content Provider's query()
method is invoked, the query is
performed & a Cursor is returned (or
an exception is thrown)
• The resulting behavior depends on
Content Provider's implementation
58
Content URIs
• Any URI that begins with the content://
scheme represents a resource served up
by a Content Provider
59
Content URIs
• e.g., content://authority/path/id
• content - data is managed by a
ContentProvider
60
Content URIs
ContentProvider
• authority – id for the content provider
61
Content URIs
ContentProvider
• path – 0 or more segments indicating
the type of data to access
62
Content URIs
ContentProvider
• path – 0 or more segments indicating
the type of data to access
• id – specific record being requested
63
Content URIs
• ContentProviders are a façade that
offers data encapsulation via Content
Uri objects used as handles
• The data could be stored in a SQLite
database, in flat files, retrieved off a
device, be stored on some server
accessed over the Internet, etc.
64
Inserting Data Via ContentResolver

• Use ContentResolver.insert() to insert data into a ContentProvider
public final Uri insert(Uri uri, ContentValues values)
• Inserts a row into a table at the given URI
• If the content provider supports transactions the insertion will be atomic
Parameters
• uri – The uri of the table to insert into
• values – The initial values for the newly inserted row, where the key is
the column name for the field (passing an empty ContentValues will
create an empty row)
Returns
• the URI of the newly created row
developer.android.com/reference/android/content/ContentProvider.html
65
#insert(android.net.Uri, android.content.ContentValues)
Deleting Data Via ContentResolver

• Use ContentResolver.delete() to delete data from a ContentProvider
public final int delete(Uri uri, String where, String[] selectionArgs)
• Deletes row(s) specified by a content URI. If the content provider
supports transactions, the deletion will be atomic
Parameters
• uri – The uri of the row to delete
• where – A filter to apply to rows before deleting, formatted as an SQL
WHERE clause (excluding the WHERE itself)
• selectionArgs – SQL pattern args
Returns
• The number of rows deleted
66
#delete(android.net.Uri, java.lang.String, java.lang.String[])
Inserting/Deleting via applyBatch()

• ContentResolver.applyBatch() can insert (& delete) groups of data
public ContentProviderResult[] applyBatch (String authority,
ArrayList<ContentProviderOperation> operations)
• Applies each ContentProviderOperation object & returns array of results
• If all the applications succeed then a ContentProviderResult array with the
same number of elements as the operations will be returned
Parameters
• authority –authority of the ContentProvider to apply this batch
• operations – the operations to apply
Returns
• the results of the applications
67
#applyBatch(java.util.ArrayList<android.content.ContentProviderOperation>)
Querying a ContentResolver
• Use ContentResolver. query()
to retrieve data
• Returns a Cursor instance
for accessing results
• A Cursor is an iterator over
a result set
developer.android.com/reference/android/content/ContentProvider.html#query
68 java.lang.String[], java.lang.String)
(Uri, java.lang.String[], java.lang.String,
query() Parameters Compared to SQL Query

query() SELECT Notes
argument keyword/parameter
Uri FROM table_name Uri maps to the table in the provider
named table_name
projection col,col,col,... projection is an array of columns that
should be included for each row
retrieved
selection WHERE col =value selection specifies the criteria for
selecting rows
selectionArgs No exact equivalent in Selection arguments replace the ?
SQL placeholders in the selection clause
sortOrder ORDER BYcol,col,... sortOrder specifies the order in which

rows appear in the returned Cursor
69
Summary
• A SQLite database is private to the
App which creates it
• If you want to share data with other
App you can use a content provider
70
Summary
• A content provider allows App to
access data
• In most cases this data is stored
in an SQlite database
71
Summary
access data
• While a content provider can be used
within an App to access data, its is
typically used to share data with other
App
72
Summary
access data
App
• App data is by default private, so a
content provider is a convenient to
share you data with other application
based on a structured interface
73
Summary
access data
App
• App data is by default private, so a
content provider is a convenient to
share you data with other application
based on a structured interface
• A content provider must be declared
in the AndroidManifest.xml file
74

Android Persistent Data Storage:: Douglas C. Schmidt

Uploaded by

Copyright:

Available Formats

Android Persistent Data Storage:: Douglas C. Schmidt

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Android Persistent Data Storage:: Douglas C. Schmidt

Uploaded by

Copyright:

Available Formats

Android Persistent Data Storage:

Professor of Computer Science

Data Storage Options on Android

• Android offers several ways to store

Professor of Computer Science

Learning Objectives in this Part of the Module

Opening an SQLite Database

It’s common to create an SQLiteOpenHelper

Using an SQLite Database Via an Activity

public void onCreate(Bundle savedInstanceState) {

SQLiteDatabase is often put in an19

Inserting Values Into an SQLite Database

Inserting Values Into an SQLite Database

Inserting Values Into an SQLite Database

values.put("name", "Lady Gaga");

Deleting a Row From an SQLite Database

Deleting a Row From an SQLite Database

Deleting a Row From an SQLite Database

private int deleteLadyGaga() {

Remove Lady Gaga from the database of artists

Querying an SQLite Database

Cursors aren’t synchronized, 26

Querying an SQLite Database

Using Query() vs. rawQuery()

private Cursor readArtists() {

Using Query() vs. rawQuery()

private Cursor readArtists() {

• Using query() on an SQLiteDatabase

private Cursor readArtists() {

Displaying an SQLite Database

private void displayArtists (Cursor c) {

Examining an SQLite Database

Examining an SQLite Database

• SQLite is embedded into every Android device

• SQLite is embedded into every Android device

Professor of Computer Science

Overview of Content Providers

Overview of Content Providers

Overview of Content Providers

Overview of Content Providers

Overview of Content Providers

Example Android ContentProviders

ContentProvider Data Model

ContentProvider Data Model

ContentResolver vs. ContentProvider

ContentResolver vs. ContentProvider

ContentResolver vs. ContentProvider

ContentResolver vs. ContentProvider

Inserting Data Via ContentResolver

Deleting Data Via ContentResolver

Inserting/Deleting via applyBatch()

query() Parameters Compared to SQL Query

sortOrder ORDER BYcol,col,... sortOrder specifies the order in which

You might also like