Package db.buffers
Class BufferFileAdapter
java.lang.Object
db.buffers.BufferFileAdapter
- All Implemented Interfaces:
BufferFile
- Direct Known Subclasses:
ManagedBufferFileAdapter
BufferFileAdapter
provides a BufferFile implementation which
wraps a BufferFileHandle.-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Deletes all parametersvoid
close()
Close the buffer file.boolean
delete()
Delete this buffer file if writable.void
dispose()
Dispose of this buffer file object.get
(DataBuffer buf, int index) Get the specified buffer.int
Return the actual size of a user data buffer.int[]
Returns the list of free indexes sorted by value.int
Returns the number of allocated buffer indexes.int
getParameter
(String name) Get a the stored value for a named parameter.String[]
Returns a list of all parameter names.boolean
Returns true if this file may not be modified via the buffer put method.boolean
isRemote()
Determine if this file is remotely accessedvoid
put
(DataBuffer buf, int index) Store a data buffer at the specified block index.void
setFreeIndexes
(int[] indexes) Sets the list of free buffer indexes.void
setParameter
(String name, int value) Set the integer value for a named parameter.boolean
If file is open read-write, the modified contents are flushed and the file re-opened as read-only.
-
Constructor Details
-
BufferFileAdapter
Constructor.- Parameters:
remoteBufferFile
- remote buffer file handle
-
-
Method Details
-
getParameter
Description copied from interface:BufferFile
Get a the stored value for a named parameter.- Specified by:
getParameter
in interfaceBufferFile
- Parameters:
name
- parameter name- Returns:
- integer value
- Throws:
NoSuchElementException
- thrown if parameter not foundIOException
-
setParameter
Description copied from interface:BufferFile
Set the integer value for a named parameter.- Specified by:
setParameter
in interfaceBufferFile
- Parameters:
name
- parameter namevalue
- parameter value- Throws:
IOException
-
clearParameters
Description copied from interface:BufferFile
Deletes all parameters- Specified by:
clearParameters
in interfaceBufferFile
- Throws:
IOException
-
getParameterNames
Description copied from interface:BufferFile
Returns a list of all parameter names.- Specified by:
getParameterNames
in interfaceBufferFile
- Throws:
IOException
-
getBufferSize
Description copied from interface:BufferFile
Return the actual size of a user data buffer. This value should be used when constructing DataBuffer objects.- Specified by:
getBufferSize
in interfaceBufferFile
- Returns:
- DataBuffer data size as a number of bytes
- Throws:
IOException
- if an I/O error occurs
-
getIndexCount
Description copied from interface:BufferFile
Returns the number of allocated buffer indexes. When a new buffer is allocated, and the file size grows, the buffer will remain allocated although it may be added to the list of free-indexes. A file will never shrink in size due to this permanent allocation.- Specified by:
getIndexCount
in interfaceBufferFile
- Throws:
IOException
-
getFreeIndexes
Description copied from interface:BufferFile
Returns the list of free indexes sorted by value. The management of the free-index-list is implementation specific.- Specified by:
getFreeIndexes
in interfaceBufferFile
- Throws:
IOException
-
setFreeIndexes
Description copied from interface:BufferFile
Sets the list of free buffer indexes. The management of the free-index-list is implementation specific.- Specified by:
setFreeIndexes
in interfaceBufferFile
- Parameters:
indexes
-- Throws:
IOException
-
isReadOnly
Description copied from interface:BufferFile
Returns true if this file may not be modified via the buffer put method. A read-only file may be considered "updateable" if the canSave method returns true. The term "updateable" means that a Save file can be obtained via the getSaveFile method.- Specified by:
isReadOnly
in interfaceBufferFile
- Throws:
IOException
- if an I/O error occurs
-
setReadOnly
Description copied from interface:BufferFile
If file is open read-write, the modified contents are flushed and the file re-opened as read-only. This is also used to commit a new version if the file had been modified for update.- Specified by:
setReadOnly
in interfaceBufferFile
- Returns:
- true if successfully transitioned from read-write to read-only
- Throws:
IOException
- if an I/O error occurs
-
close
Description copied from interface:BufferFile
Close the buffer file. If the file was open for write access, all buffers are flushed and the file header updated. Once closed, this object is immediately disposed and may no longer be used.- Specified by:
close
in interfaceBufferFile
- Throws:
IOException
- if an I/O error occurs
-
delete
Description copied from interface:BufferFile
Delete this buffer file if writable. Once deleted, this object is immediately disposed and may no longer be used.- Specified by:
delete
in interfaceBufferFile
- Returns:
- true if deleted, false if the file is read-only
- Throws:
IOException
- if an I/O error occurs.
-
dispose
public void dispose()Description copied from interface:BufferFile
Dispose of this buffer file object. If file is not readOnly and has not been closed, an attempt will be made to delete the associated file(s). Once disposed, it may no longer be used.- Specified by:
dispose
in interfaceBufferFile
-
get
Description copied from interface:BufferFile
Get the specified buffer. DataBuffer data and flags are read from the file at index and stored within the supplied DataBuffer object. If the read buffer is empty, the DataBuffer's data field will remain unchanged (which could be null).- Specified by:
get
in interfaceBufferFile
- Parameters:
buf
- a buffer whose data array will be filled-in or replaced.index
- index of buffer to be read. First user buffer is at index 0.- Throws:
IOException
- if an I/O error occurs
-
put
Description copied from interface:BufferFile
Store a data buffer at the specified block index.- Specified by:
put
in interfaceBufferFile
- Parameters:
buf
- data bufferindex
- block index- Throws:
IOException
- thrown if an IO error occurs
-
isRemote
public boolean isRemote()Determine if this file is remotely accessed- Returns:
- true if file is remote
-