�ltimas mensagens do t�pico "WebService do tipo REST"

WebService do tipo REST

chun — GMT

Alguem aqui j� fez algum webservice do tipo REST ?

Em java... por onde comecar ?

Re:WebService do tipo REST

Luca — GMT

Ol�

REST = Representational State Transfer e o conceito surgiu em 2000 com a tese de doutorado do Roy Fielding.

Se pode entender como REST qualquer Web Service que pode ser acessado com uma requisi��o simples HTTP GET.

Basicamente voc� pode criar um cliente com Swing enviando um request via URLConnection e receber de volta um xml resultado que dever� parsear. Diretamente do browser se pode tamb�m acessar o servi�o mas como a resposta costuma vir em xml, fica meio dif�cil fazer algo com ela.

Googlando se pode achar muitos tutoriais sobre o que � e como usar REST. Que eu me lembre, no XML.com tem um monte de textos do Joe Gregorio (criador do ATOM) e tem um tutorial do Roger Costello no xfront.com.

Muitas empresas servem web services com REST. A Amazon diz a partir de estat�sticas de tr�fego, que 90% do uso dos seus web services s�o baseados em REST

O Google baseou seus WS em SOAP por�m o Yahoo oferece uma API para busca baseada em REST. Veja http://developer.yahoo.net/.

E experimente o Yahoo:
http://api.search.yahoo.com/WebSearchService/V1/webSearch?appid=00000000&query=GUJ+chun

Na verdade o conceito inicial da tese do Roy Fielding n�o usava a query string do GET. Ele se baseava apenas na URL e no uso do HTTP

Assim, para acessar um servi�o que retornasse todos os posts do Chun no GUJ se escreveria algo como:
http://www.guj.com.br/posts/Chun

Para ler um post_especifico seria:
http://www.guj.com.br/posts/Chun/post_especifico

Para apagar se usaria o HTTP DELETE e para incluir ou atualizar o HTTP PUT.

Na pr�tica ningu�m usa o conceito do Roy exatamente como ele criou porque significaria projetar todo o site j� deste jeito. E isto foge do conceito de reaproveitar c�digo fornecendo WS a partir de aplica��es prontas que � uma das vantagens de web services.

[]s
Luca

Re:WebService do tipo REST

chun — GMT

Valeu

Re:WebService do tipo REST

rodrigoallemand — GMT

Ressuscitando este t�pico, como ficaria uma chamada usando REST para mais de um parametro, por exemplo:

http://www.exemplo.org/rest/tickets*****(tickets com status igual a aberto e direcionados para o usu�rio 'abcs')*****

Re:WebService do tipo REST

Leonardo3001 — GMT

Assim:

http://www.exemplo.org/rest/usuario/abcs/ticket/aberto

Voc� vai encadeando os par�metros, sendo que cada item que separa a barra limita a consulta anterior.

WebService do tipo REST

Rafael Nunes — GMT

Ou usando query string:

http://www.u-�rre-�le.com/rest?query=tickets&status=aberto&usuario=abcs

Re:WebService do tipo REST

djemacao — GMT

caraka Luca, que aula!!!!
Parab�ns pela clara explica��o. Vou aprender REST agora, fiquei super curioso.

Abra�os

Re:WebService do tipo REST

saoj — GMT

O REST seria trocar toda a parafern�lia de RPC, RMI e WebServices por simples chamadas HTTP a um web server?

Eu sempre dei preferencia a simplicidade de uma chamada HTTP ao inv�s de optar pela parafern�lia de uma requisi��o remota. Dizem que xFire resolve esse problema, mas j� em 2004 eu sugeria o seguinte:

[quote="2004"]
Eu estou meio por fora de webservices. Vc quer enviar objeto e receber objeto como resposta n�?

Como n�o manjo das sugest�es que foram dadas aqui, eu faria assim: (Veja se estou falando merda mais uma vez e me avise, ok? )

Pegaria meu objeto
serializaria ele para um array de bytes
codificaria ele em hexadecimal ou base64 (texto!) (ou XML para ficar independente de Java)
ziparia se fosse o caso para ecomizar banda
enviaria para o web server via HTTP mesmo

e o servidor faria a mesma coisa para me responder com um objeto.
[/quote]

