Трейт scala.concurrent.Future

Возвращает, завершился ли фьючер значением или исключением.

Примечание: использование этого метода приводит к недетерминированным программам с потоком данных.

При завершении этого фьючера, либо исключением, либо значением, примените предоставленную функцию.

Если фьючер уже завершен, это будет применено либо немедленно, либо асинхронно.

Обратите внимание, что возвращаемое значение f будет проигнорировано.

Поскольку этот метод выполняется асинхронно и не возвращает значение, любые некритические исключения будут сообщены ExecutionContext.

Может быть зарегистрировано несколько обратных вызовов; нет гарантии, что они будут выполнены в определенном порядке.

Предоставленный обратный вызов всегда выполняется в предоставленном неявном ExecutionContext, хотя нет гарантии, что метод execute() на ExecutionContext будет вызываться один раз на каждый обратный вызов или что execute() будет вызываться в текущем потоке. То есть реализация может запускать несколько обратных вызовов в пакете в рамках одного execute() и может запускать execute() немедленно или асинхронно. Завершение фьючера должно *произойти до* вызова обратного вызова.

Ожидайте состояния "completed" этого Awaitable.

Этот метод не следует вызывать напрямую; используйте Await.ready вместо этого.

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

Этот метод не следует вызывать напрямую; используйте Await.result вместо этого.

Создаёт новый Future, применяя указанную функцию к результату этого Future. Если при применении 'f' возникло какое-либо некритическое исключение, то это исключение будет передано в результирующее future.

Создаёт новый Future, применяя указанную функцию, которая возвращает Future, к результату этого Future. Если при применении 'f' возникло какое-либо некритическое исключение, то это исключение будет передано в результирующее future.

Текущее значение этого Future.

Примечание: использование этого метода приводит к недетерминированным программам с потоком данных.

Если future не был завершен, возвращаемое значение будет None. Если future был завершен, значение будет Some(Success(t)) если он содержал действительный результат, или Some(Failure(error)) если он содержал исключение.

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

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

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

Применяет функцию с побочным эффектом к результату этого будущего и возвращает новое будущее с результатом этого будущего.

Этот метод позволяет обеспечить, чтобы обратные вызовы выполнялись в определенном порядке.

Обратите внимание, что если один из цепочечных andThen обратных вызовов генерирует исключение, это исключение не передается последующим andThen обратным вызовам. Вместо этого последующие andThen обратные вызовы получают исходное значение этого будущего.

Следующий пример выведет 5:

val f = Future { 5 }
f andThen {
  case r => throw new RuntimeException("runtime exception")
} andThen {
  case Failure(t) => println(t)
  case Success(v) => println(v)
}

Поскольку этот метод выполняется асинхронно и не возвращает значение, любые некритические исключения будут сообщены ExecutionContext.

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

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

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

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

Создаёт новый фьючер, отображая значение текущего фьючера, если заданная частичная функция определена для этого значения.

Если текущий фьючер содержит значение, для которого частичная функция определена, то новый фьючер также будет содержать это значение. В противном случае, результирующий фьючер завершится с ошибкой NoSuchElementException.

Если текущий фьючер завершается ошибкой, то и результирующий фьючер также завершается ошибкой.

Пример:

val f = Future { -5 }
val g = f collect {
  case x if x < 0 => -x
}
val h = f collect {
  case x if x > 0 => x * 2
}
g foreach println // Eventually prints 5
Await.result(h, Duration.Zero) // throw a NoSuchElementException

Проверяет, является ли аргумент (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).

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

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

Возвращаемое значение Future будет успешно завершено с результатом Throwable исходного Future в случае, если исходное Future завершится неудачно.

Если исходное Future завершится успешно, возвращаемое Future завершится с ошибкой NoSuchElementException.

Этот объект может содержать исключение, что означает, что задача завершилась неудачно. Задачи, полученные с помощью комбинаторов, имеют то же исключение, что и исходная задача. Следующие типы исключений не содержатся в задаче:

Error - критические ошибки не содержатся в задачах InterruptedException - не содержатся в задачахвсе scala.util.control.ControlThrowable за исключением NonLocalReturnControl - не содержатся в задачах

Вместо этого, задача завершается с ExecutionException, с одним из вышеперечисленных исключений в качестве причины. Если задача завершается с scala.runtime.NonLocalReturnControl, она завершается со значением, взятым из этого исключения.

