Recapitulação - Coleção Personalizada

Parte da seção Programação Orientada a Objetos do Journey de PHP da Coddy. Lição 50 de 91.

Desafio

Fácil

Vamos criar uma classe Collection que reúne todos os métodos mágicos que você aprendeu neste capítulo. Sua coleção funcionará como um contêiner de dados flexível e natural de usar: armazenando itens por chave, verificando se eles existem, encontrando itens dinamicamente e criando cópias independentes.

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

Collection.php: crie uma classe Collection que armazene itens em um array privado. Sua coleção deve oferecer suporte aos seguintes métodos mágicos trabalhando em conjunto:
- __construct(): aceita um array opcional de itens iniciais (com um array vazio como padrão)
- __get($key): retorna o item na chave fornecida ou null se ele não existir
- __set($key, $value): armazena o valor na chave fornecida
- __isset($key): retorna se a chave existe na coleção
- __unset($key): remove o item na chave fornecida
- __call($method, $args): trata métodos de busca dinâmicos. Quando um método que começa com findBy é chamado (como findByRole ou findByStatus), extraia o nome do campo (converta para minúsculas a parte após "findBy"), pesquise em todos os itens e retorne a chave do primeiro item cujo campo corresponda ao primeiro argumento. Retorne null se nenhuma correspondência for encontrada. Para qualquer outro método, retorne "Unknown method: [method]"
- __toString(): retorna "Collection([count] items)", em que count é o número de itens
- __clone(): quando clonado, o array de itens deve ser uma cópia nova (não uma referência ao original)
main.php: inclua o arquivo Collection. Você receberá três entradas: um nome de chave, um valor de função e uma função para pesquisa. Crie uma coleção de usuários e demonstre todos os métodos mágicos:
- Crie uma nova Collection
- Adicione um usuário com a chave de entrada, armazenando um array com "name" definido como a chave e "role" definido como o valor de função informado
- Adicione outro usuário com a chave "bob", armazenando ["name" => "Bob", "role" => "editor"]
- Imprima se a chave de entrada existe usando isset(): produza "exists" ou "missing"
- Imprima o resultado da chamada do método dinâmico findByRole() com a função para pesquisa como argumento (isso deve retornar a chave do usuário correspondente ou nada se o resultado for null)
- Imprima a coleção usando echo (aciona __toString)
- Clone a coleção e, em seguida, remova a chave de entrada do clone usando unset
- Imprima se a chave de entrada existe na coleção original: produza "exists" ou "missing" (ela ainda deve existir, pois o clone é independente)

Cada saída deve estar em sua própria linha. O mecanismo de busca dinâmico pressupõe que cada item da sua coleção seja um array associativo com campos como "name" e "role".

Experimente você mesmo

<?php

require_once 'Collection.php';

// Ler entradas
$keyName = trim(fgets(STDIN));
$roleValue = trim(fgets(STDIN));
$searchRole = trim(fgets(STDIN));

// TODO: Crie uma nova Collection

// TODO: Adicione um usuário com a chave de entrada, armazenando array com "name" => key e "role" => roleValue

// TODO: Adicione outro usuário com a chave "bob", armazenando ["name" => "Bob", "role" => "editor"]

// TODO: Imprima se a chave de entrada existe usando isset() - saída "exists" ou "missing"

// TODO: Imprima o resultado de chamar findByRole() com searchRole como argumento

// TODO: Imprima a coleção usando echo (dispara __toString)

// TODO: Clone a coleção, então unset a chave de entrada do clone

// TODO: Imprima se a chave de entrada existe na coleção ORIGINAL - "exists" ou "missing"

?>