Concurrent (7)

 十七、ThreadPoolExecutor
ThreadPoolExecutor
public ThreadPoolExecutor(int corePoolSize,
                          int maximumPoolSize,
                          long keepAliveTime,
                          TimeUnit unit,
                          BlockingQueue<Runnable> workQueue)
创建一个可以定义初始线程数,最大线程数,最大生命期,时间单位和工作队列的线程池执行者.
public ThreadPoolExecutor(int corePoolSize,
                          int maximumPoolSize,
                          long keepAliveTime,
                          TimeUnit unit,
                          BlockingQueue<Runnable> workQueue,
                          ThreadFactory threadFactory)
创建一个可以定义初始线程数,最大线程数,最大生命期,时间单位和工作队列的线程池执行者,可以使用传入的线程工厂里面的线程来做工作初始工作线程.
public ThreadPoolExecutor(int corePoolSize,
                          int maximumPoolSize,
                          long keepAliveTime,
                          TimeUnit unit,
                          BlockingQueue<Runnable> workQueue,
                          RejectedExecutionHandler handler)
创建一个可以定义初始线程数,最大线程数,最大生命期,时间单位和工作队列的线程池执行者,handler用来处理执行时发生堵塞或者线程的使用超过了定义的最大数量.
public ThreadPoolExecutor(int corePoolSize,
                          int maximumPoolSize,
                          long keepAliveTime,
                          TimeUnit unit,
                          BlockingQueue<Runnable> workQueue,
                          ThreadFactory threadFactory,
                          RejectedExecutionHandler handler)
创建一个可以定义初始线程数,最大线程数,最大生命期,时间单位和工作队列的线程池执行者,可以使用传入的线程工厂里面的线程来做工作初始工作线程,handler用来处理执行时发生堵塞或者线程的使用超过了定义的最大数量.
public void execute(Runnable command)
执行一个将来要运行的任务,任务可能创建一个新的线程或者使用一个缓存了的线程,如果因为执行者被关闭或者定义的线程被耗光导致任务不能被提交或执行的话,这个任务将会被当前handler处理掉.
public void shutdown()
将所有以前提交的任务都注册关闭,以后被提交的任务将不会被接受,如果继续提交任务将会不会发生任何效果.
public List<Runnable> shutdownNow()
试着关闭所有正在运行的任务,将唤醒运行的任务挂起,返回一个还在唤醒运行的任务的列表,这个动作是使用Thread.interrupt()方法来关闭线程的,所以如果某些线程对这个方法没有反映的话,这些线程将会永远不能被关闭掉.
public boolean isShutdown()
返回当前ThreadPoolExecutor是否被关闭了.
public boolean isTerminating()
返回当前ThreadPoolExecutor是否正在被关闭中,如果关闭结束了将会返回false.
public boolean isTerminated()
返回当前ThreadPoolExecutor是否已经结束,如果关闭结束了将会返回true.
public boolean awaitTermination(long timeout,
                                TimeUnit unit)
                         throws InterruptedException
当所有任务都通过关闭请求shutdown(可能是timeout也可能是interrupted)结束之后堵塞当前ThreadPoolExecutor
protected void finalize()
如果当前ThreadPoolExecutor没有引用了,则使用shutdown方法来回收它.
public void setThreadFactory(ThreadFactory threadFactory)
设置一个线程工厂来创建新的线程.
public ThreadFactory getThreadFactory()
返回用来创建新线程的线程工厂.
public void setRejectedExecutionHandler(RejectedExecutionHandler handler)
设置用来处理无法执行的线程的RejectedExecutionHandler对象handler.
public RejectedExecutionHandler getRejectedExecutionHandler()
返回用来处理无法执行的线程的RejectedExecutionHandler对象handler.
public BlockingQueue<Runnable> getQueue()
返回任务队列.
public boolean remove(Runnable task)
取消一个计算任务.
public void purge()
除掉所有的被取消了的任务.这个方法用来立刻回收任务所占用的资源,如果这些任务还存在其它的引用的话,将无法实现回收.
public void setCorePoolSize(int corePoolSize)
设置活动的线程数量,如果这个值比当前值小,则当任务运行结束开始缩小.如果大于当前值的话将会创建新的线程.
public int getCorePoolSize()取得活动的线程数.
public int prestartAllCoreThreads()
创建所有的活动线程，并让这些线程空闲起来不做任何事情，白养着。
public int prestartCoreThreads()
创建一个活动线程并让它空闲，不做任何事情，白白养着。
public void setMaximumPoolSize(int maximumPoolSize)
设置缓存的最大值
public int getMaximumPoolSize()
取得缓存的最大值
public void setKeepAliveTime(long time,
                             TimeUnit unit)
设置该ThreadPoolExecutor的生命期
public long getKeepAliveTime(TimeUnit unit)
取得该ThreadPoolExecutor的生命期
public int getPoolSize()
取得缓存的大小
public int getActiveCount()
取得活动的线程数量
public int getLargestPoolSize()
取得最大的缓存池大小
public long getTaskCount()
取得任务的数量
public long getCompletedTaskCount()
取得结束了的任务的数量
protected void beforeExecute(Thread t,
                             Runnable r)
在该ThreadPoolExecutor的缓存里面的任务开始结束运行之前运行传入的任务
protected void afterExecute(Runnable r,
                            Throwable t)
在该ThreadPoolExecutor的缓存里面的任务开始结束运行之后运行传入的任务
protected void terminated()
关闭该ThreadPoolExecutor

还有几个内部类：
static class ThreadPoolExecutor.AbortPolicy 
  一个对被拒绝执行的任务的处理者，他处理的方法是抛出一个RejectedExecutionException.
static class ThreadPoolExecutor.CallerRunsPolicy 
  一个对被拒绝执行的任务的处理者，他处理的方法是运行计算任务,除非ThreadPoolExecutor被关闭，这样的话，任务会被丢弃。
static class ThreadPoolExecutor.DiscardOldestPolicy 
  一个对被拒绝执行的任务的处理者，他处理的方法是丢弃最老的任务，然后运行被拒绝执行的计算任务,除非ThreadPoolExecutor被关闭，这样的话，任务会被丢弃。
static class ThreadPoolExecutor.DiscardPolicy
  一个对被拒绝执行的任务的处理者，他处理的方法是不声不响的把任务丢弃掉