Ir para conteúdo
paulodsn

Interface em CRUD - S.O.L.I.D

Recommended Posts

Fala pessoal,

 

Estou com uma dúvida, comecei a estudar sobre design partners e acabei me deparando com as regras S.O.L.I.D. Assistir alguns debates entretanto fiquei com uma dúvida que é:

  • sempre devo usar uma interface em um controller?
  • Em um CRUD é necessário o uso de interface? 
  • Quando usar interface?

 

Obrigado desde já.

Compartilhar este post


Link para o post
Compartilhar em outros sites

Olá amigo, linguagens como PHP não desfrutam de todo pode que uma interface oferece, nesta linguagem você consegue burlar tudo, criar hacks para as coisas, etc. veja alguns hacks abaixo:

$class_name = "StdClass";
new $class_name;
$object->{"nomeDoMetodo"}($a, $b, $c);
// Entre outras "gambiarras"

Interfaces não são o que são por iniciar seu design com a palavra interface, na verdade é possível criar interfaces em qualquer linguagem, mesmo que está não ofereça uma "keyword" chamada "Interface", pra ser mais especifico, é possível criar uma interface usando uma classe concreta, eu sei que essa pode ter doído um pouco, mas você entenderá assim que conseguir "ficar de pé na prancha".

 

Veja um exemplo:

interface Crud
{
    public function create(/* [args...] */);
    
    public function read(/* [args...] */);
    
    public function update(/* [args...] */);
    
    public function delete(/* [args...] */);
}

Vamos implementar esta interface onde quisermos

class MySql implements Crud
{}

class SQLite implements Crud
{}

class XML implements Crud
{}

class JSON implements Crud
{}

class TextPlain implements Crud
{}

class Etc implements Crud
{}

Dessa maneira a única instancia que nosso sistema vai esperar será a de "Crud" e não a de MySql, SQLite ou outro.

class UmaClasseQueFazAlgo
{
    /**
    * @var Crud
    */
    private $instanciaDeCrud;
    
    /**
    * @param Crud $crud
    */
    public function __construct(Crud $crud)
    {
        $this->instanciaDeCrud = $crud;
    }
    
    public function facaAlgo()
    {
        /*
        Dessa maneira você poderá mudar internamente de MySql 
        para JSON que não afetará em nada aqui
        */
        $this->instanciaDeCrud->create(/* [args...] */);
    }
}

(new UmaClasseQueFazAlgo())->facaAlgo();

 

  • Obrigado! 1

Compartilhar este post


Link para o post
Compartilhar em outros sites

Olá @paulodsn.

 

5 minutos atrás, paulodsn disse:

sempre devo usar uma interface em um controller?

Honestamente, não entendi muito bem essa dúvida.

O que é um controller pra você? Um dos 3 pilares do MVC? Se sim, quem fornece esse controller à você?

Digo, qual biblioteca ou framework? Phalcon? ZF? Yii? Laravel?

Esse monte de questões é pelo fato de que depende. Depende de quem projetou/desenhou a ferramenta que você está utilizando.

Eu particularmente nunca vi uma framework que ofereça uma interface (não abrangendo classes abstratas aqui) para um Controller, mas nada impede de haver, pois isso é um mero detalhe da implementação do projeto.

 

12 minutos atrás, paulodsn disse:

Em um CRUD é necessário o uso de interface? 

De novo, depende do projeto. Vamos supor que você queira criar uma lib para auxiliar nos métodos de resposta para um CRUD, beleza... daí você pode criar uma interface, que nada mais é do que um contrato entre as partes do sistema que se relacionam de alguma forma, pelo ponto que tange o uso dessa interface (seus métodos/declaração). Exemplo:

<?php
interface CrudInterface {
    
    public function create();
    public function read();
    public function update();
    public function delete();
    
}

Agora quem implementar essa interface deve implementar seus métodos. Por isso é um contrato. Todos sabem que a classe que implementa essa interface segue um padrão de comportamento e pode fazer uma ou mais tarefas.

 

Então temos um controller para as notícias do sistema que implementa essa interface, pois sabemos que ele deve respeitar as respostas dos 4 métodos que definimos:

class Noticias implements CrudInterface {
    public function create()
    {
        //lógica para criar uma notícia
    }
    
