/* This file is part of VoltDB.
* Copyright (C) 2008-2010 VoltDB Inc.
*
* VoltDB is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* VoltDB is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with VoltDB. If not, see <http://www.gnu.org/licenses/>.
*/
package org.voltdb.messaging;
import java.io.DataInput;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.lang.reflect.Array;
import java.math.BigDecimal;
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
import org.voltdb.types.TimestampType;
import org.voltdb.types.VoltDecimalHelper;
import org.voltdb.PrivateVoltTableFactory;
import org.voltdb.VoltTable;
import org.voltdb.VoltType;
/**
* <code>DataInputStream</code> subclass to read objects that implement
* the FastSerializable interface.
*
*/
public class FastDeserializer implements DataInput {
private static final int NULL_STRING_INDICATOR = -1;
/**
* Interface to monitor metrics and other information about the deserialization process
*
*/
public interface DeserializationMonitor {
public void deserializedBytes(int numBytes);
}
private ByteBuffer buffer;
/**
* Create a <code>FastDeserializer</code> from an array of bytes.
*
* @param in A byte array to wrap.
*/
public FastDeserializer(final byte[] in) {
buffer = ByteBuffer.wrap(in);
assert(buffer.order() == ByteOrder.BIG_ENDIAN);
}
public FastDeserializer(final byte[] in, ByteOrder order) {
buffer = ByteBuffer.wrap(in);
buffer.order(order);
}
/** Create a <code>FastDeserializer</code> from a ByteBuffer.
* @param in The ByteBuffer that will be part of this FastDeserializer. */
public FastDeserializer(final ByteBuffer in) {
buffer = in;
assert(buffer.order() == ByteOrder.BIG_ENDIAN);
}
public FastDeserializer() {
}
/**
* Hackishly set the internal ByteBuffer. This allows us to be able
* to re-use a single instance.
* @param in
*/
public FastDeserializer setBuffer(ByteBuffer in) {
this.buffer = in;
return (this);
}
/** Reset this FastDeserializer and make it ready for more reads. */
public void clear() {
buffer.clear();
}
/** @return The byte buffer contained in this object. */
public ByteBuffer buffer() { return buffer; }
/** @return the unread bytes from the contained byte buffer. */
public ByteBuffer remainder() { return buffer.slice(); }
/**
* Read an object from its byte array representation. This is a shortcut
* utility method useful when only a single object needs to be deserialized.
*
* @return The byte array representation for <code>object</code>.
*/
public final static <T extends FastSerializable> T deserialize(
final byte[] data, final Class<T> expectedType) throws IOException {
final FastDeserializer in = new FastDeserializer(data);
return in.readObject(expectedType);
}
public final static <T extends FastSerializable> T deserialize(
final ByteBuffer data, final Class<T> expectedType) throws IOException {
final FastDeserializer in = new FastDeserializer(data);
return in.readObject(expectedType);
}
/**
* Read an object from a a byte array stream assuming you know the expected type.
*
* @param expectedType The class of the type to be deserialized.
* @return A derserialized object.
* @throws IOException Rethrows any IOExceptions thrown.
*/
@SuppressWarnings("unchecked")
public <T extends FastSerializable> T readObject(final Class<T> expectedType) throws IOException {
assert(expectedType != null);
T obj = null;
try {
// Since VoltTable has no empty ctor, special case it
if (expectedType == VoltTable.class) {
obj = (T) PrivateVoltTableFactory.createUninitializedVoltTable();
}
else {
obj = expectedType.newInstance();
}
obj.readExternal(this);
} catch (final InstantiationException e) {
e.printStackTrace();
} catch (final IllegalAccessException e) {
e.printStackTrace();
}
return obj;
}
/**
* Read an object from a a byte array stream into th provied instance. Takes in a
* deserialization monitor which is notified of how many bytes were deserialized.
*
* @param obj Instance of the class of the type to be deserialized.
* @param monitor Monitor that will be notified of how many bytes are deserialized
* @return A deserialized object.
* @throws IOException Rethrows any IOExceptions thrown.
*/
public FastSerializable readObject(final FastSerializable obj, final DeserializationMonitor monitor) throws IOException {
final int startPosition = buffer.position();
obj.readExternal(this);
final int endPosition = buffer.position();
if (monitor != null) {
monitor.deserializedBytes(endPosition - startPosition);
}
return obj;
}
/**
* Read a timestamp from the stream. Timestamps are stored as a long
* value representing microseconds since the epoch.
* @return The {@link org.voltdb.types.TimestampType TimestampType}
* object read from the stream.
* @throws IOException Rethrows any IOExceptions.
*/
public TimestampType readTimestamp() throws IOException {
final long val = readLong();
return new TimestampType(val);
}
/**
* Read a string in the standard VoltDB way without
* wrapping the byte buffer[
*/
public static String readString(ByteBuffer buffer) throws IOException {
final int NULL_STRING_INDICATOR = -1;
final int len = buffer.getInt();
// check for null string
if (len == NULL_STRING_INDICATOR)
return null;
assert len >= 0;
if (len > VoltType.MAX_VALUE_LENGTH) {
throw new IOException("Serializable strings cannot be longer then "
+ VoltType.MAX_VALUE_LENGTH + " bytes");
}
if (len < NULL_STRING_INDICATOR) {
throw new IOException("String length is negative " + len);
}
// now assume not null
final byte[] strbytes = new byte[len];
buffer.get(strbytes);
String retval = null;
try {
retval = new String(strbytes, "UTF-8");
} catch (final UnsupportedEncodingException e) {
e.printStackTrace();
}
return retval;
}
/**
* Read a string in the standard VoltDB way. That is, two
* bytes of length info followed by the bytes of characters
* encoded in UTF-8.
*
* @return The String value read from the stream.
* @throws IOException Rethrows any IOExceptions.
*/
public String readString() throws IOException {
final int len = readInt();
// check for null string
if (len == NULL_STRING_INDICATOR)
return null;
assert len >= 0;
if (len > VoltType.MAX_VALUE_LENGTH) {
throw new IOException("Serializable strings cannot be longer then "
+ VoltType.MAX_VALUE_LENGTH + " bytes");
}
if (len < NULL_STRING_INDICATOR) {
throw new IOException("String length is negative " + len);
}
// now assume not null
final byte[] strbytes = new byte[len];
buffer.get(strbytes);
String retval = null;
try {
retval = new String(strbytes, "UTF-8");
} catch (final UnsupportedEncodingException e) {
e.printStackTrace();
}
return retval;
}
/**
* Read the VoltDB BigDecimal serialization.
* @return BigDecimal
* @throws IOException
*/
public BigDecimal readBigDecimal() throws IOException {
return VoltDecimalHelper.deserializeBigDecimal(this);
}
/**
* Read the VoltDB BigDecimal serialization.
* @return BigDecimal
* @throws IOException
*/
public BigDecimal readBigDecimalFromString() throws IOException {
return VoltDecimalHelper.deserializeBigDecimalFromString(this.readString());
}
public Object readArray(final Class<?> type) throws IOException {
final int count = type == byte.class ? readInt() : readShort();
if (count < 0) {
throw new IOException("Array length is negative " + count);
}
if (type == byte.class) {
if (count > (1024 * 1024)) {
throw new IOException("Array length is greater then the max of 1 megabyte " + count);
}
}
if (type == byte.class) {
final byte[] retval = new byte[count];
for (int i = 0; i < count; i++) {
retval[i] = readByte();
}
return retval;
}
if (type == Byte.class) {
final Byte[] retval = new Byte[count];
for (int i = 0; i < count; i++) {
retval[i] = readByte();
}
return retval;
}
if (type == short.class) {
final short[] retval = new short[count];
for (int i = 0; i < count; i++) {
retval[i] = readShort();
}
return retval;
}
if (type == Short.class) {
final Short[] retval = new Short[count];
for (int i = 0; i < count; i++) {
retval[i] = readShort();
}
return retval;
}
if (type == int.class) {
final int[] retval = new int[count];
for (int i = 0; i < count; i++)
retval[i] = readInt();
return retval;
}
if (type == Integer.class) {
final Integer[] retval = new Integer[count];
for (int i = 0; i < count; i++)
retval[i] = readInt();
return retval;
}
if (type == long.class) {
final long[] retval = new long[count];
for (int i = 0; i < count; i++)
retval[i] = readLong();
return retval;
}
if (type == Long.class) {
final Long[] retval = new Long[count];
for (int i = 0; i < count; i++)
retval[i] = readLong();
return retval;
}
if (type == String.class) {
final String[] retval = new String[count];
for (int i = 0; i < count; i++)
retval[i] = readString();
return retval;
}
if (type == double.class) {
final double[] retval = new double[count];
for (int i = 0; i < count; i++)
retval[i] = readDouble();
return retval;
}
if (type == Double.class) {
final Double[] retval = new Double[count];
for (int i = 0; i < count; i++)
retval[i] = readDouble();
return retval;
}
if (type == TimestampType.class) {
final TimestampType[] retval = new TimestampType[count];
for (int i = 0; i < count; i++)
retval[i] = new TimestampType(readLong());
return retval;
}
if (type == BigDecimal.class) {
final BigDecimal[] retval = new BigDecimal[count];
for (int i = 0; i < count; ++i) {
retval[i] = readBigDecimal();
}
return retval;
}
if (type == boolean.class) {
final boolean[] retval = new boolean[count];
for (int i = 0; i < count; i++) {
retval[i] = readBoolean();
}
return retval;
}
// probably throws an exception if type is not fastserializable
@SuppressWarnings("unchecked")
final
Class<FastSerializable> cls = (Class<FastSerializable>) type;
final FastSerializable[] retval = (FastSerializable[])Array.newInstance(type, count);
for (int i = 0; i < count; i++)
retval[i] = readObject(cls);
return retval;
}
/**
* Create a copy of the first byteLen bytes of the underlying buffer.
* @param byteLen Number of bytes to copy
* @return ByteBuffer wrapping the copied data
*/
public ByteBuffer readBuffer(final int byteLen) {
final byte[] data = new byte[byteLen];
buffer.get(data);
return ByteBuffer.wrap(data);
}
@Override
public boolean readBoolean() throws IOException {
return buffer.get() > 0;
}
@Override
public byte readByte() throws IOException {
return buffer.get();
}
@Override
public char readChar() throws IOException {
return buffer.getChar();
}
@Override
public double readDouble() throws IOException {
return buffer.getDouble();
}
@Override
public float readFloat() throws IOException {
return buffer.getFloat();
}
@Override
public void readFully(final byte[] b) throws IOException {
buffer.get(b);
}
@Override
public void readFully(final byte[] b, final int off, final int len) throws IOException {
buffer.get(b, off, len);
}
@Override
public int readInt() throws IOException {
return buffer.getInt();
}
@Override
public String readLine() throws IOException {
throw new RuntimeException("FastDeserializer.readLine() not supported.");
}
@Override
public long readLong() throws IOException {
return buffer.getLong();
}
@Override
public short readShort() throws IOException {
return buffer.getShort();
}
@Override
public String readUTF() throws IOException {
throw new RuntimeException("FastDeserializer.readUTF() not supported.");
}
@Override
public int readUnsignedByte() throws IOException {
throw new RuntimeException("FastDeserializer.readUnsignedByte() not supported.");
}
@Override
public int readUnsignedShort() throws IOException {
throw new RuntimeException("FastDeserializer.readUnsignedShort() not supported.");
}
@Override
public int skipBytes(final int n) throws IOException {
for (int i=0; i < n; i++)
readByte();
return n;
}
/**
* return Current position within the underlying buffer, for self-comparison only.
*/
public int getPosition() {
return buffer.position();
}
}