Класс 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 из заданного имени файла. |
File |
createFileObject |
Возвращает объект File, созданный из заданной строки пути. |
protected File |
createFileSystemRoot |
Создаёт новый объект File для f с корректной обработкой корневого каталога файловой системы. |
abstract File |
createNewFolder |
Создаёт новую папку с именем по умолчанию. |
File |
getChild |
Возвращает объект File, который обычно создаётся с помощью new
File(parent, fileName), за исключением случая, когда родительский и дочерний элементы являются специальными папками; в этом случае File представляет собой оболочку, содержащую объект ShellFolder. |
File[] |
getChooserComboBoxFiles() |
Возвращает массив файлов, представляющих значения, которые будут отображаться в списке выбора файла. |
final File[] |
getChooserShortcutPanelFiles() |
Возвращает массив файлов, представляющих значения, отображаемые по умолчанию на панели ярлыков диалогового окна выбора файла. |
File |
getDefaultDirectory() |
Возвращает начальный каталог по умолчанию для диалогового окна выбора файла. |
File[] |
getFiles |
Получает список отображаемых (то есть не скрытых) файлов. |
static FileSystemView |
getFileSystemView() |
Возвращает представление файловой системы. |
File |
getHomeDirectory() |
Возвращает домашний каталог. |
File |
getLinkLocation |
Возвращает обычный файл, на который ссылается указанный файл-ссылка, если указанный файл является ссылкой, обрабатываемой оболочкой. |
File |
getParentDirectory |
Возвращает родительский каталог объекта dir. |
File[] |
getRoots() |
Возвращает все корневые разделы этой системы. |
String |
getSystemDisplayName |
Имя файла, каталога или папки в том виде, в котором оно отображалось бы в системном файловом браузере. |
Icon |
getSystemIcon |
Значок файла, каталога или папки в том виде, в котором он отображался бы в системном файловом браузере. |
Icon |
getSystemIcon |
Возвращает значок файла, каталога или папки в том виде, в котором он отображался бы в системном файловом браузере, для запрошенного размера. |
String |
getSystemTypeDescription |
Описание типа файла, каталога или папки в том виде, в котором оно отображалось бы в системном файловом браузере. |
boolean |
isComputerNode |
Используется классами пользовательского интерфейса для определения необходимости отображения специального значка для узла компьютера, например |
boolean |
isDrive |
Используется классами пользовательского интерфейса для определения необходимости отображения специального значка для дисков или разделов, например значка «жёсткий диск». |
boolean |
isFileSystem |
Проверяет, представляет ли f реальный каталог или файл, а не специальную папку, например "Desktop". |
boolean |
isFileSystemRoot |
Является ли dir корнем дерева в файловой системе, например диском или разделом. |
boolean |
isFloppyDrive |
Используется классами пользовательского интерфейса для определения необходимости отображения специального значка для дискеты. |
boolean |
isHiddenFile |
Возвращает признак того, является ли файл скрытым. |
boolean |
isLink |
Возвращает признак того, является ли указанный файл ссылкой, обрабатываемой оболочкой, которую можно получить с помощью getLinkLocation(File). |
boolean |
isParent |
В Windows файл может отображаться в нескольких папках, помимо родительского каталога в файловой системе. |
boolean |
isRoot |
Определяет, является ли заданный файл корнем в навигационном дереве (деревьях). |
Boolean |
isTraversable |
Возвращает true, если файл (каталог) можно открыть для просмотра. |
Методы, объявленные в классе Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected Object |
clone() |
Создаёт и возвращает копию этого объекта. |
boolean |
equals |
Указывает, равен ли этот объект какому-либо другому. |
protected void |
finalize() |
Устарело, планируется удаление: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков. |
final Class |
getClass() |
Возвращает класс времени выполнения этого Object. |
int |
hashCode() |
Возвращает хеш-код этого объекта. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
String |
toString() |
Возвращает строковое представление объекта. |
final void |
wait() |
Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания. |
final void |
wait |
Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного интервала реального времени. |
final void |
wait |
Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного интервала реального времени. |
Подробное описание конструкторов
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является корнем в навигационном дереве. - См. также:
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 на файл. - Начиная с:
- 17
- См. также:
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
- См. также:
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
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.