IHttpHelper

public interface IHttpHelper

com.android.tradefed.util.net.IHttpHelper

Subclasses indiretas conhecidas HttpHelper, SsoClientHttpHelper HttpHelper Contém métodos auxiliares para fazer solicitações HTTP. SsoClientHttpHelper Contém métodos auxiliares para fazer solicitações HTTP usando o binário do cliente SSO.

---

Métodos auxiliares para realizar solicitações HTTP.

Resumo

Classes aninhadas
class	IHttpHelper.DataSizeException

Constantes
int	MAX_DATA_SIZE

Métodos públicos
abstract String	buildParameters(MultiMap<String, String> paramMap) Crie a string de parâmetro codificada.
abstract String	buildUrl(String url, MultiMap<String, String> paramMap) Crie a string de solicitação de URL codificada completa.
abstract HttpURLConnection	createConnection(URL url, String method, String contentType) Crie um URL de destino.
abstract HttpURLConnection	createJsonConnection(URL url, String method) Cria uma conexão com o URL especificado para transmitir dados JSON.
abstract HttpURLConnection	createXmlConnection(URL url, String method) Cria uma conexão com o URL especificado para transmitir dados XML.
abstract String	doGet(String url) Executa um método de solicitação HTTP GET para um determinado URL e o retorna como um String.
abstract void	doGet(String url, OutputStream outputStream) Executa um método de solicitação HTTP GET para um determinado URL e transmite o resultado para um OutputStream.
abstract void	doGetIgnore(String url) Executa um GET para um determinado URL, com os parâmetros de URL fornecidos, ignorando o resultado.
abstract void	doGetIgnoreWithRetry(String url) Executa {doGetIgnore(String) novas tentativas em caso de falha.
abstract String	doGetWithRetry(String url) Executa {doGet(String) novas tentativas em caso de falha.
abstract String	doPostWithRetry(String url, String postData) Executa um método de solicitação HTTP POST para um determinado URL e o retorna como um String, repetindo em caso de falha.
abstract String	doPostWithRetry(String url, String postData, String contentType) Executa um método de solicitação HTTP POST para um determinado URL e o retorna como um String, repetindo em caso de falha.
abstract int	getInitialPollInterval() Recebe o intervalo de pesquisa inicial em ms.
abstract int	getMaxPollInterval() Recebe o intervalo máximo de pesquisa em ms.
abstract int	getMaxTime() Recebe o tempo máximo para continuar tentando a solicitação em ms.
abstract int	getOpTimeout() Recebe o tempo limite da operação em ms.
abstract void	setInitialPollInterval(int time) Defina o intervalo de pesquisa inicial em ms.
abstract void	setMaxPollInterval(int time) Defina o intervalo de pesquisa inicial em ms.
abstract void	setMaxTime(int time) Defina o tempo máximo para continuar tentando a solicitação em ms.
abstract void	setOpTimeout(int time) Defina o tempo limite da operação em ms.

Constantes

MAX_DATA_SIZE

public static final int MAX_DATA_SIZE

Valor da constante: 65536 (0x00010000)

Métodos públicos

buildParameters

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

Crie a string de parâmetro codificada.

Parâmetros
paramMap	MultiMap: os parâmetros de URL

Retorna
String	a string de parâmetro codificada

Gera
IllegalArgumentException	se ocorrer uma exceção ao codificar os parâmetros.

buildUrl

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

Crie a string de solicitação de URL codificada completa.

Parâmetros
url	String: o URL de base
paramMap	MultiMap: os parâmetros de URL

Retorna
String	o URL construído

Gera
IllegalArgumentException	se ocorrer uma exceção ao codificar os parâmetros.

createConnection

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

Crie um URL de destino.

Parâmetros
url	URL: o URL a ser conectado.
method	String: o método de solicitação HTTP. Por exemplo, GET ou POST.
contentType	String: o tipo de conteúdo. Por exemplo, "text/html".

Retorna
HttpURLConnection	O HttpURLConnection

Gera
IOException	se ocorrer uma IOException.

createJsonConnection

public abstract HttpURLConnection createJsonConnection (URL url, 
                String method)

Cria uma conexão com o URL especificado para transmitir dados JSON.

Parâmetros
url	URL: o URL a ser conectado.
method	String: o método de solicitação HTTP. Por exemplo, GET ou POST.

Retorna
HttpURLConnection	a solicitação HttpURLConnection

Gera
IOException	se a conexão não for estabelecida

createXmlConnection

public abstract HttpURLConnection createXmlConnection (URL url, 
                String method)

Cria uma conexão com o URL especificado para transmitir dados XML.

Parâmetros
url	URL: o URL a ser conectado.
method	String: o método de solicitação HTTP. Por exemplo, GET ou POST.

Retorna
HttpURLConnection	a solicitação HttpURLConnection

Gera
IOException	se a conexão não for estabelecida

doGet

public abstract String doGet (String url)

Executa um método de solicitação HTTP GET para um determinado URL e o retorna como um String.

Como o conteúdo remoto é carregado na memória, esse método só deve ser usado para tamanhos de dados relativamente pequenos.

Referências:

• Conexão de URL do Java: http://java.sun.com/docs/books/tutorial/networking/urls/readingWriting.html
• Leitor de URL em Java: http://java.sun.com/docs/books/tutorial/networking/urls/readingURL.html
• Definir proxy em Java: http://java.sun.com/docs/books/tutorial/networking/urls/_setProxy.html

Parâmetros
url	String: o URL

Retorna
String	o conteúdo remoto String

Gera
IHttpHelper.DataSizeException	se os dados recuperados forem > MAX_DATA_SIZE
IOException	se não for possível recuperar os dados

doGet

public abstract void doGet (String url, 
                OutputStream outputStream)

Executa um método de solicitação HTTP GET para um determinado URL e transmite o resultado para um OutputStream.

Parâmetros
url	String: o URL
outputStream	OutputStream: fluxo dos dados de resposta

Gera
IOException	se não for possível recuperar os dados

Confira também:

• doGet(String)

doGetIgnore

public abstract void doGetIgnore (String url)

Executa um GET para um determinado URL, com os parâmetros de URL fornecidos, ignorando o resultado.

Parâmetros
url	String: o URL

Gera
IOException	se não for possível recuperar os dados

Confira também:

• doGet(String)

doGetIgnoreWithRetry

public abstract void doGetIgnoreWithRetry (String url)

Executa {doGetIgnore(String) novas tentativas em caso de falha.

Parâmetros
url	String: o URL

Gera
IOException	se não for possível recuperar os dados

Confira também:

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

doGetWithRetry

public abstract String doGetWithRetry (String url)

Executa {doGet(String) novas tentativas em caso de falha.

Parâmetros
url	String: o URL

Retorna
String	o conteúdo remoto String

Gera
IHttpHelper.DataSizeException	se os dados recuperados forem > MAX_DATA_SIZE
IOException	se não for possível recuperar os dados

Confira também:

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

doPostWithRetry

public abstract String doPostWithRetry (String url, 
                String postData)

Executa um método de solicitação HTTP POST para um determinado URL e o retorna como um String, repetindo em caso de falha.

Como o conteúdo remoto é carregado na memória, esse método só deve ser usado para tamanhos de dados relativamente pequenos.

Parâmetros
url	String: o URL
postData	String: os dados a serem postados quando a conexão for aberta

Retorna
String	o conteúdo remoto String

Gera
IHttpHelper.DataSizeException	se os dados recuperados forem > MAX_DATA_SIZE
IOException	se não for possível recuperar os dados

doPostWithRetry

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

Executa um método de solicitação HTTP POST para um determinado URL e o retorna como um String, repetindo em caso de falha.

Como o conteúdo remoto é carregado na memória, esse método só deve ser usado para tamanhos de dados relativamente pequenos.

Parâmetros
url	String: o URL
postData	String: os dados a serem postados quando a conexão for aberta
contentType	String: o tipo de conteúdo. Por exemplo, "text/html".

Retorna
String	o conteúdo remoto String

Gera
IHttpHelper.DataSizeException	se os dados recuperados forem > MAX_DATA_SIZE
IOException	se não for possível recuperar os dados

getInitialPollInterval

public abstract int getInitialPollInterval ()

Recebe o intervalo de pesquisa inicial em ms.

Retorna
int

Confira também:

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

getMaxPollInterval

public abstract int getMaxPollInterval ()

Recebe o intervalo máximo de pesquisa em ms.

Retorna
int

Confira também:

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

getMaxTime

public abstract int getMaxTime ()

Recebe o tempo máximo para continuar tentando a solicitação em ms.

Retorna
int

Confira também:

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

getOpTimeout

public abstract int getOpTimeout ()

Recebe o tempo limite da operação em ms.

Retorna
int

Confira também:

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

setInitialPollInterval

public abstract void setInitialPollInterval (int time)

Defina o intervalo de pesquisa inicial em ms.

Parâmetros
time	int

Confira também:

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

setMaxPollInterval

public abstract void setMaxPollInterval (int time)

Defina o intervalo de pesquisa inicial em ms.

Parâmetros
time	int

Confira também:

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

setMaxTime

public abstract void setMaxTime (int time)

Defina o tempo máximo para continuar tentando a solicitação em ms.

Parâmetros
time	int

Confira também:

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

setOpTimeout

public abstract void setOpTimeout (int time)

Defina o tempo limite da operação em ms.

Parâmetros
time	int

Confira também:

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