TestRunResult

public class TestRunResult
extends Object

java.lang.Object
   ↳ com.android.tradefed.result.TestRunResult


1 回のテスト実行の結果を保持します。

テストの正確な数を維持し、未完了のテストを追跡します。

スレッドセーフではありません。test* コールバックは順番に呼び出す必要があります。

概要

フィールド

public static final String ERROR_DIVIDER

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

TestRunResult()

空の TestRunResult を作成します。

パブリック メソッド

getCompletedTests()

完了したテストのセットを取得します。

long getElapsedTime()

現在の実行の経過時間を返します。

int getExpectedTestCount()

この TestRunResult で想定されるテストケースの数を取得します。

getFailedTests()

失敗したテストのセットを取得します。

String getName()
int getNumAllFailedTests()

失敗状態(失敗、前提条件の失敗)のテストの数を返します。

int getNumCompleteTests()

この実行で完了したテストの数(ステータスが「incomplete」以外)を取得します。

int getNumTests()

この実行に含まれるテストの数を取得します。

int getNumTestsInState(TestStatus status)

この実行で特定の状態にあるテストの数を取得します。

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

以前のステータスとの互換性について。

getPassedTests()

合格したテストのセットを取得します。

FailureDescription getRunFailureDescription()

実行が失敗していない場合は null を返します。

String getRunFailureMessage()

実行エラーのエラー メッセージを返します。実行が失敗しなかった場合は null を返します。

MultiMap<String, LogFile> getRunLoggedFiles()

そのテストケースに関連付けられたすべてのログファイルを含むマップのコピーを返します。

getRunMetrics()
getRunProtoMetrics()
long getStartTime()

最初の testRunStart 呼び出しの開始時間を返します。

getTestResults()

テスト結果のマップを返します。

getTestsInState( statuses)

指定されたステータスのテストセットを取得します。

getTestsResultsInState(TestStatus status)

特定の状態のすべての TestResult を返します。

String getTextSummary()

結果を説明するわかりやすい文字列を返します。

boolean hasFailedTests()
boolean isRunComplete()
boolean isRunFailure()
static TestRunResult merge( testRunResults)
static TestRunResult merge( testRunResults, MergeStrategy strategy)

同じ testRunName の複数の TestRunResults を統合します。

void resetRunFailure()

実行の失敗ステータスをリセットします。

void setAggregateMetrics(boolean metricAggregation)
void setRunComplete(boolean runComplete)
void testAssumptionFailure(TestDescription test, String trace)
void testAssumptionFailure(TestDescription test, FailureDescription failure)
void testEnded(TestDescription test, long endTime, testMetrics)
void testEnded(TestDescription test, testMetrics)
void testFailed(TestDescription test, FailureDescription failure)
void testFailed(TestDescription test, String trace)
void testIgnored(TestDescription test)
void testLogSaved(String dataName, LogFile logFile)

ログに記録されるファイルに関する情報は保存され、進行中のテストケースまたはテスト実行に関連付けられます。

void testRunEnded(long elapsedTime, runMetrics)
void testRunFailed(FailureDescription failureDescription)
void testRunFailed(String errorMessage)
void testRunStarted(String runName, int testCount, long startTime)

テスト実行の開始を通知します。

void testRunStarted(String runName, int testCount)

テスト実行の開始を通知します。

void testRunStopped(long elapsedTime)
void testSkipped(TestDescription test, SkipReason reason)
void testStarted(TestDescription test, long startTime)
void testStarted(TestDescription test)

フィールド

ERROR_DIVIDER

public static final String ERROR_DIVIDER

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

TestRunResult

public TestRunResult ()

空の TestRunResult を作成します。

パブリック メソッド

getCompletedTests

public  getCompletedTests ()

完了したテストのセットを取得します。

戻り値

getElapsedTime

public long getElapsedTime ()

現在の実行の経過時間を返します。

戻り値
long

getExpectedTestCount

public int getExpectedTestCount ()

この TestRunResult で想定されるテストケースの数を取得します。テストのクラッシュにより、実際の数は想定数より少なくなる場合があります。通常、このような不一致は、テスト実行の失敗を示します。

戻り値
int

getFailedTests

public  getFailedTests ()

失敗したテストのセットを取得します。

戻り値

getName

public String getName ()

戻り値
String テスト実行名

getNumAllFailedTests

public int getNumAllFailedTests ()

失敗状態(失敗、前提条件の失敗)のテストの数を返します。

戻り値
int

getNumCompleteTests

public int getNumCompleteTests ()

この実行の完了済みテストの数、つまりステータスが != 未完了のものを取得します。

戻り値
int

getNumTests

public int getNumTests ()

この実行のテスト数を取得します。

戻り値
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

この実行で特定の状態にあるテストの数を取得します。

