ชื่อ MangleListener

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)

ผู้รับเหมาก่อสร้างสาธารณะ

ชื่อ MangleListener

public NameMangleListener (ITestInvocationListener listener)

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

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

รับสรุป

public TestSummary getSummary ()

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

การส่งคืน
TestSummary TestSummary สรุปการรันหรือเป็นโมฆะ

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

public void invocationEnded (long elapsedTime)

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

จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederation

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

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

public void invocationFailed (Throwable cause)

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

จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederation

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

การร้องขอเริ่มต้นแล้ว

public void invocationStarted (IInvocationContext context)

รายงานจุดเริ่มต้นของการเรียกใช้การทดสอบ

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

พารามิเตอร์
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 จะเรียกเมธอดนี้โดยอัตโนมัติ โดยจัดเตรียมบันทึกของโฮสต์และ logcat ของอุปกรณ์ หากมี

พารามิเตอร์
dataName String : ชื่อที่สื่อความหมาย String ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการร้องขอ นั่นคือผู้ดำเนินการจะต้องสามารถจัดการการโทรหลายครั้งด้วย dataName เดียวกัน

dataType LogDataType : LogDataType ของข้อมูล

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

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

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

runMetrics : คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบการทำงานด้วย Metric

testRunFailed

public void testRunFailed (String errorMessage)

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

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

ทดสอบ RunStarted

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

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

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

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

การส่งคืน
String