اعتبارًا من عام 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.

StreamUtil

public class StreamUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.StreamUtil

فئة الأدوات المساعدة لإدارة مصادر البيانات.

ملخّص

الإجراءات العامة
`static String`	`calculateBase64Md5(InputStream inputSource)` طريقة مساعدة لاحتساب base64 md5 لـ inputStream.
`static long`	`calculateCrc32(InputStream inStream)` طريقة مساعدة لاحتساب CRC-32 لـ `InputStream`.
`static String`	`calculateMd5(InputStream inputSource)` طريقة مساعدة لحساب md5 لتدفق إدخال.
`static void`	`cancel(InputStreamSource outputSource)` يلغي `InputStreamSource` المحدّد إذا لم يكن فارغًا.
`static void`	`close(Closeable closeable)` يُغلق هذا الزر `Closeable` المحدّد.
`static void`	`closeGZipStream(GZIPOutputStream outStream)` يُغلِق مصدر بيانات gzip المحدّد.
`static void`	`closeStream(InputStream in)` تم إيقاف هذه الطريقة نهائيًا. استخدِم `close(Closeable)` بدلاً من ذلك.
`static void`	`closeStream(OutputStream out)` تم إيقاف هذه الطريقة نهائيًا. استخدِم `close(Closeable)` بدلاً من ذلك.
`static void`	`closeZipStream(ZipOutputStream outStream)` يغلق هذا الإجراء مصدر بيانات zip المحدّد.
`static void`	`copyFileToStream(File file, OutputStream outStream)` ينسخ محتوى الملف إلى outStream.
`static void`	`copyStreamToWriter(InputStream inStream, Writer writer)` ينسخ محتوى inStream إلى الكاتب.
`static void`	`copyStreams(InputStream inStream, OutputStream outStream)` ينسخ هذا الإجراء محتوى origStream إلى destStream.
`static void`	`copyStreams(InputStream inStream, OutputStream outStream, long offset, long size)` نسخ محتوى origStream إلى destStream بدءًا من إزاحة معيّنة بحجم محدّد
`static void`	`copyStreams(InputStream inStream, OutputStream outStream, int offset)` ينسخ هذا الإجراء محتوى origStream إلى destStream.
`static int`	`countLinesFromSource(InputStreamSource source)` حساب عدد الأسطر في `InputStreamSource`
`static void`	`flushAndCloseStream(OutputStream outStream)` تحاول هذه الطريقة إفراغ دفق الإخراج المحدّد، ثم تغلقه.
`static BufferedReader`	`getBufferedReaderFromStreamSrc(InputStreamSource stream)` عرض BuffferedReader لقراءة المحتوى من InputstreamSource المحدّد
`static ByteArrayList`	`getByteArrayListFromSource(InputStreamSource source)` يستردّ هذا الإجراء `ByteArrayList` من `InputStreamSource`.
`static ByteArrayList`	`getByteArrayListFromStream(InputStream stream)` يسترد هذا الإجراء `ByteArrayList` من دفق بايت.
`static String`	`getStackTrace(Throwable throwable)` تعرض هذه السمة عملية تتبُّع تسلسل استدعاء الدوال البرمجية كـ `String`.
`static String`	`getStringFromSource(InputStreamSource source)` يستردّ هذا الإجراء `String` من `InputStreamSource`.
`static String`	`getStringFromStream(InputStream stream, long length)` يسترد هذا الإجراء `String` من دفق أحرف.
`static String`	`getStringFromStream(InputStream stream)` يسترد هذا الإجراء `String` من دفق أحرف.
`static OutputStream`	`nullOutputStream()` أنشئ `OutputStream` يتجاهل جميع عمليات الكتابة.

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

calculateBase64Md5

public static String calculateBase64Md5 (InputStream inputSource)

طريقة مساعدة لاحتساب base64 md5 لـ inputStream. سيتم استهلاك inputStream وإغلاقه.

المعلَمات
`inputSource`	‫`InputStream`: تُستخدَم لإنشاء inputStream

المرتجعات
`String`	base64 md5 of the stream

عمليات الطرح
	java.io.IOException
`IOException`

calculateCrc32

public static long calculateCrc32 (InputStream inStream)

