IHttpHelper
public
interface
IHttpHelper
| com.android.tradefed.util.net.IHttpHelper |
שיטות עזר לביצוע בקשות HTTP.
סיכום
כיתות בתצוגת עץ | |
|---|---|
class |
IHttpHelper.DataSizeException
|
קבועים | |
|---|---|
int |
MAX_DATA_SIZE
|
שיטות ציבוריות | |
|---|---|
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
void
|
doGet(String url, OutputStream outputStream)
הפונקציה מבצעת שיטת בקשה GET של HTTP לכתובת URL נתונה ומעבירה את התוצאה בסטרימינג ל- |
abstract
String
|
doGet(String url)
הפונקציה מבצעת method של בקשת 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)
הפונקציה מבצעת שיטת בקשה של POST HTTP לכתובת URL נתונה ומחזירה אותה בתור |
abstract
String
|
doPostWithRetry(String url, String postData, String contentType)
הפונקציה מבצעת שיטת בקשה של POST HTTP לכתובת 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)
שיטות ציבוריות
buildParameters
public abstract String buildParameters (MultiMap<String, String> paramMap)
יוצרים את מחרוזת הפרמטרים הקודדת.
| פרמטרים | |
|---|---|
paramMap |
MultiMap: הפרמטרים של כתובת ה-URL |
| החזרות | |
|---|---|
String |
מחרוזת הפרמטר המקודדת |
| זריקות | |
|---|---|
IllegalArgumentException |
אם מתרחשת חריגה במהלך קידוד הפרמטרים. |
buildUrl
public abstract String buildUrl (String url,
MultiMap<String, String> paramMap)יוצרים את מחרוזת הבקשה המלאה של כתובת ה-URL המקודדת.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL הבסיסית |
paramMap |
MultiMap: הפרמטרים של כתובת ה-URL |
| החזרות | |
|---|---|
String |
כתובת ה-URL שנוצרה |
| זריקות | |
|---|---|
IllegalArgumentException |
אם מתרחשת חריגה במהלך קידוד הפרמטרים. |
createConnection
public abstract HttpURLConnection createConnection (URL url,
String method,
String contentType)יצירת כתובת URL נתונה.
| פרמטרים | |
|---|---|
url |
URL: ה-ERROR(/URL) שאליו רוצים להתחבר. |
method |
String: שיטת הבקשה של ה-HTTP. לדוגמה, GET או POST. |
contentType |
String: סוג התוכן. לדוגמה, "text/html". |
| החזרות | |
|---|---|
HttpURLConnection |
HttpURLConnection |
| זריקות | |
|---|---|
|
אם מתרחשת IOException. |
createJsonConnection
public abstract HttpURLConnection createJsonConnection (URL url,
String method)יצירת חיבור לכתובת URL נתונה להעברת נתוני JSON.
| פרמטרים | |
|---|---|
url |
URL: ה-ERROR(/URL) שאליו רוצים להתחבר. |
method |
String: שיטת הבקשה של ה-HTTP. לדוגמה, GET או POST. |
| החזרות | |
|---|---|
HttpURLConnection |
ERROR(/HttpURLConnection) |
| זריקות | |
|---|---|
|
if failed to make connection |
createXmlConnection
public abstract HttpURLConnection createXmlConnection (URL url,
String method)יצירת חיבור לכתובת URL נתונה להעברת נתוני XML.
| פרמטרים | |
|---|---|
url |
URL: ה-ERROR(/URL) שאליו רוצים להתחבר. |
method |
String: שיטת הבקשה של ה-HTTP. לדוגמה, GET או POST. |
| החזרות | |
|---|---|
HttpURLConnection |
ERROR(/HttpURLConnection) |
| זריקות | |
|---|---|
|
if failed to make connection |
doGet
public abstract void doGet (String url,
OutputStream outputStream)הפונקציה מבצעת שיטת בקשה GET של HTTP לכתובת URL נתונה ומעבירה את התוצאה בסטרימינג ל-ERROR(/OutputStream).
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
outputStream |
OutputStream: מקור הנתונים של התגובה |
| זריקות | |
|---|---|
|
אם אחזור הנתונים נכשל |
מידע נוסף:
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
- Java URL Reader: http://java.sun.com/docs/books/tutorial/networking/urls/readingURL.html
- הגדרת שרת proxy ב-Java: http://java.sun.com/docs/books/tutorial/networking/urls/_setProxy.html
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
| החזרות | |
|---|---|
String |
התוכן המרוחק של String |
| זריקות | |
|---|---|
|
אם אחזור הנתונים נכשל |
IHttpHelper.DataSizeException |
if retrieved data is > MAX_DATA_SIZE |
doGetIgnore
public abstract void doGetIgnore (String url)
ביצוע בקשת GET לכתובת URL נתונה, כאשר הפרמטרים של כתובת ה-URL הנתונה מתעלמים מהתוצאה.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
| זריקות | |
|---|---|
|
אם אחזור הנתונים נכשל |
מידע נוסף:
doGetIgnoreWithRetry
public abstract void doGetIgnoreWithRetry (String url)
מבצע {doGetIgnore(String) ניסיונות חוזרים במקרה של כשל.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
| זריקות | |
|---|---|
|
אם אחזור הנתונים נכשל |
doGetWithRetry
public abstract String doGetWithRetry (String url)
מבצע {doGet(String) ניסיונות חוזרים במקרה של כשל.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
| החזרות | |
|---|---|
String |
התוכן המרוחק של String |
| זריקות | |
|---|---|
|
אם אחזור הנתונים נכשל |
IHttpHelper.DataSizeException |
if retrieved data is > MAX_DATA_SIZE |
doPostWithRetry
public abstract String doPostWithRetry (String url,
String postData)הפונקציה מבצעת שיטת בקשה של POST HTTP לכתובת URL נתונה ומחזירה אותה בתור String, ומנסה שוב אם הבקשה נכשלה.
מכיוון שהתוכן מרחוק נטען בזיכרון, צריך להשתמש בשיטה הזו רק לנתונים בגודל קטן יחסית.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
postData |
String: הנתונים שיפורסמו ברגע שהחיבור ייפתח |
| החזרות | |
|---|---|
String |
התוכן המרוחק של String |
| זריקות | |
|---|---|
|
אם אחזור הנתונים נכשל |
IHttpHelper.DataSizeException |
if retrieved data is > MAX_DATA_SIZE |
doPostWithRetry
public abstract String doPostWithRetry (String url,
String postData,
String contentType)הפונקציה מבצעת שיטת בקשה של POST HTTP לכתובת URL נתונה ומחזירה אותה בתור String, ומנסה שוב אם הבקשה נכשלה.
מכיוון שהתוכן מרחוק נטען בזיכרון, צריך להשתמש בשיטה הזו רק לנתונים בגודל קטן יחסית.
| פרמטרים | |
|---|---|
url |
String: כתובת ה-URL |
postData |
String: הנתונים שיפורסמו ברגע שהחיבור ייפתח |
contentType |
String: סוג התוכן. לדוגמה, "text/html". |
| החזרות | |
|---|---|
String |
התוכן המרוחק של String |
| זריקות | |
|---|---|
|
אם אחזור הנתונים נכשל |
IHttpHelper.DataSizeException |
if retrieved data is > MAX_DATA_SIZE |
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 |