Google は、黒人コミュニティに対する人種平等の促進に取り組んでいます。取り組みを見る
このページは Cloud Translation API によって翻訳されました。
Switch to English

BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

java.lang.Object
com.android.tradefed.postprocessor.BasePostProcessor


すべての実装が拡張する必要がある基本IPostProcessor 。最終結果レポーターの前に後処理メソッドが呼び出されることを確認してください。

TODO:必要に応じて、ファイルの後処理にも展開します。

概要

パブリックコンストラクター

BasePostProcessor ()

パブリックメソッド

final ITestInvocationListener init ( ITestInvocationListener listener)

ポストプロセッサーの初期化ステップ。

final void invocationEnded (long elapsedTime)

正常に、または何らかのエラー条件が原因で、呼び出しが終了したことを報告します。

final void invocationFailed (Throwable cause)

何らかのエラー条件が原因で、不完全な呼び出しを報告します。

final void invocationStarted ( IInvocationContext context)

転送用の呼び出しリスナー

final boolean isDisabled ()

オブジェクト全体が無効な場合はTrueを返します(セットアップと破棄の両方をスキップします)。

final void logAssociation (String dataName, LogFile logFile)

場合によっては、ログをテストケースと強く関連付ける必要がありますが、直接testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)コールバックはできません。

processAllTestMetrics (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics)

このメソッドを実装して、テスト指標を集計します。

abstract processRunMetrics ( rawMetrics) processRunMetrics ( rawMetrics)

既存のメトリックから新しいメトリックのセットを生成するには、このメソッドを実装します。

processTestMetrics ( TestDescription testDescription, testMetrics) processTestMetrics ( TestDescription testDescription, testMetrics)

{@inhericDoc}

final void setLogSaver ( ILogSaver logSaver)

ILogSaverを設定して、実装者がファイルを保存できるようにします。

final void testAssumptionFailure ( TestDescription test, String trace)

アトミックテストがfalseの条件を想定していることを示すフラグが付けられたときに呼び出されます

final void testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) 、終了時刻を直接指定できます。

final void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

個々のテストケースの実行終了を報告します。

final void testFailed ( TestDescription test, String trace)

個々のテストケースの失敗を報告します。

final void testIgnored ( TestDescription test)

テストが実行されないときに呼び出されます。通常、テストメソッドにorg.junit.Ignoreのアノテーションが付けられているためです。

final void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)

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

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

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

final void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

テスト実行の終了を報告します。

final void testRunFailed (String errorMessage)

致命的なエラーのため、レポートのテスト実行を完了できませんでした。

final void testRunStarted (String runName, int testCount, int attemptNumber)

テスト実行の開始を報告します。

final void testRunStarted (String runName, int testCount)

テスト実行コールバック

final void testRunStopped (long elapsedTime)

ユーザーの要求により、レポートのテスト実行が完了する前に停止しました。

final void testStarted ( TestDescription test, long startTime)

testStarted(com.android.tradefed.result.TestDescription)代わりに、テストがいつ開始されたかを指定し、正確な測定のためにERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))と組み合わせます。

final void testStarted ( TestDescription test)

テストケースのコールバック

パブリックコンストラクター

BasePostProcessor

public BasePostProcessor ()

パブリックメソッド

初期化

public final ITestInvocationListener init ( ITestInvocationListener listener)

ポストプロセッサーの初期化ステップ。テストコールバックの前に必ず呼び出されます。

パラメーター
listener ITestInvocationListener

戻り値
ITestInvocationListener

invocationEnded

public final void invocationEnded (long elapsedTime)

正常に、または何らかのエラー条件が原因で、呼び出しが終了したことを報告します。

TradeFederationフレームワークによって自動的に呼び出されます。

パラメーター
elapsedTime long :呼び出しの経過時間(ミリ秒)

invocationFailed

public final void invocationFailed (Throwable cause)

何らかのエラー条件が原因で、不完全な呼び出しを報告します。

TradeFederationフレームワークによって自動的に呼び出されます。

パラメーター
cause Throwable :失敗のThrowable可能な原因

invocationStarted

public final void invocationStarted ( IInvocationContext context)

転送用の呼び出しリスナー

パラメーター
context IInvocationContext :呼び出しに関する情報

無効になっています

public final boolean isDisabled ()

オブジェクト全体が無効な場合はTrueを返します(セットアップとティアダウンの両方をスキップします)。それ以外の場合はfalse。

戻り値
boolean

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

場合によっては、ログをテストケースと強く関連付ける必要がありますが、直接testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)コールバックはできません。したがって、このコールバックにより、強い関連付けを明示的に提供できます。

パラメーター
dataName String :データの名前

logFile LogFile :以前にLogFileに記録され、テストケースに関連付ける必要があるLogFile

processAllTestMetrics

public  processAllTestMetrics (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics)

このメソッドを実装して、テスト指標を集計します。

パラメーター
allTestMetrics ListMultimap :メトリック名でグループ化された各テストからのメトリックを格納するHashMultimap。

戻り値
すべてのテスト指標から新しく生成された指標のセット。

processRunMetrics

public abstract  processRunMetrics ( rawMetrics)

既存のメトリックから新しいメトリックのセットを生成するには、このメソッドを実装します。新しく生成されたメトリックのみが返され、一意のキー名が付けられます(既存のキーとの衝突は許可されません)。

パラメーター
rawMetrics :実行に使用できる生のメトリックのセット。

戻り値
実行メトリックから新しく生成されたメトリックのセット。

processTestMetrics

public  processTestMetrics ( TestDescription testDescription, 
                 testMetrics)

