ผู้ส่งชาร์ดหลักผลลัพธ์

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.invoker.ShardMainResultForwarder

---

ResultForwarder ที่รวมผลลัพธ์ของการเรียกใช้การทดสอบแบบชาร์ด เท่านั้น จะรายงานการเรียกไปยัง Listener เมื่อการเรียกที่มีการชาร์ดทั้งหมดเสร็จสมบูรณ์

ชั้นเรียนนี้ไม่ปลอดภัยกับชุดข้อความ คาดว่าไคลเอ็นต์จะล็อกชั้นเรียนนี้เมื่อ การส่งผลการทดสอบ เพื่อป้องกันไม่ให้มีการเรียก Callback ที่เรียกใช้อย่างเป็นระเบียบ

สรุป

ช่างก่อสร้างสาธารณะ
ShardMainResultForwarder( listeners, int expectedShards) สร้าง ShardMainResultForwarder

วิธีการสาธารณะ
	getListeners() เรียกดูรายชื่อผู้ฟัง
void	invocationEnded(long elapsedTime) รายงานว่าคำขอสิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือเนื่องจากข้อผิดพลาดบางอย่าง
void	invocationEnded(long elapsedTime, IInvocationContext context) Callback ที่ละเอียดมากขึ้นเพื่อแยกแยะชาร์ดที่เสร็จแล้ว
void	invocationFailed(FailureDescription failure) รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากมีเงื่อนไขข้อผิดพลาดบางอย่าง
void	invocationFailed(Throwable cause) รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากมีเงื่อนไขข้อผิดพลาดบางอย่าง
void	invocationSkipped(SkipReason reason) รายงานการเรียกใช้ว่าข้าม
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) โดยตรง Callback ไม่ได้
void	testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream) ส่งต่อเฉพาะ testLog แทนที่จะบันทึกก่อน
void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) มีการเรียกใช้เมื่อบันทึกบันทึกการทดสอบ

ช่างก่อสร้างสาธารณะ

ผู้ส่งชาร์ดหลักผลลัพธ์

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

สร้าง ShardMainResultForwarder

พารามิเตอร์
listeners	: รายการของ ITestInvocationListener ที่จะส่งต่อผลลัพธ์ให้เมื่อทั้งหมด ชาร์ดเสร็จสมบูรณ์แล้ว
expectedShards	int: จำนวนชาร์ด

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

getListener

public  getListeners ()

เรียกดูรายชื่อผู้ฟัง มีไว้สำหรับใช้โดยคลาสย่อยเท่านั้น

คิกรีเทิร์น
	รายการ ITestInvocationListener

สิ้นสุดการเรียกใช้

public void invocationEnded (long elapsedTime)

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

จะถูกเรียกโดยอัตโนมัติโดยเฟรมเวิร์ก TradeFederation

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

สิ้นสุดการเรียกใช้

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

Callback ที่ละเอียดมากขึ้นเพื่อแยกแยะชาร์ดที่เสร็จแล้ว

พารามิเตอร์
elapsedTime	long
context	IInvocationContext

การเรียกใช้ล้มเหลว

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 void invocationStarted (IInvocationContext context)

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

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

พารามิเตอร์
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) โดยตรง Callback ไม่ได้ ดังนั้น Callback นี้จึงช่วยให้เกิดการเชื่อมโยงที่แข็งแกร่ง อย่างชัดเจน

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

ทดสอบบันทึกไปข้างหน้า

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

ส่งต่อเฉพาะ testLog แทนที่จะบันทึกก่อน

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

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

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

มีการเรียกใช้เมื่อบันทึกบันทึกการทดสอบ

ควรใช้แทน ITestInvocationListener#testLog(String, LogDataType, InputStreamSource)

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