public class WrapperBufferOutput extends Base implements WriteBuffer.BufferOutput
Modifier and Type | Class and Description |
---|---|
static class |
WrapperBufferOutput.VersionAwareBufferOutput
A BufferOutput implementation that in addition to delegating to the given
DataOutput provides an API to check whether the recipients of the content
of this BufferOutput run versions that supersede (greater or equal to)
the specified version.
|
Base.LoggingWriter, Base.StackFrame
LOG_ALWAYS, LOG_DEBUG, LOG_ERR, LOG_INFO, LOG_MAX, LOG_MIN, LOG_QUIET, LOG_WARN, POWER_0, POWER_G, POWER_K, POWER_M, POWER_T, UNIT_D, UNIT_H, UNIT_M, UNIT_MS, UNIT_NS, UNIT_S, UNIT_US
MAX_PACKED_INT_SIZE, MAX_PACKED_LONG_SIZE
Constructor and Description |
---|
WrapperBufferOutput(DataOutput out)
Construct a WrapperBufferOutput that will write to the specified object
implementing the DataOutput interface.
|
Modifier and Type | Method and Description |
---|---|
void |
close()
Close the OutputStream and release any system resources associated
with it.
|
void |
flush()
Flushes this OutputStream and forces any buffered output bytes to be
written.
|
WriteBuffer |
getBuffer()
Get the WriteBuffer object that this BufferOutput is writing to.
|
DataOutput |
getDataOutput()
Obtain the underlying object providing the DataOutput interface that
this object is delegating to.
|
int |
getOffset()
Determine the current offset of this BufferOutput within the
underlying WriteBuffer.
|
void |
setOffset(int of)
Specify the offset of the next byte to write to the underlying
WriteBuffer.
|
void |
write(byte[] ab)
Writes all the bytes in the array
ab . |
void |
write(byte[] ab,
int of,
int cb)
Writes
cb bytes starting at offset of from
the array ab . |
void |
write(int b)
Writes the eight low-order bits of the argument
b . |
void |
writeBoolean(boolean f)
Writes the boolean value f.
|
void |
writeBuffer(ReadBuffer buf)
Write all the bytes from the passed ReadBuffer object.
|
void |
writeBuffer(ReadBuffer buf,
int of,
int cb)
Write
cb bytes from the passed ReadBuffer object
starting at offset of within the passed ReadBuffer. |
void |
writeByte(int b)
Writes the eight low-order bits of the argument b.
|
void |
writeBytes(String s)
Writes the String s, but only the low-order byte from each
character of the String is written.
|
void |
writeChar(int n)
Writes a char value, comprised of the 16 low-order bits of the
argument ch; the 16 high-order bits of ch are
ignored.
|
void |
writeChars(String s)
Writes the String s as a sequence of characters.
|
void |
writeDouble(double dfl)
Writes a double value.
|
void |
writeFloat(float fl)
Writes a float value.
|
void |
writeInt(int n)
Writes an int value.
|
void |
writeLong(long l)
Writes a long value.
|
void |
writePackedInt(int n)
Write an int value using a variable-length storage-format.
|
void |
writePackedLong(long l)
Write a long value using a variable-length storage-format.
|
void |
writeSafeUTF(String s)
Write a variable-length encoded UTF packed String.
|
void |
writeShort(int n)
Writes a short value, comprised of the 16 low-order bits of the
argument n; the 16 high-order bits of n are
ignored.
|
void |
writeStream(InputStreaming stream)
Write the remaining contents of the specified InputStreaming
object.
|
void |
writeStream(InputStreaming stream,
int cb)
Write the specified number of bytes of the specified InputStreaming
object.
|
void |
writeUTF(String s)
Writes the String s as a sequence of characters, but using
UTF-8 encoding for the characters, and including the String length
data so that the corresponding
DataInput.readUTF()
method can reconstitute a String from the written data. |
azzert, azzert, azzert, azzertFailed, breakLines, breakLines, capitalize, checkNotEmpty, checkNotNull, checkRange, computeSafeWaitTime, decimalValue, dup, dup, ensureBigDecimal, ensureClassLoader, ensureRuntimeException, ensureRuntimeException, equals, equalsDeep, err, err, err, err, err, escape, formatDateTime, getCallerStackFrame, getCommonMonitor, getCommonMonitor, getCommonMonitor, getContextClassLoader, getContextClassLoader, getDeepMessage, getErr, getLastSafeTimeMillis, getLog, getMaxDecDigits, getMaxHexDigits, getOriginalException, getOut, getRandom, getRandomBinary, getRandomBinary, getRandomString, getSafeTimeMillis, getStackFrame, getStackFrames, getStackTrace, getStackTrace, getStackTrace, getThreadFactory, getTimeZone, getUpTimeMillis, hashCode, hexValue, indentString, indentString, isDecimal, isHex, isLogEcho, isOctal, log, log, log, log, log, makeInteger, makeLong, makeThread, mergeArray, mergeBooleanArray, mergeByteArray, mergeCharArray, mergeDoubleArray, mergeFloatArray, mergeIntArray, mergeLongArray, mod, mod, octalValue, out, out, out, out, out, pad, parseBandwidth, parseBandwidth, parseDelimitedString, parseHex, parseHex, parseMemorySize, parseMemorySize, parsePercentage, parseTime, parseTime, parseTimeNanos, parseTimeNanos, printStackTrace, randomize, randomize, randomize, randomize, read, read, read, read, read, read, read, replace, setErr, setLog, setLogEcho, setOut, sleep, toBandwidthString, toBandwidthString, toCharEscape, toCrc, toCrc, toCrc, toCrc, toCrc, toDecString, toDelimitedString, toDelimitedString, toDelimitedString, toDelimitedString, toHex, toHex, toHexDump, toHexEscape, toHexEscape, toHexEscape, toHexEscape, toHexString, toMemorySizeString, toMemorySizeString, toQuotedCharEscape, toQuotedStringEscape, toSqlString, toString, toString, toStringEscape, toUnicodeEscape, trace, trace, trace, trace, trace, trace, trace, trace, trace, truncateString, truncateString, wait
public WrapperBufferOutput(DataOutput out)
out
- an object implementing DataOutput to write topublic void write(int b) throws IOException
b
. The 24
high-order bits of b
are ignored.write
in interface com.oracle.common.io.OutputStreaming
write
in interface DataOutput
b
- the byte to write (passed as an integer)IOException
- if an I/O error occurspublic void write(byte[] ab) throws IOException
ab
.write
in interface com.oracle.common.io.OutputStreaming
write
in interface DataOutput
ab
- the byte array to writeIOException
- if an I/O error occurspublic void write(byte[] ab, int of, int cb) throws IOException
cb
bytes starting at offset of
from
the array ab
.write
in interface com.oracle.common.io.OutputStreaming
write
in interface DataOutput
ab
- the byte array to write fromof
- the offset into ab
to start writing fromcb
- the number of bytes from ab
to writeIOException
- if an I/O error occurspublic void flush() throws IOException
flush
in interface com.oracle.common.io.OutputStreaming
IOException
- if an I/O error occurspublic void close() throws IOException
BufferOutput implementations do not pass this call down onto an underlying stream, if any.
close
in interface com.oracle.common.io.OutputStreaming
close
in interface WriteBuffer.BufferOutput
IOException
- if an I/O error occurspublic void writeBoolean(boolean f) throws IOException
writeBoolean
in interface WriteBuffer.BufferOutput
writeBoolean
in interface DataOutput
f
- the boolean to be writtenIOException
- if an I/O error occurspublic void writeByte(int b) throws IOException
writeByte
in interface WriteBuffer.BufferOutput
writeByte
in interface DataOutput
b
- the byte to write (passed as an integer)IOException
- if an I/O error occurspublic void writeShort(int n) throws IOException
writeShort
in interface WriteBuffer.BufferOutput
writeShort
in interface DataOutput
n
- the short to write (passed as an integer)IOException
- if an I/O error occurspublic void writeChar(int n) throws IOException
writeChar
in interface WriteBuffer.BufferOutput
writeChar
in interface DataOutput
n
- the char to write (passed as an integer)IOException
- if an I/O error occurspublic void writeInt(int n) throws IOException
writeInt
in interface WriteBuffer.BufferOutput
writeInt
in interface DataOutput
n
- the int to writeIOException
- if an I/O error occurspublic void writeLong(long l) throws IOException
writeLong
in interface WriteBuffer.BufferOutput
writeLong
in interface DataOutput
l
- the long to writeIOException
- if an I/O error occurspublic void writeFloat(float fl) throws IOException
writeFloat
in interface WriteBuffer.BufferOutput
writeFloat
in interface DataOutput
fl
- the float to writeIOException
- if an I/O error occurspublic void writeDouble(double dfl) throws IOException
writeDouble
in interface WriteBuffer.BufferOutput
writeDouble
in interface DataOutput
dfl
- the double to writeIOException
- if an I/O error occurspublic void writeBytes(String s) throws IOException
writeBytes
in interface WriteBuffer.BufferOutput
writeBytes
in interface DataOutput
s
- the String to writeIOException
- if an I/O error occurspublic void writeChars(String s) throws IOException
writeChars
in interface WriteBuffer.BufferOutput
writeChars
in interface DataOutput
s
- the String to writeIOException
- if an I/O error occurspublic void writeUTF(String s) throws IOException
DataInput.readUTF()
method can reconstitute a String from the written data.writeUTF
in interface WriteBuffer.BufferOutput
writeUTF
in interface DataOutput
s
- the String to writeIOException
- if an I/O error occurspublic WriteBuffer getBuffer()
getBuffer
in interface WriteBuffer.BufferOutput
public void writeSafeUTF(String s) throws IOException
The binary format for a Safe UTF value is a "packed int" for the binary length followed by the UTF-encoded byte stream. The length is either -1 (indicating a null String) or in the range 0 .. Integer.MAX_VALUE (inclusive). The UTF-encoded portion uses a format identical to DataOutput.
writeSafeUTF
in interface WriteBuffer.BufferOutput
s
- a String value to write; may be nullIOException
- if an I/O error occurspublic void writePackedInt(int n) throws IOException
The format differs from DataOutput in that DataOutput always uses a fixed-length 4-byte Big Endian binary format for int values. The "packed" format includes a sign bit (0x40) and a continuation bit (0x80) in the first byte, followed by the least 6 significant bits of the int value. Subsequent bytes (each appearing only if the previous byte had its continuation bit set) include a continuation bit (0x80) and the next least 7 significant bits of the int value. In this way, a 32-bit value is encoded into 1-5 bytes, depending on the magnitude of the int value being encoded.
writePackedInt
in interface WriteBuffer.BufferOutput
n
- an int value to writeIOException
- if an I/O error occurspublic void writePackedLong(long l) throws IOException
The format differs from DataOutput in that DataOutput always uses a fixed-length 8-byte Big Endian binary format for long values. The "packed" format includes a sign bit (0x40) and a continuation bit (0x80) in the first byte, followed by the least 6 significant bits of the long value. Subsequent bytes (each appearing only if the previous byte had its continuation bit set) include a continuation bit (0x80) and the next least 7 significant bits of the long value. In this way, a 64-bit value is encoded into 1-10 bytes, depending on the magnitude of the long value being encoded.
writePackedLong
in interface WriteBuffer.BufferOutput
l
- a long value to writeIOException
- if an I/O error occurspublic void writeBuffer(ReadBuffer buf) throws IOException
This is functionally equivalent to the following code:
getBuffer().write(getOffset(), buf);
writeBuffer
in interface WriteBuffer.BufferOutput
buf
- a ReadBuffer objectIOException
- if an I/O error occurspublic void writeBuffer(ReadBuffer buf, int of, int cb) throws IOException
cb
bytes from the passed ReadBuffer object
starting at offset of
within the passed ReadBuffer.
This is functionally equivalent to the following code:
getBuffer().write(getOffset(), buf, of, cb);
writeBuffer
in interface WriteBuffer.BufferOutput
buf
- a ReadBuffer objectof
- the offset within the ReadBuffer of the first byte to
write to this BufferOutputcb
- the number of bytes to writeIOException
- if an I/O error occurspublic void writeStream(InputStreaming stream) throws IOException
This is functionally equivalent to the following code:
getBuffer().write(getOffset(), stream);
writeStream
in interface WriteBuffer.BufferOutput
stream
- the stream of bytes to write to this BufferOutputIOException
- if an I/O error occurs, specifically if an
IOException occurs reading from the passed streampublic void writeStream(InputStreaming stream, int cb) throws IOException
This is functionally equivalent to the following code:
getBuffer().write(getOffset(), stream, cb);
writeStream
in interface WriteBuffer.BufferOutput
stream
- the stream of bytes to write to this BufferOutputcb
- the exact number of bytes to read from the stream
and write to this BufferOutputEOFException
- if the stream is exhausted before
the number of bytes indicated could be readIOException
- if an I/O error occurs, specifically if an
IOException occurs reading from the passed streampublic int getOffset()
getOffset
in interface WriteBuffer.BufferOutput
public void setOffset(int of)
setOffset
in interface WriteBuffer.BufferOutput
of
- the offset of the next byte to write to the
WriteBufferpublic DataOutput getDataOutput()