Mobile Programming Lecture 10 - Florida State...

Mobile ProgrammingLecture 10

ContentProviders

Lecture 9 Review

● In creating a bound service, why would you choose to use a Messenger over extending Binder?

● What are the differences between using GPS provider and Network provider?

● When should you stop listening for location updates? Why at that point?

● How would you implement turn-by-turn directions?

● When should you disable a Sensor?

Lecture 9 Review

● How do you start an Activity B from and Activity A, and get a result back from Activity B when B has completed?

● How can you find out the structure of the intent filter for a given intent in the system?

Agenda

● ContentProviders○ Querying existing databases

○ Creating a database for your app

○ Inserting data

○ Updating data

○ Deleting data

○ Content provider permissions

● Viewing ContentProvider data

Android Application Components

1. Activity

2. Broadcast Receiver

3. Content Provider

4. Service

Content Provider Basics

● A Content Provider manages access to a central repository of data

● Content providers are primarily intended to be used by other applications, which access the provider using a provider client object

● A Content Provider presents data to external applications as one or more tables that are similar to the tables found in a relational database

● When you want to access data in a Content Provider, you use the ContentResolver object in your application's Context to communicate with the provider as a client

● The ContentResolver object communicates with the provider object, an instance of a class that implements ContentProvider

● The provider object receives data requests from clients, performs the requested action, and returns the results.

● You don't need to develop your own provider if you don't intend to share your data with other applications, instead○ Use SharedPreferences

● The reason you use a ContentProvider is ○ Data is too complex for SharedPreferences○ Expose your data to other applications

● _ID column serves as the primary key column that the Content Provider automatically maintains

● Here's an example of a table with an _ID column

word app id frequency locale _ID

mapreduce user1 100 en_US 1

precompiler user14 200 fr_FR 2

applet user2 225 fr_CA 3

const user1 255 pt_BR 4

int user5 100 en_UK 5

Contacts ContentProvider

In our examples, we will look at the Contacts ContentProvider

A lot of the work for a query goes into reading the documentation online

http://developer.android.com/reference/android/provider/ContactsContract.Contacts.html

Requesting Permission

In order to read the user's contacts, you need to request permission first

android.permission.READ_CONTACTS

Constructing a QueryLet's build several queries for ContractsContract.ContactsThe columns can be found in the documentation hereA few of the columns are ...

_ID long

LOOKUP_KEY String

NAME_RAW_CONTACT_ID long

DISPLAY_NAME_PRIMARY String

PHOTO_ID long

PHOTO_URI long

IN_VISIBLE_GROUP int

HAS_PHONE_NUMBER int

TIMES_CONTACTED int

Constructing a QueryWe will use the following fields in our class in our examples

public class ContactsContractExampleActivity extends ListActivity {

Cursor mCursor;

CursorAdapter mCursorAdapter;

String[] mProjection;

String[] mListColumns;

String mSelectionClause;

String[] mSelectionArgs;

String mOrderBy;

@Override

public void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

Constructing a QueryWe will use the following fields in our class in our examples

public class ContactsContractExampleActivity extends ListActivity {

Cursor mCursor;

CursorAdapter mCursorAdapter;

String[] mProjection;

String[] mListColumns;

String mSelectionClause;

String[] mSelectionArgs;

String mOrderBy;

@Override

super.onCreate(savedInstanceState);

Note that we're extending ListActivity, so we don't need to add a ListView to our XML layout file. We don't even need an XML layout file

Constructing a Query

Consider the following SQL queries

Constructing a Query - Query 1

SELECT * FROM ContactsContract.Contacts

"Get every column for every contact in this database table"

Constructing a Query - Query 1@Override

mCursor = getContentResolver().query(

ContactsContract.Contacts.CONTENT_URI, null, null, null,

null);

mListColumns = new String[] {

ContactsContract.Contacts.DISPLAY_NAME };

mListItems = new int[] { R.id.contact_name };

mCursorAdapter = new SimpleCursorAdapter(this,

R.layout.query1, mCursor, mListColumns,

mListItems);

setListAdapter(mCursorAdapter);

null);

mListItems);

When you want to access data in a content provider, you need to use a ContentResolver. You can get the ContentResolver by calling getContentResolver()

null);

mListItems);

It returns a Cursor object.

null);

mListItems);

Using a Cursor object, you can call the query() method to execute a query on a content provider.

null);

mListItems);

The second argument is a String array (i.e. String[ ]) of which columns we want to be returned by the query. Passing null means return all columns, i.e. SELECT *

