startap / atlas

💻 Um framework Delphi para aplicações desktop

Atlas Framework

PT-BR

💡 Nasce mais um repositório para a comunidade. Uma framework de funções comuns para Delphi.

❔ Porquê?

Começamos o projeto como playground, para testar novas implementações, ideias, tecnologias e tentar trazer um pouco da modernidade ao ambiente "legado" do Delphi. O Atlas Framework é um projeto OpenSource, e que planejamos utilizar nas mais variadas soluções que forem criadas.

⚙ Adicionais

Este pacote utiliza o gerenciador de dependências da @HashLoad - o 📦 Boss - para oferecer uma fácil integração com outros sistemas (essa é a primeira tecnologia que utilizamos de forma experimental no projeto).

Também estamos utilizando 🔄 DUnitX para testes unitários automatizados das funções

Junto com o DUnitX tem a implementação de um 📃 CodeCoverage básico em HTML e planos de integração com outros formatos e relatórios

atlas's Issues

Escrever README em português

O repositório é brasileiro. Está sendo construído do zero no Português - a idéia é popularizar o OpenSource brasileiro e, depois, expandir caso necessário, executando a refatoração do código em partes. No primeiro momento vamos construir um README em Português.

Precisamos incluir a primeira contribuição obtida no componente: Boss Delphi Dependency Manager. Nosso sistema de gerenciamento de pacotes adotado para uso no Delphi.

O projeto, no entanto, também está disponível via código fonte para ser adicionado a um projeto em forma de BPL (Borland Package Library).

O desenvolvimento está sendo iniciado em Delphi XE 10.3

Componente de execução de Stored Procedures

Proposta

As execuções de Stored Procedure no SQL Server seguem a sintaxe de retorno, ou com parâmetros, na seguinte forma exec sp_GenericStoredProcedure :Param1, :Param2, :Param3, :Param4 ;

Portanto, precisamos de uma function para executar os scripts no banco - e talvez instanciar e destruir o objeto dentro da própria execução. Uma proposta de implementação seria:

function RunStoredProcedure(NomeProcedure: String, Parameters: Array of Variant, GetOutput: Boolean): return Variant

Neste caso, se GetOutput for true, a função deve obter a saída da procedure e retornar. Caso contrário, como o resultado é Variant, podemos simplesmente retornar True ou False de acordo com o resultado da execução da procedure.

---

Considerações

Podemos criar um objeto SQL Server dentro da conexão para lidar com as tarefas específicas de SQL Server, e manter as operações CRUD genéricas em um componente global, que implementa as interfaces de construção do SQLBuilder.

Abstração de layer de database

Métodos públicos propostos:

• CriaConexao returns TSQLDataset
• RetornaConexao returns TSQLDataset
• FinalizaConexao returns TSQLDataset

Estes métodos são responsáveis por gerenciar a conexão. O layer de database deve conter apenas o suficiente para prover um componente pronto de conexão ao sistema.

Sempre que o programador solicitar um acesso ao banco será retornado um único TSQLDataset pelo método RetornaConexao. O programador deve ser encarregar de criar os ClientDataSets para manipulação de dados em cada uma das janelas que faz tratamento de dados, a nível de execução dentro do objeto do Formulário.