Aplica��o Web com Spring Boot e Spring MVC

O Spring Boot � uma ferramenta para o desenvolvimento de aplicaç�es que utilizam o framework Spring sem que seja necess�ria praticamente nenhuma configuraç�o.

O Spring Boot � capaz de identificar quais as principais caracter�sticas da aplicaç�o que est� sendo desenvolvida e fazer automaticamente as configuraç�es necess�rias como, por exemplo, o arquivo applicationContext.xml, o web.xml e os data sources. Com isso os programadores ganham muito em produtividade, focando apenas no desenvolvimento da aplicaç�o e n�o na configuraç�o das ferramentas e frameworks utilizados, que s�o repetidos em praticamente todos os projetos.

Curso Completo: Curso de Spring Boot

O Spring sempre foi conhecido por ser um framework robusto e completo, mas que necessita de diversas configuraç�es. Por�m, vers�o a vers�o a ferramenta vem melhorando essa caracter�stica. Inicialmente, toda a configuraç�o do Spring era feita com arquivos XML, mas na vers�o 2.5 foram introduzidas as anotaç�es para que a mesma fosse feita diretamente no c�digo, eliminando boa parte dos arquivos XML, facilitando bastante a configuraç�o das aplicaç�es. Agora com o Spring Boot, a ideia � que praticamente nenhuma configuraç�o seja necess�ria, nem mesmo com anotaç�es no c�digo.

Ele tem quatro componentes principais para realizar as funç�es descritas anteriormente:

Configuraç�o Autom�tica: O Spring Boot identifica automaticamente as configuraç�es necess�rias pelo tipo de aplicaç�o, por exemplo, se � uma aplicaç�o Web, com JPA ou uma API Rest;
Depend�ncias Autom�ticas: O Spring Boot adiciona, pelo tipo de projeto, um conjunto de bibliotecas que j� foram testadas juntas, diminuindo problemas de compatibilidade;
Interface de Linha de Comando: disponibiliza uma interface de linha de comando onde o programador pode, de maneira f�cil, criar, executar e modificar uma aplicaç�o;
Actuator: � uma ferramenta que permite ao programador verificar o que est� acontecendo internamente em uma aplicaç�o com o Spring Boot.

Nesse artigo ser� mostrado como configurar a aplicaç�o utilizando as configuraç�es e as depend�ncias autom�ticas do Spring Boot para criar uma aplicaç�o web de maneira r�pida e f�cil e com praticamente nenhuma configuraç�o necess�ria. Tecnicamente, vamos construir uma aplicaç�o com o framework Spring MVC, o Spring Data JPA para fazer a persist�ncia dos dados, o banco de dados H2 que j� vem na instalaç�o padr�o do Spring Boot e o Thymeleaf para definir as vis�es. Este �ltimo � um template engine que substituiu o JSP.

Curso Completo: Curso de Persist�ncia com Spring-Data JPA

Desenvolvimento da Aplicaç�o

Ser� desenvolvida uma aplicaç�o bem simples, apenas para demonstrar a funcionalidade do Spring Boot e, por isso, ela ter� uma lista de livros que ser� organizada pelo nome do autor. Existir� uma p�gina para cada um destes onde ser� exibida a sua respectiva lista de livros e um formul�rio que permitir� o cadastro de novos livros para esse autor. A aplicaç�o desse artigo foi desenvolvida utilizando a IDE Eclipse, por�m qualquer IDE pode ser utilizada.

Para a configuraç�o da aplicaç�o foi utilizado o Apache Maven (o Spring Boot suporta tamb�m o Gradle), para isso foram adicionadas quatro depend�ncias do mesmo:

o spring-boot-starter-web, que adiciona as depend�ncias do Spring MVC;
o spring-boot-starter-data-jpa, que adiciona as depend�ncias do Spring Data;
o spring-boot-starter-thymeleaf, que adiciona as depend�ncias do thymeleaf para o desenvolvimento da vis�o, e;
o com.h2database, que � o banco de dados que ser� utilizado nessa aplicaç�o.

