IHttpHelper

public interface IHttpHelper

com.android.tradefed.util.net.IHttpHelper


Metodi di supporto per l'esecuzione di richieste HTTP.

Riepilogo

Classi nidificate

class IHttpHelper.DataSizeException

 

Costanti

int MAX_DATA_SIZE

Metodi pubblici

abstract String buildParameters(MultiMap<String, String> paramMap)

Crea la stringa del parametro codificata.

abstract String buildUrl(String url, MultiMap<String, String> paramMap)

Crea la stringa di richiesta dell'URL codificata completa.

abstract HttpURLConnection createConnection(URL url, String method, String contentType)

Crea un URL a un determinato URL.

abstract HttpURLConnection createJsonConnection(URL url, String method)

Crea una connessione all'URL specificato per il passaggio dei dati JSON.

abstract HttpURLConnection createXmlConnection(URL url, String method)

Crea una connessione all'URL specificato per il passaggio dei dati XML.

abstract void doGet(String url, OutputStream outputStream)

Esegue un metodo di richiesta HTTP GET per un determinato URL e trasmette il risultato in un ERROR(/OutputStream).

abstract String doGet(String url)

Esegue un metodo di richiesta HTTP GET per un determinato URL e lo restituisce come String.

abstract void doGetIgnore(String url)

Esegue una richiesta GET per un determinato URL, ignorando il risultato con i parametri URL specificati.

abstract void doGetIgnoreWithRetry(String url)

