Projecto Integrador. Introdução ao REST. Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 1

Transcrição

1 Projecto Integrador Introdução ao REST Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 1

2 Notas Imagens do livro: G. Alonso et. Al. Web Services: Concepts, Architectures and Applications, Springer, Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 2

3 Sumário REST: modelo REST: protocolos REST: programação Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 3

4 Contexto Sistema de informação pervasivos Necessidade de fornecer serviços Necessidade de aceder a serviços Criar serviços mais complexos Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 4

5 Web services: dentro de uma organização Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 5

6 Web services: entre organizações Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 6

7 Leitura Fortemente Recomendada A RESTful Web service, an example Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 7

8 REST: Representational State Transfer Estilo ou padrão arquitectural, não um sistema de desenvolvimento;; não uma especificação ou normalização formal. Aproximação: vê uma aplicação como uma colecção de recursos Um recurso é identificado por um URI/URL Um URL devolve um documento com a representação do recurso Um URL pode referir uma colecção de recursos Podem-se fazer referências a outros recursos usando ligações (links) Aproximação proposta por Roy Fielding na sua tese de doutoramento Não como uma alternativa aos web services, mas como uma forma de aceder a informação Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 8

9 REST: princípios de desenho Protocolo cliente/servidor stateless: cada pedido contém toda a informação necessária para ser processado Objectivo: tornar o sistema simples. Recursos: no sistema tudo são recursos, identificados por um URI/URL. Recursos tipicamente armazenados num formato estruturado que suporta hiper-ligações (e.g. XML) Interface uniforme: todos os recursos são acedidos por um conjunto de operações HTTP bem-definidas POST criar GET let PUT atualizar/substituir DELETE remover Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 9

10 REST: princípios de desenho Usa HTTP GET, POST, etc., mas Usa dados bem-tipados (e.g., usando schemas XML, json) Cache: para melhorar desempenho, respostas podem ser etiquetadas como permitindo ou não caching. Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 10

11 A salientar Aspectos determinantes: stateless & cacheable, web-oriented Rentabiliza a vasta experiência, maturidade e o investimento prévio na infraestrutura envolvente da web: servidores, proxies, caches, software, bibliotecas, etc. Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 11

12 Mais detalhes e exemplo Um exemplo (de Roger L. Costello) Uma empresa pretende disponibilizar web services REST para permitir aos seus clientes: Obter uma lista de peças Obter informação detalhada sobre uma peça Submeter uma ordem de compra Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 12

13 Exemplo: listagem Tornar uma lista de peças disponível como um recurso GET <?xml version="1.0"?> <p:parts xmlns:p=" xmlns:xlink=" <Part id="00345" xlink:href=" <Part id="00346" xlink:href=" <Part id="00348" xlink:href=" </p:parts> Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 13

14 Exemplo: obter informação sobre entidade Obter detalhes sobre uma peça GET <?xml version="1.0"?> <p:part xmlns:p=" xmlns:xlink=" <Part-ID>00345</Part-ID> <Name>Widget-A</Name> <Description>This part is used within the frap assembly</description> <Specification xlink:href=" <UnitCost currency="usd">0.10</unitcost> <Quantity>10</Quantity> </p:part> Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 14

15 Exemplo: criar informação Submeter uma ordem de compra POST <?xml version="1.0"?> <p:order xmlns:p=" xmlns:xlink=" <Part-ID>00345</Part-ID> <UnitCost currency="usd">0.10</unitcost> <Quantity>10</Quantity> </p:part> Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 15

16 Exemplo: listagem com filtragem / pesquisa Tornar uma lista de peças disponível como um recurso GET GET <?xml version="1.0"?> <p:parts xmlns:p=" xmlns:xlink=" <Part id="00345" xlink:href=" </p:parts> Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 16

17 Exemplo: listagem com filtragem Lista de ordens de compra dum utilizador GET GET <?xml version="1.0"?> <p:orders xmlns:p=" xmlns:xlink=" <Order id="00301" xlink:href=" "/> <Order id="00302" xlink:href=" "/> </p:parts> Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 17

18 Exemplo: listagem com múltiplos filtros Lista de ordens de compra dum utilizador num dado mês GET GET <?xml version="1.0"?> <p:orders xmlns:p=" xmlns:xlink= <Order id="00302" xlink:href=" "/> </p:parts> Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 18

19 Exemplo: listagem com paginação Tornar parte uma lista de peças disponível como um recurso GET GET <?xml version="1.0"?> <p:parts xmlns:p=" xmlns:xlink=" <Part id="00345" xlink:href=" </p:parts> Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 19