パラメータ
status TestStatus

戻り値
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

以前のステータスとの互換性のため。代わりに getNumTestsInState(com.android.tradefed.result.TestStatus) を使用する。

パラメータ
ddmlibStatus TestResult.TestStatus

戻り値
int

getPassedTests

public  getPassedTests ()

合格したテストのセットを取得します。

戻り値

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

実行失敗ディスクリプタを返します。実行に失敗しなかった場合は null を返します。

戻り値
FailureDescription

getRunFailureMessage

public String getRunFailureMessage ()

実行エラーのエラー メッセージを返します。実行に失敗しなかった場合は null を返します。

戻り値
String

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

そのテストケースに関連付けられたすべてのログファイルを含むマップのコピーを返します。

戻り値
MultiMap<String, LogFile>

getRunMetrics

public  getRunMetrics ()

戻り値
テスト実行指標の ERROR(/Map)

getRunProtoMetrics

public  getRunProtoMetrics ()

戻り値
新しいプロトコル形式のテスト実行指標の ERROR(/Map)

getStartTime

public long getStartTime ()

最初の testRunStart 呼び出しの開始時間を返します。

戻り値
long

getTestResults

public  getTestResults ()

テスト結果のマップを返します。

戻り値

getTestsInState

public  getTestsInState ( statuses)

特定のステータスにある一連のテストを取得します。

パラメータ
statuses

戻り値

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

特定の状態のすべての TestResult を返します。

パラメータ
status TestStatus

戻り値

getTextSummary

public String getTextSummary ()

結果を説明するわかりやすい文字列を返します。

戻り値
String

hasFailedTests

public boolean hasFailedTests ()

戻り値
boolean true: テストの失敗またはエラーテストがある場合。

isRunComplete

public boolean isRunComplete ()

戻り値
boolean テスト実行が完了した場合は true

isRunFailure

public boolean isRunFailure ()

戻り値
boolean テスト実行が失敗した場合は true

外部データを統合して表示

public static TestRunResult merge ( testRunResults)

パラメータ
testRunResults

戻り値
TestRunResult

外部データを統合して表示

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

同じ testRunName の複数の TestRunResults をマージ。1 つのテストケースが複数の TestRunResults に表示されても、結果が異なる場合(例: 「boottest-device」が 3 回実行され、不合格となった実行の結果が FAIL-FAIL-PASS の場合)は、失敗した実行のすべてのスタック トレースを連結し、ステータス、指標、ログファイル、開始/終了時間に対する最終的な実行結果を信頼します。

パラメータ
testRunResults : 統合する TestRunResult のリスト。

strategy MergeStrategy: 結果の統合に採用される統合戦略。

戻り値
TestRunResult testRunResults から統合されたデータを含む最終的な TestRunResult。

resetRunFailure

public void resetRunFailure ()

実行の失敗ステータスをリセットします。

再試行するときに、実行の失敗ステータスのリセットが必要になる場合があります。実際の障害を消去しないように注意して行ってください。

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

パラメータ
metricAggregation boolean

setRunComplete

public void setRunComplete (boolean runComplete)

パラメータ
runComplete boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

パラメータ
test TestDescription

trace String

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

パラメータ
test TestDescription

failure FailureDescription

testEnded

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

パラメータ
test TestDescription

endTime long

testMetrics

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

パラメータ
test TestDescription

testMetrics

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

パラメータ
test TestDescription

failure FailureDescription

testFailed

public void testFailed (TestDescription test, 
                String trace)

パラメータ
test TestDescription

trace String

testIgnored

public void testIgnored (TestDescription test)

パラメータ
test TestDescription

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

ログに記録されるファイルに関する情報は保存され、進行中のテストケースまたはテスト実行に関連付けられます。

パラメータ
dataName String: データを参照する名前。

logFile LogFile: オブジェクトの保存場所とその情報を表す LogFile オブジェクト。

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

パラメータ
elapsedTime long

runMetrics

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

パラメータ
failureDescription FailureDescription

testRunFailed

public void testRunFailed (String errorMessage)

パラメータ
errorMessage String

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                long startTime)

テスト実行の開始を通知します。

パラメータ
runName String: トラッキング用にテスト実行に関連付けられた名前。

testCount int: テスト実行に関連付けられた想定されるテストケースの数。

startTime long

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

テスト実行の開始を通知します。

パラメータ
runName String: トラッキング用にテスト実行に関連付けられた名前。

testCount int: テスト実行に関連付けられた想定されるテストケースの数。

testRunStopped

public void testRunStopped (long elapsedTime)

パラメータ
elapsedTime long

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

パラメータ
test TestDescription

reason SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

パラメータ
test TestDescription

startTime long

testStarted

public void testStarted (TestDescription test)

パラメータ
test TestDescription