|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectbiz.c24.io.api.presentation.stream.ByteAlignedBitDataWriter
public class ByteAlignedBitDataWriter
Byte aligned data stream writer.
Provides the byte processing during its serialization.
Field Summary | |
---|---|
protected OutputStream |
stream
|
Constructor Summary | |
---|---|
ByteAlignedBitDataWriter(OutputStream out)
Constructor with underlied byte output stream. |
Method Summary | |
---|---|
protected int |
acquireLength(int length)
|
protected void |
checkLength(int limit,
int actual)
|
void |
close()
Closes this output stream and releases any system resources associated with this stream. |
void |
flush()
Flushes this output stream and forces any buffered output bytes to be written out. |
void |
write(byte[] data,
int length)
Writes len bytes from the specified byte array
starting at offset off to this output stream. |
void |
writeByte(byte data,
int length)
Writes one byte into an output stream. |
void |
writeInteger(int data,
int length)
Writes fourth bytes into an output stream. |
void |
writeLong(long data,
int length)
Writes eights bytes into an output stream. |
protected void |
writePrimitives(long data,
int length)
Write data into output stream. |
void |
writeShort(short data,
int length)
Writes two bytes into an output stream. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected OutputStream stream
Constructor Detail |
---|
public ByteAlignedBitDataWriter(OutputStream out)
out
- the underlying output stream.
IllegalArgumentException
- if underlying input stream is NULL.Method Detail |
---|
public void writeByte(byte data, int length) throws IOException
write..()
method with same length specified.
data
- the data.length
- the number of bits to write (allowed values 1..8).
IllegalArgumentException
- if specified length is
below or equals to 0 or greater than 8.
IOException
- if an I/O error occurs.write(byte[], int)
public void writeShort(short data, int length) throws IOException
write..()
method with same length specified.
data
- the data.length
- the number of bits to write (allowed values 1..16).
IllegalArgumentException
- if specified length is
below or equals to 0 or greater than 16.
IOException
- if an I/O error occurs.writeByte(byte, int)
,
write(byte[], int)
public void writeInteger(int data, int length) throws IOException
write..()
method with same length specified.
data
- the data.length
- the number of bits to write (allowed values 1..32).
IllegalArgumentException
- if specified length is
below or equals to 0 or greater than 32.
IOException
- if an I/O error occurs.writeByte(byte, int)
,
writeShort(short, int)
,
write(byte[], int)
public void writeLong(long data, int length) throws IOException
write..()
method with same length specified.
data
- the data.length
- the number of bits to write (allowed values 1..64).
IllegalArgumentException
- if specified length is
below or equals to 0 or greater than 64.
IOException
- if an I/O error occurs.writeShort(short, int)
,
writeInteger(int, int)
,
write(byte[], int)
public void write(byte[] data, int length) throws IOException
len
bytes from the specified byte array
starting at offset off
to this output stream.
The general contract for write(b, off, len)
is that
some of the bytes in the array b
are written to the
output stream in order; element b[off]
is the first
byte written and b[off+len-1]
is the last byte written
by this operation.
The write
method of OutputStream
calls
the write method of one argument on each of the bytes to be
written out. Subclasses are encouraged to override this method and
provide a more efficient implementation.
If b
is null
, a
NullPointerException
is thrown.
If off
is negative, or len
is negative, or
off+len
is greater than the length of the array
b
, then an IndexOutOfBoundsException is thrown.
data
- the data.length
- the number of bits to write.
IOException
- if an I/O error occurs. In particular, an
IOException
is thrown if the output
stream is closed.public void flush() throws IOException
flush
is
that calling it is an indication that, if any bytes previously
written have been buffered by the implementation of the output
stream, such bytes should immediately be written to their
intended destination.
The flush
method of OutputStream
does nothing.
IOException
- if an I/O error occurs.public void close() throws IOException
close
is that it closes the output stream. A closed stream cannot perform
output operations and cannot be reopened.
The close
method of OutputStream
does nothing.
IOException
- if an I/O error occurs.protected int acquireLength(int length)
protected final void checkLength(int limit, int actual)
protected void writePrimitives(long data, int length) throws IOException
short
, int
and long
. Subclasses of this may override it to provide
the other byte ordering.
The general contract for this method is that the bytes in the
data are written to the output stream in network order (the
standard Java byte ordering) when highest byte is the first byte written
and lowest is the last byte written by this operation.
data
- the data to be written.length
- the number of bits that should be written.
IOException
- if an I/O error occurs.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |