LogSaverResultForwarder
public
class
LogSaverResultForwarder
extends ResultForwarder
implements
ILogSaverListener
| java.lang.Object | ||
| ↳ | com.android.tradefed.result.ResultForwarder | |
| ↳ | com.android.tradefed.result.LogSaverResultForwarder | |
グローバル ファイル セーバーを使用してログを保存するための ResultForwarder。
概要
パブリック コンストラクタ | |
|---|---|
LogSaverResultForwarder(ILogSaver logSaver, List<ITestInvocationListener> listeners, IConfiguration config)
|
|
LogSaverResultForwarder(ILogSaver logSaver, List<ITestInvocationListener> listeners, IConfiguration config, boolean setLogSaver)
|
|
パブリック メソッド | |
|---|---|
void
|
invocationEnded(long elapsedTime)
呼び出しが正常に終了したか、エラー 状態のために終了したかを報告します。 |
void
|
invocationStarted(IInvocationContext context)
テスト呼び出しの開始を報告します。 |
void
|
logAssociation(String dataName, LogFile logFile)
ログをテストケースに強く関連付ける必要がある場合でも、直接 |
static
void
|
logFile(List<ITestInvocationListener> listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type)
完了前に最終ファイルを記録します。 |
static
void
|
reportEndHostLog(List<ITestInvocationListener> listeners, ILogSaver saver, String name)
進行中のセッションから host_log を報告します。 |
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
テスト呼び出しから関連するログまたはデバッグデータを提供します。
また、グローバル |
void
|
testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)
最初にログを保存するのではなく、testLog のみを転送します。 |
void
|
testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
テストログが保存されたときに呼び出されます。
|
void
|
testModuleEnded()
モジュール実行の終了を報告します。 |
void
|
testModuleStarted(IInvocationContext moduleContext)
モジュールの実行開始を報告します。 |
パブリック コンストラクタ
LogSaverResultForwarder
public LogSaverResultForwarder (ILogSaver logSaver, List<ITestInvocationListener> listeners, IConfiguration config)
| パラメータ | |
|---|---|
logSaver |
ILogSaver |
listeners |
List |
config |
IConfiguration |
LogSaverResultForwarder
public LogSaverResultForwarder (ILogSaver logSaver, List<ITestInvocationListener> listeners, IConfiguration config, boolean setLogSaver)
| パラメータ | |
|---|---|
logSaver |
ILogSaver |
listeners |
List |
config |
IConfiguration |
setLogSaver |
boolean |
パブリック メソッド
invocationEnded
public void invocationEnded (long elapsedTime)
呼び出しが正常に終了したか、エラー 状態のために終了したかを報告します。
TradeFederation フレームワークによって自動的に呼び出されます。
| パラメータ | |
|---|---|
elapsedTime |
long: 呼び出しの経過時間(ミリ秒) |
invocationStarted
public void invocationStarted (IInvocationContext context)
テスト呼び出しの開始を報告します。
TradeFederation フレームワークによって自動的に呼び出されます。複数のデバイスのレポートをサポートするには、レポート作成者が このメソッドをオーバーライドする必要があります。
| パラメータ | |
|---|---|
context |
IInvocationContext: 呼び出しに関する情報 |
logAssociation
public void logAssociation (String dataName,
LogFile logFile)ログをテストケースに強く関連付ける必要がある場合でも、直接 testLogSaved(String,LogDataType,InputStreamSource,LogFile)
コールバックで関連付けることはできません。そのため、このコールバックを使用すると、強い関連付けを明示的に指定できます
。
| パラメータ | |
|---|---|
dataName |
String: データの名前 |
logFile |
LogFile: 以前に記録され、テストケースに関連付ける必要がある LogFile。 |
logFile
public static void logFile (List<ITestInvocationListener> listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type)
完了前に最終ファイルを記録します。
| パラメータ | |
|---|---|
listeners |
List |
saver |
ILogSaver |
source |
InputStreamSource |
name |
String |
type |
LogDataType |
reportEndHostLog
public static void reportEndHostLog (List<ITestInvocationListener> listeners, ILogSaver saver, String name)
進行中のセッションから host_log を報告します。
| パラメータ | |
|---|---|
listeners |
List |
saver |
ILogSaver |
name |
String |
testLog
public void testLog (String dataName,
LogDataType dataType,
InputStreamSource dataStream)テスト呼び出しから関連するログまたはデバッグデータを提供します。
ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) または
ERROR(/ITestInvocationListener#invocationEnded(long))
の前に呼び出す必要があります。
TradeFederation フレームワークは、このメソッドを自動的に呼び出し、ホストログ と、該当する場合はデバイスの logcat を提供します。
また、グローバル ILogSaver を使用してログファイルを保存し、
ILogSaverListener.testLogSaved(String,LogDataType,InputStreamSource,LogFile)
を実装するリスナーに対して ILogSaverListener インターフェースを呼び出します。
| パラメータ | |
|---|---|
dataName |
String:データのString記述名(例: "device_logcat")。dataName は呼び出しごとに一意でない場合があります。つまり、実装者は同じ dataName で複数の呼び出しを処理できる必要があります。 |
dataType |
LogDataType: データの LogDataType |
dataStream |
InputStreamSource:データの InputStreamSource。実装者は
createInputStream を呼び出してデータの読み取りを開始し、完了したら結果の
InputStream を閉じる必要があります。呼び出し元は、testLog メソッドが完了するまで、データのソースが存在し、アクセス可能であることを確認する必要があります。 |
testLogForward
public void testLogForward (String dataName,
LogDataType dataType,
InputStreamSource dataStream)最初にログを保存するのではなく、testLog のみを転送します。
| パラメータ | |
|---|---|
dataName |
String |
dataType |
LogDataType |
dataStream |
InputStreamSource |
testLogSaved
public void testLogSaved (String dataName,
LogDataType dataType,
InputStreamSource dataStream,
LogFile logFile)テストログが保存されたときに呼び出されます。
ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) の代わりに使用する必要があります。
LogSaverResultForwarder が別のものにラップされている場合は、その下のリスナーに
testLogSaved コールバックを転送します。
| パラメータ | |
|---|---|
dataName |
String:データのString記述名(例: "device_logcat")。dataName は呼び出しごとに一意でない場合があります。つまり、実装者は同じ dataName で複数の呼び出しを処理できる必要があります。 |
dataType |
LogDataType: データの LogDataType |
dataStream |
InputStreamSource:データの InputStreamSource。実装者は
createInputStream を呼び出してデータの読み取りを開始し、完了したら結果の
InputStream を閉じる必要があります。 |
logFile |
LogFile: 保存されたファイルのメタデータを含む LogFile。 |
testModuleEnded
public void testModuleEnded ()
モジュール実行の終了を報告します。
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
モジュールの実行開始を報告します。このコールバックは testModuleEnded() に関連付けられており、シーケンスでは省略可能です。モジュールを使用する実行(スイートベースのランナー)でのみ使用されます。
| パラメータ | |
|---|---|
moduleContext |
IInvocationContext: モジュールの IInvocationContext。 |