LogSaverResultForwarder

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

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

Các lớp con trực tiếp đã biết RetryLogSaverResultForwarder RetryLogSaverResultForwarder Người giao nhận cũng xử lý việc vượt qua nỗ lực hiện tại mà chúng tôi đang thực hiện.

---

Một ResultForwarder để lưu nhật ký bằng trình tiết kiệm tệp chung.

Bản tóm tắt

Các nhà xây dựng công cộng
LogSaverResultForwarder ( ILogSaver logSaver, listeners) LogSaverResultForwarder ( ILogSaver logSaver, listeners)

Phương pháp công khai
void	invocationEnded (long elapsedTime) Báo cáo rằng lệnh gọi đã kết thúc, cho dù thành công hay do một số điều kiện lỗi.
void	invocationStarted ( IInvocationContext context) Báo cáo thời điểm bắt đầu gọi kiểm tra.
void	logAssociation (String dataName, LogFile logFile) Trong một số trường hợp, nhật ký phải được liên kết chặt chẽ với các trường hợp thử nghiệm, nhưng cơ hội để làm như vậy trên testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Không thể gọi lại 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) Ghi lại một tập tin cuối cùng trước khi hoàn thành
static void	reportEndHostLog ( listeners, ILogSaver saver, String name) reportEndHostLog ( listeners, ILogSaver saver, String name) Báo cáo host_log từ phiên đang diễn ra.
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Cung cấp nhật ký liên quan hoặc dữ liệu gỡ lỗi từ lệnh gọi kiểm tra. Ngoài ra, lưu tệp nhật ký với ILogSaver toàn cầu và gọi ILogSaverListener#testLogSaved(String, LogDataType, InputStreamSource, LogFile) cho những người nghe triển khai giao diện ILogSaverListener .
void	testLogForward (String dataName, LogDataType dataType, InputStreamSource dataStream) Chỉ chuyển tiếp testLog thay vì lưu nhật ký trước.
void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) Được gọi khi nhật ký kiểm tra được lưu. Nếu LogSaverResultForwarder được bao bọc trong một cái khác, hãy đảm bảo rằng chúng tôi chuyển tiếp lệnh gọi lại testLogSaved tới người nghe bên dưới nó.

Các nhà xây dựng công cộng

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners)

Thông số
logSaver	ILogSaver
listeners

Phương pháp công khai

sự mời gọi

public void invocationEnded (long elapsedTime)

Báo cáo rằng lệnh gọi đã kết thúc, cho dù thành công hay do một số điều kiện lỗi.

Sẽ được tự động gọi bởi khuôn khổ TradeFederation.

Thông số
elapsedTime	long : thời gian đã trôi qua của lời gọi tính bằng mili giây

invocationStarted

public void invocationStarted (IInvocationContext context)

Báo cáo thời điểm bắt đầu gọi kiểm tra.

Sẽ được tự động gọi bởi khuôn khổ TradeFederation. Các phóng viên cần ghi đè phương pháp này để hỗ trợ báo cáo trên nhiều thiết bị.

Thông số
context	IInvocationContext : thông tin về lời gọi

nhật ký

public void logAssociation (String dataName, 
                LogFile logFile)

Trong một số trường hợp, nhật ký phải được liên kết chặt chẽ với các trường hợp thử nghiệm, nhưng cơ hội để làm như vậy trên testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Không thể gọi lại testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) . Do đó, lệnh gọi lại này cho phép cung cấp một liên kết mạnh một cách rõ ràng.

Thông số
dataName	String : Tên của dữ liệu
logFile	LogFile : LogFile đã được ghi trước đó và phải được liên kết với trường hợp thử nghiệm.

logFile

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

Ghi lại một tập tin cuối cùng trước khi hoàn thành

Thông số
listeners
saver	ILogSaver
source	InputStreamSource
name	String
type	LogDataType

reportEndHostLog

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

Báo cáo host_log từ phiên đang diễn ra.

Thông số
listeners
saver	ILogSaver
name	String

testLog

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

Cung cấp nhật ký liên quan hoặc dữ liệu gỡ lỗi từ lệnh gọi kiểm tra.

Phải được gọi trước ERROR(/ITestInvocationListener#invocationFailed(Throwable)) hoặc ERROR(/ITestInvocationListener#invocationEnded(long))

Khuôn khổ TradeFederation sẽ tự động gọi phương thức này, cung cấp nhật ký máy chủ và nếu có, nhật ký thiết bị.

Ngoài ra, lưu tệp nhật ký với ILogSaver toàn cầu và gọi ILogSaverListener#testLogSaved(String, LogDataType, InputStreamSource, LogFile) cho những người nghe triển khai giao diện ILogSaverListener .

Thông số
dataName	String : tên mô tả String của dữ liệu. ví dụ: "device_logcat". Lưu ý dataName có thể không phải là duy nhất cho mỗi lần gọi. tức là người triển khai phải có khả năng xử lý nhiều cuộc gọi với cùng một dataName
dataType	LogDataType : LogDataType của dữ liệu
dataStream	InputStreamSource : InputStreamSource của dữ liệu. Người triển khai nên gọi createInputStream để bắt đầu đọc dữ liệu và đảm bảo đóng InputStream kết quả khi hoàn tất. Người gọi phải đảm bảo nguồn dữ liệu vẫn tồn tại và có thể truy cập được cho đến khi phương thức testLog hoàn tất.

testLogForward

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

Chỉ chuyển tiếp testLog thay vì lưu nhật ký trước.

Thông số
dataName	String
dataType	LogDataType
dataStream	InputStreamSource

testLogSaved

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

Được gọi khi nhật ký kiểm tra được lưu.

Nên được sử dụng thay cho ITestInvocationListener#testLog(String, LogDataType, InputStreamSource) .

Nếu LogSaverResultForwarder được bao bọc trong một cái khác, hãy đảm bảo rằng chúng tôi chuyển tiếp lệnh gọi lại testLogSaved tới người nghe bên dưới nó.

Thông số
dataName	String : tên mô tả String của dữ liệu. ví dụ: "device_logcat". Lưu ý dataName có thể không phải là duy nhất cho mỗi lần gọi. tức là người triển khai phải có khả năng xử lý nhiều cuộc gọi với cùng một dataName
dataType	LogDataType : LogDataType của dữ liệu
dataStream	InputStreamSource : InputStreamSource của dữ liệu. Người triển khai nên gọi createInputStream để bắt đầu đọc dữ liệu và đảm bảo đóng InputStream kết quả khi hoàn tất.
logFile	LogFile : LogFile chứa dữ liệu meta của tệp đã lưu.