Создает новую задачу, содержащую результат этой задачи, если она была выполнена успешно, или, если нет, результат задачи that, если that успешно выполнена. Если обе задачи завершились неудачно, результирующая задача содержит исключение первой задачи.

Использование этого метода не приведет к недетерминированному поведению конкуретных программ.

Пример:

val f = Future { throw new RuntimeException("failed") }
val g = Future { 5 }
val h = f fallbackTo g
h foreach println // Eventually prints 5

Создает новую задачу, отфильтровав значение текущей задачи с помощью предиката.

Если текущая задача содержит значение, которое удовлетворяет предикату, новая задача также будет содержать это значение. В противном случае результирующая задача завершится с ошибкой NoSuchElementException.

Если текущая задача завершается неудачно, то результирующая задача также завершается неудачно.

Пример:

val f = Future { 5 }
val g = f filter { _ % 2 == 1 }
val h = f filter { _ % 2 == 0 }
g foreach println // Eventually prints 5
Await.result(h, Duration.Zero) // throw a NoSuchElementException

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

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

Создает новый фьючер, применяя функцию к результату успешного выполнения этого фьючера, и возвращает результат функции в качестве нового фьючера. Если этот фьючер завершен с исключением, то новый фьючер также будет содержать это исключение.

Пример:

val f = Future { 5 }
val g = Future { 3 }
val h = for {
  x: Int <- f // returns Future(5)
  y: Int <- g // returns Future(3)
} yield x + y

переводится в:

f flatMap { (x: Int) => g map { (y: Int) => x + y } }

Создает новый фьючер с одним уровнем вложенности, уплощенный. Этот метод эквивалентен flatMap(identity).

Асинхронно обрабатывает значение во фьючере, как только оно станет доступным.

ПРЕДУПРЕЖДЕНИЕ: Не будет вызвано, если этот фьючер никогда не завершится или если он завершится с ошибкой.

Поскольку этот метод выполняется асинхронно и не возвращает значения, любые некритические исключения будут сообщены ExecutionContext.

Возвращает строку, отформатированную в соответствии с заданной строкой format. Форматные строки аналогичны String.format (@см. java.lang.String.format).

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

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

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

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

Создаёт новый фьючер, применяя функцию к успешному результату этого фьючера. Если этот фьючер завершился с исключением, то новый фьючер также будет содержать это исключение.

Пример:

val f = Future { "The future" }
val g = f map { x: String => x + " is now!" }

Обратите внимание, что для понимания, включающего Future, может потребоваться вызов map и/или flatMap и withFilter. См. scala.concurrent.Future#flatMap для примера такого понимания.

Создаёт новый фьючер, который завершается результатом этого фьючера, если он соответствует стёртому типу S, или ClassCastException в противном случае.

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

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

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

Создаёт новый фьючер, который будет обрабатывать любые соответствующие исключения, которые этот фьючер может содержать. Если нет соответствия или этот фьючер содержит допустимый результат, то новый фьючер будет содержать то же самое.

Пример:

Future (6 / 0) recover { case e: ArithmeticException => 0 } // result: 0
Future (6 / 0) recover { case e: NotFoundException   => 0 } // result: exception
Future (6 / 2) recover { case e: ArithmeticException => 0 } // result: 3

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

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

Пример:

val f = Future { Int.MaxValue }
Future (6 / 0) recoverWith { case e: ArithmeticException => f } // result: Int.MaxValue

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

Создаёт новый фьючер, применяя функцию 's' к результату выполнения этого фьючера при успешном завершении, или функцию 'f' к результату при ошибке. Если при применении 's' или 'f' возникает какое-либо некритическое исключение, это исключение будет передано в результирующий фьючер.

Объединяет значения this и that фьючерсов, создавая новый фьючерс, содержащий кортеж их результатов.

Если фьючерс this завершается ошибкой, результирующий фьючерс завершается ошибкой с исключением, сохранённым в this. В противном случае, если фьючерс that завершается ошибкой, результирующий фьючерс завершается ошибкой с исключением, сохранённым в that.

Объединяет значения this и that фьючерсов, используя функцию f, и создаёт новый фьючерс, содержащий результат.

Если фьючерс this завершается ошибкой, результирующий фьючерс завершается ошибкой с исключением, сохранённым в this. В противном случае, если фьючерс that завершается ошибкой, результирующий фьючерс завершается ошибкой с исключением, сохранённым в that. Если применение f вызывает исключение, результирующий фьючерс завершается ошибкой с этим исключением, если оно не является фатальным.