سرویس فهرست فایل

public final class FileListingService
extends Object

شیء جاوا
com.android.ddmlib.FileListingService


سرویس فهرست‌گیری فایل سمت IDevice را ارائه می‌دهد.

خلاصه

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

class FileListingService.FileEntry

نشان دهنده یک ورودی در یک دایرکتوری است.

interface FileListingService.IListingReceiver

کلاس‌هایی که این رابط را پیاده‌سازی می‌کنند، متدی ارائه می‌دهند که با نتایج ناهمزمان دستور ls روی دستگاه سروکار دارد.

ثابت‌ها

String DIRECTORY_APP

پوشه برنامه.

String DIRECTORY_DATA

پوشه داده سطح بالا.

String DIRECTORY_MNT

پوشه mount سطح بالا.

String DIRECTORY_SDCARD

پوشه‌ی سطح بالای کارت حافظه (sdcard).

String DIRECTORY_SYSTEM

پوشه سیستم سطح بالا.

String DIRECTORY_TEMP

پوشه موقت سطح بالا.

String FILE_SEPARATOR

جداکننده فایل سمت دستگاه.

long REFRESH_RATE

int TYPE_BLOCK

نوع ورودی: بلوک

int TYPE_CHARACTER

نوع ورودی: شخصیت

int TYPE_DIRECTORY

نوع ورودی: دایرکتوری

int TYPE_DIRECTORY_LINK

نوع ورودی: لینک دایرکتوری

int TYPE_FIFO

نوع ورودی: FIFO

int TYPE_FILE

نوع ورودی: فایل

int TYPE_LINK

نوع مطلب: لینک

int TYPE_OTHER

نوع ورودی: سایر

int TYPE_SOCKET

نوع ورودی: سوکتی

فیلدها

public static final Pattern LS_LD_PATTERN

public static final Pattern LS_L_PATTERN

الگوی Regexp برای تجزیه نتیجه از ls.

public static final Pattern STAT_PATTERN

الگوی Regexp برای تجزیه نتیجه از stat.

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

FileListingService ( IDevice device)

یک سرویس فهرست فایل برای یک IDevice مشخص ایجاد می‌کند.

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

FileEntry[] getChildren ( FileListingService.FileEntry entry, boolean useCache, FileListingService.IListingReceiver receiver)

فرزندان یک FileEntry را برمی‌گرداند.

FileEntry[] getChildrenSync ( FileListingService.FileEntry entry)

فرزندان یک FileEntry را برمی‌گرداند.

FileListingService.FileEntry getRoot ()

عنصر ریشه را برمی‌گرداند.

ثابت‌ها

برنامه دایرکتوری

public static final String DIRECTORY_APP

پوشه برنامه.

مقدار ثابت: "برنامه"

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

public static final String DIRECTORY_DATA

پوشه داده سطح بالا.

مقدار ثابت: "داده"

دایرکتوری_MNT

public static final String DIRECTORY_MNT

پوشه mount سطح بالا.

مقدار ثابت: "mnt"

دایرکتوری_کارت_حافظه

public static final String DIRECTORY_SDCARD

پوشه‌ی سطح بالای کارت حافظه (sdcard).

مقدار ثابت: "sdcard"

سیستم دایرکتوری

public static final String DIRECTORY_SYSTEM

پوشه سیستم سطح بالا.

مقدار ثابت: "سیستم"

دایرکتوری_دما

public static final String DIRECTORY_TEMP

پوشه موقت سطح بالا.

مقدار ثابت: "tmp"

جداکننده فایل

public static final String FILE_SEPARATOR

جداکننده فایل سمت دستگاه.

مقدار ثابت: "/"

نرخ تازه‌سازی

public static final long REFRESH_RATE

مقدار ثابت: ۵۰۰۰ (۰x۰۰۰۰۰۰۰۰۰۰۰۱۳۸۸)

نوع_بلوک

public static final int TYPE_BLOCK

نوع ورودی: بلوک

مقدار ثابت: ۳ (۰x۰۰۰۰۰۰۳)

نوع_کاراکتر

public static final int TYPE_CHARACTER

نوع ورودی: شخصیت

مقدار ثابت: ۴ (۰x۰۰۰۰۰۰۴)

نوع_دایرکتوری

public static final int TYPE_DIRECTORY

نوع ورودی: دایرکتوری

مقدار ثابت: ۱ (۰x۰۰۰۰۰۰۱)

public static final int TYPE_DIRECTORY_LINK

نوع ورودی: لینک دایرکتوری

