ThreadPoolExecutor使用浅谈
1. 基础介绍
ThreadPoolExecutor是Python标准库concurrent.futures模块中的一个类，用于实现线程池的功能。
ThreadPoolExecutor模块相比于threading等模块，通过submit方法返回的是一个Future对象，它代表了一个未来可期的结果。通过Future对象，我们可以在主线程（或主进程）中获取某个线程（或任务）的状态以及返回值，实现了多线程和多进程编码接口的一致性。
具体来说，Future对象具有以下特点：
-
获取状态和返回值：通过
result()方法可以获取一个任务的执行结果。如果任务尚未完成，调用result()方法会阻塞主线程，直到任务完成并返回结果。 -
异步通知：当一个线程完成时，主线程可以立即得到通知。可以通过
done()方法判断任务是否已完成，或使用add_done_callback()方法注册一个回调函数，在任务完成时自动调用该函数。 -
异常处理：如果任务抛出异常，
Future对象会将异常抛出到主线程。可以使用exception()方法获取异常对象。
通过返回Future对象，我们可以更方便地管理和控制线程池中的任务。可以在主线程中获取任务的状态、返回值和异常信息，避免了线程之间的显式同步和等待。
总的来说，ThreadPoolExecutor模块提供了一种高级的多线程编程接口，使得多线程编程更加简洁和易用。它实现了多线程和多进程的编码接口一致性，使得我们可以使用类似的方式处理多线程和多进程编程任务。
2. 基础使用
创建线程池对象
可以使用ThreadPoolExecutor类创建一个线程池对象。可以指定线程池的大小（即可同时运行的线程数量），也可以使用默认值（大小为系统默认的处理器数量）。
from concurrent.futures import ThreadPoolExecutor
import time
def get_html(times):
time.sleep(times)
print("get page {} success".format(times))
return times
executor = ThreadPoolExecutor(max_workers=2) # 表示在这个线程池中同时运行的线程有3个线程
提交任务
使用submit()方法向线程池提交任务，该方法接受一个可调用对象（函数、方法等）作为参数，并返回一个Future对象，表示异步执行的结果。
def my_task(arg):
# 执行任务的代码
return result
# 提交任务到线程池
future = executor.submit(my_task, arg)
获取任务结果
可以使用Future对象的result()方法来获取任务的结果。如果任务尚未完成，result()方法会阻塞当前线程，直到任务完成并返回结果。
# 获取任务的结果 result = future.result()
获取一组任务结果
使用submit()方法向线程池提交一组任务，并获取返回的Future对象列表，使用as_completed()函数迭代处理Future对象列表，它会在任务完成时产生结果。可以使用next()函数或直接使用for循环来获取结果
def my_task(arg):
# 执行任务的代码
return result
args = [arg1, arg2, arg3, ...]
futures = [executor.submit(my_task, arg) for arg in args]
# 使用next()函数获取每个任务的结果
for future in as_completed(futures):
result = future.result()
# 处理任务结果
# 或者使用for循环获取每个任务的结果
for future in as_completed(futures):
result = future.result()
# 处理任务结果
批量提交任务
除了逐个提交任务，还可以使用map()方法批量提交任务。map()方法接受一个可调用对象和一个可迭代的参数列表，然后并行地对参数列表中的每个参数调用可调用对象，并返回一个迭代器，用于获取每个任务的结果。
def my_task(arg):
# 执行任务的代码
return result
args = [arg1, arg2, arg3, ...]
# 批量提交任务并获取结果
results = executor.map(my_task, args)
等待任务完成
使用wait()方法等待所有已提交的任务完成。可以指定超时时间，如果超时时间到达而还有任务未完成，则不再等待并返回结果。
from concurrent.futures import ALL_COMPLETED, FIRST_COMPLETED # 等待所有任务完成 executor.wait(futures) # 等待任意任务完成 executor.wait(futures, return_when=FIRST_COMPLETED) # 等待所有任务完成或达到超时时间（单位为秒） executor.wait(futures, timeout=10)
wait()方法接受三个参数：
fs：要等待的Future对象列表。timeout：可选参数，指定等待的超时时间（单位为秒）。如果超时时间到达而还有任务未完成，则不再等待并返回结果。return_when：可选参数，指定返回结果的条件。默认为ALL_COMPLETED，表示等待所有任务完成；也可以指定为FIRST_COMPLETED，表示等待任意一个任务完成。
关闭线程池
在不再需要线程池时，应该调用shutdown()方法关闭线程池。关闭线程池后，将不再接受新的任务提交，但会等待已提交的任务完成。
# 关闭线程池 executor.shutdown()
