Classes Chamáveis

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

Em Dart, você pode fazer com que instâncias de uma classe sejam chamáveis como funções implementando o método call(). Isso permite usar 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), Dart invoca automaticamente o método call() com 5 como argumento. O objeto se comporta como uma função, mantendo ainda seu estado (o campo factor).

O método call() pode ter qualquer assinatura — vários 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, validadores ou transformações reutilizáveis que precisam lembrar das configurações entre as chamadas.

Desafio

Fácil

Vamos criar um sistema de formatação 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 determinado número de vezes. Ela deve armazenar um valor int times e, quando chamada com um parâmetro String text, retornar o texto repetido essa quantidade 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 repita 3 vezes
- Chame o primeiro wrapper com "Hello" e imprima o resultado
- Chame o segundo wrapper com "Important" e imprima o resultado
- Chame o repetidor com "Go" e imprima o resultado
- Por fim, combine-os: chame o primeiro wrapper com o resultado de chamar o repetidor com "Dart" e imprima o resultado

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

Saída esperada:

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

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
  
}