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.