|
|
|
Berkeley DB version 4.4.20 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.io.OutputStream com.sleepycat.util.FastOutputStream com.sleepycat.bind.tuple.TupleOutput
An OutputStream
with DataOutput
-like methods for
writing tuple fields. It is used by TupleBinding
.
This class has many methods that have the same signatures as methods in
the DataOutput
interface. The reason this class does not
implement DataOutput
is because it would break the interface
contract for those methods because of data format differences.
Signed numbers are stored in the buffer in MSB (most significant byte first) order with their sign bit (high-order bit) inverted to cause negative numbers to be sorted first when comparing values as unsigned byte arrays, as done in a database. Unsigned numbers, including characters, are stored in MSB order with no change to their sign bit.
Strings and character arrays are stored either as a fixed length array of unicode characters, where the length must be known by the application, or as a null-terminated UTF byte array.
Floats and doubles are stored in standard Java integer-bit representation (IEEE 754). Non-negative numbers are correctly ordered by numeric value. However, negative numbers are not correctly ordered; therefore, if you use negative floating point numbers in a key, you'll need to implement and configure a custom comparator to get correct numeric ordering.
Field Summary |
Fields inherited from class com.sleepycat.util.FastOutputStream |
DEFAULT_BUMP_SIZE, DEFAULT_INIT_SIZE |
Constructor Summary | |
TupleOutput()
Creates a tuple output object for writing a byte array of tuple data. |
|
TupleOutput(byte[] buffer)
Creates a tuple output object for writing a byte array of tuple data, using a given buffer. |
Method Summary | |
TupleOutput |
writeBoolean(boolean val)
Writes a boolean (one byte) unsigned value to the buffer, writing one if the value is true and zero if it is false. |
TupleOutput |
writeByte(int val)
Writes an signed byte (one byte) value to the buffer. |
TupleOutput |
writeBytes(char[] chars)
Writes the specified bytes to the buffer, converting each character to an unsigned byte value. |
TupleOutput |
writeBytes(String val)
Writes the specified bytes to the buffer, converting each character to an unsigned byte value. |
TupleOutput |
writeChar(int val)
Writes a char (two byte) unsigned value to the buffer. |
TupleOutput |
writeChars(char[] chars)
Writes the specified characters to the buffer, converting each character to a two byte unsigned value. |
TupleOutput |
writeChars(String val)
Writes the specified characters to the buffer, converting each character to a two byte unsigned value. |
TupleOutput |
writeDouble(double val)
Writes an signed double (eight byte) value to the buffer. |
TupleOutput |
writeFloat(float val)
Writes an signed float (four byte) value to the buffer. |
TupleOutput |
writeInt(int val)
Writes an signed int (four byte) value to the buffer. |
TupleOutput |
writeLong(long val)
Writes an signed long (eight byte) value to the buffer. |
TupleOutput |
writeShort(int val)
Writes an signed short (two byte) value to the buffer. |
TupleOutput |
writeString(char[] chars)
Writes the specified characters to the buffer, converting each character to UTF format. |
TupleOutput |
writeString(String val)
Writes the specified characters to the buffer, converting each character to UTF format, and adding a null terminator byte. |
TupleOutput |
writeUnsignedByte(int val)
Writes an unsigned byte (one byte) value to the buffer. |
TupleOutput |
writeUnsignedInt(long val)
Writes an unsigned int (four byte) value to the buffer. |
TupleOutput |
writeUnsignedShort(int val)
Writes an unsigned short (two byte) value to the buffer. |
Methods inherited from class com.sleepycat.util.FastOutputStream |
addSize, getBufferBytes, getBufferLength, getBufferOffset, makeSpace, reset, size, toByteArray, toString, toString, write, write, write, writeFast, writeFast, writeFast, writeTo |
Methods inherited from class java.io.OutputStream |
close, flush |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public TupleOutput()
public TupleOutput(byte[] buffer)
buffer
- is the byte array to use as the buffer.Method Detail |
public final TupleOutput writeBytes(String val)
TupleInput.readBytes(int)
.
Only characters with values below 0x100 may be written using this
method, since the high-order 8 bits of all characters are discarded.
val
- is the string containing the values to be written.
NullPointerException
- if the val parameter is null.public final TupleOutput writeChars(String val)
TupleInput.readChars(int)
.
val
- is the string containing the characters to be written.
NullPointerException
- if the val parameter is null.public final TupleOutput writeString(String val)
TupleInput.readString()
.
val
- is the string containing the characters to be written.
public final TupleOutput writeChar(int val)
TupleInput.readChar()
.
val
- is the value to write to the buffer.
public final TupleOutput writeBoolean(boolean val)
TupleInput.readBoolean()
.
val
- is the value to write to the buffer.
public final TupleOutput writeByte(int val)
TupleInput.readByte()
.
val
- is the value to write to the buffer.
public final TupleOutput writeShort(int val)
TupleInput.readShort()
.
val
- is the value to write to the buffer.
public final TupleOutput writeInt(int val)
TupleInput.readInt()
.
val
- is the value to write to the buffer.
public final TupleOutput writeLong(long val)
TupleInput.readLong()
.
val
- is the value to write to the buffer.
public final TupleOutput writeFloat(float val)
TupleInput.readFloat()
.
Float.floatToIntBits
is used to convert the signed float
value.
val
- is the value to write to the buffer.
public final TupleOutput writeDouble(double val)
TupleInput.readDouble()
.
Double.doubleToLongBits
is used to convert the signed
double value.
val
- is the value to write to the buffer.
public final TupleOutput writeBytes(char[] chars)
TupleInput.readBytes(int)
.
Only characters with values below 0x100 may be written using this
method, since the high-order 8 bits of all characters are discarded.
chars
- is the array of values to be written.
NullPointerException
- if the chars parameter is null.public final TupleOutput writeChars(char[] chars)
TupleInput.readChars(int)
.
chars
- is the array of characters to be written.
NullPointerException
- if the chars parameter is null.public final TupleOutput writeString(char[] chars)
TupleInput.readString(int)
or TupleInput.readString(char[])
.
chars
- is the array of characters to be written.
NullPointerException
- if the chars parameter is null.public final TupleOutput writeUnsignedByte(int val)
TupleInput.readUnsignedByte()
.
val
- is the value to write to the buffer.
public final TupleOutput writeUnsignedShort(int val)
TupleInput.readUnsignedShort()
.
val
- is the value to write to the buffer.
public final TupleOutput writeUnsignedInt(long val)
TupleInput.readUnsignedInt()
.
val
- is the value to write to the buffer.
|
Berkeley DB version 4.4.20 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |