Spec-Zone.ru › OpenJDK 27

Класс FileSystemView

java.lang.Object
javax.swing.filechooser.FileSystemView
public abstract class FileSystemView extends Object
FileSystemView — это шлюз JFileChooser к файловой системе. Поскольку API File в 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)
Используется классами пользовательского интерфейса для определения необходимости отображения специального значка для узла компьютера, например
boolean isDrive(File dir)
Используется классами пользовательского интерфейса для определения необходимости отображения специального значка для дисков или разделов, например значка «жёсткий диск».
boolean isFileSystem(File f)
Проверяет, представляет ли f реальный каталог или файл, а не специальную папку, например "Desktop".
boolean isFileSystemRoot(File dir)
Является ли 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
Модификатор и тип Метод Описание
protected Object clone()
Создаёт и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли этот объект какому-либо другому.
protected void finalize()
Устарело, планируется удаление: этот элемент API подлежит удалению в будущей версии.
Финализация устарела и подлежит удалению в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания.
final void wait(long timeoutMillis)
Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного интервала реального времени.
final void wait(long timeoutMillis, int nanos)
Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного интервала реального времени.

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

FileSystemView

public FileSystemView()
Создаёт FileSystemView.

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

getFileSystemView

public static FileSystemView getFileSystemView()
Возвращает представление файловой системы.
Возвращает:
представление файловой системы

isRoot

public boolean isRoot(File f)
Определяет, является ли заданный файл корнем в навигационном дереве (деревьях). Примеры: в Windows 98 есть один корень — папка Desktop. В DOS есть один корень для каждой буквы диска: C:\, D:\ и т. д. В Unix есть один корень — каталог "/". Реализация по умолчанию получает сведения из класса ShellFolder.
Параметры:
f — объект File, представляющий каталог
Возвращает:
true, если f является корнем в навигационном дереве.
См. также:
  • isFileSystemRoot(File)

isTraversable

public Boolean isTraversable(File f)
Возвращает true, если файл (каталог) можно открыть для просмотра. Возвращает false, если каталог нельзя обойти.
Параметры:
f — File
Возвращает:
true, если файл/каталог можно обойти, иначе false
Начиная с:
1.4
См. также:
  • JFileChooser.isTraversable(File)
  • FileView.isTraversable(File)

getSystemDisplayName

public String getSystemDisplayName(File f)
Имя файла, каталога или папки в том виде, в котором оно отображалось бы в системном файловом браузере. Пример для Windows: каталог "M:\" отображается как "CD-ROM (M:)". Реализация по умолчанию получает сведения из класса ShellFolder.
Параметры:
f — объект File
Возвращает:
имя файла в том виде, в котором оно отображалось бы в системном диалоговом окне выбора файла
Начиная с:
1.4
См. также:
  • JFileChooser.getName(File)

getSystemTypeDescription

public String getSystemTypeDescription(File f)
Описание типа файла, каталога или папки в том виде, в котором оно отображалось бы в системном файловом браузере. Пример для Windows: папка "Desktop" описывается как "Desktop". Переопределите этот метод для платформ с собственными реализациями ShellFolder.
Параметры:
f — объект File
Возвращает:
описание типа файла в том виде, в котором оно отображалось бы в системном диалоговом окне выбора файла, либо null, если сведения системы недоступны.
Начиная с:
1.4
См. также:
  • JFileChooser.getTypeDescription(File)

getSystemIcon

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

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

Параметры:
f — объект File
Возвращает:
значок в том виде, в котором он отображался бы в системном диалоговом окне выбора файла
Начиная с:
1.4
См. также:
  • JFileChooser.getIcon(File)

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 на файл.
Начиная с:
17
См. также:
  • JFileChooser.getIcon(File)
  • AbstractMultiResolutionImage
  • getSystemIcon(File)

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)
Является ли dir корнем дерева в файловой системе, например диском или разделом. Пример: возвращает true для "C:\" в Windows 98.
Параметры:
dir — объект File, представляющий каталог
Возвращает:
true, если f является корнем файловой системы
Начиная с:
1.4
См. также:
  • isRoot(File)

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
Начиная с:
9
См. также:
  • getLinkLocation(File)

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

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе документации Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API