xyz.cofe.unix.libc

Class UnixFileIO

java.lang.Object

xyz.cofe.unix.libc.UnixFileIO

public class UnixFileIO
extends Object

Работа с файловой системой, функциями libc через интерфейс jna. Основная причина разработки этой библиотеки - отсуствие в java 6 и более ранних версий работы с символическими ссылками.

Author:

Kamnev Georgy (nt.gocha@gmail.com)

Constructor Summary

Constructors

Constructor and Description
UnixFileIO() Конструктор по умолчанию

Method Summary

Modifier and Type	Method and Description
String	canonicalizeFileName(String filename) Приводит имя файла (путь) в каноническую форму.
void	chdir(String dirName) Установка текущей директории Генерирует StdErr в случаи ошибки
void	chmod(String name, int mode) Смена привилегий файла/каталога Генерирует StdErr в случаи ошибки
void	chown(String name, int owner, int group) Смена владельца файла/каталога Генерирует StdErr в случаи ошибки
boolean	exists(String filename) Проверка существования файла/каталога
String	getcwd() Чтение текущей директории Генерирует StdErr в случаи ошибки
FileStat	lstat(String filename) Чтение информации о файле Генерирует StdErr в случаи ошибки
void	mkdir(String name, int mode) Создает каталог Генерирует StdErr в случаи ошибки
String[]	readdir(String path) Возвращает имена файлов в указанном каталоге
String	readlink(String fileName) Чтение символической ссылки Генерирует StdErr в случаи ошибки
void	rename(String oldname, String newname) Переименование файла/каталога Генерирует StdErr в случаи ошибки
void	rmdir(String name) Удаляет каталог Генерирует StdErr в случаи ошибки
void	symlink(String oldname, String newname) Создание символической ссылки.
int	umask(int umask) Указывает маску (какие биты сбросить) создаваемых файлов, см. umask Условно: 0UGO (Восмеричная сис.) - где U - права для пользователя, G - группы, O - остальных 7 - Чтение, Запись, Исполнение 6 - Чтение, Запись 5 - Чтение, Исполнение 4 - Только чтение 3 - Запись, Исполнение 2 - Запись 1 - Исполнеине 0 - Нет разрешений При значении umask=0002 и создаваемые каталоги будут иметь права доступа = 0775
void	unlink(String filename) Удаляет файл Генерирует StdErr в случаи ошибки

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

UnixFileIO

public UnixFileIO()

Конструктор по умолчанию

Method Detail

getcwd

public String getcwd()

Чтение текущей директории
Генерирует StdErr в случаи ошибки

Returns:

текущая директория

See Also:

StdErr

chdir

public void chdir(String dirName)

Установка текущей директории
Генерирует StdErr в случаи ошибки

Parameters:

dirName - текущаяя директория

See Also:

StdErr

readdir

public String[] readdir(String path)

Возвращает имена файлов в указанном каталоге

Parameters:

path - Каталог

Returns:

Имена файлов

lstat

public FileStat lstat(String filename)

Чтение информации о файле
Генерирует StdErr в случаи ошибки

Parameters:

filename - Файл

Returns:

информация о файле, размер, тип, владелец ....

See Also:

StdErr

readlink

public String readlink(String fileName)

Чтение символической ссылки
Генерирует StdErr в случаи ошибки

Parameters:

fileName - ссылка

Returns:

куда указывает

See Also:

StdErr

symlink

public void symlink(String oldname,
                    String newname)

Создание символической ссылки.
Генерирует StdErr в случаи ошибки

Parameters:

oldname - куда указывает ссылка

newname - файл ссылки

See Also:

StdErr

unlink

public void unlink(String filename)

Удаляет файл
Генерирует StdErr в случаи ошибки

Parameters:

filename - имя файла

See Also:

StdErr

rmdir

public void rmdir(String name)

Удаляет каталог
Генерирует StdErr в случаи ошибки

Parameters:

name - Имя каталога

See Also:

StdErr

canonicalizeFileName

public String canonicalizeFileName(String filename)

Приводит имя файла (путь) в каноническую форму. Удаляет точки (.), две точки (..) в имени "разрешает" до родительского каталога.

Parameters:

filename - Имя файла

Returns:

Имя файла или null, если имя файла не содержит компонентов

umask

public int umask(int umask)

Указывает маску (какие биты сбросить) создаваемых файлов, см. umask

Условно:
0UGO (Восмеричная сис.) - где U - права для пользователя, G - группы, O - остальных
7 - Чтение, Запись, Исполнение
6 - Чтение, Запись
5 - Чтение, Исполнение
4 - Только чтение
3 - Запись, Исполнение
2 - Запись
1 - Исполнеине
0 - Нет разрешений
При значении umask=0002 и создаваемые каталоги будут иметь права доступа = 0775

Parameters:

umask - битовая маска

Returns:

предыдущее значение, при параметре 0 - возвращает текущее значение

mkdir

public void mkdir(String name,
                  int mode)

Создает каталог
Генерирует StdErr в случаи ошибки

Parameters:

name - Каталог

mode - Права доступа

See Also:

StdErr

chown

public void chown(String name,
                  int owner,
                  int group)

Смена владельца файла/каталога
Генерирует StdErr в случаи ошибки

Parameters:

name - Файл/каталог

owner - Владелец-пользователь UID

group - Владелец-группа GID

See Also:

StdErr

chmod

public void chmod(String name,
                  int mode)

Смена привилегий файла/каталога
Генерирует StdErr в случаи ошибки

Parameters:

name - Файл/Каталог

mode - Права доступа

See Also:

StdErr

rename

public void rename(String oldname,
                   String newname)

Переименование файла/каталога
Генерирует StdErr в случаи ошибки

Parameters:

oldname - Старое имя

newname - Новое имя

See Also:

StdErr

exists

public boolean exists(String filename)

Проверка существования файла/каталога

Parameters:

filename - Файл/каталог

Returns:

true - существует