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 جديد

HttpURLConnection createJsonConnection(URL url, String method)

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

HttpURLConnection createXmlConnection(URL url, String method)

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

String doGet(String url)

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

void doGet(String url, OutputStream outputStream)

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

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

createJsonConnection

public HttpURLConnection createJsonConnection (URL url, 
                String method)

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

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

createXmlConnection

public HttpURLConnection createXmlConnection (URL url, 
                String method)

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

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

doGet

public String doGet (String url)

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

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

المراجع:

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

doGet

public void doGet (String url, 
                OutputStream outputStream)

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

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

doGetIgnore

public void doGetIgnore (String url)

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

المعلَمات
url String: عنوان URL
عمليات الطرح
IOException

doGetIgnoreWithRetry

public void doGetIgnoreWithRetry (String url)

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

المعلَمات
url String: عنوان URL
عمليات الطرح
IOException

doGetWithRetry

public String doGetWithRetry (String url)

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

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

doPostWithRetry

public String doPostWithRetry (String url, 
                String postData)

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

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

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

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
IOException

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