Класс FileSystemView

java.lang.Object

javax.swing.filechooser.FileSystemView

public abstract class FileSystemView extends Object

FileSystemView — это интерфейс JFileChooser для доступа к файловой системе. Поскольку API файлов JDK1.1 не предоставляет доступа к такой информации, как корневые разделы, сведения о типах файлов или атрибуты скрытых файлов, этот класс предназначен для получения максимально возможной информации о файловой системе, специфичной для ОС.

Лицензиатам Java может потребоваться предоставить другую реализацию FileSystemView для более эффективной работы с конкретной операционной системой.

Краткое описание конструкторов

Конструктор	Описание
`FileSystemView()`	Создает FileSystemView.

Краткое описание методов

Модификатор и тип	Метод	Описание
`File`	`createFileObject(File dir, String filename)`	Возвращает объект File, созданный в каталоге dir с указанным именем файла.
`File`	`createFileObject(String path)`	Возвращает объект File, созданный из указанной строки пути.
`protected File`	`createFileSystemRoot(File f)`	Создает новый объект `File` для `f` с корректным поведением для корневого каталога файловой системы.
`abstract File`	`createNewFolder(File containingDir)`	Создает новую папку с именем по умолчанию.
`File`	`getChild(File parent, String fileName)`	Возвращает объект `File`, который обычно создается с помощью `new File(parent, fileName)`, за исключением случая, когда и родительская папка, и дочерняя папка являются специальными папками: в этом случае `File` представляет собой оболочку, содержащую объект ShellFolder.
`File[]`	`getChooserComboBoxFiles()`	Возвращает массив файлов, представляющих значения, которые будут отображаться в списке выбора файлов.
`final File[]`	`getChooserShortcutPanelFiles()`	Возвращает массив файлов, представляющих значения, которые по умолчанию отображаются на панели ярлыков диалогового окна выбора файлов.
`File`	`getDefaultDirectory()`	Возвращает исходный каталог по умолчанию для диалогового окна выбора файлов.
`File[]`	`getFiles(File dir, boolean useFileHiding)`	Получает список отображаемых (то есть не скрытых) файлов.
`static FileSystemView`	`getFileSystemView()`	Возвращает представление файловой системы.
`File`	`getHomeDirectory()`	Возвращает домашний каталог.
`File`	`getLinkLocation(File file)`	Если указанный файл является ссылкой, интерпретируемой оболочкой, возвращает обычный файл, на который ссылается этот файл-ссылка.
`File`	`getParentDirectory(File dir)`	Возвращает родительский каталог объекта `dir`.
`File[]`	`getRoots()`	Возвращает все корневые разделы в этой системе.
`String`	`getSystemDisplayName(File f)`	Имя файла, каталога или папки в том виде, в котором оно отображается в системном файловом браузере.
`Icon`	`getSystemIcon(File f)`	Значок файла, каталога или папки в том виде, в котором он отображается в системном файловом браузере.
`Icon`	`getSystemIcon(File f, int width, int height)`	Возвращает значок файла, каталога или папки в том виде, в котором он отображается в системном файловом браузере, для запрошенного размера.
`String`	`getSystemTypeDescription(File f)`	Описание типа файла, каталога или папки в том виде, в котором оно отображается в системном файловом браузере.
`boolean`	`isComputerNode(File dir)`	Используется классами пользовательского интерфейса для определения необходимости отображать специальный значок для узла компьютера, например
`boolean`	`isDrive(File dir)`	Используется классами пользовательского интерфейса для определения необходимости отображать специальный значок для дисков или разделов, например значок «жесткий диск».
`boolean`	`isFileSystem(File f)`	Проверяет, представляет ли `f` реальный каталог или файл, а не специальную папку, например `"Desktop"`.
`boolean`	`isFileSystemRoot(File dir)`	Является ли каталог корнем дерева в файловой системе, например диском или разделом.
`boolean`	`isFloppyDrive(File dir)`	Используется классами пользовательского интерфейса для определения необходимости отображать специальный значок для дискеты.
`boolean`	`isHiddenFile(File f)`	Возвращает признак того, является ли файл скрытым.
`boolean`	`isLink(File file)`	Возвращает признак того, является ли указанный файл ссылкой, интерпретируемой оболочкой, расположение которой можно получить с помощью метода `getLinkLocation(File)`.
`boolean`	`isParent(File folder, File file)`	В Windows файл может отображаться в нескольких папках, помимо родительского каталога в файловой системе.
`boolean`	`isRoot(File f)`	Определяет, является ли указанный файл корнем в навигационном дереве (деревьях).
`Boolean`	`isTraversable(File f)`	Возвращает true, если файл (каталог) доступен для перехода.

Методы, объявленные в классе Object

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

Подробное описание конструкторов

FileSystemView

public FileSystemView()

Создает FileSystemView.

Подробное описание методов

getFileSystemView

public static FileSystemView getFileSystemView()

Возвращает представление файловой системы.

Возвращает:: представление файловой системы

isRoot

public boolean isRoot(File f)

