หน้านี้ได้รับการแปลโดย 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)`

ผู้สร้างสาธารณะ

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

พารามิเตอร์
`listener`	`ITestInvocationListener`

วิธีการสาธารณะ

รับบทสรุป

public TestSummary getSummary ()

อนุญาตให้ InvocationListener ส่งคืนข้อมูลสรุป

ส่งคืน
`TestSummary`	`TestSummary` สรุปการรัน หรือ null

สิ้นสุดการร้องขอ

public void invocationEnded (long elapsedTime)

รายงานว่าการร้องขอสิ้นสุดลง ไม่ว่าจะสำเร็จหรือเนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง

จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation framework

พารามิเตอร์
`elapsedTime`	`long` : เวลาที่ผ่านไปของการเรียกใช้ในหน่วย ms

การร้องขอล้มเหลว

public void invocationFailed (Throwable cause)

รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง

จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation framework

พารามิเตอร์
`cause`	`Throwable` : สาเหตุ `Throwable` ของความล้มเหลว

เรียกใช้เริ่มต้น

public void invocationStarted (IInvocationContext context)

รายงานการเริ่มต้นการเรียกทดสอบ

จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation framework ผู้รายงานต้องแทนที่วิธีนี้เพื่อรองรับการรายงานหลายอุปกรณ์

พารามิเตอร์
`context`	`IInvocationContext` : ข้อมูลเกี่ยวกับการเรียกใช้

ทดสอบ สมมติฐาน ความล้มเหลว

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` : ระบุการทดสอบ

บันทึกการทดสอบ

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

จัดเตรียมบันทึกที่เกี่ยวข้องหรือข้อมูลการดีบักจากการเรียกทดสอบ

ต้องเรียกก่อน ERROR(/ITestInvocationListener#invocationFailed(Throwable)) หรือ ERROR(/ITestInvocationListener#invocationEnded(long))

กรอบงาน TradeFederation จะเรียกใช้เมธอดนี้โดยอัตโนมัติ โดยจัดเตรียมบันทึกโฮสต์และบันทึกอุปกรณ์ (ถ้ามี)

พารามิเตอร์
`dataName`	`String` : ชื่ออธิบาย `String` ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการเรียกใช้ คือผู้ดำเนินการต้องสามารถจัดการการโทรหลายรายการด้วย dataName เดียวกันได้
`dataType`	`LogDataType` : `LogDataType` ของข้อมูล
`dataStream`	`InputStreamSource` : `InputStreamSource` ของข้อมูล Implementers ควรเรียก createInputStream เพื่อเริ่มอ่านข้อมูล และตรวจสอบให้แน่ใจว่าได้ปิด InputStream ที่เป็นผลลัพธ์เมื่อเสร็จสิ้น ผู้โทรควรตรวจสอบให้แน่ใจว่าแหล่งที่มาของข้อมูลยังคงอยู่และสามารถเข้าถึงได้จนกว่าวิธีการ testLog จะเสร็จสมบูรณ์

การทดสอบรันสิ้นสุดแล้ว

public void testRunEnded (long elapsedTime, 
                 runMetrics)

รายงานการสิ้นสุดการทดสอบการทำงาน FIXME: เราไม่สามารถมีอินเทอร์เฟซ Map<> สองรายการที่มีประเภทต่างกันได้ ดังนั้นเราต้องใช้ HashMap ที่นี่

พารามิเตอร์
`elapsedTime`	`long` : อุปกรณ์รายงานเวลาที่ผ่านไป หน่วยเป็นมิลลิวินาที
`runMetrics`	: คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบการทำงานด้วย `Metric`

การทดสอบรันล้มเหลว

public void testRunFailed (String errorMessage)

เรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง

พารามิเตอร์
`errorMessage`	`String` : `String` ที่อธิบายถึงสาเหตุของความล้มเหลวในการรัน

ทดสอบ RunStarted

public void testRunStarted (String runName, 
                int testCount)

รายงานการเริ่มต้นการทดสอบการทำงาน

พารามิเตอร์
`runName`	`String` : ชื่อการทดสอบการทำงาน
`testCount`	`int` : จำนวนการทดสอบทั้งหมดในการทดสอบการทำงาน

ทดสอบ RunStopped

public void testRunStopped (long elapsedTime)

รายงานการทดสอบหยุดทำงานก่อนที่จะเสร็จสิ้นเนื่องจากคำขอของผู้ใช้

สิ่งที่ต้องทำ: ยังไม่ได้ใช้ พิจารณาลบ

พารามิเตอร์
`elapsedTime`	`long` : อุปกรณ์รายงานเวลาที่ผ่านไป หน่วยเป็นมิลลิวินาที

เริ่มการทดสอบแล้ว

public void testStarted (TestDescription test)

รายงานการเริ่มต้นกรณีทดสอบแต่ละรายการ อินเทอร์เฟซรุ่นเก่า ควรใช้ testStarted(com.android.tradefed.result.TestDescription) ทุกครั้งที่ทำได้

พารามิเตอร์
`test`	`TestDescription` : ระบุการทดสอบ

วิธีการป้องกัน

รหัสทดสอบ

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) เมธอดควรส่งคืนชื่อการเรียกใช้การทดสอบที่อาจแตกต่างกัน ซึ่งจะถูกส่งผ่านไปยัง ITestInvocationListener ดาวน์สตรีมที่ระบุระหว่างการสร้าง

การนำไปใช้ควรระมัดระวังที่จะไม่แก้ไขชื่อเรียกใช้งานเดิม

การใช้งานเริ่มต้นจะส่งผ่านชื่อรันการทดสอบที่เข้ามาโดยไม่แก้ไข

พารามิเตอร์
`name`	`String`

ส่งคืน
`String`