net.grinder.util

Class Serialiser

java.lang.Object

net.grinder.util.Serialiser

public class Serialiser
extends Object

Utility methods for efficient serialisation.

Author:

Philip Aston

Constructor Summary

Constructors

Constructor and Description
Serialiser()

Method Summary

Methods

Modifier and Type	Method and Description
double	readDouble(DataInput input) Read a double written by writeDouble(java.io.DataOutput, double).
long	readLong(DataInput input) Read a long written by writeLong(java.io.DataOutput, long).
long	readUnsignedLong(DataInput input) Read a long written by writeUnsignedLong(java.io.DataOutput, long).
void	writeDouble(DataOutput output, double l) Write a double to a stream in such a way it can be read by readDouble(java.io.DataInput).
void	writeLong(DataOutput output, long l) Write a long to a stream in such a way it can be read by readLong(java.io.DataInput).
void	writeUnsignedLong(DataOutput output, long l) Write a long to a stream in such a way it can be read by readUnsignedLong(java.io.DataInput).

Methods inherited from class java.lang.Object

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

Constructor Detail

Serialiser

public Serialiser()

Method Detail

writeUnsignedLong

public final void writeUnsignedLong(DataOutput output,
                     long l)
                             throws IOException

Write a long to a stream in such a way it can be read by readUnsignedLong(java.io.DataInput). The value of the long must be greater than zero. Values between 0 and 127 inclusive require only one byte. Other values require eight bytes.

Parameters:

output - The stream.

l - a long value

Throws:

IOException - If the stream raises an error.

readUnsignedLong

public final long readUnsignedLong(DataInput input)
                            throws IOException

Read a long written by writeUnsignedLong(java.io.DataOutput, long).

Parameters:

input - The stream.

Returns:

The value.

Throws:

IOException - If the stream raises an error.

writeLong

public final void writeLong(DataOutput output,
             long l)
                     throws IOException

Write a long to a stream in such a way it can be read by readLong(java.io.DataInput).

Efficient for small, positive longs. Values less than 16 take one byte. The worst cases (including all negative values) take nine bytes.

Parameters:

output - The stream.

l - Value to write.

Throws:

IOException - If the stream raises an error.

readLong

public final long readLong(DataInput input)
                    throws IOException

Read a long written by writeLong(java.io.DataOutput, long).

Parameters:

input - The stream.

Returns:

The value.

Throws:

IOException - If the stream raises an error.

writeDouble

public final void writeDouble(DataOutput output,
               double l)
                       throws IOException

Write a double to a stream in such a way it can be read by readDouble(java.io.DataInput).

Parameters:

output - The stream.

l - The value.

Throws:

IOException - If the stream raises an error.

readDouble

public final double readDouble(DataInput input)
                        throws IOException

Read a double written by writeDouble(java.io.DataOutput, double).

Parameters:

input - The stream.

Returns:

The value.

Throws:

IOException - If the stream raises an error.