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