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)

ログをテストケースに強く関連付ける必要がある場合でも、直接 testLogSaved(String,LogDataType,InputStreamSource,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)

テスト呼び出しから関連するログまたはデバッグデータを提供します。

また、グローバル ILogSaver を使用してログファイルを保存し、 ILogSaverListener.testLogSaved(String,LogDataType,InputStreamSource,LogFile) を実装するリスナーに対して ILogSaverListener インターフェースを呼び出します。

void testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)

最初にログを保存するのではなく、testLog のみを転送します。

void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

テストログが保存されたときに呼び出されます。

LogSaverResultForwarder が別のものにラップされている場合は、その下のリスナーに testLogSaved コールバックを転送します。

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