IHttpHelper
public
interface
IHttpHelper
com.android.tradefed.util.net.IHttpHelper |
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)
Cria um para determinado URL. |
abstract
HttpURLConnection
|
createJsonConnection(URL url, String method)
Cria uma conexão com o URL fornecido para transmitir dados json. |
abstract
HttpURLConnection
|
createXmlConnection(URL url, String method)
Cria uma conexão com o URL fornecido para transmitir dados XML. |
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
|
abstract
String
|
doGet(String url)
Executa um método de solicitação HTTP GET para um determinado URL e o retorna como |
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 { |
abstract
String
|
doGetWithRetry(String url)
Executa { |
abstract
String
|
doPostWithRetry(String url, String postData)
Executa um método de solicitação HTTP POST para um determinado URL e o retorna como |
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 |
abstract
int
|
getInitialPollInterval()
Recebe o intervalo de enquete inicial em ms. |
abstract
int
|
getMaxPollInterval()
Recebe o intervalo máximo da enquete em ms. |
abstract
int
|
getMaxTime()
Descubra o tempo máximo para continuar tentando a solicitação em ms. |
abstract
int
|
getOpTimeout()
Receba o tempo limite da operação em ms. |
abstract
void
|
setInitialPollInterval(int time)
Defina o intervalo inicial da enquete em ms. |
abstract
void
|
setMaxPollInterval(int time)
Defina o intervalo inicial da enquete 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: 65.536 (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 na codificação dos 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 na codificação dos parâmetros. |
createConnection
public abstract HttpURLConnection createConnection (URL url, String method, String contentType)
Cria um para determinado URL.
Parâmetros | |
---|---|
url |
URL : o ERROR(/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 |
A HttpURLConnection |
Gera | |
---|---|
|
caso ocorra uma IOException. |
createJsonConnection
public abstract HttpURLConnection createJsonConnection (URL url, String method)
Cria uma conexão com o URL fornecido para transmitir dados json.
Parâmetros | |
---|---|
url |
URL : o ERROR(/URL) a ser conectado. |
method |
String : o método de solicitação HTTP. Por exemplo, GET ou POST. |
Retorna | |
---|---|
HttpURLConnection |
ERROR(/HttpURLConnection) |
Gera | |
---|---|
|
se houver falha ao fazer a conexão |
createXmlConnection
public abstract HttpURLConnection createXmlConnection (URL url, String method)
Cria uma conexão com o URL fornecido para transmitir dados XML.
Parâmetros | |
---|---|
url |
URL : o ERROR(/URL) a ser conectado. |
method |
String : o método de solicitação HTTP. Por exemplo, GET ou POST. |
Retorna | |
---|---|
HttpURLConnection |
ERROR(/HttpURLConnection) |
Gera | |
---|---|
|
se houver falha ao fazer a conexão |
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
ERROR(/OutputStream)
:
Parâmetros | |
---|---|
url |
String : o URL. |
outputStream |
OutputStream : fluxo dos dados de resposta. |
Gera | |
---|---|
|
se houver falha ao recuperar os dados |
Confira também:
doGet
public abstract String doGet (String url)
Executa um método de solicitação HTTP GET para um determinado URL e o retorna como String
.
Como conteúdos remotos são carregados 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 (em inglês)
- Leitor de URL do Java: http://java.sun.com/docs/books/tutorial/networking/urls/readingURL.html (link em inglês)
- Proxy Java definido: http://java.sun.com/docs/books/tutorial/networking/urls/_setProxy.html (link em inglês)
Parâmetros | |
---|---|
url |
String : o URL. |
Retorna | |
---|---|
String |
o conteúdo remoto String |
Gera | |
---|---|
|
se houver falha ao recuperar os 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. |
Gera | |
---|---|
|
se houver falha ao recuperar os dados |
Confira também:
doGetIgnoreWithRetry
public abstract void doGetIgnoreWithRetry (String url)
Executa {doGetIgnore(String)
nova tentativa em caso de falha.
Parâmetros | |
---|---|
url |
String : o URL. |
Gera | |
---|---|
|
se houver falha ao recuperar os dados |
doGetComRepetir
public abstract String doGetWithRetry (String url)
Executa {doGet(String)
nova tentativa em caso de falha.
Parâmetros | |
---|---|
url |
String : o URL. |
Retorna | |
---|---|
String |
o conteúdo remoto String |
Gera | |
---|---|
|
se houver falha ao recuperar os dados |
IHttpHelper.DataSizeException |
se os dados recuperados forem > MAX_DATA_SIZE |
FazerPostRepetição
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 String
.
uma nova tentativa em caso de falha.
Como conteúdos remotos são carregados 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 estiver aberta. |
Retorna | |
---|---|
String |
o conteúdo remoto String |
Gera | |
---|---|
|
se houver falha ao recuperar os dados |
IHttpHelper.DataSizeException |
se os dados recuperados forem > MAX_DATA_SIZE |
FazerPostRepetição
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 String
.
uma nova tentativa em caso de falha.
Como conteúdos remotos são carregados 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 estiver aberta. |
contentType |
String : o tipo de conteúdo. Por exemplo, "text/html". |
Retorna | |
---|---|
String |
o conteúdo remoto String |
Gera | |
---|---|
|
se houver falha ao recuperar os dados |
IHttpHelper.DataSizeException |
se os dados recuperados forem > MAX_DATA_SIZE |
getInitialPollInterval
public abstract int getInitialPollInterval ()
Recebe o intervalo de enquete inicial em ms.
Retorna | |
---|---|
int |
getMaxPollInterval
public abstract int getMaxPollInterval ()
Recebe o intervalo máximo da enquete em ms.
Retorna | |
---|---|
int |
tempo máximo de uso
public abstract int getMaxTime ()
Descubra o tempo máximo para continuar tentando a solicitação em ms.
Retorna | |
---|---|
int |
getOpTimeout
public abstract int getOpTimeout ()
Receba o tempo limite da operação em ms.
Retorna | |
---|---|
int |
setInitialPollInterval
public abstract void setInitialPollInterval (int time)
Defina o intervalo inicial da enquete em ms.
Parâmetros | |
---|---|
time |
int |
setMaxPollInterval
public abstract void setMaxPollInterval (int time)
Defina o intervalo inicial da enquete em ms.
Parâmetros | |
---|---|
time |
int |
Tempo máximo definido
public abstract void setMaxTime (int time)
Defina o tempo máximo para continuar tentando a solicitação em ms.
Parâmetros | |
---|---|
time |
int |
setOpTimeout
public abstract void setOpTimeout (int time)
Defina o tempo limite da operação em ms.
Parâmetros | |
---|---|
time |
int |