ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

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

---

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

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

สรุป

เครื่องมือสร้างสาธารณะ
ShardMainResultForwarder(List<ITestInvocationListener> listeners, int expectedShards) สร้าง ShardMainResultForwarder

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

เครื่องมือสร้างสาธารณะ

ShardMainResultForwarder

public ShardMainResultForwarder (List<ITestInvocationListener> listeners, 
                int expectedShards)

สร้าง ShardMainResultForwarder

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

เมธอดสาธารณะ

getListeners

public List<ITestInvocationListener> getListeners ()

รับรายการ Listener

การคืนสินค้า
List<ITestInvocationListener>	รายการ ITestInvocationListener

invocationEnded

public void invocationEnded (long elapsedTime)

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

เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ

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

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

การเรียกกลับที่มีรายละเอียดมากขึ้นเพื่อแยกความแตกต่างของส่วนที่เสร็จสมบูรณ์

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

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 logFile)

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

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

testLogForward

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

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

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

testLogSaved

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

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

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

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