Classes Chamáveis

Parte da seção Programação Orientada a Objetos do Journey de Dart da Coddy — lição 84 de 110.

No Dart, você pode tornar as instâncias de uma classe chamáveis como funções implementando o método call(). Isso permite que você use um objeto com a sintaxe de chamada de função - usando parênteses diretamente na instância.

class Multiplier {
  final 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 - chamando o objeto como uma função
  print(triple(5));   // 15
}

Quando você escreve double(5), o Dart invoca automaticamente o método call() com 5 como o argumento. O objeto se comporta como uma função enquanto ainda mantém seu estado (o campo factor).

O método call() pode ter qualquer assinatura - múltiplos parâmetros, parâmetros opcionais ou até mesmo retornar tipos diferentes:

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

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

Classes chamáveis são úteis quando você precisa de um comportamento semelhante ao de uma função combinado com estado ou configuração. Elas são comumente usadas para criar operações reutilizáveis, validadores ou transformações que precisam lembrar de configurações entre chamadas.

Desafio

Fácil

Vamos construir um sistema de formatador de texto usando classes chamáveis! Você criará objetos que podem ser chamados como funções para transformar texto de diferentes maneiras, mantendo suas próprias configurações.

Você organizará seu código em dois arquivos:

formatters.dart: Crie duas classes chamáveis que transformam texto:
- Uma classe Wrapper que envolve o texto com um prefixo e um sufixo. Ela deve armazenar um String prefix e um String suffix e, quando chamada com um parâmetro String text, retornar o texto envolvido entre o prefixo e o sufixo.
- Uma classe Repeater que repete o texto um certo número de vezes. Ela deve armazenar um valor int times e, quando chamada com um parâmetro String text, retornar o texto repetido esse número de vezes com um espaço entre cada repetição.
main.dart: Importe seus formatadores e demonstre como as classes chamáveis funcionam:
- Crie um Wrapper com o prefixo "[" e o sufixo "]"
- Crie outro Wrapper com o prefixo "***" e o sufixo "***"
- Crie um Repeater que repete 3 vezes
- Chame o primeiro wrapper com "Hello" e imprima o resultado
- Chame o segundo wrapper com "Important" e imprima o resultado
- Chame o repeater com "Go" e imprima o resultado
- Finalmente, combine-os: chame o primeiro wrapper com o resultado de chamar o repeater com "Dart" e imprima o resultado

Observe como cada objeto formatador lembra sua configuração e pode ser chamado diretamente com parênteses, exatamente como uma função!

Saída esperada:

[Hello]
***Important***
Go Go Go
[Dart Dart Dart]

Folha de consulta

As classes podem se tornar chamáveis como funções ao implementar o método call():

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

void main() {
  var double = Multiplier(2);
  print(double(5));   // 10 - chamando o objeto como uma função
}

O método call() pode ter qualquer assinatura com múltiplos parâmetros, parâmetros opcionais ou diferentes tipos de retorno:

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

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

Classes chamáveis são úteis para criar comportamentos semelhantes a funções combinados com estado ou configuração.

Experimente você mesmo

import 'formatters.dart';

void main() {
  // TODO: Crie um Wrapper com prefixo "[" e sufixo "]"
  
  // TODO: Crie outro Wrapper com prefixo "***" e sufixo "***"
  
  // TODO: Crie um Repeater que repete 3 vezes
  
  // TODO: Chame o primeiro wrapper com "Hello" e imprima o resultado
  
  // TODO: Chame o segundo wrapper com "Important" e imprima o resultado
  
  // TODO: Chame o repeater com "Go" e imprima o resultado
  
  // TODO: Combine-os: chame o primeiro wrapper com o resultado de
  // chamar o repeater com "Dart", e imprima o resultado
  
}