java.util.concurrent
클래스 Executors

java.lang.Object 
  java.util.concurrent.Executors

public class Executors
extends Object 

이 패키지로 정의된 Executor, ExecutorService, ScheduledExecutorService, ThreadFactory 및 Callable 클래스용의 팩토리 및 유틸리티 메서드. 이 클래스는 다음의 종류의 메서드를 지원 합니다.

• 일반적으로 유용한 구성으로 설정된 ExecutorService를 작성해, 돌려주는 메서드
• 일반적으로 유용한 구성으로 설정된 ScheduledExecutorService를 작성해, 돌려주는 메서드
• 구현 고유의 메서드를 액세스 불가능하게 하는 것으로 복구성을 불가능하게 하는 「랩 되었다」ExecutorService를 작성해, 돌려주는 메서드
• 새롭게 작성된 thread를 기존 상태로 설정하는 ThreadFactory를 작성해, 돌려주는 메서드
• Callable가 필수의 실행 메서드로 사용할 수 있도록, 다른 크로쟈를 닮은 형식으로 Callable를 작성해, 돌려주는 메서드

도입된 버전 :

1.5

메서드 개요

static Callable <Object >	callable (PrivilegedAction action) 호출시로 지정된 특권 첨부 액션을 실행해 그 결과를 돌려주는 Callable 객체를 리턴합니다.
static Callable <Object >	callable (PrivilegedExceptionAction action) 호출시로 지정된 특권 첨부 예외 액션을 실행해 그 결과를 돌려주는 Callable 객체를 리턴합니다.
static Callable <Object >	callable (Runnable task) 호출시로 지정된 태스크를 실행해 null을 돌려주는 Callable 객체를 리턴합니다.
static <T> Callable <T>	callable (Runnable task, T result) 호출시로 지정된 태스크를 실행해, 지정된 결과를 돌려주는 Callable 객체를 리턴합니다.
static ThreadFactory	defaultThreadFactory () 새로운 thread의 작성에 사용하는 디폴트의 thread 팩토리를 리턴합니다.
static ExecutorService	newCachedThreadPool () 필요하게 응해 새로운 thread를 작성하는 thread 풀을 작성합니다만, 이용 가능한 경우에는 이전에 구축된 thread를 재이용합니다.
static ExecutorService	newCachedThreadPool (ThreadFactory threadFactory) 필요하게 응해 새로운 thread를 작성하는 thread 풀을 작성합니다만, 이용 가능한 경우에는 이전에 구축된 thread를 재이용합니다.
static ExecutorService	newFixedThreadPool (int nThreads) 공유 안 바운드 형식의 큐없이 동작하는 고정 세트의 thread를 재이용하는 thread 풀을 작성합니다.
static ExecutorService	newFixedThreadPool (int nThreads, ThreadFactory threadFactory) 공유 안 바운드 형식의 큐없이 동작하는 고정 세트의 thread를 재이용하는 thread 풀을 작성합니다.
static ScheduledExecutorService	newScheduledThreadPool (int corePoolSize) 지정된 지연 시간 후, 또는 주기적으로 커멘드의 실행을 스케줄 가능한 thread 풀을 작성합니다.
static ScheduledExecutorService	newScheduledThreadPool (int corePoolSize, ThreadFactory threadFactory) 지정된 지연 시간 후, 또는 주기적으로 커멘드의 실행을 스케줄 가능한 thread 풀을 작성합니다.
static ExecutorService	newSingleThreadExecutor () 안 바운드 형식의 큐없이 동작하는 단일의 워크스 레드를 사용하는 Executor를 작성합니다 (다만, 실행중에 발생한 장해이기 때문에 이 단일 thread가 셧다운전에 종료했을 경우에는 필요에 따라서 새로운 thread가 상속해 후속의 태스크를 실행한다).
static ExecutorService	newSingleThreadExecutor (ThreadFactory threadFactory) 안 바운드 형식의 큐없이 동작하는 단일의 워크스 레드를 사용하는 Executor를 작성합니다.
static ScheduledExecutorService	newSingleThreadScheduledExecutor () 지정된 지연 시간 후, 또는 주기적으로 커멘드의 실행을 스케줄 가능한, 단일 thread의 executor를 작성합니다.
static ScheduledExecutorService	newSingleThreadScheduledExecutor (ThreadFactory threadFactory) 지정된 지연 시간 후, 또는 주기적으로 커멘드의 실행을 스케줄 가능한, 단일 thread의 executor를 작성합니다.
static <T> Callable <T>	privilegedCallable (Callable <T> callable) 호출시에 현재의 액세스 제어 컨텍스트에 따라 지정된 callable를 실행하는 Callable 객체를 리턴합니다.
static <T> Callable <T>	privilegedCallableUsingCurrentClassLoader (Callable <T> callable) 호출시에 현재의 액세스 제어 컨텍스트에 따라, 현재의 컨텍스트 클래스 로더를 컨텍스트 클래스 로더로 하는 지정된 callable를 실행하는 Callable 객체를 리턴합니다.
static ThreadFactory	privilegedThreadFactory () 현재의 thread와 같은 접근 권한을 가지는 새로운 thread를 작성하기 위해서 사용하는 thread 팩토리를 리턴합니다.
static ExecutorService	unconfigurableExecutorService (ExecutorService executor) 정의 끝난 ExecutorService 메서드를 모두 지정된 executor에 위양 하지만, 캐스트를 사용해 액세스 가능한 다른 메서드는 위양 하지 않는 객체를 리턴합니다.
static ScheduledExecutorService	unconfigurableScheduledExecutorService (ScheduledExecutorService executor) 정의 끝난 ScheduledExecutorService 메서드를 모두 지정된 executor에 위양 하지만, 캐스트를 사용해 액세스 가능한 다른 메서드는 위양 하지 않는 객체를 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

