io.timeandspace.smoothie.RarelyCalledAmortizedPerSegment Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of smoothie-map Show documentation

Map implementation with low footprint and no latency spikes

There is a newer version: 2.0.2

/*
 * Copyright (C) The SmoothieMap Authors
 *
 * Licensed 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 io.timeandspace.smoothie;

/**
 * For methods that are expected to be normally called less frequently than once per every ten
 * {@link SmoothieMap.Segment#SEGMENT_MAX_ALLOC_CAPACITY} / 2 .. SEGMENT_MAX_ALLOC_CAPACITY
 * (i. e. 24..48) point queries to a SmoothieMap or entries during iteration/stream operations. In
 * other words, methods with this annotation are expected to be normally called an order of
 * magnitude less frequently than methods annotated with {@link AmortizedPerSegment}.
 *
 * The performance of these methods is not important. Achieving zero allocations might still be
 * important in order to achieve overall SmoothieMap's zero allocation.
 *
 * @see AmortizedPerSegment
 */
@interface RarelyCalledAmortizedPerSegment {
}