صفحة المساعدة بتنسيق IHttpHelper

public interface IHttpHelper

com.android.tradefed.util.net.IHttpHelper

الفئات الفرعية المعروفة غير المباشرة HttpHelper HttpHelper يحتوي على طرق مساعدة لإجراء طلبات http

---

الطرق المساعدة لتنفيذ طلبات 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 معين ويؤدي إلى بث النتيجة إلى ERROR(/OutputStream)
abstract String	doGet(String url) لتنفيذ طريقة طلب GET HTTP لعنوان URL معين وعرضه على هيئة String.
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) لتنفيذ طريقة طلب POST HTTP لعنوان URL محدد وعرضه على هيئة String، إعادة المحاولة عند الإخفاق.
abstract String	doPostWithRetry(String url, String postData, String contentType) لتنفيذ طريقة طلب POST HTTP لعنوان 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) اضبط مهلة العملية بالملي ثانية.

الثوابت

الحد الأقصى للحجم

public static final int MAX_DATA_SIZE

القيمة الثابتة: 65536 (0x00010000)

الطرق العامة

معلّمات التصميم

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	في حالة حدوث استثناء، ترميز المعاملات.

إنشاء اتصال

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)

الرميات
	في حال تعذّر إجراء اتصال

الحصول على

public abstract void doGet (String url, 
                OutputStream outputStream)

لتنفيذ طريقة طلب GET HTTP لعنوان URL معين ويؤدي إلى بث النتيجة إلى ERROR(/OutputStream)

المعلمات
url	String: عنوان URL
outputStream	OutputStream: مصدر بيانات الردّ

الرميات
	في حال فشل استرداد البيانات

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

• doGet(String)

الحصول على

public abstract String doGet (String url)

لتنفيذ طريقة طلب GET HTTP لعنوان URL معين وعرضه على هيئة String.

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

References:

• اتصال عنوان URL في Java: http://java.sun.com/docs/books/Tutorial/networking/urls/readingWrite.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

تجاهل

public abstract void doGetIgnore (String url)

لإجراء عملية GET لعنوان URL معين، مع تجاهل معلمات عنوان URL المحددة النتيجة.

المعلمات
url	String: عنوان URL

الرميات
	في حال فشل استرداد البيانات

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

• doGet(String)

عدم تجاهل الأمر مع إعادة المحاولة

public abstract void doGetIgnoreWithRetry (String url)

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

المعلمات
url	String: عنوان URL

الرميات
	في حال فشل استرداد البيانات

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

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

إعادة المحاولة

public abstract String doGetWithRetry (String url)

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

المعلمات
url	String: عنوان URL

المرتجعات
String	المحتوى عن بُعد على جهاز String

الرميات
	في حال فشل استرداد البيانات
IHttpHelper.DataSizeException	إذا كانت البيانات المستردة > MAX_DATA_SIZE

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

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

DoPostWithإعادة المحاولة

public abstract String doPostWithRetry (String url, 
                String postData)

لتنفيذ طريقة طلب POST HTTP لعنوان URL محدد وعرضه على هيئة String، إعادة المحاولة عند الإخفاق.

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

المعلمات
url	String: عنوان URL
postData	String: البيانات التي سيتم نشرها بعد فتح الاتصال

المرتجعات
String	المحتوى عن بُعد على جهاز String

الرميات
	في حال فشل استرداد البيانات
IHttpHelper.DataSizeException	إذا كانت البيانات المستردة > MAX_DATA_SIZE

DoPostWithإعادة المحاولة

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	إذا كانت البيانات المستردة > MAX_DATA_SIZE

الحصول على فاصل أول

public abstract int getInitialPollInterval ()

الحصول على الفاصل الزمني الأولي للاستطلاع بالمللي ثانية

المرتجعات
int

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

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

الحصول على MaxPollInterval

public abstract int getMaxPollInterval ()

الحصول على الحد الأقصى للفاصل الزمني للاستطلاع بالمللي ثانية

المرتجعات
int

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

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

الحصول على MaxTime

public abstract int getMaxTime ()

الحصول على الحد الأقصى من الوقت لمواصلة محاولة الطلب بالملّي ثانية.

المرتجعات
int

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

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

الحصول على مهلة

public abstract int getOpTimeout ()

الحصول على مهلة العملية بالملي ثانية

المرتجعات
int

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

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

مَعلمة setInitialPollInterval

public abstract void setInitialPollInterval (int time)

حدِّد الفاصل الزمني الأولي للاستطلاع بالمللي ثانية.

المعلمات
time	int

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

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

مَعلمة setMaxPollInterval

public abstract void setMaxPollInterval (int time)

حدِّد الفاصل الزمني الأولي للاستطلاع بالمللي ثانية.

المعلمات
time	int

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

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

ضبط الحد الأقصى للوقت

public abstract void setMaxTime (int time)

يُرجى ضبط الحد الأقصى للوقت لمواصلة محاولة الطلب بالملي ثانية.

المعلمات
time	int

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

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

ضبط المهلة

public abstract void setOpTimeout (int time)

اضبط مهلة العملية بالملي ثانية.

المعلمات
time	int

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

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)