com.sleepycat.bind.serial.SerialBase Maven / Gradle / Ivy
/*-
* Copyright (C) 2002, 2018, Oracle and/or its affiliates. All rights reserved.
*
* This file was distributed by Oracle as part of a version of Oracle Berkeley
* DB Java Edition made available at:
*
* http://www.oracle.com/technetwork/database/database-technologies/berkeleydb/downloads/index.html
*
* Please see the LICENSE file included in the top-level directory of the
* appropriate version of Oracle Berkeley DB Java Edition for a copy of the
* license and additional information.
*/
package com.sleepycat.bind.serial;
import com.sleepycat.util.FastOutputStream;
/**
* A base class for serial bindings creators that provides control over the
* allocation of the output buffer.
*
* Serial bindings append data to a {@link FastOutputStream} instance. This
* object has a byte array buffer that is resized when it is full. The
* reallocation of this buffer can be a performance factor for some
* applications using large objects. To manage this issue, the {@link
* #setSerialBufferSize} method may be used to control the initial size of the
* buffer, and the {@link #getSerialOutput} method may be overridden by
* subclasses to take over creation of the FastOutputStream object.
*
* @see Class Evolution
*
* @author Mark Hayes
*/
public class SerialBase {
private int outputBufferSize;
/**
* Initializes the initial output buffer size to zero.
*
* Unless {@link #setSerialBufferSize} is called, the default {@link
* FastOutputStream#DEFAULT_INIT_SIZE} size will be used.
*/
public SerialBase() {
outputBufferSize = 0;
}
/**
* Sets the initial byte size of the output buffer that is allocated by the
* default implementation of {@link #getSerialOutput}.
*
* If this property is zero (the default), the default {@link
* FastOutputStream#DEFAULT_INIT_SIZE} size is used.
*
* @param byteSize the initial byte size of the output buffer, or zero to
* use the default size.
*/
public void setSerialBufferSize(int byteSize) {
outputBufferSize = byteSize;
}
/**
* Returns the initial byte size of the output buffer.
*
* @return the initial byte size of the output buffer.
*
* @see #setSerialBufferSize
*/
public int getSerialBufferSize() {
return outputBufferSize;
}
/**
* Returns an empty SerialOutput instance that will be used by the serial
* binding or key creator.
*
* The default implementation of this method creates a new SerialOutput
* with an initial buffer size that can be changed using the {@link
* #setSerialBufferSize} method.
*
* This method may be overridden to return a FastOutputStream instance.
* For example, an instance per thread could be created and returned by
* this method. If a FastOutputStream instance is reused, be sure to call
* its {@link FastOutputStream#reset} method before each use.
*
* @param object is the object to be written to the serial output, and may
* be used by subclasses to determine the size of the output buffer.
*
* @return an empty FastOutputStream instance.
*
* @see #setSerialBufferSize
*/
protected FastOutputStream getSerialOutput(Object object) {
int byteSize = getSerialBufferSize();
if (byteSize != 0) {
return new FastOutputStream(byteSize);
} else {
return new FastOutputStream();
}
}
}