SpringBootApp

Autor: Fábio Delgado

Olá! Seja bem vindo ;)

Índice

1. SpringBootApp
2. Projeto e Conteúdo
3. Swagger
4. JWT
5. SQL Server e JDBC
6. SMTP
7. Testes unitários (jUnit e JaCoCo))
8. Publicação
9. Suporte

SpringBootApp

Este repositório contém um exemplo de APIs REST desenvolvida em JAVA utilizando o framework Spring Boot com SQL Server para armazenameto de dados

Pre-requisitos

JDK 1.8 + Maven 3.0 +

Como executar essa aplicação?

• Faça o download do zip ou clone o repositório Git.
• Descompacte o arquivo zip (caso tenha baixado o .zip)
• Abra o diretório Prompt de Comando e Altere (cd) para a pasta que contém pom.xml
• Abra o visual code ou execute o comando via prompt code .
• Pressione F5 para executar a aplicação.

A aplicação deverá estar disponivel em seu navegador no endereço: http://localhost:8080/swagger-ui.html

Extensões recomendadas para desenvolvimento no VSCODE

• Java Extension Pack from Microsoft
• Spring Boot Extension Pack from Pivotal
• Spring Boot Dashboard from Microsoft
• Lombok Annotations Support for VS Code from Gabriel Basilio Brito
• Java Code Generators from Sohibe

Configurando o Java no Visual Studio Code

• Pressione Ctrl+Virgula.
• Procure por "java.home".
  Caso você esteja usando a versão mais recente do vscode:
• Digite no seu java path(Não se esqueça de colocar no caminho em: " ").*
  Caso você esteja em uma versão mais antiga do vscode:
• Clique no lápis ao lado da linha que começa com "java.home".
• Clique em "Copy to settings".
• Digite no seu java path(Não se esqueça de colocar no caminho em: " ").*
• Press Ctrl+S
  Se você não sabe o seu caminho java, digite which java no seu terminal (no Windows, observe o formato correto, e.g: "java.home": "C:/Program Files/Java/jdk-11.0.2")

Projeto e Conteúdo

O Spring Boot é um projeto da Spring que veio para facilitar o processo de configuração e publicação de nossas aplicações. A intenção é ter o seu projeto rodando o mais rápido possível e sem complicação. Ele consegue isso favorecendo a convenção sobre a configuração. Basta que você diga pra ele quais módulos deseja utilizar (WEB, Template, Persistência, Segurança, etc.) que ele vai reconhecer e configurar.

Entedento a estrutura de projeto

Swagger

O Swagger é uma aplicação open source que auxilia os desenvolvedores a definir, criar, documentar e consumir APIs REST; É composto de um arquivo de configuração, que pode ser definido em YAML ou JSON; Fornece ferramentas para: auxiliar na definição do arquivo de configuração (Swagger Editor), interagir com API através das definições do arquivo de configuração (Swagger UI) e gerar templates de código a partir do arquivo de configuração (Swagger Codegen).

fonte: https://swagger.io/resources/webinars/getting-started-with-swagger/

A maneira mais fácil de instalar é usar o Maven:

pom.xml

		<dependency>
		    <groupId>io.springfox</groupId>
		    <artifactId>springfox-swagger2</artifactId>
		    <version>2.9.2</version>
		</dependency>
		<dependency>
		    <groupId>io.springfox</groupId>
		    <artifactId>springfox-swagger-ui</artifactId>
		    <version>2.9.2</version>
		</dependency>

Exemplo de implementação para testes

@EnableSwagger2
@RestController
@RequestMapping(value="/api")
public class MainController {
 
    
    @GetMapping(value="/ola")
    public String getMethodName(){
        return "Olá mundo";
    }

JWT

O JWT (JSON Web Token) nada mais é que um padrão (RFC-7519) de mercado que define como transmitir e armazenar objetos JSON de forma simples, compacta e segura entre diferentes aplicações, muito utilizado para validar serviços em Web Services pois os dados contidos no token gerado pode ser validado a qualquer momento uma vez que ele é assinado digitalmente.

JSON Web Tokens (JWT) é um padrão stateless porque o servidor autorizador não precisa manter nenhum estado; o próprio token é sulficiente para verificar a autorização de um portador de token.

Os JWTs são assinados usando um algoritmo de assinatura digital (por exemplo, RSA) que não pode ser forjado. Por isso, qualquer pessoa que confie no certificado do assinante pode confiar com segurança que o JWT é autêntico. Não há necessidade de um servidor consultar o servidor emissor de token para confirmar sua autenticidade.

fonte: https://jwt.io/introduction/

pom.xml

