Объект scala.concurrent.Future

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

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

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

Запускает асинхронное вычисление и возвращает экземпляр Future с результатом этого вычисления.

Следующие выражения эквивалентны:

val f1 = Future(expr)
val f2 = Future.unit.map(_ => expr)

Результат становится доступным после завершения асинхронного вычисления.

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

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

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

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

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

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

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

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

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

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

Создаёт уже завершённый Future с указанным исключением.

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

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

Асинхронно и неблокирующе возвращает Future, который будет содержать необязательный результат первого Future с результатом, соответствующим предикату, провалы Future будут проигнорированы.

Асинхронно и неблокирующе возвращает новое Future к результату первого завершенного будущего в списке. Это означает, что независимо от того, завершилось ли оно успешно или с ошибкой.

Неблокирующий, асинхронный слева-направо fold над указанными futures с начальным значением заданного zero. Fold выполняется асинхронно слева направо по мере завершения futures. Результатом будет первая ошибка любого из futures, или любая ошибка в фактическом fold, или результат fold.

Пример:

val futureSum = Future.foldLeft(futures)(0)(_ + _)

Создает уже завершенное Future со значениями результата или исключения.

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

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

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

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

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

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

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

Инициализирует асинхронное, неблокирующее левое редукцию по заданным фьючерсам, где нуль - это значение результата первого Future.

Пример:

val futureSum = Future.reduceLeft(futures)(_ + _)

Простая версия Future.traverse. Асинхронно и неблокирующе преобразует TraversableOnce[Future[A]] в Future[TraversableOnce[A]]. Полезно для уменьшения многих Future в один Future.

Создаёт уже завершённый Future с указанным результатом.

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

Асинхронно и без блокировки преобразует TraversableOnce[A] в Future[TraversableOnce[B]] с помощью предоставленной функции A => Future[B]. Это полезно для выполнения параллельного отображения. Например, чтобы применить функцию ко всем элементам списка параллельно:

val myFutureList = Future.traverse(myList)(x => Future(myFunc(x)))