自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 Cloud Translation API 翻譯而成。

StreamUtil

public class StreamUtil
extends Object

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

用於管理輸入串流的工具類別。

摘要

公用方法
`static String`	`calculateBase64Md5(InputStream inputSource)` 用於計算 inputStream 的 Base64 md5 的輔助方法。
`static long`	`calculateCrc32(InputStream inStream)` 用於計算 `ERROR(/InputStream)` 的 CRC-32 的輔助方法。
`static String`	`calculateMd5(InputStream inputSource)` 用於計算 inputStream 的 MD5 的輔助方法。
`static void`	`cancel(InputStreamSource outputSource)` 如果 `InputStreamSource` 非空值，則取消該 `InputStreamSource`。
`static void`	`close(Closeable closeable)` 關閉指定的 `ERROR(/Closeable)`。
`static void`	`closeGZipStream(GZIPOutputStream outStream)` 關閉指定的 gzip 輸出串流。
`static void`	`closeStream(OutputStream out)` 這個方法已淘汰。請改用 `close(Closeable)`。
`static void`	`closeStream(InputStream in)` 這個方法已淘汰。請改用 `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, long offset, long size)` 從指定偏移量開始，以特定大小將 origStream 的內容複製到 destStream。
`static void`	`copyStreams(InputStream inStream, OutputStream outStream, int offset)` 將 origStream 的內容複製到 destStream。
`static void`	`copyStreams(InputStream inStream, OutputStream outStream)` 將 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)` 從 `InputStreamSource` 擷取 `ByteArrayList`。
`static ByteArrayList`	`getByteArrayListFromStream(InputStream stream)` 從位元組串流中擷取 `ByteArrayList`。
`static String`	`getStackTrace(Throwable throwable)` 以 `String` 的形式取得堆疊追蹤記錄。
`static String`	`getStringFromSource(InputStreamSource source)` 從 `InputStreamSource` 擷取 `String`。
`static String`	`getStringFromStream(InputStream stream)` 從字元串流中擷取 `String`。
`static String`	`getStringFromStream(InputStream stream, long length)` 從字元串流中擷取 `String`。
`static OutputStream`	`nullOutputStream()` 建立會捨棄所有寫入作業的 `ERROR(/OutputStream)`。

公用方法

calculateBase64Md5

public static String calculateBase64Md5 (InputStream inputSource)

用於計算 inputStream 的 Base64 md5 的輔助方法。系統會使用及關閉 inputStream。

參數
`inputSource`	`InputStream`：用於建立 inputStream

傳回
`String`	串流的 Base64 md5

擲回
	IOException

calculateCrc32

public static long calculateCrc32 (InputStream inStream)

輔助方法，可計算 ERROR(/InputStream) 的 CRC-32。系統會使用及關閉該串流。建議提供已緩衝的串流。

參數
`inStream`	`InputStream`：`ERROR(/InputStream)`

傳回
`long`	串流的 CRC-32

擲回
	IOException

calculateMd5

public static String calculateMd5 (InputStream inputSource)

用於計算 inputStream 的 MD5 的輔助方法。系統會使用及關閉 inputStream。

參數
`inputSource`	`InputStream`：用於建立 inputStream

傳回
`String`	串流的 MD5

擲回
	IOException

cancel

public static void cancel (InputStreamSource outputSource)

如果 InputStreamSource 非空值，則取消該值。

參數
`outputSource`	`InputStreamSource`

關閉

public static void close (Closeable closeable)

關閉指定的 ERROR(/Closeable)。

參數
`closeable`	`Closeable`：`ERROR(/Closeable)`。如果為 `null`，則不會採取任何行動。

closeGZipStream

public static void closeGZipStream (GZIPOutputStream outStream)

關閉指定的 gzip 輸出串流。

參數
`outStream`	`GZIPOutputStream`：`ERROR(/ZipOutputStream)`。如果 outStream 為空值，則不會採取任何行動。

closeStream

public static void closeStream (OutputStream out)

This method is deprecated.
請改用 close(Closeable)。

參數
`out`	`OutputStream`

closeStream

public static void closeStream (InputStream in)

This method is deprecated.
請改用 close(Closeable)。

參數
`in`	`InputStream`

closeZipStream

public static void closeZipStream (ZipOutputStream outStream)

關閉指定的 ZIP 輸出串流。

參數
`outStream`	`ZipOutputStream`：`ERROR(/ZipOutputStream)`。如果 outStream 為空值，則不會採取任何行動。

copyFileToStream

public static void copyFileToStream (File file, 
                OutputStream outStream)

將檔案內容複製到 outStream。建議提供已緩衝的串流。

參數
`file`	`File`：`ERROR(/File)`
`outStream`	`OutputStream`：`ERROR(/OutputStream)`

擲回
	IOException

copyStreamToWriter

public static void copyStreamToWriter (InputStream inStream, 
                Writer writer)

將 inStream 的內容複製到 writer。

建議為輸入和輸出提供緩衝串流

參數
`inStream`	`InputStream`：`ERROR(/InputStream)`
`writer`	`Writer`：`ERROR(/Writer)` 目的地

擲回
	IOException

copyStreams

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

從特定偏移量開始，以特定大小將 origStream 的內容複製到 destStream。

建議為輸入和輸出提供緩衝串流

參數
`inStream`	`InputStream`：`ERROR(/InputStream)`
`outStream`	`OutputStream`：`ERROR(/OutputStream)`
`offset`	`long`：開始複製資料的偏移量。
`size`	`long`：要複製的位元組數量。負值代表複製所有內容。

擲回
	IOException

copyStreams

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

將 origStream 的內容複製到 destStream。

建議為輸入和輸出提供緩衝串流

參數
`inStream`	`InputStream`：`ERROR(/InputStream)`
`outStream`	`OutputStream`：`ERROR(/OutputStream)`
`offset`	`int`：開始複製資料的偏移量。

擲回
	IOException

copyStreams

public static void copyStreams (InputStream inStream, 
                OutputStream outStream)

將 origStream 的內容複製到 destStream。

建議為輸入和輸出提供緩衝串流

參數
`inStream`	`InputStream`：`ERROR(/InputStream)`
`outStream`	`OutputStream`：`ERROR(/OutputStream)`

擲回
	IOException

countLinesFromSource

public static int countLinesFromSource (InputStreamSource source)

計算 InputStreamSource 中的行數

參數
`source`	`InputStreamSource`：`InputStreamSource`

傳回
`int`	行數

擲回
	讀取串流時發生錯誤

flushAndCloseStream

public static void flushAndCloseStream (OutputStream outStream)

嘗試將指定的輸出串流刷新，然後關閉。

參數
`outStream`	`OutputStream`：`ERROR(/OutputStream)`。如果 outStream 為空值，系統不會採取任何行動。

getBufferedReaderFromStreamSrc

public static BufferedReader getBufferedReaderFromStreamSrc (InputStreamSource stream)

傳回 BuffferedReader，以便讀取指定 InputstreamSource 的內容。

參數
`stream`	`InputStreamSource`：`InputStreamSource`

傳回
`BufferedReader`	BuffferedReader

getByteArrayListFromSource

public static ByteArrayList getByteArrayListFromSource (InputStreamSource source)

從 InputStreamSource 擷取 ByteArrayList。

參數
`source`	`InputStreamSource`：`InputStreamSource`

傳回
`ByteArrayList`	包含串流內容的 `ByteArrayList`

擲回
	讀取串流時發生錯誤

getByteArrayListFromStream

public static ByteArrayList getByteArrayListFromStream (InputStream stream)

從位元組串流擷取 ByteArrayList。

參數
`stream`	`InputStream`：`ERROR(/InputStream)`

傳回
`ByteArrayList`	包含串流內容的 `ByteArrayList`

擲回
	讀取串流時發生錯誤

getStackTrace

public static String getStackTrace (Throwable throwable)

以 String 格式取得堆疊追蹤記錄。

參數
`throwable`	`Throwable`：要轉換的 `Throwable`。

傳回
`String`	`String` 堆疊追蹤

getStringFromSource

public static String getStringFromSource (InputStreamSource source)

從 InputStreamSource 擷取 String。

參數
`source`	`InputStreamSource`：`InputStreamSource`

傳回
`String`	包含串流內容的 `String`

擲回
	讀取串流時發生錯誤

getStringFromStream

public static String getStringFromStream (InputStream stream)

從字元串流中擷取 String。

參數
`stream`	`InputStream`：`ERROR(/InputStream)`

傳回
`String`	包含串流內容的 `String`

擲回
	讀取串流時發生錯誤

getStringFromStream

public static String getStringFromStream (InputStream stream, 
                long length)

從字元串流中擷取 String。

參數
`stream`	`InputStream`：`ERROR(/InputStream)`
`length`	`long`：要讀取的內容大小，設為 0 可讀取所有內容

傳回
`String`	包含串流內容的 `String`

擲回
	讀取串流時發生錯誤

nullOutputStream

public static OutputStream nullOutputStream ()

建立會捨棄所有寫入作業的 ERROR(/OutputStream)。

傳回
`OutputStream`