/*
 * 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.
 */

#ifndef _DECAF_INTERNAL_NIO_FLOATARRAYBUFFER_H_
#define _DECAF_INTERNAL_NIO_FLOATARRAYBUFFER_H_

#include <decaf/nio/FloatBuffer.h>
#include <decaf/lang/exceptions/NullPointerException.h>
#include <decaf/lang/exceptions/IndexOutOfBoundsException.h>
#include <decaf/nio/BufferUnderflowException.h>
#include <decaf/nio/BufferOverflowException.h>
#include <decaf/nio/ReadOnlyBufferException.h>
#include <decaf/internal/util/ByteArrayAdapter.h>

#include <decaf/lang/Pointer.h>

namespace decaf {
namespace internal {
namespace nio {

    using decaf::internal::util::ByteArrayAdapter;

    class DECAF_API FloatArrayBuffer : public decaf::nio::FloatBuffer{
    private:

        // The reference array object that backs this buffer.
        decaf::lang::Pointer<ByteArrayAdapter> _array;

        // Offset into the array that we are to start from
        int offset;

        // Number of bytes to read past the offset, or Limit.
        int length;

        // Read / Write flag
        bool readOnly;

    public:

        /**
         * Creates a FloatArrayBuffer object that has its backing array allocated internally
         * and is then owned and deleted when this object is deleted.  The array is
         * initially created with all elements initialized to zero.
         *
         * @param size
         *      The size of the array, this is the limit we read and write to.
         * @param readOnly
         *      Boolean indicating if this buffer should be read-only, default as false.
         *
         * @throws IllegalArguementException if the capacity value is negative.
         */
        FloatArrayBuffer(int size, bool readOnly = false);

        /**
         * Creates a FloatArrayBuffer object that wraps the given array.  If the own flag
         * is set then it will delete this array when this object is deleted.
         *
         * @param array
         *      The actual array to wrap.
         * @param size
         *      The size of the given array.
         * @param offset
         *      The position that is this buffers start position.
         * @param length
         *      The limit of how many bytes into the array this Buffer can write.
         * @param readOnly
         *      Boolean indicating if this buffer should be read-only, default as false.
         *
         * @throws NullPointerException if buffer is NULL
         * @throws IndexOutOfBoundsException if offset is greater than array capacity.
         */
        FloatArrayBuffer(float* array, int size, int offset, int length, bool readOnly = false);

        /**
         * Creates a byte buffer that wraps the passed ByteArrayAdapter and
         * start at the given offset.  The capacity and limit of the new FloatArrayBuffer
         * will be that of the remaining capacity of the passed buffer.
         *
         * @param array
         *      The ByteArrayAdapter to wrap.
         * @param offset
         *      The position that is this buffers start position.
         * @param capacity
         *      The limit of how many bytes into the array this Buffer can write.
         * @param readOnly
         *      Boolean indicating if this buffer should be read-only, default as false.
         *
         * @throws NullPointerException if array is NULL
         * @throws IndexOutOfBoundsException if offset + length is greater than array size.
         */
        FloatArrayBuffer(const decaf::lang::Pointer<ByteArrayAdapter>& array, int offset, int capacity,
                         bool readOnly = false);

        /**
         * Create a FloatArrayBuffer that mirrors this one, meaning it shares a
         * reference to this buffers ByteArrayAdapter and when changes
         * are made to that data it is reflected in both.
         *
         * @param other
         *      The FloatArrayBuffer this one is to mirror.
         */
        FloatArrayBuffer(const FloatArrayBuffer& other);

        virtual ~FloatArrayBuffer();

    public:

        /**
         * {@inheritDoc}
         */
        virtual float* array();

        /**
         * {@inheritDoc}
         */
        virtual int arrayOffset();

        /**
         * {@inheritDoc}
         */
        virtual FloatBuffer* asReadOnlyBuffer() const;

        /**
         * {@inheritDoc}
         */
        virtual FloatBuffer& compact();

        /**
         * {@inheritDoc}
         */
        virtual FloatBuffer* duplicate();

        /**
         * {@inheritDoc}
         */
        virtual float get();

        /**
         * {@inheritDoc}
         */
        virtual float get(int index) const;

        /**
         * {@inheritDoc}
         */
        virtual bool hasArray() const {
            return true;
        }

        /**
         * {@inheritDoc}
         */
        virtual bool isReadOnly() const {
            return this->readOnly;
        }

        /**
         * {@inheritDoc}
         */
        virtual FloatBuffer& put(float value);

        /**
         * {@inheritDoc}
         */
        virtual FloatBuffer& put(int index, float value);

        /**
         * {@inheritDoc}
         */
        virtual FloatBuffer* slice() const;

    protected:

        /**
         * Sets this FloatArrayBuffer as Read-Only.
         *
         * @param value
         *      Boolean value, true if this buffer is to be read-only, false otherwise.
         */
        virtual void setReadOnly(bool value) {
            this->readOnly = value;
        }

    };

}}}

#endif /*_DECAF_INTERNAL_NIO_FLOATARRAYBUFFER_H_*/
