IHttpHelper
public
interface
IHttpHelper
| com.android.tradefed.util.net.IHttpHelper |
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)
Erstelle den vollständigen codierten URL-Anfragestring. |
abstract
HttpURLConnection
|
createConnection(URL url, String method, String contentType)
Erstellen Sie eine Verknüpfung zur angegebenen 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 für die Weitergabe von XML-Daten. |
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 |
abstract
String
|
doGet(String url)
Führt eine GET-HTTP-Anfragemethode für eine angegebene URL aus und gibt sie als |
abstract
void
|
doGetIgnore(String url)
Führt einen GET-Vorgang für eine bestimmte URL aus. Dabei wird das Ergebnis der angegebenen URL-Parameter ignoriert. |
abstract
void
|
doGetIgnoreWithRetry(String url)
Führt { |
abstract
String
|
doGetWithRetry(String url)
Führt { |
abstract
String
|
doPostWithRetry(String url, String postData)
Führt eine POST-HTTP-Anfragemethode für eine angegebene URL aus und gibt sie als |
abstract
String
|
doPostWithRetry(String url, String postData, String contentType)
Führt eine POST-HTTP-Anfragemethode für eine angegebene URL aus und gibt sie als |
abstract
int
|
getInitialPollInterval()
Ruft das erste Polling-Intervall in ms ab. |
abstract
int
|
getMaxPollInterval()
Maximales Polling-Intervall in ms abrufen |
abstract
int
|
getMaxTime()
Gibt die maximale Zeit in Millisekunden an, nach der die Anfrage wiederholt werden soll. |
abstract
int
|
getOpTimeout()
Zeitlimit für den Vorgang in Millisekunden abrufen |
abstract
void
|
setInitialPollInterval(int time)
Legen Sie das initiale Polling-Intervall in ms fest. |
abstract
void
|
setMaxPollInterval(int time)
Legen Sie das initiale Polling-Intervall in ms fest. |
abstract
void
|
setMaxTime(int time)
Legen Sie die maximale Zeit fest, nach 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: 65.536 (0x00010000)
Öffentliche Methoden
buildParameters
public abstract String buildParameters (MultiMap<String, String> paramMap)
Erstellen Sie den codierten Parameterstring.
| Parameter | |
|---|---|
paramMap |
MultiMap: die URL-Parameter |
| Returns | |
|---|---|
String |
den codierten Parameterstring |
| Ausgabe | |
|---|---|
IllegalArgumentException |
wenn beim Codieren der Parameter eine Ausnahme auftritt. |
buildUrl
public abstract String buildUrl (String url,
MultiMap<String, String> paramMap)Erstelle den vollständigen codierten URL-Anfragestring.
| Parameter | |
|---|---|
url |
String: die Basis-URL |
paramMap |
MultiMap: die URL-Parameter |
| Returns | |
|---|---|
String |
die erstellte URL |
| Ausgabe | |
|---|---|
IllegalArgumentException |
wenn beim Codieren der Parameter eine Ausnahme auftritt. |
createConnection
public abstract 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 |
| Ausgabe | |
|---|---|
|
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 ERROR(/URL), mit der eine Verbindung hergestellt werden soll. |
method |
String: die HTTP-Anfragemethode. Beispiel: GET oder POST. |
| Returns | |
|---|---|
HttpURLConnection |
die ERROR(/HttpURLConnection) |
| Ausgabe | |
|---|---|
|
if failed to make connection |
createXmlConnection
public abstract HttpURLConnection createXmlConnection (URL url,
String method)Erstellt eine Verbindung zur angegebenen URL für die Weitergabe von XML-Daten.
| 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) |
| Ausgabe | |
|---|---|
|
if failed to make connection |
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 ERROR(/OutputStream).
| Parameter | |
|---|---|
url |
String: die URL |
outputStream |
OutputStream: Stream der Antwortdaten |
| Ausgabe | |
|---|---|
|
if failed to retrieve data |
Weitere Informationen
doGet
public abstract 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 auf der Fernbedienung |
| Ausgabe | |
|---|---|
|
if failed to retrieve data |
IHttpHelper.DataSizeException |
if retrieved data is > MAX_DATA_SIZE |
doGetIgnore
public abstract 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 |
| Ausgabe | |
|---|---|
|
if failed to retrieve data |
Weitere Informationen
doGetIgnoreWithRetry
public abstract void doGetIgnoreWithRetry (String url)
Führt {doGetIgnore(String) bei Fehler noch einmal aus.
| Parameter | |
|---|---|
url |
String: die URL |
| Ausgabe | |
|---|---|
|
if failed to retrieve data |
doGetWithRetry
public abstract String doGetWithRetry (String url)
Führt {doGet(String) bei Fehler noch einmal aus.
| Parameter | |
|---|---|
url |
String: die URL |
| Returns | |
|---|---|
String |
die String-Inhalte auf der Fernbedienung |
| Ausgabe | |
|---|---|
|
if failed to retrieve data |
IHttpHelper.DataSizeException |
if retrieved data is > MAX_DATA_SIZE |
doPostWithRetry
public abstract 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 auf der Fernbedienung |
| Ausgabe | |
|---|---|
|
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)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 auf der Fernbedienung |
| Ausgabe | |
|---|---|
|
if failed to retrieve data |
IHttpHelper.DataSizeException |
if retrieved data is > MAX_DATA_SIZE |
getInitialPollInterval
public abstract int getInitialPollInterval ()
Ruft das erste Polling-Intervall in ms ab.
| Returns | |
|---|---|
int |
|
getMaxPollInterval
public abstract int getMaxPollInterval ()
Maximales Polling-Intervall in ms abrufen
| Returns | |
|---|---|
int |
|
getMaxTime
public abstract int getMaxTime ()
Gibt die maximale Zeit in Millisekunden an, nach der die Anfrage wiederholt werden soll.
| Returns | |
|---|---|
int |
|
getOpTimeout
public abstract int getOpTimeout ()
Zeitlimit für den Vorgang in Millisekunden abrufen
| Returns | |
|---|---|
int |
|
setInitialPollInterval
public abstract void setInitialPollInterval (int time)
Legen Sie das initiale Polling-Intervall in ms fest.
| Parameter | |
|---|---|
time |
int |
setMaxPollInterval
public abstract void setMaxPollInterval (int time)
Legen Sie das initiale Polling-Intervall in ms fest.
| Parameter | |
|---|---|
time |
int |
setMaxTime
public abstract void setMaxTime (int time)
Legen Sie die maximale Zeit fest, nach der die Anfrage wiederholt werden soll (in Millisekunden).
| Parameter | |
|---|---|
time |
int |
setOpTimeout
public abstract void setOpTimeout (int time)
Legen Sie das Zeitlimit für den Vorgang in Millisekunden fest.
| Parameter | |
|---|---|
time |
int |