		<dependency>
			<groupId>io.jsonwebtoken</groupId>
			<artifactId>jjwt</artifactId>
			<version>0.9.1</version>
		</dependency>

Encode

try {
    Algorithm algorithm = Algorithm.HMAC256("secret");
    String token = JWT.create()
        .withIssuer("auth0")
        .sign(algorithm);
} catch (JWTCreationException exception){
    //Invalid Signing configuration / Couldn't convert Claims.
}

Verify a Token

String token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXUyJ9.eyJpc3MiOiJhdXRoMCJ9.AbIJTDMFc7yUa5MhvcP03nJPyCPzZtQcGEp-zWfOkEE";
try {
    Algorithm algorithm = Algorithm.HMAC256("secret");
    JWTVerifier verifier = JWT.require(algorithm)
        .withIssuer("auth0")
        .build(); //Reusable verifier instance
    DecodedJWT jwt = verifier.verify(token);
} catch (JWTVerificationException exception){
    //Invalid signature/claims
}

SQL Server e JDBC

JDBC é semelhante ao ODBC, e no principio usava justamente ODBC para conectar-se com o banco de dados. A partir de um código nativo as aplicações Java podiam utilizar qualquer banco de dados que tivesse um driver ODBC disponível. Isso contribuiu bastante para a popularização do JDBC uma vez que existe um driver ODBC para praticamente qualquer banco de dados de mercado. Nesse repositório sera utilizado o JDBC para comunicação com o banco de dados e execução de comandos através de store procedures.

Stored Procedure, que traduzido significa Procedimento Armazenado, é uma conjunto de comandos em SQL que podem ser executados de uma só vez, como em uma função. Ele armazena tarefas repetitivas e aceita parâmetros de entrada para que a tarefa seja efetuada de acordo com a necessidade individual. Nesse projeto foram desenvolvidos. As Stored Procedures implementadas nesse projeto são:

• sp_Clientes_InsertValue
• sp_Clientes_GetValueById
• sp_Clientes_GetAllValues
• sp_Clientes_DeleteValue

Configurando o ambiente TCP para SQL Server

1. No menu Iniciar, abra o SQL Server 2014 Configuration Manager.
2. Clique em Protocolo para SQLEXPRESS em SQL Server Network Configuration no painel esquerdo. No painel direito, clique com o botão direito do mouse em TCP / IP e selecione Propriedades.
3. Na caixa de diálogo Propriedades de TCP / IP, clique na guia Endereços IP.
4. Role para baixo para localizar o IPALL. Remova qualquer valor, se presente, para portas dinâmicas TCP e especifique 1433 para porta TCP port.

5. Clique OK.
6. Novamente, clique com o botão direito do mouse em TCP / IP no painel direito e selecione Ativar.
7. No Serviços do SQL Server, clique com o botão direito do mouse em SQL Server (SQLEXPRESS) e selecione Reiniciar.

Firewall

• Para validar se a porta do servido esta liberada, execute o comando telnet localhost 1433
• Para validar se o servico esta no ar, execute o comando sc query mssqlserver
• Para validar as conexoes na porta, execute o commando netstat -ano | find "1433"

A maneira mais fácil de instalar é usar o Maven:

pom.xml

		<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
		<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>5.2.6.RELEASE</version>
</dependency>

Exemplo de implementação para testes

application.properties

spring.datasource.initialization-mode=always
spring.datasource.platform=@database.platform@

spring.datasource.url=jdbc:sqlserver://{{servidor}};databaseName={{base_de_dados}};integratedsecurity=true
spring.datasource.username={{usuario}}
spring.datasource.password={{senha}}
spring.datasource.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver

repository.java

@Repository
public class ClienteRepository {

    private static final String SQL_FIND_ALL = "SELECT @@version;";

    private static final BeanPropertyRowMapper<Cliente> ROW_MAPPER = new BeanPropertyRowMapper<>(Cliente.class);

    @Autowired
    NamedParameterJdbcTemplate jdbcTemplate;

    public Iterable<Cliente> findAll() {
        return jdbcTemplate.query(SQL_FIND_ALL, ROW_MAPPER);
    }

Server-Side Paging

Em muitos casos - por exemplo, ao trabalhar com conjuntos de dados muito grandes - não buscamos na base de dados toda a coleção completa e armazenamos na memória. Nesse caso é usar algum tipo de paginação no servidor, onde o servidor envia apenas uma única página de cada vez. Esse é um objeto json de resposta do servidor para casos como esses:

SMTP

O SMTP ou Simple Mail Transfer Protocol, é uma convenção padrão dedicada ao envio de e-mail. A princípio o protocolo SMTP utilizava por padrão a porta 25 ou 465 (conexão criptografada) para conexão, porém a partir de 2013 os provedores de internet e as operadoras do Brasil passaram a bloquear a porta 25, e começaram a usar a porta 587 para diminuir a quantidade de SPAM. O SMTP é um protocolo que faz apenas o envio de e-mails, isso significa que o usuário não tem permissão para baixar as mensagens do servidor, nesse caso é necessário utilizar um Client de e-mail que suporte os protocolos POP3 ou IMAP como o Outlook, Thunderbird e etc. Para negócios ou empresas pequ