com.ibm.as400.access
Class IFSSystemView

java.lang.Object
  extended byjavax.swing.filechooser.FileSystemView
      extended bycom.ibm.as400.access.IFSSystemView

public class IFSSystemView
extends FileSystemView

IFSSystemView provides a gateway to the iSeries integrated file system, for use when constructing javax.swing.JFileChooser objects.

JFileChooser is a standard Java way to build dialogs for navigating and choosing files.

The following example demonstrates the use of IFSSystemView.

See Also:
IFSJavaFile

Constructor Summary
IFSSystemView(AS400 system)
          Constructs an IFSSystemView object.
 
Method Summary
 File createFileObject(File containingDir, String name)
          Returns a File object constructed in directory from the given filename.
 File createFileObject(String path)
          Returns a File object constructed from the given path string.
protected  File createFileSystemRoot(File f)
           
 File createNewFolder(File containingDir)
          Creates a new folder with a default name.
 File getDefaultDirectory()
          Returns the user's default starting directory for the file chooser.
 File[] getFiles(File directory, boolean useFileHiding)
          Gets the list of shown (that is, not hidden) files in the directory.
 File getHomeDirectory()
          Returns the home directory.
 File getParentDirectory(File dir)
          Returns the parent directory of dir.
 File[] getRoots()
          Returns all root partitions on this system.
 String getSystemDisplayName(File f)
          Returns the name of a file, directory, or folder as it would be displayed in a system file browser.
 Icon getSystemIcon(File f)
          Always returns an icon representing an iSeries server.
 String getSystemTypeDescription(File f)
          Returns a type description for a file, directory, or folder as it would be displayed in a system file browser.
 boolean isComputerNode(File dir)
          Always returns false.
 boolean isDrive(File dir)
          Always returns false.
 boolean isFileSystemRoot(File f)
          Returns true if f represents the root directory on the server ("/"), and false otherwise.
 boolean isFloppyDrive(File dir)
          Always returns false.
 boolean isRoot(File file)
          Determines if the given file is a root in the navigatable tree(s).
 
Methods inherited from class javax.swing.filechooser.FileSystemView
getChild, getFileSystemView, isFileSystem, isHiddenFile, isParent, isTraversable
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

IFSSystemView

public IFSSystemView(AS400 system)
Constructs an IFSSystemView object.

Parameters:
system - The iSeries system that contains the file.
Method Detail

createFileObject

public File createFileObject(File containingDir,
                             String name)
Returns a File object constructed in directory from the given filename.
Note: This method does not create an actual file in the file system.

Parameters:
containingDir - The directory in which to create the file.
containingDir is assumed to represent an existing directory on the server. If null, it is ignored.
name - The file name.
Returns:
a File object representing the new file.

createFileObject

public File createFileObject(String path)
Returns a File object constructed from the given path string.
Note: This method does not create an actual file in the file system.

Parameters:
path - The file path name.
Returns:
the File object.

createFileSystemRoot

protected File createFileSystemRoot(File f)

createNewFolder

public File createNewFolder(File containingDir)
                     throws IOException
Creates a new folder with a default name.
Note: In the context of this class, "folder" is synonymous with "directory".

Parameters:
containingDir - The parent directory in which to create the folder.
containingDir is assumed to represent an existing directory on the server.
Returns:
a File object representing the new folder.
Throws:
IOException

getDefaultDirectory

public File getDefaultDirectory()
Returns the user's default starting directory for the file chooser. This will represent the 'root' directory on the server.

Returns:
A File object representing the default starting folder.

getFiles

public File[] getFiles(File directory,
                       boolean useFileHiding)
Gets the list of shown (that is, not hidden) files in the directory.

Parameters:
directory - The directory to search.
useFileHiding - This parameter is ignored.
Returns:
The list of files.

getHomeDirectory

public File getHomeDirectory()
Returns the home directory.
The iSeries integrated file system has one home directory, the "/" directory.

Returns:
the home directory.

getParentDirectory

public File getParentDirectory(File dir)
Returns the parent directory of dir.

Parameters:
dir - The directory being queried.
dir is assumed to represent an existing directory on the server.
Returns:
the parent directory of dir, or null if dir is null.

getRoots

public File[] getRoots()
Returns all root partitions on this system.
The iSeries integrated file system has one root partition, the "/" directory.

Returns:
all root partitions on this system.

getSystemDisplayName

public String getSystemDisplayName(File f)
Returns the name of a file, directory, or folder as it would be displayed in a system file browser.

Parameters:
f - A File object.
Returns:
The file name as it would be displayed by a native file chooser.

getSystemIcon

public Icon getSystemIcon(File f)
Always returns an icon representing an iSeries server.


getSystemTypeDescription

public String getSystemTypeDescription(File f)
Returns a type description for a file, directory, or folder as it would be displayed in a system file browser.

Parameters:
f - A File object.
Returns:
The file type description as it would be displayed by a native file chooser or null if no native information is available.

isComputerNode

public boolean isComputerNode(File dir)
Always returns false.


isDrive

public boolean isDrive(File dir)
Always returns false.


isFloppyDrive

public boolean isFloppyDrive(File dir)
Always returns false.


isFileSystemRoot

public boolean isFileSystemRoot(File f)
Returns true if f represents the root directory on the server ("/"), and false otherwise.

Parameters:
f - A File object representing a directory.
Returns:
true if f is a root of a filesystem

isRoot

public boolean isRoot(File file)
Determines if the given file is a root in the navigatable tree(s).
The iSeries integrated file system has one root, the "/" directory.

Parameters:
file - A File object representing a directory.
Returns:
true if file is a root in the navigatable tree.