11.5.1 Oggetti Request

I seguenti metodi descrivono tutto delle interfacce pubbliche Request, e tutte devono essere sovrascritte in sotto classi.

add_data( data): Imposta i dati di Request a data. Questo � ignorato da tutti gli handler eccezion fatta per gli handler HTTP; ci dovrebbe essere anche un buffer application/x-www-form-encoded, e la richiesta sar� cambiata in POST piuttosto che GET.

get_method( ): Restituisce una stringa che indica il metodo di richiesta HTTP. Questo � significativo solo per le richieste HTTP, e correntemente accetta solamente uno dei valori ("GET", "POST").

add_header( key, val): Aggiunge un'altra intestazione header alla richiesta. Le intestazioni vengono attualmente ignorate da tutti gli handler, fatta eccezione per quelli HTTP, dove vengono aggiunti alla lista delle intestazioni inviate al server. Notare che non ci pu� essere pi� di un'intestazione con lo stesso nome, e le chiamate successive sovrascriveranno le precedenti chiamati nel caso che key sia la stessa. Attualmente non ci sono perdite di funzionalit� HTTP, finch� tutte le intestazioni che hanno un significato quando vengono usate pi� di una volta hanno (un'intestazione specifica) modo di mantenere la stessa funzionalit� usando una sola intestazione.

add_unredirected_header( key, header): Aggiunge un'intestazione che non verr� aggiunta ad una richiesta rediretta. Nuovo nella versione 2.4.

has_header( header): Restituisce entrambe le istanze che hanno l'intestazione header indicato (verifica sia i regolari che i non rediretti). Nuovo nella versione 2.4.

get_host( ): Restituisce l'host verso cui la connessione verr� instaurata.

get_selector( ): Restituisce il selettore selector: la parte dell'URL che viene inviata al server.

set_proxy( host, type): Prepara la richiesta connettendosi a un proxy server. host e type rimpiazzeranno quelli dell'instanza, ed il selettore dell'istanza sar� l'URL originale fornita nel costruttore.

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.