/*
 * Copyright (c) 2008-2017, Hazelcast, Inc. All Rights Reserved.
 *
 * 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 com.hazelcast.internal.memory;

import com.hazelcast.internal.memory.impl.AlignmentAwareMemoryAccessor;
import com.hazelcast.internal.memory.impl.StandardMemoryAccessor;

/**
 * Types of {@link GlobalMemoryAccessor} implementations.
 */
public enum GlobalMemoryAccessorType {

    /**
     * Represents the standard {@link GlobalMemoryAccessor} which correctly handles only aligned memory access.
     * Requesting unaligned memory access from this instance will result in low-level JVM crash on
     * platforms which only support aligned access.
     *
     * @see StandardMemoryAccessor
     */
    STANDARD,

    /**
     * Represents the aligned {@link GlobalMemoryAccessor}, which checks for and handles unaligned memory access
     * by splitting a larger-size memory operation into several smaller-size ones
     * (which have finer-grained alignment requirements).
     *
     * @see AlignmentAwareMemoryAccessor
     */
    ALIGNMENT_AWARE,

    /**
     * Represents a {@link GlobalMemoryAccessor} which is either {@link #ALIGNMENT_AWARE} or {@link #STANDARD},
     * as appropriate to the underlying platform's architecture.
     * <p>
     * If the underlying platform supports unaligned memory access, it will match the standard
     * {@link GlobalMemoryAccessor} because there's no need for aligmnent checks.
     * Otherwise it will match the alignment-aware {@link GlobalMemoryAccessor}.
     */
    PLATFORM_AWARE,
}