Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

org.apache.derby.impl.io
Class DirFile  view DirFile download DirFile.java

java.lang.Object
  extended byjava.io.File
      extended byorg.apache.derby.impl.io.DirFile
All Implemented Interfaces:
java.lang.Comparable, java.io.Serializable, org.apache.derby.io.StorageFile
Direct Known Subclasses:
DirFile4

class DirFile
extends java.io.File
implements org.apache.derby.io.StorageFile

This class provides a disk based implementation of the StorageFile interface. It is used by the database engine to access persistent data and transaction logs under the directory (default) subsubprotocol.


Field Summary
 
Fields inherited from class java.io.File
pathSeparator, pathSeparatorChar, separator, separatorChar
 
Fields inherited from interface org.apache.derby.io.StorageFile
EXCLUSIVE_FILE_LOCK, EXCLUSIVE_FILE_LOCK_NOT_AVAILABLE, NO_FILE_LOCK_SUPPORT
 
Constructor Summary
(package private) DirFile(DirFile directoryName, java.lang.String fileName)
          Construct a DirFile from a directory name and a file name.
(package private) DirFile(java.lang.String path)
          Construct a DirFile from a path name.
(package private) DirFile(java.lang.String directoryName, java.lang.String fileName)
          Construct a DirFile from a directory name and a file name.
 
Method Summary
 boolean deleteAll()
          Deletes the named file and, if it is a directory, all the files and directories it contains.
 int getExclusiveFileLock()
          Get an exclusive lock.
 java.io.InputStream getInputStream()
          Creates an input stream from a file name.
 java.io.OutputStream getOutputStream()
          Creates an output stream from a file name.
 java.io.OutputStream getOutputStream(boolean append)
          Creates an output stream from a file name.
 org.apache.derby.io.StorageFile getParentDir()
          Get the name of the parent directory if this name includes a parent.
 org.apache.derby.io.StorageRandomAccessFile getRandomAccessFile(java.lang.String mode)
          Get a random access (read/write) file.
(package private) static org.apache.derby.io.StorageFile getTempDir()
          Get the name of the directory of temporary files.
 void releaseExclusiveFileLock()
          Release the resource associated with an earlier acquired exclusive lock
 boolean renameTo(org.apache.derby.io.StorageFile newName)
          Rename the file denoted by this name.
 
Methods inherited from class java.io.File
canRead, canWrite, compareTo, compareTo, createNewFile, createTempFile, createTempFile, delete, deleteOnExit, equals, exists, getAbsoluteFile, getAbsolutePath, getCanonicalFile, getCanonicalPath, getName, getParent, getParentFile, getPath, hashCode, isAbsolute, isDirectory, isFile, isHidden, lastModified, length, list, list, listFiles, listFiles, listFiles, listRoots, mkdir, mkdirs, renameTo, setLastModified, setReadOnly, toString, toURI, toURL
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.apache.derby.io.StorageFile
canWrite, createNewFile, delete, exists, getCanonicalPath, getName, getPath, isDirectory, length, list, mkdir, mkdirs, setReadOnly, toString
 

Constructor Detail

DirFile

DirFile(java.lang.String path)
Construct a DirFile from a path name.


DirFile

DirFile(java.lang.String directoryName,
        java.lang.String fileName)
Construct a DirFile from a directory name and a file name.


DirFile

DirFile(DirFile directoryName,
        java.lang.String fileName)
Construct a DirFile from a directory name and a file name.

Method Detail

getParentDir

public org.apache.derby.io.StorageFile getParentDir()
Get the name of the parent directory if this name includes a parent.

Specified by:
getParentDir in interface org.apache.derby.io.StorageFile

getTempDir

static org.apache.derby.io.StorageFile getTempDir()
                                           throws java.io.IOException
Get the name of the directory of temporary files.


getOutputStream

public java.io.OutputStream getOutputStream()
                                     throws java.io.FileNotFoundException
Creates an output stream from a file name.

Specified by:
getOutputStream in interface org.apache.derby.io.StorageFile

getOutputStream

public java.io.OutputStream getOutputStream(boolean append)
                                     throws java.io.FileNotFoundException
Creates an output stream from a file name.

Specified by:
getOutputStream in interface org.apache.derby.io.StorageFile

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.FileNotFoundException
Creates an input stream from a file name.

Specified by:
getInputStream in interface org.apache.derby.io.StorageFile

getExclusiveFileLock

public int getExclusiveFileLock()
Get an exclusive lock. This is used to ensure that two or more JVMs do not open the same database at the same time.

Specified by:
getExclusiveFileLock in interface org.apache.derby.io.StorageFile

releaseExclusiveFileLock

public void releaseExclusiveFileLock()
Release the resource associated with an earlier acquired exclusive lock

Specified by:
releaseExclusiveFileLock in interface org.apache.derby.io.StorageFile

getRandomAccessFile

public org.apache.derby.io.StorageRandomAccessFile getRandomAccessFile(java.lang.String mode)
                                                                throws java.io.FileNotFoundException
Get a random access (read/write) file.

Specified by:
getRandomAccessFile in interface org.apache.derby.io.StorageFile

renameTo

public boolean renameTo(org.apache.derby.io.StorageFile newName)
Rename the file denoted by this name. Note that StorageFile objects are immutable. This method renames the underlying file, it does not change this StorageFile object. The StorageFile object denotes the same name as before, however the exists() method will return false after the renameTo method executes successfully.

It is not specified whether this method will succeed if a file already exists under the new name.

Specified by:
renameTo in interface org.apache.derby.io.StorageFile

deleteAll

public boolean deleteAll()
Deletes the named file and, if it is a directory, all the files and directories it contains.

Specified by:
deleteAll in interface org.apache.derby.io.StorageFile