اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

SsoClientHttpHelper

public class SsoClientHttpHelper
extends HttpHelper

java.lang.Object
↳	com.android.tradefed.util.net.HttpHelper
	↳	com.google.android.tradefed.build.SsoClientHttpHelper

يحتوي على طرق مساعدة لإنشاء طلبات HTTP باستخدام برنامج عميل SSO الثنائي

ملخّص

طُرق وضع التصميم العامة
`SsoClientHttpHelper()`
`SsoClientHttpHelper(String ssoClient, String certificate)`

الإجراءات العامة
`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`	`doGetIgnore(String url)` يُجري طلب GET لعنوان URL معيّن، مع تجاهل النتيجة باستخدام مَعلمات عنوان URL المحدّدة.
`void`	`doGetIgnoreWithRetry(String url)` يتم تنفيذ {`doGetIgnore(String)` إعادة محاولة عند التعذّر.
`String`	`doGetWithRetry(String url)` يتم تنفيذ {`doGet(String)` إعادة محاولة عند التعذّر.
`String`	`doPostWithRetry(String url, String postData, String contentType)` تُجري هذه الدالة طلب HTTP POST لعنوان URL معيّن وتعرضه كـ `String`، مع إعادة المحاولة عند حدوث خطأ.

طُرق محمية
`int`	`parseHttpStatusCode(String httpStatusLine)` تحليل رمز حالة HTTP (مثلاً
`String`	`stripResponseHeader(String response)` إزالة العنوان من استجابة HTTP من عميل الدخول المُوحَّد وعرض نصها
`String`	`validateAndAdjustResponse(String response)` التحقّق من صحة استجابة HTTP وتعديلها إذا لزم الأمر

طُرق وضع التصميم العامة

SsoClientHttpHelper

public SsoClientHttpHelper ()

SsoClientHttpHelper

public SsoClientHttpHelper (String ssoClient, 
                String certificate)

المعلَمات
`ssoClient`	`String`
`certificate`	`String`

الإجراءات العامة

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.

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

المراجع:

Java URL Connection: http://java.sun.com/docs/books/tutorial/networking/urls/readingWriting.html
قارئ عناوين URL في Java: http://java.sun.com/docs/books/tutorial/networking/urls/readingURL.html
Java set Proxy: http://java.sun.com/docs/books/tutorial/networking/urls/_setProxy.html

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

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

عمليات الطرح
`IHttpHelper.DataSizeException`
`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, 
                String contentType)

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

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

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

المرتجعات
`String`	محتوى وحدة التحكّم عن بُعد في جهاز `String`

عمليات الطرح
`IHttpHelper.DataSizeException`
`IOException`

طُرق محمية

parseHttpStatusCode

protected int parseHttpStatusCode (String httpStatusLine)

تحليل رمز حالة HTTP (مثلاً ‫200) من سطر حالة HTTP (مثلاً HTTP/1.1 200 OK)

المعلَمات
`httpStatusLine`	`String`

المرتجعات
`int`

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

Status-Line

stripResponseHeader

protected String stripResponseHeader (String response)

إزالة العنوان من استجابة HTTP من عميل الدخول المُوحَّد وعرض نصها

المعلَمات
`response`	`String`

المرتجعات
`String`

validateAndAdjustResponse

protected String validateAndAdjustResponse (String response)

التحقّق من صحة استجابة HTTP وتعديلها إذا لزم الأمر

المعلَمات
`response`	`String`

المرتجعات
`String`