{@inhericDoc}

パラメーター
testDescription TestDescription :テストを説明するTestDescriptionオブジェクト。

testMetrics :テストからのメトリックのセット。

戻り値
テスト指標から新しく生成された指標のセット。

setLogSaver

public final void setLogSaver ( ILogSaver logSaver)

ILogSaverを設定して、実装者がファイルを保存できるようにします。

パラメーター
logSaver ILogSaverILogSaver

testAssumptionFailure

public final void testAssumptionFailure ( TestDescription test, 
                String trace)

アトミックテストがfalseの条件を想定していることを示すフラグが付けられたときに呼び出されます

パラメーター
test TestDescription :テストを識別します

trace String :失敗のスタックトレース

testEnded

public final void testEnded ( TestDescription test, 
                long endTime, 
                 testMetrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) 、終了時刻を直接指定できます。正確な測定のためにtestStarted(com.android.tradefed.result.TestDescription, long)と組み合わせます。

パラメーター
test TestDescription :テストを識別します

endTime longSystem.currentTimeMillis()で測定された、テストが終了した時間

testMetrics :発生したメトリックのERROR(/Map)

testEnded

public final void testEnded ( TestDescription test, 
                 testMetrics)

個々のテストケースの実行終了を報告します。

testFailed(TestDescription, String)が呼び出されなかった場合、このテストはtestFailed(TestDescription, String)しました。また、テストケースの実行中に出力された可能性のあるキー/値メトリックを返します。

パラメーター
test TestDescription :テストを識別します

testMetrics :発生したメトリックのERROR(/Map)

testFailed

public final void testFailed ( TestDescription test, 
                String trace)

個々のテストケースの失敗を報告します。

testStartedとtestEndedの間で呼び出されます。

パラメーター
test TestDescription :テストを識別します

trace String :失敗のスタックトレース

testIgnored

public final void testIgnored ( TestDescription test)

テストが実行されないときに呼び出されます。通常、テストメソッドにorg.junit.Ignoreのアノテーションが付けられているためです。

パラメーター
test TestDescription :テストを識別します

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

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

ITestInvocationListener#invocationFailed(Throwable)またはITestInvocationListener#invocationEnded(long)前にITestInvocationListener#invocationFailed(Throwable)必要があります

TradeFederationフレームワークは自動的にこのメソッドを呼び出し、ホストログと、該当する場合はデバイスlogcatを提供します。

パラメーター
dataName String :データの説明的なString 。例:「device_logcat」。 dataNameは呼び出しごとに一意ではない場合があることに注意してください。つまり、実装者は同じdataNameで複数の呼び出しを処理できる必要があります

dataType LogDataType :データのLogDataType

dataStream InputStreamSource :データのInputStreamSource 。実装者は、createInputStreamを呼び出してデータの読み取りを開始し、完了時に結果のInputStreamを確実に閉じる必要があります。呼び出し元は、testLogメソッドが完了するまで、データのソースが存在し、アクセス可能であることを確認する必要があります。

testLogSaved

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

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

ITestInvocationListener#testLog(String, LogDataType, InputStreamSource)代わりに使用する必要があります。

パラメーター
dataName String :データの説明的なString 。例:「device_logcat」。 dataNameは呼び出しごとに一意ではない場合があることに注意してください。つまり、実装者は同じdataNameで複数の呼び出しを処理できる必要があります

dataType LogDataType :データのLogDataType

dataStream InputStreamSource :データのInputStreamSource 。実装者は、createInputStreamを呼び出してデータの読み取りを開始し、完了時に結果のInputStreamを確実に閉じる必要があります。

logFile LogFile :保存されたファイルのメタデータを含むLogFile

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

テスト実行の終了を報告します。 FIXME:タイプの異なる2つのMap <>インターフェースを使用することはできないため、ここではHashMapを使用する必要があります。

パラメーター
elapsedTime long :デバイスが経過時間をミリ秒単位で報告しました

runMetrics Metricを使用したテスト実行の最後に報告されるキーと値のペア。

testRunFailed

public final void testRunFailed (String errorMessage)

致命的なエラーのため、レポートのテスト実行を完了できませんでした。

パラメーター
errorMessage String :実行失敗の理由を説明するString

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

テスト実行の開始を報告します。

パラメーター
runName String :テスト実行名

testCount int :テスト実行のテストの総数

attemptNumber int :複数回実行される同じrunNameの異なる試行を識別する注文番号。 attemptNumberのインデックスは0であり、新しい実行が発生するたびに増分する必要があります。たとえば、テストは3回細かく再試行され、同じrunNameの下で合計4つの実行があり、attemptNumberは0〜3です。

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

テスト実行コールバック

パラメーター
runName String :テスト実行名

testCount int :テスト実行のテストの総数

testRunStopped

public final void testRunStopped (long elapsedTime)

ユーザーの要求により、レポートのテスト実行が完了する前に停止しました。

TODO:現在使用されていません。削除することを検討してください

パラメーター
elapsedTime long :デバイスが経過時間をミリ秒単位で報告しました

testStarted

public final void testStarted ( TestDescription test, 
                long startTime)

testStarted(com.android.tradefed.result.TestDescription)代わりに、テストがいつ開始されたかを指定し、正確な測定のためにERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))と組み合わせます。

パラメーター
test TestDescription :テストを識別します

startTime longSystem.currentTimeMillis()で測定された、テストの開始時間

testStarted

public final void testStarted ( TestDescription test)

テストケースのコールバック

パラメーター
test TestDescription :テストを識別します