Определяет, является ли указанный файл корнем в навигационном дереве (деревьях). Примеры: в Windows 98 корень один — папка «Рабочий стол». В DOS имеется отдельный корень для каждой буквы диска: C:\, D:\ и т. д. В Unix корень один — каталог "/". Реализация по умолчанию получает сведения из класса ShellFolder.

Параметры:

f — объект File, представляющий каталог

Возвращает:

true, если f является корнем в навигационном дереве.

См. также:

isTraversable

public Boolean isTraversable(File f)

Возвращает true, если файл (каталог) доступен для перехода. Возвращает false, если переход по каталогу невозможен.

Параметры:

f — File

Возвращает:

true, если по файлу/каталогу можно перейти, иначе false

Начиная с версии:

1.4

См. также:

getSystemDisplayName

public String getSystemDisplayName(File f)

Имя файла, каталога или папки в том виде, в котором оно отображается в системном файловом браузере. Пример для Windows: каталог "M:\" отображается как "CD-ROM (M:)". Реализация по умолчанию получает сведения из класса ShellFolder.

Параметры:

f — объект File

Возвращает:

имя файла в том виде, в котором оно отображается в системном диалоговом окне выбора файлов

Начиная с версии:

1.4

См. также:

getSystemTypeDescription

public String getSystemTypeDescription(File f)

Описание типа файла, каталога или папки в том виде, в котором оно отображается в системном файловом браузере. Пример для Windows: папка "Desktop" описывается как "Desktop". Переопределите этот метод для платформ с собственными реализациями ShellFolder.

Параметры:

f — объект File

Возвращает:

описание типа файла в том виде, в котором оно отображается в системном диалоговом окне выбора файлов, или null, если системная информация недоступна.

Начиная с версии:

1.4

См. также:

getSystemIcon

public Icon getSystemIcon(File f)

Значок файла, каталога или папки в том виде, в котором он отображается в системном файловом браузере. Пример для Windows: для каталога "M:\" отображается значок CD-ROM.

Реализация по умолчанию получает сведения из класса ShellFolder.

Параметры:

f — объект File

Возвращает:

значок в том виде, в котором он отображается в системном диалоговом окне выбора файлов

Начиная с версии:

1.4

См. также:

getSystemIcon

public Icon getSystemIcon(File f, int width, int height)

Возвращает значок файла, каталога или папки в том виде, в котором он отображается в системном файловом браузере, для запрошенного размера.

Пример:

    FileSystemView fsv = FileSystemView.getFileSystemView();
    Icon icon = fsv.getSystemIcon(new File("application.exe"), 64, 64);
    JLabel label = new JLabel(icon);

Требования к реализации:

Доступные значки могут зависеть от платформы, поэтому и доступные размеры определяются платформой. Следовательно, точное соответствие запрошенному размеру может быть недостижимо. Возвращенный значок может быть изображением со значком с несколькими разрешениями, что обеспечивает лучшую поддержку сред с высоким разрешением DPI и различными коэффициентами масштабирования.

Параметры:

f — объект File, для которого будет получен значок

width — ширина значка в пользовательской системе координат.

height — высота значка в пользовательской системе координат.

Возвращает:

значок в том виде, в котором он отображается в системном диалоговом окне выбора файлов, или null, если файл не существует или недоступен.

Исключения:

IllegalArgumentException — если передан недопустимый параметр, например отрицательный размер или ссылка на файл null.

Начиная с версии:

См. также:

isParent

public boolean isParent(File folder, File file)

В Windows файл может отображаться в нескольких папках, помимо родительского каталога в файловой системе. Например, такой папкой может быть папка "Desktop", которая не совпадает с file.getParentFile().

Параметры:: folder — объект File, представляющий каталог или специальную папку; file — объект File
Возвращает:: true, если folder является каталогом или специальной папкой и содержит file.
Начиная с версии:: 1.4

getChild

public File getChild(File parent, String fileName)

Возвращает объект File, который обычно создается с помощью

new
File(parent, fileName)

, за исключением случая, когда и родительская папка, и дочерняя папка являются специальными папками: в этом случае File представляет собой оболочку, содержащую объект ShellFolder.

Параметры:: parent — объект File, представляющий каталог или специальную папку; fileName — имя файла или папки, существующей в parent
Возвращает:: объект File.
Начиная с версии:: 1.4

isFileSystem

public boolean isFileSystem(File f)

Проверяет, представляет ли f реальный каталог или файл, а не специальную папку, например "Desktop". Используется классами пользовательского интерфейса для определения возможности выбора папки при выборе каталога.

Параметры:: f — объект File
Возвращает:: true, если f является реальным файлом или каталогом.
Начиная с версии:: 1.4

createNewFolder

public abstract File createNewFolder(File containingDir) throws IOException

Создает новую папку с именем по умолчанию.

Параметры:: containingDir — объект File, обозначающий каталог, в котором будет создана новая папка
Возвращает:: объект File, обозначающий созданную папку
Исключения:: IOException — если не удалось создать новую папку

isHiddenFile

public boolean isHiddenFile(File f)

Возвращает признак того, является ли файл скрытым.

Параметры:: f — объект File
Возвращает:: true, если указанный File обозначает скрытый файл

