OMG! API RESTFul em 1 minuto

Fiquei muito assustado com a velocidade que é possível desenvolver um pequeno serviço RESTFul com o Spring Data Rest e tudo fica mais bonito ainda sendo o banco embarcado e o servidor também embarcado.

Primeiramente, segue o pom.xml, onde será possível ver os poucos pacotes que estou usando:

	<?xml version="1.0" encoding="UTF-8"?>
	<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>br.com.tassioauad</groupId>
	<artifactId>myrest</artifactId>
	<version>0.1</version>
	<packaging>jar</packaging>

	<name>myrest</name>
	<description>RESTFul API</description>

	<parent>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-parent</artifactId>
	<version>2.0.0.RELEASE</version>
	<relativePath/> <!– lookup parent from repository –>
	</parent>

	<properties>
	<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
	<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
	<java.version>1.8</java.version>
	</properties>

	<dependencies>
	<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-data-jpa</artifactId>
	</dependency>
	<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-data-rest</artifactId>
	</dependency>
	<dependency>
	<groupId>com.h2database</groupId>
	<artifactId>h2</artifactId>
	<scope>runtime</scope>
	</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>

view raw
pom.xml
hosted with ❤ by GitHub

Estou apenas usando Spring Data JPA, Spring Data REST e o driver para conexão com o H2. Próximo passo, o arquivo de configurações application.properties fica assim:

server.port= 9000

#—–H2

spring.h2.datasource.url=jdbc:h2:file:~/myh2

spring.h2.datasource.username=sa

spring.h2.datasource.password=

spring.h2.datasource.driver-class-name=org.h2.Driver

spring.jpa.show-sql=true

view raw
application.properties
hosted with ❤ by GitHub

Próximo ponto é criar uma entidade:

@Entity

@Table(name = "person")

public class Person {

    @Id

    @Column(name = "id", nullable = false)

    @GeneratedValue(strategy = GenerationType.IDENTITY)

    private Long id;

    @Column(name = "name", nullable = false, length = 100)

    private String name;

    @Column(name = "email", nullable = false)

    private String email;

    @Column(name = "document_nr", nullable = false, length = 15)

    private String documentNr;

    //….

}

view raw
person.java
hosted with ❤ by GitHub

Agora, basta criarmos um Repository para essa entidade e colocarmos a annotation @RepositoryRestResource(path = “person”), que informará que nosso repositório será um resource Rest e será endereçado em “person/”:

@RepositoryRestResource(path = "person")

public interface PersonRepository extends PagingAndSortingRepository<Person, Long> {

}

view raw
PersonRepository.java
hosted with ❤ by GitHub

Pronto, você já tem seu web service RESTFul com um CRUD de POST, GET, DELETE e PUT já criados e paginados também pela herança da classe PagingAndSortingRepository. Faça um teste, realize um GET em “http//:localhost:9000/person” e você verá algo como:

	{
	"_embedded" : {
	"persons" : [ ]
	},
	"_links" : {
	"self" : {
	"href" : "http://localhost:9000/person{?page,size,sort}",
	"templated" : true
	},
	"profile" : {
	"href" : "http://localhost:9000/profile/person"
	}
	},
	"page" : {
	"size" : 20,
	"totalElements" : 0,
	"totalPages" : 0,
	"number" : 0
	}
	}