ARCHIV

Poor Http / Publisher: metody aplikace

V minulém článku jsem se věnoval rozdělení a popsání aplikačních metod. V tomto článku pak ukážu jak takové metody mohou vypadat pod pokličkou. Použiji jazyk python a rozhraní webového serveru Poor Http, které je kompatibilní s modulem serveru Apache, mod_python pomocí nadstavby Poor Publisher.

17.7.2011 10:00 | Ondřej Tůma | Články autora | přečteno 7569×

Metoda lomítko - homepage

O deklaraci dostupných metod, resp. přiřazení handlerů se stará soubor dispatch_table.py popsaný ve starším článku. Parametr obslužné funkce (handleru) je objekt Request. Ten je popsán v dokumentaci mod_pythonu nebo v dokumentaci poor_http. Poor Http se snaží být kompatibilní a tak případné chybějící metody a vlastnosti objektu budou na podněty uživatelů doplněny. Funkce obsluhující požadavek má tyto tři základní úkoly:

Nastavit hlavičky a správný content_type. V hlavičkách se skrývá celá řada užitečných informací, které zpracovává klient, tedy browser. Ty nejčastěji používané jsou například cookie, pomocí něž se identifikuje přihlášení uživatele. Mohou zde být například i další speciální hodnoty, informace pro proxy servery atd.

Vygenerovat datový obsah, který je společně s odpovědí vrácen http klientu (browseru). V případě ui metod to budou zejména html stránky, doplněné o data z databází atd. Tento výstup je možné provést různými způsoby, nejčastěji to bude ale pomocí metody write, která se volá obdobně jako metoda write objektu File. Data ja možné posílat jak binární, tak textová. Před tím než se začnou zapisovat data, je důležité nastavit právě hlavičku a správný content_type, poté, to již nebude možné.

Vrátit správnou návratovou hodnotu, případně skončit svojí činnost vyvoláním správné výjimky. Funkce by měla vracet hodnotu http.DONE, případně http.OK. Server Apache ještě tyto dvě metody rozeznává a v případě http.OK, resp apache.OK je možné, že výstup bude dále zpracován. Funkci je možné korektně ukončit pomocí výjimky SERVER_RETURN s parametrem http statusu. Díky tomu je možné vyvolat korektní http chybu a o nic dalšího se nestarat. Ve všech ostatních případech dojde k neočekávanému chování, které bude ukončeno chybou 500 Internal Server Error.


def light(req):
   if False:
       # k toto chybe nastesti nikdy nedojde
       raise SERVER_RETURN, http.HTTP_NOT_ACCEPTABLE

   req.content_type = "text/html"                            # nastavi content_type
   req.headers_out.add("X-My-Info", "Moje vlastni hlavicka") # nastavi hlavicku

   html = [
       "<html>",
       "  <head>",
       "    <title>Jednoduchy priklad</title>",
       "  </head>",
       "  <body>",
       "     <h1>Toto je jednoduchy priklad metody lomitko</h1>",
       "     <p>Ahoj, tato stranka obsahuje velmi jednoduchy html kod.",
       "     Dnes je <code>%s</code> a je " % strftime("%Y-%m-%d"),
       "       <code>%s</code>." % strftime("%H:%M:%S"),
       "     </p>",
       "     Dekujeme za navstevu.",
       "   </body>",
       "</html>",
   ]
   for line in html:
       req.write(line + '\n')     # vystup html kodu
   return http.DONE               # korektni ukonceni

Error handler

Obdobně jako lze definovat funkci, která se postará o obsluhu metody aplikace, lze definovat i funkci, která se stará o obsluhu http chyby, resp. http statusu jiného než 200 Ok. Rozdíl je především v tom, že taková funkce má navíc za úkol nastavit správný http kód, na který bude browser správně reagovat.


def forbidden(req):
   content = \
       "<html>\n"\
       "  <head>\n"\
       "    <title>403 - Pristup odepren</title>\n"\
       "    <style>\n"\
       "      body {width: 80%%; margin: auto; padding-top: 30px;}\n"\
       "      h1 {text-align: center; color: #ff0000;}\n"\
       "      p {text-indent: 30px; margin-top: 30px; margin-bottom: 30px;}\n"\
       "    </style>\n"\
       "  <head>\n" \
       "  <body>\n"\
       "    <h1>403 - Pristup odepren</h1>\n"\
       "    <p>Nemate prava k pristupu k <code>%s</code> na tomto serveru.</p>\n"\
       "  </body>\n"\
       "</html>" % req.uri       

   req.content_type = "text/html"            # nastavi content type
   req.status = HTTP_FORBIDDEN               # nastavi status kod
   req.write(content)
   return DONE

Datový vstup

Každá z metod aplikací samozřejmě může zpracovávat uživatelský vstup, a to odeslaný jak GET tak POST formou. O ten se v jazyku python stará třída FieldStorage. Poor Http resp. Poor Publisher tuto třídu sjednocuje a tak je její použití shodné. Stačí tuto třídu vytvořit s příslušnými parametry a volat patřičné metody. Jedna ze základních se jmenuje getfirst a Poor Api ji rozšiřuje o funkci, která je volána nad získanou metodou.


    form = FieldStorage(req, keep_blank_values = True)
    nick = form.getfirst(‚nick‘, ‚anonym‘, str)
    message = form.getfirst(‚message‘, ‚‘, str)
    age = form.getfirst(‚age‘, 0, int)

