Spec-Zone.ru › Scala 2.13 Library

Объект scala.concurrent.ExecutionContext

Компаньон трейт ExecutionContext

объект ExecutionContext

Содержит фабричные методы для создания контекстов выполнения.

Источник
ExecutionContext.scala
Линейные супертипы
AnyRef, Any

Значения членов

final def !=(arg0: Any): Boolean

Тестирование двух объектов на неравенство.

возвращает

true если !(this == that), иначе false.

Определяющие классы
AnyRef → Any

final def ##(): Int

Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для чисел он возвращает значение хэша, которое согласуется с равенством значений: если две сущности типа значения сравниваются как true, то ## выведет одно и то же значение хэша для каждой из них. Для null возвращает код хэша, где null.hashCode вызывает NullPointerException.

возвращает

значение хэша, согласованное с ==

Определяющие классы
AnyRef → Any

final def ==(arg0: Any): Boolean

Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).

возвращает

true если объект-получатель эквивалентен аргументу; false в противном случае.

Определяющие классы
AnyRef → Any

final def asInstanceOf[T0]: T0

Приведение объекта-получателя к типу T0.

Обратите внимание, что успех приведения во время выполнения зависит от семантики стирания Scala. Поэтому выражение 1.asInstanceOf[String] бросит ClassCastException во время выполнения, а выражение List(1).asInstanceOf[List[String]] нет. В последнем примере из-за стирания аргумента типа во время компиляции невозможно проверить, соответствуют ли содержимое списка запрошенному типу.

возвращает

объект-получатель.

Определяющие классы
Any
Исключения

ClassCastException, если объект-получатель не является экземпляром стирания типа T0.

def clone(): AnyRef

Создаёт копию объекта-получателя.

По умолчанию реализация метода clone зависит от платформы.

возвращает

копию объекта-получателя.

Атрибуты
protected[java.lang]
Определяющие классы
AnyRef
Аннотации
@throws(classOf[java.lang.CloneNotSupportedException]) @native()
Примечание

не определён SLS как член AnyRef

final val defaultReporter: (Throwable) => Unit

По умолчанию обработчик просто выводит трассировку стека Throwable в System.err.

возвращает

функция для отчёта об ошибках

final def eq(arg0: AnyRef): Boolean

Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).

Метод eq реализует отношение эквивалентности на не-null экземплярах AnyRef, и имеет три дополнительных свойства:

    Он согласован: для любых не-null экземпляров x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false.Для любого не-null экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращают false. null.eq(null) возвращает true.

При переопределении методов equals или hashCode важно обеспечить согласованность их поведения с равенством ссылок. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2 ), они должны быть равны друг другу (o1 == o2) и должны иметь одинаковое значение хэша (o1.hashCode == o2.hashCode).

возвращает

true если аргумент является ссылкой на объект-получатель; false в противном случае.

Определяющие классы
AnyRef

def equals(arg0: AnyRef): Boolean

Метод равенства для типов ссылок. По умолчанию делегирует eq.

См. также equals в scala.Any.

возвращает

true если объект-получатель эквивалентен аргументу; false в противном случае.

Определяющие классы
AnyRef → Any

def finalize(): Unit

Вызывается сборщиком мусора для объекта-получателя, когда больше нет ссылок на объект.

Подробности о том, когда и если вызывается метод finalize, а также взаимодействие finalize с нелокальными возвратами и исключениями, зависят от платформы.

Атрибуты
protected[java.lang]
Определяющие классы
AnyRef
Аннотации
@throws(classOf[java.lang.Throwable])
Примечание

не определён SLS как член AnyRef

def fromExecutor(e: Executor): ExecutionContextExecutor

Создаёт ExecutionContext из заданного Executor с стандартным обработчиком ошибок.

e

используемый Executor. Если null, создаётся новый Executor с стандартной конфигурацией.

returns

ExecutionContext с использованием заданного Executor

def fromExecutor(e: Executor, reporter: (Throwable) => Unit): ExecutionContextExecutor

Создаёт ExecutionContext из заданного Executor.

e

используемый Executor . Если null, создаётся новый Executor с стандартной конфигурацией.

reporter

функция для обработки ошибок

returns

ExecutionContext с использованием заданного Executor

def fromExecutorService(e: ExecutorService): ExecutionContextExecutorService

Создаёт ExecutionContext из заданного ExecutorService с стандартным обработчиком ошибок.

Если гарантируется, что выполняемые задачи не блокирующие, можно использовать однопоточный ExecutorService для создания ExecutionContext следующим образом:

import java.util.concurrent.Executors
val ec = ExecutionContext.fromExecutorService(Executors.newSingleThreadExecutor())
e

