<!doctype html>
<html lang="en">

	<head>
		<meta charset="utf-8">

		<title>ReST - Restructured State Transfer</title>

		<meta name="author" content="Julio Biason">

		<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">

		<link rel="stylesheet" href="_external/reveal.min.css">
		<link rel="stylesheet" href="_external/default.css" id="theme">

		<!-- For syntax highlighting -->
		<link rel="stylesheet" href="_external/zenburn.css">

		<!-- If the query includes 'print-pdf', include the PDF print sheet -->
		<script>
			if( window.location.search.match( /print-pdf/gi ) ) {
				var link = document.createElement( 'link' );
				link.rel = 'stylesheet';
				link.type = 'text/css';
				link.href = '_external/pdf.css';
				document.getElementsByTagName( 'head' )[0].appendChild( link );
			}
		</script>

		<!--[if lt IE 9]>
		<script src="reveal.js/lib/js/html5shiv.js"></script>
		<![endif]-->

		<style>
img {
	height: 400px;
}

.semi-opaque {
	background-color: rgba(0, 0, 0, 0.7);
}

* {
	hyphens: none !important;
	-moz-hyphens: none !important;
}
		</style>
	</head>

	<body>

		<div class="reveal">
			<div class="slides">
				<section data-background='_images/Seascapeshd.png' class='semi-opaque' data-header>
					<h1>ReST</h1>
					<h4>Restructured State Transfer</h4>
				</section>

				<section>
					<ul>
						<li>Criado por Roy Fielding em 2000.</li>
						<li>Fielding trabalhou na definição do HTTP e no início do projeto Apache.</li>
					</ul>
				</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>
					<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>

					<p>Requisições sem um recurso definido utilizam um verbo e GET:</p>

					<p><code>GET /convert/?source=BRL&amp;value=10&amp;target=AUD</code></p>
				</section>

				<section>
					<h2>Conteúdo</h2>
					<img src='_images/content-strategy.jpg'></img>
				</section>

				<section>
					<h3>Formato das respostas/requisições</h3>

					<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>
					<h2>Resultado das operações</h2>
					<img src='_images/RightWrongBlackboard.jpg'></img>
				</section>

				<section>
					<p>São utilizados os status HTTP</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>

					<p>E assim por diante...</p>

					<p class='fragment'>Entretanto...</p>
				</section>

				<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>

				<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'>
					<p></p>
				</section>

				<section class='semi-opaque' data-background='_images/thats-all-folks.jpg'>
					<p><small>Perguntas?</small></p>
				</section>
			</div>
		</div>

		<script src="_external/head.min.js"></script>
		<script src="_external/reveal.min.js"></script>

		<script>

			// Full list of configuration options available here:
			// https://github.com/hakimel/reveal.js#configuration
			Reveal.initialize({
				controls: true,
				progress: true,
				history: true,
				center: true,

				theme: 'night',
				transition: 'linear',

				// Parallax scrolling
				// parallaxBackgroundImage: 'https://s3.amazonaws.com/hakim-static/reveal-js/reveal-parallax-1.jpg',
				// parallaxBackgroundSize: '2100px 900px',

				// Optional libraries used to extend on reveal.js
				dependencies: [
					{ src: '_external/classList.js', condition: function() { return !document.body.classList; } },
					{ src: '_external/marked.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } },
					{ src: '_external/markdown.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } },
					{ src: '_external/highlight.js', async: true, callback: function() { hljs.initHighlightingOnLoad(); } },
					{ src: '_external/zoom.js', async: true, condition: function() { return !!document.body.classList; } },
					{ src: '_external/notes.js', async: true, condition: function() { return !!document.body.classList; } }
				]
			});

		</script>

	</body>
</html>