mariohood/quarkus-food

Tutorial: Criando um CRUD utilizando Quarkus Java + REST + CDI + Panache, Hibernate com Postgres (Docker) + Postman

Tutorial: Criando um CRUD utilizando Quarkus Java + REST + CDI + Panache, Hibernate com Postgres (Docker) + Postman

Quarkus IO

Link para os Artigos

• Linkedin Pulse : https://www.linkedin.com/pulse/tutorial-criando-um-crud-utilizando-quarkus-java-rest-da-silva-melo/

• Medium : https://medium.com/@marcus.paulo/tutorial-criando-um-crud-utilizando-quarkus-java-rest-cdi-panache-hibernate-com-postgres-59793e0d7162

Tabela de Conteúdo

• Tabela de Conteúdo
• Sobre o Projeto
  • Feito Com
• Começando
  • Pré-requisitos
  • Estrutura de Arquivos
  • Instalação
  • Edição
  • Publicação
• Contribuição
• Licença
• Contato

Sobre o Projeto

Tutorial: Criando um CRUD utilizando Quarkus Java + REST + CDI + Panache, Hibernate com Postgres (Docker) + Postman

Feito Com

Tecnologias utilizadas no projeto

• JAVA - Java é uma linguagem de programação e plataforma computacional lançada pela primeira vez pela Sun Microsystems em 1995. Existem muitas aplicações e sites que não funcionarão, a menos que você tenha o Java instalado, e mais desses são criados todos os dias;
• Quarkus - A Red Hat lançou o Quarkus, um framework Java nativo do Kubernetes feito sob medida para o GraalVM e OpenJDK HotSpot. O Quarkus visa tornar o java uma plataforma líder em ambientes serverless e Kubernetes, oferecendo aos desenvolvedores um modelo unificado de programação reativa e imperativa;

Começando

Para reproduzir o exemplo, é necessário seguir os requisitos mínimos.

Pré-requisitos

• Você vai precisar de uma IDE como por exemplo: IntelliJ IDEA, Eclipse, VSCode.
• Instale a JDK 8 or 11+
• Instale o Apache Maven 3.5.3+ ou o Gradle
• (Opcional) - Você pode baixar o GraalVM 19.2.1 para compilar nativamente sua aplicação.
• Panache Entity (Possível artigo futuro)

Docker

• Escolha um cliente para conectar com o Banco de dados, exemplo: DBeaver, PGAdmin, Postico (Mac)
• Cliente para realizar requisições REST: Postman ou o Insomnia.
• Instruções Adicionais:
• Instalação do Docker (Documentação oficial)
• Instalando Docker no windows: (Youtube, ESR)
• Instalando o Docker no Linux: (Youtube: LinuxTips)
• Instalando o Docker no Mac: (Youtube: Wellington Rogati)

Estrutura de Arquivos

A estrutura de arquivos está da seguinte maneira:

quarkus-food
├── README.md
├── pom.xml
├── quarkus-food.iml
└── src
    ├── main
    │   ├── docker
    │   │   ├── Dockerfile.jvm
    │   │   └── Dockerfile.native
    │   ├── java
    │   │   └── br
    │   │       └── com
    │   │           └── food
    │   │               ├── controller
    │   │               │   └── FoodController.java
    │   │               ├── entity
    │   │               │   └── Food.java
    │   │               └── resource
    │   │                   └── FoodResource.java
    │   └── resources
    │       ├── META-INF
    │       │   └── resources
    │       │       └── index.html
    │       └── application.properties
    └── test
        └── java
            └── br
                └── com
                    └── food
                        └── resource
                            ├── FoodResourceTest.java
                            └── NativeFoodResourceIT.java

19 directories, 12 files

Criação da aplicação

1. Para criar o projeto, basta utlizar o template do Maven + Quarkus, conforme o comando abaixo:

mvn io.quarkus:quarkus-maven-plugin:1.0.1.Final:create \
     -DprojectGroupId=br.com.food \
     -DprojectArtifactId=quarkus-food \
     -DclassName="br.com.food.resource.FoodResource" \
     -Dpath="/food"

(Alternativo) - O Quarkus disponibiliza um site chamado Quarkus.code.io, onde é posísvel configurar o projeto de uma forma mais visual, vale a pena conferir, segue o link: https://code.quarkus.io/

---

Executando a Instância do Postgresql no Docker

Para iniciar o Postgresql, basta rodar o comando abaixo (O Docker precisa estar instalado):

docker run --name postgres-food -e "POSTGRES_PASSWORD=postgres" -p 5433:5432 -v ~/developer/PostgreSQL:/var/lib/postgresql/data -d postgres

Executando o projeto em Quarkus

Para executar um projeto em Quarkus, basta executar o comando:

mvn compile quarkus:dev

Contribuição

Fique a vontade para contribuir com o projeto.

1. Faça um Fork do projeto
2. Crie uma Branch para sua Feature (git checkout -b feature/newFeature)
3. Adicione suas mudanças (git add .)
4. Comite suas mudanças (git commit -m 'Nova funcionalidade para facilitar ...)
5. Faça o Push da Branch (git push origin feature/newFeature)
6. Abra um Pull Request

Licença

Distribuído sob a licença MIT. Veja LICENSE para mais informações.

Contato

Marcus Paulo - Github