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 String doGet(String url)

تنفّذ هذه السمة طريقة طلب استرداد بيانات باستخدام GET HTTP لعنوان URL محدّد وتعرضه كـ String.

abstract void doGet(String url, OutputStream outputStream)

تنفيذ طريقة طلب HTTP GET لعنوان URL معيّن وبث النتيجة إلى OutputStream

abstract void doGetIgnore(String url)

يُجري طلب GET لعنوان URL معيّن، مع تجاهل النتيجة باستخدام مَعلمات عنوان URL المحدّدة.

abstract void doGetIgnoreWithRetry(String url)

يتم تنفيذ {doGetIgnore(String) إعادة محاولة عند التعذّر.

abstract String doGetWithRetry(String url)

يتم تنفيذ {doGet(String) إعادة محاولة عند التعذّر.

abstract String doPostWithRetry(String url, String postData)

تُجري هذه الدالة طلب HTTP POST لعنوان URL معيّن وتعرضه كـ String، مع إعادة المحاولة عند حدوث خطأ.

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

تُجري هذه الدالة طلب HTTP POST لعنوان URL معيّن وتعرضه كـ String، مع إعادة المحاولة عند حدوث خطأ.

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

Constant Value: 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: URL المطلوب الاتصال به
method ‫String: طريقة طلب HTTP على سبيل المثال، GET أو POST.
contentType ‫String: نوع المحتوى على سبيل المثال، "text/html".
المرتجعات
HttpURLConnection ‫HttpURLConnection
عمليات الطرح
IOException إذا حدث IOException.

createJsonConnection

public abstract HttpURLConnection createJsonConnection (URL url, 
                String method)

تنشئ هذه الطريقة اتصالاً بعنوان URL محدّد لتمرير بيانات بتنسيق JSON.

المعلَمات
url URL: URL المطلوب الاتصال به
method ‫String: طريقة طلب HTTP على سبيل المثال، GET أو POST.
المرتجعات
HttpURLConnection HttpURLConnection
عمليات الطرح
IOException في حال تعذّر إجراء عملية الربط

createXmlConnection

public abstract HttpURLConnection createXmlConnection (URL url, 
                String method)

تنشئ هذه السمة اتصالاً بعنوان URL محدّد لتمرير بيانات XML.

المعلَمات
url URL: URL المطلوب الاتصال به
method ‫String: طريقة طلب HTTP على سبيل المثال، GET أو POST.
المرتجعات
HttpURLConnection HttpURLConnection
عمليات الطرح
IOException في حال تعذّر إجراء عملية الربط

doGet

public abstract String doGet (String url)

تنفّذ هذه السمة طريقة طلب استرداد بيانات باستخدام GET HTTP لعنوان URL محدّد وتعرضه كـ String.

بما أنّ المحتوى البعيد يتم تحميله في الذاكرة، يجب استخدام هذه الطريقة فقط مع أحجام البيانات الصغيرة نسبيًا.

المراجع:

المعلَمات
url String: عنوان URL
المرتجعات
String محتوى وحدة التحكّم عن بُعد في جهاز String
عمليات الطرح
IHttpHelper.DataSizeException إذا كانت البيانات المستردّة > MAX_DATA_SIZE
IOException في حال تعذّر استرداد البيانات

doGet

public abstract void doGet (String url, 
                OutputStream outputStream)

تنفيذ طريقة طلب HTTP GET لعنوان URL معيّن وبث النتيجة إلى OutputStream

المعلَمات
url String: عنوان URL
outputStream ‫OutputStream: مصدر بيانات الرد
عمليات الطرح
IOException في حال تعذّر استرداد البيانات

يُرجى الاطّلاع أيضًا على:

doGetIgnore

public abstract void doGetIgnore (String url)

يُجري طلب GET لعنوان URL معيّن، مع تجاهل النتيجة باستخدام مَعلمات عنوان URL المحدّدة.

المعلَمات
url String: عنوان URL
عمليات الطرح
IOException في حال تعذّر استرداد البيانات

يُرجى الاطّلاع أيضًا على:

doGetIgnoreWithRetry

public abstract void doGetIgnoreWithRetry (String url)

يتم تنفيذ {doGetIgnore(String) إعادة محاولة عند التعذّر.

المعلَمات
url String: عنوان URL
عمليات الطرح
IOException في حال تعذّر استرداد البيانات

doGetWithRetry

public abstract String doGetWithRetry (String url)

يتم تنفيذ {doGet(String) إعادة محاولة عند التعذّر.

المعلَمات
url String: عنوان URL
المرتجعات
String محتوى وحدة التحكّم عن بُعد في جهاز String
عمليات الطرح
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
عمليات الطرح
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
عمليات الطرح
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