메서드의 상세

newFixedThreadPool

public static ExecutorService  newFixedThreadPool(int nThreads)

공유 안 바운드 형식의 큐없이 동작하는 고정 세트의 thread를 재이용하는 thread 풀을 작성합니다. 실행중에 발생한 장해이기 때문에 몇개의 thread가 셧다운전에 종료했을 경우에는 필요에 따라서 새로운 thread가 상속해 후속의 태스크를 실행합니다.

파라미터:

nThreads - 풀내의 thread수

반환값:

새로운 작성된 thread 풀

newFixedThreadPool

public static ExecutorService  newFixedThreadPool(int nThreads,
                                                 ThreadFactory  threadFactory)

공유 안 바운드 형식의 큐없이 동작하는 고정 세트의 thread를 재이용하는 thread 풀을 작성합니다. 필요하게 응해 지정된 ThreadFactory를 사용해 새로운 thread를 작성합니다.

파라미터:

nThreads - 풀내의 thread수

threadFactory - 새로운 thread 작성시에 사용하는 팩토리

반환값:

새로운 작성된 thread 풀

newSingleThreadExecutor

public static ExecutorService  newSingleThreadExecutor()

안 바운드 형식의 큐없이 동작하는 단일의 워크스 레드를 사용하는 Executor를 작성합니다 (다만, 실행중에 발생한 장해이기 때문에 이 단일 thread가 셧다운전에 종료했을 경우에는 필요에 따라서 새로운 thread가 상속해 후속의 태스크를 실행한다). 태스크가 차례로 실행되는 것 및 어느 시점에 있어도 복수의 태스크가 활성화 될 것은 없는 것이 보증됩니다. 다른 점으로써 등가인 newFixedThreadPool(1) 과는 달리, 리턴된 executor 에서는 복구성에 한 thread의 추가 사용은 불가능하다라고 하는 것이 보증되고 있습니다.

반환값:

새로운 작성된 단일 thread의 Executor

newSingleThreadExecutor

public static ExecutorService  newSingleThreadExecutor(ThreadFactory  threadFactory)

안 바운드 형식의 큐없이 동작하는 단일의 워크스 레드를 사용하는 Executor를 작성합니다. 필요에 따라서, 지정된 ThreadFactory를 사용해 새로운 thread를 작성합니다. 다른 점으로써 등가인 newFixedThreadPool(1, threadFactory) 과는 달리, 리턴된 executor 에서는 복구성에 한 thread의 추가 사용은 불가능하다라고 하는 것이 보증되고 있습니다.

