andervilo / quarkus-panache-car

Tutorial: Quarkus - Simplificando o Hibernate utilizando Panache, criando uma aplicação simples utilizando Quarkus Java + REST + CDI + Panache

Tutorial: Quarkus - Simplificando o Hibernate utilizando Panache, criando uma aplicação simples utilizando Quarkus Java + REST + CDI + Panache

Link do artigo

Quarkus IO

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: Quarkus - Simplificando o Hibernate utilizando Panache, criando uma aplicação simples utilizando Quarkus Java + REST + CDI + Panache

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;
• Panache - Simplificando a camada de persistência de dados.

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
• Panache Entity

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-panache-car
├── README.md
├── docs
│   └── postman
│       └── Quarkus-Panache-Car.postman_collection.json
├── pom.xml
├── quarkus-panache-car.iml
└── src
    ├── docs
    ├── main
    │   ├── docker
    │   │   ├── Dockerfile.jvm
    │   │   └── Dockerfile.native
    │   ├── java
    │   │   └── br
    │   │       └── com
    │   │           └── car
    │   │               ├── model
    │   │               │   └── Car.java
    │   │               ├── repository
    │   │               │   └── CarRepository.java
    │   │               └── resource
    │   │                   ├── CarResource.java
    │   │                   └── CarV2Resource.java
    │   └── resources
    │       ├── META-INF
    │       │   └── resources
    │       │       └── index.html
    │       ├── application.properties
    │       └── import.sql
    └── test
        └── java
            └── br
                └── com
                    └── car
                        └── resource
                            ├── CarResourceTest.java
                            └── NativeCarResourceIT.java

22 directories, 15 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.car \
     -DprojectArtifactId=quarkus-panache-car \
     -DclassName="br.com.car.resource.CarResource" \
     -Dpath="/cars"

(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-car -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