com.telecom
Class FileSystemAccessor

java.lang.Object
  extended bycom.telecom.FileSystemAccessor

public class FileSystemAccessor
extends java.lang.Object

Класс FileSystemAccessor предназначен для доступа к файлам и папкам телефона. Обеспечивает получение списка файлов и каталогов, создание, чтение, запись, удаление файлов и каталогов, изменение атрибутов и т.д.


Constructor Summary
FileSystemAccessor(java.lang.String resource)
          Создает новый объект FileSystemAccessor.
 
Method Summary
 long availableSize()
          Определяет доступное пространство на устройстве.
 boolean canRead()
          Определяет возможность чтения из файла или каталога.
 boolean canWrite()
          Определяет возможность записи в файл или каталог.
 void closeInputStream(java.io.InputStream stream)
          Закрывает входной поток для файла, открытый ранее openInputStream(), закрывает файл.
 void closeOutputStream(java.io.OutputStream stream)
          Закрывает выходной поток для файла, открытый ранее openOutputStream(), закрывает файл.
 boolean create()
          Создает новый файл.
 boolean delete()
          Удаляет существующий файл.
 long directorySize(boolean includeSubDirs)
          Определяет размер, занимаемый каталогом.
 boolean exists()
          Определяет существует ли ресурс.
 long fileSize()
          Определяет размер файла.
 boolean isDirectory()
          Определяет является ли ресурс каталогом.
 boolean isHidden()
          Определяет значение атрибута "скрытый".
 long lastModified()
          Определяет время последнего изменения файла.
 java.lang.String[] list()
          Получает список файлов и каталогов, находящихся в каталоге.
static java.lang.String[] listRoots()
          Получает корневой список устройств.
 boolean mkdir()
          Создает новый каталог.
 java.io.InputStream openInputStream()
          Открывает входной поток для файла.
 java.io.OutputStream openOutputStream()
          Открывает выходной поток для файла.
 byte[] read()
          Чтение из файла.
 boolean rename(java.lang.String newName)
          Переименование файла.
 void setHidden(boolean hidden)
          Устанавливает файлу значение атрибута "скрытый".
 void setReadable(boolean readable)
          Устанавливает новое значение атрибута "для чтения".
 void setWritable(boolean writable)
          Устанавливает новео значение атрибута "для записи".
 long totalSize()
          Определяет размер устройства.
 long usedSize()
          Используемый объем на устройстве.
 boolean write(byte[] abyte0)
          Запись в файл.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

FileSystemAccessor

public FileSystemAccessor(java.lang.String resource)
Создает новый объект FileSystemAccessor. Для работы с каталогом используется маршрут: /диск/путь/ Для работы с файлом необходимо указывать полный путь и расширение: /диск/путь/файл.расширение

Пример 1:

FileSystemAccessor fsa = new FileSystemAccessor("/a/mobile/audio/tATu.mp3");

byte[] buf = fsa.read();

fsa = null;

Пример 2:

FileSystemAccessor fsa = new FileSystemAccessor("/a/mobile/helloworld.txt");

fsa.create();

String s = "Hello, World!";

fsa.write(s.getBytes());

fsa = null;

Parameters:
resource - - задает имя файла или папки.
Method Detail

availableSize

public long availableSize()
Определяет доступное пространство на устройстве.

Returns:
Доступное пространство на устройстве в байтах или -1 если устройство не доступно.

canRead

public boolean canRead()
Определяет возможность чтения из файла или каталога.

Returns:
true, если ресурс существует и доступен для чтения.

canWrite

public boolean canWrite()
Определяет возможность записи в файл или каталог.

Returns:
true, если ресурс существует и доступен для записи.

create

public boolean create()
Создает новый файл.

Returns:
true, если файл существует или новый файл создан.

delete

public boolean delete()
Удаляет существующий файл.

Returns:
true, если файл не существует или файл удален.

directorySize

