سرویس فهرست فایل
public final class FileListingService
extends Object
| شیء جاوا | |
| ↳ | com.android.ddmlib.FileListingService |
سرویس فهرستگیری فایل سمت IDevice را ارائه میدهد.
خلاصه
کلاسهای تو در تو | |
|---|---|
class | FileListingService.FileEntryنشان دهنده یک ورودی در یک دایرکتوری است. |
interface | FileListingService.IListingReceiver کلاسهایی که این رابط را پیادهسازی میکنند، متدی ارائه میدهند که با نتایج ناهمزمان دستور |
ثابتها | |
|---|---|
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) یک سرویس فهرست فایل برای یک | |
روشهای عمومی | |
|---|---|
FileEntry[] | getChildren ( FileListingService.FileEntry entry, boolean useCache, FileListingService.IListingReceiver receiver) فرزندان یک |
FileEntry[] | getChildrenSync ( FileListingService.FileEntry entry) فرزندان یک |
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 است. |
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-12-04 بهوقت ساعت هماهنگ جهانی.