A Listagem 1 mostra o c�digo do arquivo pom.xml com as depend�ncias adicionadas.


<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
      http://maven.apache.org/xsd/maven-4.0.0.xsd">
      <modelVersion>4.0.0</modelVersion>
      <groupId>com.devmedia.mvc</groupId>
      <artifactId>agenda</artifactId>
      <version>0.0.1-SNAPSHOT</version>
 
      <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.2.1.RELEASE</version>
      </parent>
 
      <dependencies>
            <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>
            </dependency>
            <dependency>
                  <groupId>org.springframework.boot</groupId>
                  <artifactId>spring-boot-starter-thymeleaf</artifactId>
            </dependency>
            <dependency>
                  <groupId>com.h2database</groupId>
                  <artifactId>h2</artifactId>
            </dependency>
            <dependency>
                  <groupId>org.springframework.boot</groupId>
                  <artifactId>spring-boot-starter-test</artifactId>
                  <scope>test</scope>
            </dependency>
      </dependencies>
 
      <build>
            <plugins>
                  <plugin>
                        <groupId>org.springframework.boot</groupId>
                        <artifactId>spring-boot-maven-plugin</artifactId>
                  </plugin>
            </plugins>
      </build>
 
</project>

Listagem 1. Pom.xml para a configuraç�o da aplicaç�o com o Maven

A tag no arquivo indica qual a vers�o do Spring Boot ser� utilizada no projeto, e assim, todas as bibliotecas do Spring Boot tamb�m utilizam essa vers�o. Verifiquem que na tag das tr�s bibliotecas do Spring Boot (spring-boot-starter-web, spring-boot-starter-data-jpa, spring-boot-starter-thymeleaf) n�o s�o adicionadas as vers�es porque todas elas utilizam a vers�o que foi definida na tag .

Com a aplicaç�o configurada, o primeiro passo no desenvolvimento foi a implementaç�o da classe que representa os objetos que ser�o persistidos no banco de dados, que � a classe Livro. Essa classe tem diversas anotaç�es do JPA, como a @Entity para indicar que a classe � uma entidade do banco de dados, a @Id para indicar que o campo id � o identificador da entidade, a @GeneratedValue que indica que o valor ser� gerado banco de dados e a @Column para definir alguns par�metros das colunas como o nome, se ela pode receber valores nulos ou se o valor da coluna � �nico. A Listagem 2 mostra o c�digo da classe Livro com suas anotaç�es.


package com.devmedia.mvc.entity;
 
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
 
@Entity
public class Livro {
 
      @Id 
      @GeneratedValue(strategy=GenerationType.AUTO) 
      private Long id; 
      
      @Column(name="titulo", nullable=false)
       private String titulo; 
 
      @Column(name="isbn", nullable=false, unique=true)
      private String isbn; 
      
      @Column(name="autor", nullable=false)
      private String autor;
      
      @Column(name="description", nullable=true)
      private String description;
      
      public Long getId() {
            return id;
      }
      public void setId(Long id) {
            this.id = id;
      }
      public String getTitulo() {
            return titulo;
      }
      public void setTitulo(String titulo) {
            this.titulo = titulo;
      }
      public String getIsbn() {
            return isbn;
      }
      public void setIsbn(String isbn) {
            this.isbn = isbn;
      }
      public String getAutor() {
            return autor;
      }
      public void setAutor(String autor) {
            this.autor = autor;
      }
      public String getDescription() {
            return description;
      }
      public void setDescription(String description) {
            this.description = description;
      }
 
}

Listagem 2. Classe Livro com anotaç�es JPA

Utilizando o H2, o banco de dados ser� sempre criado quando a aplicaç�o for executada, o que facilita o desenvolvimento, pois n�o � necess�ria nenhuma configuraç�o inicial para usar a aplicaç�o. Por simplicidade, nesse artigo usaremos o H2 mesmo, por�m o Spring Boot funciona com qualquer banco de dados que tenha um Driver JDBC.

