همگام‌سازی سرویس

public class SyncService
extends Object

شیء جاوا
↳ com.android.tradefed.device.server.SyncService

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

برای دریافت یک شیء SyncService ، از IDevice.getSyncService() استفاده کنید.

خلاصه

کلاس‌های تو در تو

class SyncService.FileStat

interface SyncService.ISyncProgressMonitor

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

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

SyncService (InetSocketAddress address, IDevice device)

یک شیء سرویس همگام‌سازی (Sync) ایجاد می‌کند.

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

void close ()

اتصال را قطع می‌کند.

static SyncService.ISyncProgressMonitor getNullProgressMonitor ()

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

boolean openSync ()

اتصال همگام‌سازی را باز می‌کند.

void pull ( FileEntry[] entries, String localPath, SyncService.ISyncProgressMonitor monitor)

فایل(ها) یا پوشه(ها) را دریافت می‌کند.

void pullFile ( FileListingService.FileEntry remote, String localFilename, SyncService.ISyncProgressMonitor monitor)

یک فایل واحد را دریافت می‌کند.

void pullFile (String remoteFilepath, String localFilename, SyncService.ISyncProgressMonitor monitor)

یک فایل واحد را دریافت می‌کند.

void push (String[] local, FileListingService.FileEntry remote, SyncService.ISyncProgressMonitor monitor)

چندین فایل یا دایرکتوری را ارسال می‌کند.

void push (String[] local, String remote, SyncService.ISyncProgressMonitor monitor)

چندین فایل یا دایرکتوری را ارسال می‌کند.

void pushFile (String local, String remote, SyncService.ISyncProgressMonitor monitor)

یک فایل واحد را فشار دهید.

SyncService.FileStat statFile (String path)

اطلاعات آماری فایل راه دور را برمی‌گرداند.

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

همگام‌سازی سرویس 

public SyncService (InetSocketAddress address, 
                IDevice device)

یک شیء سرویس همگام‌سازی (Sync) ایجاد می‌کند.

پارامترها
address InetSocketAddress : آدرسی که باید به آن متصل شوید

device IDevice : IDevice که سرویس به آن متصل می‌شود.

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

بستن 

public void close ()

اتصال را قطع می‌کند.

مانیتور پیشرفت نول 

public static SyncService.ISyncProgressMonitor getNullProgressMonitor ()

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

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

بازگشت‌ها
SyncService.ISyncProgressMonitor

همگام‌سازی باز 

public boolean openSync ()

اتصال همگام‌سازی را باز می‌کند. این باید قبل از هرگونه فراخوانی push[File] / pull[File] فراخوانی شود.

بازگشت‌ها
boolean اگر اتصال برقرار باشد، مقدار true و اگر adb اتصال را رد کند، مقدار false برمی‌گرداند. این اتفاق می‌تواند در صورت نامعتبر بودن IDevice رخ دهد.

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
اگر اتصال به adb ناموفق بود.

کشیدن 

public void pull (FileEntry[] entries, 
                String localPath, 
                SyncService.ISyncProgressMonitor monitor)

فایل(ها) یا پوشه(ها) را دریافت می‌کند.

پارامترها
entries FileEntry : آیتم(های) راه دور برای دریافت

localPath String : مقصد محلی. اگر تعداد ورودی‌ها > ۱ باشد یا اگر ورودی منحصر به فرد یک پوشه باشد، این باید یک پوشه باشد.

monitor SyncService.ISyncProgressMonitor : مانیتور پیشرفت. نمی‌تواند تهی (null) باشد.

پرتاب‌ها
com.android.ddmlib.SyncException
استثنای IO
com.android.ddmlib.TimeoutException
SyncException
TimeoutException

فایل pull 

public void pullFile (FileListingService.FileEntry remote, 
                String localFilename, 
                SyncService.ISyncProgressMonitor monitor)

یک فایل واحد را دریافت می‌کند.

پارامترها
remote FileListingService.FileEntry : فایل راه دور