파라미터:

threadFactory - 새로운 thread 작성시에 사용하는 팩토리

반환값:

새로운 작성된 단일 thread의 Executor

newCachedThreadPool

public static ExecutorService  newCachedThreadPool()

필요하게 응해 새로운 thread를 작성하는 thread 풀을 작성합니다만, 이용 가능한 경우에는 이전에 구축된 thread를 재이용합니다. 보통, 풀은 단기의 비동기 태스크를 다수 실행하는 프로그램의 퍼포먼스를 개선합니다. execute를 호출하면, 이전에 구축된 thread가 이용 가능하면, 그것을 재이용합니다. 기존의 thread를 이용할 수 없는 경우는 새로운 thread가 작성되어, 풀에 추가됩니다. 60 초간 사용되지 않았던 thread는 종료해, 캐쉬로부터 삭제됩니다. 이 때문에 오랫동안자식 돌 상태의 풀에 의해 자원이 소비될 것은 없습니다. 유사한 프로퍼티를 가지지만, 상세한 다른 풀 (timeout 파라미터등)은, ThreadPoolExecutor 생성자를 사용해 작성할 수 있습니다.

반환값:

새로운 작성된 thread 풀

newCachedThreadPool

public static ExecutorService  newCachedThreadPool(ThreadFactory  threadFactory)

필요하게 응해 새로운 thread를 작성하는 thread 풀을 작성합니다만, 이용 가능한 경우에는 이전에 구축된 thread를 재이용합니다. 또, 필요하게 응해 지정된 ThreadFactory를 사용해 새로운 thread를 작성합니다.

파라미터:

threadFactory - 새로운 thread 작성시에 사용하는 팩토리

반환값:

새로운 작성된 thread 풀

newSingleThreadScheduledExecutor

public static ScheduledExecutorService  newSingleThreadScheduledExecutor()

지정된 지연 시간 후, 또는 주기적으로 커멘드의 실행을 스케줄 가능한, 단일 thread의 executor를 작성합니다. (다만, 실행중에 발생한 장해이기 때문에 이 단일 thread가 셧다운전에 종료했을 경우에는 필요에 따라서 새로운 thread가 상속해 후속의 태스크를 실행한다). 태스크가 차례로 실행되는 것 및 어느 시점에 있어도 복수의 태스크가 활성화 될 것은 없는 것이 보증됩니다. 다른 점으로써 등가인 newScheduledThreadPool(1) 과는 달리, 리턴된 executor 에서는 복구성에 한 thread의 추가 사용은 불가능하다라고 하는 것이 보증되고 있습니다.

반환값:

새로운 작성된 스케줄 끝난 executor

newSingleThreadScheduledExecutor

public static ScheduledExecutorService  newSingleThreadScheduledExecutor(ThreadFactory  threadFactory)

지정된 지연 시간 후, 또는 주기적으로 커멘드의 실행을 스케줄 가능한, 단일 thread의 executor를 작성합니다. (다만, 실행중에 발생한 장해이기 때문에 이 단일 thread가 셧다운전에 종료했을 경우에는 필요에 따라서 새로운 thread가 상속해 후속의 태스크를 실행한다). 태스크가 차례로 실행되는 것 및 어느 시점에 있어도 복수의 태스크가 활성화 될 것은 없는 것이 보증됩니다. 다른 점으로써 등가인 newScheduledThreadPool(1, threadFactory) 과는 달리, 리턴된 executor 에서는 복구성에 한 thread의 추가 사용은 불가능하다라고 하는 것이 보증되고 있습니다.

파라미터:

threadFactory - 새로운 thread 작성시에 사용하는 팩토리

반환값:

새로운 작성된 스케줄 끝난 executor

newScheduledThreadPool

public static ScheduledExecutorService  newScheduledThreadPool(int corePoolSize)

지정된 지연 시간 후, 또는 주기적으로 커멘드의 실행을 스케줄 가능한 thread 풀을 작성합니다.

파라미터:

corePoolSize - 풀내 로 유지하는 thread의 수 (아이돌 상태의 thread도 포함한다)

반환값:

