Remember when we created a sqlite database android application. We saw that the database file is stored in the file system directories of that application meaning that the database cannot be accessed from another application. You can apply the same thing on any resources within your application (Files, images, videos, …). But there is a method to expose your data across multiple applications: Content Providers.
Content Providers expose an application’s data across all other applications, you can use content providers to store or retrieve data of one application from any other application.
In this post we’re going to see how to deal with the existing default content providers by retrieving and manipulating data through them.
Android default content providers:
There are many built-in content providers supplied by OS. They are defined in the android.provider package, they include:
· Browser.
· Calllog.
· Live Folders.
· Contacts Contract.
· Media Store.
· Settings
content providers basics:the concept of content providers is pretty similar to the concept of
ASP.NET Web Services they provide data encapsulation through exposing data by
URis. Any content provider is invoked by a URi in the form of
content://provider_name . for example the URi of the Contacts content provider that retrieves all contacts is in the following form
content://contacts/people. If you want to retrieve a particular contact (by its ID) then it would be in this form:
content://contacts/people/5.
You do not need to write the URis of the content providers manually as they are stored as constant values in their respective content provider classes.
The Uri of the Contacts phones content provider is defined in
ContactsContract.CommonDataKinds.Phone.CONTENT_URI
(
content://com.android.contacts/data/phones)
The Uri of the browser Bookmarks content provider is defined in
Browser.BOOKMARKS_URI
(
content://browser/bookmarks)
The Media store (Video) stored in external device (SD Card) is defined in
MediaStore.Video.Media.EXTERNAL_CONTENT_URI
(
content://media/external/video/media) and so on.
content providers allow you to perform basic
CRUD operations: Create,Read, Update and Delete on data.
Making Queriesto retrieve data from a content provider we run a sql-like query using ManagedQuery object. The ManagedQuery object returns a cursor holding the result set.
To retrieve a list of all contacts and display them in a ListView
We first define our activity xml layout:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
android_orientation="vertical"
android_layout_width="fill_parent"
android_layout_height="fill_parent"
>
<TextView
android_layout_width="wrap_content"
android_layout_height="wrap_content"
android_id="@+id/txt"
/>
<ListView
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:id="@+id/list"
/>
</LinearLayout>
And define the layout of each row in the
ListView:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
android_layout_width="wrap_content"
android_layout_height="wrap_content"
android_orientation="horizontal"
>
<TextView
android_layout_width="100px"
android_layout_height="wrap_content"
android_id="@+id/txtName"
android_layout_weight="1"
/>
<TextView
android_layout_width="100px"
android_layout_height="wrap_content"
android_id="@+id/txtNumber"
android_layout_weight="1"
/>
</LinearLayout>
Remember to add the following permission to the manifest.xml file
<uses-permission android_name="android.permission.READ_CONTACTS"></uses-permission>
To retrieve the contacts and bind them to the listView:
String [] projection=new String[]{ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME,ContactsContract.CommonDataKinds.Phone.NUMBER,ContactsContract.CommonDataKinds.Phone._ID};
txt.setText(ContactsContract.PhoneLookup.CONTENT_FILTER_URI.toString());
Uri contacts = ContactsContract.CommonDataKinds.Phone.CONTENT_URI;
Cursor managedCursor = managedQuery(contacts,projection,null,null,null);
//Cursor managedCursor =cr.query(contacts, projection, null, null, null);
ListAdapter sca=new SimpleCursorAdapter(this,R.layout.listrow,managedCursor,projection,to);
list.setAdapter(sca);
the above code retrieves all the contacts in the following steps:
- We first define the projection of our query, we define the columns we want to retrieve in the result set.We define a String array containing the names of the columns we want to retreieve.The contacts column names are defined in ContactsContract.CommonDataKinds.Phone class.Note that we need to retrieve the _ID column as the cursor that retrieves the data expects such a column to be there.
- We specify the Uri of the content provider ContactsContract.CommonDataKinds.Phone.CONTENT_URI
- We retrieve the data by a cursor
Cursor managedCursor = managedQuery(contacts,projection,null,null,null);The cursor is retrieved by executing a managedQuery which has the following parameters:
- The Uri of the content provider.
- A String Array of the columns to be retrieved (projection)
- Where clause.
- String array containing selection arguments values.
- String representing the order by clause, we can use it but here it will be null. If we want to sort the contacts by name it would be ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME +“ asc”
- Then we create a list adapeter using the cursor and bind the ListView to it.
The previous example retrieves all the contacts but what if we want to retrieve a certain contact by name:
There are two ways:
- Using the same code above but adding a where clause and selection arguments to the managed wuery so it becomes like this:
Cursor managedCursor = managedQuery(contacts,projection,ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME+"=?",new String[]{"Jack"},null);This retrieves contact info of a person named Jack.
The other method is to inject the query in the Uri, instead of using Uri
contacts = ContactsContract.CommonDataKinds.Phone.CONTENT_URI;
we use
Uri contacts=Uri.withAppendedPath(ContactsContract.CommonDataKinds.Phone.CONTENT_FILTER_URI,Uri.encode("Jack"));This is equivalent to the following Uri content://com.android.contacts/data/phones/Jack
Inserting,updating and deleting:to insert data using a content provider there are two methods
First:Using the
Insert() method of your activity’s content resolver object. Like this example t insert a new bookmark to the browser:
ContentValues cv=new ContentValues();
cv.put(Browser.BookmarkColumns.TITLE, "End Gadget");
cv.put(Browser.BookmarkColumns.URL, "http://www.engadget.com/");
cv.put(Browser.BookmarkColumns.BOOKMARK,1);
Uri u= getContentResolver().insert(Browser.BOOKMARKS_URI, cv);
We create a
ContentValues object and add to it all the required fields, then we call
getContentResolver().insert method which returns the Uri of the newly inserted item.
It would be in this example
content://browser/bookmarks/17 We can use the generated Uri to update or delete the item later.
Second:We can replace the
getcontentresolver().insert() method with
bulkInsert method if we want to insert multiple items at a time.
The
bulkInsert(Uri url,ContentValues[] values) method returns the number of new items created.
Updating info using Content Providers:To update data using content providers, we use
getContnetResolver.Update() method:
This code updates the title of an existing browser bookmark:
ContentValues cv=new ContentValues();
cv.put(Browser.BookmarkColumns.TITLE, "End Gadget mod");
//uriBook= getContentResolver().insert(Browser.BOOKMARKS_URI, cv);
getContentResolver().update(Browser.BOOKMARKS_URI, cv, BookmarkColumns.TITLE+"=?", new String[]{"End Gadget"});
the
Update method has the following parameters:
- Content Providers Uri
- ContentValues object having the new values
- Where clause
- String array of the where clause arguments values
Deleting info using Content Providers:To delete info we use
getContentResolver.Delete() method
To delete a bookmark:
getContentResolver().delete(Browser.BOOKMARKS_URI,BookmarkColumns.TITLE+"=?", new String[]{"End Gadget"});the delete function has the following parameters:
- Content Providers Uri
- Where clause
- String array of the where clause arguments values
Remember to add the following permissions to the manifest.xml to add and read browser bookmarks:
<uses-permission android_name="android.permission.WRITE_CONTACTS"></uses-permission>
<uses-permission android_name="com.android.browser.permission.WRITE_HISTORY_BOOKMARKS"></uses-permission>
