com.ibm.as400.access
Class IFSSystemView

java.lang.Object
  javax.swing.filechooser.FileSystemView
      com.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.

 
 import com.ibm.as400.access.AS400;
 import com.ibm.as400.access.IFSJavaFile;
 import com.ibm.as400.access.IFSSystemView;
 import javax.swing.JFileChooser;
 import java.awt.Frame;
 
 // Work with directory /Dir on the system myAS400.
 AS400 system = new AS400("myAS400");
 IFSJavaFile dir = new IFSJavaFile(system, "/Dir");
 JFileChooser chooser = new JFileChooser(dir, new IFSSystemView(system));
 Frame parent = new Frame();
 int returnVal = chooser.showOpenDialog(parent);
 if (returnVal == JFileChooser.APPROVE_OPTION) {
    IFSJavaFile chosenFile = (IFSJavaFile)(chooser.getSelectedFile());
    System.out.println("You selected the file named " +
                        chosenFile.getName());
 }
 

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.