    public function read()
    {
        //lógica para ler notícias
    }
    
    public function update()
    {
        //lógica para atualizar uma notícia
    }
    
    public function delete() {
        //lógica para excluir uma notícia
    }
}

 

Isso facilita a organização do código, pois dá limites à ele. Expõe as intenções de um pacote sem precisar necessariamente explicar sobre isso.

 

Tudo é muito conceitual, eu sei. Passei pelas mesmas dúvidas que você. É fato ainda que muitas vezes podemos utilizar classes abstratas ao invés de interfaces e isso nos confunde ainda mais, certo?

Mas a verdade é que interfaces são meras definições comportamentais. Ela diz: essa classe FAZ alguma coisa, enquanto uma classe abstrata indica que a classe filha É alguma coisa.

 

Veja:

- Temos um Funcionário em uma empresa (uma pessoa, genérica, mas com atribuições que lhe colocam em um grupo específico).

- Temos o comportamento de Dirigir (algo que pessoas fazem, mas não todas).

 

Então podemos criar uma pessoa concreta seguindo o raciocínio:

class Pessoa {}
interface CarDriver {
    public function turnLeft();
    public function turnRight();
	public function moveForward();
    //outras possíveis ações no manuseio de um carro
}
class Funcionario extends Pessoa {}

//observe a composição de classes e "contratos de ações" (interfaces)
//Joao deve implementar sua forma de dirigir por si só. Cada um dirige de uma forma.
class Joao extends Pessoa implements CarDriver {
   //implementações....
}

 

O problema é que esses exemplos, apesar de verdadeiros, não nos auxiliam no entendimento para a prática no desenvolvimento web. Então vamos pegar o exemplo do nosso pequeno módulo de Noticias com CRUD e bolar um exemplo prático. Vou colocar arquivo por arquivo. Leia linha-a-linha, pois fiz comentários para ajudar no entendimento.

 

CrudInterface

/**
 * Cada recurso da nossa pequena API REST deve implementar essa interface se quiser
 * declarar ao sistema que respeita os métodos de uma CRUD comum
 */
interface CrudInterface
{
    public function create(array $data);
    public function read(int $id = null);//Se id informado, apenas ele, senão todos
    public function update(array $data, int $id);
    public function delete(int $id);//argumento tipado disponível somente no PHP 7.0.0 em diante
}

 

News (uma implementação concreta de CRUD)

class News implements CrudInterface
{
    
    /**
     * Isso seria responsabilidade de outra lib, mas vamos armazenar as noticias aqui para fins didáticos.
     * Vamos preencher com dados por padrão para exemplificar.
     */
    private $news = [
        [
            'id'     => 1,//como em um banco de dados, vamos começar o id por 1 e não 0
            'titulo' => 'Girafas agora podem voar!',
            'texto'  => 'Lorem ipsum dolor sit amet...',
        ],
        [
            'id'     => 2,
            'titulo' => 'iMasters eleito o maior portal de TI do Brasil novamente!',
            'texto'  => 'Lorem ipsum dolor sit amet...',
        ],
    ];
    
    public function create(array $data)
    {
        $this->news[] = [
            'id'     => $this->getLastId() + 1,
            'titulo' => $data[ 'titulo' ],//seria interessante validar...
            'texto'  => $data[ 'texto' ],
        ];
    }
    
    public function read(int $id = null)
    {
        if ( $id === null ) {
            return print_r( $this->news, true );//leitura de um registro específico
        }
        
        return print_r( $this->news[ $this->getIndexById( $id ) ], true );//leitura de todos os registros
    }
    
    public function update(array $data, int $id)
    {
        $registro =& $this->news[ $this->getIndexById( $id ) ];
        
        if ( isset( $data[ 'titulo' ] ) ) {
            $registro[ 'titulo' ] = $data[ 'titulo' ];
        }
        
        if ( isset( $data[ 'texto' ] ) ) {
            $registro[ 'texto' ] = $data[ 'texto' ];
        }
    }
    
    public function delete(int $id)
    {
        unset( $this->news[ $this->getIndexById( $id ) ] );
    }
    
