Класс 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[] getChooserComboBoxFiles()

Возвращает массив файлов, представляющих значения, которые по умолчанию должны отображаться в селекторе выбора файла.
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)

Значок файла, каталога или папки, как он отображается в файловом браузере системы.
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, если файл (каталог) доступен для посещения.

Методы, объявленные в классе 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 является корнем в навигационном дереве.
См. также:
isFileSystemRoot(java.io.File)

isTraversable

public Boolean isTraversable(File f)

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

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

getSystemDisplayName

public String getSystemDisplayName(File f)

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

Параметры:
f - объект File
Возвращает:
имя файла в виде, в котором оно отображается в собственном файловом просмотрщике
С:
1.4
См. также:
JFileChooser.getName(java.io.File)

getSystemTypeDescription

public String getSystemTypeDescription(File f)

Описание типа файла, каталога или папки, как оно отображается в файловом браузере системы. Пример из Windows: папка «Рабочий стол» описывается как «Рабочий стол». Переопределить для платформ с собственными реализациями ShellFolder.

Параметры:
f - объект File
Возвращает:
описание типа файла, как оно отображается в собственном файловом просмотрщике, или null, если информация не доступна.
С:
1.4
См. также:
JFileChooser.getTypeDescription(java.io.File)

getSystemIcon

public Icon getSystemIcon(File f)

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

Параметры:
f - объект File
Возвращает:
иконка, как она отображается в собственном файловом просмотрщике
С:
1.4
См. также:
JFileChooser.getIcon(java.io.File)

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)
Параметры:
parent - объект File , представляющий каталог или специальную папку
fileName - имя файла или папки, которые существуют в parent
Возвращает:
объект File. Он обычно создаётся с помощью new File(parent, fileName), за исключением случаев, когда родитель и ребёнок — обе специальные папки, в этом случае File — обёртка, содержащая объект ShellFolder.
С:
1.4

isFileSystem

public boolean isFileSystem(File f)

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

Параметры:
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(java.io.File)

isDrive

public boolean isDrive(File dir)

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

Параметры:
dir - каталог
Возвращает:
false всегда
С:
1.4

isFloppyDrive

public boolean isFloppyDrive(File dir)

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

Параметры:
dir - каталог
Возвращает:
false всегда
С:
1.4

isComputerNode

public boolean isComputerNode(File dir)

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

Параметры:
dir - каталог
Возвращает:
false всегда
С:
1.4

getRoots

public File[] getRoots()

Возвращает все корневые разделы в этой системе. Например, в Windows это папка «Рабочий стол», а в 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 - строковое представление пути
Возвращает:
объект File , созданный из dir и filename

createFileObject

public File createFileObject(String path)

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

Параметры:
path - строковое представление пути
Возвращает:
объект 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.
Выбрасывает:
SecurityException - если у вызывающего объекта нет необходимых разрешений
С:
9

isLink

public boolean isLink(File file)

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

Параметры:
file - файл
Возвращает:
является ли это ссылкой
Исключения:
NullPointerException - если file равно null
SecurityException - если у вызывающего объекта нет необходимых разрешений
С тех пор:
9
См. также:
getLinkLocation(File)

getLinkLocation

public File getLinkLocation(File file)
                     throws FileNotFoundException

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

Параметры:
file - файл
Возвращает:
связанный файл или null.
Исключения:
FileNotFoundException - если связанный файл не существует
NullPointerException - если file равно null
SecurityException - если у вызывающего объекта нет необходимых разрешений
С тех пор:
9

createFileSystemRoot

protected File createFileSystemRoot(File f)

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

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

© 1993, 2020, 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/11/docs/api/java.desktop/javax/swing/filechooser/FileSystemView.html

Spec-Zone .ru
спецификации, руководства, описания, API