Main Page Cookbook/Overview ImageMeister the jcprops file Licensing Binary Installation & Configuration [ Win · Mac · Nix · OSX ] Changes Public API Source Code Main Page Java [ Common · Win · Mac · Nix ] Native Code [ Common · Win · Mac · Nix ] Manifest Native Code Overviews [ Common · Win · Mac · Nix · Strings ] Macros [ General · Native Macros ] Walkthroughs [ Java only · Java and native ] Building [ Win · Mac · Nix · OSX ] Distribution Issues

    All Packages  This Package  Class Hierarchy  Class Search  Index

Interface com.jconfig.DiskObject

Summary

    public interface  DiskObject
         extends com.jconfig.DumpInfo
    {
              // Fields 3
         public static final int DO_CREATEDIR;
         public static final int DO_CREATEFILE;
         public static final String copyrightString;

              // Methods 18
         public abstract DiskObject createObject(String, int, int);
         public abstract boolean exists();
         public abstract int getColorCoding();
         public abstract DiskObject getContainer() throws FileNotFoundException, DiskFileException;
         public abstract DateBundle getDateBundle();
         public abstract String getDisplayName();
         public abstract File getFile();
         public abstract FileSystem getFileSystem();
         public abstract int getFlags();
         public abstract int getGetFlagsMask();
         public abstract IconBundle getIconBundle();
         public abstract String getName();
         public abstract int getSetFlagsMask();
         public abstract int iterate(DiskFilter, int, int);
         public abstract void setDateBundle(DateBundle);
         public abstract void setFlags(int, int);
         public abstract int setName(String);
         public abstract int updateContainer();
    }

The interfaces DiskVolume, DiskFile, and DiskAlias extend this interface, which contains common methods for disk-related objects.

Author:
  Copyright (c) 1997-2002 Samizdat Productions. All Rights Reserved.

Cross Reference

Extended By:
  DiskFile, DiskVolume

Returned By:
  DiskObject.createObject(), DiskObject.getContainer(), FileRegistryI.createDiskObject(), FileRegistryI.resolveAlias(), FileRegistry.createDiskObject(), FileRegistry.resolveAlias(), FileSystem.getMountPoint(), GenDiskFilter.getArray(), FileSpecifier.getDiskObject(), BrowserPanel.getDiskObject()

Fields

### · copyrightString | Summary | Top

       public static final String copyrightString

### · DO_CREATEFILE | Summary | Top

       public static final int DO_CREATEFILE

> See the 'type' argument of the 'createObject() method.

### · DO_CREATEDIR | Summary | Top

       public static final int DO_CREATEDIR

> See the 'type' argument of the 'createObject() method.

Methods

### · getName | Summary | Top

       public abstract String getName()

> Returns the name of this object. If this object no longer exists or if an error occurs, returns null.

### · setName | Summary | Top

       public abstract int setName(String newName)

> Sets the name of this object. Returns 0 if the name was set successfully, non-zero otherwise. The name must be in quoted-printable form.

### · getDisplayName | Summary | Top

       public abstract String getDisplayName()

> Returns the name of this object, as it would be displayed to the user. Note that the display name may be different from the name of this object. If this object no longer exists, returns null.

### · getDateBundle | Summary | Top

       public abstract DateBundle getDateBundle()

> Returns a DateBundle containing zero or more of the dates associated with this object: the creation date, modification date, backup date, and access date. Use this instead of the following methods. Any or all of the dates in the DateBundle may be null if this object no longer exists, of if it is not possible to determine this information. This method can return null in those cases as well.

### · setDateBundle | Summary | Top

       public abstract void setDateBundle(DateBundle newDates)

> Sets the set of dates associated with this file.

> Parameter | Description
> newDates | if one or more of the dates in this bundle are null, they will not be changed.

### · getIconBundle | Summary | Top

       public abstract IconBundle getIconBundle()

> Returns the icon bundle associated with this object. Returns null if this object does not have any associated icons, or if this object no longer exists.

### · getColorCoding | Summary | Top

       public abstract int getColorCoding()

> Returns the Mac-style color coding label for this object. Returns a number between 0 and 7; 0 signifies that there is no color coding.

### · getFlags | Summary | Top

       public abstract int getFlags()