طريقة مساعدة لاحتساب CRC-32 لـ InputStream. سيتم استهلاك البث وإغلاقه. يُنصح بتوفير بث مخزّن مؤقتًا.

المعلَمات
`inStream`	`InputStream`: `InputStream`

المرتجعات
`long`	رمز التحقّق الدوري (CRC-32) الخاص بالبث

عمليات الطرح
	java.io.IOException
`IOException`

calculateMd5

public static String calculateMd5 (InputStream inputSource)

طريقة مساعدة لحساب md5 لتدفق إدخال. سيتم استهلاك inputStream وإغلاقه.

المعلَمات
`inputSource`	‫`InputStream`: تُستخدَم لإنشاء inputStream

المرتجعات
`String`	md5 of the stream

عمليات الطرح
	java.io.IOException
`IOException`

إلغاء

public static void cancel (InputStreamSource outputSource)

يلغي InputStreamSource المحدّد إذا لم يكن فارغًا.

المعلَمات
`outputSource`	`InputStreamSource`

إغلاق

public static void close (Closeable closeable)

يُغلق هذا الزر Closeable المحدّد.

المعلَمات
`closeable`	`Closeable`: `Closeable` لا يتم اتّخاذ أي إجراء إذا كان `null`.

closeGZipStream

public static void closeGZipStream (GZIPOutputStream outStream)

يُغلِق مصدر بيانات gzip المحدّد.

المعلَمات
`outStream`	`GZIPOutputStream`: `ZipOutputStream` لا يتم اتّخاذ أي إجراء إذا كانت قيمة outStream هي null.

closeStream

public static void closeStream (InputStream in)

تم إيقاف هذا الإجراء نهائيًا.
يُرجى استخدام close(Closeable) بدلاً من ذلك.

المعلَمات
`in`	`InputStream`

closeStream

public static void closeStream (OutputStream out)

تم إيقاف هذا الإجراء نهائيًا.
يُرجى استخدام close(Closeable) بدلاً من ذلك.

المعلَمات
`out`	`OutputStream`

closeZipStream

public static void closeZipStream (ZipOutputStream outStream)

يغلق هذا الإجراء مصدر بيانات zip المحدّد.

المعلَمات
`outStream`	`ZipOutputStream`: `ZipOutputStream` لا يتم اتّخاذ أي إجراء إذا كانت قيمة outStream هي null.

copyFileToStream

public static void copyFileToStream (File file, 
                OutputStream outStream)

ينسخ محتوى الملف إلى outStream. يُنصح بتوفير بث مخزّن مؤقتًا.

المعلَمات
`file`	`File`: `File`
`outStream`	`OutputStream`: `OutputStream`

عمليات الطرح
	java.io.IOException
`IOException`

copyStreamToWriter

public static void copyStreamToWriter (InputStream inStream, 
                Writer writer)

ينسخ محتوى inStream إلى الكاتب.

ننصح بتوفير بث مخزّن مؤقت للإدخال والإخراج

المعلَمات
`inStream`	`InputStream`: `InputStream`
`writer`	`Writer`: وجهة `Writer`

عمليات الطرح
	java.io.IOException
`IOException`

copyStreams

public static void copyStreams (InputStream inStream, 
                OutputStream outStream)

ينسخ هذا الإجراء محتوى origStream إلى destStream.

ننصح بتوفير بث مخزّن مؤقت للإدخال والإخراج

المعلَمات
`inStream`	`InputStream`: `InputStream`
`outStream`	`OutputStream`: `OutputStream`

عمليات الطرح
	java.io.IOException
`IOException`

copyStreams

public static void copyStreams (InputStream inStream, 
                OutputStream outStream, 
                long offset, 
                long size)

ينسخ هذا الإجراء محتوى origStream إلى destStream بدءًا من إزاحة معيّنة بحجم محدّد.

ننصح بتوفير بث مخزّن مؤقت للإدخال والإخراج

المعلَمات
`inStream`	`InputStream`: `InputStream`
`outStream`	`OutputStream`: `OutputStream`
`offset`	`long`: إزاحة وقت بدء نسخ البيانات.
`size`	‫`long`: عدد البايت المطلوب نسخه تعني القيمة السالبة نسخ كل المحتوى.