Utilizando o Spring Data JPA � poss�vel criar um reposit�rio para a classe Livro: este � uma interface que cont�m diversos m�todos pr�-implementados para a manipulaç�o de dados de uma entidade como m�todos para salvar, deletar, listar e recuperar pelo o ID da classe. Para criar essa interface basta estender a interface JpaRepository; os tipos passados s�o a classe da entidade usada (no caso a classe Livro) e o tipo do atributo que � o identificador dessa classe (que neste caso � um Long).

Al�m disso, o programador pode criar diversos m�todos espec�ficos de busca, para isso basta seguir o padr�o de nomeaç�o dos m�todos como, por exemplo, findByNomeAtributo. A Listagem 3 mostra o c�digo dessa interface.


package com.devmedia.mvc.repository;
 
import java.util.List;
import org.springframework.data.jpa.repository.JpaRepository;
 
import com.devmedia.mvc.entity.Livro;
 
public interface LivroRepository extends 
JpaRepository<Livro, Long> {
 
      /**
       * Encontra todos os livros de um mesmo autor.
       * 
       * @param autor
       * @return lista de livros
       */
      List<Livro> findByAutor(String autor);
      
      /**
  * Encontra um livro a partir do seu t�tulo. 
 * Retorna uma lista pois podem existir
       * mais de um livro com mesmo t�tulo.
       * 
       * @param titulo
       * @return lista de livros
       */
      List<Livro> findByTitulo(String titulo);
      
      /**
* Encontra um livro a partir de seu isbn, como o isbn � �nico, 
apenas um livro pode ser encontrado. 
       * 
       * @param isbn
       * @return livro
       */
      Livro findByIsbn(String isbn);
 
}

Listagem 3. Classe reposit�rio da entidade Livro

Verifiquem que foram adicionados tr�s m�todos novos para busca:

um para buscar os livros pelo autor;
um para encontrar os livros pelo t�tulo e;
um para encontrar o livro pelo seu ISBN.

A classe Controller � bastante simples, primeiro � adicionada a anotaç�o @Controller para indicar que a classe � um controlador, e a anotaç�o @RequestMapping, que indica o caminho para acessar esse controlador. � adicionado um atributo do tipo LivroRepository, que � o reposit�rio criado na Listagem 3, onde o pr�prio Spring far� a injeç�o dessa depend�ncia. Al�m disso, existem dois m�todos: um para listar os livros de um determinado autor e que ser� acessado quando a requisiç�o para esse controlador for do tipo GET, e o m�todo para adicionar um livro, que ser� acessado quando a requisiç�o for do tipo POST. A Listagem 4 mostra o c�digo dessa classe.


package com.devmedia.mvc.controller;
 
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
 
import com.devmedia.mvc.entity.Livro;
import com.devmedia.mvc.repository.LivroRepository;
 
import java.util.List;
 
@Controller
@RequestMapping("/")
public class LivroController {
      
      private LivroRepository livroRepository;
 
      @Autowired
      public LivroController( LivroRepository livroRepository) {
            this.livroRepository = livroRepository;
      }
 
      @RequestMapping(value = "/", method = RequestMethod.GET)
      public String listaLivros(@PathVariable("autor") String autor, Model model) {
            List<Livro> listaLivros = livroRepository.findByAutor(autor);
            if (listaLivros != null) {
                  model.addAttribute("livros", listaLivros);
            }
            return "listaLivros";
      }
 
      @RequestMapping(value = "/", method = RequestMethod.POST)
      public String adicionaLivroAutor(@PathVariable("autor") String autor, Livro livro) {
            livro.setAutor(autor);
            livroRepository.save(livro);
            return "redirect:/";
      }
}

Listagem 4. Controller da classe Livro

