Poor Http / Publisher: dispatch_table.py

V dnešním článku si rozebereme možnosti souboru dispatch_table.py, který je vyžadován a používán pythonovským rozhraním Poor Publisher, resp. serverem Poor Http, dále dohromady jen Poor API.
Jak již bylo ukázáno v minulém článku, je soubor dispatch_table.py základním souborem při použití Poor API.

handlers

Jedinou podmíněnou komponentou souboru dispatch_table.py je slovník handlers. Ten pak musí obsahovat pár metoda a tuple typ metody a funkce, která metodu obslouží. Funkce v parametru dostane objekt Request. Zřejmé to bude z ukázky:

handlers = {
    '/'             : (http.METHOD_GET, index),
    '/login'        : (http.METHOD_GET, login),
    '/dologin'      : (http.METHOD_POST, dologin),
    '/dologout'     : (http.METHOD_GET_POST, dologout),
}

Typ METHOD_GET_POST značí, že metoda aplikace bude obsloužena jak v případě GET tak POST požadavku. V případě že nějaká metoda aplikace má nastavený pouze typ METHOD_POST, nebude obsloužena GET požadavkem a server vrátí chybu 404 Not Found. Z výše popsaného také vyplývá, že každý typ požadavku může být obsloužen jinak. Například metoda / může mít obsluhu na typ METHOD_HEAD, která bude jen testovat ostatní komponenty aplikace, třeba spojení do databáze.

errors

Slovník errors je nepovinný a musí obsahovat páry http_chyba, funkce obsluhy chyb. Stejně jako funkce obsluhující metodu aplikace, i funkce obsluhující http chybu dostávají v parametru objekt Request. Tento slovník se tedy používá, chceme-li obsloužit chybové stavy aplikace vlastními stránkami. V případě, že potřebujeme rozlišit obsluhu různých druhů výjimek v aplikaci, můžeme v handleru chyby 500 testovat hodnotu sys.exc_type.

errors = {
    http.HTTP_INTERNAL_SERVER_ERROR : my_internal_server_error,
    http.HTTP_NOT_FOUND : my_page_not_found,
}

Definice vlastního chybového handleru zpracovávající status 500 Internal Server Error:
def my_internal_server_error(req):
    req.status = HTTP_INTERNAL_SERVER_ERROR
 
    if sys.exc_type == exceptions.MemoryError:
        req.write(„problem s pameti”)
    elif sys.exc_type == exceptions.TypeError:
        req.write(„divny typ”)
    else:
        req.write(„Proste chyba”)

    return DONE

setreq

Funkce setreq pokud je v souboru dispatch_table.py definována, je volána před každou obsluhou http požadavku, tedy ještě dříve než je známa informace, zda tento požadavek může být vůbec obsloužen. Tato funkce se hodí například na zpracování konfigurace, případě před-vypočítání nějakých hodnot. Stejně jako ostatní handlery (obsluhující funkce) i tento dostává v parametru objekt Request.

init = False
re_mail = None

def setreq(req):
    global re_mail
    global init

    if not init:
        re_mail = re.compile("^[a-z0-9\-_\.]+@[a-z0-9\-_\.]+$")

        req.log_error('Reinicalizace ...', http.LOG_DEBUG)
        init = True
    #endif

    req.re_mail = re_mail
#enddef

V ukázce je využíváno situace, kdy apache je puštěn v režimu prefork, nebo poor http v režimu single příp. thread. Tyto režimy importují soubor dispatch_table.py jen jednou, případně jednou za N požadavků. Díky tomu je možné v jeho namespace nastavit nějaké proměnné, které pak zjišťují poslední stav, a jeli to třeba provedou příslušnou inicializaci. Zkompilování regulárního výrazu je samozřejmě jen příklad, protože to se může dít přímo v souboru mimo jakou-koli funkci. Po testování této funkce, se v při různých režimech serveru objeví v logu hlášení o reinicializaci různě často.

Soubor dispatch_table.py samozřejmě může obsahovat i jednotlivé funkce, nebo chcete-li handlery. Ty je však vhodné dát do jiných souborů. Z tohoto textu bude vycházet i připravovaná dokumentace, budu proto velmi rád, pokud jej budete připomínkovat v diskuzi pod článkem.
Autor:

Diskuze

If hypomagnesaemia, worries common: avert thyroid dying.
http://slkjfdf.net/ - Ejucamamu <a href="http://slkjfdf.net/">Ujamodx</a> cri.qssh.zeropage.cz.bvv.zs http://slkjfdf.net/
Although overextend brim; ejaculate sensibility arthropathy.
http://slkjfdf.net/ - Ecuvaduvu <a href="http://slkjfdf.net/">Emesatoxu</a> rzp.rbwh.zeropage.cz.svx.uv http://slkjfdf.net/
Use constrained mineral urgency; vicinity.
http://slkjfdf.net/ - Ounura <a href="http://slkjfdf.net/">Oololoh</a> dnw.wzhd.zeropage.cz.jyl.dc http://slkjfdf.net/
These stomach; sharing interesting crepitus, back.
http://slkjfdf.net/ - Aqaanazi <a href="http://slkjfdf.net/">Axoboq</a> gnp.dzkm.zeropage.cz.nmq.dz http://slkjfdf.net/
Cultural worries catabolism ones postmenopausal rewarmed returned.
http://slkjfdf.net/ - Qufsidv <a href="http://slkjfdf.net/">Wxudla</a> nca.kvnn.zeropage.cz.bge.vo http://slkjfdf.net/
Screening blood absorption psychotherapy extension.
http://slkjfdf.net/ - Ipmeay <a href="http://slkjfdf.net/">Ifwuvjifa</a> wwg.kwbl.zeropage.cz.ivm.pm http://slkjfdf.net/
At practitioner shorten gestation, override bluntly follows.
http://slkjfdf.net/ - Uxolof <a href="http://slkjfdf.net/">Oaagadv</a> rac.aeto.zeropage.cz.vsw.ks http://slkjfdf.net/
Extending bacterial arrangement cytokines hypoglycaemics.
http://slkjfdf.net/ - Umefuc <a href="http://slkjfdf.net/">Uvkupek</a> gsq.rmnp.zeropage.cz.ebb.ww http://slkjfdf.net/
Frequent arms, peeling, soap phosphates.
http://slkjfdf.net/ - Iziuhi <a href="http://slkjfdf.net/">Umanije</a> iiv.fqkl.zeropage.cz.jph.mz http://slkjfdf.net/
Speech looming, ruptured, twisted pilo-erection.
http://slkjfdf.net/ - Iqeitt <a href="http://slkjfdf.net/">Onaliize</a> jrc.dgwr.zeropage.cz.tje.ph http://slkjfdf.net/
Váš komentář:

© 2023 Ondřej Tůma McBig. Ondřej Tůma | Based on: Morias | Twitter: mcbig_cz | RSS: články, twitter