Исполнители (Платформа Java SE 7)

java.lang. Объект
- java.util.concurrent. Исполнители

```
public class Executors
extends Object
```
Фабрика и служебные методы для Executor, ExecutorService, ScheduledExecutorService, ThreadFactory, и Callable классы определяются в этом пакете. Этот класс поддерживает следующие виды методов:
- Методы, которые создают и возвращаются ExecutorService установленный с обычно полезными параметрами конфигурации.
- Методы, которые создают и возвращают a ScheduledExecutorService установленный с обычно полезными параметрами конфигурации.
- Методы, которые создают и возвращают "обернутый" ExecutorService, который отключает реконфигурирование, делая специфичные для реализации недоступные методы.
- Методы, которые создают и возвращают a ThreadFactory это устанавливает недавно создаваемые потоки в известное состояние.
- Методы, которые создают и возвращают a Callable из других подобных закрытию форм, таким образом, они могут использоваться в методах выполнения, требующих Callable.
С тех пор:

1.5

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`static Callable<Object>`	`callable(PrivilegedAction<?> action)` Возвраты a `Callable` возразите, что, когда вызвано, выполняет данное привилегированное действие и возвращает его результат.
`static Callable<Object>`	`callable(PrivilegedExceptionAction<?> action)` Возвраты a `Callable` возразите, что, когда вызвано, выполняет данное привилегированное действие исключения и возвращает его результат.
`static Callable<Object>`	`callable(Runnable task)` Возвраты a `Callable` возразите, что, когда вызвано, выполняет данную задачу и возвращает `null`.
`static <T> Callable<T>`	`callable(Runnable task, T result)` Возвраты a `Callable` возразите, что, когда вызвано, выполняет данную задачу и возвращает данный результат.
`static ThreadFactory`	`defaultThreadFactory()` Возвращает фабрику потока по умолчанию, используемую, чтобы создать новые потоки.
`static ExecutorService`	`newCachedThreadPool()` Создает пул потоков, который создает новые потоки как необходимый, но снова использует ранее созданные потоки, когда они доступны.
`static ExecutorService`	`newCachedThreadPool(ThreadFactory threadFactory)` Создает пул потоков, который создает новые потоки как необходимый, но снова использует ранее созданные потоки, когда они доступны, и использует предоставленный ThreadFactory, чтобы создать новые потоки при необходимости.
`static ExecutorService`	`newFixedThreadPool(int nThreads)` Создает пул потоков, который снова использует постоянное число потоков, работающих от совместно используемой неограниченной очереди.
`static ExecutorService`	`newFixedThreadPool(int nThreads, ThreadFactory threadFactory)` Создает пул потоков, который снова использует постоянное число потоков, работающих от совместно используемой неограниченной очереди, используя предоставленный ThreadFactory, чтобы создать новые потоки при необходимости.
`static ScheduledExecutorService`	`newScheduledThreadPool(int corePoolSize)` Создает пул потоков, который может запланировать команды, чтобы бежать за данной задержкой, или периодически выполняться.
`static ScheduledExecutorService`	`newScheduledThreadPool(int corePoolSize, ThreadFactory threadFactory)` Создает пул потоков, который может запланировать команды, чтобы бежать за данной задержкой, или периодически выполняться.
`static ExecutorService`	`newSingleThreadExecutor()` Создает Исполнителя, который использует единственный рабочий поток, работающий от неограниченной очереди.
`static ExecutorService`	`newSingleThreadExecutor(ThreadFactory threadFactory)` Создает Исполнителя, который использует единственный рабочий поток, работающий от неограниченной очереди, и использует предоставленный ThreadFactory, чтобы создать новый поток при необходимости.
`static ScheduledExecutorService`	`newSingleThreadScheduledExecutor()` Создает однопоточного исполнителя, который может запланировать команды, чтобы бежать за данной задержкой, или периодически выполняться.
`static ScheduledExecutorService`	`newSingleThreadScheduledExecutor(ThreadFactory threadFactory)` Создает однопоточного исполнителя, который может запланировать команды, чтобы бежать за данной задержкой, или периодически выполняться.
`static <T> Callable<T>`	`privilegedCallable(Callable<T> callable)` Возвраты a `Callable` объект, который, когда вызвано, выполнит данный `callable` под текущим контекстом управления доступом.
`static <T> Callable<T>`	`privilegedCallableUsingCurrentClassLoader(Callable<T> callable)` Возвраты a `Callable` объект, который, когда вызвано, выполнит данный `callable` под текущим контекстом управления доступом с текущим загрузчиком класса контекста как загрузчик класса контекста.
`static ThreadFactory`	`privilegedThreadFactory()` Возвращает фабрику потока, используемую, чтобы создать новые потоки, у которых есть те же самые полномочия как текущий поток.
`static ExecutorService`	`unconfigurableExecutorService(ExecutorService executor)` Возвращает объект, который делегирует все определенные `ExecutorService` методы данному исполнителю, но не любые другие методы, которые могли бы иначе быть доступными бросками использования.
`static ScheduledExecutorService`	`unconfigurableScheduledExecutorService(ScheduledExecutorService executor)` Возвращает объект, который делегирует все определенные `ScheduledExecutorService` методы данному исполнителю, но не любые другие методы, которые могли бы иначе быть доступными бросками использования.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь метода
  - newFixedThreadPool
