/*
 * 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; } } }