Loader / Threads / UI Thread

Background Tasks – Part 4

In the previous article we had a look at AsyncTask as saw how it simplified the process of performing background tasks, but saw some potential pitfalls to the newbie, and also saw how it leaves the potential to leak a Context. In Honeycomb Loader was introduced and in this article we’ll have a look at what this offers us.

Before we continue, it is worth pointing out that although Loader was introduced in Honeycomb (API 11) it is also included in the Support Library, so it can be used in older projects as well. One problem that you’ll have pre Honeycomb is that you must extend FragmentActivity rather than Activity in order to get an instance of LoaderManager. Personally I don’t see this as a problem. I tend to use Fragments everywhere because they offer some useful functionality even when I don’t need them to provide different Layouts / UI for tablet & phone form factors. However, that’s a discussion for another article…

The Loader mechanism is specifically geared toward loading content either from a SQLite database, file storage, or from a network resource as a background task. That said, it can be used quite effectively to perform other tasks as well.

There are essentially three components that we need:

  • LoaderManager – this manages one or more Loader instances
  • Loader – this is the actual workhorse that will perform your background task
  • LoaderManager.LoaderCallbacks – this is an interface that you need to implement to manage the lifecycle of the Loader

In order to user a Loader, the first thing that you need to do is obtain a LoaderManager instance. This can be done from an Activity object (but only on API 11 or later), or through Fragment or FragmentActivity (either the native ones in API 11 or later, or using the Support Library classes in earlier versions):

The next thing that we must do is implement LoaderManager.LoaderCallbacks which are callback methods which will create a loader, and get called when the loader either finishes, or is reset. These will all be executed on the UI thread, and we will typically implement them within our Activity / FragmentActivity. The simple fact that we implement these in a separate class from the Loader provides a logical separation between the code which runs on the UI thread and that which runs on the background thread because they are in separate classes. This reduces the risk of running into the issue we discussed in the previous article of running a network call in the wrong method of AsyncTask. The simple fact that the methods invoked on the UI thread are implemented within our Activity / FragmentActivity is a strong hint that we shouldn’t be doing anything too heavy in them and make sure that code goes in to the Loader itself.

So our Activity looks like this:

[java] public class LoaderActivity
extends Activity
implements LoaderCallbacks
{
@Override
public void onCreate( Bundle savedInstanceState )
{
super.onCreate( savedInstanceState );
setContentView( R.layout.main );

LoaderManager lm = getSupportLoaderManager();
Loader loader = lm.restartLoader( 0,
null, this );
loader.forceLoad();
}

@Override
public Loader onCreateLoader( int id,
Bundle args )
{
return new MyLoader( this );
}

@Override
public void onLoadFinished( Loader loader,
String str )
{
Toast.makeText( this, str,
Toast.LENGTH_SHORT ).show();
}

@Override
public void onLoaderReset( Loader loader )
{
}
}
[/java]

Actually implementing things is actually quite similar to what we have to do for AsyncTask. There is actually an AsyncTaskLoader class which we can extend which is based upon AsyncTask. All we have to do is implement the doInBackground() method exactly as we would for AsyncTask:

[java] public class MyLoader extends AsyncTaskLoader
{
public MyLoader( Context context )
{
super( context );
}

@Override
public String loadInBackground()
{
String ret = null;

// Do something which
// populates ret

return ret;
}
}
[/java]

I have only scratched the surface on what you can do with Loaders, but there are some really good tutorials an samples on developer.android.com.

In the next part of this series we’ll change tack a little and have a look at when and how to use Services to perform your background processing.

The source code for this article can be found here.

© 2012, Mark Allison. All rights reserved.

Copyright © 2012 Styling Android. All Rights Reserved.
Information about how to reuse or republish this work may be available at http://blog.stylingandroid.com/license-information.

1 Comment

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.