28 - ResponseEntity

Nessa vigésima oitava parte do nosso tutorial, iremos aprender a utilizar o ResponseEntity, responsável por retornar o status de uma requisição, veja abaixo alguns status que podemos utilizar em nossos projetos:

Código	Status	Descrição
200	Ok	Requisições bem sucedidas
201	Created	Quando efetuado algum cadastro
202	Accepted	Requisição aceita, porém não executada
400	Bad Request	Quando não é possível realizar determinada requisição
401	Unauthorized	Sem autorização para executar alguma requisição
404	Not Found	O servidor não consegue encontrar a rota ou requisição solicitada
429	Too Many Requests	Quando o usuário efetua muitas requisições simultaneamente

Caso queira conhecer outros status, basta acessar o site para desenvolvedores da Mozilla Foudation, clique aqui para acessar os conteúdos.

Vamos implementar nosso projeto, primeiramente no arquivo de controle, crie a seguinte rota:

Agora podemos testar, abra o Thunder Client e acesse a url: localhost:8080/status e o resultado será esse:

Note que o status da requisição é um 200 Ok, mas e se quisermos alterar esse status? Aí que vai entrar o nosso ResponseEntity, vamos fazer a seguinte implementação na nossa rota:

Nossa rota retornará agora o status 201 Created, garantindo que essa requisição especifique exatamente a ação efetuada. Veja abaixo como será o retorno dessa rota:

Abaixo deixarei um vídeo explicando detalhadamente os conceitos acima: