<style type="text/css" media="all">@import "softeu-slides/css/tisk.css";</style></head><body id="prez-softeu-cz" onload="init_all()"><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Obsah</h3><div>. </div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Omluva</h3><div>. <ul xmlns=""> <li>Dlouho jsem přemýšlel, jak postavit tuto přednášku. Technické detaily si můžete najít sami (a budeme je publikovat). Chci proto mluvit o motivacích, přínosech a výhodách tohoto řešení)</li> <li>Budu mluvit moc o WinStromu: chceme ukázat tok našich myšlenek, naše požadavky a ukázat jak jsme to udělali</li> <li>Vymyslím si případně jiné jméno</li> <li>O WinStromu se snažíme mezi vývojáři komunikovat: Proč PostgreSQL, Pod pokličkou, REST API</li> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Proč API?</h3><div>. <ul xmlns=""> <li>Kdo jste řešili eshop, plánovací systém, museli jste řešit i sklady, fakturaci, platby, DPH, ... <ul> <li>Objednávky a sklady: eshop, optimalizace, ...</li> <li>Platby: import z banky, úhrady, částečné úhrady, zápočty faktur, ...</li> <li>DPH: generování daňového přiznání, ...</li> </ul> </li> <li>Synchronní: potřebujete mít možnost provést rychle nějakou operaci <ul> <li>vytvořit fakturu</li> <li>poslat ji e-mailem nebo nechat stáhnout uživatelem</li> <li>zobrazit seznam neuhrazených faktur</li> </ul> </li> <li>Asynchronní: potřebujete kvůli např. výkonnosti či spolehlivosti (a nebo máte více dat) držet duplicitně u sebe <ul> <li>výměna dat</li> <li>eshop (katalog, množství na skladě, objednávky)</li> <li>např. i kvůli výkonnu</li> </ul> </li> <li>Navrhovali jsme rozhraní tak, aby se líbilo mně (a Honzovi Novotnému a dalším lidem)</li> <li>Kdybych ho měl před lety</li> <li>datový model účetnictví je hrozně složitý (částečné úhrady, zápočty, zálohové doklady, ...) <ul> <li>datový model musí být zjednoduššený, srozumitelný a jasný</li> <li>zdokumentovaný</li> <li>stabilní</li> <li>Pravidlo: čemu nerozumíš, to nepotřebuješ (číslo faktury, příjemce, částka, proto typ dokladu)</li> </ul> </li> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Požadavky na API</h3><div>. <ul xmlns=""> <li>umožnit síťový přístup k rozhraní (server, lokální instalace),</li> <li>jeho funkčnost napříč podporovanými operačními systémy (Windows, Linux a Mac OS X),</li> <li>možnost volání z různých programovacích jazyků.</li> <li>základem bude XML, které: <ul> <li>Když to schrnu, tak toto API je primárně dokumentově orientované: faktura, objednávka</li> <li>umožní dávkový přenos dat (import a export všech dat - např. do stejné firmy)</li> <li>výměna dat mezi partnery (ceník)</li> <li>aktualizace záznamů</li> <li>čtení záznamů</li> </ul> </li> <li>HTTP je takové univerzální API, jako příkazová řádka</li> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Co používá konkurence</h3><div>. <ul xmlns=""> <li>COM/DCOM/Active X/OLE: jen Windows</li> <li>Pouštění z příkazové řádky: zajímvé řešení, ale není síťové, vyžaduje instalaci</li> <li>RMI: jen z Javy</li> <li>WebServices (SOAP): Zajímavé. Na můj vkus není jednoduché. SOA is Dead, REST is the future.</li> <li>REST API</li> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Proč REST API</h3><div>. <ul xmlns=""> <li>Velmi jednoduché</li> <li>Mohu odkázat přímo na data</li> <li>Mohu ze všech jazyků</li> <li>Ladící nástroj je prohlížeč</li> <li>Rovnou jsme získali i webový přístup</li> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Proč REST API 2</h3><div>. <ul xmlns=""> <li/> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Proč REST API: Založení nové faktury</h3><div>. <ul xmlns=""> <li/> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Struktura URL</h3><div>. <ul xmlns=""> <li>POST nepoužíváme, kvůli CSRF. Používáme je jen pro uživatelský přístup</li> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Výstupní formáty</h3><div>. <ul xmlns=""> <li>automatická detekce formátu</li> <li>XML a JSON: XMLStreamWriter a nadstavba kvůli polím</li> <li>Možnost exportu do kalendáře (a díky filtraci umíme třeba export )</li> <li>Volba je dle URL (.xml) nebo pomocí accept</li> <li>Prohlížeče posílají Accept: */* nebo Accept: application/xml a myslí XHTML</li> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Identifikace objektů</h3><div>. <ul xmlns=""> <li>Identifikátor lze použít jako součást URL, jako filtr, tak i jako součást XML dokumentu</li> <li>URL jsou stabilní, lze tedy odkazovat</li> <li>Není nutné mít extra mapování mezi systémy</li> <li>Kvůli duplicitnímu obsahu dochází k přesměrování</li> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Výpis faktur</h3><div>. </div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Aktualizace a validace</h3><div>. <ul xmlns=""> <li>Popovídat o validaci a ExtJS</li> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Zvyklosti v REST API</h3><div>. <ul xmlns=""> <li>Máme přímou podporu pro ExtJS</li> <li>ExtJS používá pro řazení něco, Ruby něco jiného</li> <li>my řešíme filtraci jinak než Ruby</li> , <li>Ruby má faktura a fakturas</li> <li>mode=ruby</li> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Automatická dokumentace</h3><div>. <ul xmlns=""> <li/> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Stabilní rozhraní</h3><div>. <ul xmlns=""> <li>Vyplňujte jen to, čemu rozumíte.</li> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Bezpečnost</h3><div>. <ul xmlns=""> <li>Potřebujeme dát přístup pro Google Kalendář</li> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>JAX-RS (Jersey)</h3><div>. <ul xmlns=""> <li/> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Resource</h3><div>. <ul xmlns=""> <li/> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Parametry</h3><div>. <ul xmlns=""> <li/> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Sub-resources</h3><div>. <ul xmlns=""> <li/> </ul></div></div><br clear="all"/><div class="ls-content"><hr style="height:1px; border:1px solid #009;"/><h3>Závěr</h3><div>. <para xmlns=""/></div></div><br clear="all"/></body></html>