ProtoResultReporter
public abstract class ProtoResultReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.Object | |
↳ | com.android.tradefed.result.proto.ProtoResultReporter |
ผู้รายงานผลลัพธ์สร้าง Protobuf TestRecord
โดยมีผลลัพธ์ทั้งหมดอยู่ภายใน ควรขยายเพื่อจัดการกับสิ่งที่ต้องทำกับโปรโตสุดท้ายใน processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord)
สรุป
ผู้รับเหมาก่อสร้างสาธารณะ | |
---|---|
ProtoResultReporter () |
วิธีการสาธารณะ | |
---|---|
final void | invocationEnded (long elapsedTime) รายงานว่าการร้องขอสิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือเนื่องมาจากเงื่อนไขข้อผิดพลาดบางประการ |
void | invocationFailed ( FailureDescription failure) รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากมีข้อผิดพลาดบางประการ |
void | invocationFailed (Throwable cause) รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากมีข้อผิดพลาดบางประการ |
void | invocationSkipped ( SkipReason reason) รายงานการร้องขอว่าข้ามไป |
final void | invocationStarted ( IInvocationContext context) รายงานจุดเริ่มต้นของการเรียกใช้การทดสอบ |
final void | logAssociation (String dataName, LogFile logFile) ในบางกรณี บันทึกจะต้องเชื่อมโยงอย่างมากกับกรณีทดสอบ แต่มีโอกาสที่จะทำเช่นนั้นใน |
void | processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs) ใช้บันทึกการร้องขอเพื่อส่งบันทึกสุดท้ายของการร้องขอทีละรายการ |
void | processFinalProto (TestRecordProto.TestRecord finalRecord) การจัดการกับโปรโตสุดท้ายพร้อมผลลัพธ์ทั้งหมด |
void | processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext) การจัดการโปรโตบันทึกการทดสอบการร้องขอบางส่วนหลังจาก |
void | processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord) การจัดการโปรโตบันทึกกรณีทดสอบสรุปผลหลังจากเกิด |
void | processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord) การจัดการโปรโตบันทึกกรณีทดสอบบางส่วนหลังจาก |
void | processTestModuleEnd (TestRecordProto.TestRecord moduleRecord) การจัดการโปรโตบันทึกโมดูลสรุปผลหลังจากเกิดขึ้น |
void | processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord) การจัดการโปรโตบันทึกโมดูลบางส่วนหลังจาก |
void | processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress) การจัดการโปรโตบันทึกการรันสรุปผลหลังจากเกิด |
void | processTestRunStarted (TestRecordProto.TestRecord runStartedRecord) การจัดการโปรโตบันทึกการรันการทดสอบบางส่วนหลังจาก |
void | setGranularResults (boolean granularResults) |
void | setInlineRecordOfChildren (boolean inline) |
boolean | supportGranularResults () ส่งคืน True หากผู้รายงานสนับสนุนผลลัพธ์แบบละเอียด หากไม่ใช่จะเป็นเท็จ |
final void | testAssumptionFailure ( TestDescription test, String trace) เรียกว่าเมื่อการทดสอบอะตอมมิกแฟล็กว่าเงื่อนไขนั้นเป็นเท็จ |
final void | testAssumptionFailure ( TestDescription test, FailureDescription failure) เรียกว่าเมื่อการทดสอบอะตอมมิกแฟล็กว่าเงื่อนไขนั้นเป็นเท็จ |
final void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) ทางเลือกอื่นสำหรับ |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) รายงานการสิ้นสุดการดำเนินการของกรณีทดสอบแต่ละรายการ |
final void | testFailed ( TestDescription test, FailureDescription failure) รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ |
final void | testFailed ( TestDescription test, String trace) รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ |
final void | testIgnored ( TestDescription test) เรียกว่าเมื่อการทดสอบจะไม่ทำงาน โดยทั่วไปเนื่องจากวิธีทดสอบมีคำอธิบายประกอบด้วย org.junit.Ignore |
final void | testModuleEnded () รายงานการสิ้นสุดการรันโมดูล |
final void | testModuleStarted ( IInvocationContext moduleContext) รายงานจุดเริ่มต้นของโมดูลที่ทำงานอยู่ |
final void | testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) รายงานการสิ้นสุดการทดสอบการทำงาน |
final void | testRunFailed ( FailureDescription failure) รายงานการทดสอบการทำงานล้มเหลวที่จะเสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย |
final void | testRunFailed (String errorMessage) รายงานการดำเนินการทดสอบล้มเหลวเนื่องจากข้อผิดพลาดร้ายแรง |
void | testRunStarted (String runName, int testCount, int attemptNumber) รายงานการเริ่มต้นการทดสอบการทำงาน |
final void | testRunStarted (String runName, int testCount) รายงานการเริ่มต้นการทดสอบการทำงาน |
void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) รายงานการเริ่มต้นการทดสอบการทำงาน |
final void | testSkipped ( TestDescription test, SkipReason reason) เรียกว่าเมื่อข้ามการทดสอบและไม่ได้ดำเนินการด้วยเหตุผลที่ปกติไม่คาดหมาย |
final void | testStarted ( TestDescription test, long startTime) ทางเลือกอื่นแทน |
final void | testStarted ( TestDescription test) รายงานการเริ่มต้นของกรณีทดสอบแต่ละรายการ |
วิธีการที่ได้รับการป้องกัน | |
---|---|
TestRecordProto.ChildReference | createModuleChildReference (TestRecordProto.TestRecord record) สร้างการอ้างอิงลูกสำหรับโมดูล |
ผู้รับเหมาก่อสร้างสาธารณะ
ProtoResultReporter
public ProtoResultReporter ()
วิธีการสาธารณะ
การร้องขอสิ้นสุดแล้ว
public final void invocationEnded (long elapsedTime)
รายงานว่าการร้องขอสิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือเนื่องมาจากเงื่อนไขข้อผิดพลาดบางประการ
จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederationพารามิเตอร์ | |
---|---|
elapsedTime | long : เวลาที่ผ่านไปของการร้องขอในหน่วย ms |
การร้องขอล้มเหลว
public void invocationFailed (FailureDescription failure)
รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากมีข้อผิดพลาดบางประการ
จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederation
พารามิเตอร์ | |
---|---|
failure | FailureDescription : FailureDescription ที่อธิบายสาเหตุของความล้มเหลว |
การร้องขอล้มเหลว
public void invocationFailed (Throwable cause)
รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากมีข้อผิดพลาดบางประการ
จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederationพารามิเตอร์ | |
---|---|
cause | Throwable : สาเหตุ Throwable ของความล้มเหลว |
การร้องขอข้ามไป
public void invocationSkipped (SkipReason reason)
รายงานการร้องขอว่าข้ามไป
พารามิเตอร์ | |
---|---|
reason | SkipReason |
การร้องขอเริ่มต้นแล้ว
public final void invocationStarted (IInvocationContext context)
รายงานจุดเริ่มต้นของการเรียกใช้การทดสอบ
จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederation ผู้รายงานจำเป็นต้องแทนที่วิธีนี้เพื่อรองรับการรายงานอุปกรณ์หลายเครื่อง
พารามิเตอร์ | |
---|---|
context | IInvocationContext : ข้อมูลเกี่ยวกับการร้องขอ |
สมาคมล็อก
public final void logAssociation (String dataName, LogFile logFile)
ในบางกรณี บันทึกจะต้องเชื่อมโยงอย่างมากกับกรณีทดสอบ แต่มีโอกาสที่จะทำเช่นนั้นใน testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
โดยตรง testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
ไม่สามารถโทรกลับได้ ดังนั้นการเรียกกลับนี้ช่วยให้สามารถระบุการเชื่อมโยงที่แน่นแฟ้นได้อย่างชัดเจน
พารามิเตอร์ | |
---|---|
dataName | String : ชื่อของข้อมูล |
logFile | LogFile : LogFile ที่ถูกบันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับกรณีทดสอบ |
กระบวนการ FinalInvocationLogs
public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)
ใช้บันทึกการร้องขอเพื่อส่งบันทึกสุดท้ายของการร้องขอทีละรายการ
พารามิเตอร์ | |
---|---|
invocationLogs | TestRecordProto.TestRecord : โปรโตสรุปที่แสดงถึงการเรียกใช้ |
กระบวนการFinalProto
public void processFinalProto (TestRecordProto.TestRecord finalRecord)
การจัดการกับโปรโตสุดท้ายพร้อมผลลัพธ์ทั้งหมด
พารามิเตอร์ | |
---|---|
finalRecord | TestRecordProto.TestRecord : โปรโตสรุปพร้อมผลลัพธ์การเรียกใช้ทั้งหมด |
กระบวนการStartInvocation
public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
การจัดการโปรโตบันทึกการทดสอบการร้องขอบางส่วนหลังจาก invocationStarted(com.android.tradefed.invoker.IInvocationContext)
เกิดขึ้น
พารามิเตอร์ | |
---|---|
invocationStartRecord | TestRecordProto.TestRecord : โปรโตบางส่วนที่เติมข้อมูลหลังจาก invocationStart |
invocationContext | IInvocationContext : การร้องขอ IInvocationContext |
กระบวนการTestCaseEnded
public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)
การจัดการโปรโตบันทึกกรณีทดสอบสรุปผลหลังจากเกิด ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))
พารามิเตอร์ | |
---|---|
testCaseRecord | TestRecordProto.TestRecord : โปรโตสรุปที่แสดงถึงกรณีทดสอบ |
กระบวนการTestCaseStarted
public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)
การจัดการโปรโตบันทึกกรณีทดสอบบางส่วนหลังจาก testStarted(com.android.tradefed.result.TestDescription, long)
เกิดขึ้น
พารามิเตอร์ | |
---|---|
testCaseStartedRecord | TestRecordProto.TestRecord : โปรโตบางส่วนที่แสดงถึงกรณีทดสอบ |
กระบวนการทดสอบโมดูลสิ้นสุด
public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)
การจัดการโปรโตบันทึกโมดูลสรุปผลหลังจากเกิดขึ้น testModuleEnded()
พารามิเตอร์ | |
---|---|
moduleRecord | TestRecordProto.TestRecord : โปรโตสรุปที่เป็นตัวแทนของโมดูล |
กระบวนการทดสอบโมดูลเริ่มต้นแล้ว
public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)
การจัดการโปรโตบันทึกโมดูลบางส่วนหลังจาก testModuleStarted(com.android.tradefed.invoker.IInvocationContext)
เกิดขึ้น
พารามิเตอร์ | |
---|---|
moduleStartRecord | TestRecordProto.TestRecord : โปรโตบางส่วนที่เป็นตัวแทนของโมดูล |
กระบวนการ TestRunEnded
public void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
การจัดการโปรโตบันทึกการรันสรุปผลหลังจากเกิด ERROR(/#testRunEnded(long,HashMap))
พารามิเตอร์ | |
---|---|
runRecord | TestRecordProto.TestRecord : โปรโตสรุปที่แสดงถึงการวิ่ง |
moduleInProgress | boolean : แสดงว่าโมดูลกำลังดำเนินการอยู่หรือไม่ |
กระบวนการ TestRunStarted
public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)
การจัดการโปรโตบันทึกการรันการทดสอบบางส่วนหลังจาก testRunStarted(String, int)
เกิดขึ้น
พารามิเตอร์ | |
---|---|
runStartedRecord | TestRecordProto.TestRecord : โปรโตบางส่วนที่แสดงถึงการวิ่ง |
กำหนดผลลัพธ์แบบละเอียด
public void setGranularResults (boolean granularResults)
พารามิเตอร์ | |
---|---|
granularResults | boolean |
setInlineRecordOfChildren
public void setInlineRecordOfChildren (boolean inline)
พารามิเตอร์ | |
---|---|
inline | boolean |
สนับสนุนผลลัพธ์แบบละเอียด
public boolean supportGranularResults ()
ส่งคืน True หากผู้รายงานสนับสนุนผลลัพธ์แบบละเอียด หากไม่ใช่จะเป็นเท็จ
การส่งคืน | |
---|---|
boolean |
ทดสอบความล้มเหลว
public final void testAssumptionFailure (TestDescription test, String trace)
เรียกว่าเมื่อการทดสอบอะตอมมิกแฟล็กว่าเงื่อนไขนั้นเป็นเท็จ
พารามิเตอร์ | |
---|---|
test | TestDescription : ระบุการทดสอบ |
trace | String : การติดตามสแต็กของความล้มเหลว |
ทดสอบความล้มเหลว
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
เรียกว่าเมื่อการทดสอบอะตอมมิกแฟล็กว่าเงื่อนไขนั้นเป็นเท็จ
พารามิเตอร์ | |
---|---|
test | TestDescription : ระบุการทดสอบ |
failure | FailureDescription : FailureDescription ที่อธิบายความล้มเหลวและบริบทของมัน |
การทดสอบสิ้นสุดแล้ว
public final void testEnded (TestDescription test, long endTime,testMetrics)
ทางเลือกอื่นสำหรับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
ซึ่งเราสามารถระบุเวลาสิ้นสุดได้โดยตรง ใช้ร่วมกับ testStarted(com.android.tradefed.result.TestDescription, long)
เพื่อการวัดที่แม่นยำ
พารามิเตอร์ | |
---|---|
test | TestDescription : ระบุการทดสอบ |
endTime | long : เวลาที่การทดสอบสิ้นสุด วัดผ่าน System.currentTimeMillis() |
testMetrics | ERROR(/Map) ของตัวชี้วัดที่ปล่อยออกมา |
การทดสอบสิ้นสุดแล้ว
public void testEnded (TestDescription test,testMetrics)
รายงานการสิ้นสุดการดำเนินการของกรณีทดสอบแต่ละรายการ
หากไม่ได้เรียกใช้ testFailed(TestDescription, FailureDescription)
แสดงว่าการทดสอบนี้ผ่านไป นอกจากนี้ ยังส่งคืนเมตริกคีย์/ค่าใดๆ ที่อาจถูกส่งออกมาระหว่างการดำเนินการของกรณีทดสอบ
พารามิเตอร์ | |
---|---|
test | TestDescription : ระบุการทดสอบ |
testMetrics | ERROR(/Map) ของตัวชี้วัดที่ปล่อยออกมา |
การทดสอบล้มเหลว
public final void testFailed (TestDescription test, FailureDescription failure)
รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
จะถูกเรียกระหว่าง testStarted และ testEnded
พารามิเตอร์ | |
---|---|
test | TestDescription : ระบุการทดสอบ |
failure | FailureDescription : FailureDescription ที่อธิบายความล้มเหลวและบริบทของมัน |
การทดสอบล้มเหลว
public final void testFailed (TestDescription test, String trace)
รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
จะถูกเรียกระหว่าง testStarted และ testEnded
พารามิเตอร์ | |
---|---|
test | TestDescription : ระบุการทดสอบ |
trace | String : การติดตามสแต็กของความล้มเหลว |
ทดสอบละเว้น
public final void testIgnored (TestDescription test)
เรียกว่าเมื่อการทดสอบจะไม่ทำงาน โดยทั่วไปเนื่องจากวิธีทดสอบมีคำอธิบายประกอบด้วย org.junit.Ignore
พารามิเตอร์ | |
---|---|
test | TestDescription : ระบุการทดสอบ |
ทดสอบโมดูลสิ้นสุดแล้ว
public final void testModuleEnded ()
รายงานการสิ้นสุดการรันโมดูล
ทดสอบโมดูลเริ่มต้นแล้ว
public final void testModuleStarted (IInvocationContext moduleContext)
รายงานจุดเริ่มต้นของโมดูลที่ทำงานอยู่ การเรียกกลับนี้เชื่อมโยงกับ testModuleEnded()
และเป็นทางเลือกในลำดับ มันถูกใช้เฉพาะในระหว่างการวิ่งที่ใช้โมดูล: ชุดนักวิ่ง
พารามิเตอร์ | |
---|---|
moduleContext | IInvocationContext : IInvocationContext ของโมดูล |
ทดสอบรันสิ้นสุดแล้ว
public final void testRunEnded (long elapsedTimeMillis,runMetrics)
รายงานการสิ้นสุดการทดสอบการทำงาน การแก้ไข: เราไม่สามารถมีอินเทอร์เฟซ Map<> สองอินเทอร์เฟซที่มีประเภทต่างกันได้ ดังนั้นเราจึงต้องใช้ HashMap ที่นี่
พารามิเตอร์ | |
---|---|
elapsedTimeMillis | long : อุปกรณ์รายงานเวลาที่ผ่านไป หน่วยเป็นมิลลิวินาที |
runMetrics | Metric |
testRunFailed
public final void testRunFailed (FailureDescription failure)
รายงานการทดสอบการทำงานล้มเหลวที่จะเสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription
พารามิเตอร์ | |
---|---|
failure | FailureDescription : FailureDescription ที่อธิบายความล้มเหลวและบริบทของมัน |
testRunFailed
public final void testRunFailed (String errorMessage)
รายงานการดำเนินการทดสอบล้มเหลวเนื่องจากข้อผิดพลาดร้ายแรง
พารามิเตอร์ | |
---|---|
errorMessage | String : String ที่อธิบายสาเหตุของความล้มเหลวในการรัน |
ทดสอบ RunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
รายงานการเริ่มต้นการทดสอบการทำงาน
พารามิเตอร์ | |
---|---|
runName | String : ชื่อการทดสอบการทำงาน |
testCount | int : จำนวนการทดสอบทั้งหมดในการทดสอบ |
attemptNumber | int : หมายเลขคำสั่งซื้อ ระบุความพยายามที่แตกต่างกันของ runName เดียวกันที่ทำงานหลายครั้ง tryNumber ได้รับการจัดทำดัชนีเป็น 0 และควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น การทดสอบมีการลองซ้ำแบบละเอียด 3 ครั้ง โดยควรมีการทดสอบทั้งหมด 4 ครั้งภายใต้ชื่อ runName เดียวกัน และหมายเลขความพยายามคือตั้งแต่ 0 ถึง 3 |
ทดสอบ RunStarted
public final void testRunStarted (String runName, int testCount)
รายงานการเริ่มต้นการทดสอบการทำงาน
พารามิเตอร์ | |
---|---|
runName | String : ชื่อการทดสอบการทำงาน |
testCount | int : จำนวนการทดสอบทั้งหมดในการทดสอบ |
ทดสอบ RunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
รายงานการเริ่มต้นการทดสอบการทำงาน
พารามิเตอร์ | |
---|---|
runName | String : ชื่อการทดสอบการทำงาน |
testCount | int : จำนวนการทดสอบทั้งหมดในการทดสอบ |
attemptNumber | int : หมายเลขคำสั่งซื้อ ระบุความพยายามที่แตกต่างกันของ runName เดียวกันที่ทำงานหลายครั้ง tryNumber ได้รับการจัดทำดัชนีเป็น 0 และควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น การทดสอบมีการลองซ้ำแบบละเอียด 3 ครั้ง โดยควรมีการทดสอบทั้งหมด 4 ครั้งภายใต้ชื่อ runName เดียวกัน และหมายเลขความพยายามคือตั้งแต่ 0 ถึง 3 |
startTime | long : เวลาที่รันเริ่มต้น วัดผ่าน System.currentTimeMillis() |
ทดสอบข้าม
public final void testSkipped (TestDescription test, SkipReason reason)
เรียกว่าเมื่อข้ามการทดสอบและไม่ได้ดำเนินการด้วยเหตุผลที่ปกติไม่คาดหมาย การทดสอบเหล่านี้จะพยายามทำซ้ำเพื่อให้ได้รับการดำเนินการที่เหมาะสม
พารามิเตอร์ | |
---|---|
test | TestDescription : ระบุการทดสอบ |
reason | SkipReason : SkipReason |
ทดสอบเริ่มต้นแล้ว
public final void testStarted (TestDescription test, long startTime)
ทางเลือกอื่นแทน testStarted(com.android.tradefed.result.TestDescription)
ซึ่งเรายังระบุด้วยว่าการทดสอบเริ่มต้นเมื่อใด รวมกับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
เพื่อการวัดที่แม่นยำ .
พารามิเตอร์ | |
---|---|
test | TestDescription : ระบุการทดสอบ |
startTime | long : เวลาที่เริ่มการทดสอบ วัดผ่าน System.currentTimeMillis() |
ทดสอบเริ่มต้นแล้ว
public final void testStarted (TestDescription test)
รายงานการเริ่มต้นของกรณีทดสอบแต่ละรายการ อินเทอร์เฟซรุ่นเก่า ควรใช้ testStarted(com.android.tradefed.result.TestDescription)
ทุกครั้งที่เป็นไปได้
พารามิเตอร์ | |
---|---|
test | TestDescription : ระบุการทดสอบ |
วิธีการที่ได้รับการป้องกัน
createModuleChildReference
protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)
สร้างการอ้างอิงลูกสำหรับโมดูล
พารามิเตอร์ | |
---|---|
record | TestRecordProto.TestRecord |
การส่งคืน | |
---|---|
TestRecordProto.ChildReference |