> Returns a set of binary flags associated with this object. Use the 'getGetFlagsMask' method to find out which bits of the returned value are significant.

### · getGetFlagsMask | Summary | Top

       public abstract int getGetFlagsMask()

> Returns a mask which indicates which bits returned by 'getFlags' are significant. For instance, if bit 0 of the return value of this method is set, bit 0 of 'getFlags' contains actual information, otherwise, this information is not available.

### · setFlags | Summary | Top

       public abstract void setFlags(int whichFlags,
                                     int flags)

> Sets the binary flags associated with this object. Use the 'getSetFlagsMask' method to find out which bits can be set.

> Parameter | Description
> whichFlags | a mask which indicates which bits in 'flags' will be set or reset For instance, if whichFlags is 0011, and flags is 0101, and the rightmost digit in the preceding numbers is bit #0, then, only bits #0 and #1 will be changed; bit #0 (indicated by the rightmost digit of whichFlags being 1) will be changed to 1 (the rightmost value in flags), and bit #1 will be changed to 0. All the other flags will not be changed, because only bits #0 and bits #1 are set in the mask.
> flags | contains the new values of the bits indicated by the whichFlags mask

> Throws: OSException
>   if an OS error occurs

### · getSetFlagsMask | Summary | Top

       public abstract int getSetFlagsMask()

> Returns a mask which indicates which bits can be set by 'setFlags'. For instance, if bit 0 of the return value of this method is set, bit 0 of the argument to 'setFlags' can be set.

> Throws: OSException
>   if an OS error occurs

### · getFile | Summary | Top

       public abstract File getFile()

> Returns a copy of the File object associated with this object.

### · exists | Summary | Top

       public abstract boolean exists()

> Returns true if this object still exists, false otherwise.

### · iterate | Summary | Top

       public abstract int iterate(DiskFilter filter,
                                   int flags,
                                   int maxToIterate)

> Enumerates the contents of this object. If this object does not contain other objects, returns -1. Other error codes may be returned. Returns 0 if no error occurs.

> Parameter | Description
> filter | a DiskFilter object, to which each of the contained items will be presented. The DiskFilter returns a boolean; true means to continue, false means to stop.
> flags | indicates what type of objects should be ignored. If zero, all objects will be presented to the filter. If you want to exclude various types of objects, OR together the appropriate constants from the DiskFilter interface: kIgnoreHidden, kIgnoreFolders, kIgnoreFiles, kIgnoreAliases, kIgnoreNameLocked.
> maxToIterate | the maximum number of files to present to the DiskFilter

### · getContainer | Summary | Top

       public abstract DiskObject getContainer()  throws FileNotFoundException, DiskFileException

> Returns the DiskObject which contains this object. If there is no such object ( i.e., this is a volume ), returns null.

### · getFileSystem | Summary | Top

       public abstract FileSystem getFileSystem()

> Returns the FileSystem which contains this object. If that information cannot be determined, returns null.

### · updateContainer | Summary | Top

       public abstract int updateContainer()

> Sets the modification date of the container of this object to the current time. Use this method, for instance, to inform the Finder that you've made changes to an object.

### · createObject | Summary | Top

       public abstract DiskObject createObject(String name,
                                               int type,
                                               int flags)

> Used to create a file, folder or other object which will be contained by this DiskObject. Returns the new DiskObject, or null if the object could not be created.

> Parameter | Description
> name | the name of the new object
> type | either 'DO_CREATEFILE' or 'DO_CREATEDIR'
> flags | reserved; set to 0 The following logic is used to create the object:
>     if type == DO_CREATEDIR
>     	if an object with that name already exists
>     		if it's a folder
>     			return a DiskObject representing that folder
>     		else
>     			return null
>     	else
>     		create a new folder, and return a DiskObject representing the new folder
>     else if type == DO_CREATEFILE
>     	if an object with that name already exists
>     		if it's a file
>     			return a DiskObject representing that file
>     		else
>     			return null
>     	else
>     		create a new, empty file, and return a DiskObject representing the new file

    All Packages  This Package  Class Hierarchy  Class Search  Index

Freshly brewed Java API Documentation automatically generated with polardoc Version 1.0.7