Skip to content

Latest commit

 

History

History
191 lines (131 loc) · 7.37 KB

README.md

File metadata and controls

191 lines (131 loc) · 7.37 KB
Raw

Sistema de Injeção de Dependências e Gerenciamento de Rotas

Integrantes

  • Alisson de Oliveira - R.A 200029600
  • Davi Ribeiro - R.A 200016718
  • Denilson Melo - R.A 200028969
  • Maria Clara Mendes - R.A 200028802
  • Maria Fernanda Barçante - R.A 200028863
  • Vinicius Lago - R.A 200028769
  • Adnan Fatal Anunciação Nascimento - R.A 200028791
  • Larissa da Silva Santana - R.A 200029897
  • Luan Gabriel Ornelas Sacramento Oliveira - R.A 20027297

Descrição Geral

Este projeto é um sistema de injeção de dependências que utiliza reflexão para gerenciar a criação de instâncias de forma automática, suportando anotações personalizadas e organização de dependências. Além disso, implementa um sistema de gerenciamento de rotas baseado no padrão Command, permitindo que rotas sejam registradas e executadas dinamicamente.

Explicação das Anotações Criadas

@Injectable

  • Propósito: Indica que a classe é elegível para injeção de dependências.
  • Funcionamento:
    • Detectada automaticamente durante a varredura de pacotes.
    • Registrada no contêiner IoC.
    • Deve possuir um construtor público ou anotado com @Inject.

@Inject

  • Propósito: Marca o construtor que será usado para injetar dependências.
  • Funcionamento:
    • Se presente, o sistema utiliza este construtor para criar instâncias da classe.
    • Caso ausente, o construtor padrão será utilizado.

@Singleton

  • Propósito: Garante que a classe tenha apenas uma instância durante todo o ciclo de vida do sistema.
  • Funcionamento:
    • Classes anotadas com @Singleton têm suas instâncias armazenadas no mapa singletonInstances e reutilizadas em chamadas subsequentes.

@RegisterPersistence

  • Propósito: Configura o tipo de persistência que será utilizado.
  • Funcionamento:
    • Associa um enum PersistenceType à classe que retorna o nome da classe dentro do contexto de persistência.
    • Utilizado pelo sistema para criar implementações de repositórios dinamicamente.
package br.com.ucsal.persistencia;

public enum PersistenceType {
    MEMORIA("MemoriaProdutoRepository"),
    HSQL("HSQLProdutoRepository");

    private final String className;

    PersistenceType(String className) {
        this.className = className;
    }

    public String getClassName() {
        return className;
    }
}

@Rota

  • Propósito: Define o mapeamento de rotas para comandos no padrão Command.
  • Funcionamento:
    • Especifica o valor da rota (caminho) que será associada a um comando.
    • Classes anotadas são registradas no sistema de rotas.

Gerenciamento de Rotas com CommandBus

A classe CommandBus é responsável por escanear, registrar e executar comandos baseados no padrão Command, integrando-se ao sistema de injeção de dependências para criar instâncias dinamicamente.

Funcionamento do CommandBus

  1. Varredura de Rotas:

    • O método scanCommandHandlers utiliza reflexão para identificar todas as classes anotadas com @Rota.
    • As rotas encontradas são registradas no mapa commands, associando o caminho da rota ao comando correspondente.

  2. Criação de Instâncias:

    • O método createCommandInstance utiliza o DependencyInjector para criar instâncias dos comandos.
    • Isso garante que todas as dependências do comando sejam resolvidas automaticamente.

  3. Execução de Comandos:

    • O método run localiza o comando associado à rota solicitada e o executa.
    • Se nenhuma rota correspondente for encontrada, retorna um erro HTTP 404.

Integração com o Sistema de Injeção de Dependências

O CommandBus utiliza o DependencyInjector para gerenciar a criação de instâncias de comandos. Isso permite que cada comando tenha suas dependências injetadas automaticamente.

Benefícios:

  • Flexibilidade: Adicionar ou modificar comandos é simples, bastando anotar as classes com @Rota.
  • Reuso: Comandos podem reutilizar dependências resolvidas pelo DependencyInjector.
  • Escalabilidade: Permite gerenciar um grande número de rotas sem alterar o código principal.

Uso de Reflexão para Carga Dinâmica

No DependencyInjector

  • Identifica classes anotadas com @Injectable ou @RegisterPersistence.
  • Registra essas classes no contêiner IoC e resolve dependências recursivamente.

No CommandBus

  • Detecta classes anotadas com @Rota.
  • Cria instâncias dinâmicas dos comandos, registrando-as com base na rota associada.

Troca de Repositórios com Factory Method

O projeto utiliza o padrão Factory Method para alternar entre diferentes implementações de repositórios com base no tipo de persistência configurado.

Funcionamento

  1. Configuração:

    • A anotação @RegisterPersistence define o tipo de persistência (ex.: banco de dados ou arquivo).
    • O tipo configurado é armazenado na variável persistenceType.

  2. Resolução de Dependências:

    • Durante a criação de instâncias, o sistema identifica repositórios e utiliza o tipo configurado para instanciar a implementação correta.

Vantagens:

  • A troca de implementações é transparente para o restante do sistema.
  • Segue o princípio Open/Closed do SOLID.

Padrão Singleton

O padrão Singleton é implementado para garantir que certas classes tenham apenas uma instância no ciclo de vida do sistema.

Funcionamento

  1. Detecção de Singleton:

    • Durante a criação de instâncias, o sistema verifica se a classe está anotada com @Singleton.

  2. Reuso de Instâncias:

    • Classes anotadas com @Singleton são armazenadas no mapa singletonInstances e reutilizadas.

Vantagens:

  • Redução de consumo de recursos.
  • Consistência no estado de instâncias compartilhadas.

Fluxo Geral do Sistema

  1. Escaneamento e Registro:

    • O DependencyInjector escaneia pacotes, registra classes anotadas, e resolve dependências dinamicamente.
    • O CommandBus escaneia classes anotadas com @Rota e registra as rotas.

  2. Execução de Comandos:

    • Quando uma rota é solicitada, o CommandBus localiza o comando associado e o executa.
    • Dependências do comando são injetadas automaticamente pelo DependencyInjector.

  3. Troca de Repositórios:

    • Repositórios são resolvidos dinamicamente com base no tipo de persistência configurado.

Diagrama de Classe

diagrama-class

Diagrama de Sequência

diagrama-sequencia

Conclusão

Este projeto automatiza a injeção de dependências e o gerenciamento de rotas, integrando padrões como IoC, Factory Method, Singleton e Command. Ele facilita o desenvolvimento, a escalabilidade e a manutenção do código, promovendo boas práticas de programação como:

  • Responsabilidade Única: Cada componente tem uma função clara.
  • Open/Closed: Novos comandos e implementações de repositórios podem ser adicionados sem alterar o sistema existente.
  • Reuso: Instâncias e dependências são gerenciadas de forma eficiente e reutilizadas sempre que possível.