דף זה תורגם על ידי Cloud Translation API.

CollectingTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener

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

תת מחלקות ישירות ידועות

JsonHttpTestResultReporter , MetricsXMLResultReporter , ModuleListener , ReportPassedTests , ResultAggregator , ShardListener , SuiteResultReporter , XmlResultReporter

JsonHttpTestResultReporter	כתב תוצאות שמקודד תוצאות מדדי בדיקה והסתעפות, פרטי מכשיר ל-JSON ו-POST לנקודת קצה של שירות HTTP
MetricsXMLResultReporter	MetricsXMLResultReporter כותב מדדי בדיקה ומריץ מדדים לקובץ XML בתיקייה שצוינה על ידי פרמטר metrics-folder בשלב invocationEnded של הבדיקה.
ModuleListener	מאזין מצורף לכל `IRemoteTest` של כל מודול על מנת לאסוף את רשימת התוצאות.
ReportPassedTests	דווח בקובץ על מסננים אפשריים כדי לא לכלול מבחן שעבר.
ResultAggregator	משלח מיוחד שמגבש את התוצאות בעת הצורך, בהתבסס על אסטרטגיית הניסיון החוזר שננקטה.
ShardListener	`ITestInvocationListener` שאוסף תוצאות מ-Shard (הידוע גם בשם פיצול הזמנה להפעלה על מספר משאבים במקביל), ומעביר אותם למאזין אחר.
SuiteResultReporter	אסוף תוצאות בדיקה עבור הזמנה של חבילה שלמה והוציא את התוצאות הסופיות.
XmlResultReporter	כותב תוצאות JUnit לקובצי XML בפורמט התואם ל-XMLJUnitResultFormatter של Ant.

תת-מחלקות עקיפות ידועות

FormattedGeneratorReporter , XmlFormattedGeneratorReporter

FormattedGeneratorReporter	כתב המאפשר להפיק דוחות בפורמט מסוים.
XmlFormattedGeneratorReporter	יישום של `FormattedGeneratorReporter` אשר פורמט את החבילה מביא לפורמט xml.

ITestInvocationListener שיאסוף את כל תוצאות הבדיקה.

למרות שמבני הנתונים המשמשים באובייקט זה בטוחים לשרשור, יש לקרוא להתקשרות חזרה של ITestInvocationListener בסדר הנכון.

סיכום

בנאים ציבוריים
`CollectingTestListener ()`

שיטות ציבוריות
`IBuildInfo`	`getBuildInfo ()` שיטה זו הוצאה משימוש. הסתמכו על `IBuildInfo` מ- `getInvocationContext()` .
`TestRunResult`	`getCurrentRunResults ()` מקבל את התוצאות עבור ריצת הבדיקה הנוכחית.
`int`	`getExpectedTests ()` מחזירה את מספר הבדיקות הצפויות.
`IInvocationContext`	`getInvocationContext ()` החזר את הקשר ההתקשרות שדווח באמצעות `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`
	`getMergedTestRunResults ()` החזר את אוסף התוצאות הממוזג עבור כל הריצות על פני ניסיונות שונים.
`IInvocationContext`	`getModuleContextForRunResult (String testRunName)` מחזירה את `IInvocationContext` של המודול המשויך לתוצאות.
`MultiMap<String, LogFile>`	`getModuleLogFiles ()` מחזירה עותק של המפה המכילה את כל הקבצים הרשום המשויכים למודול
`MultiMap<String, LogFile>`	`getNonAssociatedLogFiles ()` מחזירה עותק של המפה המכילה את כל הקובץ המתועד שאינו משויך להפעלת מבחן או למודול.
`int`	`getNumAllFailedTestRuns ()` מחזירה את המספר הכולל של ריצות בדיקה במצב כשל
`int`	`getNumAllFailedTests ()` מחזירה את המספר הכולל של בדיקות במצב כשל (רק נכשל, כשלים בהנחה אינם נחשבים כלפיו).
`int`	`getNumTestsInState (TestResult.TestStatus status)` מחזירה את מספר הבדיקות במצב נתון עבור ריצה זו.
`int`	`getNumTotalTests ()` מחזירה את המספר הכולל של בדיקות שלמות עבור כל הריצות.
`IBuildInfo`	`getPrimaryBuildInfo ()` החזר את פרטי הבנייה הראשיים שדווחו באמצעות `invocationStarted(com.android.tradefed.invoker.IInvocationContext)` .
	`getRunResults ()` שיטה זו הוצאה משימוש. השתמש `getMergedTestRunResults()`