null);

mListItems);

The first argument to Cursor.query() is a Uri. It specifies the table that you want to access, i.e. SELECT * FROM table

null);

mListItems);

ContactsContract is a content provider. You can think of it as the database

null);

mListItems);

ContactsContract.Contacts is a content provider. You can think of it as a table in the database

null);

mListItems);

This is one of the Uris for the table, which says how you want to access the table. Some tables have multiple Uris

null);

mListItems);

The third argument is a String. Here you specify the conditions for your query. Passing null means don't specify any conditions

null);

mListItems);

The fourth argument is a String[ ]. We will get back to this soon

null);

mListItems);

The fifth argument is a String. It says how we want to sort our results. Passing null means don't specify any sorting

null);

mListItems);

SELECT * FROM ContactsContract.Contacts

null);

mListItems);

Our query is now complete, and the Cursor can iterate through the results. But since we want to attach our results to a ListView, we need to add a few more lines of code

null);

mListItems);

Although our query was on all columns, here we create a String array of the columns we want to have displayed in our ListView.

null);

mListItems);

The column names are usually constants that you can reference via the database table

● In order to setup our ListView properly, we need to create an XML layout file that can represent each row in the list.

● We create a Layout XML file called query1.xml, which has the following TextView

Constructing a Query - Query 1<?xml version="1.0" encoding="utf-8"?>

<TextView

xmlns:android="http://schemas.android.com/apk/res/android"

android:id="@+id/contact_name"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="Large Text"

android:textAppearance="?android:attr/textAppearanceLarge" />

<?xml version="1.0" encoding="utf-8"?>

<TextView

xmlns:android="http://schemas.android.com/apk/res/android"

android:id="@+id/contact_name"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="Large Text"

android:textAppearance="?android:attr/textAppearanceLarge"/>

Note the android:id attribute of the TextView

null);

mListItems);

null);

mListItems);

So, String[ ] mListColumns specifies which columns we want to select

null);

mListItems);

and int[] mListItems is a corresponding array, telling us where to place the actual value of the DISPLAY_NAME

null);

mListItems);

It will be placed in this TextView, whose android:id="@+id/contact_name"

null);

mListItems);

We've been using ArrayAdapters with ListViews in the past, but here we use a SimpleCursorAdapter instead, because we have a Cursor (i.e. mCursor)

null);

mListItems);

First argument is a Context

null);

mListItems);

Second argument is our Layout XML file resource used to construct the ListView

null);

mListItems);

Third argument is our Cursor object

null);

mListItems);

Fourth argument is our String array of column names

null);

mListItems);

Fifth argument is our int array of TextView resources

null);

mListItems);

Finally, we call setListAdapter and pass our SimpleCursorAdapter

See the query1() method inside of ContactsContractQueryExample.tar

This query is inefficient, because we're requesting all columns, but yet only using one column after we get the results

Consider the following SQL query

SELECT _ID, DISPLAY_NAME FROM ContactsContract.Contacts

"Get the _ID and DISPLAY_NAME for all contacts"

mProjection = new String[] { ContactsContract.Contacts. _ID,

ContactsContract.Contacts. DISPLAY_NAME };

ContactsContract.Contacts. CONTENT_URI, mProjection, null, null,

null);

mCursorAdapter = new SimpleCursorAdapter( this,

R.layout.query1, mCursor, mListColumns, mListItems);

mProjection = new String[] { ContactsContract.Contacts._ID,

ContactsContract.Contacts.CONTENT_URI, mProjection, null, null,

null);

Here we make a String array of the columns that we need.

null);

Instead of passing null, we pass our String array of column names

mCursor = getContentResolver(). query(

null);

SELECT _ID, DISPLAY_NAMEFROM ContactsContract.Contacts

null);

This hasn't changed

SELECT _ID, DISPLAY_NAME FROM ContactsContract.Contacts WHERE HAS_PHONE_NUMBER = 1

"Get the _ID and DISPLAY_NAME for all contacts that have phone numbers"

mSelectionClause = ContactsContract.Contacts. HAS_PHONE_NUMBER +

" = ?";

mSelectionArgs = new String[]{ "1"};

ContactsContract.Contacts. CONTENT_URI, mProjection, null, null,

null);

mSelectionClause = ContactsContract.Contacts.DISPLAY_NAME + " = ? ";

mSelectionArgs = new String[]{"Fred"};

null);

mProjection has not changed

