IHttpHelper

public interface IHttpHelper

com.android.tradefed.util.net.IHttpHelper

Subclasses indiretas conhecidas HttpHelper HttpHelper Contém métodos auxiliares para fazer solicitações http

---

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 sequência de parâmetros 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 determinado URL.
abstract HttpURLConnection	createJsonConnection (URL url, String method) Cria uma conexão com um determinado URL para passar dados JSON.
abstract HttpURLConnection	createXmlConnection (URL url, String method) Cria uma conexão com um determinado URL para passar dados XML.
abstract void	doGet (String url, OutputStream outputStream) Executa um método de solicitação GET HTTP para um determinado URL e transmite o resultado para um ERROR(/OutputStream) .
abstract String	doGet (String url) Executa um método de solicitação GET HTTP para um determinado URL e o retorna como String .
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 POST HTTP para um determinado URL e o retorna como String , tentando novamente em caso de falha.
abstract String	doPostWithRetry (String url, String postData, String contentType) Executa um método de solicitação POST HTTP para um determinado URL e o retorna como String , tentando novamente em caso de falha.
abstract int	getInitialPollInterval () Obtenha o intervalo de pesquisa inicial em ms.
abstract int	getMaxPollInterval () Obtenha o intervalo máximo de pesquisa em ms.
abstract int	getMaxTime () Obtenha o tempo máximo para continuar tentando a solicitação em ms.
abstract int	getOpTimeout () Obtenha 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 Constante: 65536 (0x00010000)

Métodos públicos

parâmetros de construção

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

Crie a sequência de parâmetros codificada.

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

Devoluções
String	a string de parâmetro codificada

Lança
IllegalArgumentException	se ocorrer uma exceção na codificação dos parâmetros.

construirUrl

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 base
paramMap	MultiMap : os parâmetros de URL

Devoluções
String	o URL construído

Lança
IllegalArgumentException	se ocorrer uma exceção na codificação dos parâmetros.

criarConexão

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

Crie um determinado URL.

Parâmetros
url	URL : o ERROR(/URL) ao qual se conectar.
method	String : o método de solicitação HTTP. Por exemplo, GET ou POST.
contentType	String : o tipo de conteúdo. Por exemplo, "texto/html".

Devoluções
HttpURLConnection	A conexão HttpURL

Lança
	se ocorrer uma IOException.

criarJsonConnection

public abstract HttpURLConnection createJsonConnection (URL url, 
                String method)

Cria uma conexão com um determinado URL para passar dados JSON.

Parâmetros
url	URL : o ERROR(/URL) ao qual se conectar.
method	String : o método de solicitação HTTP. Por exemplo, GET ou POST.

Devoluções
HttpURLConnection	o ERROR(/HttpURLConnection)

Lança
	se não conseguiu fazer a conexão

createXmlConnection

public abstract HttpURLConnection createXmlConnection (URL url, 
                String method)

Cria uma conexão com um determinado URL para passar dados XML.

Parâmetros
url	URL : o ERROR(/URL) ao qual se conectar.
method	String : o método de solicitação HTTP. Por exemplo, GET ou POST.

Devoluções
HttpURLConnection	o ERROR(/HttpURLConnection)

Lança
	se não conseguiu fazer a conexão

fazer

public abstract void doGet (String url, 
                OutputStream outputStream)

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

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

Lança
	se não conseguiu recuperar dados

Veja também:

• doGet(String)

fazer

public abstract String doGet (String url)

Executa um método de solicitação GET HTTP para um determinado URL e o retorna como 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 Java: http://java.sun.com/docs/books/tutorial/networking/urls/readingWriting.html
• Leitor de URL Java: http://java.sun.com/docs/books/tutorial/networking/urls/readingURL.html
• Proxy de conjunto Java: http://java.sun.com/docs/books/tutorial/networking/urls/_setProxy.html

Parâmetros
url	String : o URL

Devoluções
String	o conteúdo remoto String

Lança
	se não conseguiu recuperar dados
IHttpHelper.DataSizeException	se os dados recuperados forem > MAX_DATA_SIZE

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

Lança
	se não conseguiu recuperar dados

Veja 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

Lança
	se não conseguiu recuperar dados

Veja 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

Devoluções
String	o conteúdo remoto String

Lança
	se não conseguiu recuperar dados
IHttpHelper.DataSizeException	se os dados recuperados forem > MAX_DATA_SIZE

Veja 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 POST HTTP para um determinado URL e o retorna como String , tentando novamente 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 assim que a conexão for aberta

Devoluções
String	o conteúdo remoto String

Lança
	se não conseguiu recuperar dados
IHttpHelper.DataSizeException	se os dados recuperados forem > MAX_DATA_SIZE

doPostWithRetry

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

Executa um método de solicitação POST HTTP para um determinado URL e o retorna como String , tentando novamente 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 assim que a conexão for aberta
contentType	String : o tipo de conteúdo. Por exemplo, "texto/html".

Devoluções
String	o conteúdo remoto String

Lança
	se não conseguiu recuperar dados
IHttpHelper.DataSizeException	se os dados recuperados forem > MAX_DATA_SIZE

getInitialPollInterval

public abstract int getInitialPollInterval ()

Obtenha o intervalo de pesquisa inicial em ms.

Devoluções
int

Veja também:

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

getMaxPollInterval

public abstract int getMaxPollInterval ()

Obtenha o intervalo máximo de pesquisa em ms.

Devoluções
int

Veja também:

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

getMaxTime

public abstract int getMaxTime ()

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

Devoluções
int

Veja também:

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

getOpTimeout

public abstract int getOpTimeout ()

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

Devoluções
int

Veja 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

Veja 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

Veja 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

Veja 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

Veja também:

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