```
public static ExecutorService newFixedThreadPool(int nThreads)
```
    Создает пул потоков, который снова использует постоянное число потоков, работающих от совместно используемой неограниченной очереди. В любой точке, в большинстве потоков nThreads будут активные задачи обработки. Если дополнительные задачи будут представлены, когда все потоки будут активными, то они будут ожидать в очереди, пока поток не доступен. Если какой-либо поток завершится из-за отказа во время выполнения до завершения работы, то новый возьмет свое место если нужно, чтобы выполнить последующие задачи. Потоки в пуле будут существовать, пока это не будет явно shutdown.
    
    Параметры:
    nThreads - число потоков в пуле
    
    Возвраты:
    недавно создаваемый пул потоков
    
    Броски:
    
    IllegalArgumentException - если nThreads <= 0
  - newFixedThreadPool
```
public static ExecutorService newFixedThreadPool(int nThreads,
                                 ThreadFactory threadFactory)
```
    Создает пул потоков, который снова использует постоянное число потоков, работающих от совместно используемой неограниченной очереди, используя предоставленный ThreadFactory, чтобы создать новые потоки при необходимости. В любой точке, в большинстве потоков nThreads будут активные задачи обработки. Если дополнительные задачи будут представлены, когда все потоки будут активными, то они будут ожидать в очереди, пока поток не доступен. Если какой-либо поток завершится из-за отказа во время выполнения до завершения работы, то новый возьмет свое место если нужно, чтобы выполнить последующие задачи. Потоки в пуле будут существовать, пока это не будет явно shutdown.
    
    Параметры:
    nThreads - число потоков в пуле
    threadFactory - фабрика, чтобы использовать, создавая новые потоки
    
    Возвраты:
    недавно создаваемый пул потоков
    
    Броски:
    
    NullPointerException - если threadFactory является нулем
    
    IllegalArgumentException - если nThreads <= 0
  - newSingleThreadExecutor
```
public static ExecutorService newSingleThreadExecutor()
```
    Создает Исполнителя, который использует единственный рабочий поток, работающий от неограниченной очереди. (Отметьте однако, что, если этот единственный поток завершается из-за отказа во время выполнения до завершения работы, новый возьмет свое место если нужно, чтобы выполнить последующие задачи.) Задачи, как гарантируют, выполнятся последовательно, и не больше, чем одна задача будет активной в любой момент времени. В отличие от иначе эквивалентного newFixedThreadPool(1) возвращенный исполнитель, как гарантируют, не будет реконфигурируем, чтобы использовать дополнительные потоки.
    
    Возвраты:
    недавно создаваемый однопоточный Исполнитель
  - newSingleThreadExecutor