새로운 작성된 스케줄 끝난 thread 풀

newScheduledThreadPool

public static ScheduledExecutorService  newScheduledThreadPool(int corePoolSize,
                                                              ThreadFactory  threadFactory)

지정된 지연 시간 후, 또는 주기적으로 커멘드의 실행을 스케줄 가능한 thread 풀을 작성합니다.

파라미터:

corePoolSize - 풀내 로 유지하는 thread의 수 (아이돌 상태의 thread도 포함한다)

threadFactory - executor가 새로운 thread를 작성할 때에 사용하는 팩토리

반환값:

새로운 작성된 스케줄 끝난 thread 풀

unconfigurableExecutorService

public static ExecutorService  unconfigurableExecutorService(ExecutorService  executor)

정의 끝난 ExecutorService 메서드를 모두 지정된 executor에 위양 하지만, 캐스트를 사용해 액세스 가능한 다른 메서드는 위양 하지 않는 객체를 리턴합니다. 이것을 사용하면, 구성을 안전하게 「freeze」하면서, 지정된 구상 구현의 튜닝을 허가하지 않게 할 수 있습니다.

파라미터:

executor - 기본으로 되는 구현

반환값:

ExecutorService 인스턴스

예외:

NullPointerException - executor가 null인 경우

unconfigurableScheduledExecutorService

public static ScheduledExecutorService  unconfigurableScheduledExecutorService(ScheduledExecutorService  executor)

정의 끝난 ScheduledExecutorService 메서드를 모두 지정된 executor에 위양 하지만, 캐스트를 사용해 액세스 가능한 다른 메서드는 위양 하지 않는 객체를 리턴합니다. 이것을 사용하면, 구성을 안전하게 「freeze」하면서, 지정된 구상 구현의 튜닝을 허가하지 않게 할 수 있습니다.

파라미터:

executor - 기본으로 되는 구현

반환값:

ScheduledExecutorService 인스턴스

예외:

NullPointerException - executor가 null인 경우

defaultThreadFactory

public static ThreadFactory  defaultThreadFactory()

새로운 thread의 작성에 사용하는 디폴트의 thread 팩토리를 리턴합니다. 이 팩토리는 같은 ThreadGroup 내의 Executor가 사용하는 새로운 thread를 모두 작성합니다. SecurityManager 가 존재하는 경우, System.getSecurityManager() 그룹이 사용되어 존재하지 않는 경우는 이 defaultThreadFactory 메서드를 호출하는 thread 그룹이 사용됩니다. 각 새로운 thread는 우선 순위 Thread.NORM_PRIORITY를 가지는 비demon thread로서 작성됩니다. 새로운 thread는 pool-N-thread-M Thread.getName()를 개입시켜 액세스 가능한 이름을 가집니다. 여기서, N는 이 팩토리의 일련 번호, M는 이 팩토리에 의해 작성된 thread의 일련 번호를의미합니다.

반환값:

thread 팩토리

privilegedThreadFactory

public static ThreadFactory  privilegedThreadFactory()

현재의 thread와 같은 접근 권한을 가지는 새로운 thread를 작성하기 위해서 사용하는 thread 팩토리를 리턴합니다. 이 팩토리는 defaultThreadFactory() 와 같은 설정을 가지는 thread를 작성합니다. 또, 새로운 thread의 AccessControlContext 및 contextClassLoader를, 이 privilegedThreadFactory 메서드를 호출하는 thread와 같게 설정합니다. 새로운 privilegedThreadFactory는 AccessController.doPrivileged(java.security.PrivilegedAction) 액션내에서 작성할 수 있습니다. 그 때, 현재의 thread의 액세스 제어 컨텍스트를 설정해, 액션내에 선택한 접근 권한 설정을 보관 유지하는 thread를 작성합니다.

