IMetricCollector
public
interface
IMetricCollector
implements
IDisableable,
ILogSaverListener
| com.android.tradefed.device.metric.IMetricCollector |
เราจะเพิ่มอินเทอร์เฟซนี้เป็น Decorator เมื่อรายงานผลการทดสอบเพื่อรวบรวม เมตริกที่ตรงกัน
ใช้อินเทอร์เฟซนี้เป็น ITestInvocationListener ก็ตาม การตรวจสอบการกำหนดค่าจะปฏิเสธ ต้องใช้เป็น
"metrics_collector"
ไม่ควรให้ Collector เก็บสถานะภายในไว้เนื่องจากอาจมีการนำไปใช้ซ้ำในหลาย
ที่ หากจำเป็นต้องใช้สถานะภายในจริงๆ ก็ควรล้างสถานะดังกล่าวใน init(IInvocationContext,ITestInvocationListener)
สรุป
เมธอดสาธารณะ | |
|---|---|
default
boolean
|
captureModuleLevel()
ไม่ว่าตัวรวบรวมจะใช้ได้กับการจับภาพระดับโมดูลและควรเริ่มต้นหรือไม่ |
default
boolean
|
doesModuleContainFailure()
แสดงค่าเป็นจริงหากโมดูลปัจจุบันมีกรณีทดสอบหรือการทดสอบที่ล้มเหลว |
default
void
|
enableDefaultMetricCollection()
อนุญาตให้ผู้รวบรวมเปิดใช้การรวบรวมเมตริกเริ่มต้น |
default
IMetricCollector.MetricCollectionLevel
|
getAlwaysOnCollectionLevel()
|
abstract
List<IBuildInfo>
|
getBuildInfos()
แสดงผลรายการข้อมูลบิลด์ที่มีอยู่ในการเรียกใช้ |
abstract
List<ITestDevice>
|
getDevices()
แสดงผลรายการอุปกรณ์ที่พร้อมใช้งานในการเรียกใช้ |
abstract
ITestInvocationListener
|
getInvocationListener()
แสดง |
default
IMetricCollector.MetricCollectionLevel
|
getOnFailureCollectionLevel()
|
abstract
ITestInvocationListener
|
init(IInvocationContext context, ITestInvocationListener listener)
การเริ่มต้นของตัวรวบรวมที่มีบริบทปัจจุบันและตำแหน่งที่จะส่งต่อผลลัพธ์ |
default
boolean
|
isDefaultMetricCollectionEnabled()
ไม่ว่าตัวรวบรวมจะรวบรวมเมตริกเป็นส่วนหนึ่งของการรวบรวมเมตริกเริ่มต้นหรือไม่ |
abstract
void
|
onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)
การเรียกกลับเมื่อกรณีทดสอบล้มเหลวเนื่องจากสมมติฐานไม่ถูกต้อง |
abstract
void
|
onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)
การเรียกกลับเมื่อเคสทดสอบสิ้นสุด |
abstract
void
|
onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)
การเรียกกลับเมื่อเคสทดสอบสิ้นสุด |
abstract
void
|
onTestFail(DeviceMetricData testData, TestDescription test)
การเรียกกลับเมื่อกรอบการทดสอบล้มเหลว |
default
void
|
onTestModuleEnded()
อนุญาตให้บันทึกเหตุการณ์เมื่อโมดูลสิ้นสุด |
default
void
|
onTestModuleStarted()
อนุญาตให้บันทึกเหตุการณ์ที่โมดูลเริ่มต้น |
abstract
void
|
onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)
การเรียกกลับเมื่อการทดสอบสิ้นสุดลง |
abstract
void
|
onTestRunStart(DeviceMetricData runData)
การเรียกกลับเมื่อเริ่มการทดสอบ |
default
void
|
onTestRunStart(DeviceMetricData runData, int testCount)
การเรียกกลับเมื่อเริ่มการทดสอบ |
default
void
|
onTestRunStartBlocking()
การเรียกกลับที่ชัดเจนเพื่อเริ่ม Collector ด้วยตนเองหากรองรับ |
abstract
void
|
onTestStart(DeviceMetricData testData)
การเรียกกลับเมื่อเริ่มกรณีทดสอบ |
default
void
|
setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)
กำหนดระดับที่ควรให้ตัวรวบรวมรวบรวมบันทึกโดยไม่คำนึงถึงความล้มเหลว |
default
void
|
setModuleContainsFailure()
ตั้งค่าว่าโมดูลมีความล้มเหลวหรือไม่ (กรณีทดสอบ การทดสอบ) |
default
void
|
setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)
กำหนดระดับที่ควรให้ตัวรวบรวมบันทึกรวบรวมบันทึกระหว่างที่เกิดข้อผิดพลาด |
เมธอดสาธารณะ
captureModuleLevel
public boolean captureModuleLevel ()
ไม่ว่าตัวรวบรวมจะใช้ได้กับการจับภาพระดับโมดูลและควรเริ่มต้นหรือไม่
| การคืนสินค้า | |
|---|---|
boolean |
|
doesModuleContainFailure
public boolean doesModuleContainFailure ()
แสดงค่าเป็นจริงหากโมดูลปัจจุบันมีกรณีทดสอบหรือการทดสอบที่ล้มเหลว
| การคืนสินค้า | |
|---|---|
boolean |
|
enableDefaultMetricCollection
public void enableDefaultMetricCollection ()
อนุญาตให้ผู้รวบรวมเปิดใช้การรวบรวมเมตริกเริ่มต้น เมื่อ เปิดใช้การรวบรวมเมตริกเริ่มต้นแล้ว ตัวรวบรวมควรเก็บรวบรวมที่ระดับการรวบรวมที่ระบุเท่านั้น
getAlwaysOnCollectionLevel
public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()
| การคืนสินค้า | |
|---|---|
IMetricCollector.MetricCollectionLevel |
|
getBuildInfos
public abstract List<IBuildInfo> getBuildInfos ()
แสดงผลรายการข้อมูลบิลด์ที่มีอยู่ในการเรียกใช้
| การคืนสินค้า | |
|---|---|
List<IBuildInfo> |
|
getDevices
public abstract List<ITestDevice> getDevices ()
แสดงผลรายการอุปกรณ์ที่พร้อมใช้งานในการเรียกใช้
| การคืนสินค้า | |
|---|---|
List<ITestDevice> |
|
getInvocationListener
public abstract ITestInvocationListener getInvocationListener ()
แสดง ITestInvocationListener เดิมที่เราส่งต่อผลลัพธ์
| การคืนสินค้า | |
|---|---|
ITestInvocationListener |
|
getOnFailureCollectionLevel
public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()
| การคืนสินค้า | |
|---|---|
IMetricCollector.MetricCollectionLevel |
|
init
public abstract ITestInvocationListener init (IInvocationContext context, ITestInvocationListener listener)
การเริ่มต้นของตัวรวบรวมที่มีบริบทปัจจุบันและตำแหน่งที่จะส่งต่อผลลัพธ์ จะเรียกใช้เพียงครั้งเดียวต่ออินสแตนซ์ และคาดว่า Collector จะอัปเดตบริบทภายใน และ Listener ระบบจะไม่เรียกใช้ Init ระหว่างการทดสอบ แต่จะเรียกใช้ก่อนเสมอ
อย่าลบล้างเว้นแต่คุณจะทราบว่ากำลังทำอะไรอยู่
| พารามิเตอร์ | |
|---|---|
context |
IInvocationContext: IInvocationContext สำหรับการเรียกใช้ที่กำลังดำเนินการ |
listener |
ITestInvocationListener: ITestInvocationListener ที่ใช้แสดงผลลัพธ์ |
| การคืนสินค้า | |
|---|---|
ITestInvocationListener |
Listener ใหม่ที่ครอบ Listener เดิม |
| ส่ง | |
|---|---|
DeviceNotAvailableException |
|
isDefaultMetricCollectionEnabled
public boolean isDefaultMetricCollectionEnabled ()
ไม่ว่าตัวรวบรวมจะรวบรวมเมตริกเป็นส่วนหนึ่งของการรวบรวมเมตริกเริ่มต้นหรือไม่
| การคืนสินค้า | |
|---|---|
boolean |
|
onTestAssumptionFailure
public abstract void onTestAssumptionFailure (DeviceMetricData testData, TestDescription test)
การเรียกกลับเมื่อกรณีทดสอบล้มเหลวเนื่องจากสมมติฐานไม่ถูกต้อง
| พารามิเตอร์ | |
|---|---|
testData |
DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรณีทดสอบ |
test |
TestDescription: TestDescription ของกรณีทดสอบที่กำลังดำเนินการ |
| ส่ง | |
|---|---|
DeviceNotAvailableException |
|
onTestEnd
public abstract void onTestEnd (DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)
การเรียกกลับเมื่อเคสทดสอบสิ้นสุด ตอนนี้เป็นเวลาที่ควรทำความสะอาด
| พารามิเตอร์ | |
|---|---|
testData |
DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรณีทดสอบ จะเป็นออบเจ็กต์เดียวกันกับในระหว่าง onTestStart(DeviceMetricData) |
currentTestCaseMetrics |
Map: แผนที่เมตริกปัจจุบันที่ส่งไปยัง testEnded(TestDescription,Map) |
test |
TestDescription: TestDescription ของกรณีทดสอบที่กำลังดำเนินการ |
| ส่ง | |
|---|---|
DeviceNotAvailableException |
|
onTestEnd
public abstract void onTestEnd (DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)
การเรียกกลับเมื่อเคสทดสอบสิ้นสุด ตอนนี้เป็นเวลาที่ควรทำความสะอาด
| พารามิเตอร์ | |
|---|---|
testData |
DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรณีทดสอบ จะเป็นออบเจ็กต์เดียวกันกับในระหว่าง onTestStart(DeviceMetricData) |
currentTestCaseMetrics |
Map: แผนที่เมตริกปัจจุบันที่ส่งไปยัง testEnded(TestDescription,Map) |
| ส่ง | |
|---|---|
DeviceNotAvailableException |
|
onTestFail
public abstract void onTestFail (DeviceMetricData testData, TestDescription test)
การเรียกกลับเมื่อกรอบการทดสอบล้มเหลว
| พารามิเตอร์ | |
|---|---|
testData |
DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรณีทดสอบ |
test |
TestDescription: TestDescription ของกรณีทดสอบที่กำลังดำเนินการ |
| ส่ง | |
|---|---|
DeviceNotAvailableException |
|
onTestModuleEnded
public void onTestModuleEnded ()
อนุญาตให้บันทึกเหตุการณ์เมื่อโมดูลสิ้นสุด
| ส่ง | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
onTestModuleStarted
public void onTestModuleStarted ()
อนุญาตให้บันทึกเหตุการณ์ที่โมดูลเริ่มต้น
| ส่ง | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
onTestRunEnd
public abstract void onTestRunEnd (DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)
การเรียกกลับเมื่อการทดสอบสิ้นสุดลง ตอนนี้เป็นเวลาที่ควรทำความสะอาด
| พารามิเตอร์ | |
|---|---|
runData |
DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสําหรับการเรียกใช้ จะเป็นออบเจ็กต์เดียวกันกับตอน onTestRunStart(DeviceMetricData) |
currentRunMetrics |
Map: แผนที่เมตริกปัจจุบันที่ส่งไปยัง testRunEnded(long,Map) |
| ส่ง | |
|---|---|
DeviceNotAvailableException |
|
onTestRunStart
public abstract void onTestRunStart (DeviceMetricData runData)
การเรียกกลับเมื่อเริ่มการทดสอบ
| พารามิเตอร์ | |
|---|---|
runData |
DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสําหรับการเรียกใช้ |
| ส่ง | |
|---|---|
DeviceNotAvailableException |
|
onTestRunStart
public void onTestRunStart (DeviceMetricData runData, int testCount)
การเรียกกลับเมื่อเริ่มการทดสอบ
| พารามิเตอร์ | |
|---|---|
runData |
DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสําหรับการเรียกใช้ |
testCount |
int: จำนวนกรณีทดสอบในการทดสอบนี้ |
| ส่ง | |
|---|---|
DeviceNotAvailableException |
|
onTestRunStartBlocking
public void onTestRunStartBlocking ()
การเรียกกลับที่ชัดเจนเพื่อเริ่ม Collector ด้วยตนเองหากรองรับ ซึ่งช่วยให้มั่นใจได้ว่าเรา จะอยู่นอกวงจรการทดสอบบางอย่างซึ่งเป็นแบบไม่พร้อมกัน
| ส่ง | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
onTestStart
public abstract void onTestStart (DeviceMetricData testData)
การเรียกกลับเมื่อเริ่มกรณีทดสอบ
| พารามิเตอร์ | |
|---|---|
testData |
DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรณีทดสอบ |
| ส่ง | |
|---|---|
DeviceNotAvailableException |
|
setAlwaysOnCollectionLevel
public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)
กำหนดระดับที่ควรให้ตัวรวบรวมรวบรวมบันทึกโดยไม่คำนึงถึงความล้มเหลว
ระดับ NULL จะส่งผลให้ไม่มีการรวบรวม
| พารามิเตอร์ | |
|---|---|
level |
IMetricCollector.MetricCollectionLevel: MetricCollectionLevel ที่จะรวบรวมบันทึก |
setModuleContainsFailure
public void setModuleContainsFailure ()
ตั้งค่าว่าโมดูลมีความล้มเหลวหรือไม่ (กรณีทดสอบ การทดสอบ)
setOnFailureCollectionLevel
public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)
กำหนดระดับที่ควรให้ตัวรวบรวมบันทึกรวบรวมบันทึกระหว่างที่เกิดข้อผิดพลาด
ระดับ NULL จะส่งผลให้ไม่มีการรวบรวม
| พารามิเตอร์ | |
|---|---|
level |
IMetricCollector.MetricCollectionLevel: MetricCollectionLevel ที่จะรวบรวมบันทึก |