LargeOutputReceiver

public class LargeOutputReceiver
extends Object implements IShellOutputReceiver

java.lang.Object
↳	com.android.tradefed.device.LargeOutputReceiver

---

這個類別旨在協助執行長時間執行的指令，並收集輸出內容。

暫時檔案大小上限約為 maxFileSize。 為避免達到限制時遺失資料，這個檔案會保留一組暫時主機檔案。

摘要

公用建構函式
LargeOutputReceiver(String descriptor, String serialNumber, long maxDataSize) 建立 LargeOutputReceiver。

公用方法
void	addOutput(byte[] data, int offset, int length) 每當有新資料可用時，系統就會呼叫此方法。
void	cancel() 取消指令。
void	clear() 刪除目前累積的資料，然後重新建立新檔案。
void	delete() 刪除所有累積資料。
void	flush() 在程序執行結束時呼叫 (除非程序已取消)。
InputStreamSource	getData() 以 InputStreamSource 形式取得收集的輸出內容。
InputStreamSource	getData(int maxBytes) 取得收集到的最後一個 maxBytes 輸出內容做為 InputStreamSource。
InputStreamSource	getData(int maxBytes, int offset) 取得收集到的最後一個 maxBytes 輸出內容做為 InputStreamSource。
boolean	isCancelled() Cancel 方法可停止執行遠端 shell 命令。

公用建構函式

LargeOutputReceiver

public LargeOutputReceiver (String descriptor, 
                String serialNumber, 
                long maxDataSize)

建立 LargeOutputReceiver。

參數
descriptor	String：要執行的指令描述元。僅供記錄。
serialNumber	String：裝置的序號。僅供記錄。
maxDataSize	long：要保留的資料量上限 (約略值)。

公用方法

addOutput

public void addOutput (byte[] data, 
                int offset, 
                int length)

每當有新資料可用時，系統就會呼叫此方法。

參數
data	byte：新資料。
offset	int：新資料的起始位移。
length	int：新資料的長度。

cancel

public void cancel ()

取消指令。

清除

public void clear ()

刪除目前累積的資料，然後重新建立新檔案。

刪除

public void delete ()

刪除所有累積的資料。

清除

public void flush ()

在程序執行結束時呼叫 (除非程序已取消)。這可讓接收端終止並清除尚未處理的資料。

getData

public InputStreamSource getData ()

以 InputStreamSource 形式取得收集的輸出內容。

傳回
InputStreamSource	指令收集到的輸出內容。

getData

public InputStreamSource getData (int maxBytes)

取得收集到的最後一個 maxBytes 輸出內容做為 InputStreamSource。

參數
maxBytes	int：要傳回的資料量上限。應為可輕鬆放入記憶體的量

傳回
InputStreamSource	從指令收集的輸出內容，儲存在記憶體中

getData

public InputStreamSource getData (int maxBytes, 
                int offset)

取得收集到的最後一個 maxBytes 輸出內容做為 InputStreamSource。

參數
maxBytes	int：要傳回的資料量上限。應為可輕鬆放入記憶體的量
offset	int：從緩衝區開始取得資料的位移。

傳回
InputStreamSource	從指令收集的輸出內容，儲存在記憶體中

isCancelled

public boolean isCancelled ()

取消方法，停止執行遠端 Shell 指令。

傳回
boolean	true 可取消執行指令。