Spec-Zone.ru › Scala 2.12 Library

Объект scala.concurrent.Await

объект Await

Await используется для обеспечения надлежащего управления блокировкой для Awaitable экземпляров.

Хотя иногда полезен, например, для тестирования, рекомендуется избегать Await всякий раз, когда это возможно — вместо этого отдавая предпочтение комбинаторам и/или обратным вызовам. Методы Await's result и ready заблокируют выполнение вызывающей нити до возврата, что приведет к снижению производительности и, возможно, к проблемам с тупиком.

Источник
package.scala
Линейные надтипы

Члены-значения

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[lang]
Определяющие классы
AnyRef
Аннотации
@throws( ... ) @native()
Примечание

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

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: Any): Boolean

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

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

возвращает

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

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

def finalize(): Unit

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

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

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

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

final def getClass(): Class[_]

Возвращает представление runtime-класса объекта.

возвращает

объект класса, соответствующий runtime-типу получателя.

Определяющие классы
AnyRef → Any
Аннотации
@native()

def hashCode(): Int

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

возвращает

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

Определяющие классы
AnyRef → Any
Аннотации
@native()

final def isInstanceOf[T0]: Boolean

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

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

возвращает

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

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

final def ne(arg0: AnyRef): Boolean

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

возвращает

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

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

final def notify(): Unit

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

Определяющие классы
AnyRef
Аннотации
@native()
Примечание

не указано SLS как член AnyRef

final def notifyAll(): Unit

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

Определяющие классы
AnyRef
Аннотации
@native()
Примечание

не указано SLS как член AnyRef

def ready[T](awaitable: Awaitable[T], atMost: Duration): awaitable.type

Ожидайте состояния "завершен" Awaitable.

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

ПРЕДУПРЕЖДЕНИЕ: Настоятельно не рекомендуется использовать длительные таймауты, так как прогресс вызывающего потока будет приостановлен — заблокирован — до тех пор, пока Awaitable не станет готовым или таймаут не истечет.

awaitable

ожидаемое Awaitable

atMost

максимальное время ожидания, которое может быть отрицательным (ожидание не производится), Duration.Inf для неограниченного ожидания или конечное положительное время

возвращает

ожидаемое awaitable

Аннотации
@throws( clazz = classOf[TimeoutException] ) @throws( clazz = classOf[InterruptedException] )
Исключения

IllegalArgumentException если atMost равно Duration.Undefined

InterruptedException если текущий поток прерван во время ожидания

TimeoutException если после ожидания указанного времени это Awaitable все еще не готово

def result[T](awaitable: Awaitable[T], atMost: Duration): T

Ожидание и возвращение результата (типа T) Awaitable.

Хотя этот метод блокирует, внутреннее использование blocking гарантирует, что подлежащий ExecutionContext имеет возможность должным образом управлять блокировкой.

ПРЕДУПРЕЖДЕНИЕ: Настоятельно не рекомендуется использовать длительные таймауты, так как прогресс вызывающего потока будет приостановлен — заблокирован — до тех пор, пока у Awaitable не будет результата или таймаут не истечет.

awaitable

ожидаемое Awaitable

atMost

максимальное время ожидания, которое может быть отрицательным (ожидание не производится), Duration.Inf для неограниченного ожидания или конечное положительное время

возвращает

значение результата, если awaitable завершено в рамках указанного максимального времени ожидания

Аннотации
@throws( clazz = classOf[TimeoutException] ) @throws( clazz = classOf[InterruptedException] )
Исключения

IllegalArgumentException если atMost равно Duration.Undefined

InterruptedException если текущий поток прерван во время ожидания

TimeoutException если после ожидания указанного времени awaitable все еще не готово

final def synchronized[T0](arg0: ⇒ T0): T0

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

def toString(): String

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

возвращает

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

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

final def wait(): Unit

Классы определения
AnyRef
Аннотации
@throws( ... )

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

Классы определения
AnyRef
Аннотации
@throws( ... )

final def wait(arg0: Long): Unit

Классы определения
AnyRef
Аннотации
@throws( ... ) @native()

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

Spec-Zone.ru

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