20 Exemplo: contagem Contar número de elementos duma lista de peças GET <?xml version="1.0"?> <p:partscount xmlns:p=" xmlns:xlink=" 3 </p:partscount> Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 20

21 REST vs. RPCs/Web Services Nos sistemas de RPCs/Web Services a ênfase é nas operações que podem ser invocadas Nos sistemas REST, a ênfase é nos recusos, na sua representação e em como estes são afectados por um conjunto de métodos standard Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 21

22 REST: protocolos Baseado em protocolos standard Comunicação HTTP (tipicamente) Identifcação de recursos URL/URI Representação dos recursos XML, JSon Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 22

23 XML vs. Json <Person firstname='john' lastname='smith' age='25'> <Address streetaddress='21 2nd Street' city='new York' state='ny' postalcode='10021' /> <PhoneNumbers home=' ' fax=' ' /> </Person> (Example from wikipedia) { "Person : { "firstname": "John", "lastname": "Smith", "age": 25, "Address : { "streetaddress":"21 2 nd Street", "city":"new York", "state":"ny", "postalcode":"10021" }, "PhoneNumbers : { "home":" ", "fax":" " } } } Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 23

24 REST: programação cliente Estilo bricolage Biblioteca invocação métodos HTTP Java: URL JavaScript: XMLHttpRequest Ruby: Net:HTTP Bibliotecas para codificação de dados Java: XML -> JAXP;; JSON -> google it J JavaScript: XML -> XMLHttpRequest;; JSON -> objecto JavaScript PHP: XML, JSON installed in PHP > 5.2 Estilo framework Sistemas em que integram mecanismos anteriores de forma coerente Java: JAX-RS;; PHP: EasyRest, Recess, ;; JavaScript: jquery Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 24

25 REST: cliente Javascript var httprequest = new XMLHttpRequest(); httprequest.onreadystatechange = function() { dosomething(httprequest); }; httprequest.open("get", true); httprequest.send(null); Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 25

26 REST: cliente Ruby on Rails Net::HTTP.get('example.com', '/index.html') # => String uri = URI(' Net::HTTP.start(uri.host, uri.port) do http request = Net:: uri.request_uri response = http.request request # Net::HTTPResponse object end Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 26

27 REST: programação servidor Estilo bricolage Cliente + Biblioteca servidor/application server Estilo framework Sistemas em que integram mecanismos anteriores de forma coerente Java: Jersey, Jboss, Restlet, etc. PHP: Recess, Zend Rest, etc. Ruby on Rails: rails routing Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 27

28 REST: servidor Ruby on Rails resources :parts HTTP Verb Path action used for GET /parts index display a list of all part GET /parts/new new return an HTML form for creating a new part POST /parts create create a new part GET /parts/:id show display a specific part GET /parts/:id/edit edit return an HTML form for editing a part PUT /parts/:id update update a specific part DELETE /parts/:id destroy delete a specific part Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 28

29 REST: programação em Java Definido em JAX-RS (JSR 311) Suporte linguístico baseado na utilização de anotações Permite definir que um dado URL/operação HTTP leva à execução dum dado método Permite definir o modo de codificação da resposta/pedido XML usando mecanismo standard de codificação de cobjectos java em XML fornecido pelo JAXB JSON mecanismo leve de codificação de tipos (RFC 4627) Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 29

30 REST: suporte public class CustomerService public Customers getcustomers() @Produces("application/json") public Customer getcustomer(@pathparam("id") String id) @Consumes("application/xml") public Response updatecustomer(@pathparam("id") long id, Customer customer) {... } Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 30

31 REST: suporte public Response addcustomer(customer customer) public Response deletecustomer(@pathparam("id") String id) {... } public Order getorder(@pathparam("orderid") String orderid) {... } Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 31

32 Conclusões Grande popularidade Muitos serviços web disponibilizados segundo este modelo Grandes vantagens: simplicidade e desempenho Serviços disponibilizados num modelo REST nem sempre aderem completamente aos princípios REST Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 32

33 Ligações REST Fielding s TOIT paper: Wikipedia: Exemplo Delicious: Ruby on Rails Net:Http: /libdoc/net/http/rdoc/Net/HTTP.html Routing Javascript XMLHttpRequest: Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 33

34 Ligações Java Docs JAX-RS spec: Restful Java with JAX-RS: Frameworks Jersey: Jboss: Restlet: Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 34

35 Ligações (cont.) PHP JSON Docs Framework Recess: EasyRest: Zend Rest: Material de suporte às aulas de Proj. Integrador (Nuno Preguiça) Copyright DI FCT/ UNL / 35