|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.helidb.lang.serializer.CharacterSerializer
public class CharacterSerializer
A Serializer
for Character
values. Every Character
value serialized by this object is represented as a byte array of
length two.
This object only serializes 16 bit char values. See
Character
for information on how to use 32 bit Unicode
characters.
This serializer does not handle null
values.
The singleton instance INSTANCE
may be used instead of creating a
new object of this class.
Character
,
CharacterNullSerializer
Field Summary | |
---|---|
static int |
DATA_SIZE
Two bytes. |
static CharacterSerializer |
INSTANCE
The singleton instance. |
Constructor Summary | |
---|---|
CharacterSerializer()
|
Method Summary | |
---|---|
static byte[] |
encodeCharacter(char c)
Encode a character to a two bytes long, big-endian byte array. |
static char |
getCharacter(byte[] barr)
Get the char value encoded in the big-endian, byte array. |
int |
getSerializedSize()
If the serialized data produced by this serializer always is of the same size, return that size (in number of bytes). |
Character |
interpret(byte[] barr)
Interpret the data in the byte array to an object of the type
handled by the Serializer implementation. |
Character |
interpret(byte[] barr,
int offset,
int length)
Interpret the data in the byte array to an object of the type
handled by the Serializer implementation. |
boolean |
isNullValuesPermitted()
Does this serializer permit null values? |
Character |
read(InputStream is,
int dataSize)
Read a value from the InputStream . |
Character |
read(RandomAccess ra,
int dataSize)
Read a value from the RandomAccess ' current position. |
Character |
readCharacter(InputStream is)
Read a Character value from the current position of the InputStream . |
Character |
readCharacter(RandomAccess ra)
Read a Character value from the current position of the RandomAccess . |
byte[] |
serialize(Character value)
Serialize the supplied object into a new byte array. |
int |
serialize(Character value,
byte[] barr,
int offset)
Serialize the supplied object into the byte array. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final CharacterSerializer INSTANCE
public static final int DATA_SIZE
Constructor Detail |
---|
public CharacterSerializer()
Method Detail |
---|
public Character interpret(byte[] barr, int offset, int length)
Serializer
byte
array to an object of the type
handled by the Serializer
implementation.
interpret
in interface Serializer<Character>
barr
- The byte
array containing the data.offset
- The start position of the data.length
- The length of the data.
Serializer.interpret(byte[])
public static char getCharacter(byte[] barr) throws SerializationException, NullPointerException
char
value encoded in the big-endian, byte array.
barr
- The byte array. It must be two bytes long and big-endian.
SerializationException
- If the array length is different from two
bytes.
NullPointerException
- If barr
is null
encodeCharacter(char)
public Character interpret(byte[] barr)
Serializer
byte
array to an object of the type
handled by the Serializer
implementation.
interpret
in interface Serializer<Character>
barr
- The byte
array containing the data.
Serializer.interpret(byte[], int, int)
public static byte[] encodeCharacter(char c)
c
- The char to encode.
public int serialize(Character value, byte[] barr, int offset)
Serializer
byte
array.
serialize
in interface Serializer<Character>
value
- The object to serialize.barr
- The byte array to serialize it to.offset
- The start position to write data at in the byte array.
public byte[] serialize(Character value)
Serializer
byte
array.
serialize
in interface Serializer<Character>
value
- The object to serialize.
byte
array.public int getSerializedSize()
Serializer
-1
is
returned.
getSerializedSize
in interface Serializer<Character>
public boolean isNullValuesPermitted()
Serializer
null
values?
isNullValuesPermitted
in interface Serializer<Character>
false
, always.public Character readCharacter(RandomAccess ra) throws NotEnoughDataException, WrappedIOException
Character
value from the current position of the RandomAccess
.
ra
- The RandomAccess
to read from. The current position of
this is incremented by 2 bytes.
Character
value.
NotEnoughDataException
- If 2 bytes cannot be
read.
WrappedIOException
- On I/O errors.public Character readCharacter(InputStream is) throws NotEnoughDataException, WrappedIOException
Character
value from the current position of the InputStream
.
is
- The InputStream
to read from. The current position of
the stream is incremented by 2 bytes.
Character
value.
NotEnoughDataException
- If 2 bytes cannot be
read.
WrappedIOException
- If an IOException
is encountered while
reading data.public Character read(RandomAccess ra, int dataSize)
Serializer
RandomAccess
' current position. The
position in the RandomAccess
is incremented by size
bytes.
read
in interface Serializer<Character>
ra
- The RandomAccess
to read from.dataSize
- The size of the value.
public Character read(InputStream is, int dataSize)
Serializer
InputStream
.
read
in interface Serializer<Character>
is
- The InputStream
to read from.dataSize
- The size of the value.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |