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
	}
	}