org.openide.filesystems
Class AbstractFileSystem

java.lang.Object
  |
  +--org.openide.filesystems.FileSystem
        |
        +--org.openide.filesystems.AbstractFileSystem

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

JarFileSystem, LocalFileSystem, XMLFileSystem

public abstract class AbstractFileSystem

extends FileSystem

Implementation of FileSystem that simplifies the most common tasks. Caches information about the filesystem in memory and periodically refreshes its content. Many other operations are performed in a safer manner so as to reuse known experience; should be substantially simpler to subclass.

See Also:

Serialized Form

Inner Class Summary

static interface	AbstractFileSystem.Attr Handle attributes of files.
static interface	AbstractFileSystem.Change Controls modification of files.
static interface	AbstractFileSystem.Info Information about files.
static interface	AbstractFileSystem.List Provides access to the hierarchy of resources.
static interface	AbstractFileSystem.Transfer Controls on moving of files.

Inner classes inherited from class org.openide.filesystems.FileSystem

FileSystem.AtomicAction, FileSystem.Environment, FileSystem.Status

Field Summary

protected AbstractFileSystem.Attr	attr Handling of attributes for files.
protected AbstractFileSystem.Change	change Methods for modification of files.
protected AbstractFileSystem.Info	info Methods for obtaining information about files.
protected AbstractFileSystem.List	list Provider of hierarchy of files.
protected AbstractFileSystem.Transfer	transfer Methods for moving of files.

Fields inherited from class org.openide.filesystems.FileSystem

PROP_HIDDEN, PROP_READ_ONLY, PROP_ROOT, PROP_SYSTEM_NAME, PROP_VALID

Constructor Summary

AbstractFileSystem()

Method Summary

protected boolean	checkVirtual(String name) This method is called from AbstractFileObject.isVirtual.
protected Reference	createReference(FileObject fo) Creates Reference.
protected Enumeration	existingFileObjects(FileObject fo) For the FileObject specified as parameter, returns the recursive enumeration of existing children fileobjects (both folders and data).
FileObject	find(String aPackage, String name, String ext) Finds file in the filesystem by name.
protected Reference	findReference(String resourceName) This method allows to find Reference to resourceName
FileObject	findResource(String name) Finds file when its resource name is given.
SystemAction[]	getActions() Returns an array of actions that can be invoked on any file in this file system.
abstract String	getDisplayName() Provides a name for the system that can be presented to the user.
protected int	getRefreshTime() Get the number of milliseconds between automatic refreshes of the directory structure.
FileObject	getRoot() Getter for root folder in the filesystem.
protected void	markImportant(String name, boolean important) Mark the file as being important or unimportant.
protected void	refreshResource(String name, boolean expected) Allows subclasses to fire that a change occured in a file or folder.
protected FileObject	refreshRoot() Instruct the filesystem that the root should change.
protected void	setRefreshTime(int ms) Set the number of milliseconds between automatic refreshes of the directory structure.

Methods inherited from class org.openide.filesystems.FileSystem

addFileStatusListener, addNotify, addPropertyChangeListener, addVetoableChangeListener, fireFileStatusChanged, firePropertyChange, fireVetoableChange, getActions, getCapability, getStatus, getSystemName, isDefault, isHidden, isPersistent, isReadOnly, isValid, prepareEnvironment, removeFileStatusListener, removeNotify, removePropertyChangeListener, removeVetoableChangeListener, runAtomicAction, setCapability, setHidden, setSystemName, toString

Methods inherited from class java.lang.Object

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

Field Detail

list

protected AbstractFileSystem.List list

Provider of hierarchy of files.

change

protected AbstractFileSystem.Change change

Methods for modification of files.

transfer

protected AbstractFileSystem.Transfer transfer

Methods for moving of files. This field can be left null if the filesystem does not require special handling handling of FileObject.move and is satified with the default implementation.

info

protected AbstractFileSystem.Info info

Methods for obtaining information about files.

attr

protected AbstractFileSystem.Attr attr

Handling of attributes for files.

Constructor Detail

AbstractFileSystem

public AbstractFileSystem()

Method Detail

getDisplayName

public abstract String getDisplayName()

Description copied from class: FileSystem

Provides a name for the system that can be presented to the user.

