... | ... | @@ -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)
|
|
|
- [Configuração do Front-end](#configuração-do-front-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:
|
... | ... | @@ -31,12 +32,12 @@ Esta seção apresentará todas as configurações necessárias dos ambientes do |
|
|
|
|
|
## Configuração do Front-end:
|
|
|
|
|
|
## Pré-requisitos
|
|
|
### Pré-requisitos
|
|
|
|
|
|
1. **Node.js**
|
|
|
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/).
|
|
|
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 |
|
|
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. Clone o repositório usando o comando git clone
|
... | ... | @@ -56,7 +57,7 @@ npm -v |
|
|
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:
|
|
|
|
... | ... | @@ -65,7 +66,7 @@ npm install |
|
|
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:
|
|
|
|
... | ... | @@ -74,7 +75,7 @@ Após configurar e instalar as dependências, você pode iniciar a aplicação: |
|
|
|
|
|
## 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:
|
|
|
|
... | ... | @@ -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. **Apache Maven**
|
|
|
|
|
|
## Passo 1: Instalar o JDK
|
|
|
### Passo 1: 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/).
|
... | ... | @@ -99,7 +100,7 @@ Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua |
|
|
1. **Verificar a instalação:**
|
|
|
* 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:**
|
|
|
* 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 |
|
|
1. **Verificar a instalação:**
|
|
|
* 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:**
|
|
|
* 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).
|
... | ... | @@ -137,3 +138,94 @@ Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua |
|
|
1. Abra o terminal integrado (`Ctrl+` \`).
|
|
|
1. Navegue até o diretório do projeto se necessário.
|
|
|
1. Execute o comando `./mvnw spring-boot:run`.
|
|
|
|
|
|
## 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 |