IHttpHelper
public
interface
IHttpHelper
| com.android.tradefed.util.net.IHttpHelper |
Phương thức hỗ trợ để thực hiện các yêu cầu http.
Tóm tắt
Các lớp học lồng ghép | |
|---|---|
class |
IHttpHelper.DataSizeException
|
Các hằng số | |
|---|---|
int |
MAX_DATA_SIZE
|
Phương thức công khai | |
|---|---|
abstract
String
|
buildParameters(MultiMap<String, String> paramMap)
Tạo chuỗi tham số được mã hoá. |
abstract
String
|
buildUrl(String url, MultiMap<String, String> paramMap)
Tạo chuỗi yêu cầu URL được mã hoá đầy đủ. |
abstract
HttpURLConnection
|
createConnection(URL url, String method, String contentType)
Tạo một đến URL đã cho. |
abstract
HttpURLConnection
|
createJsonConnection(URL url, String method)
Tạo một kết nối đến URL đã cho để truyền dữ liệu JSON. |
abstract
HttpURLConnection
|
createXmlConnection(URL url, String method)
Tạo một kết nối đến URL đã cho để truyền dữ liệu XML. |
abstract
String
|
doGet(String url)
Thực hiện phương thức yêu cầu GET HTTP cho một URL nhất định và trả về URL đó dưới dạng |
abstract
void
|
doGet(String url, OutputStream outputStream)
Thực hiện phương thức yêu cầu HTTP GET cho một URL nhất định và truyền kết quả đến một |
abstract
void
|
doGetIgnore(String url)
Thực hiện một yêu cầu GET cho một URL nhất định, với các tham số URL nhất định bỏ qua kết quả. |
abstract
void
|
doGetIgnoreWithRetry(String url)
Thực hiện { |
abstract
String
|
doGetWithRetry(String url)
Thực hiện { |
abstract
String
|
doPostWithRetry(String url, String postData)
Thực hiện phương thức yêu cầu POST qua HTTP cho một URL nhất định và trả về URL đó dưới dạng |
abstract
String
|
doPostWithRetry(String url, String postData, String contentType)
Thực hiện phương thức yêu cầu POST qua HTTP cho một URL nhất định và trả về URL đó dưới dạng |
abstract
int
|
getInitialPollInterval()
Lấy khoảng thời gian thăm dò ban đầu tính bằng mili giây. |
abstract
int
|
getMaxPollInterval()
Lấy khoảng thời gian thăm dò tối đa tính bằng mili giây. |
abstract
int
|
getMaxTime()
Lấy thời gian tối đa để tiếp tục thử yêu cầu theo mili giây. |
abstract
int
|
getOpTimeout()
Nhận thời gian chờ thao tác tính bằng mili giây. |
abstract
void
|
setInitialPollInterval(int time)
Đặt khoảng thời gian thăm dò ban đầu tính bằng mili giây. |
abstract
void
|
setMaxPollInterval(int time)
Đặt khoảng thời gian thăm dò ban đầu tính bằng mili giây. |
abstract
void
|
setMaxTime(int time)
Đặt thời gian tối đa để tiếp tục thử lại yêu cầu (tính bằng mili giây). |
abstract
void
|
setOpTimeout(int time)
Đặt thời gian chờ của thao tác tính bằng mili giây. |
Hằng số
MAX_DATA_SIZE
public static final int MAX_DATA_SIZE
Giá trị hằng số: 65536 (0x00010000)
Phương thức công khai
buildParameters
public abstract String buildParameters (MultiMap<String, String> paramMap)
Tạo chuỗi tham số được mã hoá.
| Tham số | |
|---|---|
paramMap |
MultiMap: tham số URL |
| Giá trị trả về | |
|---|---|
String |
chuỗi tham số được mã hoá |
| Gửi | |
|---|---|
IllegalArgumentException |
nếu xảy ra một trường hợp ngoại lệ khi mã hoá các tham số. |
buildUrl
public abstract String buildUrl (String url,
MultiMap<String, String> paramMap)Tạo chuỗi yêu cầu URL được mã hoá đầy đủ.
| Tham số | |
|---|---|
url |
String: URL cơ sở |
paramMap |
MultiMap: tham số URL |
| Giá trị trả về | |
|---|---|
String |
URL được tạo |
| Gửi | |
|---|---|
IllegalArgumentException |
nếu xảy ra một trường hợp ngoại lệ khi mã hoá các tham số. |
createConnection
public abstract HttpURLConnection createConnection (URL url,
String method,
String contentType)Tạo một đến URL đã cho.
| Tham số | |
|---|---|
url |
URL: URL để kết nối. |
method |
String: phương thức yêu cầu HTTP. Ví dụ: GET hoặc POST. |
contentType |
String: loại nội dung. Ví dụ: "text/html". |
| Giá trị trả về | |
|---|---|
HttpURLConnection |
HttpURLConnection |
| Gửi | |
|---|---|
IOException |
nếu xảy ra IOException. |
createJsonConnection
public abstract HttpURLConnection createJsonConnection (URL url,
String method)Tạo một kết nối đến URL đã cho để truyền dữ liệu JSON.
| Tham số | |
|---|---|
url |
URL: URL để kết nối. |
method |
String: phương thức yêu cầu HTTP. Ví dụ: GET hoặc POST. |
| Giá trị trả về | |
|---|---|
HttpURLConnection |
HttpURLConnection |
| Gửi | |
|---|---|
IOException |
nếu không kết nối được |
createXmlConnection
public abstract HttpURLConnection createXmlConnection (URL url,
String method)Tạo một kết nối đến URL đã cho để truyền dữ liệu XML.
| Tham số | |
|---|---|
url |
URL: URL để kết nối. |
method |
String: phương thức yêu cầu HTTP. Ví dụ: GET hoặc POST. |
| Giá trị trả về | |
|---|---|
HttpURLConnection |
HttpURLConnection |
| Gửi | |
|---|---|
IOException |
nếu không kết nối được |
doGet
public abstract String doGet (String url)
Thực hiện phương thức yêu cầu GET HTTP cho một URL nhất định và trả về URL đó dưới dạng String.
Vì nội dung từ xa được tải vào bộ nhớ, nên phương thức này chỉ được dùng cho các kích thước dữ liệu tương đối nhỏ.
Tài liệu tham khảo:
- Java URL Connection: http://java.sun.com/docs/books/tutorial/networking/urls/readingWriting.html
- Trình đọc URL Java: http://java.sun.com/docs/books/tutorial/networking/urls/readingURL.html
- Java set Proxy: http://java.sun.com/docs/books/tutorial/networking/urls/_setProxy.html
| Tham số | |
|---|---|
url |
String: URL |
| Giá trị trả về | |
|---|---|
String |
nội dung từ xa String |
| Gửi | |
|---|---|
IHttpHelper.DataSizeException |
nếu dữ liệu được truy xuất > MAX_DATA_SIZE |
IOException |
nếu không truy xuất được dữ liệu |
doGet
public abstract void doGet (String url,
OutputStream outputStream)Thực hiện phương thức yêu cầu HTTP GET cho một URL nhất định và truyền kết quả đến một OutputStream.
| Tham số | |
|---|---|
url |
String: URL |
outputStream |
OutputStream: luồng dữ liệu phản hồi |
| Gửi | |
|---|---|
IOException |
nếu không truy xuất được dữ liệu |
Xem thêm:
doGetIgnore
public abstract void doGetIgnore (String url)
Thực hiện một yêu cầu GET cho một URL nhất định, với các tham số URL nhất định bỏ qua kết quả.
| Tham số | |
|---|---|
url |
String: URL |
| Gửi | |
|---|---|
IOException |
nếu không truy xuất được dữ liệu |
Xem thêm:
doGetIgnoreWithRetry
public abstract void doGetIgnoreWithRetry (String url)
Thực hiện {doGetIgnore(String) thử lại khi không thành công.
| Tham số | |
|---|---|
url |
String: URL |
| Gửi | |
|---|---|
IOException |
nếu không truy xuất được dữ liệu |
doGetWithRetry
public abstract String doGetWithRetry (String url)
Thực hiện {doGet(String) thử lại khi không thành công.
| Tham số | |
|---|---|
url |
String: URL |
| Giá trị trả về | |
|---|---|
String |
nội dung từ xa String |
| Gửi | |
|---|---|
IHttpHelper.DataSizeException |
nếu dữ liệu được truy xuất > MAX_DATA_SIZE |
IOException |
nếu không truy xuất được dữ liệu |
doPostWithRetry
public abstract String doPostWithRetry (String url,
String postData)Thực hiện phương thức yêu cầu POST qua HTTP cho một URL nhất định và trả về URL đó dưới dạng String, thử lại khi thất bại.
Vì nội dung từ xa được tải vào bộ nhớ, nên phương thức này chỉ được dùng cho các kích thước dữ liệu tương đối nhỏ.
| Tham số | |
|---|---|
url |
String: URL |
postData |
String: dữ liệu sẽ được đăng sau khi kết nối mở |
| Giá trị trả về | |
|---|---|
String |
nội dung từ xa String |
| Gửi | |
|---|---|
IHttpHelper.DataSizeException |
nếu dữ liệu được truy xuất > MAX_DATA_SIZE |
IOException |
nếu không truy xuất được dữ liệu |
doPostWithRetry
public abstract String doPostWithRetry (String url,
String postData,
String contentType)Thực hiện phương thức yêu cầu POST qua HTTP cho một URL nhất định và trả về URL đó dưới dạng String, thử lại khi thất bại.
Vì nội dung từ xa được tải vào bộ nhớ, nên phương thức này chỉ được dùng cho các kích thước dữ liệu tương đối nhỏ.
| Tham số | |
|---|---|
url |
String: URL |
postData |
String: dữ liệu sẽ được đăng sau khi kết nối mở |
contentType |
String: loại nội dung. Ví dụ: "text/html". |
| Giá trị trả về | |
|---|---|
String |
nội dung từ xa String |
| Gửi | |
|---|---|
IHttpHelper.DataSizeException |
nếu dữ liệu được truy xuất > MAX_DATA_SIZE |
IOException |
nếu không truy xuất được dữ liệu |
getInitialPollInterval
public abstract int getInitialPollInterval ()
Lấy khoảng thời gian thăm dò ban đầu tính bằng mili giây.
| Giá trị trả về | |
|---|---|
int |
|
getMaxPollInterval
public abstract int getMaxPollInterval ()
Lấy khoảng thời gian thăm dò tối đa tính bằng mili giây.
| Giá trị trả về | |
|---|---|
int |
|
getMaxTime
public abstract int getMaxTime ()
Lấy thời gian tối đa để tiếp tục thử yêu cầu theo mili giây.
| Giá trị trả về | |
|---|---|
int |
|
getOpTimeout
public abstract int getOpTimeout ()
Nhận thời gian chờ thao tác tính bằng mili giây.
| Giá trị trả về | |
|---|---|
int |
|
setInitialPollInterval
public abstract void setInitialPollInterval (int time)
Đặt khoảng thời gian thăm dò ban đầu tính bằng mili giây.
| Tham số | |
|---|---|
time |
int |
setMaxPollInterval
public abstract void setMaxPollInterval (int time)
Đặt khoảng thời gian thăm dò ban đầu tính bằng mili giây.
| Tham số | |
|---|---|
time |
int |
setMaxTime
public abstract void setMaxTime (int time)
Đặt thời gian tối đa để tiếp tục thử lại yêu cầu (tính bằng mili giây).
| Tham số | |
|---|---|
time |
int |
setOpTimeout
public abstract void setOpTimeout (int time)
Đặt thời gian chờ của thao tác tính bằng mili giây.
| Tham số | |
|---|---|
time |
int |