more django rest

django-rest.html

@@ -227,7 +227,179 @@
 
                         <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">
+{
+    "count": 1,
+    "next": null,
+    "previous": null,
+    "results": [
+        {
+            "url": "http://127.0.0.1:8000/users/1/",
+            "username": "jbiason",
+            "email": "",
+            "groups": []
+        }
+    ]
+						</code></pre>
+					</section>
+
+					<section>
+						<h2>YAML</h2>
+
+						<pre><code class="hljs">
+count: 1
+next: null
+previous: null
+results:
+- email: ''
+  groups: []
+  url: http://127.0.0.1:8000/users/1/
+  username: jbiason
+						</code></pre>
+					</section>
+
+					<section>
+						<h2>XML</h2>
+
+						<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>jbiason</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>