You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
461 lines
18 KiB
461 lines
18 KiB
<!doctype html> |
|
<html lang="en"> |
|
|
|
<head> |
|
<meta charset="utf-8"> |
|
|
|
<title>Entendendo DJANGO</title> |
|
|
|
<meta name="description" content="A framework for easily creating beautiful presentations using HTML"> |
|
<meta name="author" content="Hakim El Hattab"> |
|
|
|
<meta name="apple-mobile-web-app-capable" content="yes"> |
|
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent"> |
|
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, minimal-ui"> |
|
|
|
<link rel="stylesheet" href="reveal.js/css/reveal.css"> |
|
<link rel="stylesheet" href="reveal.js/css/theme/black.css" id="theme"> |
|
|
|
<!-- Code syntax highlighting --> |
|
<link rel="stylesheet" href="reveal.js/lib/css/zenburn.css"> |
|
|
|
<!-- Printing and PDF exports --> |
|
<script> |
|
var link = document.createElement( 'link' ); |
|
link.rel = 'stylesheet'; |
|
link.type = 'text/css'; |
|
link.href = window.location.search.match( /print-pdf/gi ) ? 'css/print/pdf.css' : 'reveal.js/css/print/paper.css'; |
|
document.getElementsByTagName( 'head' )[0].appendChild( link ); |
|
</script> |
|
|
|
<!--[if lt IE 9]> |
|
<script src="lib/js/html5shiv.js"></script> |
|
<![endif]--> |
|
|
|
<!-- personal styles --> |
|
<style> |
|
.semi-opaque { |
|
background-color: rgba(0, 0, 0, 0.7); |
|
} |
|
</style> |
|
</head> |
|
|
|
<body> |
|
<div class="reveal"> |
|
<div class="slides"> |
|
<section data-background='_images/django-rest.png' data-header> |
|
<h1 class='semi-opaque'>Entendendo Django REST Framework</h1> |
|
</section> |
|
|
|
<section> |
|
<section> |
|
<h2>Review Django</h2> |
|
|
|
<ul> |
|
<li>Request de um browser chega no Django;</li> |
|
<li>Consulta o urls.py base do projeto para encontrar o |
|
que será executado;</li> |
|
<li>Consulta o urls.py da app (no caso) para encontrar |
|
a view que será executada;</li> |
|
<li>Encontra a view dentro da app, que busca as informações no model;</li> |
|
<li>Renderiza o template;</li> |
|
<li>Retorna o template renderizado para o usuário.</li> |
|
</ul> |
|
</section> |
|
</section> |
|
|
|
<section> |
|
<section> |
|
<h2>Interlúdio: REST</h2> |
|
|
|
<img src="_images/intermission_3696.jpg" alt=""/> |
|
</section> |
|
|
|
<section> |
|
<h3>REST: Recursos</h3> |
|
|
|
<p>Elementos são chamados "recursos" e fazem parte da URL.</p> |
|
|
|
<ul> |
|
<li>Recurso <i>usuários</i>: <code>/user</code>;</li> |
|
<li>Recurso <i>orders</i>: <code>/order</code>;</li> |
|
<li>Recurso <i>produtos</i>: <code>/product</code></li> |
|
</ul> |
|
</section> |
|
|
|
<section> |
|
<h3>REST: Recursos</h3> |
|
|
|
<p>Recursos específicos são indicados também na URL depois |
|
da URL base do recurso, apontados por sua chave principal.</p> |
|
|
|
<ul> |
|
<li><i>Usuário</i> <strong>1</strong>: <code>/user/1/</code></li> |
|
<li><i>Produto</i> <strong>ws-1243</strong>: <code>/product/ws-1243/</code></li> |
|
</ul> |
|
</section> |
|
|
|
<section> |
|
<h3>REST: Recursos</h3> |
|
|
|
<p>Recursos podem estar aninhados.</p> |
|
|
|
<ul> |
|
<li><code>/user/1/order</code>: Todos os pedidos do usuário <strong>1</strong>.</li> |
|
<li><code>/user/1/order/2</code>: Pedido <strong>2</strong> do usuário <strong>1</strong>.</li> |
|
</ul> |
|
</section> |
|
|
|
<section> |
|
<h3>REST: Verbos/Ações</h3> |
|
|
|
<p>Ações sobre os recursos são indicadas pelo <i>verbo HTTP</i>:</p> |
|
|
|
<ul> |
|
<li><code>GET</code>: Recupera recursos;</li> |
|
<li><code>POST</code>: Cria recursos;</li> |
|
<li><code>PUT</code>: Altera (update) recursos;</li> |
|
<li><code>DELETE</code>: Apaga recursos;</li> |
|
<li><code>PATCH</code>: Altera recursos.</li> |
|
</ul> |
|
</section> |
|
|
|
<section> |
|
<h3>REST: Verbos</h3> |
|
|
|
<table border="0"> |
|
<tr> |
|
<th> </th> |
|
<th>Base recurso</th> |
|
<th>Recurso específico</th> |
|
</tr> |
|
|
|
<tr> |
|
<td><strong><code>GET</code></strong></td> |
|
<td>Todos os elementos do recurso</td> |
|
<td>Dados do recurso específico</td> |
|
</tr> |
|
</table> |
|
</section> |
|
|
|
<section> |
|
<h3>REST: Verbos</h3> |
|
|
|
<table border="0"> |
|
<tr> |
|
<th> </th> |
|
<th>Base recurso</th> |
|
<th>Recurso específico</th> |
|
</tr> |
|
|
|
<tr> |
|
<td><strong><code>POST</code></strong></td> |
|
<td>Cria um recurso novo</td> |
|
<td>Não usado, mas poderia criar um recurso com a cahve indicada</td> |
|
</tr> |
|
</table> |
|
</section> |
|
|
|
<section> |
|
<h3>REST: Verbos</h3> |
|
|
|
<table border="0"> |
|
<tr> |
|
<th> </th> |
|
<th>Base recurso</th> |
|
<th>Recurso específico</th> |
|
</tr> |
|
<tr> |
|
<td><strong><code>PUT</code></strong></td> |
|
<td>Não usado</td> |
|
<td>Ataliza o registro inteiro do recurso</td> |
|
</tr> |
|
</table> |
|
</section> |
|
|
|
<section> |
|
<h3>REST: Verbos</h3> |
|
|
|
<table border="0"> |
|
<tr> |
|
<th> </th> |
|
<th>Base recurso</th> |
|
<th>Recurso específico</th> |
|
</tr> |
|
|
|
<tr> |
|
<td><strong><code>DELETE</code></strong></td> |
|
<td>Não usado, mas poderia apagar todos os recursos</td> |
|
<td>Apaga o recurso</td> |
|
</tr> |
|
</table> |
|
</section> |
|
|
|
<section> |
|
<h3>REST: Verbos</h3> |
|
|
|
<table border="0"> |
|
<tr> |
|
<th> </th> |
|
<th>Base recurso</th> |
|
<th>Recurso específico</th> |
|
</tr> |
|
|
|
<tr> |
|
<td><strong><code>PATCH</code></strong></td> |
|
<td>Não usado</td> |
|
<td>Atualiza campos específicos do recurso</td> |
|
</tr> |
|
</table> |
|
</section> |
|
|
|
<section> |
|
<h3>REST: Exemplos</h3> |
|
|
|
<ul> |
|
<li><code>GET /user</code>: Retorna todos os usuários do sistema.</li> |
|
<li><code>POST /order</code>: Cria um novo pedido.</li> |
|
<li><code>DELETE /user/1/order/2</code>: Apaga o pedido 2 do usuário 1.</li> |
|
</ul> |
|
</section> |
|
</section> |
|
|
|
<section> |
|
<section> |
|
<h2>De volta ao REST Framework</h2> |
|
|
|
<img src="_images/tumblr_n6qbpoBDVX1rbyj0do1_500.jpg" alt=""/> |
|
</section> |
|
|
|
<section> |
|
<ul> |
|
<li>Request de um browser chega no Django;</li> |
|
<li>Consulta o urls.py base do projeto para encontrar o |
|
que será executado;</li> |
|
<li>Consulta o urls.py da app (no caso) <del>para encontrar |
|
a view que será executada</del>;</li> |
|
<li class="fragment">Continua acessando o urls.py do app, mas |
|
esse é complementado com Routers.</li> |
|
</ul> |
|
</section> |
|
|
|
<section> |
|
<h2>Routes</h2> |
|
<pre><code class="hljs"> |
|
router = DefaultRouter() |
|
router.register(r'base_resource', ModelViewSet) |
|
urlpatterns = router.urls |
|
</code></pre> |
|
|
|
<p>Onde:</p> |
|
|
|
<ul> |
|
<li><code>base_resource</code>: é a URL base de acesso ao recurso;</li> |
|
<li><code>ModelViewSet</code>: é um <i>ViewSet</i> criado em cima do modelo.</li> |
|
</ul> |
|
</section> |
|
|
|
<section> |
|
<h2>Por que "Routes"?</h2> |
|
|
|
<p>Para não precisar criar dois GETS, um POST, um PUT, |
|
um PATCH e um DELETE.</p> |
|
</section> |
|
|
|
<section> |
|
<h2>E o que diabos é um ViewSet?</h2> |
|
|
|
<p><i>ViewSet</i> define as funções para cada um dos verbos dentro do resource:</p> |
|
|
|
<ul> |
|
<li><code>list(self, request)</code></li> |
|
<li><code>create(self, request)</code></li> |
|
<li><code>retrieve(self, request, pk=None)</code></li> |
|
<li><code>update(self, request, pk=None)</code></li> |
|
<li><code>partial_update(self, request, pk=None)</code></li> |
|
<li><code>destroy(self, request, pk=None)</code></li> |
|
</ul> |
|
</section> |
|
|
|
<section> |
|
<h2>ModelViewSet</h2> |
|
|
|
<p>Um <i>ModelViewSet</i> aplica as funções acima sobre um Model.</p> |
|
|
|
<pre><code class="hljs"> |
|
class ProductViewSet(viewsets.ModelViewSet): |
|
queryset = Product.objects.all() |
|
serializer_class = ProductSerializer |
|
</code></pre> |
|
|
|
<p>Existe ainda <i>ReadOnlyModelViewSet</i> que só define as funções |
|
<code>list()</code> e <code>retrieve()</code>.</p> |
|
</section> |
|
|
|
<section> |
|
<h2>Pera, pera... Serializer?</h2> |
|
|
|
<p><i>Serializers</i> definem campos de resultados e sua validação, |
|
caso estejam sendo usados como entradas (assim como <i>Forms</i> |
|
são usados para validar entradas de dados por forms).</p> |
|
|
|
<pre><code class="hljs"> |
|
class UserSerializer(serializers.ModelSerializer): |
|
|
|
class Meta: |
|
model = Product |
|
fields = ('name', 'price') |
|
</code></pre> |
|
</section> |
|
</section> |
|
|
|
<section> |
|
<section> |
|
<h2>Fluxo REST Framework</h2> |
|
|
|
<ul> |
|
<li>Request de um browser chega no Django;</li> |
|
<li>Consulta o urls.py base do projeto para encontrar o |
|
que será executado;</li> |
|
<li>Consulta o urls.py da app (no caso) <del>para encontrar |
|
a view que será executada</del>;</li> |
|
<li>Continua acessando o urls.py do app, mas |
|
esse é complementado com Routers;</li> |
|
</ul> |
|
</section> |
|
|
|
<section> |
|
<h2>Fluxo REST Framework (contd.)</h2> |
|
|
|
<ul> |
|
<li>Acerta o Serializer para validar a entrada (se houver);</li> |
|
<li>Vai ou ViewModelSet para definr a execução;</li> |
|
<li>Faz os requests necessários para o model;</li> |
|
<li>Passa o resultado de novo pelo Serializer para converter para |
|
o formato de saída;</li> |
|
<li>Retorna o request.</li> |
|
</ul> |
|
</section> |
|
</section> |
|
|
|
<section> |
|
<section> |
|
<h2>PS: Outras coisas legais</h2> |
|
|
|
<p>Vem com um serializador JSON como padrão, mas existem outros:</p> |
|
|
|
<ul> |
|
<li><code>djangorestframework-yaml</code>: Serializador/desserializador para YAML.</li> |
|
<li><code>djangorestframework-xml</code>: Serializador/desserializador para XML.</li> |
|
</ul> |
|
</section> |
|
|
|
<section> |
|
<h2>JSON</h2> |
|
|
|
<pre><code class="hljs"> |
|
curl -H 'Accept: application/json; indent=4' \ |
|
-u admin:admin123 http://127.0.0.1:8000/users/ |
|
</code></pre> |
|
|
|
<pre><code class="hljs"> |
|
{ |
|
"count": 1, |
|
"next": null, |
|
"previous": null, |
|
"results": [ |
|
{ |
|
"url": "http://127.0.0.1:8000/users/1/", |
|
"username": "admin", |
|
"email": "", |
|
"groups": [] |
|
} |
|
] |
|
</code></pre> |
|
</section> |
|
|
|
<section> |
|
<h2>YAML</h2> |
|
|
|
<pre><code class="hljs"> |
|
curl -H 'Accept: application/yaml' \ |
|
-u admin:admin123 http://127.0.0.1:8000/users/ |
|
</code></pre> |
|
|
|
<pre><code class="hljs"> |
|
count: 1 |
|
next: null |
|
previous: null |
|
results: |
|
- email: '' |
|
groups: [] |
|
url: http://127.0.0.1:8000/users/1/ |
|
username: admin |
|
</code></pre> |
|
</section> |
|
|
|
<section> |
|
<h2>XML</h2> |
|
|
|
<pre><code class="hljs"> |
|
curl -H 'Accept: application/xml' \ |
|
-u jbiason:slowdown http://127.0.0.1:8000/users/ |
|
</code></pre> |
|
|
|
<pre><code class="hljs"> |
|
<?xml version="1.0" encoding="utf-8"?> |
|
<root> |
|
<count>1</count> |
|
<next></next> |
|
<previous></previous> |
|
<results> |
|
<list-item> |
|
<url>http://127.0.0.1:8000/users/1/</url> |
|
<username>admin</username> |
|
<email></email> |
|
<groups></groups> |
|
</list-item> |
|
</results> |
|
</root> |
|
</code></pre> |
|
</section> |
|
|
|
<section> |
|
<p>(Todos os casos, só foi alterado o header "Accept" no request; nenhuma |
|
alteração de código -- com exceção do settings.py para ativar os |
|
serializers.)</p> |
|
</section> |
|
</section> |
|
</div> |
|
</div> |
|
|
|
<script src="reveal.js/lib/js/head.min.js"></script> |
|
<script src="reveal.js/js/reveal.js"></script> |
|
|
|
<script> |
|
// Full list of configuration options available at: |
|
// https://github.com/hakimel/reveal.js#configuration |
|
Reveal.initialize({ |
|
controls: true, |
|
progress: true, |
|
history: true, |
|
center: true, |
|
|
|
transition: 'slide', // none/fade/slide/convex/concave/zoom |
|
|
|
// Optional reveal.js plugins |
|
dependencies: [ |
|
{ src: 'lib/js/classList.js', condition: function() { return !document.body.classList; } }, |
|
{ src: 'plugin/markdown/marked.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } }, |
|
{ src: 'plugin/markdown/markdown.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } }, |
|
{ src: 'reveal.js/plugin/highlight/highlight.js', async: true, callback: function() { hljs.configure({languages: ['python']}); hljs.initHighlightingOnLoad(); } }, |
|
{ src: 'reveal.js/plugin/zoom-js/zoom.js', async: true }, |
|
{ src: 'reveal.js/plugin/notes/notes.js', async: true } |
|
] |
|
}); |
|
|
|
</script> |
|
|
|
</body> |
|
</html>
|
|
|