```
public static ExecutorService newSingleThreadExecutor(ThreadFactory threadFactory)
```
    Создает Исполнителя, который использует единственный рабочий поток, работающий от неограниченной очереди, и использует предоставленный ThreadFactory, чтобы создать новый поток при необходимости. В отличие от иначе эквивалентного newFixedThreadPool(1, threadFactory) возвращенный исполнитель, как гарантируют, не будет реконфигурируем, чтобы использовать дополнительные потоки.
    
    Параметры:
    threadFactory - фабрика, чтобы использовать, создавая новые потоки
    
    Возвраты:
    недавно создаваемый однопоточный Исполнитель
    
    Броски:
    
    NullPointerException - если threadFactory является нулем
  - newCachedThreadPool
```
public static ExecutorService newCachedThreadPool()
```
    Создает пул потоков, который создает новые потоки как необходимый, но снова использует ранее созданные потоки, когда они доступны. Эти пулы будут обычно улучшать производительность программ, которые выполняют много недолгих асинхронных задач. Звонки в execute снова используют ранее созданные потоки при наличии. Если никакой существующий поток не будет доступен, то новый поток будет создан и добавлен к пулу. Потоки, которые не использовались в течение шестидесяти секунд, завершаются и удаляются из кэша. Таким образом пул, который остается неактивным довольно долго, не будет использовать ресурсов. Отметьте, что пулы с подобными свойствами, но различными деталями (например, параметры тайм-аута) могут быть созданы, используя ThreadPoolExecutor конструкторы.
    
    Возвраты:
    недавно создаваемый пул потоков
  - newCachedThreadPool
```
public static ExecutorService newCachedThreadPool(ThreadFactory threadFactory)
```
    Создает пул потоков, который создает новые потоки как необходимый, но снова использует ранее созданные потоки, когда они доступны, и использует предоставленный ThreadFactory, чтобы создать новые потоки при необходимости.
    
    Параметры:
    threadFactory - фабрика, чтобы использовать, создавая новые потоки
    
    Возвраты:
    недавно создаваемый пул потоков
    
    Броски:
    
    NullPointerException - если threadFactory является нулем
  - newSingleThreadScheduledExecutor
```
public static ScheduledExecutorService newSingleThreadScheduledExecutor()
```
    Создает однопоточного исполнителя, который может запланировать команды, чтобы бежать за данной задержкой, или периодически выполняться. (Отметьте однако, что, если этот единственный поток завершается из-за отказа во время выполнения до завершения работы, новый возьмет свое место если нужно, чтобы выполнить последующие задачи.) Задачи, как гарантируют, выполнятся последовательно, и не больше, чем одна задача будет активной в любой момент времени. В отличие от иначе эквивалентного newScheduledThreadPool(1) возвращенный исполнитель, как гарантируют, не будет реконфигурируем, чтобы использовать дополнительные потоки.
    
    Возвраты:
    недавно создаваемый запланированный исполнитель
  - newSingleThreadScheduledExecutor
```
public static ScheduledExecutorService newSingleThreadScheduledExecutor(ThreadFactory threadFactory)
```
    Создает однопоточного исполнителя, который может запланировать команды, чтобы бежать за данной задержкой, или периодически выполняться. (Отметьте однако, что, если этот единственный поток завершается из-за отказа во время выполнения до завершения работы, новый возьмет свое место если нужно, чтобы выполнить последующие задачи.) Задачи, как гарантируют, выполнятся последовательно, и не больше, чем одна задача будет активной в любой момент времени. В отличие от иначе эквивалентного newScheduledThreadPool(1, threadFactory) возвращенный исполнитель, как гарантируют, не будет реконфигурируем, чтобы использовать дополнительные потоки.
    
    Параметры:
    threadFactory - фабрика, чтобы использовать, создавая новые потоки
    
    Возвраты:
    недавно создаваемый запланированный исполнитель
    
    Броски:
    
    NullPointerException - если threadFactory является нулем
  - newScheduledThreadPool
```
public static ScheduledExecutorService newScheduledThreadPool(int corePoolSize)
```
    Создает пул потоков, который может запланировать команды, чтобы бежать за данной задержкой, или периодически выполняться.
    
    Параметры:
    corePoolSize - число потоков, чтобы сохранить в пуле, даже если они неактивны.
    
    Возвраты:
    недавно создаваемый запланированный пул потоков
    
    Броски:
    
    IllegalArgumentException - если corePoolSize < 0
  - newScheduledThreadPool