O m�todo listaLivros � bastante simples, pois ele ser� acessado quando a requisiç�o para esse controlador for do tipo GET e receber� como par�metro o nome de um autor, por onde � feita uma busca no banco de dados para encontrar todos os livros desse autor. Caso sejam encontrados livros, essa lista � adicionada no model para que seja mostrada depois na tela da aplicaç�o, o que ser� mostrado na pr�xima listagem.

O m�todo adicionaLivroAutor � parecido com o anterior, pois ele ser� acessado quando a requisiç�o para o controlador for do tipo POST e recebe tamb�m como par�metro o nome de um autor. A diferença � que, al�m disso, ele tamb�m deve receber os dados de um livro, o que ser� feito por um formul�rio, que tamb�m ser� mostrado na pr�xima listagem. O livro enviado pela requisiç�o ser� cadastrado no banco de dados utilizando a interface reposit�rio. Por fim, esse m�todo redireciona para o m�todo listaLivros, e o livro que acabou de ser cadastrado j� ser� exibido na tela.

Com todas as classes para acesso e inserç�o dos dados, basta criar a vis�o e para isso foi criado o arquivo listaLivros.html na pasta src/main/resources/templates. Essa tela tem duas partes, sendo a primeira uma lista dos livros do autor que foi recuperado a partir da URL de acesso, que deve ser feita no formato http://localhost:8080/nomeAutor. Se n�o existir nenhum livro cadastrado para o autor ser� mostrado o texto �Nenhum Livro Cadastrado para esse autor�, caso contr�rio ser� mostrada a lista de livro. A segunda parte da tela � um formul�rio de cadastro de livros com os dados Titulo, ISBN e descriç�o, e o autor � cadastrado com o nome do autor da p�gina acessada. A Listagem 5 mostra o c�digo dessa tela.


<html>
<head>
<title>Reading List</title>
</head>
<body>
  <h2>Lista de Livros por Autor</h2>
  <div th:unless="${#lists.isEmpty(livros)}">
    <dl th:each="livro : $">
      <dt class="bookHeadline">
        <span th:text="${livro.titulo}">Title</span> by <span
              th:text="${livro.autor}">Author</span> (ISBN: <span
              th:text="${livro.isbn}">ISBN</span>)

      </dt>
      <dd class="bookDescription">
        <span th:if="${livro.description}" th:text="${livro.description}"
        >Description</span>
        <span th:if="${livro.description eq null}"> Nenhuma descriç�o 
        foi adicionada para esse livro!</span>
      </dd>
    </dl>
  </div>
  <div th:if="${#lists.isEmpty(livros)}">
    <p>Nenhum Livro Cadastrado para esse autor</p>
  </div>
  <hr />
  <h3>Adicione um novo livro para o autor:</h3>
  <form method="POST">
    <label for="title">Title:</label> <input type="text" 
    name="titulo" size="50"></input><br />  
    <label for="isbn">ISBN:</label> <input type="text" 
    name="isbn" size="15"></input><br /> 
    <label      for="description">Description:</label><br />
    <textarea name="description" cols="80" rows="5"> </textarea>
    <br /> <input type="submit"></input>
  </form>
</body>
</html>

Listagem 5. Vis�o para o cadastro e Listagem de Livros

Por �ltimo, � necess�rio criar a classe que inicializa a aplicaç�o com o Spring Boot e cria o banco de dados H2 e o Apache Tomcat. A �nica configuraç�o necess�ria nesse arquivo � dizer onde estar�o as entidades, os reposit�rios e os controladores (se tudo estiver no mesmo pacote isso n�o � necess�rio). A Listagem 6 mostra o c�digo dessa classe.


package com.devmedia.mvc.application;
 
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.orm.jpa.EntityScan;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
 
@SpringBootApplication
@EntityScan(basePackages = { "com.devmedia.mvc.entity" })
@EnableJpaRepositories(basePackages = { "com.devmedia.mvc.repository" })
@ComponentScan(basePackages = {"com.devmedia.mvc.controller"})
public class Application {
      public static void main(String[] args) {
            SpringApplication.run(Application.class, args);
      }
}

