翻译:
https://developer.android.com/reference/android/os/AsyncTask.html#doInBackground(Params...)
AsyncTask可以方便和简单的使用UI线程。此类允许您执行后台操作并在UI线程上发布结果,而无需操作线程或者handlers。
AsyncTask被设计为围绕Thread和Handler的辅助类,并不构成通用的线程框架。理想情况下,AsyncTasks应用于短操作(最多几秒钟)。如果需要长时间保持线程运行,强烈建议您使用java.util.concurrent包提供的各种API,如Executor,ThreadPoolExecutor和FutureTask。
异步任务由在后台线程上运行并在UI线程上发布结果的计算定义。异步任务由3个通用类型(称为Params,Progress和Result)以及4个步骤(称为onPreExecute,doInBackground,onProgressUpdate和onPostExecute)定义。
AsyncTask必须被子类化才能使用。该子类将覆盖至少一个方法(doInBackground(Params ...)),并且通常会覆盖第二个(onPostExecute(Result))。
AsyncTask的通用类型
异步任务使用的三种类型如下:
- Params,在执行时发送到任务的参数类型。
- Progress, 后台程序运行过程中发布的进度单位类型。
- Result,后台程序运行结果的类型。
4步
当执行异步任务时,任务将通过4个步骤:
- onPreExecute(),在任务执行之前在UI线程上调用。此步骤通常用于设置任务,例如在用户界面中显示进度条。
- doInBackground(Params...),在onPreExecute()完成执行后立即在后台线程上调用。此步骤用于执行可能需要很长时间的后台计算。异步任务的参数传递给此步骤。计算结果必须由此步骤返回,并将被传递回最后一步。此步骤也可以使用publishProgress(Progress ...)发布一个或多个进度单位。这些值在onProgressUpdate(Progress ...)步骤中的UI线程上发布。
- onProgressUpdate(Progress...),在调用publishProgress(Progress ...)后在UI线程上调用。执行时间是不确定的。该方法用于在后台程序仍在执行时在用户界面中显示任何形式的进度。例如,它可以用于对进度条进行动画处理或在文本字段中显示日志。
- onPostExecute(Result),在后台程序完成后在UI线程上调用。后台程序的结果作为参数传递给该步骤。
取消任务
任何时候都可以通过调用cancel(boolean)来取消任务。调用此方法将导致接下来isCancelled()的调用返回true。调用此方法后,onCancelled(Object),而不是onPostExecute(Object)将在doInBackground(Object [])返回后被调用。为了尽快地取消任务,您应该始终从doInBackground(Object [])中定期检查isCancelled()的返回值(比如在一个循环中)。
线程规则
这个类必须遵循一些线程规则才能正常工作:
必须在UI线程上加载AsyncTask类。这是从JELLY_BEAN自动完成的。
必须在UI线程上创建任务实例。
必须在UI线程上调用execute(Params ...)。
不要手动调用onPreExecute(),onPostExecute(Result),doInBackground(Params ...),onProgressUpdate(Progress ...)。
该任务只能执行一次(如果尝试第二次执行,将抛出异常)。