IHttpHelper

public interface IHttpHelper

com.android.tradefed.util.net.IHttpHelper

Известные косвенные подклассы HttpHelper HttpHelper Содержит вспомогательные методы для выполнения HTTP-запросов.

---

Вспомогательные методы для выполнения http-запросов.

Краткое содержание

Вложенные классы
class	IHttpHelper.DataSizeException

Константы
int	MAX_DATA_SIZE

Публичные методы
abstract String	buildParameters ( MultiMap <String, String> paramMap) Создайте закодированную строку параметров.
abstract String	buildUrl (String url, MultiMap <String, String> paramMap) Создайте полную закодированную строку запроса URL-адреса.
abstract HttpURLConnection	createConnection (URL url, String method, String contentType) Создайте указанный URL-адрес.
abstract HttpURLConnection	createJsonConnection (URL url, String method) Создает соединение с заданным URL-адресом для передачи данных JSON.
abstract HttpURLConnection	createXmlConnection (URL url, String method) Создает соединение с заданным URL-адресом для передачи данных XML.
abstract void	doGet (String url, OutputStream outputStream) Выполняет метод HTTP-запроса GET для заданного URL-адреса и передает результат в ERROR(/OutputStream) .
abstract String	doGet (String url) Выполняет метод HTTP-запроса GET для заданного URL-адреса и возвращает его в виде String .
abstract void	doGetIgnore (String url) Выполняет GET для заданного URL-адреса, при этом заданные параметры URL-адреса игнорируют результат.
abstract void	doGetIgnoreWithRetry (String url) Выполняет { doGetIgnore(String) повторную попытку в случае неудачи.
abstract String	doGetWithRetry (String url) Выполняет { doGet(String) повторную попытку в случае неудачи.
abstract String	doPostWithRetry (String url, String postData) Выполняет метод запроса POST HTTP для заданного URL-адреса и возвращает его в виде String , повторяя попытку в случае неудачи.
abstract String	doPostWithRetry (String url, String postData, String contentType) Выполняет метод запроса POST HTTP для заданного URL-адреса и возвращает его в виде String , повторяя попытку в случае неудачи.
abstract int	getInitialPollInterval () Получите начальный интервал опроса в мс.
abstract int	getMaxPollInterval () Получите максимальный интервал опроса в мс.
abstract int	getMaxTime () Получите максимальное время выполнения запроса в мс.
abstract int	getOpTimeout () Получить таймаут операции в мс.
abstract void	setInitialPollInterval (int time) Установите начальный интервал опроса в мс.
abstract void	setMaxPollInterval (int time) Установите начальный интервал опроса в мс.
abstract void	setMaxTime (int time) Установите максимальное время повторения запроса в мс.
abstract void	setOpTimeout (int time) Установите таймаут операции в мс.

Константы

MAX_DATA_SIZE

public static final int MAX_DATA_SIZE

Постоянное значение: 65536 (0x00010000)

Публичные методы

Параметры сборки

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

Создайте закодированную строку параметров.

Параметры
paramMap	MultiMap : параметры URL

Возврат
String	закодированная строка параметра

Броски
IllegalArgumentException	если возникает исключение, кодируя параметры.

построитьUrl

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

Создайте полную закодированную строку запроса URL-адреса.

Параметры
url	String : базовый URL-адрес.
paramMap	MultiMap : параметры URL

Возврат
String	созданный URL-адрес

Броски
IllegalArgumentException	если возникает исключение, кодируя параметры.

создать соединение

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

Создайте указанный URL-адрес.

Параметры
url	URL : ERROR(/URL) для подключения.
method	String : метод HTTP-запроса. Например, GET или POST.
contentType	String : тип контента. Например, «текст/html».

Возврат
HttpURLConnection	Соединение HttpURL

Броски
	если возникает исключение IOException.

создатьJsonConnection

public abstract HttpURLConnection createJsonConnection (URL url, 
                String method)

Создает соединение с заданным URL-адресом для передачи данных JSON.

Параметры
url	URL : ERROR(/URL) для подключения.
method	String : метод HTTP-запроса. Например, GET или POST.

Возврат
HttpURLConnection	ERROR(/HttpURLConnection)

Броски
	если не удалось установить соединение

создатьXmlConnection

public abstract HttpURLConnection createXmlConnection (URL url, 
                String method)

Создает соединение с заданным URL-адресом для передачи данных XML.

Параметры
url	URL : ERROR(/URL) для подключения.
method	String : метод HTTP-запроса. Например, GET или POST.

Возврат
HttpURLConnection	ERROR(/HttpURLConnection)

Броски
	если не удалось установить соединение

doGet

public abstract void doGet (String url, 
                OutputStream outputStream)

Выполняет метод HTTP-запроса GET для заданного URL-адреса и передает результат в ERROR(/OutputStream) .

Параметры
url	String : URL-адрес.
outputStream	OutputStream : поток данных ответа.

Броски
	если не удалось получить данные

См. также:

• doGet(String)

doGet

public abstract String doGet (String url)

Выполняет метод HTTP-запроса GET для заданного URL-адреса и возвращает его в виде String .

Поскольку удаленное содержимое загружается в память, этот метод следует использовать только для относительно небольших размеров данных.

Ссылки:

• URL-соединение Java: http://java.sun.com/docs/books/tutorial/networking/urls/readingWriting.html .
• Программа чтения URL-адресов Java: http://java.sun.com/docs/books/tutorial/networking/urls/readingURL.html .
• Прокси-сервер набора Java: http://java.sun.com/docs/books/tutorial/networking/urls/_setProxy.html

Параметры
url	String : URL-адрес.

Возврат
String	удаленное содержимое String

Броски
	если не удалось получить данные
IHttpHelper.DataSizeException	если полученные данные > MAX_DATA_SIZE

doGetIgnore

public abstract void doGetIgnore (String url)

Выполняет GET для заданного URL-адреса, при этом заданные параметры URL-адреса игнорируют результат.

Параметры
url	String : URL-адрес.

Броски
	если не удалось получить данные

См. также:

• doGet(String)

doGetIgnoreWithRetry

public abstract void doGetIgnoreWithRetry (String url)

Выполняет { doGetIgnore(String) повторную попытку в случае неудачи.

Параметры
url	String : URL-адрес.

Броски
	если не удалось получить данные

См. также:

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

doGetWithRetry

public abstract String doGetWithRetry (String url)

Выполняет { doGet(String) повторную попытку в случае неудачи.

Параметры
url	String : URL-адрес.

Возврат
String	удаленное содержимое String

Броски
	если не удалось получить данные
IHttpHelper.DataSizeException	если полученные данные > MAX_DATA_SIZE

См. также:

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

doPostWithRetry

public abstract String doPostWithRetry (String url, 
                String postData)

Выполняет метод запроса POST HTTP для заданного URL-адреса и возвращает его в виде String , повторяя попытку в случае неудачи.

Поскольку удаленное содержимое загружается в память, этот метод следует использовать только для относительно небольших размеров данных.

Параметры
url	String : URL-адрес.
postData	String : данные, которые будут опубликованы после открытия соединения.

Возврат
String	удаленное содержимое String

Броски
	если не удалось получить данные
IHttpHelper.DataSizeException	если полученные данные > MAX_DATA_SIZE

doPostWithRetry

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

Выполняет метод запроса POST HTTP для заданного URL-адреса и возвращает его в виде String , повторяя попытку в случае неудачи.

Поскольку удаленное содержимое загружается в память, этот метод следует использовать только для относительно небольших размеров данных.

Параметры
url	String : URL-адрес.
postData	String : данные, которые будут опубликованы после открытия соединения.
contentType	String : тип контента. Например, «текст/html».

Возврат
String	удаленное содержимое String

Броски
	если не удалось получить данные
IHttpHelper.DataSizeException	если полученные данные > MAX_DATA_SIZE

getInitialPollInterval

public abstract int getInitialPollInterval ()

Получите начальный интервал опроса в мс.

Возврат
int

См. также:

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

getMaxPollInterval

public abstract int getMaxPollInterval ()

Получите максимальный интервал опроса в мс.

Возврат
int

См. также:

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

getMaxTime

public abstract int getMaxTime ()

Получите максимальное время выполнения запроса в мс.

Возврат
int

См. также:

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

getOpTimeout

public abstract int getOpTimeout ()

Получить таймаут операции в мс.

Возврат
int

См. также:

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

setInitialPollInterval

public abstract void setInitialPollInterval (int time)

Установите начальный интервал опроса в мс.

Параметры
time	int

См. также:

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

setMaxPollInterval

public abstract void setMaxPollInterval (int time)

Установите начальный интервал опроса в мс.

Параметры
time	int

См. также:

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

setMaxTime

public abstract void setMaxTime (int time)

Установите максимальное время выполнения запроса в мс.

Параметры
time	int

См. также:

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

setOpTimeout

public abstract void setOpTimeout (int time)

Установите таймаут операции в мс.

Параметры
time	int

См. также:

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