jbiason
/
Presentations
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Browse Source

removed the sub views in the rest presentation, they are confusing as heck

master
Julio Biason 11 years ago
parent
e32d09b21d
commit
c018748efe
1 changed files with 207 additions and 224 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 431
      rest.html

431
rest.html
Unescape View File

@ -67,261 +67,244 @@ img {
</ul> </ul>
</section> </section>
<section> <!-- data-background="_images/l-What-is-this-sorcery.jpg"> --> <section>
<section> <h2>O que é ReST?</h2>
<h2>O que é ReST?</h2> <img src='_images/l-What-is-this-sorcery.jpg'></img>
<img src='_images/l-What-is-this-sorcery.jpg'></img> </section>
</section>
<section>
<section> <p>É uma "arquitetura" de transmissão de dados sobre HTTP.</p>
<p>
É uma "arquitetura" de transmissão de dados sobre HTTP. <p>("Conjunto de idéias para utilizar HTTP para geração de APIs.")</p>
</p> </section>
<p> <section>
("Conjunto de idéias para utilizar HTTP para geração de APIs.") <p>Linguagem? Qualquer!</p>
</p>
</section> <ul>
<li>Python: Flask, Django, Flask-Restless, Django Rest Framework</li>
<section> <li>Ruby: Ruby on Rails, Sinatra</li>
<p> <li>Java: Spring, Restlet, Jersey</li>
Linguagem? Qualquer! <li>C#: Ramone</li>
</p> <li>Nodejs: Express</li>
<li>Rust: Rustful</li>
<ul> </dl>
<li>Python: Flask, Django, Flask-Restless, Django Rest Framework</li> </section>
<li>Ruby: Ruby on Rails, Sinatra</li>
<li>Java: Spring, Restlet, Jersey</li> <section>
<li>C#: Ramone</li> <h2>ReST e HTTP</h2>
<li>Nodejs: Express</li> <img src='_images/20090504102402_dsc_2864 (1).jpg'></img>
<li>Rust: Rustful</li> </section>
</dl>
</section> <section>
<ul>
<li>Métodos HTTP = operação de banco de dados (CRUD).</li>
<li>Resultado das operações são indicados por status HTTP.</li>
<li>Meta-informações podem ser enviadas nos headers.
<ul>
<li>Por exemplo, atenticação é feita por HTTP auth.</li>
</ul>
</li>
<li>Sem transações/sessões -- todas as operações são atômicas.</li>
</ul>
</section>
<section>
<p>Em HTTP, usam-se métodos para descrever o que quer ser feito:</p>
<ul>
<li><code>POST</code> requisita informações, com conteúdo.</li>
<li><code>GET</code> requisita informações, sem conteúdo.</li>
</ul>
<p class='fragment'>(Ainda: PUT, DELETE, HEAD, TRACE, PATCH, OPTIONS)</p>
</section>
<section>
<p>Em ReST, métodos HTTP viram CRUD:</p>
<ul>
<li>Create &#8658; POST</li>
<li>Retrieve &#8658; GET</li>
<li>Update &#8658; PUT</li>
<li>Delete &#8658; DELETE</li>
<li class='fragment'>Update &#8658; PATCH</li>
</ul>
</section>
<section>
<h2>Recursos</h2>
<img src='_images/jellybeans.jpg'></img>
</section>
<section>
<ul>
<li>Em ReST, as "tabelas" são chamadas "recursos".</li>
<li>Sempre substantivos no plural.</li>
<li>Duas URLs por recurso
<ul>
<li>Uma para o conjunto;</li>
<li>Uma para elementos específicos.</li>
</ul>
</li>
</ul>
</section>
<section>
<h3>URLs para o Recurso</h3>
<ul>
<li><code>GET /recurso/</code> &#8658; retorna todos os elementos do recurso.</li>
<li><code>POST /recurso/</code> &#8658; cria um novo elemento.</li>
<li><code>PUT /recurso/</code> &#8658; atualização em massa.</li>
<li><code>DELETE /recurso/</code> &#8658; remove todos os elementos do recurso.</li>
</ul>
</section> </section>
<section> <section>
<section> <h3>URLs para o Elemento</h3>
<h2>ReST e HTTP</h2>
<img src='_images/20090504102402_dsc_2864 (1).jpg'></img> <ul>
</section> <li><code>GET /recurso/id</code> &#8658; retorna as informações do elemento com identificador "id".</li>
<li><code>POST /recurso/id</code> &#8658; proibído, use <code>POST /recurso/</code> para criar elementos.</li>
<section> <li><code>PUT /recurso/id</code> &#8658; atualiza as informações do elemento.</li>
<ul> <li><code>DELETE /recurso/id</code> &#8658; remove o elemento com identificador "id".</li>
<li>Métodos HTTP = operação de banco de dados (CRUD).</li> </ul>
<li>Status das operações são status HTTP.</li>
<li>Meta-informações podem ser enviadas nos headers.
<ul>
<li>Atenticação é feita por HTTP auth.</li>
</ul>
</li>
<li>Sem transações/sessões -- todas as operações são atômicas.</li>
</ul>
</section>
<section>
Em HTTP, usam-se métodos para descrever o que quer ser feito:
<ul>
<li><code>POST</code> requisita informações, com conteúdo.</li>
<li><code>GET</code> requisita informações, sem conteúdo.</li>
</ul>
<p class='fragment'>(Ainda: PUT, DELETE, HEAD, TRACE, PATCH, OPTIONS)</p>
</section>
<section>
<p>
Em ReST, métodos HTTP viram CRUD:
</p>
<ul>
<li>Create &#8658; POST</li>
<li>Retrieve &#8658; GET</li>
<li>Update &#8658; PUT</li>
<li>Delete &#8658; DELETE</li>
<li class='fragment'>Update &#8658; PATCH</li>
</ul>
</section>
</section> </section>
<section> <section>
<section> <h3>Exemplos</h3>
<h2>Recursos</h2>
<img src='_images/jellybeans.jpg'></img> <ul>
</section> <li><code>GET /users/</code> &#8658; Retorna a lista de todos os usuários.</li>
<li><code>POST /users/</code> &#8658; Cria um novo usuário.</li>
<section> <br/>
<ul> <li><code>GET /users/1</code> &#8658; Retorna as informações do usuário com id "1".</li>
<li>Em ReST, as "tabelas" são chamadas "recursos".</li> <li><code>PUT /users/1</code> &#8658; Atualiza as informações do usuário "1".</li>
<li>Sempre substantivos no plural.</li> <li><code>DELETE /users/1</code> &#8658; Remove o usuário "1".</li>
<li>Duas URLs por recurso </ul>
<ul>
<li>Uma para o conjunto;</li>
<li>Uma para elementos específicos.</li>
</ul>
</li>
</ul>
</section>
<section>
<h3>URLs para o Recurso</h3>
<ul>
<li><code>GET /recurso/</code> &#8658; retorna todos os elementos do recurso.</li>
<li><code>POST /recurso/</code> &#8658; cria um novo elemento.</li>
<li><code>PUT /recurso/</code> &#8658; atualização em massa.</li>
<li><code>DELETE /recurso/</code> &#8658; remove todos os elementos do recurso.</li>
</ul>
</section>
<section>
<h3>URLs para o Elemento</h3>
<ul>
<li><code>GET /recurso/id</code> &#8658; retorna as informações do elemento com identificador "id".</li>
<li><code>POST /recurso/id</code> &#8658; proibído, use <code>POST /recurso/</code> para criar elementos.</li>
<li><code>PUT /recurso/id</code> &#8658; atualiza as informações do elemento.</li>
<li><code>DELETE /recurso/id</code> &#8658; remove o elemento com identificador "id".</li>
</ul>
</section>
<section>
<h3>Exemplos</h3>
<ul>
<li><code>GET /users/</code> &#8658; Retorna a lista de todos os usuários.</li>
<li><code>POST /users/</code> &#8658; Cria um novo usuário.</li>
<br/>
<li><code>GET /users/1</code> &#8658; Retorna as informações do usuário com id "1".</li>
<li><code>PUT /users/1</code> &#8658; Atualiza as informações do usuário "1".</li>
<li><code>DELETE /users/1</code> &#8658; Remove o usuário "1".</li>
</ul>
</section>
<section>
<h3>Requisições sem recursos</h3>
Requisições sem um recurso definido utilizam um verbo e GET:
<code>GET /covert/?source=BRL&amp;value=10&amp;target=AUD</code>
</section>
</section> </section>
<section> <section>
<section> <h3>Requisições sem recursos</h3>
<h2>Conteúdo</h2>
<img src='_images/content-strategy.jpg'></img> <p>Requisições sem um recurso definido utilizam um verbo e GET:</p>
</section>
<p><code>GET /covert/?source=BRL&amp;value=10&amp;target=AUD</code></p>
<section>
<p>Qualquer formato, ReST não define um específico.</p>
<ul>
<li>XML</li>
<li>JSON</li>
<li>HTML (www-form-encoded)</li>
<li>CNAB</li>
</ul>
<p>Fica a cargo da equipe decidir o melhor formato para a aplicação.</p>
</section>
</section> </section>
<section> <section>
<section> <h2>Conteúdo</h2>
<h2>Status</h2> <img src='_images/content-strategy.jpg'></img>
<img src='_images/RightWrongBlackboard.jpg'></img> </section>
</section>
<section> <section>
<p>São utilizados os status HTTP</p> <h3>Formato das respostas/requisições</h3>
<ul> <p>Qualquer formato, ReST não define um específico.</p>
<li>200 OK &#8658; operação concluída com sucesso.</li>
<li>400 Bad Request &#8658; algo errado com a requisição.</li>
<li>401 Unauthorized &#8658; o usuário informado não tem permissão para acessar o recurso.</li>
<li>403 Forbidden &#8658; precisa de autenticação e essa não foi informada.</li>
<li>404 Not Found &#8658; recurso ou elemento não existe.</li>
<li>405 Method Not Allowed &#8658; metódo inválido para recurso/elemento (p.ex. "POST" num elemento)</li>
</ul>
<p>E assim por diante...</p> <ul>
</section> <li>XML</li>
<li>JSON</li>
<li>HTML (www-form-encoded)</li>
<li>CNAB</li>
</ul>
<section> <p>Fica a cargo da equipe decidir o melhor formato para a aplicação.</p>
<p>Problema:</p> </section>
<p>ReST não define o que fazer em caso de conflito dos erros.</p> <section>
</section> <h2>Resultado das operações</h2>
<img src='_images/RightWrongBlackboard.jpg'></img>
</section>
<section> <section>
<p>Exemplo:</p> <p>São utilizados os status HTTP</p>
<p>Operação para adicionar um usuário à um grupo:</p> <ul>
<li>200 OK &#8658; operação concluída com sucesso.</li>
<li>400 Bad Request &#8658; algo errado com a requisição.</li>
<li>401 Unauthorized &#8658; o usuário informado não tem permissão para acessar o recurso.</li>
<li>403 Forbidden &#8658; precisa de autenticação e essa não foi informada.</li>
<li>404 Not Found &#8658; recurso ou elemento não existe.</li>
<li>405 Method Not Allowed &#8658; metódo inválido para recurso/elemento (p.ex. "POST" num elemento)</li>
</ul>
<ul> <p>E assim por diante...</p>
<li>404 se o grupo não existir;</li>
<li>Qual status a ser retornado quando o usuário não existe, neste caso?</li>
</ul>
<p>Normalmente é enviado um corpo junto com o erro.</p> <p class='fragment'>Entretanto...</p>
</section>
</section> </section>
<section> <section>
<section> <h3>Problema</h3>
<h2>Por que usar ReST?</h2>
<img src='_images/house-do-want_cut455_22k.jpg'></img> <p>ReST não define o que fazer em caso de conflito dos erros.</p>
</section> </section>
<section> <section>
<ul> <h3>Exemplo</h3>
<li>Reaproveita toda a estrutura HTTP existente.</li>
<li>HTTP praticamente padrão em todas as linguagens "na caixa". <p>Operação para adicionar um usuário à um grupo:</p>
<ul>
<li>(E, se não tiver, o protocolo é simples o suficiente para uma <ul>
implementação na hora.) <li>404 se o grupo não existir;</li>
</ul> <li>Qual status a ser retornado quando o usuário não existe, neste caso?</li>
</li> </ul>
<li>Dificilmente portas HTTP (80 e 443) são bloequeadas em proxies.</li>
<li>"Sintaxe" simples.</li> <p>Normalmente é enviado um corpo indicando o erro de forma mais completa,
</ul> ainda com status HTTP.</p>
</section> </section>
<section>
<h2>Por que usar ReST?</h2>
<img src='_images/house-do-want_cut455_22k.jpg'></img>
</section>
<section>
<ul>
<li>Reaproveita toda a estrutura HTTP existente.</li>
<li>HTTP praticamente padrão em todas as linguagens "na caixa".
<ul>
<li>(E, se não tiver, o protocolo é simples o suficiente para uma
implementação na hora.)
</ul>
</li>
<li>Dificilmente portas HTTP (80 e 443) são bloqueadas em proxies.</li>
<li>"Sintaxe" simples.</li>
</ul>
</section>
<section>
<h2>Por que não usar ReST?</h2>
<img src='_images/Luke-Derp.jpg'></img>
</section> </section>
<section> <section>
<section>
<h2>Por que não usar ReST?</h2>
<img src='_images/Luke-Derp.jpg'></img>
</section>
<section>
</section>
<section>
<ul>
<li>Segurança depende de terceiros (HTTPS).
<ul>
<li>Existem outras opções (OAuth, por exemplo), mas são complexas e não se parecem
com soluções HTTP.</li>
</ul>
</li>
<li>Não recomendado para dispositivos com processamento e memória
extremamente limitados.</li>
<li>Necessidade de sessões/transações.</li>
<li>Requisito não é um serviço.</li>
</ul>
</section>
<section></section>
</section> </section>
<section>
<ul>
<li>Segurança depende de terceiros (HTTPS).
<ul>
<li>Existem outras opções (OAuth, por exemplo), mas são complexas e não se parecem
com soluções HTTP.</li>
</ul>
</li>
<li>Não recomendado para dispositivos com processamento e memória
extremamente limitados.</li>
<li>Necessidade de sessões/transações.</li>
<li>Requisito não é um serviço.</li>
</ul>
</section>
<section></section>
<section data-background='_images/thats-all-folks.jpg'> <section data-background='_images/thats-all-folks.jpg'>
<section></section> <p></p>
</section>
<section class='semi-opaque'> <section class='semi-opaque' data-background='_images/thats-all-folks.jpg'>
<p><small>Perguntas?</small></p> <p><small>Perguntas?</small></p>
</section>
</section> </section>
</div> </div>
</div> </div>

Write Preview
Loading…
Cancel
Save