    /**
     * Os métodos abaixo fazem parte da nossa implementação somente.
     * Não faz parte do contrato, mas precisamos desses métodos para ajudar a satisfazer o propósito da classe
     */
    private function getIndexById(int $id)
    {
        foreach ( $this->news as $i => $noticia ) {
            if ( $noticia[ 'id' ] === $id ) {
                return $i;
            }
        }
        
        throw new Exception( 'ID inexistente.' );
    }
    
    private function getLastId()
    {
        return max( array_column( $this->news, 'id' ) );
    }
    
}

 

AddressParser - Apenas um auxiliar para a classe responsável pelas Rotas

class PatternNotSatisfied extends Exception
{
}

/**
 * Essa classe não segue os princípios da Clean Code / S.O.L.I.D.
 * Muita responsabilidade em cima de cada método, mas para não aumentarmos a quantidade de classes,
 * fiz uma implementação bem primitiva propositalmente. Ela é apenas uma auxiliar do Router,
 * mas podia ser desmembrada para ficar melhor.
 */
class AddressParser
{
    
    private $address;
    private $params = [];
    
    public function __construct($actual_address)
    {
        $this->address = trim( $actual_address, '/' );
    }
    
    public function getFirstSuitablePattern($options)
    {
        $address_chunks = explode( '/', $this->address );
        
        foreach ( $options as $pattern ) {
            $this->params = [];
            $pattern_chunks = explode( '/', trim( $pattern, '/' ) );
            $address_chunks_copy = $address_chunks;
            
            try {
                while ( $pattern_chunk = array_shift( $pattern_chunks ) ) {
                    $this->parseAndTestChunks( $pattern_chunk, array_shift( $address_chunks_copy ) );
                }
                
                return $pattern;//se não encontrou exceções, pode ser utilizada como padrão para a URL requisitada
                
            } catch ( PatternNotSatisfied $e ) {
            }
        }
        
        return end( $options );
    }
    
    private function parseAndTestChunks($pattern_chunk, $address_chunk = null)
    {
        //Trata-se de um parâmetro
        if ( $pattern_chunk[ 0 ] === ':' ) {
            
            //O parâmetro é obrigatório
            if ( $pattern_chunk[ 1 ] !== '[' && !$address_chunk ) {
                throw new PatternNotSatisfied();
            }
            
            //O parâmetro é opcional
            if ( $address_chunk ) {
                $this->params[] = $address_chunk;
            }
            
            return;
        }
        
        if ( $pattern_chunk === $address_chunk ) {
            return;
        }
        
        throw new PatternNotSatisfied();
    }
    
    public function getParamsFromLastParsing()
    {
        return $this->params;
    }
    
}

 

Router

/**
 * Implementação da Router desconsiderando a REQUEST e RESPONSE
 *
 * Além disso trabalharemos apenas com métodos para tratar as calls, ignorando a possibilidade
 * do uso de Closures, por exemplo.
 */
class Router
{
    
    private $methods = [];
    
    /**
     * Os exemplos serão feitos "na mão", via código mesmo. Por isso precisamos de um método para invocar
     * nossas requisições, simulando uma ação externa, como em uma pequena API REST
     */
    public function request($http_method, $actual_address, array $params = null)
    {
        $parser = new AddressParser( $actual_address );
        $possible_methods = array_keys( $this->methods[ $http_method ] );
        $address_pattern = $parser->getFirstSuitablePattern( $possible_methods );
        $handler = $this->methods[ $http_method ][ $address_pattern ];
        
        $params = array_merge( (array)$params, (array)$parser->getParamsFromLastParsing() );
        
        return call_user_func_array( $handler, $params );
    }
    
    /**
     * O que é $controller? Um objeto Controller? Não importa!
     * handleCrud() espera apenas que o objeto seja capaz de responder por uma CRUD
     *
     * As requisições devem respeitar as seguintes regras:
     * 1 - Quantas partes (controller, action, etc) quiser para compor a URL
     * 2 - Parametros começam com :
     * 3 - Parâmetros opcionais ficam dentro de [ ]
     */
    public function handleCrud(CrudInterface $controller)
    {
        $resource_name = mb_strtolower( get_class( $controller ) );//apenas o nome da classe minúsculo. No caso, "news"
        
        $this->get( "/{$resource_name}/:[id]", [ $controller, 'read' ] );
        $this->post( "/{$resource_name}/:id", [ $controller, 'update' ] );
        $this->put( "/{$resource_name}", [ $controller, 'create' ] );
        $this->delete( "/{$resource_name}/:[id]", [ $controller, 'delete' ] );
    }
    
