201709013工作日记--Android异步通信AsyncTask

Posted 2020-10-06 buder

参考相关博客：http://blog.csdn.net/liuhe688/article/details/6532519

  在android中实现异步任务机制有两种方式，Handler和AsyncTask。

  Handler模式需要为每一个任务创建一个新的线程，任务完成后通过Handler实例向UI线程发送消息，完成界面的更新，这种方式对于整个过程的控制比较精细，但也是有缺点的，例如代码相对臃肿，在多个任务同时执行时，不易对线程进行精确的控制。关于Handler的相关知识，前面也有所介绍，不清楚的朋友们可以参照一下。 为了简化操作，Android1.5提供了工具类android.os.AsyncTask，它使创建异步任务变得更加简单，不再需要编写任务线程和Handler实例即可完成相同的任务。

  先来看看AsyncTask的定义：public abstract class AsyncTask<Params, Progress, Result> {

  三种泛型类型分别代表“启动任务执行的输入参数”、“后台任务执行的进度”、“后台计算结果的类型”。在特定场合下，并不是所有类型都被使用，如果没有被使用，可以用java.lang.Void类型代替。 一个异步任务的执行一般包括以下几个步骤：

1.execute(Params... params)，执行一个异步任务，需要我们在代码中调用此方法，触发异步任务的执行。

2.onPreExecute()，在execute(Params... params)被调用后立即执行，一般用来在执行后台任务前对UI做一些标记。

3.doInBackground(Params... params)，在onPreExecute()完成后立即执行，用于执行较为费时的操作，此方法将接收输入参数和返回计算结果。在执行过程中可以调用publishProgress(Progress... values)来更新进度信息。

4.onProgressUpdate(Progress... values)，在调用publishProgress(Progress... values)时，此方法被执行，直接将进度信息更新到UI组件上。

5.onPostExecute(Result result)，当后台操作结束时，此方法将会被调用，计算结果将做为参数传递到此方法中，直接将结果显示到UI组件上。

  在使用的时候，有几点需要格外注意：

1.异步任务的实例必须在UI线程中创建。

2.execute(Params... params)方法必须在UI线程中调用。

3.不要手动调用onPreExecute()，doInBackground(Params... params)，onProgressUpdate(Progress... values)，onPostExecute(Result result)这几个方法。

4.不能在doInBackground(Params... params)中更改UI组件的信息。

5.一个任务实例只能执行一次，如果执行第二次将会抛出异常。

 

下面举一个具体的例子：

  1 public class MainActivity extends AppCompatActivity {
  2 
  3     private static final String TAG = "~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~";
  4 
  5     private Button execute;
  6     private Button cancel;
  7     private ProgressBar progressBar;
  8     private TextView textView;
  9 
 10     private MyTask myTask;
 11 
 12     @Override
 13     protected void onCreate(Bundle savedInstanceState) {
 14         super.onCreate(savedInstanceState);
 15         setContentView(R.layout.activity_main);
 16 
 17         execute = (Button) findViewById(R.id.execute);
 18         execute.setOnClickListener(new View.OnClickListener() {
 19             @Override
 20             public void onClick(View view) {
 21                 myTask = new MyTask();
 22                 myTask.execute("http://blog.csdn.net/w250shini11/article/details/8646859");
 23 
 24                 execute.setEnabled(false);
 25                 cancel.setEnabled(true);
 26             }
 27         });
 28 
 29         cancel = (Button) findViewById(R.id.cancel);
 30         cancel.setOnClickListener(new View.OnClickListener() {
 31             @Override
 32             public void onClick(View view) {
 33                 myTask.cancel(true);
 34             }
 35         });
 36 
 37         progressBar = (ProgressBar) findViewById(R.id.progress_bar);
 38         textView = (TextView) findViewById(R.id.text_view);
 39     }
 40 
 41     private class MyTask extends AsyncTask<String, Integer, String> {
 42         //在执行任务之前做一些准备工作，这里显示一个提示界面
 43         @Override
 44         protected void onPreExecute() {
 45             //super.onPreExecute();
 46             Log.i(TAG, "onPreExecute() called");
 47             textView.setText("loading...");
 48         }
 49 
 50         //真正开始执行的后台任务
 51         @Override
 52         protected String doInBackground(String... params) {
 53             Log.i(TAG, "doInBackground(Params... params) called");
 54             try {
 55                 HttpClient client = new DefaultHttpClient();
 56                 HttpGet get = new HttpGet(params[0]);
 57                 HttpResponse response = client.execute(get);
 58                 if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
 59                     HttpEntity entity = response.getEntity();
 60                     InputStream is = entity.getContent();
 61                     long total = entity.getContentLength();
 62                     ByteArrayOutputStream baos = new ByteArrayOutputStream();
 63                     byte[] buf = new byte[1024];
 64                     int count = 0;
 65                     int length = -1;
 66                     while ((length = is.read(buf)) != -1) {
 67                         baos.write(buf, 0, length);
 68                         count += length;
 69                         //这个方法将会调用onProgressUpdate，用于在执行任务过程中更新进度
 70                         publishProgress((int) ((count / (float) total) * 100));
 71                         Thread.sleep(500);
 72                     }
 73                     //这个方法执行结束后，将会返回字符串传递给onPostExecute，去进行后续的任务
 74                     return new String(baos.toByteArray(), "utf-8");
 75                 }
 76             } catch (IOException e) {
 77                 e.printStackTrace();
 78             } catch (InterruptedException e) {
 79                 e.printStackTrace();
 80             }
 81             return null;
 82         }
 83 
 84         //onProgressUpdate方法用于更新进度信息
 85         @Override
 86         protected void onProgressUpdate(Integer... progresses) {
 87             //super.onProgressUpdate(progresses);
 88             Log.i(TAG, "onProgressUpdate(Progress... progresses) called");
 89             progressBar.setProgress(progresses[0]);
 90             textView.setText("loading..."  + progresses[0] + "%");
 91         }
 92 
 93         //onPostExecute方法用于在执行完后台任务后更新UI,显示结果
 94         @Override
 95         protected void onPostExecute(String s) {
 96             //super.onPostExecute(s);
 97             Log.i(TAG, "onPostExecute(Result result) called");
 98             textView.setText(s);
 99 
100             execute.setEnabled(true);
101             cancel.setEnabled(false);
102         }
103 
104         //onCancelled方法用于在取消执行中的任务时更改UI
105         @Override
106         protected void onCancelled() {
107             //super.onCancelled(s);
108             Log.i(TAG, "onCancelled() called");
109             textView.setText("cancelled");
110             progressBar.setProgress(0);
111 
112             execute.setEnabled(true);
113             cancel.setEnabled(false);
114         }
115     }
116 }

 

