HttpHelper

public class HttpHelper
extends Object implements IHttpHelper

java.lang.Object
   ↳ com.android.tradefed.util.net.HttpHelper

يحتوي على طرق مساعدة لإنشاء طلبات http

ملخّص

الفئات المُدمجة

class HttpHelper.RequestRunnable

قابل للتنفيذ لتقديم طلبات باستخدام IRunUtil#runEscalatingTimedRetry(long, long, long, long, IRunnableResult). 

وظائف الإنشاء العامة

HttpHelper()

الطرق العامة

String buildParameters(MultiMap<String, String> paramMap)

أنشِئ سلسلة المَعلمة المشفَّرة.

String buildUrl(String baseUrl, MultiMap<String, String> paramMap)

أنشئ سلسلة طلب عنوان URL المرمّز الكاملة.

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

أنشئ عنوان URL إلى عنوان URL معيّن.

HttpURLConnection createJsonConnection(URL url, String method)

ينشئ رابطًا لعنوان URL المحدد لتمرير بيانات JSON.

HttpURLConnection createXmlConnection(URL url, String method)

لإنشاء اتصال بعنوان URL معيّن لتمرير بيانات xml.

void doGet(String url, OutputStream outputStream)

تُنفِّذ طريقة طلب HTTP GET لعنوان URL معيّن وتُرسِل النتيجة إلى ERROR(/OutputStream).

String doGet(String url)

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

void doGetIgnore(String url)

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

void doGetIgnoreWithRetry(String url)

تُجري {doGetIgnore(String) عملية إعادة محاولة عند حدوث خطأ.

String doGetWithRetry(String url)

تُجري {doGet(String) عملية إعادة محاولة عند حدوث خطأ.

String doPostWithRetry(String url, String postData)

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

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

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

int getInitialPollInterval()

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

int getMaxPollInterval()

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

int getMaxTime()

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

int getOpTimeout()

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

IRunUtil getRunUtil()

يمكنك الحصول على مساحة تخزين بسعة IRunUtil.

void setInitialPollInterval(int time)

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

void setMaxPollInterval(int time)

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

void setMaxTime(int time)

حدِّد الحد الأقصى للوقت لمواصلة محاولة إرسال الطلب بالمللي ثانية.

void setOpTimeout(int time)

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

وظائف الإنشاء العامة

HttpHelper

public HttpHelper ()

الطرق العامة

buildParameters

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

أنشئ سلسلة المَعلمات المشفّرة.

المعلمات
paramMap MultiMap: مَعلمات عناوين URL
المرتجعات
String سلسلة المَعلمة المُشفَّرة

buildUrl

public String buildUrl (String baseUrl, 
                MultiMap<String, String> paramMap)

أنشئ سلسلة طلب عنوان URL المشفّرة بالكامل.

المعلمات
baseUrl String: عنوان URL الأساسي
paramMap MultiMap: مَعلمات عنوان URL
المرتجعات
String عنوان URL الذي تم إنشاؤه

createConnection

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

أنشئ عنوان URL معيّنًا.

المعلمات
url URL: ERROR(/URL) المطلوب الاتصال به
method ‫String: طريقة طلب HTTP على سبيل المثال، GET أو POST.
contentType ‫String: نوع المحتوى على سبيل المثال، "text/html".
المرتجعات
HttpURLConnection HttpURLConnection

createJsonConnection

public HttpURLConnection createJsonConnection (URL url, 
                String method)

ينشئ رابطًا بعنوان URL محدَّد لتمرير بيانات JSON.

المعلمات
url URL: الجهاز ERROR(/URL) المطلوب الربط به
method ‫String: طريقة طلب HTTP على سبيل المثال، GET أو POST.
المرتجعات
HttpURLConnection ERROR(/HttpURLConnection)

createXmlConnection

public HttpURLConnection createXmlConnection (URL url, 
                String method)

لإنشاء اتصال بعنوان URL معيّن لتمرير بيانات xml.

المعلمات
url URL: الجهاز ERROR(/URL) المطلوب الربط به
method ‫String: طريقة طلب HTTP على سبيل المثال، GET أو POST.
المرتجعات
HttpURLConnection ERROR(/HttpURLConnection)

doGet

public void doGet (String url, 
                OutputStream outputStream)

تُنفِّذ طريقة طلب HTTP GET لعنوان URL معيّن وتُرسِل النتيجة إلى ERROR(/OutputStream).

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

الحصول على

public String doGet (String url)

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

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

References:

المعلمات
url String: عنوان URL
المرتجعات
String محتوى جهاز التحكّم عن بُعد في String
عمليات الرمي
IHttpHelper.DataSizeException

doGetIgnore

public void doGetIgnore (String url)

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

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

doGetIgnoreWithRetry

public void doGetIgnoreWithRetry (String url)

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

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

doGetWithRetry

public String doGetWithRetry (String url)

تُجري {doGet(String) عملية إعادة محاولة عند حدوث خطأ.

المعلمات
url String: عنوان URL
المرتجعات
String محتوى جهاز التحكّم عن بُعد في String
عمليات الرمي
IHttpHelper.DataSizeException

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

public String doPostWithRetry (String url, 
                String postData)

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

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

المعلمات
url String: عنوان URL
postData String: البيانات التي سيتم نشرها بعد فتح الاتصال
المرتجعات
String محتوى جهاز التحكّم عن بُعد في String
عمليات الرمي
IHttpHelper.DataSizeException

doPostWithRetry

public 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

getInitialPollInterval

public int getInitialPollInterval ()

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

المرتجعات
int

getMaxPollInterval

public int getMaxPollInterval ()

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

المرتجعات
int

getMaxTime

public int getMaxTime ()

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

المرتجعات
int

getOpTimeout

public int getOpTimeout ()

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

المرتجعات
int

getRunUtil

public IRunUtil getRunUtil ()

الحصول على IRunUtil لاستخدامه معرّضة للكهرباء كي تتمكّن من محاكاة اختبارات الوحدة.

المرتجعات
IRunUtil

setInitialPollInterval

public void setInitialPollInterval (int time)

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

المعلمات
time int

setMaxPollInterval

public void setMaxPollInterval (int time)

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

المعلمات
time int

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

public void setMaxTime (int time)

حدِّد الحد الأقصى للوقت لمواصلة محاولة إرسال الطلب بالمللي ثانية.

المعلمات
time int

setOpTimeout

public void setOpTimeout (int time)

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

المعلمات
time int