Esegue {doGetIgnore(String) nuovi tentativi in caso di errore.

abstract String doGetWithRetry(String url)

Esegue {doGet(String) nuovi tentativi in caso di errore.

abstract String doPostWithRetry(String url, String postData)

Esegue un metodo di richiesta HTTP POST per un determinato URL e lo restituisce come String, riprovando in caso di errore.

abstract String doPostWithRetry(String url, String postData, String contentType)

Esegue un metodo di richiesta HTTP POST per un determinato URL e lo restituisce come String, riprovando in caso di errore.

abstract int getInitialPollInterval()

Recupera l'intervallo di polling iniziale in millisecondi.

abstract int getMaxPollInterval()

Recupera l'intervallo di polling massimo in millisecondi.

abstract int getMaxTime()

Ottieni il tempo massimo per continuare a tentare la richiesta in millisecondi.

abstract int getOpTimeout()

Recupera il timeout dell'operazione in millisecondi.

abstract void setInitialPollInterval(int time)

Imposta l'intervallo di polling iniziale in ms.

abstract void setMaxPollInterval(int time)

Imposta l'intervallo di polling iniziale in millisecondi.

abstract void setMaxTime(int time)

Imposta il tempo massimo per continuare a tentare la richiesta in ms.

abstract void setOpTimeout(int time)

Imposta il timeout dell'operazione in millisecondi.

Costanti

MAX_DATA_SIZE

public static final int MAX_DATA_SIZE

Valore costante: 65536 (0x00010000)

Metodi pubblici

buildParameters

public abstract String buildParameters (MultiMap<String, String> paramMap)

Crea la stringa del parametro codificata.

Parametri
paramMap MultiMap: i parametri URL

Ritorni
String la stringa di parametro codificata

Lanci
IllegalArgumentException Se si verifica un'eccezione durante la codifica dei parametri.

buildUrl

public abstract String buildUrl (String url, 
                MultiMap<String, String> paramMap)

Crea la stringa di richiesta dell'URL codificata completa.

Parametri
url String: l'URL di base

paramMap MultiMap: i parametri URL

Ritorni
String l'URL costruito

Lanci
IllegalArgumentException Se si verifica un'eccezione durante la codifica dei parametri.

createConnection

public abstract HttpURLConnection createConnection (URL url, 
                String method, 
                String contentType)

Crea un URL a un determinato URL.

Parametri
url URL: il ERROR(/URL) a cui connetterti.

method String: il metodo della richiesta HTTP. Ad esempio, GET o POST.

contentType String: il tipo di contenuti. Ad esempio, "text/html".

Ritorni
HttpURLConnection HttpURLConnection

Lanci
Se si verifica un'eccezione IOException.

createJsonConnection

public abstract HttpURLConnection createJsonConnection (URL url, 
                String method)

Crea una connessione all'URL specificato per il passaggio dei dati JSON.

Parametri
url URL: il ERROR(/URL) a cui connetterti.

method String: il metodo della richiesta HTTP. Ad esempio, GET o POST.

Ritorni
HttpURLConnection ERROR(/HttpURLConnection)

Lanci
if failed to make connection

createXmlConnection

public abstract HttpURLConnection createXmlConnection (URL url, 
                String method)

Crea una connessione all'URL specificato per il passaggio dei dati XML.

Parametri
url URL: il ERROR(/URL) a cui connetterti.

method String: il metodo di richiesta HTTP. Ad esempio, GET o POST.

Ritorni
HttpURLConnection ERROR(/HttpURLConnection)

Lanci
if failed to make connection

doGet

public abstract void doGet (String url, 
                OutputStream outputStream)

Esegue un metodo di richiesta HTTP GET per un determinato URL e trasmette il risultato in un ERROR(/OutputStream).

Parametri
url String: l'URL

outputStream OutputStream: stream dei dati di risposta

Lanci
if failed to retrieve data

Vedi anche:

doGet

public abstract String doGet (String url)

Esegue un metodo di richiesta HTTP GET per un determinato URL e lo restituisce come String.

Poiché i contenuti remoti vengono caricati in memoria, questo metodo deve essere utilizzato solo per dimensioni dei dati relativamente ridotte.

Riferimenti:

Parametri
url String: l'URL

Ritorni
String i contenuti String remoti

Lanci
if failed to retrieve data
IHttpHelper.DataSizeException if retrieved data is > MAX_DATA_SIZE

doGetIgnore

public abstract void doGetIgnore (String url)

Esegue una richiesta GET per un determinato URL, ignorando il risultato con i parametri URL specificati.

Parametri
url String: l'URL

Lanci
if failed to retrieve data

Vedi anche:

doGetIgnoreWithRetry

public abstract void doGetIgnoreWithRetry (String url)

Esegue {doGetIgnore(String) nuovi tentativi in caso di errore.

Parametri
url String: l'URL

Lanci
if failed to retrieve data

doGetWithRetry

public abstract String doGetWithRetry (String url)

Esegue {doGet(String) nuovi tentativi in caso di errore.

Parametri
url String: l'URL

Ritorni
String i contenuti String remoti

Lanci
if failed to retrieve data
IHttpHelper.DataSizeException if retrieved data is > MAX_DATA_SIZE

doPostWithRetry

public abstract String doPostWithRetry (String url, 
                String postData)

Esegue un metodo di richiesta HTTP POST per un determinato URL e lo restituisce come String, riprovando in caso di errore.

Poiché i contenuti remoti vengono caricati in memoria, questo metodo deve essere utilizzato solo per dimensioni dei dati relativamente ridotte.

Parametri
url String: l'URL

postData String: i dati da pubblicare una volta aperta la connessione

Ritorni
String i contenuti String remoti

Lanci
if failed to retrieve data
IHttpHelper.DataSizeException if retrieved data is > MAX_DATA_SIZE

doPostWithRetry

public abstract String doPostWithRetry (String url, 
                String postData, 
                String contentType)

Esegue un metodo di richiesta HTTP POST per un determinato URL e lo restituisce come String, riprovando in caso di errore.

Poiché i contenuti remoti vengono caricati in memoria, questo metodo deve essere utilizzato solo per dimensioni dei dati relativamente ridotte.

Parametri
url String: l'URL

postData String: i dati da pubblicare una volta aperta la connessione

contentType String: il tipo di contenuti. Ad esempio, "text/html".

Ritorni
String i contenuti String remoti

Lanci
if failed to retrieve data
IHttpHelper.DataSizeException if retrieved data is > MAX_DATA_SIZE

getInitialPollInterval

public abstract int getInitialPollInterval ()

Recupera l'intervallo di polling iniziale in millisecondi.

Ritorni
int

getMaxPollInterval

public abstract int getMaxPollInterval ()

Recupera l'intervallo di polling massimo in millisecondi.

Ritorni
int

getMaxTime

public abstract int getMaxTime ()

Ottieni il tempo massimo per continuare a tentare la richiesta in millisecondi.

Ritorni
int

getOpTimeout

public abstract int getOpTimeout ()

Recupera il timeout dell'operazione in millisecondi.

Ritorni
int

setInitialPollInterval

public abstract void setInitialPollInterval (int time)

Imposta l'intervallo di polling iniziale in ms.

Parametri
time int

setMaxPollInterval

public abstract void setMaxPollInterval (int time)

Imposta l'intervallo di polling iniziale in ms.

Parametri
time int

setMaxTime

public abstract void setMaxTime (int time)

Imposta il tempo massimo per continuare a tentare la richiesta in ms.

Parametri
time int

setOpTimeout

public abstract void setOpTimeout (int time)

Imposta il timeout dell'operazione in millisecondi.

Parametri
time int