/* * 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 */ public class SequentialWriterOption { /** * 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. * * @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; } } }