    /**
     * Na nossa limitada implementação, $handler deve representar um array com o par "objeto-nome do método"
     */
    public function get($address, array $handler)
    {
        $this->methods[ 'GET' ][ $address ] = $handler;
    }
    
    public function post($address, array $handler)
    {
        $this->methods[ 'POST' ][ $address ] = $handler;
    }
    
    public function put($address, array $handler)
    {
        $this->methods[ 'PUT' ][ $address ] = $handler;
    }
    
    public function delete($address, array $handler)
    {
        $this->methods[ 'DELETE' ][ $address ] = $handler;
    }
    
}

 

 

E agora unimos tudo e usamos a ferramenta:

$router = new Router;
$app = new News;

/**
 * É aqui que a mágica acontece.
 * Veja a implementação de Router e notará que ele nem sequer conhece uma notícia (News).
 * Ele apenas oferece um método adicional (além de get, put, etc...) para tratar especificamente CRUDs.
 * E como ele sabe quem pode tratar uma CRUD?
 * Pela imposição feita sobre o tipo do parâmetro desse método (CrudInterface).
 */
$router->handleCrud( $app );

/**
 * Vamos simular algumas requisições.
 * Note o uso de [[]]. Isso é pelo fato de este parâmetro gera uma lista chave-valor de parâmetros para o objecto,
 * onde o primeiro parâmetro da lista seria $data com o array de dados.
 *
 * Caso fosse um único array, estaríamos dizendo que queríamos passar $titulo e $texto como parâmetro,
 * enquanto na verdade queremos passar um array de dados.
 */
$router->request( 'PUT', '/news', [ [ 'titulo' => 'TESTANDO', 'texto' => 'bla bla bla bla' ] ] );
$router->request( 'POST', '/news/3', [ [ 'titulo' => 'Este novo título é muito melhor :)' ] ] );
$router->request( 'DELETE', '/news/1' );

//exibimos o resultado final
echo nl2br( $router->request( 'GET', '/news' ) );

 

Resultado:

Array
(
[1] => Array
(
[id] => 2
[titulo] => iMasters eleito o maior portal de TI do Brasil novamente!
[texto] => Lorem ipsum dolor sit amet...
)

[2] => Array
(
[id] => 3
[titulo] => Este novo título é muito melhor :)
[texto] => bla bla bla bla
)

)

 

  • Obrigado! 1

Compartilhar este post


Link para o post
Compartilhar em outros sites

@Matheus Tavares Muito obrigado pela explicação, reforçou mais a ideia, onde eu posso sim ter uma interface em meu controller ( MVC - Laravel). Porém vai depender para que eu quero utiliza-lo e se realmente é preciso a interface, no seu exemplo é uma obrigação a existência de uma interface pois na parte:

    public function handleCrud(CrudInterface $controller)
    {
        $resource_name = mb_strtolower( get_class( $controller ) );//apenas o nome da classe minúsculo. No caso, "news"
        
        $this->get( "/{$resource_name}/:[id]", [ $controller, 'read' ] );
        $this->post( "/{$resource_name}/:id", [ $controller, 'update' ] );
        $this->put( "/{$resource_name}", [ $controller, 'create' ] );
        $this->delete( "/{$resource_name}/:[id]", [ $controller, 'delete' ] );
    }
    

 

Você utiliza os métodos no qual foram definidos através do "contrato". Além disso você não precisa especificar qual class está sendo passada para ele, apenas sendo necessário que a class passada tenha o "contrato".

Compartilhar este post


Link para o post
Compartilhar em outros sites

Perfeito, @paulodsn. Excelente observação.

 

37 minutos atrás, paulodsn disse:

no seu exemplo é uma obrigação a existência de uma interface

Apenas é bom reforçar a diferença que expliquei no post (entre interfaces x classes abstratas), em relação a isso que você disse.

 

O código obriga sim uma interface para declarar as regras de comportamento da classe, que serão utilizadas pelo Router.

Mas essa interface poderia ser feita utilizando uma classe abstrata também.

 

