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

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

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

סיכום

בנאים ציבוריים
`NameMangleListener ( ITestInvocationListener listener)`

שיטות ציבוריות
`TestSummary`	`getSummary ()` מאפשר ל-InvocationListener להחזיר סיכום.
`void`	`invocationEnded (long elapsedTime)` מדווח שהפנייה הסתיימה, בין אם בהצלחה ובין אם עקב מצב שגיאה כלשהו.
`void`	`invocationFailed (Throwable cause)` מדווח על הזמנה לא מלאה עקב מצב שגיאה כלשהו.
`void`	`invocationStarted ( IInvocationContext context)` מדווח על תחילת הזמנת הבדיקה.
`void`	`testAssumptionFailure ( TestDescription test, String trace)` נקרא כאשר בדיקה אטומית מסמנת שהיא מניחה מצב שהוא שקרי
`void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` מדווח על סיום הביצוע של מקרה בדיקה בודד.
`void`	`testFailed ( TestDescription test, String trace)` מדווח על כישלון של מקרה בדיקה בודד.
`void`	`testIgnored ( TestDescription test)` נקרא כאשר בדיקה לא תופעל, בדרך כלל מכיוון ששיטת בדיקה מסומנת ב-org.junit.Ignore.
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` מספק את היומן המשויך או נתוני ניפוי באגים מקריאת הבדיקה.
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` מדווח על סיום ריצת המבחן.
`void`	`testRunFailed (String errorMessage)` ריצת בדיקת הדוחות לא הושלמה עקב שגיאה קטלנית.
`void`	`testRunStarted (String runName, int testCount)` מדווח על תחילת ריצת מבחן.
`void`	`testRunStopped (long elapsedTime)` הפעלת בדיקת הדוחות הופסקה לפני השלמתה עקב בקשת משתמש.
`void`	`testStarted ( TestDescription test)` מדווח על תחילת מקרה בדיקה בודד.

שיטות מוגנות
`TestDescription`	`mangleTestId ( TestDescription test)` שיטה זו מופעלת על כל ה- `TestDescription` המועברים ל- `testStarted(com.android.tradefed.result.TestDescription)` , `testFailed(com.android.tradefed.result.TestDescription, String)` ו- `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))` התקשרויות חוזרות.
`String`	`mangleTestRunName (String name)` שיטה זו מופעלת על כל שמות ריצת הבדיקה המועברים ל- `testRunStarted(String, int)` callback.

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

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

פרמטרים
`listener`	`ITestInvocationListener`

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

getSummary

public TestSummary getSummary ()

מאפשר ל-InvocationListener להחזיר סיכום.

החזרות
`TestSummary`	`TestSummary` המסכם את הריצה, או null

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

public void invocationEnded (long elapsedTime)

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

ייקרא אוטומטית על ידי מסגרת TradeFederation.

פרמטרים
`elapsedTime`	`long` : הזמן שחלף של הקריאה ב-ms

הפניה נכשלה

public void invocationFailed (Throwable cause)

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

ייקרא אוטומטית על ידי מסגרת TradeFederation.

פרמטרים
`cause`	`Throwable` : הגורם `ERROR(/Throwable)` לכשל

התראה התחילה

public void invocationStarted (IInvocationContext context)

מדווח על תחילת הזמנת הבדיקה.

ייקרא אוטומטית על ידי מסגרת TradeFederation. כתבים צריכים לעקוף שיטה זו כדי לתמוך בדיווח על מספר מכשירים.

פרמטרים
`context`	`IInvocationContext` : מידע על הפנייה

testAssumption Failure

public void testAssumptionFailure (TestDescription test, 
                String trace)

נקרא כאשר בדיקה אטומית מסמנת שהיא מניחה מצב שהוא שקרי

פרמטרים
`test`	`TestDescription` : מזהה את הבדיקה
`trace`	`String` : עקבות מחסנית של כישלון

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

public void testEnded (TestDescription test, 
                 testMetrics)

מדווח על סיום הביצוע של מקרה בדיקה בודד.

אם testFailed(TestDescription, FailureDescription) לא הופעל, מבחן זה עבר. מחזירה גם מדדי מפתח/ערך שייתכן שנפלטו במהלך ביצוע מקרה הבדיקה.

