Skip to content

GitLab

  • Menu
Projects Groups Snippets
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
  • Wiki Wiki
  • Project information
    • Project information
    • Activity
    • Labels
    • Planning hierarchy
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 0
    • Issues 0
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 0
    • Merge requests 0
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Monitor
    • Monitor
    • Incidents
  • Packages & Registries
    • Packages & Registries
    • Package Registry
    • Infrastructure Registry
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • MeditAmamente
  • WikiWiki
  • Wiki
  • Configuração

Configuração · Changes

Page history
Update Configuração authored Sep 12, 2024 by Nicolas Kics Marques's avatar Nicolas Kics Marques
Hide whitespace changes
Inline Side-by-side
Configuração.md
View page @ 4985854b
...@@ -9,6 +9,7 @@ Esta seção apresentará todas as configurações necessárias dos ambientes do ...@@ -9,6 +9,7 @@ Esta seção apresentará todas as configurações necessárias dos ambientes do
- [Instalação de uma IDE](#instalação-de-uma-ide) - [Instalação de uma IDE](#instalação-de-uma-ide)
- [Configuração do Front-end](#configuração-do-front-end) - [Configuração do Front-end](#configuração-do-front-end)
- [Configuração do Back-end](#configuração-do-back-end) - [Configuração do Back-end](#configuração-do-back-end)
- [Configuração do Banco de Dados com Spring](#configuração-do-banco-de-dados-com-spring)
## Instalação de uma IDE: ## Instalação de uma IDE:
...@@ -31,12 +32,12 @@ Esta seção apresentará todas as configurações necessárias dos ambientes do ...@@ -31,12 +32,12 @@ Esta seção apresentará todas as configurações necessárias dos ambientes do
## Configuração do Front-end: ## Configuração do Front-end:
## Pré-requisitos ### Pré-requisitos
1. **Node.js** 1. **Node.js**
2. **npm** 2. **npm**
## Passo 1: Instalando Node.js e npm ### Passo 1: Instalando Node.js e npm
1. Acesse o site oficial do Node.js: [Node.js Downloads](https://nodejs.org/). 1. Acesse o site oficial do Node.js: [Node.js Downloads](https://nodejs.org/).
2. Siga as instruções do instalador. Durante a instalação, você pode selecionar as opções padrão. 2. Siga as instruções do instalador. Durante a instalação, você pode selecionar as opções padrão.
...@@ -47,7 +48,7 @@ node -v ...@@ -47,7 +48,7 @@ node -v
npm -v npm -v
``` ```
## Passo 2: Clonando o Repositório ### Passo 2: Clonando o Repositório
1. Navegue até o diretório onde você deseja clonar o projeto 1. Navegue até o diretório onde você deseja clonar o projeto
1. Clone o repositório usando o comando git clone 1. Clone o repositório usando o comando git clone
...@@ -56,7 +57,7 @@ npm -v ...@@ -56,7 +57,7 @@ npm -v
git clone https://link_copiado_do_gitLab git clone https://link_copiado_do_gitLab
``` ```
## Passo 3: Iniciando ### Passo 3: Iniciando
Para começar, siga os passos abaixo para instalar as dependências e iniciar o servidor de desenvolvimento: Para começar, siga os passos abaixo para instalar as dependências e iniciar o servidor de desenvolvimento:
...@@ -65,7 +66,7 @@ npm install ...@@ -65,7 +66,7 @@ npm install
npm run dev npm run dev
``` ```
## Passo 4: Executando a Aplicação ### Passo 4: Executando a Aplicação
Após configurar e instalar as dependências, você pode iniciar a aplicação: Após configurar e instalar as dependências, você pode iniciar a aplicação:
...@@ -74,7 +75,7 @@ Após configurar e instalar as dependências, você pode iniciar a aplicação: ...@@ -74,7 +75,7 @@ Após configurar e instalar as dependências, você pode iniciar a aplicação:
## Configuração do Back-end: ## Configuração do Back-end:
## Pré-requisitos ### Pré-requisitos
Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua máquina: Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua máquina:
...@@ -82,7 +83,7 @@ Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua ...@@ -82,7 +83,7 @@ Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua
1. **IDE (IntelliJ IDEA ou Visual Studio Code)** 1. **IDE (IntelliJ IDEA ou Visual Studio Code)**
1. **Apache Maven** 1. **Apache Maven**
## Passo 1: Instalar o JDK ### Passo 1: Instalar o JDK
1. **Baixar e instalar o JDK:** 1. **Baixar e instalar o JDK:**
* Acesse a [página de downloads do JDK](https://www.oracle.com/java/technologies/javase-jdk-downloads.html) ou o [OpenJDK](https://openjdk.org/install/). * Acesse a [página de downloads do JDK](https://www.oracle.com/java/technologies/javase-jdk-downloads.html) ou o [OpenJDK](https://openjdk.org/install/).
...@@ -99,7 +100,7 @@ Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua ...@@ -99,7 +100,7 @@ Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua
1. **Verificar a instalação:** 1. **Verificar a instalação:**
* Abra um terminal e execute `java -version` e `javac -version` para garantir que o JDK está instalado corretamente. * Abra um terminal e execute `java -version` e `javac -version` para garantir que o JDK está instalado corretamente.
## Passo 2: Instalar o Apache Maven ### Passo 2: Instalar o Apache Maven
1. **Baixar e instalar o Maven:** 1. **Baixar e instalar o Maven:**
* Acesse a [página de downloads do Apache Maven](https://maven.apache.org/download.cgi). * Acesse a [página de downloads do Apache Maven](https://maven.apache.org/download.cgi).
...@@ -124,7 +125,7 @@ Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua ...@@ -124,7 +125,7 @@ Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua
1. **Verificar a instalação:** 1. **Verificar a instalação:**
* Abra um terminal e execute `mvn -v` para garantir que o Maven está instalado corretamente. * Abra um terminal e execute `mvn -v` para garantir que o Maven está instalado corretamente.
## Passo 3: Executar o Projeto ### Passo 3: Executar o Projeto
1. **Importar o Projeto:** 1. **Importar o Projeto:**
* No IntelliJ IDEA, o projeto deve ser carregado automaticamente. Se necessário, sincronize o projeto com o Maven ou Gradle (ícones geralmente localizados na parte superior direita da janela do IntelliJ). * No IntelliJ IDEA, o projeto deve ser carregado automaticamente. Se necessário, sincronize o projeto com o Maven ou Gradle (ícones geralmente localizados na parte superior direita da janela do IntelliJ).
...@@ -136,4 +137,95 @@ Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua ...@@ -136,4 +137,95 @@ Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua
* **No VSCode:** * **No VSCode:**
1. Abra o terminal integrado (`Ctrl+` \`). 1. Abra o terminal integrado (`Ctrl+` \`).
1. Navegue até o diretório do projeto se necessário. 1. Navegue até o diretório do projeto se necessário.
1. Execute o comando `./mvnw spring-boot:run`. 1. Execute o comando `./mvnw spring-boot:run`.
\ No newline at end of file
## Configuração do Banco de Dados com Spring:
**Adicionando dependências:** Dependências, quando combinadas, asseguram que a aplicação possa interagir com o banco de dados MySQL de maneira eficiente e robusta. A dependência `spring-boot-starter-data-jpa` fornece uma camada de abstração que simplifica a manipulação de dados, permitindo o uso de JPA e Hibernate para mapear objetos Java para tabelas do banco de dados e gerenciar operações de persistência de maneira automatizada. Isso não só reduz o esforço necessário para escrever código de acesso a dados, como também melhora a manutenção e a escalabilidade da aplicação. Por sua vez, a dependência `mysql-connector-java` estabelece a conexão necessária entre a aplicação e o banco de dados MySQL, garantindo que as operações de leitura e escrita sejam realizadas de forma confiável e eficiente. Juntas, essas dependências permitem que a aplicação aproveite a automação, a flexibilidade e o desempenho do Spring Data JPA para gerenciar dados de forma eficaz.
```shell
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
<version>3.3.3</version>
</dependency>
```
```shell
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<scope>runtime</scope>
</dependency>
```
**Definindo a configuração do banco de dados:** O arquivo `application.properties` define a configuração do banco de dados no projeto Java Spring. Ele especifica a URL de conexão com o MySQL (`spring.datasource.url`), o nome de usuário (`spring.datasource.username`) e a senha (`spring.datasource.password`). A propriedade `spring.jpa.hibernate.ddl-auto` controla como o Hibernate gerencia o esquema do banco de dados, sendo configurado para atualizar o esquema automaticamente. Além disso, `spring.jpa.show-sql=true` faz com que as consultas SQL executadas sejam exibidas no console, ajudando na depuração.
```shell
spring.datasource.url=jdbc:mysql://localhost:3306/meditamente?createDatabaseIfNotExist=true
spring.datasource.username=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQLDialect
security.jwt.secret-key=3cfa76ef14937c1c0ea519f8fc057a80fc0d4a7420f8e8bcd0a7567c272e007b
security.jwt.expiration-time=3600000
security.jwt.refresh-token-expiration-time=432000000
```
**Criando Entidades:** A criação de entidades é realizada através da definição de classes Java que representam tabelas no banco de dados. Cada classe é anotada com a anotação `@Entity`, que indica ao Hibernate (ou outro provedor JPA) que a classe deve ser mapeada para uma tabela no banco de dados. As propriedades da classe correspondem às colunas da tabela, e são anotadas com `@Column` para especificar detalhes adicionais, como o nome da coluna e se ela pode ser nula. A chave primária é definida com a anotação `@Id`, e geralmente é gerada automaticamente usando a estratégia `@GeneratedValue`. Essas entidades são então usadas para criar, ler, atualizar e excluir registros no banco de dados de forma orientada a objetos, facilitando a manipulação dos dados e a manutenção do código.
**Definindo a Interfaces de Repositório**
A classe Interfaces de Repositório em um projeto Java Spring com JPA atua como um intermediário entre a aplicação e o banco de dados, facilitando o acesso e a manipulação dos dados. Essas interfaces são definidas como extensões da interface `JpaRepository` ou `CrudRepository`, fornecidas pelo Spring Data JPA. Ao estender `JpaRepository`, a interface ganha métodos pré-definidos para operações básicas de CRUD (Create, Read, Update, Delete), como `save()`, `findById()`, `findAll()`, e `deleteById()`. Isso elimina a necessidade de implementar manualmente as operações de acesso a dados e permite que a aplicação se concentre na lógica de negócio.
### Parâmetro JDBC URL
O parâmetro `jdbc.url` é uma configuração crucial para estabelecer a conexão entre uma aplicação e um banco de dados relacional. Ele especifica o endereço do banco de dados que a aplicação deve acessar, incluindo detalhes como o protocolo, o endereço do servidor, a porta e o nome do banco de dados. O formato básico do `jdbc.url` é:
```shell
jdbc:[database_type]://[host]:[port]/[database_name]
```
Em nosso projeto, o JDBC URL é:
```shell
jdbc:mysql://localhost:3306/meditamente?createDatabaseIfNotExist=true
```
A seguir temos as definições de cada parte que compõe a URL:
- **Protocolo (`jdbc:`)**:
- Indica que o Java Database Connectivity (JDBC) está sendo usado para a conexão.
- **Tipo de Banco de Dados (`[database_type]`)**:
- Define o tipo de banco de dados. Por exemplo, para MySQL é `mysql`, para PostgreSQL é `postgresql`, etc.
- **Endereço do Servidor (`[host]`)**:
- O endereço IP ou o nome do host onde o servidor de banco de dados está localizado. Para um banco de dados local, pode ser `localhost`.
- **Porta (`[port]`)**:
- O número da porta na qual o banco de dados está ouvindo as conexões. A porta padrão para MySQL, por exemplo, é `3306`.
- **Nome do Banco de Dados (`[database_name]`)**:
- O nome específico do banco de dados ao qual você deseja se conectar.
### Como logar no banco de dados usando **MySQL Workbench**
1. **Abrir MySQL Workbench**: Inicie o MySQL Workbench no seu computador.
2. **Criar uma Nova Conexão**:
- Clique em `+` ao lado de "MySQL Connections" para criar uma nova conexão.
- Na tela de configuração, preencha as informações:
- **Connection Name**: Nome da conexão (pode ser qualquer nome).
- **Hostname**: O endereço do servidor MySQL, geralmente `localhost` para uma instalação local.
- **Port**: A porta do MySQL, que geralmente é `3306`.
- **Username**: O nome de usuário do MySQL (por exemplo, `root`).
- **Password**: A senha para o usuário fornecido.
- Clique em `Test Connection` para verificar se as configurações estão corretas.
- Clique em `OK` para salvar a conexão.
3. **Conectar-se ao Banco de Dados**:
- Clique duas vezes na nova conexão que você criou para se conectar ao banco de dados.
### Considerações Adicionais
**Senhas e Dados Sensíveis:** Use variáveis de ambiente para armazenar senhas e dados sensíveis.
\ No newline at end of file
Clone repository
  • Arquitetura
  • Configuração
  • Database
  • Escopo
  • Gerência
  • Infraestrutura
  • Mockups
  • Processo
  • Testes
  • Home