API Excel2DB ūüďą

Uma API que tem como objetivo facilitar a carga de dados nos formatos .xlsx ou .xls
para um banco de dados.

Nessa situação, como o foco era apenas aprender a manusear arquivos excel com Kotlin,
a planilha teste presente neste repositório com o nome customers.xlsx possui apenas 4 colunas: id, name, email e salary.

Caso queira testar para outros formatos ou colunas diferente, sugiro dar uma lida na documentação do Apache POI. O raciocínio será o
mesmo que o utilizado aqui.

Tecnologias Utilizadas

Licença

MIT License

Rodando a Aplicação

Para iniciar, primeiro faça um clone do repositório utilizando o comando abaixo:

  git clone https://github.com/franciscofeo/Excel2DB.git

Após isso, vá para a pasta raiz do repositório e agora você pode iniciar a aplicação, lembre-se somente de ter o banco de dados MySQL instalado na sua máquina. Lembre-se de configurar o arquivo application.yml com a sua senha e usuário do MySQL.

Se j√° possuir o gradle instalado, utilize o seguinte comando:

    gradle bootRun

Caso contrário, você pode iniciar a partir da sua IDE de preferência.

Após esses comandos e aguardar alguns segundos, a aplicação estará funcionando na porta 8080, como padrão. Dessa forma, basta ver que foi criado um novo schema chamado db_excelapi e uma tabela customers no seu banco de dados MySQL.

Utilizando a API

Criei algumas rotas para serem utilizados os m√©todos HTTP. Utilize Postman ou Insomnia para a manipula√ß√£o das requisi√ß√Ķes.

– Rota raiz /customers

São permitidos os métodos GET e POST, para a listagem e cadastro de novos clientes, respectivamente.

– Rota /customers/update/{id}

√Č permitido apenas o m√©todo PUT para a atualiza√ß√£o do cliente.

– Rota /customers/delete/{id}

√Č permitido apenas o m√©todo DELETE para a dele√ß√£o do cliente.

– Rota /customers/{filename}

√Č permitido apenas o m√©todo POST para o in√≠cio da carga do arquivo Excel para o Banco de Dados, atente-se ao fato de que √© necess√°rio
escrever o arquivo junto com sua extens√£o, por exemplo: customers.xlsx.

– Rota /customers/upload

√Č permitido apenas o m√©todo POST onde vai ser feito o carregamento do arquivo, utilize um dos programas citados acima para realizar essa
operação.

FAQ

Posso utilizar livremente a API?

Com certeza! O uso é livre, lembre-se de apenas dar os devidos créditos.

Encontrei algum bug, como entro em contato?

Voc√™ pode mandar um email para [email protected] ou entrar em contato aqui mesmo pela plataforma.

GitHub

View Github