This call should never be used to attempt to identify the file root of the filesystem. On some systems it may happen to look the same but this is a coincidence and may well change in the future. Either check whether you are working with a LocalFileSystem or similar implementation and use LocalFileSystem.getRootDirectory(); or better, try FileUtil.toFile(org.openide.filesystems.FileObject) which is designed to do this correctly.

Overrides:

getDisplayName in class FileSystem

Following copied from class: org.openide.filesystems.FileSystem

Returns:

user presentable name of the file system

getRoot

public FileObject getRoot()

Description copied from class: FileSystem

Getter for root folder in the filesystem.

Overrides:

getRoot in class FileSystem

Following copied from class: org.openide.filesystems.FileSystem

Returns:

root folder of whole filesystem

find

public FileObject find(String aPackage,
                       String name,
                       String ext)

Description copied from class: FileSystem

Finds file in the filesystem by name.

The default implementation converts dots in the package name into slashes, concatenates the strings, adds any extension prefixed by a dot and calls the findResource method.

Note: when both of name and ext are null then name and extension should be ignored and scan should look only for a package.

Overrides:

find in class FileSystem

Following copied from class: org.openide.filesystems.FileSystem

Parameters:

aPackage - package name where each package component is separated by a dot

name - name of the file (without dots) or null if one wants to obtain a folder (package) and not a file in it

ext - extension of the file (without leading dot) or null if one needs a package and not a file

Returns:

a file object that represents a file with the given name or null if the file does not exist

findResource

public FileObject findResource(String name)

Description copied from class: FileSystem

Finds file when its resource name is given. The name has the usual format for the ClassLoader.getResource(String) method. So it may consist of "package1/package2/filename.ext". If there is no package, it may consist only of "filename.ext".

Overrides:

findResource in class FileSystem

Following copied from class: org.openide.filesystems.FileSystem

Parameters:

name - resource name

Returns:

FileObject that represents file with given name or null if the file does not exist

createReference

protected Reference createReference(FileObject fo)

Creates Reference. In FileSystem, which subclasses AbstractFileSystem, you can overload method createReference(FileObject fo) to achieve another type of Reference (weak, strong etc.)

Parameters:

fo - is FileObject. It`s reference yourequire to get.

Returns:

Reference to FileObject

findReference

protected final Reference findReference(String resourceName)

This method allows to find Reference to resourceName

Parameters:

resourceName - is name of resource

Returns:

Reference to resourceName

getActions

public SystemAction[] getActions()

Description copied from class: FileSystem

Returns an array of actions that can be invoked on any file in this file system. These actions should preferably support the Menu, Popup, and Toolbar presenters.

Overrides:

getActions in class FileSystem

Following copied from class: org.openide.filesystems.FileSystem

Returns:

array of available actions

setRefreshTime

protected final void setRefreshTime(int ms)

Set the number of milliseconds between automatic refreshes of the directory structure.

Parameters:

ms - number of milliseconds between two refreshes; if <= 0 then refreshing is disabled

getRefreshTime

protected final int getRefreshTime()

Get the number of milliseconds between automatic refreshes of the directory structure. By default, automatic refreshing is disabled.

Returns:

the number of milliseconds, or 0 if refreshing is disabled

refreshRoot

protected final FileObject refreshRoot()

Instruct the filesystem that the root should change. A fresh root is created. Subclasses that support root changes should use this.

Returns:

the new root

refreshResource

protected final void refreshResource(String name,
                                     boolean expected)

Allows subclasses to fire that a change occured in a file or folder. The change can be "expected" when it is a result of an user action and the user knows that such change should occur.

Parameters:

name - resource name of the file where the change occured

expected - true if the user initiated change and expects it

existingFileObjects

protected final Enumeration existingFileObjects(FileObject fo)

For the FileObject specified as parameter, returns the recursive enumeration of existing children fileobjects (both folders and data). It doesn't create any new FileObject instances. Direct children are at the begining of the enumeration.

Parameters:

fo - the starting point for the recursive fileobject search

checkVirtual

protected boolean checkVirtual(String name)

This method is called from AbstractFileObject.isVirtual. Tests if file really exists or is missing. Some operation on it may be restricted if returns true.

Parameters:

name - of the file

Returns:

true indicates that the file is missing.

Since:

1.9

markImportant

protected void markImportant(String name,
                             boolean important)

Mark the file as being important or unimportant.

Parameters:

name - the file to mark

important - true indicates that file is important, false conversely file is unimportant.

Since:

1.9