IHttpHelper

public interface IHttpHelper

com.android.tradefed.util.net.IHttpHelper

الفئات الفرعية غير المباشرة المعروفة http.HttpHelper http.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) اضبط مهلة العملية بالمللي ثانية.

الثوابت

MAX_DATA_SIZE

public static final int MAX_DATA_SIZE

القيمة الثابتة: 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 : ERROR(/URL) للاتصال به.
method	String : طريقة طلب HTTP. على سبيل المثال، الحصول على أو نشر.
contentType	String : نوع المحتوى. على سبيل المثال، "نص/أتش تي أم أل".

عائدات
HttpURLConnection	اتصال HttpURLC

رميات
	في حالة حدوث IOException.

createJsonConnection

public abstract HttpURLConnection createJsonConnection (URL url, 
                String method)

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

حدود
url	URL : ERROR(/URL) للاتصال به.
method	String : طريقة طلب HTTP. على سبيل المثال، الحصول على أو نشر.

عائدات
HttpURLConnection	ERROR(/HttpURLConnection)

رميات
	إذا فشل في إجراء الاتصال

createXmlConnection

public abstract HttpURLConnection createXmlConnection (URL url, 
                String method)

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

حدود
url	URL : ERROR(/URL) للاتصال به.
method	String : طريقة طلب HTTP. على سبيل المثال، الحصول على أو نشر.

عائدات
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 .

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

مراجع:

• اتصال URL لجافا: http://java.sun.com/docs/books/tutorial/networking/urls/readingWriting.html
• قارئ URL لجافا: http://java.sun.com/docs/books/tutorial/networking/urls/readingURL.html
• وكيل مجموعة جافا: http://java.sun.com/docs/books/tutorial/networking/urls/_setProxy.html

حدود
url	String : عنوان URL

عائدات
String	محتويات String البعيدة

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

doGetIgnore

public abstract void doGetIgnore (String url)

ينفذ GET لعنوان URL محدد، مع تجاهل معلمات URL المحددة للنتيجة.

حدود
url	String : عنوان URL

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

أنظر أيضا:

• doGet(String)

doGetIgnoreWithRetry

public abstract void doGetIgnoreWithRetry (String url)

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

حدود
url	String : عنوان URL

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

أنظر أيضا:

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

doGetWithRetry

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)

doPostWithRetry

public abstract String doPostWithRetry (String url, 
                String postData)

ينفذ طريقة طلب POST HTTP لعنوان URL محدد ويعيده String ، ويعيد المحاولة عند الفشل.

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

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

عائدات
String	محتويات String البعيدة

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

doPostWithRetry

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

ينفذ طريقة طلب POST HTTP لعنوان URL محدد ويعيده String ، ويعيد المحاولة عند الفشل.

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

حدود
url	String : عنوان URL
postData	String : البيانات التي سيتم نشرها بمجرد فتح الاتصال
contentType	String : نوع المحتوى. على سبيل المثال، "نص/أتش تي أم أل".

عائدات
String	محتويات String البعيدة

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

getInitialPollInterval

public abstract int getInitialPollInterval ()

الحصول على الفاصل الزمني للاستقصاء الأولي في مللي ثانية.

عائدات
int

أنظر أيضا:

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

getMaxPollInterval

public abstract int getMaxPollInterval ()

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

عائدات
int

أنظر أيضا:

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

com.getMaxTime

public abstract int getMaxTime ()

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

عائدات
int

أنظر أيضا:

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

getOpTimeout

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)

setMaxTime

public abstract void setMaxTime (int time)

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

حدود
time	int

أنظر أيضا:

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

setOpTimeout

public abstract void setOpTimeout (int time)

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

حدود
time	int

أنظر أيضا:

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