android AsyncTask

shangbolei 2014-12-22

/**
 * AsyncTask是抽象类,
 * AsyncTask定义了三种泛型类型 Params,Progress和Result。
 * Params   启动任务执行的输入参数,比如HTTP请求的URL。
 * Progress 后台任务执行的百分比。
 * Result   后台执行任务最终返回的结果,比如String,Integer等。
 * 
 * AsyncTask的执行分为四个步骤,每一步都对应一个回调方法,开发者需要实现这些方法
 * 
 * 1) 继承AsyncTask
 * 2) 实现AsyncTask中定义的下面一个或几个方法:
 * 
 * onPreExecute(), 该方法将在执行实际的后台操作前被UI 线程调用。可以在该方法中做一些准备工作,如在界面上显示一个进度条,
 * 或者一些控件的实例化,这个方法可以不用实现。
 * 
 * doInBackground(Params...), 将在onPreExecute 方法执行后马上执行,该方法运行在后台线程中。这里将主要负责执行那些
 * 很耗时的后台处理工作。可以调用 publishProgress方法来更新实时的任务进度。该方法是抽象方法,子类必须实现。
 * 
 * onProgressUpdate(Progress...),在publishProgress方法被调用后,UI 线程将调用这个方法从而在界面上展示任务的进展情况,
 * 例如通过一个进度条进行展示。
 * 
 * onPostExecute(Result), 在doInBackground 执行完成后,onPostExecute 方法将被UI 线程调用,后台的计算结果将通过该方
 * 法传递到UI 线程,并且在界面上展示给用户.

 * onCancelled(),在用户取消线程操作的时候调用。在主线程中调用onCancelled()的时候调用。

 */

/**
 * 为了正确的使用AsyncTask类,以下是几条必须遵守的准则:
       0) AsyncTask的实现当中必须实例化doInBackground()方法,其他的不规定
  1) Task的实例必须是在UI 线程中创建
  2) execute方法必须是在UI 线程中调用
  3) 不要手动的调用onPreExecute(), onPostExecute(Result),doInBackground(Params...), onProgressUpdate(Progress...)这几个方法,
        需要在UI线程中实例化这个task来调用。
  4) 该task只能被执行一次,否则多次调用时将会出现异常
 *
 注意:doInBackground方法和onPostExecute的参数必须对应,这两个参数在AsyncTask声明的泛型参数列表中指定,
 第一个为doInBackground接收的参数,第二个为显示进度的参数,第三个为doInBackground返回和onPostExecute传入的参数。

 * /


//下面为一个模板
/*
 * 注意:AsyncTask<Integer, Integer, String>当中,<>内三个类型可以是随意的,根据实际情况而定
 * 但必须的遵循一些规则,下面以AsyncTask<Integer, Integer, String>为例子说明
 * 第一个Integer为doInBackground()输入参数的类型
 * 第二个Integer为onProgressUpdate()输入参数的类型
 * 第三个String为doInBackground()的返回值类型和onProgressUpdate()的输入参数类型
 * 必须的实例化doInBackground()方法,其他,可有可无,根据实际情况
*/
class DownloadTask extends AsyncTask<Integer, Integer, String> {
 
 //注意:该方法是运行在UI线程当中的,此时还允许对UI当中的控件进行操作,不同于doInBackground()方法
 @Override
 protected void onPreExecute() {
  //第一个执行方法
  //do what u want
  super.onPreExecute();
 }
 
 //doInBackground()作为另外一个独立的线程运行的了,并不再运行于UI线程当中了,所以不能对UI当中的控件进行设置和修改
 //等等操作了,这一点是不同于onPreExecute()方法,但可以通过publishProgress()方法间接的触发调用可运行于UI线程当中
 //的onProgressUpdate()来对UI线程当中的控件进行操作,publishProgress()方法自动触发onProgressUpdate()方法
 //(Integer... params)为execute(100)传入的可变长参数,输入参数的个数可不定,类型为<>当中的第一个类型,
 //params[0]表示第一输入参数,params[1]表示第二个,以此类推
 //doInBackground()方法执行完后会自动触发onPostExecute()方法,它的返回值即为onPostExecute()方法的输入参数
 @Override
 protected String doInBackground(Integer... params) {
  //第二个执行方法,onPreExecute()执行完后执行
  //do what u want
  return "一个字符";
 }

 //每一次调用publishProgress()方法都会自动触发调用onProgressUpdate()方法,而在doInBackground()当中,又常常是
 //用到publishProgress()方法,实现与UI线程之间数据的实时交互
 //onProgressUpdate()和onPreExecute()一样,都是运行在UI线程当中的,换言之,都可以对UI线程当中的控制进程操作
 @Override
 protected void onProgressUpdate(Integer... progress) {
  //do what u want
  super.onProgressUpdate(progress);
 }

 //onPostExecute()在doInBackground()方法执行完后自动触发调用,注意onPostExecute()是运行于UI线程当中的
 //onPostExecute(String result)当中传入的参数即为doInBackground()方法的返回值
 @Override
 protected void onPostExecute(String result) {
  //doInBackground返回时触发,换句话说,就是doInBackground执行完后触发
  //do what u want
  super.onPostExecute(result);
 }
 
}

相关推荐