используемый ExecutorService . Если null, создаётся новый ExecutorService с стандартной конфигурацией.

returns

ExecutionContext с использованием заданного ExecutorService

def fromExecutorService(e: ExecutorService, reporter: (Throwable) => Unit): ExecutionContextExecutorService

Создаёт ExecutionContext из заданного ExecutorService.

e

используемый ExecutorService . Если null, создаётся новый ExecutorService с стандартной конфигурацией.

reporter

функция для обработки ошибок

returns

ExecutionContext с использованием заданного ExecutorService

final def getClass(): Class[_ <: AnyRef]

Возвращает представление класса объекта во время выполнения.

returns

объект класса, соответствующий типу получателя во время выполнения.

Definition Classes
AnyRef → Any
Annotations
@native()

final lazy val global: ExecutionContextExecutor

Явный глобальный ExecutionContext. Вызовите global , если хотите явно указать глобальный ExecutionContext.

Стандартная реализация ExecutionContext основана на многопоточном пуле с кражей задач. Можно настроить его с помощью следующих свойств scala.sys.SystemProperties:

scala.concurrent.context.minThreads = по умолчанию "1" scala.concurrent.context.numThreads = по умолчанию "x1" (т.е. текущее число доступных процессоров * 1) scala.concurrent.context.maxThreads = по умолчанию "x1" (т.е. текущее число доступных процессоров * 1) scala.concurrent.context.maxExtraThreads = по умолчанию "256"

Размер пула потоков затем numThreads ограничен minThreads снизу и maxThreads сверху.

maxExtraThreads — максимальное количество дополнительных потоков в любой момент времени, чтобы избежать тупика, см. scala.concurrent.BlockContext.

returns

глобальный ExecutionContext

def hashCode(): Int

Метод hashCode для ссылочных типов. См. hashCode в scala.Any.

returns

значение кода хэша для этого объекта.

Definition Classes
AnyRef → Any
Annotations
@native()

final def isInstanceOf[T0]: Boolean

Проверяет, является ли динамический тип объекта получателя T0.

Обратите внимание, что результат проверки модулируется семантикой стирания Scala. Таким образом, выражение 1.isInstanceOf[String] вернёт false, а выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, поскольку аргумент типа стирается во время компиляции, невозможно проверить, содержатся ли элементы списка указанного типа.

returns

true , если объект получателя является экземпляром стираемого типа T0; false в противном случае.

Definition Classes
Any

final def ne(arg0: AnyRef): Boolean

Эквивалентно !(this eq that).

returns

true , если аргумент не является ссылкой на объект получателя; false в противном случае.

Definition Classes
AnyRef

final def notify(): Unit

Разбуживает один поток, ждущий монитор объекта-приемника.

Definition Classes
AnyRef
Annotations
@native()
Note

не указано SLS в качестве члена AnyRef

final def notifyAll(): Unit

Разбуживает все потоки, ждущие монитор объекта-приемника.

Definition Classes
AnyRef
Annotations
@native()
Note

не указано SLS в качестве члена AnyRef

final def synchronized[T0](arg0: => T0): T0

Definition Classes
AnyRef

def toString(): String

Создаёт строковое представление этого объекта. По умолчанию представление зависит от платформы. На платформе Java это объединение имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.

returns

строковое представление объекта.

Definition Classes
AnyRef → Any

final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.InterruptedException])

final def wait(arg0: Long, arg1: Int): Unit

Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.InterruptedException])

final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.InterruptedException]) @native()

object Implicits

object parasitic extends ExecutionContextExecutor with BatchingExecutor

ВНИМАНИЕ: Выполняйте только логику, которая быстро вернёт управление вызывающей стороне.

Этот ExecutionContext крадёт время выполнения других потоков, заставляя свои Runnable работать в Thread, который вызывает execute и затем возвращает управление вызывающей стороне после *всех* своих Runnable были выполнены. Вложенные вызовы execute будут выполняться с помощью trampolining, чтобы избежать неконтролируемого роста стека.

Используя parasitic с абстракциями, такими как Future, в многочисленных случаях невозможно предсказать, какой Thread будет выполнять логику, так как это зависит от того, когда/если данный Future будет завершён.

Не вызывайте блокирующие операции в Runnables, отправленные в этот ExecutionContext, так как это предотвратит прогресс других ожидающих Runnable и вызывающей Thread.

Признаками неправильного использования этого ExecutionContext могут быть тупики и серьёзные проблемы производительности.

Любые NonFatal или InterruptedException будут сообщены defaultReporter.

© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.13.0/scala/concurrent/ExecutionContext$.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API