IHttpHelper
public
interface
IHttpHelper
| com.android.tradefed.util.net.IHttpHelper |
Các phương thức trợ giúp để thực hiện 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ố đã 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 URL đã cho. |
abstract
HttpURLConnection
|
createJsonConnection(URL url, String method)
Tạo kết nối đến URL đã cho để truyền dữ liệu json. |
abstract
HttpURLConnection
|
createXmlConnection(URL url, String method)
Tạo kết nối đến URL đã cho để truyền dữ liệu xml. |
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 |
abstract
String
|
doGet(String url)
Thực hiện phương thức yêu cầu HTTP GET cho một URL nhất định và trả về phương thức đó dưới dạng |
abstract
void
|
doGetIgnore(String url)
Thực hiện lệnh 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 HTTP cho một URL nhất định và trả về phương thức đó 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 HTTP cho một URL nhất định và trả về phương thức đó dưới dạng |
abstract
int
|
getInitialPollInterval()
Lấy khoảng thời gian thăm dò ý kiến ban đầu tính bằng mili giây. |
abstract
int
|
getMaxPollInterval()
Lấy khoảng thời gian thăm dò ý kiến tối đa tính bằng mili giây. |
abstract
int
|
getMaxTime()
Nhận thời gian tối đa để tiếp tục thử yêu cầu tính bằng 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ò ý kiến ban đầu tính bằng mili giây. |
abstract
void
|
setMaxPollInterval(int time)
Đặt khoảng thời gian thăm dò ý kiến 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ử 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ị không đổi: 65536 (0x00010000)
Phương thức công khai
buildParameters
public abstract String buildParameters (MultiMap<String, String> paramMap)
Tạo chuỗi tham số đã mã hoá.
| Tham số | |
|---|---|
paramMap |
MultiMap: tham số URL |
| Giá trị trả về | |
|---|---|
String |
chuỗi tham số đã mã hoá |
| Gửi | |
|---|---|
IllegalArgumentException |
nếu xảy ra 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 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 URL đã cho.
| Tham số | |
|---|---|
url |
URL: ERROR(/URL) cần 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 | |
|---|---|
|
nếu xảy ra IOException. |
createJsonConnection
public abstract HttpURLConnection createJsonConnection (URL url,
String method)Tạo kết nối đến URL đã cho để truyền dữ liệu json.
| Tham số | |
|---|---|
url |
URL: ERROR(/URL) cần 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 |
ERROR(/HttpURLConnection) |
| Gửi | |
|---|---|
|
nếu không kết nối được |
createXmlConnection
public abstract HttpURLConnection createXmlConnection (URL url,
String method)Tạo kết nối đến URL đã cho để truyền dữ liệu xml.
| Tham số | |
|---|---|
url |
URL: ERROR(/URL) cần 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 |
ERROR(/HttpURLConnection) |
| Gửi | |
|---|---|
|
nếu không kết nối được |
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 ERROR(/OutputStream).
| Tham số | |
|---|---|
url |
String: URL |
outputStream |
OutputStream: luồng dữ liệu phản hồi |
| Gửi | |
|---|---|
|
nếu không truy xuất được dữ liệu |
Xem thêm:
doGet
public abstract String doGet (String url)
Thực hiện phương thức yêu cầu HTTP GET cho một URL nhất định và trả về phương thức đó 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ỉ nên được dùng cho kích thước dữ liệu tương đối nhỏ.
References:
- Kết nối URL Java: 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
- Đặt proxy Java: 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 | |
|---|---|
|
nếu không truy xuất được dữ liệu |
IHttpHelper.DataSizeException |
nếu dữ liệu được truy xuất > MAX_DATA_SIZE |
doGetIgnore
public abstract void doGetIgnore (String url)
Thực hiện lệnh 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 | |
|---|---|
|
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 | |
|---|---|
|
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 | |
|---|---|
|
nếu không truy xuất được dữ liệu |
IHttpHelper.DataSizeException |
nếu dữ liệu được truy xuất > MAX_DATA_SIZE |
doPostWithRetry
public abstract String doPostWithRetry (String url,
String postData)Thực hiện phương thức yêu cầu POST HTTP cho một URL nhất định và trả về phương thức đó dưới dạng String, thử lại khi không thành công.
Vì nội dung từ xa được tải vào bộ nhớ, nên phương thức này chỉ nên được dùng cho 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 được mở |
| Giá trị trả về | |
|---|---|
String |
nội dung từ xa String |
| Gửi | |
|---|---|
|
nếu không truy xuất được dữ liệu |
IHttpHelper.DataSizeException |
nếu dữ liệu được truy xuất > MAX_DATA_SIZE |
doPostWithRetry
public abstract String doPostWithRetry (String url,
String postData,
String contentType)Thực hiện phương thức yêu cầu POST HTTP cho một URL nhất định và trả về phương thức đó dưới dạng String, thử lại khi không thành công.
Vì nội dung từ xa được tải vào bộ nhớ, nên phương thức này chỉ nên được dùng cho 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 được 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 | |
|---|---|
|
nếu không truy xuất được dữ liệu |
IHttpHelper.DataSizeException |
nếu dữ liệu được truy xuất > MAX_DATA_SIZE |
getInitialPollInterval
public abstract int getInitialPollInterval ()
Lấy khoảng thời gian thăm dò ý kiến 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ò ý kiến tối đa tính bằng mili giây.
| Giá trị trả về | |
|---|---|
int |
|
getMaxTime
public abstract int getMaxTime ()
Nhận thời gian tối đa để tiếp tục thử yêu cầu tính bằng 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ò ý kiến 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ò ý kiến 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ử 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 |