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, IConfiguration config)
LogSaverResultForwarder(ILogSaver logSaver, listeners, IConfiguration config, boolean setLogSaver)

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

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) callbacks โดยตรงนั้นไม่สามารถทำได้

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

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

static void 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 ไปยัง Listeners ที่อยู่ภายใน

ตัวสร้างแบบสาธารณะ

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners, 
                IConfiguration config)

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

listeners

config IConfiguration

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners, 
                IConfiguration config, 
                boolean setLogSaver)

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

listeners

config IConfiguration

setLogSaver boolean

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

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

พารามิเตอร์
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

reportEndHostLog

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

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

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

saver ILogSaver

name String

testLog

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 อาจไม่ซ้ำกันต่อการเรียกใช้ 1 ครั้ง เช่น ผู้ติดตั้งใช้งานต้องจัดการกับการเรียกใช้หลายครั้งที่มี dataName เดียวกันได้
dataType LogDataType: LogDataType ของข้อมูล
dataStream InputStreamSource: InputStreamSource ของข้อมูล ผู้ใช้งานควรเรียกใช้ createInputStream เพื่อเริ่มอ่านข้อมูล และอย่าลืมปิด InputStream ที่ได้เมื่ออ่านเสร็จแล้ว ผู้เรียกใช้ควรตรวจสอบว่าแหล่งที่มาของข้อมูลยังคงอยู่และเข้าถึงได้จนกว่าเมธอด testLog จะเสร็จสมบูรณ์

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)

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

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