Método call()

Parte de la sección Programación Orientada a Objetos del Journey de Dart de Coddy — lección 73 de 110.

Dart tiene un método especial llamado call() que te permite usar un objeto como si fuera una función. Cuando una clase define un método call(), puedes invocar instancias de esa clase usando la sintaxis de llamada a función.

class Multiplier {
  int factor;
  
  Multiplier(this.factor);
  
  int call(int value) {
    return value * factor;
  }
}

void main() {
  var double = Multiplier(2);
  var triple = Multiplier(3);
  
  print(double(5));  // 10 - llamando al objeto como una función
  print(triple(5));  // 15
}

En lugar de escribir double.call(5), puedes simplemente escribir double(5). Dart invoca automáticamente el método call() cuando usas paréntesis en el objeto.

El método call() puede aceptar cualquier parámetro y devolver cualquier tipo, al igual que un método normal:

class Greeter {
  String prefix;
  
  Greeter(this.prefix);
  
  String call(String name, {String punctuation = '!'}) {
    return '$prefix, $name$punctuation';
  }
}

void main() {
  var hello = Greeter('Hello');
  print(hello('Alice'));  // Hello, Alice!
  print(hello('Bob', punctuation: '?'));  // Hello, Bob?
}

Este patrón es útil cuando necesitas objetos que se comporten como funciones pero que también mantengan un estado o configuración. Se utiliza comúnmente para crear operaciones reutilizables, validadores o formateadores que necesitan recordar ajustes entre llamadas.

Desafío

Fácil

¡Vamos a construir un sistema formateador de texto donde los objetos formateadores se puedan llamar directamente como funciones! Crearás clases invocables (callable classes) que transforman texto de diferentes maneras mientras mantienen sus ajustes de configuración.

Organizarás tu código en dos archivos:

formatters.dart: Crea dos clases invocables que transformen cadenas:
- Una clase Wrapper que envuelva el texto con un prefijo y sufijo configurables. Debe almacenar las cadenas prefix y suffix, y su método call() debe aceptar un String text y devolver el texto envuelto con el prefijo y el sufijo.
- Una clase Repeater que repita el texto un número configurable de veces. Debe almacenar un entero times, y su método call() debe aceptar un String text y devolver el texto repetido esa cantidad de veces, separado por espacios.
main.dart: Importa tus formateadores y demuestra cómo estos objetos pueden usarse igual que las funciones:
- Crea un Wrapper con el prefijo '[' y el sufijo ']'
- Crea otro Wrapper con el prefijo '***' y el sufijo '***'
- Crea un Repeater con times establecido en 3
- Llama al primer wrapper con 'Hello' e imprime el resultado
- Llama al segundo wrapper con 'Important' e imprime el resultado
- Llama al repeater con 'Go' e imprime el resultado
- Demuestra el encadenamiento pasando el resultado del primer wrapper (con 'Nested') al segundo wrapper, e imprime el resultado

Observa cómo puedes llamar a tus objetos formateadores directamente usando paréntesis, al igual que las funciones regulares. El método call() hace esto posible, ¡y cada objeto recuerda su configuración entre usos!

Salida esperada:

[Hello]
***Important***
Go Go Go
***[Nested]***

Hoja de referencia

El método call() te permite usar un objeto como si fuera una función. Cuando una clase define un método call(), puedes invocar instancias de esa clase utilizando la sintaxis de llamada a función.

class Multiplier {
  int factor;
  
  Multiplier(this.factor);
  
  int call(int value) {
    return value * factor;
  }
}

void main() {
  var double = Multiplier(2);
  print(double(5));  // 10 - llamando al objeto como una función
}

En lugar de escribir double.call(5), simplemente puedes escribir double(5). Dart invoca automáticamente el método call() cuando utilizas paréntesis en el objeto.

El método call() puede aceptar cualquier parámetro y devolver cualquier tipo:

class Greeter {
  String prefix;
  
  Greeter(this.prefix);
  
  String call(String name, {String punctuation = '!'}) {
    return '$prefix, $name$punctuation';
  }
}

void main() {
  var hello = Greeter('Hello');
  print(hello('Alice'));  // Hello, Alice!
  print(hello('Bob', punctuation: '?'));  // Hello, Bob?
}

Este patrón es útil para crear objetos que se comportan como funciones pero que también mantienen un estado o configuración entre llamadas.

Pruébalo tú mismo

import 'formatters.dart';

void main() {
  // TODO: Crear un Wrapper con el prefijo '[' y el sufijo ']'
  
  // TODO: Crear otro Wrapper con el prefijo '***' y el sufijo '***'
  
  // TODO: Crear un Repeater con times establecido en 3
  
  // TODO: Llamar al primer wrapper con 'Hello' e imprimir el resultado
  
  // TODO: Llamar al segundo wrapper con 'Important' e imprimir el resultado
  
  // TODO: Llamar al repeater con 'Go' e imprimir el resultado
  
  // TODO: Demostrar el encadenamiento pasando el resultado del primer wrapper
  // (con 'Nested') al segundo wrapper, e imprimir el resultado
}