IHttpHelper

public interface IHttpHelper

com.android.tradefed.util.net.IHttpHelper

Bekannte indirekte Unterklassen HttpHelper, SsoClientHttpHelper HttpHelper Enthält Hilfsmethoden zum Senden von HTTP-Anfragen  SsoClientHttpHelper Enthält Hilfsmethoden zum Senden von HTTP-Anfragen mit der SSO-Client-Binärdatei

---

Hilfsmethoden zum Ausführen von HTTP-Anfragen.

Zusammenfassung

Verschachtelte Klassen
class	IHttpHelper.DataSizeException

Konstanten
int	MAX_DATA_SIZE

Öffentliche Methoden
abstract String	buildParameters(MultiMap<String, String> paramMap) Erstellen Sie den codierten Parameterstring.
abstract String	buildUrl(String url, MultiMap<String, String> paramMap) Erstellen Sie den vollständigen codierten URL-Anfragestring.
abstract HttpURLConnection	createConnection(URL url, String method, String contentType) Erstelle eine URL.
abstract HttpURLConnection	createJsonConnection(URL url, String method) Erstellt eine Verbindung zur angegebenen URL, um JSON-Daten zu übergeben.
abstract HttpURLConnection	createXmlConnection(URL url, String method) Erstellt eine Verbindung zur angegebenen URL, um XML-Daten zu übergeben.
abstract String	doGet(String url) Führt eine GET-HTTP-Anfragemethode für eine bestimmte URL aus und gibt sie als String zurück.
abstract void	doGet(String url, OutputStream outputStream) Führt eine GET-HTTP-Anfragemethode für eine bestimmte URL aus und streamt das Ergebnis an einen OutputStream.
abstract void	doGetIgnore(String url) Führt einen GET-Vorgang für eine bestimmte URL mit den angegebenen URL-Parametern aus und ignoriert das Ergebnis.
abstract void	doGetIgnoreWithRetry(String url) Führt {doGetIgnore(String) aus und versucht es bei einem Fehler noch einmal.
abstract String	doGetWithRetry(String url) Führt {doGet(String) aus und versucht es bei einem Fehler noch einmal.
abstract String	doPostWithRetry(String url, String postData) Führt eine POST-HTTP-Anfragemethode für eine bestimmte URL aus und gibt sie als String zurück. Bei einem Fehler wird die Anfrage wiederholt.
abstract String	doPostWithRetry(String url, String postData, String contentType) Führt eine POST-HTTP-Anfragemethode für eine bestimmte URL aus und gibt sie als String zurück. Bei einem Fehler wird die Anfrage wiederholt.
abstract int	getInitialPollInterval() Das anfängliche Abfrageintervall in Millisekunden abrufen.
abstract int	getMaxPollInterval() Das maximale Abfrageintervall in Millisekunden abrufen.
abstract int	getMaxTime() Gibt die maximale Zeit für Wiederholungsversuche für die Anfrage in Millisekunden zurück.
abstract int	getOpTimeout() Das Zeitlimit für den Vorgang in Millisekunden abrufen.
abstract void	setInitialPollInterval(int time) Legen Sie das anfängliche Abfrageintervall in Millisekunden fest.
abstract void	setMaxPollInterval(int time) Legen Sie das anfängliche Abfrageintervall in Millisekunden fest.
abstract void	setMaxTime(int time) Legen Sie die maximale Zeit fest, in der die Anfrage wiederholt werden soll (in Millisekunden).
abstract void	setOpTimeout(int time) Legen Sie das Zeitlimit für den Vorgang in Millisekunden fest.

Konstanten

MAX_DATA_SIZE

public static final int MAX_DATA_SIZE

Konstanter Wert: 65536 (0x00010000)

Öffentliche Methoden

buildParameters

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

Erstellen Sie den codierten Parameterstring.

Parameter
paramMap	MultiMap: die URL-Parameter

Gibt Folgendes zurück:
String	der codierte Parameterstring

Löst aus
IllegalArgumentException	wenn beim Codieren der Parameter eine Ausnahme auftritt.

buildUrl

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

Erstellen Sie den vollständigen codierten URL-Anfragestring.

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

Gibt Folgendes zurück:
String	die erstellte URL

Löst aus
IllegalArgumentException	wenn beim Codieren der Parameter eine Ausnahme auftritt.

createConnection

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

Erstelle eine URL.

Parameter
url	URL: die URL, zu der eine Verbindung hergestellt werden soll.
method	String: Die HTTP-Anfragemethode. Beispiel: GET oder POST.
contentType	String: Der Inhaltstyp. Beispiel: „text/html“.

Gibt Folgendes zurück:
HttpURLConnection	HttpURLConnection

Löst aus
IOException	wenn eine IOException auftritt.

createJsonConnection

public abstract HttpURLConnection createJsonConnection (URL url, 
                String method)

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

Parameter
url	URL: die URL, zu der eine Verbindung hergestellt werden soll.
method	String: Die HTTP-Anfragemethode. Beispiel: GET oder POST.

Gibt Folgendes zurück:
HttpURLConnection	die HttpURLConnection

Löst aus
IOException	Wenn die Verbindung nicht hergestellt werden konnte

createXmlConnection

public abstract HttpURLConnection createXmlConnection (URL url, 
                String method)

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

Parameter
url	URL: die URL, zu der eine Verbindung hergestellt werden soll.
method	String: Die HTTP-Anfragemethode. Beispiel: GET oder POST.

Gibt Folgendes zurück:
HttpURLConnection	die HttpURLConnection

Löst aus
IOException	Wenn die Verbindung nicht hergestellt werden konnte

doGet

public abstract String doGet (String url)

Führt eine GET-HTTP-Anfragemethode für eine bestimmte 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

Gibt Folgendes zurück:
String	die String-Fernbedienungsinhalte

Löst aus
IHttpHelper.DataSizeException	wenn die abgerufenen Daten > MAX_DATA_SIZE sind
IOException	wenn Daten nicht abgerufen werden konnten

doGet

public abstract void doGet (String url, 
                OutputStream outputStream)

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

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

Löst aus
IOException	wenn Daten nicht abgerufen werden konnten

Weitere Informationen

• doGet(String)

doGetIgnore

public abstract void doGetIgnore (String url)

Führt einen GET-Vorgang für eine bestimmte URL mit den angegebenen URL-Parametern aus und ignoriert das Ergebnis.

Parameter
url	String: die URL

Löst aus
IOException	wenn Daten nicht abgerufen werden konnten

Weitere Informationen

• doGet(String)

doGetIgnoreWithRetry

public abstract void doGetIgnoreWithRetry (String url)

Führt {doGetIgnore(String) aus und versucht es bei einem Fehler noch einmal.

Parameter
url	String: die URL

Löst aus
IOException	wenn Daten nicht abgerufen werden konnten

Weitere Informationen

• IRunUtil.runEscalatingTimedRetry(long,long,long,long,com.android.tradefed.util.IRunUtil.IRunnableResult)

doGetWithRetry

public abstract String doGetWithRetry (String url)

Führt {doGet(String) aus und versucht es bei einem Fehler noch einmal.

Parameter
url	String: die URL

Gibt Folgendes zurück:
String	die String-Fernbedienungsinhalte

Löst aus
IHttpHelper.DataSizeException	wenn die abgerufenen Daten > MAX_DATA_SIZE sind
IOException	wenn Daten nicht abgerufen werden konnten

Weitere Informationen

• IRunUtil.runEscalatingTimedRetry(long,long,long,long,com.android.tradefed.util.IRunUtil.IRunnableResult)

doPostWithRetry

public abstract String doPostWithRetry (String url, 
                String postData)

Führt eine POST-HTTP-Anfragemethode für eine bestimmte URL aus und gibt sie als String zurück. Bei einem Fehler wird die Anfrage 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 nach dem Öffnen der Verbindung gepostet werden sollen

Gibt Folgendes zurück:
String	die String-Fernbedienungsinhalte

Löst aus
IHttpHelper.DataSizeException	wenn die abgerufenen Daten > MAX_DATA_SIZE sind
IOException	wenn Daten nicht abgerufen werden konnten

doPostWithRetry

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

Führt eine POST-HTTP-Anfragemethode für eine bestimmte URL aus und gibt sie als String zurück. Bei einem Fehler wird die Anfrage 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 nach dem Öffnen der Verbindung gepostet werden sollen
contentType	String: Der Inhaltstyp. Beispiel: „text/html“.

Gibt Folgendes zurück:
String	die String-Fernbedienungsinhalte

Löst aus
IHttpHelper.DataSizeException	wenn die abgerufenen Daten > MAX_DATA_SIZE sind
IOException	wenn Daten nicht abgerufen werden konnten

getInitialPollInterval

public abstract int getInitialPollInterval ()

Das anfängliche Abfrageintervall in Millisekunden abrufen.

Gibt Folgendes zurück:
int

Weitere Informationen

• IRunUtil.runEscalatingTimedRetry(long,long,long,long,com.android.tradefed.util.IRunUtil.IRunnableResult)

getMaxPollInterval

public abstract int getMaxPollInterval ()

Das maximale Abfrageintervall in Millisekunden abrufen.

Gibt Folgendes zurück:
int

Weitere Informationen

• IRunUtil.runEscalatingTimedRetry(long,long,long,long,com.android.tradefed.util.IRunUtil.IRunnableResult)

getMaxTime

public abstract int getMaxTime ()

Gibt die maximale Zeit für Wiederholungsversuche für die Anfrage in Millisekunden zurück.

Gibt Folgendes zurück:
int

Weitere Informationen

• IRunUtil.runEscalatingTimedRetry(long,long,long,long,com.android.tradefed.util.IRunUtil.IRunnableResult)

getOpTimeout

public abstract int getOpTimeout ()

Das Zeitlimit für den Vorgang in Millisekunden abrufen.

Gibt Folgendes zurück:
int

Weitere Informationen

• IRunUtil.runEscalatingTimedRetry(long,long,long,long,com.android.tradefed.util.IRunUtil.IRunnableResult)

setInitialPollInterval

public abstract void setInitialPollInterval (int time)

Legen Sie das anfängliche Abfrageintervall in Millisekunden fest.

Parameter
time	int

Weitere Informationen

• IRunUtil.runEscalatingTimedRetry(long,long,long,long,com.android.tradefed.util.IRunUtil.IRunnableResult)

setMaxPollInterval

public abstract void setMaxPollInterval (int time)

Legen Sie das anfängliche Abfrageintervall in Millisekunden fest.

Parameter
time	int

Weitere Informationen

• IRunUtil.runEscalatingTimedRetry(long,long,long,long,com.android.tradefed.util.IRunUtil.IRunnableResult)

setMaxTime

public abstract void setMaxTime (int time)

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

Parameter
time	int

Weitere Informationen

• IRunUtil.runEscalatingTimedRetry(long,long,long,long,com.android.tradefed.util.IRunUtil.IRunnableResult)

setOpTimeout

public abstract void setOpTimeout (int time)

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

Parameter
time	int

Weitere Informationen

• IRunUtil.runEscalatingTimedRetry(long,long,long,long,com.android.tradefed.util.IRunUtil.IRunnableResult)