mSelectionClause = ContactsContract.Contacts.HAS_PHONE_NUMBER +

" = ? ";

mSelectionArgs = new String[]{"1"};

null);

Here we use "?" as a placeholder. ContactsContract.Contacts.HAS_PHONE_NUMBER is a String, so we're appending " = ?" to this String0

" = ? ";

null);

Each "?" will be replaced by an element in this String array, sequentially. In this case we only have one "?"

" = ? ";

ContactsContract.Contacts.CONTENT_URI, mProjection,

mSelectionClause, mSelectionArgs, null);

Now instead of passing null for the selection clause, we pass our mSelectionClause String

" = ? ";

Instead of passing null, we pass our selection args array mSelectionArgs

" = ? ";

SELECT _ID, DISPLAY_NAME FROM ContactsContract.ContactsWHERE HAS_PHONE_NUMBER = 1

" = ? ";

null);

The ? is a placeholder here, just as %d or %s is a placeholder when you call printf()

SELECT _ID, DISPLAY_NAME, TIMES_CONTACTED FROM ContactsContract.Contacts

WHERE HAS_PHONE_NUMBER = 1

AND TIMES_CONTACTED > 5

"Get the _ID and DISPLAY_NAME for all contacts that have a phone number and that I've contacted more than 5 times"

mSelectionClause = ContactsContract.Contacts.HAS_PHONE_NUMBER + " = ? AND " +

ContactsContract.Contacts.TIMES_CONTACTED + " > ? ";

mSelectionArgs = new String[]{ "1", "5" };

mSelectionArgs = new String[]{"1", "5"};

We modify our selection clause slightly, to also have the condition that the contact must have been contacted more than 5 times

Since we have a new condition, we also add the argument to the condition to our selection arguments String array

SELECT _ID, DISPLAY_NAME, TIMES_CONTACTED FROM ContactsContract.Contacts WHERE HAS_PHONE_NUMBER = 1

AND TIMES_CONTACTED > 5

The rest hasn't changed

SELECT _ID, DISPLAY_NAME

FROM ContactsContract.Contacts

WHERE HAS_PHONE_NUMBER = 1

ORDER BY DISPLAY_NAME

"Get the _ID and DISPLAY_NAME for all contacts that have phone numbers, and sort the results by DISPLAY_NAME"

FYI, we will build this query off of query3, not query4

mSelectionClause = ContactsContract.Contacts. HAS_PHONE_NUMBER +

" = ? ";

mSelectionArgs = new String[]{ "1" };

mOrderBy = ContactsContract.Contacts. DISPLAY_NAME;

ContactsContract.Contacts. CONTENT_URI, mProjection,

mSelectionClause, mSelectionArgs, mOrderBy);

" = ? ";

mOrderBy = ContactsContract.Contacts.DISPLAY_NAME;

Here we have a String specifying the column by which we want to sort. In this case, the DISPLAY_NAME

" = ? ";

mOrderBy = ContactsContract.Contacts.DISPLAY_NAME;

SELECT _ID, DISPLAY_NAME FROM ContactsContract.Contacts WHERE HAS_PHONE_NUMBER = 1 ORDER BY DISPLAY_NAME

Iterating through query results

You may not always want to add the results from a query to a ListView. Sometimes you just need to go through the results one-by-one

Iterating through query resultsCursor cursor = getContentResolver().query(

ContactsContract.Contacts.CONTENT_URI,

projection,

selectionClause,

selectionArgs,

null);

if (cursor != null) {

while (cursor.moveToNext()) {

cursor.getString(1);

projection,

selectionClause,

selectionArgs,

null);

if(cursor != null) {

while(cursor.moveToNext()) {

After executing the query ...

projection,

selectionClause,

selectionArgs,

null);

Make sure that the Cursor is not null before using it

projection,

selectionClause,

selectionArgs,

null);

This returns true as long as there are more results to be fetched

projection,

selectionClause,

selectionArgs,

null);

Get the String represention of column number 1 (or use another integer if you want a different column value)

Iterating through query results

See ContentProviderExample.tar

Creating a Content Provider

There are two ways to store your data using a Content Provider

1. File data○ photos, audio, video, etc

2. Structured data○ data fit for a database

We will look at structured data using SQLite databases

Because writing to databases is a sensitive operation, in the next examples we will perform operations on our own SQLite database

The steps for creating an SQLite DB for your app is not what you're used to, because doing it right means that you also need to understand URIs