Fonte: http://www.guj.com.br/posts/list/15760.java

Re:WebService do tipo REST

rodrigoallemand — GMT

Bem, vou seguir a ideia do Leonardo3001...
Estou montando um framework para um cliente onde eu pretendo disponibilizar tudo em REST... est� ficando legal! Em breve estarei colocando exemplos aqui no GUJ pra galera...
S� pra dar gostinho, eu posso fazer coisas deste tipo:

http://www.exemplo.org/usuario (Lista todos os usu�rios)
http://www.exemplo.org/usuario.login/rodrigoallemand (detalha o usu�rio)
http://www.exemplo.org/usuario.login/*allemand (lista todos os usu�rios onde o login termine com allemand)
http://www.exemplo.org/venda.status/finalizada/venda.produto.precocusto/>10 (lista todas as vendas finalizadas onde o pre�o de custo do produto � maior que 10)

DETALHE: Sem nada de ficar configurando um monte de URIs pra l� e pra c�...

WebService do tipo REST

Rafael Nunes — GMT

Rodrigo, por que voc� adotou essa separa��o por resource na URI(/usuario/, /venda.status/) e n�o query String do m�todo GET?

Re:WebService do tipo REST

Leonardo3001 — GMT

[quote=saoj]
O REST seria trocar toda a parafern�lia de RPC, RMI e WebServices por simples chamadas HTTP a um web server?

Eu sempre dei preferencia a simplicidade de uma chamada HTTP ao inv�s de optar pela parafern�lia de uma requisi��o remota. Dizem que xFire resolve esse problema, mas j� em 2004 eu sugeria o seguinte:

[quote="2004"]
Eu estou meio por fora de webservices. Vc quer enviar objeto e receber objeto como resposta n�?

Como n�o manjo das sugest�es que foram dadas aqui, eu faria assim: (Veja se estou falando merda mais uma vez e me avise, ok? )

Pegaria meu objeto
serializaria ele para um array de bytes
codificaria ele em hexadecimal ou base64 (texto!) (ou XML para ficar independente de Java)
ziparia se fosse o caso para ecomizar banda
enviaria para o web server via HTTP mesmo

e o servidor faria a mesma coisa para me responder com um objeto.
[/quote]

Fonte: http://www.guj.com.br/posts/list/15760.java[/quote]

Legal! � por isso que eu gosto do REST.
Mas tem 2 coisas legais no REST que ningu�m falou:
1- A variedade de formato de representa��o: o cliente sempre manda os mime types que ele � capaz de processar, pode ser text/plain, application/xml ou outros. Quem t� servindo REST pode responder em v�rios formatos diferentes, dependendo do que o cliente est� mandando. Assim, posso responder com uma imagem (image/gif), um xml (application/xml), um json (application/json) ou um objeto Java serializ�vel (application/x-java-serializable), � s� o cliente escolher.

2- O uso de links como refer�ncias: se o cliente quer buscar um pedido, s� que o pedido sempre � feito por um comprador, o objeto possui uma refer�ncia para um comprador. Ok. Mas na hora de serializar, eu n�o preciso colocar toda a representa��o do comprador, basta uma refer�ncia URL como por exemplo http://www.exemplo.org/comprador/425 . Se depois disso, o cliente quiser ver o comprador, basta chamar a URL que recebeu quando viu o pedido.

Re:WebService do tipo REST

saoj — GMT

[quote]
1- A variedade de formato de representa��o: o cliente sempre manda os mime types que ele � capaz de processar, pode ser text/plain, application/xml ou outros. Quem t� servindo REST pode responder em v�rios formatos diferentes, dependendo do que o cliente est� mandando. Assim, posso responder com uma imagem (image/gif), um xml (application/xml), um json (application/json) ou um objeto Java serializ�vel (application/x-java-serializable), � s� o cliente escolher.
[/quote]

Legal, mas na pr�tica seria melhor se todo mundo optasse por um formato s�. Eu gosto muito de objeto serializado em base64 zipado. Mas a� seria s� para clientes Java. JSON/XML pode ser melhor para suportar qualquer tipo de cliente.

