HttpHelper

public class HttpHelper
extends Object implements IHttpHelper

java.lang.Object
↳	com.android.tradefed.util.net.HttpHelper

---

Enthält Hilfsmethoden zum Senden von HTTP-Anfragen

Zusammenfassung

Verschachtelte Klassen
class	HttpHelper.RequestRunnable Kann zum Senden von Anfragen mit IRunUtil.runEscalatingTimedRetry(long, long, long, long, IRunnableResult) verwendet werden.

Öffentliche Konstruktoren
HttpHelper()

Öffentliche Methoden
String	buildParameters(MultiMap<String, String> paramMap) Erstellen Sie den codierten Parameterstring.
String	buildUrl(String baseUrl, MultiMap<String, String> paramMap) Erstelle den vollständigen codierten URL-Anfragestring.
HttpURLConnection	createConnection(URL url, String method, String contentType) Erstellen Sie eine Verknüpfung zur angegebenen URL.
HttpURLConnection	createJsonConnection(URL url, String method) Erstellt eine Verbindung zur angegebenen URL, um JSON-Daten zu übergeben.
HttpURLConnection	createXmlConnection(URL url, String method) Erstellt eine Verbindung zur angegebenen URL, um XML-Daten zu übergeben.
void	doGet(String url, OutputStream outputStream) Führt eine GET-HTTP-Anfragemethode für eine bestimmte URL aus und streamt das Ergebnis an einen ERROR(/OutputStream).
String	doGet(String url) Führt eine GET-HTTP-Anfragemethode für eine angegebene URL aus und gibt sie als String zurück.
void	doGetIgnore(String url) Führt einen GET-Vorgang für eine bestimmte URL aus. Dabei wird das Ergebnis der angegebenen URL-Parameter ignoriert.
void	doGetIgnoreWithRetry(String url) Führt bei einem Fehler {doGetIgnore(String) Wiederholungsversuche aus.
String	doGetWithRetry(String url) Führt bei einem Fehler {doGet(String) Wiederholungsversuche aus.
String	doPostWithRetry(String url, String postData) Führt eine POST-HTTP-Anfragemethode für eine angegebene URL aus und gibt sie als String zurück. Bei Fehlern wird der Vorgang wiederholt.
String	doPostWithRetry(String url, String postData, String contentType) Führt eine POST-HTTP-Anfragemethode für eine angegebene URL aus und gibt sie als String zurück. Bei Fehlern wird der Vorgang wiederholt.
int	getInitialPollInterval() Das erste Polling-Intervall in ms abrufen.
int	getMaxPollInterval() Maximales Polling-Intervall in ms abrufen
int	getMaxTime() Gibt die maximale Zeit in Millisekunden an, nach der die Anfrage wiederholt werden soll.
int	getOpTimeout() Zeitlimit für den Vorgang in Millisekunden abrufen
IRunUtil	getRunUtil() IRunUtil zum Verwenden abrufen
void	setInitialPollInterval(int time) Legen Sie das initiale Polling-Intervall in ms fest.
void	setMaxPollInterval(int time) Legen Sie das initiale Polling-Intervall in ms fest.
void	setMaxTime(int time) Legen Sie die maximale Zeit fest, nach der die Anfrage wiederholt werden soll (in Millisekunden).
void	setOpTimeout(int time) Legen Sie das Zeitlimit für den Vorgang in Millisekunden fest.

Öffentliche Konstruktoren

HttpHelper

public HttpHelper ()

Öffentliche Methoden

buildParameters

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

Erstellen Sie den codierten Parameterstring.

Parameter
paramMap	MultiMap: die URL-Parameter

Returns
String	den codierten Parameterstring

buildUrl

public String buildUrl (String baseUrl, 
                MultiMap<String, String> paramMap)

Erstelle den vollständigen codierten URL-Anfragestring.

Parameter
baseUrl	String: die Basis-URL
paramMap	MultiMap: die URL-Parameter

Returns
String	die erstellte URL

createConnection

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

Erstellen Sie eine Verknüpfung zur angegebenen URL.

Parameter
url	URL: die ERROR(/URL), mit der eine Verbindung hergestellt werden soll.
method	String: die HTTP-Anfragemethode. Beispiel: GET oder POST.
contentType	String: den Inhaltstyp. Beispiel: „text/html“.

Returns
HttpURLConnection	Die HttpURLConnection

createJsonConnection

public HttpURLConnection createJsonConnection (URL url, 
                String method)

Erstellt eine Verbindung zur angegebenen URL, um JSON-Daten zu übergeben.

Parameter
url	URL: die ERROR(/URL), mit der eine Verbindung hergestellt werden soll.
method	String: die HTTP-Anfragemethode. Beispiel: GET oder POST.

Returns
HttpURLConnection	die ERROR(/HttpURLConnection)

createXmlConnection

public HttpURLConnection createXmlConnection (URL url, 
                String method)

Erstellt eine Verbindung zur angegebenen URL, um XML-Daten zu übergeben.

Parameter
url	URL: die ERROR(/URL), mit der eine Verbindung hergestellt werden soll.
method	String: die HTTP-Anfragemethode. Beispiel: GET oder POST.

Returns
HttpURLConnection	die ERROR(/HttpURLConnection)

doGet

public void doGet (String url, 
                OutputStream outputStream)

Führt eine GET-HTTP-Anfragemethode für eine bestimmte URL aus und streamt das Ergebnis an einen ERROR(/OutputStream).

Parameter
url	String: die URL
outputStream	OutputStream: Stream der Antwortdaten

doGet

public String doGet (String url)

Führt eine GET-HTTP-Anfragemethode für eine angegebene URL aus und gibt sie als String zurück.

Da Remote-Inhalte in den Arbeitsspeicher geladen werden, sollte diese Methode nur für relativ kleine Datenmengen verwendet werden.

Referenzen:

• Java-URL-Verbindung: http://java.sun.com/docs/books/tutorial/networking/urls/readingWriting.html
• Java-URL-Reader: http://java.sun.com/docs/books/tutorial/networking/urls/readingURL.html
• Java-Proxy festlegen: http://java.sun.com/docs/books/tutorial/networking/urls/_setProxy.html

Parameter
url	String: die URL

Returns
String	die String-Inhalte der Fernbedienung

Ausgabe
IHttpHelper.DataSizeException

doGetIgnore

public void doGetIgnore (String url)

Führt einen GET-Vorgang für eine bestimmte URL aus. Dabei wird das Ergebnis der angegebenen URL-Parameter ignoriert.

Parameter
url	String: die URL

doGetIgnoreWithRetry

public void doGetIgnoreWithRetry (String url)

Führt bei einem Fehler {doGetIgnore(String) Wiederholungsversuche aus.

Parameter
url	String: die URL

doGetWithRetry

public String doGetWithRetry (String url)

Führt bei einem Fehler {doGet(String) Wiederholungsversuche aus.

Parameter
url	String: die URL

Returns
String	die String-Inhalte der Fernbedienung

Ausgabe
IHttpHelper.DataSizeException

doPostWithRetry

public String doPostWithRetry (String url, 
                String postData)

Führt eine POST-HTTP-Anfragemethode für eine angegebene URL aus und gibt sie als String zurück. Bei Fehlern wird der Vorgang wiederholt.

Da Remote-Inhalte in den Arbeitsspeicher geladen werden, sollte diese Methode nur für relativ kleine Datenmengen verwendet werden.

Parameter
url	String: die URL
postData	String: die Daten, die gepostet werden sollen, sobald die Verbindung geöffnet ist

Returns
String	die String-Inhalte der Fernbedienung

Ausgabe
IHttpHelper.DataSizeException

doPostWithRetry

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

Führt eine POST-HTTP-Anfragemethode für eine angegebene URL aus und gibt sie als String zurück. Bei Fehlern wird der Vorgang wiederholt.

Da Remote-Inhalte in den Arbeitsspeicher geladen werden, sollte diese Methode nur für relativ kleine Datenmengen verwendet werden.

Parameter
url	String: die URL
postData	String: die Daten, die gepostet werden sollen, sobald die Verbindung geöffnet ist
contentType	String: den Inhaltstyp. Beispiel: „text/html“.

Returns
String	die String-Inhalte der Fernbedienung

Ausgabe
IHttpHelper.DataSizeException

getInitialPollInterval

public int getInitialPollInterval ()

Das erste Polling-Intervall in ms abrufen.

Returns
int

getMaxPollInterval

public int getMaxPollInterval ()

Maximales Polling-Intervall in ms abrufen

Returns
int

getMaxTime

public int getMaxTime ()

Gibt die maximale Zeit in Millisekunden an, nach der die Anfrage wiederholt werden soll.

Returns
int

getOpTimeout

public int getOpTimeout ()

Zeitlimit für den Vorgang in Millisekunden abrufen

Returns
int

getRunUtil

public IRunUtil getRunUtil ()

IRunUtil zum Verwenden abrufen Sie werden freigegeben, damit sie in Unittests gemockt werden können.

Returns
IRunUtil

setInitialPollInterval

public void setInitialPollInterval (int time)

Legen Sie das initiale Polling-Intervall in ms fest.

Parameter
time	int

setMaxPollInterval

public void setMaxPollInterval (int time)

Legen Sie das erste Polling-Intervall in ms fest.

Parameter
time	int

setMaxTime

public void setMaxTime (int time)

Legen Sie die maximale Zeit fest, nach der die Anfrage wiederholt werden soll (in Millisekunden).

Parameter
time	int

setOpTimeout

public void setOpTimeout (int time)

Legen Sie das Zeitlimit für den Vorgang in Millisekunden fest.

Parameter
time	int