Трейт scala.concurrent.Future

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

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

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

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

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

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

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

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

Дождитесь состояния "завершено" этого Awaitable.

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

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

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

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

Создаёт новый 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 => sys.error("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 реализует отношение эквивалентности на не-нулевых экземплярах 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 будет успешно завершён с Throwable исходного Future, если исходный Future завершается ошибкой.

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

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

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

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

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

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

Пример:

val f = Future { sys.error("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 (@see 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!" }

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

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

Эквивалентно !(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 вызывает исключение, результирующий фьючер завершается с этим исключением, если оно не является фатальным.