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 10 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
Split 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>
</section>
<section> <!-- data-background="_images/l-What-is-this-sorcery.jpg"> -->
<section>
<h2>O que é ReST?</h2>
<img src='_images/l-What-is-this-sorcery.jpg'></img>
</section>
<section>
<p>
É uma "arquitetura" de transmissão de dados sobre HTTP.
</p>
<p>
("Conjunto de idéias para utilizar HTTP para geração de APIs.")
</p>
</section>
<section>
<p>
Linguagem? Qualquer!
</p>
<ul>
<li>Python: Flask, Django, Flask-Restless, Django Rest Framework</li>
<li>Ruby: Ruby on Rails, Sinatra</li>
<li>Java: Spring, Restlet, Jersey</li>
<li>C#: Ramone</li>
<li>Nodejs: Express</li>
<li>Rust: Rustful</li>
</dl>
</section>
<section>
<h2>O que é ReST?</h2>
<img src='_images/l-What-is-this-sorcery.jpg'></img>
</section>
<section>
<p>É uma "arquitetura" de transmissão de dados sobre HTTP.</p>
<p>("Conjunto de idéias para utilizar HTTP para geração de APIs.")</p>
</section>
<section>
<p>Linguagem? Qualquer!</p>
<ul>
<li>Python: Flask, Django, Flask-Restless, Django Rest Framework</li>
<li>Ruby: Ruby on Rails, Sinatra</li>
<li>Java: Spring, Restlet, Jersey</li>
<li>C#: Ramone</li>
<li>Nodejs: Express</li>
<li>Rust: Rustful</li>
</dl>
</section>
<section>
<h2>ReST e HTTP</h2>
<img src='_images/20090504102402_dsc_2864 (1).jpg'></img>
</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>
<h2>ReST e HTTP</h2>
<img src='_images/20090504102402_dsc_2864 (1).jpg'></img>
</section>
<section>
<ul>
<li>Métodos HTTP = operação de banco de dados (CRUD).</li>
<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>
<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>
<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>
<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>
<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>
<section>
<h2>Conteúdo</h2>
<img src='_images/content-strategy.jpg'></img>
</section>
<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>
<h3>Requisições sem recursos</h3>
<p>Requisições sem um recurso definido utilizam um verbo e GET:</p>
<p><code>GET /covert/?source=BRL&amp;value=10&amp;target=AUD</code></p>
</section>
<section>
<section>
<h2>Status</h2>
<img src='_images/RightWrongBlackboard.jpg'></img>
</section>
<h2>Conteúdo</h2>
<img src='_images/content-strategy.jpg'></img>
</section>
<section>
<p>São utilizados os status HTTP</p>
<section>
<h3>Formato das respostas/requisições</h3>
<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>
<p>Qualquer formato, ReST não define um específico.</p>
<p>E assim por diante...</p>
</section>
<ul>
<li>XML</li>
<li>JSON</li>
<li>HTML (www-form-encoded)</li>
<li>CNAB</li>
</ul>
<section>
<p>Problema:</p>
<p>Fica a cargo da equipe decidir o melhor formato para a aplicação.</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>
<p>Exemplo:</p>
<section>
<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>
<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>E assim por diante...</p>
<p>Normalmente é enviado um corpo junto com o erro.</p>
</section>
<p class='fragment'>Entretanto...</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 bloequeadas em proxies.</li>
<li>"Sintaxe" simples.</li>
</ul>
</section>
<h3>Problema</h3>
<p>ReST não define o que fazer em caso de conflito dos erros.</p>
</section>
<section>
<h3>Exemplo</h3>
<p>Operação para adicionar um usuário à um grupo:</p>
<ul>
<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 indicando o erro de forma mais completa,
ainda com status HTTP.</p>
</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>
<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>
<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></section>
<p></p>
</section>
<section class='semi-opaque'>
<p><small>Perguntas?</small></p>
</section>
<section class='semi-opaque' data-background='_images/thats-all-folks.jpg'>
<p><small>Perguntas?</small></p>
</section>
</div>
</div>

Write Preview
Loading…
Cancel
Save