Package org.apache.commons.vfs2.provider.local

Class LocalFileRandomAccessContent

java.lang.Object

org.apache.commons.vfs2.provider.AbstractRandomAccessContent

org.apache.commons.vfs2.provider.local.LocalFileRandomAccessContent

All Implemented Interfaces:

Closeable, DataInput, DataOutput, AutoCloseable, RandomAccessContent

final class LocalFileRandomAccessContent
extends AbstractRandomAccessContent

Implements RandomAccessContent for local files.

Field Summary

Fields

Modifier and Type	Field	Description
private static final int	BYTE_VALUE_MASK
private final RandomAccessFile	raf
private final InputStream	rafis

Constructor Summary

Constructors

Constructor	Description
LocalFileRandomAccessContent(File localFile, RandomAccessMode mode)

Method Summary

Modifier and Type	Method	Description
void	close()	Closes this random access file stream and releases any system resources associated with the stream.
long	getFilePointer()	Returns the current offset in this file.
InputStream	getInputStream()	Get the input stream.
long	length()	Returns the length of this file.
boolean	readBoolean()
byte	readByte()
char	readChar()
double	readDouble()
float	readFloat()
void	readFully(byte[] b)
void	readFully(byte[] b, int off, int len)
int	readInt()
long	readLong()
short	readShort()
int	readUnsignedByte()
int	readUnsignedShort()
String	readUTF()
void	seek(long pos)	Sets the file-pointer offset, measured from the beginning of this file, at which the next read or write occurs.
void	setLength(long newLength)	Sets the length of this content.
int	skipBytes(int n)
void	write(byte[] b)
void	write(byte[] b, int off, int len)
void	write(int b)
void	writeBoolean(boolean v)
void	writeByte(int v)
void	writeBytes(String s)
void	writeChar(int v)
void	writeChars(String s)
void	writeDouble(double v)
void	writeFloat(float v)
void	writeInt(int v)
void	writeLong(long v)
void	writeShort(int v)
void	writeUTF(String str)

Methods inherited from class org.apache.commons.vfs2.provider.AbstractRandomAccessContent

readLine

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

BYTE_VALUE_MASK

private static final int BYTE_VALUE_MASK

See Also:

• Constant Field Values

raf

private final RandomAccessFile raf

rafis

private final InputStream rafis

Constructor Details

LocalFileRandomAccessContent

LocalFileRandomAccessContent(File localFile,
 RandomAccessMode mode)
                      throws FileSystemException

Throws:

FileSystemException

Method Details

close

public void close()
           throws IOException

Description copied from interface: RandomAccessContent

Closes this random access file stream and releases any system resources associated with the stream.

A closed random access file cannot perform input or output operations and cannot be reopened.

If this file has an associated channel then the channel is closed as well.

Throws:

IOException - if an I/O error occurs.

getFilePointer

public long getFilePointer()
                    throws IOException

Description copied from interface: RandomAccessContent

Returns the current offset in this file.

Returns:

the offset from the beginning of the file, in bytes, at which the next read or write occurs.

Throws:

IOException - if an I/O error occurs.

getInputStream

public InputStream getInputStream()
                           throws IOException

Description copied from interface: RandomAccessContent

Get the input stream.

Notice: If you use RandomAccessContent.seek(long) you have to re-get the InputStream

Returns:

the InputStream.

Throws:

IOException - if an I/O error occurs.

length

public long length()
            throws IOException

Description copied from interface: RandomAccessContent

Returns the length of this file.

Returns:

the length of this file, measured in bytes.

Throws:

IOException - if an I/O error occurs.

readBoolean

public boolean readBoolean()
                    throws IOException

Throws:

IOException

readByte

public byte readByte()
              throws IOException

Throws:

IOException

readChar

public char readChar()
              throws IOException

Throws:

IOException

readDouble

public double readDouble()
                  throws IOException

Throws:

IOException

readFloat

public float readFloat()
                throws IOException

Throws:

IOException

readFully

public void readFully(byte[] b)
               throws IOException

Throws:

IOException

readFully

public void readFully(byte[] b,
 int off,
 int len)
               throws IOException

Throws:

IOException

readInt

public int readInt()
            throws IOException

Throws:

IOException

