Класс FileSystemView

java.lang.Object

javax.swing.filechooser.FileSystemView

public abstract class FileSystemView extends Object

FileSystemView — это шлюз JFileChooser к файловой системе. Поскольку API файлов JDK 1.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)`	Используется классами UI для определения, нужно ли отображать специальный значок для узла компьютера, например.
`boolean`	`isDrive(File dir)`	Используется классами UI для определения, нужно ли отображать специальный значок для дисков или разделов, например, значок "жёсткий диск".
`boolean`	`isFileSystem(File f)`	Проверяет, представляет ли `f` реальный каталог или файл, а не специальную папку, например, `"Desktop"`.
`boolean`	`isFileSystemRoot(File dir)`	Является ли dir корнем дерева в файловой системе, например, диском или разделом.
`boolean`	`isFloppyDrive(File dir)`	Используется классами UI для определения, нужно ли отображать специальный значок для гибкого диска.
`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, если к файлу (каталогу) можно получить доступ.

Методы, объявленные в классе java.lang.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: папка "Рабочий стол" описывается как "Рабочий стол". Переопределить для платформ с реализациями 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);

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

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

Параметры:

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

width - ширина иконки в системе координат пользователя.

height - высота иконки в системе координат пользователя.

Возвращает:

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

Выбрасывает:

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

С момента:

См. также:

isParent

public boolean isParent(File folder, File file)

В Windows файл может отображаться в нескольких папках, помимо родительского каталога в файловой системе. Например, папка "Рабочий стол" не является тем же, что и 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)

Является ли 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

END_OF_DOCUMENT_MARKER

isComputerNode

public boolean isComputerNode(File dir)

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

Parameters:: dir - каталог
Returns:: false всегда
Since:: 1.4

getRoots

public File[] getRoots()

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

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

getHomeDirectory

public File getHomeDirectory()

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

Returns:: домашний каталог

getDefaultDirectory

public File getDefaultDirectory()

Возвращает стандартный начальный каталог пользователя для выбора файла.

Returns:: объект File, представляющий стандартную папку для начала
Since:: 1.4

createFileObject

public File createFileObject(File dir, String filename)

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

Parameters:: dir - абстрактное имя пути, обозначающее каталог; filename - String представление имени пути
Returns:: объект File, созданный из dir и filename

createFileObject

public File createFileObject(String path)

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

Parameters:: path - String представление пути
Returns:: объект File, созданный из заданного path

getFiles

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

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

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

getParentDirectory

public File getParentDirectory(File dir)

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

Parameters:: dir - запрашиваемый File
Returns:: родительский каталог dir, или null, если dir равен null

getChooserComboBoxFiles

public File[] getChooserComboBoxFiles()

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

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

getChooserShortcutPanelFiles

public final File[] getChooserShortcutPanelFiles()

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

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

isLink

public boolean isLink(File file)

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

Parameters:

file - файл

Returns:

является ли это ссылкой

Throws:

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

Since:

See Also:

getLinkLocation

public File getLinkLocation(File file) throws FileNotFoundException

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

Parameters:: file - файл
Returns:: связанный файл или null.
Throws:: FileNotFoundException - если связанный файл не существует; NullPointerException - если file равно null
Since:: 9

createFileSystemRoot

protected File createFileSystemRoot(File f)

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

Parameters:: f - объект File, представляющий корневой каталог файловой системы, например, "/" в Unix или "C:\" в Windows.
Returns:: новый объект File
Since:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/filechooser/FileSystemView.html