/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.cassandra.io.util;
import java.nio.ByteBuffer;
import java.util.Objects;
import org.apache.cassandra.io.compress.BufferType;
SequentialWriter option
/**
* SequentialWriter option
*/
public class SequentialWriterOption
{
Default write option.
- buffer size: 64 KB
- buffer type: on heap
- trickle fsync: false
- trickle fsync byte interval: 10 MB
- finish on close: false
/**
* Default write option.
*
* <ul>
* <li>buffer size: 64 KB
* <li>buffer type: on heap
* <li>trickle fsync: false
* <li>trickle fsync byte interval: 10 MB
* <li>finish on close: false
* </ul>
*/
public static final SequentialWriterOption DEFAULT = SequentialWriterOption.newBuilder().build();
private final int bufferSize;
private final BufferType bufferType;
private final boolean trickleFsync;
private final int trickleFsyncByteInterval;
private final boolean finishOnClose;
private SequentialWriterOption(int bufferSize,
BufferType bufferType,
boolean trickleFsync,
int trickleFsyncByteInterval,
boolean finishOnClose)
{
this.bufferSize = bufferSize;
this.bufferType = bufferType;
this.trickleFsync = trickleFsync;
this.trickleFsyncByteInterval = trickleFsyncByteInterval;
this.finishOnClose = finishOnClose;
}
public static Builder newBuilder()
{
return new Builder();
}
public int bufferSize()
{
return bufferSize;
}
public BufferType bufferType()
{
return bufferType;
}
public boolean trickleFsync()
{
return trickleFsync;
}
public int trickleFsyncByteInterval()
{
return trickleFsyncByteInterval;
}
public boolean finishOnClose()
{
return finishOnClose;
}
Allocate buffer using set buffer type and buffer size.
Returns: allocated ByteBuffer
/**
* Allocate buffer using set buffer type and buffer size.
*
* @return allocated ByteBuffer
*/
public ByteBuffer allocateBuffer()
{
return bufferType.allocate(bufferSize);
}
public static class Builder
{
/* default buffer size: 64k */
private int bufferSize = 64 * 1024;
/* default buffer type: on heap */
private BufferType bufferType = BufferType.ON_HEAP;
/* default: no trickle fsync */
private boolean trickleFsync = false;
/* default tricle fsync byte interval: 10MB */
private int trickleFsyncByteInterval = 10 * 1024 * 1024;
private boolean finishOnClose = false;
/* construct throguh SequentialWriteOption.newBuilder */
private Builder() {}
public SequentialWriterOption build()
{
return new SequentialWriterOption(bufferSize, bufferType, trickleFsync,
trickleFsyncByteInterval, finishOnClose);
}
public Builder bufferSize(int bufferSize)
{
this.bufferSize = bufferSize;
return this;
}
public Builder bufferType(BufferType bufferType)
{
this.bufferType = Objects.requireNonNull(bufferType);
return this;
}
public Builder trickleFsync(boolean trickleFsync)
{
this.trickleFsync = trickleFsync;
return this;
}
public Builder trickleFsyncByteInterval(int trickleFsyncByteInterval)
{
this.trickleFsyncByteInterval = trickleFsyncByteInterval;
return this;
}
public Builder finishOnClose(boolean finishOnClose)
{
this.finishOnClose = finishOnClose;
return this;
}
}
}