readLong

public long readLong()
              throws IOException

Throws:

IOException

readShort

public short readShort()
                throws IOException

Throws:

IOException

readUnsignedByte

public int readUnsignedByte()
                     throws IOException

Throws:

IOException

readUnsignedShort

public int readUnsignedShort()
                      throws IOException

Throws:

IOException

readUTF

public String readUTF()
               throws IOException

Throws:

IOException

seek

public void seek(long pos)
          throws IOException

Description copied from interface: RandomAccessContent

Sets the file-pointer offset, measured from the beginning of this file, at which the next read or write occurs.

The offset may be set beyond the end of the file. Setting the offset beyond the end of the file does not change the file length. The file length will change only by writing after the offset has been set beyond the end of the file.

Notice: If you use RandomAccessContent.getInputStream() you have to re-get the InputStream after calling RandomAccessContent.seek(long)

Parameters:

pos - the offset position, measured in bytes from the beginning of the file, at which to set the file pointer.

Throws:

IOException - if pos is less than 0 or if an I/O error occurs.

setLength

public void setLength(long newLength)
               throws IOException

Description copied from interface: RandomAccessContent

Sets the length of this content.

If the the newLength argument is smaller than RandomAccessContent.length(), the content is truncated.

If the the newLength argument is greater than RandomAccessContent.length(), the content grows with undefined data.

Parameters:

newLength - The desired content length

Throws:

IOException - If an I/O error occurs

skipBytes

public int skipBytes(int n)
              throws IOException

Throws:

IOException

write

public void write(byte[] b)
           throws IOException

Specified by:

write in interface DataOutput

Overrides:

write in class AbstractRandomAccessContent

Throws:

IOException

write

public void write(byte[] b,
 int off,
 int len)
           throws IOException

Specified by:

write in interface DataOutput

Overrides:

write in class AbstractRandomAccessContent

Throws:

IOException

write

public void write(int b)
           throws IOException

Specified by:

write in interface DataOutput

Overrides:

write in class AbstractRandomAccessContent

Throws:

IOException

writeBoolean

public void writeBoolean(boolean v)
                  throws IOException

Specified by:

writeBoolean in interface DataOutput

Overrides:

writeBoolean in class AbstractRandomAccessContent

Throws:

IOException

writeByte

public void writeByte(int v)
               throws IOException

Specified by:

writeByte in interface DataOutput

Overrides:

writeByte in class AbstractRandomAccessContent

Throws:

IOException

writeBytes

public void writeBytes(String s)
                throws IOException

Specified by:

writeBytes in interface DataOutput

Overrides:

writeBytes in class AbstractRandomAccessContent

Throws:

IOException

writeChar

public void writeChar(int v)
               throws IOException

Specified by:

writeChar in interface DataOutput

Overrides:

writeChar in class AbstractRandomAccessContent

Throws:

IOException

writeChars

public void writeChars(String s)
                throws IOException

Specified by:

writeChars in interface DataOutput

Overrides:

writeChars in class AbstractRandomAccessContent

Throws:

IOException

writeDouble

public void writeDouble(double v)
                 throws IOException

Specified by:

writeDouble in interface DataOutput

Overrides:

writeDouble in class AbstractRandomAccessContent

Throws:

IOException

writeFloat

public void writeFloat(float v)
                throws IOException

Specified by:

writeFloat in interface DataOutput

Overrides:

writeFloat in class AbstractRandomAccessContent

Throws:

IOException

writeInt

public void writeInt(int v)
              throws IOException

Specified by:

writeInt in interface DataOutput

Overrides:

writeInt in class AbstractRandomAccessContent

Throws:

IOException

writeLong

public void writeLong(long v)
               throws IOException

Specified by:

writeLong in interface DataOutput

Overrides:

writeLong in class AbstractRandomAccessContent

Throws:

IOException

writeShort

public void writeShort(int v)
                throws IOException

Specified by:

writeShort in interface DataOutput

Overrides:

writeShort in class AbstractRandomAccessContent

Throws:

IOException

writeUTF

public void writeUTF(String str)
              throws IOException

Specified by:

writeUTF in interface DataOutput

Overrides:

writeUTF in class AbstractRandomAccessContent

Throws:

IOException