LogSaverResultForwarder

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
com.android.tradefed.result.ResultForwarder
com.android.tradefed.result.LogSaverResultForwarder


ResultForwarder สำหรับการบันทึกบันทึกด้วยโปรแกรมรักษาไฟล์ทั่วโลก

สรุป

ผู้รับเหมาก่อสร้างสาธารณะ

LogSaverResultForwarder ( ILogSaver logSaver, listeners) LogSaverResultForwarder ( ILogSaver logSaver, listeners)

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

void invocationEnded (long elapsedTime)

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

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) โดยตรง testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ไม่สามารถโทรกลับได้

static void logFile ( listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type) logFile ( listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type)

บันทึกไฟล์สุดท้ายก่อนที่จะเสร็จสิ้น

static void reportEndHostLog ( listeners, ILogSaver saver, String name) reportEndHostLog ( listeners, ILogSaver saver, String name)

รายงาน host_log จากเซสชันที่กำลังดำเนินอยู่

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

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

นอกจากนี้ ให้บันทึกไฟล์บันทึกด้วย ILogSaver ส่วนกลางและเรียก ILogSaverListener#testLogSaved(String, LogDataType, InputStreamSource, LogFile) สำหรับผู้ฟังที่ใช้อินเทอร์เฟซ ILogSaverListener

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

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

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

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

หาก LogSaverResultForwarder รวมเข้ากับอีกอันหนึ่ง ตรวจสอบให้แน่ใจว่าเราได้ส่งต่อการโทรกลับ testLogSaved ไปยัง Listener ที่อยู่ด้านล่าง

ผู้รับเหมาก่อสร้างสาธารณะ

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners)

พารามิเตอร์
logSaver ILogSaver

listeners

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

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

public void invocationEnded (long elapsedTime)

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

จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederation

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

การร้องขอเริ่มต้นแล้ว

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) โดยตรง testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ไม่สามารถโทรกลับได้ ดังนั้นการเรียกกลับนี้ช่วยให้สามารถระบุการเชื่อมโยงที่แน่นแฟ้นได้อย่างชัดเจน

พารามิเตอร์
dataName String : ชื่อของข้อมูล

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

logFile

public static void logFile ( listeners, 
                ILogSaver saver, 
                InputStreamSource source, 
                String name, 
                LogDataType type)

บันทึกไฟล์สุดท้ายก่อนที่จะเสร็จสิ้น

พารามิเตอร์
listeners

saver ILogSaver

source InputStreamSource

name String

type LogDataType

รายงานEndHostLog

public static void reportEndHostLog ( listeners, 
                ILogSaver saver, 
                String name)

รายงาน host_log จากเซสชันที่กำลังดำเนินอยู่

พารามิเตอร์
listeners

saver ILogSaver

name String

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

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

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

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

กรอบงาน TradeFederation จะเรียกเมธอดนี้โดยอัตโนมัติ โดยจัดเตรียมบันทึกของโฮสต์และ logcat ของอุปกรณ์ หากมี

นอกจากนี้ ให้บันทึกไฟล์บันทึกด้วย ILogSaver ส่วนกลางและเรียก ILogSaverListener#testLogSaved(String, LogDataType, InputStreamSource, LogFile) สำหรับผู้ฟังที่ใช้อินเทอร์เฟซ ILogSaverListener

พารามิเตอร์
dataName String : ชื่อที่สื่อความหมาย String ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการร้องขอ นั่นคือผู้ดำเนินการจะต้องสามารถจัดการการโทรหลายครั้งด้วย dataName เดียวกัน

dataType LogDataType : LogDataType ของข้อมูล

dataStream InputStreamSource : InputStreamSource ของข้อมูล ผู้นำไปใช้งานควรเรียก createInputStream เพื่อเริ่มอ่านข้อมูล และตรวจสอบให้แน่ใจว่าได้ปิด InputStream ที่เป็นผลลัพธ์เมื่อเสร็จสิ้น ผู้โทรควรตรวจสอบให้แน่ใจว่าแหล่งที่มาของข้อมูลยังคงอยู่และสามารถเข้าถึงได้จนกว่าวิธี testLog จะเสร็จสิ้น

ทดสอบ LogForward

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

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

พารามิเตอร์
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogบันทึกไว้

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

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

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

หาก LogSaverResultForwarder รวมเข้ากับอีกอันหนึ่ง ตรวจสอบให้แน่ใจว่าเราได้ส่งต่อการโทรกลับ testLogSaved ไปยัง Listener ที่อยู่ด้านล่าง

พารามิเตอร์
dataName String : ชื่อที่สื่อความหมาย String ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการร้องขอ นั่นคือผู้ดำเนินการจะต้องสามารถจัดการการโทรหลายครั้งด้วย dataName เดียวกัน

dataType LogDataType : LogDataType ของข้อมูล

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

logFile LogFile : LogFile ที่มีข้อมูลเมตาของไฟล์ที่บันทึกไว้