از سال ۲۰۲۶، برای همسو شدن با مدل توسعه پایدار ترانک و تضمین پایداری پلتفرم برای اکوسیستم، کد منبع را در سه‌ماهه دوم و چهارم در AOSP منتشر خواهیم کرد. برای ساخت و مشارکت در AOSP، android-latest-release استفاده کنید. شاخه مانیفست android-latest-release همیشه به جدیدترین نسخه منتشر شده در AOSP ارجاع می‌دهد. برای اطلاعات بیشتر، به تغییرات در AOSP مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

StreamUtil

public class StreamUtil
extends Object

شیء جاوا
↳	com.android.tradefed.util.StreamUtil

کلاس کاربردی برای مدیریت جریان‌های ورودی.

خلاصه

روش‌های عمومی
`static String`	`calculateBase64Md5 (InputStream inputSource)` متد کمکی برای محاسبه‌ی md5 از base64 برای یک inputStream.
`static long`	`calculateCrc32 (InputStream inStream)` روش کمکی برای محاسبه CRC-32 برای `InputStream` .
`static String`	`calculateMd5 (InputStream inputSource)` متد کمکی برای محاسبه md5 برای یک inputStream.
`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 را برای writer کپی می‌کند.
`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` ایجاد کنید که تمام نوشته‌ها را نادیده بگیرد.

روش‌های عمومی

محاسبهBase64Md5

public static String calculateBase64Md5 (InputStream inputSource)

متد کمکی برای محاسبه‌ی md5 از base64 برای یک inputStream. inputStream مصرف و بسته خواهد شد.

پارامترها
`inputSource`	`InputStream` : برای ایجاد inputStream استفاده می‌شود.

بازگشت‌ها
`String`	base64 md5 از جریان

پرتاب‌ها
	استثنای java.io.IO
`IOException`

محاسبهCrc32

public static long calculateCrc32 (InputStream inStream)

متد کمکی برای محاسبه CRC-32 برای یک InputStream . این جریان مصرف و بسته خواهد شد. توصیه می‌شود یک جریان بافر شده ارائه شود.

پارامترها
`inStream`	`InputStream` : `InputStream`

بازگشت‌ها
`long`	CRC-32 جریان

پرتاب‌ها
	استثنای java.io.IO
`IOException`

محاسبه‌ی Md5

public static String calculateMd5 (InputStream inputSource)

متد کمکی برای محاسبه‌ی md5 برای یک inputStream. inputStream مصرف و بسته خواهد شد.

پارامترها
`inputSource`	`InputStream` : برای ایجاد inputStream استفاده می‌شود.

بازگشت‌ها
`String`	md5 جریان

پرتاب‌ها
	استثنای java.io.IO
`IOException`

لغو

public static void cancel (InputStreamSource outputSource)

اگر InputStreamSource داده شده تهی نباشد، آن را لغو می‌کند.

پارامترها
`outputSource`	`InputStreamSource`

بستن

public static void close (Closeable closeable)

Closeable داده شده را می‌بندد.

پارامترها
`closeable`	`Closeable` : `Closeable` . اگر `null` هیچ اقدامی انجام نمی‌شود.

بستنGZipStream

public static void closeGZipStream (GZIPOutputStream outStream)

جریان خروجی gzip داده شده را می‌بندد.

پارامترها
`outStream`	`GZIPOutputStream` : همان `ZipOutputStream` است. اگر outStream مقدار null داشته باشد، هیچ عملی انجام نمی‌شود.

بستن جریان

public static void closeStream (InputStream in)

این روش منسوخ شده است.
به جای آن close(Closeable) استفاده کنید.

پارامترها
`in`	`InputStream`

بستن جریان

public static void closeStream (OutputStream out)

این روش منسوخ شده است.
به جای آن close(Closeable) استفاده کنید.

پارامترها
`out`	`OutputStream`

بستن زیپ‌استریم

public static void closeZipStream (ZipOutputStream outStream)

جریان خروجی zip داده شده را می‌بندد.

پارامترها
`outStream`	`ZipOutputStream` : همان `ZipOutputStream` است. اگر outStream مقدار null داشته باشد، هیچ عملی انجام نمی‌شود.

کپی‌فایل برای پخش

public static void copyFileToStream (File file, 
                OutputStream outStream)

محتویات فایل را به outStream کپی می‌کند. توصیه می‌شود یک جریان بافر شده ارائه دهید.

پارامترها
`file`	`File` : `File`
`outStream`	`OutputStream` : `OutputStream`

پرتاب‌ها
	استثنای java.io.IO
`IOException`

کپی‌استریم‌تو‌رایتر

public static void copyStreamToWriter (InputStream inStream, 
                Writer writer)

محتویات inStream را برای writer کپی می‌کند.

توصیه می‌شود یک جریان بافر شده برای ورودی و خروجی فراهم شود

پارامترها
`inStream`	`InputStream` : `InputStream`
`writer`	`Writer` : مقصد `Writer`

پرتاب‌ها
	استثنای java.io.IO
`IOException`

کپی‌استریم‌ها

public static void copyStreams (InputStream inStream, 
                OutputStream outStream)

محتویات origStream را در destStream کپی می‌کند.

توصیه می‌شود یک جریان بافر شده برای ورودی و خروجی فراهم شود

پارامترها
`inStream`	`InputStream` : `InputStream`
`outStream`	`OutputStream` : `OutputStream`

پرتاب‌ها
	استثنای java.io.IO
`IOException`

کپی‌استریم‌ها

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.IO
`IOException`

کپی‌استریم‌ها

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

محتویات origStream را در destStream کپی می‌کند.

توصیه می‌شود یک جریان بافر شده برای ورودی و خروجی فراهم شود

پارامترها
`inStream`	`InputStream` : `InputStream`
`outStream`	`OutputStream` : `OutputStream`
`offset`	`int` : فاصله زمانی شروع کپی کردن داده‌ها.

پرتاب‌ها
	استثنای java.io.IO
`IOException`

شمارش خطوط از منبع

public static int countLinesFromSource (InputStreamSource source)

تعداد خطوط را در یک InputStreamSource بشمارید

پارامترها
`source`	`InputStreamSource` : `InputStreamSource`

بازگشت‌ها
`int`	تعداد خطوط

پرتاب‌ها
`IOException`	اگر در خواندن جریان خطایی رخ داد

flushAndCloseStream

public static void flushAndCloseStream (OutputStream outStream)

تلاش می‌کند تا جریان خروجی داده شده را پاک کند و سپس آن را می‌بندد.

پارامترها
`outStream`	`OutputStream` : `OutputStream` . اگر outStream تهی باشد، هیچ اقدامی انجام نمی‌شود.

getBufferedReaderFromStreamSrc

public static BufferedReader getBufferedReaderFromStreamSrc (InputStreamSource stream)

یک BuffferedReader را برای خواندن محتویات از InputstreamSource داده شده، برمی‌گرداند.

پارامترها
`stream`	`InputStreamSource` : `InputStreamSource`

بازگشت‌ها
`BufferedReader`	یک BuffferedReader

دریافت بایت‌آری‌لیست از منبع

public static ByteArrayList getByteArrayListFromSource (InputStreamSource source)

یک ByteArrayList از InputStreamSource بازیابی می‌کند.

پارامترها
`source`	`InputStreamSource` : `InputStreamSource`

بازگشت‌ها
`ByteArrayList`	یک `ByteArrayList` حاوی محتوای جریان

پرتاب‌ها
`IOException`	اگر در خواندن جریان خطایی رخ داد

دریافت بایت‌آری‌لیست از جریان

public static ByteArrayList getByteArrayListFromStream (InputStream stream)

یک ByteArrayList از یک جریان بایت بازیابی می‌کند.

پارامترها
`stream`	`InputStream` : `InputStream`

بازگشت‌ها
`ByteArrayList`	یک `ByteArrayList` حاوی محتوای جریان

پرتاب‌ها
`IOException`	اگر در خواندن جریان خطایی رخ داد

دریافت پشته ردیابی

public static String getStackTrace (Throwable throwable)

رد پشته را به صورت یک String دریافت می‌کند.

پارامترها
`throwable`	`Throwable` : `Throwable` برای تبدیل.

بازگشت‌ها
`String`	ردیابی پشته `String`

دریافت رشته از منبع

public static String getStringFromSource (InputStreamSource source)

یک String از InputStreamSource بازیابی می‌کند.

پارامترها
`source`	`InputStreamSource` : `InputStreamSource`

بازگشت‌ها
`String`	یک `String` حاوی محتوای جریان

پرتاب‌ها
`IOException`	اگر در خواندن جریان خطایی رخ داد

دریافت رشته از جریان

public static String getStringFromStream (InputStream stream, 
                long length)

یک String از یک جریان کاراکتری بازیابی می‌کند.

پارامترها
`stream`	`InputStream` : `InputStream`
`length`	`long` : اندازه محتوایی که باید خوانده شود، برای خواندن همه محتوا روی ۰ تنظیم می‌شود.

بازگشت‌ها
`String`	یک `String` حاوی محتوای جریان

پرتاب‌ها
`IOException`	اگر در خواندن جریان خطایی رخ داد

دریافت رشته از جریان

public static String getStringFromStream (InputStream stream)

یک String از یک جریان کاراکتری بازیابی می‌کند.

پارامترها
`stream`	`InputStream` : `InputStream`

بازگشت‌ها
`String`	یک `String` حاوی محتوای جریان

پرتاب‌ها
`IOException`	اگر در خواندن جریان خطایی رخ داد

جریان خروجی تهی

public static OutputStream nullOutputStream ()

یک OutputStream ایجاد کنید که تمام نوشته‌ها را نادیده بگیرد.

بازگشت‌ها
`OutputStream`