agilermi.utility.io

Interface RandomAccessService

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable, Remote

public interface RandomAccessService
extends java.io.Closeable, Remote

Remote interface used to access a random access file remotely. The server should use the RafToRas or another proper implementation of this interface to provide access to a random access file or to a similar data storage.

Author:

Salvatore Giampa'

Method Summary

Modifier and Type	Method and Description
void	close()
static RandomAccessService	convert(java.io.RandomAccessFile raf) Converts a RandomAccessFile to a remote RandomAccessService.
long	length() Same as RandomAccessFile.length().
boolean	readBoolean() Same as RandomAccessFile.readBoolean().
byte	readByte() Same as RandomAccessFile.readByte().
char	readChar() Same as RandomAccessFile.readChar().
double	readDouble() Same as RandomAccessFile.readDouble().
float	readFloat() Same as RandomAccessFile.readFloat().
byte[]	readFully(int len) Same as RandomAccessFile.readFully(byte[], int, int) but construct the byte[] result itself, instead of taking it as a parameter.
int	readInt() Same as RandomAccessFile.readInt().
java.lang.String	readLine() Same as RandomAccessFile.readLine().
long	readLong() Same as RandomAccessFile.readLong().
short	readShort() Same as RandomAccessFile.readShort().
int	readUnsignedByte() Same as RandomAccessFile.readUnsignedByte().
int	readUnsignedShort() Same as RandomAccessFile.readUnsignedShort().
java.lang.String	readUTF() Same as RandomAccessFile.readUTF().
void	seek(long pos) Same as RandomAccessFile.seek(long).
void	setLength(long newLength) Same as RandomAccessFile.setLength(long).
int	skipBytes(int n) Same as RandomAccessFile.skipBytes(int).
void	write(byte[] b) Same as RandomAccessFile.write(byte[]).
void	write(int b) Same as RandomAccessFile.write(int).
void	writeBoolean(boolean v) Same as RandomAccessFile.writeBoolean(boolean).
void	writeByte(int v) Same as RandomAccessFile.writeByte(int).
void	writeBytes(java.lang.String s) Same as RandomAccessFile.writeBytes(String).
void	writeChar(int v) Same as RandomAccessFile.writeChar(int).
void	writeChars(java.lang.String s) Same as RandomAccessFile.writeChars(String).
void	writeDouble(double v) Same as RandomAccessFile.writeDouble(double).
void	writeFloat(float v) Same as RandomAccessFile.writeFloat(float).
void	writeInt(int v) Same as RandomAccessFile.writeInt(int).
void	writeLong(long v) Same as RandomAccessFile.writeLong(long).
void	writeShort(int v) Same as RandomAccessFile.writeShort(int).
void	writeUTF(java.lang.String s) Same as RandomAccessFile.writeUTF(String).

Method Detail

convert

static RandomAccessService convert(java.io.RandomAccessFile raf)

Converts a RandomAccessFile to a remote RandomAccessService.

Parameters:

raf - the RandomAccessFile to convert

Returns:

A RandomAccessService that wraps the given RandomAccessFile instance

readFully

byte[] readFully(int len)
          throws java.io.IOException,
                 RemoteException

Same as RandomAccessFile.readFully(byte[], int, int) but construct the byte[] result itself, instead of taking it as a parameter.

Parameters:

len - the max number of bytes to read

Returns:

the bytes read

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

skipBytes

int skipBytes(int n)
       throws java.io.IOException,
              RemoteException

Same as RandomAccessFile.skipBytes(int).

Parameters:

n - the number of bytes to be skipped.

Returns:

the actual number of bytes skipped.

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

readBoolean

boolean readBoolean()
             throws java.io.IOException,
                    RemoteException

Same as RandomAccessFile.readBoolean().

Returns:

the read value

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

readByte

byte readByte()
       throws java.io.IOException,
              RemoteException

Same as RandomAccessFile.readByte().

Returns:

the read value

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

readUnsignedByte

int readUnsignedByte()
              throws java.io.IOException,
                     RemoteException

Same as RandomAccessFile.readUnsignedByte().

Returns:

the read value

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

readShort

short readShort()
         throws java.io.IOException,
                RemoteException

Same as RandomAccessFile.readShort().