مقدار ثابت: ۲ (۰x۰۰۰۰۰۰۲)

نوع_FIFO

public static final int TYPE_FIFO

نوع ورودی: FIFO

مقدار ثابت: ۷ (۰x۰۰۰۰۰۰۷)

نوع_فایل

public static final int TYPE_FILE

نوع ورودی: فایل

مقدار ثابت: 0 (0x00000000)

public static final int TYPE_LINK

نوع مطلب: لینک

مقدار ثابت: ۵ (۰x۰۰۰۰۰۰۵)

نوع دیگر

public static final int TYPE_OTHER

نوع ورودی: سایر

مقدار ثابت: ۸ (۰x۰۰۰۰۰۰۸)

نوع_سوکت

public static final int TYPE_SOCKET

نوع ورودی: سوکتی

مقدار ثابت: ۶ (۰x۰۰۰۰۰۰۰۶)

فیلدها

الگوی LS_LD

public static final Pattern LS_LD_PATTERN

الگوی LS

public static final Pattern LS_L_PATTERN

الگوی Regexp برای تجزیه نتیجه از ls.

الگوی آماری

public static final Pattern STAT_PATTERN

الگوی Regexp برای تجزیه نتیجه از stat. مثال: drwxr-xr-x root root 2021-08-02 09:20:53.000000000 -0700 4096 /

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

سرویس فهرست فایل

public FileListingService (IDevice device)

یک سرویس فهرست فایل برای یک IDevice مشخص ایجاد می‌کند.

پارامترها
device IDevice : دستگاهی که سرویس به آن متصل است.

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

کودکان را دریافت کنید

public FileEntry[] getChildren (FileListingService.FileEntry entry, 
                boolean useCache, 
                FileListingService.IListingReceiver receiver)

فرزندان یک FileEntry را برمی‌گرداند.

این روش از مکانیزم حافظه پنهان (cache) و حالت‌های همزمان (synchronous) و غیرهمزمان (asynchronous) پشتیبانی می‌کند.

اگر receiver null باشد، دستور ls سمت دستگاه به صورت همزمان انجام می‌شود و متد پس از اتمام دستور، نتیجه را برمی‌گرداند.
اگر receiver null نباشد، دستور در یک نخ جداگانه اجرا می‌شود و پس از اتمام، گیرنده از نتیجه مطلع خواهد شد.

نتیجه هر دستور ls در FileEntry والد ذخیره می‌شود. useCache اجازه استفاده از این حافظه پنهان را می‌دهد، اما فقط در صورتی که حافظه پنهان معتبر باشد. حافظه پنهان فقط برای FileListingService.REFRESH_RATE ms معتبر است. پس از آن همیشه یک دستور ls جدید اجرا می‌شود.

اگر حافظه پنهان معتبر باشد و useCache == true ، متد همیشه مقدار حافظه پنهان را برمی‌گرداند، چه IListingReceiver ارائه شده باشد چه نشده باشد.

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

useCache boolean : یک پرچم برای استفاده از حافظه پنهان یا اعمال یک دستور ls جدید.

receiver FileListingService.IListingReceiver : یک گیرنده برای فراخوانی‌های ناهمزمان.

بازگشت‌ها
FileEntry[] لیست فرزندان یا null برای فراخوانی‌های ناهمزمان.

همگام‌سازی کودکان

public FileEntry[] getChildrenSync (FileListingService.FileEntry entry)

فرزندان یک FileEntry را برمی‌گرداند.

این متد، نسخه همزمان صریح getChildren(com.android.ddmlib.FileListingService.FileEntry, boolean, com.android.ddmlib.FileListingService.IListingReceiver) است. این تقریباً معادل فراخوانی getChildren(FileEntry, false, null) است.

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

بازگشت‌ها
FileEntry[] فهرست کودکان

پرتاب‌ها
TimeoutException در صورت بروز وقفه در اتصال هنگام ارسال دستور.
AdbCommandRejectedException اگر adb دستور را رد کند.
ShellCommandUnresponsiveException در صورتی که دستور shell برای مدت زمانی طولانی‌تر از maxTimeToOutputResponse هیچ خروجی ارسال نکند.
در صورت بروز خطای ورودی/خروجی در اتصال.

دریافت روت

public FileListingService.FileEntry getRoot ()

عنصر ریشه را برمی‌گرداند.

بازگشت‌ها
FileListingService.FileEntry شیء FileEntry که عنصر ریشه را نشان می‌دهد یا در صورت نامعتبر بودن دستگاه، null است.