{"id":875,"date":"2016-06-13T06:05:14","date_gmt":"2016-06-13T09:05:14","guid":{"rendered":"https:\/\/www.erudio.com.br\/blog\/?p=875"},"modified":"2022-12-21T11:28:07","modified_gmt":"2022-12-21T14:28:07","slug":"o-que-e-hateoas","status":"publish","type":"post","link":"https:\/\/www.erudio.com.br\/blog\/o-que-e-hateoas\/","title":{"rendered":"Entendendo HATEOAS"},"content":{"rendered":"

HATEOAS<\/strong> (Hypermedia as the Engine of Application State)<\/a> \u00e9 uma constraint arquitetural de aplica\u00e7\u00f5es REST. Uma API HATEOAS<\/strong> prov\u00ea informa\u00e7\u00f5es que permite navegar entre seus endpoints de forma din\u00e2mica visto que inclui links junto \u00e0s respostas. Esta capacidade a difere de sistemas baseados em SOA<\/strong> e interfaces dirigidas por WSDL<\/strong>(pronuncia-se u\u00edsdou). Com SOA<\/strong>, servidores e clientes usualmente devem acessar uma especifica\u00e7\u00e3o fixa que pode ser acessada em outro lugar na API<\/strong>, ou em um website, ou as vezes distribu\u00eddo por email.<\/p>\n

Nota<\/strong>: Pronunciar HATEOAS <\/strong>n\u00e3o \u00e9 f\u00e1cil e pode variar bastante. Algumas pessoas pronunciam algo como “riteos<\/strong>“, outros como “reitos<\/strong>” ou como “reid\u00f4s<\/strong>“. Alguns podem se referir a esse conceito arquitetural por hypermedia-driven system<\/strong> \u2013 algo como sistema dirigido por hiperm\u00eddia.<\/em><\/p>\n

Exemplos<\/strong><\/p>\n

O c\u00f3digo a seguir representa um objeto Cliente<\/em>.<\/p>\n

\nclass Cliente {\n\tString nome;\n}\n<\/pre>\n
Uma representa\u00e7\u00e3o JSON<\/strong> tradicional seria algo como:<\/p>\n
\n{\n\t"nome" : "Leandro"\n}\n<\/pre>\n
Os dados do Cliente<\/em> est\u00e3o l\u00e1, mas os dados n\u00e3o cont\u00e9m nada de relevante sobre suas conex\u00f5es. Uma representa\u00e7\u00e3o baseada em HATEOAS<\/strong> deve ser similar ao JSON<\/strong> abaixo:<\/p>\n
\n{\n   "nome":"Leandro",\n   "links":[\n      {\n         "rel":"self",\n         "href":"http:\/\/localhost:8080\/Cliente\/1"\n      }\n   ]\n}\n<\/pre>\n
A resposta n\u00e3o cont\u00e9m somente o nome de uma pessoa, mas inclui uma URL com o endere\u00e7o de onde as informa\u00e7\u00f5es dessa pessoa podem ser localizadas.<\/p>\n