布局文件main.xml代码如下：

<?xml version="1.0" encoding="utf-8"?>  
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
    android:orientation="vertical"  
    android:layout_width="fill_parent"  
    android:layout_height="fill_parent">  
    <Button  
        android:id="@+id/execute"  
        android:layout_width="fill_parent"  
        android:layout_height="wrap_content"  
        android:text="execute"/>  
    <Button  
        android:id="@+id/cancel"  
        android:layout_width="fill_parent"  
        android:layout_height="wrap_content"  
        android:enabled="false"  
        android:text="cancel"/>  
    <ProgressBar   
        android:id="@+id/progress_bar"   
        android:layout_width="fill_parent"   
        android:layout_height="wrap_content"   
        android:progress="0"  
        android:max="100"  
        style="?android:attr/progressBarStyleHorizontal"/>  
    <ScrollView  
        android:layout_width="fill_parent"   
        android:layout_height="wrap_content">  
        <TextView  
            android:id="@+id/text_view"  
            android:layout_width="fill_parent"   
            android:layout_height="wrap_content"/>  
    </ScrollView>  
</LinearLayout>

 

因为需要访问网络，所以我们还需要在AndroidManifest.xml中加入访问网络的权限：

<uses-permission android:name="android.permission.INTERNET"/>

 

  AsyncTask本身就是一个抽象类，我们可以看到关键几个步骤的方法都在其中，doInBackground(Params... params)是一个抽象方法，我们继承AsyncTask时必须覆写此方法；onPreExecute()、onProgressUpdate(Progress... values)、onPostExecute(Result result)、onCancelled()这几个方法体都是空的，我们需要的时候可以选择性的覆写它们；publishProgress(Progress... values)是final修饰的，不能覆写，只能去调用，我们一般会在doInBackground(Params... params)中调用此方法。

  当我们调用execute(Params... params)方法后注意必须是在主线程中调用，execute方法会调用onPreExecute()方法，然后由ThreadPoolExecutor实例sExecutor执行一个FutureTask任务，这个过程中doInBackground(Params... params)将被调用，如果被开发者覆写的doInBackground(Params... params)方法中调用了publishProgress(Progress... values)方法，则通过InternalHandler实例sHandler发送一条MESSAGE_POST_PROGRESS消息，更新进度，sHandler处理消息时onProgressUpdate(Progress... values)方法将被调用；如果遇到异常，则发送一条MESSAGE_POST_CANCEL的消息，取消任务，sHandler处理消息时onCancelled()方法将被调用；如果执行成功，则发送一条MESSAGE_POST_RESULT的消息，显示结果，sHandler处理消息时，会根据返回结果去调用onPostExecute(Result result)方法被调用。