ResultReporter
public
class
ResultReporter
extends Object
implements
IConfigurationReceiver,
ILogSaverListener,
ISupportGranularResults,
ITestSummaryListener
| java.lang.Object | |
| ↳ | com.google.android.tradefed.result.teststorage.ResultReporter |
สรุป
คลาสเรียนที่ซ้อนกัน | |
|---|---|
class |
ResultReporter.ListBuilder<T>
|
ค่าคงที่ | |
|---|---|
String |
DEFAULT_BUILDPROVIDER
|
String |
EXPERIMENTAL
|
String |
SYSTEM_CHECKER
|
String |
TRADEFED
|
เครื่องมือสร้างสาธารณะ | |
|---|---|
ResultReporter()
|
|
เมธอดสาธารณะ | |
|---|---|
void
|
enableFilterProperty(boolean enableFilterProperty)
|
IConfiguration
|
getConfiguration()
|
TestSummary
|
getSummary()
อนุญาตให้ InvocationListener แสดงผลสรุป |
void
|
invocationEnded(long elapsedTime)
รายงานว่าการเรียกใช้สิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือเกิดจากข้อผิดพลาด บางอย่าง |
void
|
invocationFailed(FailureDescription failure)
รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง |
void
|
invocationFailed(Throwable cause)
รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง |
void
|
invocationSkipped(SkipReason reason)
รายงานการเรียกใช้ว่าข้ามไป |
void
|
invocationStarted(IInvocationContext context)
รายงานการเรียกใช้การทดสอบที่เริ่มต้น |
void
|
logAssociation(String dataName, LogFile log)
ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างแน่นแฟ้น แต่ไม่สามารถดำเนินการดังกล่าวใน |
void
|
putEarlySummary(
ส่ง |
void
|
setConfiguration(IConfiguration configuration)
แทรก |
void
|
setLogSaver(ILogSaver logSaver)
ตั้งค่า |
boolean
|
supportGranularResults()
แสดงค่า True หากผู้รายงานรองรับผลลัพธ์แบบละเอียด หรือแสดงค่า False หากไม่รองรับ |
void
|
testAssumptionFailure(TestDescription test, String trace)
เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ |
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ |
void
|
testEnded(TestDescription test, long endTime,
ทางเลือกแทน |
void
|
testEnded(TestDescription test,
รายงานจุดสิ้นสุดการดำเนินการของกรณีทดสอบแต่ละรายการ |
void
|
testFailed(TestDescription test, FailureDescription failure)
รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ |
void
|
testFailed(TestDescription test, String trace)
รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ |
void
|
testIgnored(TestDescription test)
เรียกใช้เมื่อจะไม่ทำการทดสอบ โดยทั่วไปเนื่องจากมีการใส่คำอธิบายประกอบเมธอดทดสอบด้วย org.junit.Ignore |
void
|
testModuleEnded()
รายงานการสิ้นสุดการเรียกใช้โมดูล |
void
|
testModuleStarted(IInvocationContext moduleContext)
รายงานจุดเริ่มต้นของการเรียกใช้โมดูล |
void
|
testRunEnded(long elapsedTimeMillis,
รายงานเมื่อการทดสอบสิ้นสุด |
void
|
testRunFailed(FailureDescription failure)
การทดสอบรายงานไม่เสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย |
void
|
testRunFailed(String errorMessage)
การทดสอบการเรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง |
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
รายงานการเริ่มต้นการทดสอบ |
void
|
testRunStarted(String runName, int testCount)
รายงานการเริ่มต้นการทดสอบ |
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
รายงานการเริ่มต้นการทดสอบ |
void
|
testSkipped(TestDescription test, SkipReason reason)
เรียกใช้เมื่อข้ามการทดสอบและไม่ได้ดำเนินการด้วยเหตุผลที่มักไม่คาดคิด |
void
|
testStarted(TestDescription test, long startTime)
ทางเลือกแทน |
void
|
testStarted(TestDescription test)
รายงานจุดเริ่มต้นของกรณีทดสอบแต่ละรายการ |
วิธีการที่ได้รับการป้องกัน | |
|---|---|
ITestStorageClient
|
createTestStorageClient(IInvocationContext context)
|
String
|
getVersion()
|
ค่าคงที่
DEFAULT_BUILDPROVIDER
public static final String DEFAULT_BUILDPROVIDER
ค่าคงที่: "androidbuild"
ทดลอง
public static final String EXPERIMENTAL
ค่าคงที่ "experimental"
SYSTEM_CHECKER
public static final String SYSTEM_CHECKER
ค่าคงที่ "system_checker"
TRADEFED
public static final String TRADEFED
ค่าคงที่: "tradefed"
เครื่องมือสร้างสาธารณะ
ResultReporter
public ResultReporter ()
เมธอดสาธารณะ
enableFilterProperty
public void enableFilterProperty (boolean enableFilterProperty)
| พารามิเตอร์ | |
|---|---|
enableFilterProperty |
boolean |
getSummary
public TestSummary getSummary ()
อนุญาตให้ InvocationListener แสดงข้อมูลสรุป
| คิกรีเทิร์น | |
|---|---|
TestSummary |
TestSummary ที่สรุปการวิ่ง หรือ null |
invocationEnded
public void invocationEnded (long elapsedTime)
รายงานว่าการเรียกใช้สิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือเกิดจากข้อผิดพลาด บางอย่าง
เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ
| พารามิเตอร์ | |
|---|---|
elapsedTime |
long: เวลาที่ผ่านไปของการเรียกใช้ในหน่วยมิลลิวินาที |
invocationFailed
public void invocationFailed (FailureDescription failure)
รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ
| พารามิเตอร์ | |
|---|---|
failure |
FailureDescription: FailureDescription ที่อธิบายสาเหตุของการดำเนินการไม่สำเร็จ |
invocationFailed
public void invocationFailed (Throwable cause)
รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ
| พารามิเตอร์ | |
|---|---|
cause |
Throwable: สาเหตุที่ Throwable ไม่สำเร็จ |
invocationSkipped
public void invocationSkipped (SkipReason reason)
รายงานการเรียกใช้ว่าข้ามไป
| พารามิเตอร์ | |
|---|---|
reason |
SkipReason |
invocationStarted
public void invocationStarted (IInvocationContext context)
รายงานการเรียกใช้การทดสอบที่เริ่มต้น
เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ ผู้รายงานต้องลบล้าง เมธอดนี้เพื่อรองรับการรายงานจากอุปกรณ์หลายเครื่อง
| พารามิเตอร์ | |
|---|---|
context |
IInvocationContext: ข้อมูลเกี่ยวกับการเรียกใช้ |
logAssociation
public void logAssociation (String dataName,
LogFile log)ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างแน่นแฟ้น แต่ไม่สามารถดำเนินการดังกล่าวในtestLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
การเรียกกลับโดยตรงได้ ดังนั้น Callback นี้จึงช่วยให้คุณเชื่อมโยงได้อย่างชัดเจน
| พารามิเตอร์ | |
|---|---|
dataName |
String: ชื่อของข้อมูล |
log |
LogFile: LogFile ที่บันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับ
กรณีทดสอบ |
putEarlySummary
public void putEarlySummary (summaries)
ส่ง ERROR(/List) ของ TestSummary ที่ไม่ใช่ค่าว่าง ซึ่งอาจส่งคืนจาก ITestInvocationListener ใดๆ ที่สร้างขึ้นเป็นส่วนหนึ่งของการกำหนดค่า ระบบจะสร้างข้อมูลสรุปเบื้องต้นหลังจาก ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) และจะสร้างข้อมูลสรุปที่สมบูรณ์ได้เมื่อสิ้นสุดการเรียกใช้ผ่าน ERROR(/#putSummary(List))
โดยจะเรียกใช้ก่อน ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) และมีข้อมูลสรุปทั้งหมด
จาก Listener ที่กำหนดค่าไว้ก่อนหน้านี้
| พารามิเตอร์ | |
|---|---|
summaries |
: ERROR(/List) ของ TestSummary ที่ไม่ใช่ค่าว่างจาก ITestInvocationListener ที่เป็นส่วนหนึ่งของการกำหนดค่าปัจจุบัน |
setConfiguration
public void setConfiguration (IConfiguration configuration)
แทรก IConfiguration ที่ใช้งานอยู่
| พารามิเตอร์ | |
|---|---|
configuration |
IConfiguration |
setLogSaver
public void setLogSaver (ILogSaver logSaver)
ตั้งค่า ILogSaver เพื่ออนุญาตให้ผู้ใช้บันทึกไฟล์
| พารามิเตอร์ | |
|---|---|
logSaver |
ILogSaver: ILogSaver |
supportGranularResults
public boolean supportGranularResults ()
แสดงค่า True หากผู้รายงานรองรับผลลัพธ์แบบละเอียด หรือแสดงค่า False หากไม่รองรับ
| คิกรีเทิร์น | |
|---|---|
boolean |
|
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
trace |
String: สแต็กเทรซของความล้มเหลว |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
failure |
FailureDescription: FailureDescription อธิบายความล้มเหลวและบริบทของความล้มเหลวนั้น |
testEnded
public 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) ของเมตริกที่ปล่อยออกมา |
testEnded
public void testEnded (TestDescription test,metrics)
รายงานจุดสิ้นสุดการดำเนินการของกรณีทดสอบแต่ละรายการ
หากไม่ได้เรียกใช้ testFailed(TestDescription, FailureDescription) การทดสอบนี้จะผ่าน นอกจากนี้ยังแสดงผลเมตริกคีย์/ค่า
ที่อาจมีการปล่อยออกมาในระหว่างการดำเนินการกรณีทดสอบด้วย
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
metrics |
: ERROR(/Map) ของเมตริกที่ปล่อยออกมา |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
จะเรียกใช้ระหว่าง testStarted และ testEnded
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
failure |
FailureDescription: FailureDescription อธิบายความล้มเหลวและบริบทของความล้มเหลวนั้น |
testFailed
public void testFailed (TestDescription test, String trace)
รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
จะเรียกใช้ระหว่าง testStarted และ testEnded
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
trace |
String: สแต็กเทรซของความล้มเหลว |
testIgnored
public void testIgnored (TestDescription test)
เรียกใช้เมื่อจะไม่ทำการทดสอบ โดยทั่วไปเนื่องจากมีการใส่คำอธิบายประกอบเมธอดทดสอบด้วย org.junit.Ignore
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
testModuleEnded
public void testModuleEnded ()
รายงานการสิ้นสุดการเรียกใช้โมดูล
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
รายงานจุดเริ่มต้นของการเรียกใช้โมดูล โดยการเรียกกลับนี้เชื่อมโยงกับ testModuleEnded() และเป็นแบบไม่บังคับในลำดับ โดยจะใช้เฉพาะในระหว่างการเรียกใช้ที่ใช้โมดูล
ซึ่งเป็นโปรแกรมเรียกใช้ตามชุดทดสอบ
| พารามิเตอร์ | |
|---|---|
moduleContext |
IInvocationContext: IInvocationContext ของโมดูล |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,
runMetrics) รายงานเมื่อการทดสอบสิ้นสุด
| พารามิเตอร์ | |
|---|---|
elapsedTimeMillis |
long: อุปกรณ์รายงานเวลาที่ผ่านไปเป็นมิลลิวินาที |
runMetrics |
: คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบ |
testRunFailed
public void testRunFailed (FailureDescription failure)
การทดสอบรายงานไม่เสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription
| พารามิเตอร์ | |
|---|---|
failure |
FailureDescription: FailureDescription อธิบายความล้มเหลวและบริบทของความล้มเหลวนั้น |
testRunFailed
public void testRunFailed (String errorMessage)
การทดสอบการเรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง
| พารามิเตอร์ | |
|---|---|
errorMessage |
String: String อธิบายเหตุผลที่การเรียกใช้ล้มเหลว |
testRunStarted
public void testRunStarted (String runName,
int testCount,
int attemptNumber)รายงานการเริ่มต้นการทดสอบ
| พารามิเตอร์ | |
|---|---|
runName |
String: ชื่อการทดสอบ |
testCount |
int: จำนวนการทดสอบทั้งหมดในการทดสอบการเรียกใช้ |
attemptNumber |
int: หมายเลขคำสั่งซื้อ ซึ่งระบุความพยายามต่างๆ ของ runName เดียวกัน
ที่เรียกใช้หลายครั้ง attemptNumber มีดัชนีเป็น 0 และควรเพิ่มขึ้นทุกครั้ง
ที่มีการเรียกใช้ใหม่ เช่น หากมีการลองใหม่แบบละเอียด 3 ครั้ง การทดสอบควรมีการเรียกใช้ทั้งหมด 4 ครั้ง
ภายใต้ runName เดียวกัน และ attemptNumber จะมีค่าตั้งแต่ 0 ถึง 3 |
testRunStarted
public void testRunStarted (String runName,
int testCount)รายงานการเริ่มต้นการทดสอบ
| พารามิเตอร์ | |
|---|---|
runName |
String: ชื่อการทดสอบ |
testCount |
int: จำนวนการทดสอบทั้งหมดในการทดสอบการเรียกใช้ |
testRunStarted
public void testRunStarted (String runName,
int testCount,
int attemptNumber,
long startTime)รายงานการเริ่มต้นการทดสอบ
| พารามิเตอร์ | |
|---|---|
runName |
String: ชื่อการทดสอบ |
testCount |
int: จำนวนการทดสอบทั้งหมดในการทดสอบการเรียกใช้ |
attemptNumber |
int: หมายเลขคำสั่งซื้อ ซึ่งระบุความพยายามต่างๆ ของ runName เดียวกัน
ที่เรียกใช้หลายครั้ง attemptNumber มีดัชนีเป็น 0 และควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น หากมีการลองใหม่แบบละเอียด 3 ครั้ง ควรมีการเรียกใช้ทั้งหมด 4 ครั้งภายใต้ runName เดียวกัน และ attemptNumber จะมีค่าตั้งแต่ 0 ถึง 3 |
startTime |
long: เวลาที่เริ่มวิ่ง ซึ่งวัดผ่าน System.currentTimeMillis() |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
เรียกใช้เมื่อข้ามการทดสอบและไม่ได้ดำเนินการด้วยเหตุผลที่มักไม่คาดคิด ระบบจะพยายามลองทดสอบเหล่านี้อีกครั้งเพื่อให้ดำเนินการได้อย่างถูกต้อง
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
reason |
SkipReason: SkipReason |
testStarted
public 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() |
testStarted
public void testStarted (TestDescription test)
รายงานจุดเริ่มต้นของกรณีทดสอบแต่ละรายการ อินเทอร์เฟซรุ่นเก่าควรใช้ testStarted(com.android.tradefed.result.TestDescription) เมื่อเป็นไปได้
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
วิธีการที่ได้รับการป้องกัน
createTestStorageClient
protected ITestStorageClient createTestStorageClient (IInvocationContext context)
| พารามิเตอร์ | |
|---|---|
context |
IInvocationContext |
| คิกรีเทิร์น | |
|---|---|
ITestStorageClient |
|
getVersion
protected String getVersion ()
| คิกรีเทิร์น | |
|---|---|
String |
|