[quote]
2- O uso de links como refer�ncias: se o cliente quer buscar um pedido, s� que o pedido sempre � feito por um comprador, o objeto possui uma refer�ncia para um comprador. Ok. Mas na hora de serializar, eu n�o preciso colocar toda a representa��o do comprador, basta uma refer�ncia URL como por exemplo http://www.exemplo.org/comprador/425 . Se depois disso, o cliente quiser ver o comprador, basta chamar a URL que recebeu quando viu o pedido.
[/quote]

N�o entendi. Vc diz se eu tenho um objeto que contem usu�rio, eu mando o link do usu�rio ao inv�s do objeto usu�rio inteiro? Explica melhor...

Re:WebService do tipo REST

Leonardo3001 — GMT

� um tipo de coisa que s� se consegue explicar em c�digo. Vamos l�!
Imagine que eu tenha a classe Pedido:

[code]
public class Pedido {

private Long id;
private String nomeProduto;
private BigDecimal valor;
private Comprador comprador;

// getters, setters e tudo mais

}
[/code]

e eu tenha a classe Comprador:

[code]
public class Comprador {

public Long id;
public String nome;
public String sobrenome;

public Collection pedidos;

// getters, setters e tudo mais

}
[/code]

Podemos ver que um pedido � feito por um comprador e que um comprador possui v�rios pedidos.

Imagine que eu fa�a um GET no endere�o http://www.exemplo.org/pedido/5, e que me retornaria um JSON, que seria a deserializa��o pura do objeto:
[code]
{"pedido":
{"id":5,
"nomeProduto": "Nintendo Wii",
"valor": "2000,00",
"comprador":
{"id": 12,
"nome": "Beltrano",
"sobrenome": "Silva",
"pedido" : ### hummmmm.... come�ou a complicar! ###
}
}
}
[/code]

Vai ficar muito grande se eu resolver devolver o pedido e todos os objetos que os referenciam, ia correr at� risco de uma refer�ncia circular.

Por isso, eu s� devolveria a refer�ncia do comprador:

[code]
{"pedido":
{"id":5,
"nomeProduto": "Nintendo Wii",
"valor": "2000,00",
"comprador": "http://www.exemplo.org/comprador/12"
}
}
[/code]

Repare, a refer�ncia � uma URL! Se eu n�o quiser saber do comprador, tudo bem, eu n�o carreguei essa informa��o do servidor. Mas se eu quiser saber, basta pegar essa URL que est� dentro de pedido e fazer uma nova requisi��o GET.

Re:WebService do tipo REST

saoj — GMT

Seria um lazy-loading via http?

Re:WebService do tipo REST

peczenyj — GMT

[quote=saoj]
Seria um lazy-loading via http? [/quote]

Pensei na mesma coisa.

Re:WebService do tipo REST

Paulo Silveira — GMT

O Leonardo esta mostrando a maneira bonita e ideal de implementar rest, parabens! � assim mesmo.

Mas, se voce for ver por ai, ate mesmo as grandes empresas que o Luca cita na assinatura dele n�o usam rest dessa maneira. O Flickr da yahoo, por exemplo, se diz restful, mas usa a mesmissima URL para todos os servicos, nao tendo a ideia de aproveitar a URI:
http://www.flickr.com/services/api/

E cada um usa sua propria ideia de REST da maneira que o convem.

A JSR de Rest da Sun da suporte a implementar da maneira "correta" (que esta muito interessante alias, e o glassfish tem ela implementada beta no jersey):
http://www.jcp.org/en/jsr/detail?id=311

Fortemente baseada em anotacoes. Bem legal.

WebService do tipo REST

rodrigoallemand — GMT

[quote=Rafael Nunes]Rodrigo, por que voc� adotou essa separa��o por resource na URI(/usuario/, /venda.status/) e n�o query String do m�todo GET?[/quote]

Po, sei l�... achei que ficaria melhor a visualiza��o do que aquelas montagens de query string... mas no final ficou legal que a DSL j� entende o que foi mandado, de qualquer forma... se fosse query string, eu teria que fazer uma procura especializada... ou n�o... sei l�...

Bem, respondendo, foi por uma melhor visualiza��o e pra entendimento automativo da DSL...

Re:WebService do tipo REST

saoj — GMT