```
public static ScheduledExecutorService newScheduledThreadPool(int corePoolSize,
                                              ThreadFactory threadFactory)
```
    Создает пул потоков, который может запланировать команды, чтобы бежать за данной задержкой, или периодически выполняться.
    
    Параметры:
    corePoolSize - число потоков, чтобы сохранить в пуле, даже если они неактивны.
    threadFactory - фабрика, чтобы использовать, когда исполнитель создает новый поток.
    
    Возвраты:
    недавно создаваемый запланированный пул потоков
    
    Броски:
    
    IllegalArgumentException - если corePoolSize < 0
    
    NullPointerException - если threadFactory является нулем
  - unconfigurableExecutorService
```
public static ExecutorService unconfigurableExecutorService(ExecutorService executor)
```
    Возвращает объект, который делегирует все определенные ExecutorService методы данному исполнителю, но не любые другие методы, которые могли бы иначе быть доступными бросками использования. Это обеспечивает способ безопасно "заморозить" конфигурацию и отвергнуть настройку данной конкретной реализации.
    
    Параметры:
    executor - базовая реализация
    
    Возвраты:
    экземпляр ExecutorService
    
    Броски:
    
    NullPointerException - если нуль исполнителя
  - unconfigurableScheduledExecutorService
```
public static ScheduledExecutorService unconfigurableScheduledExecutorService(ScheduledExecutorService executor)
```
    Возвращает объект, который делегирует все определенные ScheduledExecutorService методы данному исполнителю, но не любые другие методы, которые могли бы иначе быть доступными бросками использования. Это обеспечивает способ безопасно "заморозить" конфигурацию и отвергнуть настройку данной конкретной реализации.
    
    Параметры:
    executor - базовая реализация
    
    Возвраты:
    экземпляр ScheduledExecutorService
    
    Броски:
    
    NullPointerException - если нуль исполнителя
  - defaultThreadFactory
```
public static ThreadFactory defaultThreadFactory()
```
    Возвращает фабрику потока по умолчанию, используемую, чтобы создать новые потоки. Эта фабрика создает все новые потоки, используемые Исполнителем в том же самом ThreadGroup. Если есть a SecurityManager, это использует группу System.getSecurityManager(), еще группа потока, вызывающего этот метод defaultThreadFactory. Каждый новый поток создается как поток недемона с приоритетным набором к меньшему из Thread.NORM_PRIORITY и максимального приоритета, разрешенного в группе потока. У новых потоков есть имена, доступные через Thread.getName() из pool-N-thread-M, где N является порядковым номером этой фабрики, и М. является порядковым номером потока, создаваемого этой фабрикой.
    
    Возвраты:
    фабрика потока
  - privilegedThreadFactory
```
public static ThreadFactory privilegedThreadFactory()
```
    Возвращает фабрику потока, используемую, чтобы создать новые потоки, у которых есть те же самые полномочия как текущий поток. Эта фабрика создает потоки с теми же самыми настройками как defaultThreadFactory(), дополнительно устанавливая AccessControlContext и contextClassLoader новых потоков, чтобы быть тем же самым как поток, вызывающий этот метод privilegedThreadFactory. Новый privilegedThreadFactory может быть создан в пределах AccessController.doPrivileged(java.security.PrivilegedAction<T>) действие, устанавливающее контекст управления доступом текущего потока, чтобы создать потоки с выбранным содержанием настроек разрешения в пределах того действия.
    Отметьте, что, в то время как у задач, работающих в пределах таких потоков, будут то же самое управление доступом и настройки загрузчика класса как текущий поток, у них не должно быть того же самого ThreadLocal или InheritableThreadLocal значения. В случае необходимости определенные значения локальных переменных потока могут быть установлены или сброшены перед любыми выполнениями задачи в ThreadPoolExecutor использование подклассов ThreadPoolExecutor.beforeExecute(java.lang.Thread, java.lang.Runnable). Кроме того, если необходимо инициализировать рабочие потоки, чтобы иметь те же самые настройки InheritableThreadLocal как некоторый другой определяемый поток, можно создать пользовательский ThreadFactory, в котором тот поток ожидает, и службы запрашивает создать других, которые наследуют его значения.
    
    Возвраты:
    фабрика потока
    
    Броски:
    
    AccessControlException - если у текущего контекста управления доступом нет разрешения, чтобы и получить и установить загрузчик класса контекста.
  - вызываемый
