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