IHttpHelper
public
interface
IHttpHelper
| com.android.tradefed.util.net.IHttpHelper |
שיטות עזר לביצוע בקשות HTTP.
סיכום
כיתות מוטמעות | |
|---|---|
class |
IHttpHelper.DataSizeException
|
ערכים קבועים | |
|---|---|
int |
MAX_DATA_SIZE
|
methods ציבוריים | |
|---|---|
abstract
String
|
buildParameters(MultiMap<String, String> paramMap)
יוצרים את מחרוזת הפרמטרים המקודדת. |
abstract
String
|
buildUrl(String url, MultiMap<String, String> paramMap)
יוצרים את מחרוזת הבקשה המלאה של כתובת ה-URL המקודדת. |
abstract
HttpURLConnection
|
createConnection(URL url, String method, String contentType)
יוצרים כתובת URL נתונה. |
abstract
HttpURLConnection
|
createJsonConnection(URL url, String method)
יוצר חיבור לכתובת URL נתונה כדי להעביר נתוני JSON. |
abstract
HttpURLConnection
|
createXmlConnection(URL url, String method)
יוצר חיבור לכתובת URL נתונה כדי להעביר נתוני XML. |
abstract
String
|
doGet(String url)
מבצעת method של בקשת HTTP GET לכתובת URL נתונה ומחזירה אותה כ- |
abstract
void
|
doGet(String url, OutputStream outputStream)
מבצע שיטת בקשת HTTP GET לכתובת URL נתונה ומזרים את התוצאה אל
|
abstract
void
|
doGetIgnore(String url)
מבצע GET לכתובת URL נתונה, עם פרמטרים נתונים של כתובת ה-URL, ומתעלם מהתוצאה. |
abstract
void
|
doGetIgnoreWithRetry(String url)
מבצע { |
abstract
String
|
doGetWithRetry(String url)
מבצע { |
abstract
String
|
doPostWithRetry(String url, String postData)
מבצע שיטת בקשת HTTP POST לכתובת URL נתונה ומחזיר אותה כ- |
abstract
String
|
doPostWithRetry(String url, String postData, String contentType)
מבצע שיטת בקשת HTTP POST לכתובת URL נתונה ומחזיר אותה כ- |
abstract
int
|
getInitialPollInterval()
קבלת מרווח הזמן הראשוני של הסקר באלפיות השנייה. |
abstract
int
|
getMaxPollInterval()
מקבלים את מרווח הזמן המקסימלי בין סקרים באלפיות השנייה. |
abstract
int
|
getMaxTime()
מקבלים את משך הזמן המקסימלי לניסיון חוזר של הבקשה במילישניות. |
abstract
int
|
getOpTimeout()
קבלת הזמן הקצוב לתפוגה של הפעולה באלפיות השנייה. |
abstract
void
|
setInitialPollInterval(int time)
הגדרת מרווח הסקר הראשוני במילישניות. |
abstract
void
|
setMaxPollInterval(int time)
הגדרת מרווח הסקר הראשוני במילישניות. |
abstract
void
|
setMaxTime(int time)
מגדירים את משך הזמן המקסימלי לניסיון חוזר של הבקשה במילישניות. |
abstract
void
|
setOpTimeout(int time)
מגדירים את הזמן הקצוב לתפוגה של הפעולה באלפיות השנייה. |
ערכים קבועים
MAX_DATA_SIZE
public static final int MAX_DATA_SIZE
ערך קבוע: 65536 (0x00010000)
methods ציבוריים
buildParameters
public abstract String buildParameters (MultiMap<String, String> paramMap)
יוצרים את מחרוזת הפרמטרים המקודדת.
| פרמטרים | |
|---|---|
paramMap |
MultiMap: הפרמטרים של כתובת ה-URL |
| החזרות | |
|---|---|
String |
מחרוזת הפרמטרים המקודדת |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
IllegalArgumentException |
אם מתרחשת חריגה בקידוד הפרמטרים. |
buildUrl
public abstract String buildUrl (String url,
MultiMap<String, String> paramMap)יוצרים את המחרוזת המלאה של בקשת כתובת ה-URL המקודדת.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL הבסיסית |
paramMap |
MultiMap: הפרמטרים של כתובת ה-URL |
| החזרות | |
|---|---|
String |
כתובת ה-URL שנבנתה |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
IllegalArgumentException |
אם מתרחשת חריגה בקידוד הפרמטרים. |
createConnection
public abstract HttpURLConnection createConnection (URL url,
String method,
String contentType)יוצרים כתובת URL נתונה.
| פרמטרים | |
|---|---|
url |
URL: URL שאליו רוצים להתחבר. |
method |
String: ה-method של בקשת ה-HTTP. לדוגמה, GET או POST. |
contentType |
String: סוג התוכן. לדוגמה, "text/html". |
| החזרות | |
|---|---|
HttpURLConnection |
HttpURLConnection |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
IOException |
אם מתרחשת שגיאת קלט/פלט. |
createJsonConnection
public abstract HttpURLConnection createJsonConnection (URL url,
String method)יוצר חיבור לכתובת URL נתונה כדי להעביר נתוני JSON.
| פרמטרים | |
|---|---|
url |
URL: URL שאליו רוצים להתחבר. |
method |
String: ה-method של בקשת ה-HTTP. לדוגמה, GET או POST. |
| החזרות | |
|---|---|
HttpURLConnection |
HttpURLConnection |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
IOException |
אם החיבור נכשל |
createXmlConnection
public abstract HttpURLConnection createXmlConnection (URL url,
String method)יוצר חיבור לכתובת URL נתונה כדי להעביר נתוני XML.
| פרמטרים | |
|---|---|
url |
URL: URL שאליו רוצים להתחבר. |
method |
String: ה-method של בקשת ה-HTTP. לדוגמה, GET או POST. |
| החזרות | |
|---|---|
HttpURLConnection |
HttpURLConnection |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
IOException |
אם החיבור נכשל |
doGet
public abstract String doGet (String url)
מבצעת method של בקשת HTTP GET לכתובת URL נתונה ומחזירה אותה כ-String.
התוכן המרוחק נטען לזיכרון, ולכן השיטה הזו מתאימה רק לגדלי נתונים קטנים יחסית.
מקורות מידע:
- Java URL Connection: http://java.sun.com/docs/books/tutorial/networking/urls/readingWriting.html
- קורא כתובות 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
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
| החזרות | |
|---|---|
String |
התוכן המרוחק String |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
IHttpHelper.DataSizeException |
אם הנתונים שאוחזרו הם > MAX_DATA_SIZE |
IOException |
אם אחזור הנתונים נכשל |
doGet
public abstract void doGet (String url,
OutputStream outputStream)מבצע שיטת בקשת HTTP GET לכתובת URL נתונה ומזרים את התוצאה אל OutputStream.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
outputStream |
OutputStream: מקור נתונים של התגובה |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
IOException |
אם אחזור הנתונים נכשל |
מידע נוסף:
doGetIgnore
public abstract void doGetIgnore (String url)
מבצע GET לכתובת URL נתונה, עם פרמטרים נתונים של כתובת ה-URL, ומתעלם מהתוצאה.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
IOException |
אם אחזור הנתונים נכשל |
מידע נוסף:
doGetIgnoreWithRetry
public abstract void doGetIgnoreWithRetry (String url)
מבצע {doGetIgnore(String) ניסיונות חוזרים במקרה של כשל.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
IOException |
אם אחזור הנתונים נכשל |
doGetWithRetry
public abstract String doGetWithRetry (String url)
מבצע {doGet(String) ניסיונות חוזרים במקרה של כשל.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
| החזרות | |
|---|---|
String |
התוכן המרוחק String |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
IHttpHelper.DataSizeException |
אם הנתונים שאוחזרו הם > MAX_DATA_SIZE |
IOException |
אם אחזור הנתונים נכשל |
doPostWithRetry
public abstract String doPostWithRetry (String url,
String postData)מבצע שיטת בקשת HTTP POST לכתובת URL נתונה ומחזיר אותה כ-String, ומנסה שוב אם הפעולה נכשלת.
התוכן המרוחק נטען לזיכרון, ולכן השיטה הזו מתאימה רק לגדלי נתונים קטנים יחסית.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
postData |
String: הנתונים שיישלחו ברגע שהחיבור ייפתח |
| החזרות | |
|---|---|
String |
התוכן המרוחק String |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
IHttpHelper.DataSizeException |
אם הנתונים שאוחזרו הם > MAX_DATA_SIZE |
IOException |
אם אחזור הנתונים נכשל |
doPostWithRetry
public abstract String doPostWithRetry (String url,
String postData,
String contentType)מבצע שיטת בקשת HTTP POST לכתובת URL נתונה ומחזיר אותה כ-String, ומנסה שוב אם הפעולה נכשלת.
התוכן המרוחק נטען לזיכרון, ולכן השיטה הזו מתאימה רק לגדלי נתונים קטנים יחסית.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
postData |
String: הנתונים שיישלחו ברגע שהחיבור ייפתח |
contentType |
String: סוג התוכן. לדוגמה, "text/html". |
| החזרות | |
|---|---|
String |
התוכן המרוחק String |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
IHttpHelper.DataSizeException |
אם הנתונים שאוחזרו הם > MAX_DATA_SIZE |
IOException |
אם אחזור הנתונים נכשל |
getInitialPollInterval
public abstract int getInitialPollInterval ()
קבלת מרווח הזמן הראשוני של הסקר באלפיות השנייה.
| החזרות | |
|---|---|
int |
|
getMaxPollInterval
public abstract int getMaxPollInterval ()
מקבלים את מרווח הזמן המקסימלי בין סקרים באלפיות השנייה.
| החזרות | |
|---|---|
int |
|
getMaxTime
public abstract int getMaxTime ()
מקבלים את משך הזמן המקסימלי לניסיון חוזר של הבקשה במילישניות.
| החזרות | |
|---|---|
int |
|
getOpTimeout
public abstract int getOpTimeout ()
קבלת הזמן הקצוב לתפוגה של הפעולה באלפיות השנייה.
| החזרות | |
|---|---|
int |
|
setInitialPollInterval
public abstract void setInitialPollInterval (int time)
הגדרת מרווח הסקר הראשוני במילישניות.
| פרמטרים | |
|---|---|
time |
int |
setMaxPollInterval
public abstract void setMaxPollInterval (int time)
הגדרת מרווח הסקר הראשוני במילישניות.
| פרמטרים | |
|---|---|
time |
int |
setMaxTime
public abstract void setMaxTime (int time)
מגדירים את משך הזמן המקסימלי לניסיון חוזר של הבקשה במילישניות.
| פרמטרים | |
|---|---|
time |
int |
setOpTimeout
public abstract void setOpTimeout (int time)
מגדירים את הזמן הקצוב לתפוגה של הפעולה באלפיות השנייה.
| פרמטרים | |
|---|---|
time |
int |