You should add the content provider via the Android Studio menu● Click File > New > Other > Content Provider● Provide a name for the Content Provider● Provide an Authorities URI

○ This should be your package name followed by “.provider”

● Click Finish

Decide on the name of your database now, and we will add it as a field to the ContentProvider

public class MyProvider extends ContentProvider {

public final static String DBNAME = "NameDatabase";

Next we need to add a String containing the SQL query for creating the necessary tables for our database

In our example, we will create a table in our database with the following structure

Column Name Type

_ID Integer PRIMARY KEY

FirstName TEXT

LastName TEXT

Creating a Content Providerpublic class MyProvider extends ContentProvider {

private static final String SQL_CREATE_MAIN =

"CREATE TABLE Users ( " +

" _ID INTEGER PRIMARY KEY, " +

"FirstName TEXT, " +

"LastName TEXT )";

If you're unfamiliar with SQL, see this page

● We will also add the CONTENT_URI Uri as a convenient way to get the URI for our database.

● We make it final because we don't want it to be modified after it has been set

private static final String SQL_CREATE_MAIN =

"CREATE TABLE Users ( " +

" _ID INTEGER PRIMARY KEY, " +

"FirstName TEXT, " +

"LastName TEXT )";

public static final Uri CONTENT_URI = Uri.parse("content://my.package.name.provider");

Before we implement any of the methods inside of your new ContentProvider, we need to add an inner class which extends SQLiteOpenHelper. This class will take care of

● Opening the database if it exists● Creating it if it does not

protected static final class MainDatabaseHelper extends SQLiteOpenHelper {

MainDatabaseHelper(Context context) {

super(context, "NamesDatabase", null, 1);

@Override

public void onCreate(SQLiteDatabase db) {

db.execSQL(SQL_CREATE_MAIN);

@Override

public void onUpgrade(SQLiteDatabase arg0, int arg1, int arg2) {

@Override

The String we created previously are here

@Override

Make sure to call super, and pass the name of the database as the second argument

@Override

The database will be created when onCreate() is called on our inner class. Note that this onCreate() doesn't get called until you try to access the database

Now we can implement the methods for our ContentProvider

Implementing the onCreate() method

public class MyContentProvider extends ContentProvider {

@Override

public boolean onCreate() {

mOpenHelper = new MainDatabaseHelper(getContext());

return true;

Implementing the onCreate() method

public class MyContentProvider extends ContentProvider {

@Override

public boolean onCreate() {

mOpenHelper = new MainDatabaseHelper(getContext());

return true;

We create an instance of our MainDatabaseHelper so that we can use it later for reading and modifying our NamesDatabase

Implementing the insert() methodpublic class MyContentProvider extends ContentProvider {

@Override

public Uri insert(Uri uri, ContentValues values) {

String fname = values.getAsString("FirstName");

String lname = values.getAsString("LastName");

long id = mOpenHelper.getWritableDatabase()

.insert("Users", null, values);

return Uri.withAppendedPath(CONTENT_URI, "" + id);

@Override

We must return a Uri. We will return a Uri that has the new id of the item that will be inserted in this method

@Override

This Uri can be used to identify the table in our database, but since we only have one table, we don't need to use it in this function

@Override

These are the values that will be inserted. They are key-value pairs

@Override

We get the FirstName and LastName values that were passed in

@Override

Before you call insert() and update(), you should check for invalid values and return null if there is any invalid input. We don't use fname and lname afterward, as we are just trying to illustrate how to use ContentValues

@Override

We need to call getWritableDatabase() to create and/or open our database which will be used for reading and writing

@Override

We can insert() on our Users table, passing the values that need to be inserted

@Override

Because the _ID column is the primary key, we don't need to specify a value for it. It will automatically be added for us

@Override

That _ID value is returned from the call to insert(), we store it in this long int

@Override

Here we return the Uri that can be used to identify the row that was just inserted. For examplecontent://my.package.name.provider/Users/1

Implementing the update() methodpublic class MyContentProvider extends ContentProvider {

@Override

public int update(Uri uri, ContentValues values,

String selection, String[] selectionArgs) {

return mOpenHelper.getWritableDatabase().

update("Users", values, selection, selectionArgs);

Implementing the update() methodpublic class MyContentProvider extends ContentProvider {

@Override

public int update(Uri uri, ContentValues values,

String selection, String[] selectionArgs) {

update("Users", values, selection, selectionArgs);

After checking for invalid values (not shown here), we simply use our mOpenHelper to update the Users table, and return that value. Next we implement the delete() method

Implementing the delete() methodpublic class MyContentProvider extends ContentProvider {

@Override

public int delete(Uri uri, String whereClause,

String[] whereArgs) {

delete(TABLE_NAMESTABLE, whereClause, whereArgs);

@Override

public int delete(Uri uri, String whereClause,

String[] whereArgs) {

delete(TABLE_NAMESTABLE, whereClause, whereArgs);

Next, we implement the query() method

@Override

public Cursor query(Uri table, String[] columns,

String selection, String[] args, String orderBy) {

return mOpenHelper.getReadableDatabase()

.query("Users", columns, selection, args, null, null, orderBy);

Content Provider Permissions

Now that you've set up your ContentProvider, you will want to have external apps require permission to read/write your data

Mobile Programming Lecture 10 - Florida State...

Documents

Transcript of Mobile Programming Lecture 10 - Florida State...

Java Methods - Florida State Universityww2.cs.fsu.edu/~akbas/java17/Slides/Methods.pdf · Java Methods In Java, the word method refers to the same kind of thing that the word function

DOC011 - Old Dominion Universityww2.odu.edu/~jdudek/GradEM1_materials/charges_multipoles.pdf · Title: DOC011.pdf Created Date: 8/27/2015 9:16:20 PM

LECTURE 2 - cs.fsu.edu

Author's personal copy - Old Dominion Universityww2.odu.edu/~czemlin/publications/LinGating.pdf · 2013. 9. 2. · Author's personal copy Original article Connexin40 and connexin43

Programming 1 - cs.fsu.edu

1 Grid DAIS: Database Access and Integration Services Greg Riccardi Florida State University riccardi@cs.fsu.edu.

Review - Florida State Universityww2.cs.fsu.edu/~dennis/teaching/2013_summer_cda... · Format • 10 multiple choice – 8 points each –Make sure to show your work –Can write

Finite State Machine Continued - Florida State Universityww2.cs.fsu.edu/~dennis/teaching/2013_summer_cda3100/week... · 2013. 7. 11. · 11/10/2007 11:52:34 AM week12-3.ppt 5 Finite

electromagnetic induction - ODU - Old Dominion Universityww2.odu.edu/~jdudek/Phys112N_materials/5-induction.pdf · physics 112N 5 Faraday’s law of induction! Faraday discovered

Mobile Programming Lecture 2ww2.cs.fsu.edu/~yannes/lectures/lect02.Layouts.Widgets.Toasts.and... · Event Handling. Views Every UI component in Android is a View. Layouts Layouts

Dealing with MASSIVE Data Feifei Li lifeifei@cs.fsu.edu Dept Computer Science, FSU Sep 9, 2008.

rotational motion - Old Dominion Universityww2.odu.edu/~jdudek/Phys111N_materials/7_rotational_motion.pdf · rotational motion. physics 111N 2 ... so although the angular speed is

Tallahassee, Florida, Sept., 2015 Research in Data Sciences Peixiang Zhao Department of Computer Science Florida State University zhao@cs.fsu.edu Introduction.

HTML and CSS basics - Florida State Universityww2.cs.fsu.edu/~jayarama/webdev16/Slides/HTML2.pdfI The tag is used to group block-elements to format them with CSS. CSS Syntax

MIPS I/O and Interrupt - Florida State Universityww2.cs.fsu.edu/~dennis/teaching/2013_summer_cda3100/week5/we… · MIPS interrupt • With external interrupt, if an event happens

Basics of Java Programming - Florida State Universityww2.cs.fsu.edu/~akbas/java17/Slides/Java_Basics.pdf · Basics of Java Programming Lecture 2 CGS 3416 Spring 2016 January 9, 2017

Mobile Programming Lecture 3 - ww2.cs.fsu.eduww2.cs.fsu.edu/~yannes/lectures/lect03.Resources.Selection.Activiti… · Lecture 3 Resources, Selection, Activities, Intents . ... Referencing

Uniprocessors - cs.fsu.edu

CSS Introduction to - Florida State Universityww2.cs.fsu.edu/~faizian/cgs3066/resources/Lecture4-Intro to CSS.pdfCSS = Cascading Style Sheets CSS is a "style sheet language" that lets

Educational Research - ODU - Old Dominion Universityww2.odu.edu/~jritz/attachments/edrefu.pdf · Educational Research ... Qualitative 9Basic Research 10 Applied Research10 Action