หน้านี้ได้รับการแปลโดย Cloud Translation API

ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.invoker.ShardListener

ITestInvocationListener ที่รวบรวมผลลัพธ์จากส่วนแบ่งการร้องขอ (หรือที่เรียกว่าการแบ่งการร้องขอเพื่อเรียกใช้บนทรัพยากรหลายรายการพร้อมกัน) และส่งต่อไปยังผู้ฟังรายอื่น

สรุป

ผู้สร้างสาธารณะ
`ShardListener ( ITestInvocationListener main)` สร้าง `ShardListener`

วิธีการสาธารณะ
	`getUnderlyingResultReporter ()`
`void`	`invocationEnded (long elapsedTime)` รายงานว่าการร้องขอสิ้นสุดลง ไม่ว่าจะสำเร็จหรือเนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
`void`	`invocationFailed ( FailureDescription failure)` รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
`void`	`invocationFailed (Throwable cause)` รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
`void`	`invocationStarted ( IInvocationContext context)` รายงานการเริ่มต้นการเรียกทดสอบ
`void`	`logAssociation (String dataName, LogFile logFile)` ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างมาก แต่มีโอกาสที่จะทำเช่นนั้นใน `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` ไม่สามารถโทรกลับได้
`void`	`setSupportGranularResults (boolean enableGranularResults)`
`boolean`	`supportGranularResults ()` คืนค่า True หากผู้รายงานสนับสนุนผลลัพธ์แบบละเอียด มิฉะนั้นจะเป็นเท็จ
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` จัดเตรียมบันทึกที่เกี่ยวข้องหรือข้อมูลการดีบักจากการเรียกทดสอบ
`void`	`testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testModuleEnded ()` รายงานการสิ้นสุดของการรันโมดูล
`void`	`testModuleStarted ( IInvocationContext moduleContext)` รายงานการเริ่มต้นโมดูลที่กำลังทำงาน
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` รายงานการสิ้นสุดการทดสอบการทำงาน
`void`	`testRunFailed ( FailureDescription failure)` การรันการทดสอบรายงานล้มเหลวเนื่องจากความล้มเหลวที่อธิบายโดย `FailureDescription`
`void`	`testRunFailed (String failureMessage)` เรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง
`void`	`testRunStarted (String name, int numTests, int attemptNumber, long startTime)` รายงานการเริ่มต้นการทดสอบการทำงาน

ผู้สร้างสาธารณะ

ShardListener

public ShardListener (ITestInvocationListener main)

สร้าง ShardListener

พารามิเตอร์

พารามิเตอร์
`main`	`ITestInvocationListener` : `ITestInvocationListener` ควรส่งต่อผลลัพธ์ เพื่อป้องกันการชนกับ `ShardListener` อื่น ๆ ออบเจ็กต์นี้จะซิงโครไนซ์กับ `main` เมื่อส่งต่อผลลัพธ์ และผลลัพธ์จะถูกส่งเมื่อส่วนการร้องขอเสร็จสมบูรณ์เท่านั้น

main

ITestInvocationListener : ITestInvocationListener ควรส่งต่อผลลัพธ์ เพื่อป้องกันการชนกับ ShardListener อื่น ๆ ออบเจ็กต์นี้จะซิงโครไนซ์กับ main เมื่อส่งต่อผลลัพธ์ และผลลัพธ์จะถูกส่งเมื่อส่วนการร้องขอเสร็จสมบูรณ์เท่านั้น

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

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

ส่งคืน

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

public void invocationEnded (long elapsedTime)

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

จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation framework

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

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

public void invocationFailed (FailureDescription failure)

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

จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation framework

พารามิเตอร์
`failure`	`FailureDescription` : `FailureDescription` ที่อธิบายสาเหตุของความล้มเหลว

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

public void invocationFailed (Throwable cause)

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

จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation framework

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

เรียกใช้เริ่มต้น

public void invocationStarted (IInvocationContext context)

รายงานการเริ่มต้นการเรียกทดสอบ

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

พารามิเตอร์
`context`	`IInvocationContext` : ข้อมูลเกี่ยวกับการเรียกใช้

เข้าสู่ระบบสมาคม

public void logAssociation (String dataName, 
                LogFile logFile)

ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างมาก แต่มีโอกาสที่จะทำเช่นนั้นใน testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ไม่สามารถโทรกลับได้ ดังนั้น การเรียกกลับนี้ช่วยให้สามารถเชื่อมโยงอย่างชัดเจนได้