Returns:

the read value

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

readUnsignedShort

int readUnsignedShort()
               throws java.io.IOException,
                      RemoteException

Same as RandomAccessFile.readUnsignedShort().

Returns:

the read value

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

readChar

char readChar()
       throws java.io.IOException,
              RemoteException

Same as RandomAccessFile.readChar().

Returns:

the read value

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

readInt

int readInt()
     throws java.io.IOException,
            RemoteException

Same as RandomAccessFile.readInt().

Returns:

the read value

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

readLong

long readLong()
       throws java.io.IOException,
              RemoteException

Same as RandomAccessFile.readLong().

Returns:

the read value

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

readFloat

float readFloat()
         throws java.io.IOException,
                RemoteException

Same as RandomAccessFile.readFloat().

Returns:

the read value

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

readDouble

double readDouble()
           throws java.io.IOException,
                  RemoteException

Same as RandomAccessFile.readDouble().

Returns:

the read value

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

readLine

java.lang.String readLine()
                   throws java.io.IOException,
                          RemoteException

Same as RandomAccessFile.readLine().

Returns:

the read value

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

readUTF

java.lang.String readUTF()
                  throws java.io.IOException,
                         RemoteException

Same as RandomAccessFile.readUTF().

Returns:

the read value

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

write

void write(int b)
    throws java.io.IOException,
           RemoteException

Same as RandomAccessFile.write(int).

Parameters:

b - the byte to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

write

void write(byte[] b)
    throws java.io.IOException,
           RemoteException

Same as RandomAccessFile.write(byte[]).

Parameters:

b - the bytes to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

writeBoolean

void writeBoolean(boolean v)
           throws java.io.IOException,
                  RemoteException

Same as RandomAccessFile.writeBoolean(boolean).

Parameters:

v - the value to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

writeByte

void writeByte(int v)
        throws java.io.IOException,
               RemoteException

Same as RandomAccessFile.writeByte(int).

Parameters:

v - the value to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

writeShort

void writeShort(int v)
         throws java.io.IOException,
                RemoteException

Same as RandomAccessFile.writeShort(int).

Parameters:

v - the value to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

writeChar

void writeChar(int v)
        throws java.io.IOException,
               RemoteException

Same as RandomAccessFile.writeChar(int).

Parameters:

v - the integer to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

writeInt

void writeInt(int v)
       throws java.io.IOException,
              RemoteException

Same as RandomAccessFile.writeInt(int).

Parameters:

v - the integer to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

writeLong

void writeLong(long v)
        throws java.io.IOException,
               RemoteException

Same as RandomAccessFile.writeLong(long).

Parameters:

v - the integer to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

writeFloat

void writeFloat(float v)
         throws java.io.IOException,
                RemoteException

Same as RandomAccessFile.writeFloat(float).

Parameters:

v - the integer to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

writeDouble

void writeDouble(double v)
          throws java.io.IOException,
                 RemoteException

Same as RandomAccessFile.writeDouble(double).

Parameters:

v - the integer to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

writeBytes

void writeBytes(java.lang.String s)
         throws java.io.IOException,
                RemoteException

Same as RandomAccessFile.writeBytes(String).

Parameters:

s - the string to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

writeChars

void writeChars(java.lang.String s)
         throws java.io.IOException,
                RemoteException

Same as RandomAccessFile.writeChars(String).

Parameters:

s - the string to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

writeUTF

void writeUTF(java.lang.String s)
       throws java.io.IOException,
              RemoteException

Same as RandomAccessFile.writeUTF(String).

Parameters:

s - the string to write

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

seek

void seek(long pos)
   throws java.io.IOException,
          RemoteException

Same as RandomAccessFile.seek(long).

Parameters:

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

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

length

long length()
     throws java.io.IOException,
            RemoteException

Same as RandomAccessFile.length().

Returns:

the length of this file, measured in bytes.

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

setLength

void setLength(long newLength)
        throws java.io.IOException,
               RemoteException

Same as RandomAccessFile.setLength(long).

Parameters:

newLength - The desired length of the file

Throws:

java.io.IOException - if an I/O error occurs.

RemoteException - if a RMI failure occurs

close

void close()
    throws java.io.IOException

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Throws:

java.io.IOException