isFileSystemRoot

public boolean isFileSystemRoot(File dir)

Является ли каталог корнем дерева в файловой системе, например диском или разделом. Пример: возвращает true для "C:\" в Windows 98.

Параметры:

dir — объект File, представляющий каталог

Возвращает:

true, если f является корнем файловой системы

Начиная с версии:

1.4

См. также:

isDrive

public boolean isDrive(File dir)

Используется классами пользовательского интерфейса для определения необходимости отображать специальный значок для дисков или разделов, например значок «жесткий диск». Реализация по умолчанию не может определить это и поэтому всегда возвращает false.

Параметры:: dir — каталог
Возвращает:: false всегда
Начиная с версии:: 1.4

isFloppyDrive

public boolean isFloppyDrive(File dir)

Используется классами пользовательского интерфейса для определения необходимости отображать специальный значок для дискеты. Предполагает isDrive(dir). Реализация по умолчанию не может определить это и поэтому всегда возвращает false.

Параметры:: dir — каталог
Возвращает:: false всегда
Начиная с версии:: 1.4

isComputerNode

public boolean isComputerNode(File dir)

Используется классами пользовательского интерфейса для определения необходимости отображать специальный значок для узла компьютера, например «Мой компьютер» или сетевой сервер. Реализация по умолчанию не может определить это и поэтому всегда возвращает false.

Параметры:: dir — каталог
Возвращает:: false всегда
Начиная с версии:: 1.4

getRoots

public File[] getRoots()

Возвращает все корневые разделы в этой системе. Например, в Windows это будет папка "Desktop", а в DOS — диски от A: до Z:.

Возвращает:: массив объектов File, представляющих все корневые разделы в этой системе

getHomeDirectory

public File getHomeDirectory()

Возвращает домашний каталог.

Возвращает:: домашний каталог

getDefaultDirectory

public File getDefaultDirectory()

Возвращает исходный каталог по умолчанию для диалогового окна выбора файлов.

Возвращает:: объект File, представляющий исходную папку по умолчанию
Начиная с версии:: 1.4

createFileObject

public File createFileObject(File dir, String filename)

Возвращает объект File, созданный в каталоге dir с указанным именем файла.

Параметры:: dir — абстрактный путь, обозначающий каталог; filename — представление пути в виде String
Возвращает:: объект File, созданный из dir и filename

createFileObject

public File createFileObject(String path)

Возвращает объект File, созданный из указанной строки пути.

Параметры:: path — представление пути в виде String
Возвращает:: объект File, созданный из указанного path

getFiles

public File[] getFiles(File dir, boolean useFileHiding)

Получает список отображаемых (то есть не скрытых) файлов.

Параметры:: dir — корневой каталог файлов, которые необходимо вернуть; useFileHiding — определяет, возвращаются ли скрытые файлы
Возвращает:: массив объектов File, представляющих файлы и каталоги в указанном dir. Скрытые файлы включаются, если useFileHiding имеет значение false.

getParentDirectory

public File getParentDirectory(File dir)

Возвращает родительский каталог объекта dir.

Параметры:: dir — проверяемый объект File
Возвращает:: родительский каталог объекта dir или null, если dir равен null

getChooserComboBoxFiles

public File[] getChooserComboBoxFiles()

Возвращает массив файлов, представляющих значения, которые будут отображаться в списке выбора файлов.

Возвращает:: массив объектов File. Возвращенный массив может быть пустым, если нет соответствующих разрешений.
Начиная с версии:: 9

getChooserShortcutPanelFiles

public final File[] getChooserShortcutPanelFiles()

Возвращает массив файлов, представляющих значения, которые по умолчанию отображаются на панели ярлыков диалогового окна выбора файлов.

Возвращает:: массив объектов File. Возвращенный массив может быть пустым, если нет соответствующих разрешений.
Начиная с версии:: 12

isLink

public boolean isLink(File file)

Возвращает признак того, является ли указанный файл ссылкой, интерпретируемой оболочкой, расположение которой можно получить с помощью метода getLinkLocation(File).

Параметры:

file — файл

Возвращает:

признак того, является ли файл ссылкой

Исключения:

NullPointerException — если file равно null

Начиная с версии:

См. также:

getLinkLocation

public File getLinkLocation(File file) throws FileNotFoundException

Если указанный файл является ссылкой, интерпретируемой оболочкой, возвращает обычный файл, на который ссылается этот файл-ссылка. Возвращает null, если указанный файл не является ссылкой, интерпретируемой оболочкой.

Параметры:: file — файл
Возвращает:: файл, на который ведет ссылка, или null.
Исключения:: FileNotFoundException — если файл, на который ведет ссылка, не существует; NullPointerException — если file равно null
Начиная с версии:: 9

createFileSystemRoot

protected File createFileSystemRoot(File f)

Создает новый объект File для f с корректным поведением для корневого каталога файловой системы.

Параметры:: f — объект File, представляющий корневой каталог файловой системы, например "/" в Unix или "C:\" в Windows.
Возвращает:: новый объект File
Начиная с версии:: 1.4

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/filechooser/FileSystemView.html