[quote=Paulo Silveira] Mas, se voce for ver por ai, ate mesmo as grandes empresas que o Luca cita na assinatura dele n�o usam rest dessa maneira. O Flickr da yahoo, por exemplo, se diz restful, mas usa a mesmissima URL para todos os servicos, nao tendo a ideia de aproveitar a URI:
http://www.flickr.com/services/api/
[/quote]

[quote="Flick API"]
http://api.flickr.com/services/rest/?method=flickr.test.echo&name=value
[/quote]

At� agora, REST est� me parecendo simplesmente RMI em cima de HTTP. S� que inv�s de objeto serializado, vc usa XML ou JSON para n�o ficar atrelado ao Java.

Re:WebService do tipo REST

rodrigoallemand — GMT

[quote=saoj]At� agora, REST est� me parecendo simplesmente RMI em cima de HTTP. S� que inv�s de objeto serializado, vc usa XML ou JSON para n�o ficar atrelado ao Java.
[/quote]

Po, � uma compara��o meio trivial.... se for assim, qualquer coisa que vc fa�a uma chamada padronizada (URI) e ele responda de qualquer maneira que seja, � parecido com RMI, REST, EJB, CORBA, JMS, etc.

Acho que o legal do REST (e pelo que eu to vendo no levante desse topico) � a possibilidade de tornar simples um conceito que pra muitos era complicado...
Afinal, WebService nas vias "normais" (SOAP) � tranquilo tambem, mas eu sentia que causava medo em certas pessoas... JMS ent�o, nem se fala... J� REST o pessoal entende que � HTTP e Servlet puro e aplicado...

Re:WebService do tipo REST

saoj — GMT

[quote]
Po, � uma compara��o meio trivial....
[/quote]

Verdade, mas o grosso da id�ia � isso. � aquela velha hist�ria: "Pra que simplificar quando se pode complicar?"

[quote]
Many SOAP adherents make the claim that systems are complex and therefore require complex solutions. REST is too simple and therefore cannot be used to solve complex problems. This claim is same claim that any vendor will make to help you justify paying a higher margin. The reality is, the claim is entirely false, complex systems can be built using simple components.
[/quote]

Fonte: http://www.manageability.org/blog/stuff/rest-explained-in-code

Acabei de descobrir uma diferen�a em rela��o a RMI. REST, diferentemente de RMI, s� pode fazer chamada STATELESS. Isso � para facilitar o cache, simplicidade e escalabilidade.

Re:WebService do tipo REST

Maracuja — GMT

Ja que o t�pico � sobre REST... se alguem ainda n�o ouviu falar...

[url=http://www.projectzero.org/wiki/bin/view/]Project Zero[/url]

Re:WebService do tipo REST

saoj — GMT

Encontrei um link que esclareceu todas as minhas d�vidas sobre Rest.

Estou RESTful.

http://www.peej.co.uk/articles/restfully-delicious.html

Re:WebService do tipo REST

khichfy — GMT

Fala pessoal

Foi me dada a tarefa de implementar 2 servi�os com o conceito de REST...
beleza... entendi o conceito, li tudo que vcs falaram, e agora vou come�ar a fazer o download das coisas que preciso...
seria por exemplo o jersey da Sun ?

eu ia come�ar a procurar esse .jar para t�o logo mexer no meu web.xml e incluir essa dependencia no pom.xml (to usando maven...)
mas antes de procurar, sei que vou me complicar em achar as coisas certas, por isso minha pergunta aqui se refere ao ponto de partida, ou seja, qual vers�o do jersey eu devo pegar e onde pegar ?

to usando o eclipse, ser� que tem algum plugin ?

depois de passar por esses tramites iniciais, vou preparar com "anotacions" @ minha classe de modelo para indicar o root do xml, os campos, o pattern da URI etc... esse tipo de coisa vou me virando...
no fim, espero postar do inicio ao fim todo o roteiro utilizado para implementar o servi�o, que consiste em :
- Dado um CPF retornar uma lista de clientes

Valeu e ate mais

Re:WebService do tipo REST

roanbrasil — GMT

Como funciona o gerenciamento de sessoes para uma determinada operacao ou at� para ver se o usuario est� logado, muda alguma coisa ou tudo continua no fornt-end?