/*
* Copyright (C) 2012, 2016 higherfrequencytrading.com
* Copyright (C) 2016 Roman Leventov
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License.
*
* This program 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
package net.openhft.chronicle.set;
import net.openhft.chronicle.hash.HashAbsentEntry;
import org.jetbrains.annotations.NotNull;
/**
* Low-level operational context for the situations, when the new key is going to be inserted
* into the {@link ChronicleSet}.
*
* @param <K> the set key type
*
* @see SetEntryOperations
* @see SetQueryContext#absentEntry()
*/
public interface SetAbsentEntry<K> extends HashAbsentEntry<K> {
@NotNull
@Override
SetContext<K, ?> context();
/**
* Inserts {@link #absentKey() the new key} into the set.
*
* <p>This method is the default implementation for {@link SetEntryOperations#insert(
* SetAbsentEntry)}, which might be customized over the default.
*
* @throws IllegalStateException if some locking/state conditions required to perform insertion
* operation are not met
* @see SetEntryOperations#insert(SetAbsentEntry)
*/
void doInsert();
}