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 إلى عنوان 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)
تُنفِّذ طريقة طلب HTTP GET لعنوان URL معيّن وتُرسِل النتيجة إلى
|
abstract
String
|
doGet(String url)
تُنفِّذ طريقة طلب 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)
الطرق العامة
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) |
| عمليات الرمي | |
|---|---|
|
في حال تعذّر إجراء عملية الربط |
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)تُنفِّذ طريقة طلب HTTP GET لعنوان URL معيّن وتُرسِل النتيجة إلى
ERROR(/OutputStream).
| المعلمات | |
|---|---|
url |
String: عنوان URL |
outputStream |
OutputStream: مصدر بيانات الردّ |
| عمليات الرمي | |
|---|---|
|
في حال تعذّر استرداد البيانات |
راجِع أيضًا:
doGet
public abstract String doGet (String url)
تُنفِّذ طريقة طلب HTTP GET لعنوان URL معيّن وتُعيده كقيمة String.
وبما أنّه يتم تحميل المحتوى البعيد في الذاكرة، يجب عدم استخدام هذه الطريقة إلا مع أحجام البيانات الصغيرة نسبيًا.
References:
- ربط عنوان URL في Java: 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: http://java.sun.com/docs/books/tutorial/networking/urls/_setProxy.html
| المعلمات | |
|---|---|
url |
String: عنوان URL |
| المرتجعات | |
|---|---|
String |
محتوى جهاز التحكّم عن بُعد في String |
| عمليات الرمي | |
|---|---|
|
في حال تعذّر استرداد البيانات |
IHttpHelper.DataSizeException |
إذا كانت البيانات التي تم استرجاعها > 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 |
إذا كانت البيانات التي تم استرجاعها > MAX_DATA_SIZE |
doPostWithRetry
public abstract String doPostWithRetry (String url,
String postData)تُنفِّذ طريقة طلب HTTP POST لعنوان URL معيّن وتُعيده كString،
مع إعادة المحاولة في حال تعذّر إكمالها.
وبما أنّه يتم تحميل المحتوى البعيد في الذاكرة، يجب عدم استخدام هذه الطريقة إلا مع أحجام البيانات الصغيرة نسبيًا.
| المعلمات | |
|---|---|
url |
String: عنوان URL |
postData |
String: البيانات التي سيتم نشرها بعد فتح الاتصال |
| المرتجعات | |
|---|---|
String |
محتوى جهاز التحكّم عن بُعد في String |
| عمليات الرمي | |
|---|---|
|
في حال تعذّر استرداد البيانات |
IHttpHelper.DataSizeException |
إذا كانت البيانات التي تم استرجاعها > MAX_DATA_SIZE |
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 |
| عمليات الرمي | |
|---|---|
|
في حال تعذّر استرداد البيانات |
IHttpHelper.DataSizeException |
إذا كانت البيانات التي تم استرجاعها > 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 |