Agenda Telefônica

Esse é um projeto de uma Agenda Telefônica desenvolvido com a arquitetura REST. No front-end foi usado o framework Angular 10. No back-end: Java EE 8 com EJB3, RESTEasy (JAX-RS), Hibernate/JPA e o gerenciador de dependências Maven. O banco de dados é o MySQL 8.

Link do repositório do front-end

URLs:

URL	Método	Descrição
`http://localhost:8080/agenda-telefonica-backend/api/contato`	GET	Retorna todos os contatos salvos no banco de dados
`http://localhost:8080/agenda-telefonica-backend/api/contato`	POST	Salva um contato no banco de dados
`http://localhost:8080/agenda-telefonica-backend/api/contato/{id}`	GET	Retorna o contato com o ID do parâmetro da URL
`http://localhost:8080/agenda-telefonica-backend/api/contato/{id}`	DELETE	Deleta o registro do contato com o ID do parâmetro da URL
`http://localhost:8080/agenda-telefonica-backend/api/contato/{id}`	PUT	Atualiza o registro do contato com o ID numérico do parâmetro da URL

Validações das requisições POST e PUT

Para executar os métodos HTTP da aplicação com alguma ferramenta de testes de API, como o Postman por exemplo, é necessário configurar o cabeçalho (header) da requisição com o atributo chave-valor “Content-Type: application/json”.
No método POST, o corpo da requisição deve ser enviado dessa forma:

{
    "nome":  "github.com/israelferreira",
    "telefone":  "(61) 99999-1234",     
    "email":  "email@valido.com",
    "dataNascimento":  "1954-01-14",
    "informacoesExtras":  null
}

O nome não pode ser nulo e deve ter entre 2 e 200 caracteres.

O telefone pode ser nulo.

O email pode ser nulo. Caso for preenchido, deve ser válido, contendo um “@” na string.

A data de nascimento pode ser nula. Caso for preenchida, deve ser válida, no formato “YYYY-MM-DD”.

As informações extras do contato podem ser nulas. Se forem preenchidas, o tamanho máximo é de 500 caracteres.

O corpo da requisição no método PUT é similar ao POST. A diferença é que o ID do registro a ser editado deve ser passado como parâmetro na URL.

Para executar o projeto:

O projeto foi desenvolvido para funcionar no servidor de aplicações WildFly 19, então algumas configurações extras são necessárias.
Na pasta do WildFly, ir até modules\layers\base\com e criar uma pasta chamada mysql, depois outra com o nome main.
O caminho completo fica assim: …\wildfly-19.1.0.Final\modules\system\layers\base\com\mysql\main.
Baixar o arquivo jar do mysql-connector no repositório do Maven e colar na pasta main.
Ainda na pasta main, criar um arquivo chamado module.xml e colar o seguinte texto dentro:

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.0" name="com.mysql">
    <resources>
      <resource-root path="mysql-connector-java-8.0.21.jar" ></resource-root>
    </resources>
    <dependencies>
      <module name="javax.api"></module>
      <module name="javax.transaction.api"></module>
    </dependencies>
</module>

É necessário adaptar a linha abaixo para a versão do MySQL que foi baixada

<resource-root path="mysql-connector-java-8.0.21.jar" ></resource-root>

Após isso, ir no diretório wildfly-19.1.0.Final\standalone\configuration e abrir o arquivo standalone.xml.
Dentro da tag datasources, adicione o seguinte texto:

<datasource jta="true" jndi-name="java:/jdbc/AgendaTelefonica" pool-name="AgendaTelefonica" enabled="true" use-java-context="true" use-ccm="true">
    <connection-url>jdbc:mysql://localhost:3306/agenda_telefonica?useSSL=false&allowPublicKeyRetrieval=true&useUnicode=true&characterEncoding=UTF-8&useTimezone=true&serverTimezone=America/Sao_Paulo</connection-url>
    <driver>com.mysql</driver>
    <security>
        <user-name>root</user-name>
        <password>root</password>
    </security>
</datasource>

Substitua o nome de usuário e a senha para a versão utilizada no seu banco de dados.

Dentro da tag drivers, adicione o seguinte texto:

<driver name="com.mysql" module="com.mysql">
    <driver-class>com.mysql.cj.jdbc.Driver</driver-class>
    <xa-datasource-class>com.mysql.cj.jdbc.MysqlXADataSource</xa-datasource-class>
</driver>

O script para criar o banco de dados está no arquivo “agenda-telefonica (MySQL8 Database).sql”.

Após esses passos, o backend do projeto deve ser executado no servidor WildFly.