이런 종류의 thread내에서 실행중의 태스크는 현재의 thread와 같은 액세스 제어 및 클래스 로더를 보관 유지합니다만, 같은 ThreadLocal 나 InheritableThreadLocal 치를 보관 유지할 필요는 없습니다. ThreadPoolExecutor.beforeExecute(java.lang.Thread, java.lang.Runnable)를 사용해 ThreadPoolExecutor 서브 클래스내에서 태스크를 실행하기 전에 필요하게 응해 thread 로케일의 특정의 값을 설정 또는 리셋 할 수 있습니다. 또, 워크스 레드를 초기화해, 다른 지정된 thread와 같은 InheritableThreadLocal 설정으로 하는 것이 필요한 경우, 커스텀 ThreadFactory를 작성해, thread가 그 내부에서 값을 상속하는 다른 thread의 작성을 대기해, 서비스가 그것을 요구하도록 할 수 있습니다.

반환값:

thread 팩토리

예외:

AccessControlException - 현재의 액세스 제어 컨텍스트이, 컨텍스트 클래스 로더의 취득과 설정의 양쪽 모두의 접근 권한을 보관 유지하지 않는 경우

callable

public static <T> Callable <T> callable(Runnable  task,
                                       T result)

호출시로 지정된 태스크를 실행해, 지정된 결과를 돌려주는 Callable 객체를 리턴합니다. 이것은, Callable를 필요로 하는 메서드를, 다른 방법에서는 결과의 나오지 않는 액션에 적용하는 경우에 도움이 됩니다.

파라미터:

task - 실행하는 태스크

result - 돌려주는 결과

반환값:

호출해 가능한 객체

예외:

NullPointerException - 태스크가 null인 경우

callable

public static Callable <Object > callable(Runnable  task)

호출시로 지정된 태스크를 실행해 null을 돌려주는 Callable 객체를 리턴합니다.

파라미터:

task - 실행하는 태스크

반환값:

호출해 가능한 객체

예외:

NullPointerException - 태스크가 null인 경우

callable

public static Callable <Object > callable(PrivilegedAction  action)

호출시로 지정된 특권 첨부 액션을 실행해 그 결과를 돌려주는 Callable 객체를 리턴합니다.

파라미터:

action - 실행하는 특권 첨부 액션

반환값:

호출해 가능한 객체

예외:

NullPointerException - 액션이 null인 경우

callable

public static Callable <Object > callable(PrivilegedExceptionAction  action)

호출시로 지정된 특권 첨부 예외 액션을 실행해 그 결과를 돌려주는 Callable 객체를 리턴합니다.

파라미터:

action - 실행하는 특권 첨부 예외 액션

반환값:

호출해 가능한 객체

예외:

NullPointerException - 액션이 null인 경우

privilegedCallable

public static <T> Callable <T> privilegedCallable(Callable <T> callable)

호출시에 현재의 액세스 제어 컨텍스트에 따라 지정된 callable를 실행하는 Callable 객체를 리턴합니다. 보통, 이 메서드는 AccessController.doPrivileged(java.security.PrivilegedAction) 액션내에서 불려가 callable를 작성하도록 합니다. callable는 가능하면 그 액션내의 선택한 접근 권한 설정에 따라 실행해, 가능하지 않으면 관련된 AccessControlException를 Throw 합니다.

파라미터:

callable - 기본으로 되는 태스크

반환값:

호출해 가능한 객체

예외:

NullPointerException - callable가 null인 경우

privilegedCallableUsingCurrentClassLoader

public static <T> Callable <T> privilegedCallableUsingCurrentClassLoader(Callable <T> callable)

호출시에 현재의 액세스 제어 컨텍스트에 따라, 현재의 컨텍스트 클래스 로더를 컨텍스트 클래스 로더로 하는 지정된 callable를 실행하는 Callable 객체를 리턴합니다. 보통, 이 메서드는 AccessController.doPrivileged(java.security.PrivilegedAction) 액션내에서 호출해 callable를 작성하도록 합니다. callable는 가능하면 그 액션내의 선택한 접근 권한 설정에 따라 실행해, 가능하지 않으면 관련된 AccessControlException를 Throw 합니다.

파라미터:

callable - 기본으로 되는 태스크

반환값:

호출해 가능한 객체

예외:

NullPointerException - callable가 null인 경우

AccessControlException - 현재의 액세스 제어 컨텍스트이, 컨텍스트 클래스 로더의 설정과 취득의 양쪽 모두의 접근 권한을 보관 유지하지 않는 경우