Listagem 6. Classe que inicializa a aplicaç�o

Para rodar a aplicaç�o no Eclipse basta executar a classe Application e esperar o Tomcat ser inicializado. Assim que isso acontecer, acesse de qualquer browser o endereço http://localhost:8080/nomeDeAutor. Com isso ser� mostrada a tela da aplicaç�o desenvolvida. Inicialmente a lista de livros estar� vazia, mas voc� pode cadastrar quantos livros quiser utilizando o formul�rio que est� na parte de baixo da tela. A Figura 1 mostra como exemplo a aplicaç�o sendo executada com o nome do autor Eduardo: vejam que existem dois livros cadastrados para esse autor e abaixo aparece o formul�rio, onde podem ser cadastrados mais livros para este. O endereço de acesso para essa p�gina foi http://localhost:8080/Eduardo.

Figura 1. Tela da Aplicaç�o desenvolvida com a lista de livros do autor Eduardo.

Caso a aplicaç�o seja acessada com o nome de outro autor � exibida a lista correspondente a este, como mostra a Figura 2, onde a p�gina foi acessada passando o nome Luiz como nome do autor. A aplicaç�o diferencia o autor que est� sendo acessado pela URL que foi acessada: nesse caso o autor � o Luiz, pois o endereço usado na requisiç�o foi http://localhost:8080/Luiz.

Figura 2. Tela da aplicaç�o desenvolvida com a lista de livros do autor Luiz

Esse artigo mostrou como desenvolver uma aplicaç�o simples com o Spring Boot utilizando os frameworks Spring Data e Spring MVC. Nessa aplicaç�o n�o foi necess�ria praticamente nenhuma configuraç�o, nem de banco de dados, nem de arquivos XML e praticamente nenhuma anotaç�o de configuraç�o. Esse � o grande objetivo do Spring Boot, que permite ao o programador focar apenas no desenvolvimento dos requisitos funcionais da aplicaç�o, evitando o trabalho repetitivo que s�o necess�rios em todos os projetos.

Saiu na DevMedia!

O que � UML?: Neste curso entenderemos o que � UML, a Unified Modeling Language, bem como quais s�o os principais diagramas que podemos criar com essa linguagem.
Seu banco est� protegido de SQL Injection?: E se o usu�rio conseguir enviar um trecho de SQL com o qual ele consiga roubar ou danificar os dados do banco? Saiba neste DevCast o que � SQL Injection e, mais importante, como proteger a sua aplicaç�o deste ataque t�o comum.
Primeiros passos com Spring Security: Um requisito fundamental no desenvolvimento de qualquer aplicaç�o � a segurança. Pensando na import�ncia desse assunto, neste curso voc� aprender� a adicionar segurança em aplicaç�es web ao mesmo tempo em que d� os primeiros passos com o framework Spring Security.

Saiba mais sobre Spring e Java ;)

Guia de Spring Framework: Neste Guia de Refer�ncia voc� encontrar� o conte�do que precisa para aprender a desenvolver aplicaç�es utilizando o Spring Framework e seus subprojetos.
O que � Spring MVC?: Neste curso voc� aprender� o que � o Spring MVC, framework criado com o intuito de simplificar e trazer mais produtividade ao desenvolvimento de aplicaç�es Web
Segurança com Spring Security: Durante este v�deo ser� demonstrado como trabalhar com o Spring Security em uma aplicaç�o com o Spring MVC. O Spring Security � um projeto do Spring Framework com a finalidade de adicionar segurança em aplicaç�es Java Web.

Refer�ncias:

Desenvolvendo uma Aplica��o Web com Spring Boot e Spring MVC

Nesse artigo será mostrado como desenvolver uma aplicação Web com o Spring MVC e o Spring Data utilizando o Spring Boot com o Maven para configuraração, o que facilita muito o desenvolvimento desse tipo de aplicação.

Desenvolvimento da Aplicaç�o

Saiu na DevMedia!

Saiba mais sobre Spring e Java ;)

Artigos relacionados