Методы расширения

Эта страница документа относится к Scala 3 и может охватывать новые концепции, недоступные в Scala 2. Если не указано явно, все примеры кода на этой странице предполагают, что вы используете Scala 3.

В Scala 2 аналогичного результата можно добиться с помощью неявных классов.

Методы расширения позволяют добавлять методы к типу после того, как он был определен, т.е. они позволяют добавлять новые методы в закрытые классы. Например, представьте, что кто-то создал класс Circle:

case class Circle(x: Double, y: Double, radius: Double) 

Теперь представим, что необходим метод circumference, но нет возможности изменить исходный код Circle. До того как концепция вывода терминов была введена в языки программирования, единственное, что можно было сделать, это написать метод в отдельном классе или объекте, подобном этому:

object CircleHelpers { def circumference(c: Circle): Double = c.radius * math.Pi * 2 } 

object CircleHelpers: def circumference(c: Circle): Double = c.radius * math.Pi * 2 

Затем этот метод можно было использовать следующим образом:

val aCircle = Circle(2, 3, 5) // без использования метода расширения CircleHelpers.circumference(aCircle) 

Но методы расширения позволяют создать метод circumference для работы с экземплярами Circle:

extension (c: Circle) def circumference: Double = c.radius * math.Pi * 2 

В этом коде:

• Circle — это тип, к которому будет добавлен метод расширения circumference
• Синтаксис c: Circle позволяет ссылаться на переменную c в методах расширения

Затем в коде метод circumference можно использовать так же, как если бы он был изначально определен в классе Circle:

aCircle.circumference 

Импорт методов расширения

Представим, что circumference определен в пакете lib - его можно импортировать с помощью

import lib.circumference aCircle.circumference 

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

value circumference is not a member of Circle, but could be made available as an extension method. The following import might fix the problem: import lib.circumference 

Обсуждение

Ключевое слово extension объявляет о намерении определить один или несколько методов расширения для типа, заключенного в круглые скобки. Чтобы определить для типа несколько методов расширения, используется следующий синтаксис:

extension (c: Circle) def circumference: Double = c.radius * math.Pi * 2 def diameter: Double = c.radius * 2 def area: Double = math.Pi * c.radius * c.radius