พารามิเตอร์
`dataName`	`String` : ชื่อของข้อมูล
`logFile`	`LogFile` : `LogFile` ที่ถูกบันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับกรณีทดสอบ

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

พารามิเตอร์
`enableGranularResults`	`boolean`

สนับสนุน GranularResults

public boolean supportGranularResults ()

คืนค่า True หากผู้รายงานสนับสนุนผลลัพธ์แบบละเอียด มิฉะนั้นจะเป็นเท็จ

ส่งคืน
`boolean`

บันทึกการทดสอบ

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

จัดเตรียมบันทึกที่เกี่ยวข้องหรือข้อมูลการดีบักจากการเรียกทดสอบ

ต้องเรียกก่อน ERROR(/ITestInvocationListener#invocationFailed(Throwable)) หรือ ERROR(/ITestInvocationListener#invocationEnded(long))

กรอบงาน TradeFederation จะเรียกใช้เมธอดนี้โดยอัตโนมัติ โดยจัดเตรียมบันทึกโฮสต์และบันทึกอุปกรณ์ (ถ้ามี)

พารามิเตอร์
`dataName`	`String` : ชื่ออธิบาย `ERROR(/String)` ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการเรียกใช้ คือผู้ดำเนินการต้องสามารถจัดการการโทรหลายรายการด้วย dataName เดียวกันได้
`dataType`	`LogDataType` : `LogDataType` ของข้อมูล
`dataStream`	`InputStreamSource` : `InputStreamSource` ของข้อมูล Implementers ควรเรียก createInputStream เพื่อเริ่มอ่านข้อมูล และตรวจสอบให้แน่ใจว่าได้ปิด InputStream ที่เป็นผลลัพธ์เมื่อเสร็จสิ้น ผู้โทรควรตรวจสอบให้แน่ใจว่าแหล่งที่มาของข้อมูลยังคงอยู่และสามารถเข้าถึงได้จนกว่าวิธีการ testLog จะเสร็จสมบูรณ์

บันทึกการทดสอบที่บันทึกไว้

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

พารามิเตอร์
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

ทดสอบโมดูลสิ้นสุดแล้ว

public void testModuleEnded ()

รายงานการสิ้นสุดของการรันโมดูล

ทดสอบโมดูลเริ่มต้นแล้ว

public void testModuleStarted (IInvocationContext moduleContext)

รายงานการเริ่มต้นโมดูลที่กำลังทำงาน การเรียกกลับนี้เชื่อมโยงกับ testModuleEnded() และเป็นทางเลือกในลำดับ ใช้เฉพาะระหว่างการวิ่งที่ใช้โมดูล: นักวิ่งตามชุด

พารามิเตอร์
`moduleContext`	`IInvocationContext` : `IInvocationContext` ของโมดูล

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

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

พารามิเตอร์
`elapsedTime`	`long` : อุปกรณ์รายงานเวลาที่ผ่านไป หน่วยเป็นมิลลิวินาที
`runMetrics`	: คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบการทำงานด้วย `Metric`

การทดสอบรันล้มเหลว

public void testRunFailed (FailureDescription failure)

การรันการทดสอบรายงานล้มเหลวเนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription

พารามิเตอร์
`failure`	`FailureDescription` : `FailureDescription` อธิบายความล้มเหลวและบริบท

การทดสอบรันล้มเหลว

public void testRunFailed (String failureMessage)

เรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง

พารามิเตอร์
`failureMessage`	`String` : `ERROR(/String)` อธิบายสาเหตุของความล้มเหลวในการรัน

ทดสอบ RunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

รายงานการเริ่มต้นการทดสอบการทำงาน

พารามิเตอร์
`name`	`String` : ชื่อการทดสอบการทำงาน
`numTests`	`int` : จำนวนการทดสอบทั้งหมดในการทดสอบการทำงาน
`attemptNumber`	`int` : หมายเลขคำสั่งซื้อ ระบุความพยายามที่แตกต่างกันของ runName เดียวกันที่เรียกใช้หลายครั้ง จำนวนความพยายามเป็น 0 จัดทำดัชนีและควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น การทดสอบมีการลองใหม่แบบละเอียด 3 ครั้ง ควรมีการรันทั้งหมด 4 ครั้งภายใต้ชื่อรันเดียวกัน และหมายเลขความพยายามคือตั้งแต่ 0 ถึง 3
`startTime`	`long` : เวลาที่รันเริ่มต้น โดยวัดจาก `ERROR(/System#currentTimeMillis())`