public long directorySize(boolean includeSubDirs)
Определяет размер, занимаемый каталогом.

Parameters:
includeSubDirs - - если true, то учитывается также размер всех подкаталогов в текущем каталоге.
Returns:
размер каталога в байтах.

exists

public boolean exists()
Определяет существует ли ресурс.

Returns:
true, если указанный файл или каталог существует.

fileSize

public long fileSize()
Определяет размер файла.

Returns:
размер файла в байтах.

isDirectory

public boolean isDirectory()
Определяет является ли ресурс каталогом.

Returns:
true, если указанный ресурс является каталогом.

isHidden

public boolean isHidden()
Определяет значение атрибута "скрытый".

Returns:
true, если указанный файл имеет атрибут "скрытый".

lastModified

public long lastModified()
Определяет время последнего изменения файла.

Returns:
Количество миллисекунд начиная с 1 января 1970 года до времени последнего изменения файла.

list

public java.lang.String[] list()
Получает список файлов и каталогов, находящихся в каталоге. Все файлы и каталоги возвращаются с родительским каталогом.

Пример:

FileSystemAccessor fsa = new FileSystemAccessor("/a/");

String[] s = fsa.list();

fsa = null;

for (int i = 0; i < s.length; i++) System.out.println(s[i]);

Returns:
список всех видимых файлов и каталогов в каталоге.

listRoots

public static java.lang.String[] listRoots()
Получает корневой список устройств. Каждое устройство списка имеет вид /диск/

Пример:

String[] s = FileSystemAccessor.listRoots();

for (int i = 0; i < s.length; i++) System.out.println(s[i]);

Returns:
корневой список устройств.

mkdir

public boolean mkdir()
Создает новый каталог.

Returns:
true, если каталог существует или создан новый каталог.

read

public byte[] read()
Чтение из файла.

Returns:
содержимое файла в виде массива байт или null, если чтение невозможно.

rename

public boolean rename(java.lang.String newName)
Переименование файла.

Пример:

FileSystemAccessor fsa = new FileSystemAccessor("/a/oldname.txt");

fsa.rename("/a/newname.txt");

fsa = null;

Parameters:
newName - - новое имя файла. Должно быть с тем же путем, что и исходный файл.
Returns:
true, если переименование прошло успешно.

write

public boolean write(byte[] abyte0)
Запись в файл.

Parameters:
abyte0 - - массив байт для записи в файл.
Returns:
true, если запись прошла успешно.

setHidden

public void setHidden(boolean hidden)
Устанавливает файлу значение атрибута "скрытый".

Parameters:
hidden - - новое значение атрибута "скрытый".

setReadable

public void setReadable(boolean readable)
Устанавливает новое значение атрибута "для чтения".

Parameters:
readable - - новое значение атрибута "для чтения".

setWritable

public void setWritable(boolean writable)
Устанавливает новео значение атрибута "для записи".

Parameters:
writable - - новое значение атрибута "для записи".

totalSize

public long totalSize()
Определяет размер устройства.

Returns:
Общий размер устройства в байтах или -1, если устройство не доступно.

usedSize

public long usedSize()
Используемый объем на устройстве.

Returns:
Используемый объем на устройстве в байтах или -1, если устройство не доступно.

openInputStream

public java.io.InputStream openInputStream()
Открывает входной поток для файла.

Returns:
входной поток.

openOutputStream

public java.io.OutputStream openOutputStream()
Открывает выходной поток для файла.

Returns:
выходной поток.

closeInputStream

public void closeInputStream(java.io.InputStream stream)
Закрывает входной поток для файла, открытый ранее openInputStream(), закрывает файл.

Parameters:
stream - - входной поток, открытый ранее openInputStream().

closeOutputStream

public void closeOutputStream(java.io.OutputStream stream)
Закрывает выходной поток для файла, открытый ранее openOutputStream(), закрывает файл.

Parameters:
stream - - выходной поток, открытый ранее openOutputStream().