Bastaria que para isso tornássemos CrudInterface uma classe abstrata e seus métodos fossem abstract.

 

Aí vai da sua necessidade e do seu projeto.

O método handleCrud() poderia funcionar exatamente da mesma forma, se ao invés da interface ele definisse que o tipo fosse uma classe abstrata.

 

É interessante ver os exemplos do próprio PHP: http://php.net/manual/pt_BR/reserved.interfaces.php

Observe que interfaces geralmente possuem nomes como "FAZEDOR" (sufixo "or") de alguma coisa ou "CAPAZ" (able) de fazer algo.

Exemplo: "Traversable" => "Capaz de atravessar / (Percorrível)"

Outro: "Throwable" => "Capaz de arremessar/disparar (uma exceção, no caso)"

 

Já uma classe, mesmo abstrata, ela sempre SERÁ alguma coisa. "Animal" é o abstrato de Cachorro (que é concreto)...

 

Enfim... mas que bom que o código te ajudou. Os conceitos confundem mesmo, por isso quis trazer algo mais "prático". Geralmente é mais eficiente no aprendizado.

Compartilhar este post


Link para o post
Compartilhar em outros sites

Crie uma conta ou entre para comentar

Você precisar ser um membro para fazer um comentário

Criar uma conta

Crie uma nova conta em nossa comunidade. É fácil!

Crie uma nova conta

Entrar

Já tem uma conta? Faça o login.

Entrar Agora

  • Conteúdo Similar

    • Por Loconarrativo
      Bom, no meu form, eu peço para o cliente digitar um valor (esse valor em reais), mas para continuar eu preciso me certificar que a variável que contem o valor, tenha 16 dígitos ao total, então se a pessoa digita uma 1000.00, eu preciso completar com 9 zeros a esquerda (fica assim 0000000001000.00), para eu saber quantos dígitos tem na variável, eu faço
      $i = strlen( $_POST['valor']);   ai eu faço
      $u = 8 - $i ; eu tenho o numero de zeros que preciso colocar a esquerda, mas como eu transformo isso em vários zeros? 
    • Por leandrosv
      Boa tarde pessoal, uma dúvida somente,se conseguirem  me responder ficarei grato!.
      Programo em php há 6 meses. Até o momento foquei em aprender e fazer para  mim.
      Peguei meu primeiro projeto, para um amigo, porém design, css e javascript não é meu forte, falta criatividade e aprender bastante sobre o JS.
      A duvida é a seguinte: Comprei um tema no themeforest.net à escolha dele(amigo), e o tema veio com puglins woocommerce, a minha dúvida é se posso hospedar e utilizar normalmente no site esses plugins sem usar o sistema wordpress. Editei o código js e css do que não me interessa e está funcionando legal. A dúvida mesmo, unica dúvida é se posso e vou conseguir rodar meu site em uma hospedagem normal sem o sistema wordpress.
      Obrigado!
      **moderadores e administradores do fórum, caso seja aqui um tópico errado, perdão, procurei mas não achei nada a respeito do assunto.
    • Por Marcos Bellini
      Olá amigos, alguém já fez integração do Frenet (frenet.com.br) utilizando PHP?
       
      Vi que existe muitos módulos prontos para Magento e etc, porém quero integrar com minha loja, código próprio e estou tendo dificuldades.
       
      Alguém já fez o mesmo?
    • Por M. Alberto
      Estou realizando a migração de meu site que utiliza um banco de dados em mySQL PHP porém estou obtendo erro.
       
      Criei o banco de dados e fiz upload dos arquivos, porém agora neste servidor não roda de maneira alguma. Alguém poderia me ajudar ?
    • Por cauai
      Olá,
      Eu estou tentando criar uma lista de vendedores que irão receber o contato de clientes através do meu site. É uma plataforma wordpress, porém tenho completo acesso ao código php.
      Até agora, só achei maneiras de enviar para múltiplos e-mails, como cópia, ou separando por departamento à escolha do cliente, utilizando o Contact Form 7, o que não é meu desejo.
      Quero algo como isso:
       
      Não sei se o Contact Form 7 me permitiria algo desse tipo, ou se teria mesmo que fazer pelo php. Mas aceito ajuda para ambos os casos.
×

Informação importante

Ao usar o fórum, você concorda com nossos Termos e condições.