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: مصدر بيانات الردّ

doGet

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

doPostWithRetry

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

setMaxTime

public void setMaxTime (int time)

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

المعلمات
time int

setOpTimeout

public void setOpTimeout (int time)

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

المعلمات
time int