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)

בנה את מחרוזת הבקשות המלאה של כתובת האתר המקודדת.

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 נתונה ומזרים תוצאה ל- ERROR(/OutputStream) .

abstract String doGet (String url)

מבצע שיטת בקשת HTTP עבור כתובת URL נתונה ומחזיר אותה String .

abstract void doGetIgnore (String url)

מבצע GET עבור כתובת אתר נתונה, כאשר הפרמטרים הנתונים של כתובת האתר מתעלמים מהתוצאה.

abstract void doGetIgnoreWithRetry (String url)

מבצע { doGetIgnore(String) ניסיון חוזר במקרה של כישלון.

abstract String doGetWithRetry (String url)

מבצע { doGet(String) ניסיון חוזר בעת כישלון.

abstract String doPostWithRetry (String url, String postData)

מבצע שיטת בקשת POST HTTP עבור כתובת URL נתונה ומחזיר אותה String , מנסה שוב במקרה של כשל.

abstract String doPostWithRetry (String url, String postData, String contentType)

מבצע שיטת בקשת POST HTTP עבור כתובת URL נתונה ומחזיר אותה String , מנסה שוב במקרה של כשל.

abstract int getInitialPollInterval ()

קבל את מרווח הסקר הראשוני ב-ms.

abstract int getMaxPollInterval ()

קבל את מרווח הסקר המקסימלי ב-ms.

abstract int getMaxTime ()

קבל את הזמן המקסימלי להמשיך לנסות את הבקשה ב-ms.

abstract int getOpTimeout ()

קבל את פסק הזמן של הפעולה ב-ms.

abstract void setInitialPollInterval (int time)

הגדר את מרווח הסקר הראשוני ב-ms.

abstract void setMaxPollInterval (int time)

הגדר את מרווח הסקר הראשוני ב-ms.

abstract void setMaxTime (int time)

הגדר את הזמן המרבי כדי להמשיך לנסות את הבקשה ב-ms.

abstract void setOpTimeout (int time)

הגדר את פסק הזמן של הפעולה ב-ms.

קבועים

MAX_DATA_SIZE

public static final int MAX_DATA_SIZE

ערך קבוע: 65536 (0x00010000)

שיטות ציבוריות

buildParameters

public abstract String buildParameters (MultiMap<String, String> paramMap)

בנה את מחרוזת הפרמטרים המקודדת.

פרמטרים
paramMap MultiMap : הפרמטרים של כתובת האתר

החזרות
String מחרוזת הפרמטרים המקודדת

זורק
IllegalArgumentException אם מתרחש חריג, קידוד הפרמטרים.

buildUrl

public abstract String buildUrl (String url, 
                MultiMap<String, String> paramMap)

בנה את מחרוזת הבקשות המלאה של כתובת האתר המקודדת.

פרמטרים
url String : כתובת האתר הבסיסית

paramMap MultiMap : הפרמטרים של כתובת האתר

החזרות
String כתובת האתר שנבנתה

זורק
IllegalArgumentException אם מתרחש חריג, קידוד הפרמטרים.

ליצור חיבור

public abstract HttpURLConnection createConnection (URL url, 
                String method, 
                String contentType)

צור כתובת URL נתונה.

פרמטרים
url URL : ERROR(/URL) שאליה יש להתחבר.

method String : שיטת בקשת HTTP. לדוגמה, GET או POST.

contentType String : סוג התוכן. לדוגמה, "טקסט/html".

החזרות
HttpURLConnection ה-HttpURLCnection

זורק
אם מתרחשת IOException.

צור JsonConnection

public abstract HttpURLConnection createJsonConnection (URL url, 
                String method)

יוצר חיבור לכתובת URL נתונה להעברת נתוני json.

פרמטרים
url URL : ERROR(/URL) שאליה יש להתחבר.

method String : שיטת בקשת HTTP. לדוגמה, GET או POST.

החזרות
HttpURLConnection ה- ERROR(/HttpURLConnection)

זורק
אם לא הצליח ליצור חיבור

createXmlConnection

public abstract HttpURLConnection createXmlConnection (URL url, 
                String method)

יוצר חיבור לכתובת URL נתונה להעברת נתוני XML.

פרמטרים
url URL : ERROR(/URL) שאליה יש להתחבר.

method String : שיטת בקשת HTTP. לדוגמה, GET או POST.

החזרות
HttpURLConnection ה- ERROR(/HttpURLConnection)

זורק
אם לא הצליח ליצור חיבור

doGet

public abstract void doGet (String url, 
                OutputStream outputStream)

מבצע שיטת בקשת GET HTTP עבור כתובת URL נתונה ומזרים תוצאה ל- ERROR(/OutputStream) .

פרמטרים
url String : כתובת האתר

outputStream OutputStream : זרם של נתוני התגובה

זורק
אם לא הצליח לאחזר נתונים

ראה גם:

doGet

public abstract String doGet (String url)

מבצע שיטת בקשת HTTP עבור כתובת URL נתונה ומחזיר אותה String .

מכיוון שתוכן מרוחק נטען לזיכרון, יש להשתמש בשיטה זו רק עבור גדלי נתונים קטנים יחסית.

הפניות:

פרמטרים
url String : כתובת האתר

החזרות
String התוכן מרחוק String

זורק
אם לא הצליח לאחזר נתונים
IHttpHelper.DataSizeException אם הנתונים שאוחזרו הם > MAX_DATA_SIZE

doGetIgnore

public abstract void doGetIgnore (String url)

מבצע GET עבור כתובת אתר נתונה, כאשר הפרמטרים הנתונים של כתובת האתר מתעלמים מהתוצאה.

פרמטרים
url String : כתובת האתר

זורק
אם לא הצליח לאחזר נתונים

ראה גם:

doGetIgnoreWithRetry

public abstract void doGetIgnoreWithRetry (String url)

מבצע { doGetIgnore(String) ניסיון חוזר במקרה של כישלון.

פרמטרים
url String : כתובת האתר

זורק
אם לא הצליח לאחזר נתונים

doGetWithRetry

public abstract String doGetWithRetry (String url)

מבצע { doGet(String) ניסיון חוזר בעת כישלון.

פרמטרים
url String : כתובת האתר

החזרות
String התוכן מרחוק String

זורק
אם לא הצליח לאחזר נתונים
IHttpHelper.DataSizeException אם הנתונים שאוחזרו הם > MAX_DATA_SIZE

doPostWithRetry

public abstract String doPostWithRetry (String url, 
                String postData)

מבצע שיטת בקשת POST HTTP עבור כתובת URL נתונה ומחזיר אותה String , מנסה שוב במקרה של כשל.

מכיוון שתוכן מרוחק נטען לזיכרון, יש להשתמש בשיטה זו רק עבור גדלי נתונים קטנים יחסית.

פרמטרים
url String : כתובת האתר

postData String : הנתונים שיתפרסמו ברגע שהחיבור נפתח

החזרות
String התוכן מרחוק String

זורק
אם לא הצליח לאחזר נתונים
IHttpHelper.DataSizeException אם הנתונים שאוחזרו הם > MAX_DATA_SIZE

doPostWithRetry

public abstract String doPostWithRetry (String url, 
                String postData, 
                String contentType)

מבצע שיטת בקשת POST HTTP עבור כתובת URL נתונה ומחזיר אותה String , מנסה שוב במקרה של כשל.

מכיוון שתוכן מרוחק נטען לזיכרון, יש להשתמש בשיטה זו רק עבור גדלי נתונים קטנים יחסית.

פרמטרים
url String : כתובת האתר

postData String : הנתונים שיתפרסמו ברגע שהחיבור נפתח

contentType String : סוג התוכן. לדוגמה, "טקסט/html".

החזרות
String התוכן מרחוק String

זורק
אם לא הצליח לאחזר נתונים
IHttpHelper.DataSizeException אם הנתונים שאוחזרו הם > MAX_DATA_SIZE

getInitialPollInterval

public abstract int getInitialPollInterval ()

קבל את מרווח הסקר הראשוני ב-ms.

החזרות
int

getMaxPollInterval

public abstract int getMaxPollInterval ()

קבל את מרווח הסקר המקסימלי ב-ms.

החזרות
int

getMaxTime

public abstract int getMaxTime ()

קבל את הזמן המקסימלי להמשיך לנסות את הבקשה ב-ms.

החזרות
int

getOpTimeout

public abstract int getOpTimeout ()

קבל את פסק הזמן של הפעולה ב-ms.

החזרות
int

setInitialPollInterval

public abstract void setInitialPollInterval (int time)

הגדר את מרווח הסקר הראשוני ב-ms.

פרמטרים
time int

setMaxPollInterval

public abstract void setMaxPollInterval (int time)

הגדר את מרווח הסקר הראשוני ב-ms.

פרמטרים
time int

setMaxTime

public abstract void setMaxTime (int time)

הגדר את הזמן המרבי כדי להמשיך לנסות את הבקשה ב-ms.

פרמטרים
time int

setOpTimeout

public abstract void setOpTimeout (int time)

הגדר את פסק הזמן של הפעולה ב-ms.

פרמטרים
time int