Toho může být využito například při získávání číselné hodnoty, nebo získání správného typu stringu (Apache vrací string ve vlastní třídě, to pak může působit problémy).

Příště

V dalším článku věnovaném webové službě napsané v jazyku python ukážu jak naprogramovat tzv. sezení. To budeme vytvářet pomocí samonosné cookie, která je v Poor Api definovaná třídou PoorSession.

Verze pro tisk


DISKUZE Nejsou žádné diskuzní příspěvky u dané položky. Příspívat do diskuze mohou pouze registrovaní uživatelé.

Vyhledávání software

Vyhledávání článků

Rozšířené vyhledávání

Linux News

28.11.2018 23:56 /František Kučera
Prosincový sraz spolku OpenAlt se koná ve středu 5.12.2018 od 16:00 na adrese Zikova 1903/4, Praha 6. Tentokrát navštívíme organizaci CESNET. Na programu jsou dvě přednášky: Distribuované úložiště Ceph (Michal Strnad) a Plně šifrovaný disk na moderním systému (Ondřej Caletka). Následně se přesuneme do některé z nedalekých restaurací, kde budeme pokračovat v diskusi.
Komentářů: 1

12.11.2018 21:28 /Redakce Linuxsoft.cz
22. listopadu 2018 se koná v Praze na Karlově náměstí již pátý ročník konference s tématem Datová centra pro business, která nabídne odpovědi na aktuální a často řešené otázky: Jaké jsou aktuální trendy v oblasti datových center a jak je optimálně využít pro vlastní prospěch? Jak si zajistit odpovídající služby datových center? Podle jakých kritérií vybírat dodavatele služeb? Jak volit vhodné součásti infrastruktury při budování či rozšiřování vlastního datového centra? Jak efektivně datové centrum spravovat? Jak co nejlépe eliminovat možná rizika? apod. Příznivci LinuxSoftu mohou při registraci uplatnit kód LIN350, který jim přinese zvýhodněné vstupné s 50% slevou.
Přidat komentář

6.11.2018 2:04 /František Kučera
Říjnový pražský sraz spolku OpenAlt se koná v listopadu – již tento čtvrtek – 8. 11. 2018 od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5). Tentokrát bez oficiální přednášky, ale zato s dobrým jídlem a pivem – volná diskuse na téma umění a technologie, IoT, CNC, svobodný software, hardware a další hračky.
Přidat komentář

4.10.2018 21:30 /Ondřej Čečák
LinuxDays 2018 již tento víkend, registrace je otevřená.
Přidat komentář

18.9.2018 23:30 /František Kučera
Zářijový pražský sraz spolku OpenAlt se koná již tento čtvrtek – 20. 9. 2018 od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5). Tentokrát bez oficiální přednášky, ale zato s dobrým jídlem a pivem – volná diskuse na téma IoT, CNC, svobodný software, hardware a další hračky.
Přidat komentář

9.9.2018 14:15 /Redakce Linuxsoft.cz
20.9.2018 proběhne v pražském Kongresovém centru Vavruška konference Mobilní řešení pro business. Návštěvníci si vyslechnou mimo jiné přednášky na témata: Nejdůležitější aktuální trendy v oblasti mobilních technologií, správa a zabezpečení mobilních zařízení ve firmách, jak mobilně přistupovat k informačnímu systému firmy, kdy se vyplatí používat odolná mobilní zařízení nebo jak zabezpečit mobilní komunikaci.
Přidat komentář

12.8.2018 16:58 /František Kučera
Srpnový pražský sraz spolku OpenAlt se koná ve čtvrtek – 16. 8. 2018 od 19:00 v Kavárně Ideál (Sázavská 30, Praha), kde máme rezervovaný salonek. Tentokrát jsou tématem srazu databáze prezentaci svého projektu si pro nás připravil Standa Dzik. Dále bude prostor, abychom probrali nápady na využití IoT a sítě The Things Network, případně další témata.
Přidat komentář

16.7.2018 1:05 /František Kučera
Červencový pražský sraz spolku OpenAlt se koná již tento čtvrtek – 19. 7. 2018 od 18:00 v Kavárně Ideál (Sázavská 30, Praha), kde máme rezervovaný salonek. Tentokrát bude přednáška na téma: automatizační nástroj Ansible, kterou si připravil Martin Vicián.
Přidat komentář

Více ... Přidat zprávičku

Poslední diskuze

31.7.2023 14:13 / Linda Graham
iPhone Services

30.11.2022 9:32 / Kyle McDermott
Hosting download unavailable

13.12.2018 10:57 / Jan Mareš
Re: zavináč

2.12.2018 23:56 / František Kučera
Sraz

5.10.2018 17:12 / Jakub Kuljovsky
Re: Jaký kurz a software by jste doporučili pro začínajcího kodéra?

Více ...

ISSN 1801-3805 | Provozovatel: Pavel Kysilka, IČ: 72868490 (2003-2024) | mail at linuxsoft dot cz | Design: www.megadesign.cz | Textová verze