```
public static <T> Callable<T> callable(Runnable task,
                       T result)
```
    Возвраты a Callable возразите, что, когда вызвано, выполняет данную задачу и возвращает данный результат. Это может быть полезно, применяя методы, требующие Callable к иначе resultless действие.
    
    Параметры:
    task - задача работать
    result - результат возвратиться
    
    Возвраты:
    вызываемый объект
    
    Броски:
    
    NullPointerException - если нуль задачи
  - вызываемый
```
public static Callable<Object> callable(Runnable task)
```
    Возвраты a Callable возразите, что, когда вызвано, выполняет данную задачу и возвращает null.
    
    Параметры:
    task - задача работать
    
    Возвраты:
    вызываемый объект
    
    Броски:
    
    NullPointerException - если нуль задачи
  - вызываемый
```
public static Callable<Object> callable(PrivilegedAction<?> action)
```
    Возвраты a Callable возразите, что, когда вызвано, выполняет данное привилегированное действие и возвращает его результат.
    
    Параметры:
    action - привилегированное действие, чтобы работать
    
    Возвраты:
    вызываемый объект
    
    Броски:
    
    NullPointerException - если нуль действия
  - вызываемый
```
public static Callable<Object> callable(PrivilegedExceptionAction<?> action)
```
    Возвраты a Callable возразите, что, когда вызвано, выполняет данное привилегированное действие исключения и возвращает его результат.
    
    Параметры:
    action - привилегированное действие исключения, чтобы работать
    
    Возвраты:
    вызываемый объект
    
    Броски:
    
    NullPointerException - если нуль действия
  - privilegedCallable
```
public static <T> Callable<T> privilegedCallable(Callable<T> callable)
```
    Возвраты a Callable объект, который, когда вызвано, выполнит данный callable под текущим контекстом управления доступом. Этот метод должен обычно вызываться в пределах AccessController.doPrivileged(java.security.PrivilegedAction<T>) действие, чтобы создать callables, который, если возможный, выполнится при выбранном содержании настроек разрешения в пределах того действия; или если не возможный, бросьте связанное AccessControlException.
    
    Параметры:
    callable - базовая задача
    
    Возвраты:
    вызываемый объект
    
    Броски:
    
    NullPointerException - если вызываемый нуль
  - privilegedCallableUsingCurrentClassLoader
```
public static <T> Callable<T> privilegedCallableUsingCurrentClassLoader(Callable<T> callable)
```
    Возвраты a Callable объект, который, когда вызвано, выполнит данный callable под текущим контекстом управления доступом с текущим загрузчиком класса контекста как загрузчик класса контекста. Этот метод должен обычно вызываться в пределах AccessController.doPrivileged(java.security.PrivilegedAction<T>) действие, чтобы создать callables, который, если возможный, выполнится при выбранном содержании настроек разрешения в пределах того действия; или если не возможный, бросьте связанное AccessControlException.
    
    Параметры:
    callable - базовая задача
    
    Возвраты:
    вызываемый объект
    
    Броски:
    
    NullPointerException - если вызываемый нуль
    
    AccessControlException - если текущий контекст управления доступом не имеет разрешения, чтобы и установить и получает загрузчик класса контекста.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Исполнители класса

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь метода

newFixedThreadPool

newFixedThreadPool

newSingleThreadExecutor

newSingleThreadExecutor

newCachedThreadPool

newCachedThreadPool

newSingleThreadScheduledExecutor

newSingleThreadScheduledExecutor

newScheduledThreadPool

newScheduledThreadPool

unconfigurableExecutorService

unconfigurableScheduledExecutorService

defaultThreadFactory

privilegedThreadFactory

вызываемый

вызываемый

вызываемый

вызываемый

privilegedCallable

privilegedCallableUsingCurrentClassLoader