פרמטרים
`test`	`TestDescription` : מזהה את הבדיקה
`testMetrics`	: `ERROR(/Map)` של המדדים הנפלטים

מבחן נכשל

public void testFailed (TestDescription test, 
                String trace)

מדווח על כישלון של מקרה בדיקה בודד.

ייקרא בין testStarted לבין testEnded.

פרמטרים
`test`	`TestDescription` : מזהה את הבדיקה
`trace`	`String` : עקבות מחסנית של כישלון

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

public void testIgnored (TestDescription test)

נקרא כאשר בדיקה לא תופעל, בדרך כלל מכיוון ששיטת בדיקה מסומנת ב-org.junit.Ignore.

פרמטרים
`test`	`TestDescription` : מזהה את הבדיקה

testLog

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

מספק את היומן המשויך או נתוני ניפוי באגים מקריאת הבדיקה.

יש לקרוא לפני ERROR(/ITestInvocationListener#invocationFailed(Throwable)) או ERROR(/ITestInvocationListener#invocationEnded(long))

המסגרת של TradeFederation תקרא אוטומטית לשיטה זו, תספק את יומן המארח ואם רלוונטי, את logcat המכשיר.

פרמטרים
`dataName`	`String` : שם תיאורי של `ERROR(/String)` של הנתונים. למשל "device_logcat". הערה ייתכן ש-dataName אינו ייחודי לכל הזמנה. כלומר, המיישמים חייבים להיות מסוגלים לטפל במספר שיחות עם אותו dataName
`dataType`	`LogDataType` : `LogDataType` של הנתונים
`dataStream`	`InputStreamSource` : `InputStreamSource` של הנתונים. על המיישמים להתקשר ל-createInputStream כדי להתחיל לקרוא את הנתונים, ולהבטיח לסגור את ה-InputStream שהתקבל לאחר השלמתו. המתקשרים צריכים לוודא שמקור הנתונים נשאר קיים ונגיש עד להשלמת שיטת testLog.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

מדווח על סיום ריצת המבחן. FIXME: אין לנו שני ממשקי Map<> עם סוג שונה, אז עלינו להשתמש ב-HashMap כאן.

פרמטרים
`elapsedTime`	`long` : המכשיר דיווח על זמן שחלף, באלפיות שניות
`runMetrics`	: צמדי מפתח-ערך שדווחו בסוף ריצת בדיקה עם `Metric` .

testRunFailed

public void testRunFailed (String errorMessage)

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

פרמטרים
`errorMessage`	`String` : `ERROR(/String)` המתאר את הסיבה לכישלון הריצה.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

מדווח על תחילת ריצת מבחן.

פרמטרים
`runName`	`String` : שם ריצת המבחן
`testCount`	`int` : המספר הכולל של בדיקות בריצת מבחן

testRunStopped

public void testRunStopped (long elapsedTime)

הפעלת בדיקת הדוחות הופסקה לפני השלמתה עקב בקשת משתמש.

מטלה: לא בשימוש כרגע, שקול להסיר

פרמטרים
`elapsedTime`	`long` : המכשיר דיווח על זמן שחלף, באלפיות שניות

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

public void testStarted (TestDescription test)

מדווח על תחילת מקרה בדיקה בודד. ממשק ישן יותר, צריך להשתמש testStarted(com.android.tradefed.result.TestDescription) במידת האפשר.

פרמטרים
`test`	`TestDescription` : מזהה את הבדיקה

שיטות מוגנות

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

שיטה זו מופעלת על כל ה- TestDescription המועברים ל- testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) ו- ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) התקשרויות חוזרות. השיטה צריכה להחזיר TestDescription אולי שונה שיועבר ל- ITestInvocationListener במורד הזרם שצוין במהלך הבנייה.

היישום צריך להיזהר שלא לשנות את ה- TestDescription המקורי.

יישום ברירת המחדל מעביר את המזהה הנכנס ללא שינוי.

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

החזרות
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

שיטה זו מופעלת על כל שמות ריצת הבדיקה המועברים ל- testRunStarted(String, int) callback. השיטה אמורה להחזיר שם אולי-שונה של הפעלת בדיקה שיועבר ל- ITestInvocationListener במורד הזרם שצוין במהלך הבנייה.

היישום צריך להיזהר שלא לשנות את שם הריצה המקורי.

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

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

החזרות
`String`