localFilename String : مقصد محلی.

monitor SyncService.ISyncProgressMonitor : مانیتور پیشرفت. نمی‌تواند تهی (null) باشد.

پرتاب‌ها
در صورت وجود استثنای IO.
TimeoutException در صورت اتمام زمان خواندن پاسخ‌ها از دستگاه.
SyncException در صورت بروز استثنا در همگام‌سازی.

فایل pull 

public void pullFile (String remoteFilepath, 
                String localFilename, 
                SyncService.ISyncProgressMonitor monitor)

یک فایل واحد را دریافت می‌کند.

از آنجا که این متد به جای FileEntry ، فقط با یک String برای فایل راه دور سروکار دارد، اندازه فایلی که دریافت می‌شود ناشناخته است و ISyncProgressMonitor پیشرفت را به درستی نشان نمی‌دهد.

پارامترها
remoteFilepath String : مسیر کامل فایل راه دور

localFilename String : مقصد محلی.

monitor SyncService.ISyncProgressMonitor : مانیتور پیشرفت. نمی‌تواند تهی (null) باشد.

پرتاب‌ها
در صورت وجود استثنای IO.
TimeoutException در صورت اتمام زمان خواندن پاسخ‌ها از دستگاه.
SyncException در صورت بروز استثنا در همگام‌سازی.

همچنین ببینید:

فشار دادن 

public void push (String[] local, 
                FileListingService.FileEntry remote, 
                SyncService.ISyncProgressMonitor monitor)

چندین فایل یا دایرکتوری را ارسال می‌کند.

پارامترها
local String : فایل‌های محلی برای ارسال

remote FileListingService.FileEntry : یک FileEntry ریموت که نشان‌دهنده‌ی یک دایرکتوری است.

monitor SyncService.ISyncProgressMonitor : مانیتور پیشرفت

پرتاب‌ها
SyncException اگر برخی از فایل‌ها قابل ارسال نبودند
در صورت بروز خطای ورودی/خروجی در اتصال
TimeoutException در صورت اتمام زمان خواندن پاسخ‌ها از دستگاه

فشار دادن 

public void push (String[] local, 
                String remote, 
                SyncService.ISyncProgressMonitor monitor)

چندین فایل یا دایرکتوری را ارسال می‌کند.

پارامترها
local String : فایل‌های محلی برای ارسال

remote String : مسیر راه دور که نشان‌دهنده‌ی یک دایرکتوری است

monitor SyncService.ISyncProgressMonitor : مانیتور پیشرفت

پرتاب‌ها
SyncException اگر برخی از فایل‌ها قابل ارسال نبودند
در صورت بروز خطای ورودی/خروجی در اتصال
TimeoutException در صورت اتمام زمان خواندن پاسخ‌ها از دستگاه

pushFile 

public void pushFile (String local, 
                String remote, 
                SyncService.ISyncProgressMonitor monitor)

یک فایل واحد را فشار دهید.

پارامترها
local String : مسیر فایل محلی.

remote String : مسیر فایل راه دور.

monitor SyncService.ISyncProgressMonitor : مانیتور پیشرفت. نمی‌تواند تهی (null) باشد.

پرتاب‌ها
SyncException اگر فایل قابل ارسال نبود
در صورت بروز خطای ورودی/خروجی در اتصال.
TimeoutException در صورت اتمام زمان خواندن پاسخ‌ها از دستگاه.

فایل stat 

public SyncService.FileStat statFile (String path)

اطلاعات آماری فایل راه دور را برمی‌گرداند.

پارامترها
path String : فایل راه دور

بازگشت‌ها
SyncService.FileStat یک FileStat شامل حالت، اندازه و آخرین اطلاعات تغییر یافته اگر همه چیز خوب پیش رفته باشد یا در غیر این صورت null

پرتاب‌ها
استثنای IO
TimeoutException در صورت اتمام زمان خواندن پاسخ‌ها از دستگاه.