`TestRunResult`	`getTestRunAtAttempt (String testRunName, int attempt)` החזר את `TestRunResult` עבור ניסיון בודד.
`int`	`getTestRunAttemptCount (String testRunName)` מחזירה את מספר הניסיונות עבור שם נתון של ריצת בדיקה.
	`getTestRunAttempts (String testRunName)` מקבל את כל הניסיונות ל- `TestRunResult` של ריצת בדיקה נתונה.
	`getTestRunForAttempts (int attempt)` מקבל את כל התוצאות עבור ניסיון נתון.
	`getTestRunNames ()` החזר את כל השמות עבור כל ריצות הבדיקה.
`boolean`	`hasFailedTests ()` מחזירה אם הפנייה נכשלה במבחנים כלשהם או בהנחה שנכשלו.
`boolean`	`hasTestRunResultsForName (String testRunName)` מחזירה אם לשם ריצת בדיקה נתון יש תוצאות כלשהן.
`void`	`invocationEnded (long elapsedTime)`
`void`	`invocationFailed (Throwable cause)`
`void`	`invocationStarted (IInvocationContext context)`
`void`	`logAssociation (String dataName, LogFile logFile)`
`void`	`setBuildInfo (IBuildInfo buildInfo)` שיטה זו הוצאה משימוש. לא הכרחי לבדיקה יותר.
`void`	`setMergeStrategy (MergeStrategy strategy)` מגדיר את `MergeStrategy` לשימוש בעת מיזוג תוצאות.
`void`	`testAssumptionFailure (TestDescription test, String trace)`
`void`	`testAssumptionFailure (TestDescription test, FailureDescription failure)`
`void`	`testEnded (TestDescription test, long endTime, testMetrics)` `testEnded (TestDescription test, long endTime, testMetrics)`
`void`	`testEnded (TestDescription test, testMetrics)` `testEnded (TestDescription test, testMetrics)`
`void`	`testFailed (TestDescription test, FailureDescription failure)`
`void`	`testFailed (TestDescription test, String trace)`
`void`	`testIgnored (TestDescription test)`
`void`	`testModuleEnded ()`
`void`	`testModuleStarted (IInvocationContext moduleContext)`
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)`
`void`	`testRunFailed (FailureDescription failure)`
`void`	`testRunFailed (String errorMessage)`
`void`	`testRunStarted (String name, int numTests, int attemptNumber)`
`void`	`testRunStarted (String name, int numTests)`
`void`	`testRunStarted (String name, int numTests, int attemptNumber, long startTime)`
`void`	`testRunStopped (long elapsedTime)`
`void`	`testStarted (TestDescription test, long startTime)`
`void`	`testStarted (TestDescription test)`

שיטות מוגנות
`final void`	`clearModuleLogFiles ()` מאפשר ניקוי קובץ המודול, כך שאנו נמנעים מלשאת אותם זמן רב מדי.
`final void`	`clearResultsForName (String testRunName)` מאפשר לנקות את התוצאות עבור שם ריצה נתון.
`void`	`setIsAggregrateMetrics (boolean aggregate)` החלף את האפשרות 'מדדים מצטברים'

בנאים ציבוריים

CollectingTestListener

public CollectingTestListener ()

שיטות ציבוריות

getBuildInfo

public IBuildInfo getBuildInfo ()

שיטה זו הוצאה משימוש.
הסתמכו על IBuildInfo מ- getInvocationContext() .

מחזיר את פרטי הבנייה.

החזרות
`IBuildInfo`

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

מקבל את התוצאות עבור ריצת הבדיקה הנוכחית.

שימו לב, ייתכן שהתוצאות אינן שלמות. מומלץ לבדוק את הערך של TestRunResult.isRunComplete() ו/או (@link TestRunResult#isRunFailure()} לפי המתאים לפני עיבוד התוצאות.

החזרות
`TestRunResult`	ה- `TestRunResult` המייצג נתונים שנאספו במהלך ריצת הבדיקה האחרונה

getExpectedTests

public int getExpectedTests ()

מחזירה את מספר הבדיקות הצפויות. יכול להיות שונה מ getNumTotalTests() אם חלק מהבדיקות לא פעלו.

החזרות
`int`

getInvocationContext

public IInvocationContext getInvocationContext ()

החזר את הקשר ההתקשרות שדווח באמצעות invocationStarted(com.android.tradefed.invoker.IInvocationContext)

החזרות
`IInvocationContext`

getMergedTestRunResults

public  getMergedTestRunResults ()

החזר את אוסף התוצאות הממוזג עבור כל הריצות על פני ניסיונות שונים.

אם יש מספר תוצאות, כל ריצת בדיקה מתמזגת, כאשר תוצאת הבדיקה האחרונה מחליפה את תוצאות הבדיקה של ריצות קודמות. ריצות המבחן מסודרות לפי מספר הניסיון.

מדדים עבור אותו ניסיון ימוזגו על סמך ההעדפה שנקבעה על ידי aggregate-metrics . המדדים הסופיים יהיו המדדים של הניסיון האחרון.

החזרות

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

מחזירה את IInvocationContext של המודול המשויך לתוצאות.

פרמטרים
`testRunName`	`String` : השם שניתן על ידי { `testRunStarted(String, int)` .

החזרות
`IInvocationContext`	`IInvocationContext` של המודול עבור שם ריצת בדיקה נתון `null` אם אין תוצאות עבור השם הזה.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

מחזירה עותק של המפה המכילה את כל הקבצים הרשום המשויכים למודול

החזרות
`MultiMap<String, LogFile>`

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

מחזירה עותק של המפה המכילה את כל הקובץ המתועד שאינו משויך להפעלת מבחן או למודול.

החזרות
`MultiMap<String, LogFile>`

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

מחזירה את המספר הכולל של ריצות בדיקה במצב כשל

החזרות
`int`

getNumAllFailedTests

public int getNumAllFailedTests ()

מחזירה את המספר הכולל של בדיקות במצב כשל (רק נכשל, כשלים בהנחה אינם נחשבים כלפיו).

החזרות
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

מחזירה את מספר הבדיקות במצב נתון עבור ריצה זו.

פרמטרים
`status`	`TestResult.TestStatus`

החזרות
`int`

getNumTotalTests

public int getNumTotalTests ()

מחזירה את המספר הכולל של בדיקות שלמות עבור כל הריצות.

החזרות
`int`

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

החזר את פרטי הבנייה הראשיים שדווחו באמצעות invocationStarted(com.android.tradefed.invoker.IInvocationContext) . Build ראשי הוא ה-Build המוחזר על ידי ספק ה-Build הראשון של התצורה הפועלת. מחזירה null אם אין הקשר (ללא בנייה למקרה בדיקה).

החזרות
`IBuildInfo`

getRunResults

public  getRunResults ()

שיטה זו הוצאה משימוש.
השתמש getMergedTestRunResults()

מחזיר את התוצאות עבור כל ריצות הבדיקה.

החזרות

getTestRunAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

החזר את TestRunResult עבור ניסיון בודד.

פרמטרים
`testRunName`	`String` : השם שניתן על ידי { `testRunStarted(String, int)` .
`attempt`	`int` : מזהה הניסיון.

החזרות
`TestRunResult`	ה- `TestRunResult` עבור השם הנתון ומזהה הניסיון או `null` אם הוא לא קיים.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

מחזירה את מספר הניסיונות עבור שם נתון של ריצת בדיקה.

פרמטרים
`testRunName`	`String` : השם שניתן על ידי { `testRunStarted(String, int)` .

החזרות
`int`

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

מקבל את כל הניסיונות ל- TestRunResult של ריצת בדיקה נתונה.

פרמטרים
`testRunName`	`String` : השם שניתן על ידי { `testRunStarted(String, int)` .

החזרות
	כל `TestRunResult` עבור ריצת בדיקה נתונה, מסודרים לפי ניסיונות.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

מקבל את כל התוצאות עבור ניסיון נתון.

פרמטרים
`attempt`	`int` : הניסיון שאנחנו רוצים תוצאות עבורו.

החזרות
	כל `TestRunResult` עבור ניסיון נתון.

getTestRunNames

public  getTestRunNames ()

החזר את כל השמות עבור כל ריצות הבדיקה.

ייתכן שהרצות בדיקה אלו רצו מספר פעמים עם ניסיונות שונים.

החזרות

hasFailedTests

public boolean hasFailedTests ()

מחזירה אם הפנייה נכשלה במבחנים כלשהם או בהנחה שנכשלו.

החזרות
`boolean`

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

מחזירה אם לשם ריצת בדיקה נתון יש תוצאות כלשהן.

פרמטרים
`testRunName`	`String` : השם שניתן על ידי { `testRunStarted(String, int)` .

החזרות
`boolean`

הקריאה הסתיימה

public void invocationEnded (long elapsedTime)

פרמטרים
`elapsedTime`	`long`

הפניה נכשלה

public void invocationFailed (Throwable cause)

פרמטרים
`cause`	`Throwable`

התראה התחילה

public void invocationStarted (IInvocationContext context)

פרמטרים
`context`	`IInvocationContext`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

פרמטרים
`dataName`	`String`
`logFile`	`LogFile`

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

שיטה זו הוצאה משימוש.
לא הכרחי לבדיקה יותר.

הגדר את פרטי הבנייה. צריך לשמש רק לבדיקה.

פרמטרים
`buildInfo`	`IBuildInfo`

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

מגדיר את MergeStrategy לשימוש בעת מיזוג תוצאות.

פרמטרים
`strategy`	`MergeStrategy`

testAssumption Failure

public void testAssumptionFailure (TestDescription test, 
                String trace)

פרמטרים
`test`	`TestDescription`
`trace`	`String`

testAssumption Failure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

פרמטרים
`test`	`TestDescription`
`failure`	`FailureDescription`

הבדיקה הסתיים

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

פרמטרים
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

הבדיקה הסתיים

public void testEnded (TestDescription test, 
                 testMetrics)

פרמטרים
`test`	`TestDescription`
`testMetrics`

מבחן נכשל

public void testFailed (TestDescription test, 
                FailureDescription failure)

פרמטרים
`test`	`TestDescription`
`failure`	`FailureDescription`

מבחן נכשל

public void testFailed (TestDescription test, 
                String trace)

פרמטרים
`test`	`TestDescription`
`trace`	`String`

התעלמו מהבדיקה

public void testIgnored (TestDescription test)

פרמטרים
`test`	`TestDescription`

testModuleEnded

public void testModuleEnded ()

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

פרמטרים
`moduleContext`	`IInvocationContext`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

פרמטרים
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public void testRunFailed (FailureDescription failure)

פרמטרים
`failure`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

פרמטרים
`errorMessage`	`String`

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

פרמטרים
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests)

פרמטרים
`name`	`String`
`numTests`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

פרמטרים
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`
`startTime`	`long`

testRunStopped

public void testRunStopped (long elapsedTime)

פרמטרים
`elapsedTime`	`long`

הבדיקה התחילה

public void testStarted (TestDescription test, 
                long startTime)

פרמטרים
`test`	`TestDescription`
`startTime`	`long`

הבדיקה התחילה

public void testStarted (TestDescription test)

פרמטרים
`test`	`TestDescription`

שיטות מוגנות

clearModuleLogFiles

protected final void clearModuleLogFiles ()

מאפשר ניקוי קובץ המודול, כך שאנו נמנעים מלשאת אותם זמן רב מדי.

clearResultsForName

protected final void clearResultsForName (String testRunName)

מאפשר לנקות את התוצאות עבור שם ריצה נתון. צריך לשמש רק במקרים מסוימים כמו אגרגטור התוצאות.

פרמטרים
`testRunName`	`String`

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

החלף את האפשרות 'מדדים מצטברים'

פרמטרים
`aggregate`	`boolean`