لاگ سیور ریسل فورواردر

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

شیء جاوا
↳ com.android.tradefed.result.ResultForwarder
↳ com.android.tradefed.result.LogSaverResultForwarder

یک ResultForwarder برای ذخیره لاگ‌ها با استفاده از ذخیره‌کننده فایل سراسری.

خلاصه

سازندگان عمومی

LogSaverResultForwarder ( ILogSaver logSaver, List< ITestInvocationListener > listeners, IConfiguration config)
LogSaverResultForwarder ( ILogSaver logSaver, List< ITestInvocationListener > listeners, IConfiguration config, boolean setLogSaver)

روش‌های عمومی

void invocationEnded (long elapsedTime)

گزارش می‌دهد که فراخوانی، چه با موفقیت و چه به دلیل وجود برخی خطاها، خاتمه یافته است.

void invocationStarted ( IInvocationContext context)

شروع فراخوانی تست را گزارش می‌دهد.

void logAssociation (String dataName, LogFile logFile)

در برخی موارد، log باید به شدت با یک مورد آزمایشی مرتبط باشد، اما امکان انجام این کار در فراخوانی مستقیم testLogSaved(String,LogDataType,InputStreamSource,LogFile) امکان‌پذیر نیست.

static void logFile (List< ITestInvocationListener > listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type)

قبل از تکمیل، یک فایل نهایی را ثبت کنید

static void reportEndHostLog (List< ITestInvocationListener > 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 را به شنوندگان زیر آن ارسال می‌کنیم.

void testModuleEnded ()

پایان اجرای یک ماژول را گزارش می‌دهد.

void testModuleStarted ( IInvocationContext moduleContext)

شروع اجرای یک ماژول را گزارش می‌دهد.

سازندگان عمومی

لاگ سیور ریسل فورواردر 

public LogSaverResultForwarder (ILogSaver logSaver, 
                List<ITestInvocationListener> listeners, 
                IConfiguration config)

پارامترها
logSaver ILogSaver

listeners List

config IConfiguration

لاگ سیور ریسل فورواردر 

public LogSaverResultForwarder (ILogSaver logSaver, 
                List<ITestInvocationListener> listeners, 
                IConfiguration config, 
                boolean setLogSaver)

پارامترها
logSaver ILogSaver

listeners List

config IConfiguration

setLogSaver boolean

روش‌های عمومی

فراخوان پایان یافت 

public void invocationEnded (long elapsedTime)

گزارش می‌دهد که فراخوانی، چه با موفقیت و چه به دلیل وجود برخی خطاها، خاتمه یافته است.

به طور خودکار توسط چارچوب TradeFederation فراخوانی خواهد شد.

پارامترها
elapsedTime long : زمان سپری شده از فراخوانی بر حسب میلی‌ثانیه

فراخوان شروع شد 

public void invocationStarted (IInvocationContext context)

شروع فراخوانی تست را گزارش می‌دهد.

به طور خودکار توسط چارچوب TradeFederation فراخوانی می‌شود. گزارشگران برای پشتیبانی از گزارش‌دهی چندین دستگاه، باید این متد را بازنویسی کنند.

پارامترها
context IInvocationContext : اطلاعاتی درباره فراخوانی

انجمن ورود به سیستم 

public void logAssociation (String dataName, 
                LogFile logFile)

در برخی موارد، log باید به شدت با یک مورد آزمایشی مرتبط باشد، اما امکان انجام این کار در فراخوانی مستقیم testLogSaved(String,LogDataType,InputStreamSource,LogFile) امکان‌پذیر نیست. بنابراین، این فراخوانی امکان ارائه یک ارتباط قوی را به طور صریح فراهم می‌کند.

پارامترها
dataName String : نام داده

logFile LogFile : LogFile که قبلاً لاگ شده و باید با مورد آزمایشی مرتبط باشد.

لاگ‌فایل 

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

قبل از تکمیل، یک فایل نهایی را ثبت کنید

پارامترها
listeners List

saver ILogSaver

source InputStreamSource

name String

type LogDataType

گزارشپایانمیزبانورود 

public static void reportEndHostLog (List<ITestInvocationListener> listeners, 
                ILogSaver saver, 
                String name)

گزارش host_log از جلسه در حال انجام.

پارامترها
listeners List

saver ILogSaver

name String

تست لاگ 

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

داده‌های مربوط به گزارش یا اشکال‌زدایی را از فراخوانی تست ارائه می‌دهد.

باید قبل از ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) یا ERROR(/ITestInvocationListener#invocationEnded(long)) فراخوانی شود.

چارچوب TradeFederation به طور خودکار این متد را فراخوانی می‌کند و گزارش میزبان و در صورت لزوم، گزارش دستگاه را ارائه می‌دهد.

همچنین، فایل لاگ را با ILogSaver سراسری ذخیره کنید و ILogSaverListener.testLogSaved(String,LogDataType,InputStreamSource,LogFile) را برای آن دسته از شنونده‌هایی که رابط ILogSaverListener پیاده‌سازی می‌کنند، فراخوانی کنید.

پارامترها
dataName String : یک نام توصیفی String از داده‌ها. مثلاً "device_logcat". توجه داشته باشید که dataName ممکن است در هر فراخوانی منحصر به فرد نباشد. یعنی پیاده‌سازی‌کنندگان باید بتوانند چندین فراخوانی را با همان dataName مدیریت کنند.

dataType LogDataType : نوع داده‌ی LogDataType

dataStream InputStreamSource : InputStreamSource داده‌ها. پیاده‌سازی‌کنندگان باید createInputStream را برای شروع خواندن داده‌ها فراخوانی کنند و اطمینان حاصل کنند که InputStream حاصل را پس از اتمام ببندند. فراخوانی‌کنندگان باید اطمینان حاصل کنند که منبع داده‌ها تا زمان تکمیل متد testLog موجود و در دسترس باقی می‌ماند.

تست لاگ فوروارد 

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 را به شنوندگان زیر آن ارسال می‌کنیم.

پارامترها
dataName String : یک نام توصیفی String از داده‌ها. مثلاً "device_logcat". توجه داشته باشید که dataName ممکن است در هر فراخوانی منحصر به فرد نباشد. یعنی پیاده‌سازی‌کنندگان باید بتوانند چندین فراخوانی را با همان dataName مدیریت کنند.

dataType LogDataType : نوع داده‌ی LogDataType

dataStream InputStreamSource : InputStreamSource داده‌ها. پیاده‌سازی‌کنندگان باید createInputStream را برای شروع خواندن داده‌ها فراخوانی کنند و مطمئن شوند که InputStream حاصل را پس از اتمام کار ببندند.

logFile LogFile : LogFile که شامل متا دیتای فایل ذخیره شده است.

testModuleEnd 

public void testModuleEnded ()

پایان اجرای یک ماژول را گزارش می‌دهد.

ماژول تست شروع شد 

public void testModuleStarted (IInvocationContext moduleContext)

شروع اجرای یک ماژول را گزارش می‌دهد. این فراخوانی با testModuleEnded() مرتبط است و در دنباله اختیاری است. فقط در طول اجرایی که از اجراکننده‌های مبتنی بر modules: suite استفاده می‌کند، استفاده می‌شود.

پارامترها
moduleContext IInvocationContext : همان IInvocationContext مربوط به ماژول است.