عمليات الطرح
	java.io.IOException
`IOException`

copyStreams

public static void copyStreams (InputStream inStream, 
                OutputStream outStream, 
                int offset)

ينسخ هذا الإجراء محتوى origStream إلى destStream.

ننصح بتوفير بث مخزّن مؤقت للإدخال والإخراج

المعلَمات
`inStream`	`InputStream`: `InputStream`
`outStream`	`OutputStream`: `OutputStream`
`offset`	`int`: إزاحة وقت بدء نسخ البيانات.

عمليات الطرح
	java.io.IOException
`IOException`

countLinesFromSource

public static int countLinesFromSource (InputStreamSource source)

حساب عدد الأسطر في InputStreamSource

المعلَمات
`source`	`InputStreamSource`: `InputStreamSource`

المرتجعات
`int`	عدد الأسطر

عمليات الطرح
`IOException`	إذا حدث خطأ أثناء قراءة البث

flushAndCloseStream

public static void flushAndCloseStream (OutputStream outStream)

تحاول هذه الطريقة إفراغ دفق الإخراج المحدّد، ثم تغلقه.

المعلَمات
`outStream`	`OutputStream`: `OutputStream` لا يتم اتّخاذ أي إجراء إذا كانت قيمة outStream هي null.

getBufferedReaderFromStreamSrc

public static BufferedReader getBufferedReaderFromStreamSrc (InputStreamSource stream)

عرض BuffferedReader لقراءة المحتوى من InputstreamSource المحدّد

المعلَمات
`stream`	`InputStreamSource`: `InputStreamSource`

المرتجعات
`BufferedReader`	a BuffferedReader

getByteArrayListFromSource

public static ByteArrayList getByteArrayListFromSource (InputStreamSource source)

يستردّ هذا الإجراء ByteArrayList من InputStreamSource.

المعلَمات
`source`	`InputStreamSource`: `InputStreamSource`

المرتجعات
`ByteArrayList`	`ByteArrayList` يحتوي على محتوى البث

عمليات الطرح
`IOException`	إذا حدث خطأ أثناء قراءة البث

getByteArrayListFromStream

public static ByteArrayList getByteArrayListFromStream (InputStream stream)

يسترد هذا الإجراء ByteArrayList من دفق بايت.

المعلَمات
`stream`	`InputStream`: `InputStream`

المرتجعات
`ByteArrayList`	`ByteArrayList` يحتوي على محتوى البث

عمليات الطرح
`IOException`	إذا حدث خطأ أثناء قراءة البث

getStackTrace

public static String getStackTrace (Throwable throwable)

تعرض هذه السمة عملية تتبُّع تسلسل استدعاء الدوال البرمجية كـ String.

المعلَمات
`throwable`	`Throwable`: `Throwable` المطلوب تحويله

المرتجعات
`String`	`String` تتبُّع تسلسل استدعاء الدوال البرمجية

getStringFromSource

public static String getStringFromSource (InputStreamSource source)

يستردّ هذا الإجراء String من InputStreamSource.

المعلَمات
`source`	`InputStreamSource`: `InputStreamSource`

المرتجعات
`String`	`String` يحتوي على محتوى البث

عمليات الطرح
`IOException`	إذا حدث خطأ أثناء قراءة البث

getStringFromStream

public static String getStringFromStream (InputStream stream, 
                long length)

يسترد هذا الإجراء String من دفق أحرف.

المعلَمات
`stream`	`InputStream`: `InputStream`
`length`	‫`long`: حجم المحتوى المطلوب قراءته، اضبطه على 0 لقراءة كل المحتوى

المرتجعات
`String`	`String` يحتوي على محتوى البث

عمليات الطرح
`IOException`	إذا حدث خطأ أثناء قراءة البث

getStringFromStream

public static String getStringFromStream (InputStream stream)

يسترد هذا الإجراء String من دفق أحرف.

المعلَمات
`stream`	`InputStream`: `InputStream`

المرتجعات
`String`	`String` يحتوي على محتوى البث

عمليات الطرح
`IOException`	إذا حدث خطأ أثناء قراءة البث

nullOutputStream

public static OutputStream nullOutputStream ()

أنشئ OutputStream يتجاهل جميع عمليات الكتابة.

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