Класс scala.deprecated

класс deprecated extends Annotation with StaticAnnotation

Аннотация, обозначающая, что определение устарело. При использовании аннотированного определения выдаётся предупреждение об устаревании.

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

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

@deprecated("this method will be removed", "FooLib 12.0")
def oldMethod(x: Int) = ...

Компилятор будет выдавать предупреждения об устаревании, сгруппированные по библиотеке и версии:

oldMethod(1)
oldMethod(2)
aDeprecatedMethodFromLibraryBar(3, 4)

// warning: there was one deprecation warning (since BarLib 3.2)
// warning: there were two deprecation warnings (since FooLib 12.0)
// warning: there were three deprecation warnings in total; re-run with -deprecation for details

@deprecated в языке Scala и его стандартной библиотеке

Устаревший элемент языка Scala или определение в стандартной библиотеке Scala будет сохраняться как минимум для текущей основной версии.

Это означает, что элемент, устаревший в какой-то версии 2.12.x, будет сохранён во всех версиях 2.12.x, но может быть удалён в 2.13. (Устаревший элемент может быть сохранён дольше, чтобы облегчить миграцию. Разработчики не должны полагаться на это.)

Специальная политика устаревания для Scala 2.12
Команда Scala приняла решение о специальной политике устаревания для Scala 2.12:

Поскольку обновление с 2.11 до 2.12 также требует обновления с Java 6 до Java 8, устаревшие элементы обычно не будут удалены в этом релизе, чтобы облегчить миграцию и кросс-компиляцию.

Аннотации: @getter() @setter() @beanGetter() @beanSetter() @field()
Источник: deprecated.scala
С: 2.3
См. также: Официальная документация по бинарной совместимости.
scala.deprecatedInheritance
scala.deprecatedOverriding
scala.deprecatedName

Линейные супертипы

Конструкторы экземпляров

новый deprecated(message: String = "", since: String = "")

message: сообщение для печати во время компиляции, если определение обращается
since: строка, определяющая первую версию, в которой определение было устаревшим

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

final def !=(arg0: Any): Boolean

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

возвращает: true если !(this == that), иначе false.

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

final def ##(): Int

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

возвращает: значение хеша, согласованное с ==

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

def +(other: String): String

Неявный: Этот член добавлен благодаря неявной конверсии из deprecated в any2stringadd[deprecated] с помощью метода any2stringadd в scala.Predef.
Определяющие классы: any2stringadd

def ->[B](y: B): (deprecated, B)

Неявный: Этот член добавлен благодаря неявной конверсии из deprecated в ArrowAssoc[deprecated] с помощью метода ArrowAssoc в scala.Predef.
Определяющие классы: ArrowAssoc
Аннотации: @inline()

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

def ensuring(cond: (deprecated) ⇒ Boolean, msg: ⇒ Any): deprecated

Неявный: Этот член добавлен благодаря неявной конверсии из deprecated в Ensuring[deprecated] с помощью метода Ensuring в scala.Predef.
Определяющие классы: Ensuring

def ensuring(cond: (deprecated) ⇒ Boolean): deprecated

Неявный: Этот член добавлен благодаря неявной конверсии из deprecated в Ensuring[deprecated] с помощью метода Ensuring в scala.Predef.
Определяющие классы: Ensuring

def ensuring(cond: Boolean, msg: ⇒ Any): deprecated

Неявный: Этот член добавлен благодаря неявной конверсии из deprecated в Ensuring[deprecated] с помощью метода Ensuring в scala.Predef.
Определяющие классы: Ensuring

def ensuring(cond: Boolean): deprecated

Неявный: Этот член добавлен неявным преобразованием из deprecated в Ensuring[deprecated] с помощью метода Ensuring в scala.Predef.
Определяющие классы: Ensuring

final def eq(arg0: AnyRef): Boolean

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

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

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

def equals(arg0: Any): Boolean

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

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

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

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

def finalize(): Unit

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

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

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

def formatted(fmtstr: String): String

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

Неявный: Этот член добавлен неявным преобразованием из deprecated в StringFormat[deprecated] с помощью метода StringFormat в scala.Predef.
Определяющие классы: StringFormat
Аннотации: @inline()

final def getClass(): Class[_]

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

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

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

def hashCode(): Int

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

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

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

final def isInstanceOf[T0]: Boolean

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

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

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

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

final def ne(arg0: AnyRef): Boolean

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

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

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

final def notify(): Unit

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

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

final def notifyAll(): Unit

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

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

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

Definition Classes: AnyRef
Annotations: @throws( ... )

final def wait(arg0: Long): Unit

Definition Classes: AnyRef
Annotations: @throws( ... ) @native()

def →[B](y: B): (deprecated, B)

Неявный: Этот член добавлен неявным преобразованием из deprecated в ArrowAssoc[deprecated] с помощью метода ArrowAssoc в scala.Predef.
Definition Classes: ArrowAssoc

© 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/deprecated.html