You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by ta...@apache.org on 2007/12/01 15:35:01 UTC
svn commit: r600140 - in /activemq/activemq-cpp/decaf/trunk/src/main:
Makefile.am decaf/nio/LongBuffer.cpp decaf/nio/LongBuffer.h
decaf/nio/ShortBuffer.cpp decaf/nio/ShortBuffer.h
Author: tabish
Date: Sat Dec 1 06:35:00 2007
New Revision: 600140
URL: http://svn.apache.org/viewvc?rev=600140&view=rev
Log:
http://issues.apache.org/activemq/browse/AMQCPP-103
Working on the NIO package
Added:
activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/LongBuffer.cpp
activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/LongBuffer.h
activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/ShortBuffer.cpp
activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/ShortBuffer.h
Modified:
activemq/activemq-cpp/decaf/trunk/src/main/Makefile.am
Modified: activemq/activemq-cpp/decaf/trunk/src/main/Makefile.am
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/decaf/trunk/src/main/Makefile.am?rev=600140&r1=600139&r2=600140&view=diff
==============================================================================
--- activemq/activemq-cpp/decaf/trunk/src/main/Makefile.am (original)
+++ activemq/activemq-cpp/decaf/trunk/src/main/Makefile.am Sat Dec 1 06:35:00 2007
@@ -70,7 +70,12 @@
decaf/util/logging/LogManager.cpp \
decaf/nio/Buffer.cpp \
decaf/nio/ByteBuffer.cpp \
- decaf/nio/CharBuffer.cpp
+ decaf/nio/CharBuffer.cpp \
+ decaf/nio/DoubleBuffer.cpp \
+ decaf/nio/FloatBuffer.cpp \
+ decaf/nio/IntBuffer.cpp \
+ decaf/nio/LongBuffer.cpp \
+ decaf/nio/ShortBuffer.cpp
h_sources = \
decaf/net/BindException.h \
@@ -193,6 +198,11 @@
decaf/nio/Buffer.h \
decaf/nio/ByteBuffer.h \
decaf/nio/CharBuffer.h \
+ decaf/nio/DoubleBuffer.h \
+ decaf/nio/FloatBuffer.h \
+ decaf/nio/IntBuffer.h \
+ decaf/nio/LongBuffer.h \
+ decaf/nio/ShortBuffer.h \
decaf/nio/BufferOverflowException.h \
decaf/nio/BufferUnderflowException.h \
decaf/nio/InvalidMarkException.h \
Added: activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/LongBuffer.cpp
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/LongBuffer.cpp?rev=600140&view=auto
==============================================================================
--- activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/LongBuffer.cpp (added)
+++ activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/LongBuffer.cpp Sat Dec 1 06:35:00 2007
@@ -0,0 +1,252 @@
+/*
+ * 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.
+ */
+
+#include "LongBuffer.h"
+
+#include <decaf/lang/Long.h>
+#include <decaf/lang/Math.h>
+
+using namespace std;
+using namespace decaf;
+using namespace decaf::nio;
+using namespace decaf::lang;
+using namespace decaf::lang::exceptions;
+
+////////////////////////////////////////////////////////////////////////////////
+LongBuffer::LongBuffer( std::size_t capacity )
+ : Buffer( capacity ) {
+
+}
+
+////////////////////////////////////////////////////////////////////////////////
+std::string LongBuffer::toString() const {
+
+ std::string strbuf;
+
+ for( std::size_t i = this->position(); i < this->limit(); i++ ) {
+ strbuf.append( Long::valueOf( get( i ) ).toString() );
+ }
+
+ return strbuf;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+LongBuffer& LongBuffer::get( std::vector<long long> buffer )
+ throw ( BufferUnderflowException ) {
+
+ try{
+
+ if( !buffer.empty() ) {
+ this->get( &buffer[0], 0, buffer.size() );
+ }
+ return *this;
+ }
+ DECAF_CATCH_RETHROW( BufferUnderflowException )
+ DECAF_CATCH_EXCEPTION_CONVERT( Exception, BufferUnderflowException )
+ DECAF_CATCHALL_THROW( BufferUnderflowException )
+}
+
+////////////////////////////////////////////////////////////////////////////////
+LongBuffer& LongBuffer::get( long long* buffer, std::size_t offset, std::size_t length )
+ throw( BufferUnderflowException,
+ lang::exceptions::NullPointerException ) {
+
+ try{
+
+ if( length == 0 ) {
+ return *this;
+ }
+
+ if( buffer == NULL ) {
+ throw NullPointerException(
+ __FILE__, __LINE__,
+ "LongBuffer::get - Passed Buffer is Null" );
+ }
+
+ if( length > remaining() ) {
+ throw BufferUnderflowException(
+ __FILE__, __LINE__,
+ "LongBuffer::get - Not enough data to fill length = %d", length );
+ }
+
+ for( std::size_t ix = 0; ix < length; ++ix ){
+ buffer[offset + ix] = this->get();
+ }
+
+ return *this;
+ }
+ DECAF_CATCH_RETHROW( BufferUnderflowException )
+ DECAF_CATCH_EXCEPTION_CONVERT( Exception, BufferUnderflowException )
+ DECAF_CATCHALL_THROW( BufferUnderflowException )
+}
+
+////////////////////////////////////////////////////////////////////////////////
+LongBuffer& LongBuffer::put( LongBuffer& src )
+ throw( BufferOverflowException, ReadOnlyBufferException,
+ lang::exceptions::IllegalArgumentException ) {
+
+ try{
+
+ if( this == &src ) {
+ throw IllegalArgumentException(
+ __FILE__, __LINE__,
+ "LongBuffer::put - Can't put Self" );
+ }
+
+ if( this->isReadOnly() ) {
+ throw ReadOnlyBufferException(
+ __FILE__, __LINE__,
+ "LongBuffer::put - This buffer is Read Only.");
+ }
+
+ if( src.remaining() > this->remaining() ) {
+ throw BufferOverflowException(
+ __FILE__, __LINE__,
+ "LongBuffer::put - Not enough space remaining to put src." );
+ }
+
+ while( src.hasRemaining() ) {
+ this->put( src.get() );
+ }
+
+ return *this;
+ }
+ DECAF_CATCH_RETHROW( BufferOverflowException )
+ DECAF_CATCH_RETHROW( ReadOnlyBufferException )
+ DECAF_CATCH_RETHROW( IllegalArgumentException )
+ DECAF_CATCH_EXCEPTION_CONVERT( Exception, BufferOverflowException )
+ DECAF_CATCHALL_THROW( BufferOverflowException )
+}
+
+////////////////////////////////////////////////////////////////////////////////
+LongBuffer& LongBuffer::put( const long long* buffer, std::size_t offset, std::size_t length )
+ throw( BufferOverflowException, ReadOnlyBufferException,
+ lang::exceptions::NullPointerException ) {
+
+ try{
+
+ if( length == 0 ) {
+ return *this;
+ }
+
+ if( this->isReadOnly() ) {
+ throw ReadOnlyBufferException(
+ __FILE__, __LINE__,
+ "LongBuffer::put - This buffer is Read Only.");
+ }
+
+ if( buffer == NULL ) {
+ throw NullPointerException(
+ __FILE__, __LINE__,
+ "LongBuffer::put - Passed Buffer is Null.");
+ }
+
+ if( length > this->remaining() ) {
+ throw BufferOverflowException(
+ __FILE__, __LINE__,
+ "LongBuffer::put - Not Enough space to store requested Data.");
+ }
+
+ // read length bytes starting from the offset
+ for( std::size_t ix = 0; ix < length; ++ix ) {
+ this->put( buffer[ix + offset] );
+ }
+
+ return *this;
+ }
+ DECAF_CATCH_RETHROW( BufferOverflowException )
+ DECAF_CATCH_RETHROW( ReadOnlyBufferException )
+ DECAF_CATCH_RETHROW( NullPointerException )
+ DECAF_CATCH_EXCEPTION_CONVERT( Exception, BufferOverflowException )
+ DECAF_CATCHALL_THROW( BufferOverflowException )
+}
+
+////////////////////////////////////////////////////////////////////////////////
+LongBuffer& LongBuffer::put( std::vector<long long>& buffer )
+ throw( BufferOverflowException, ReadOnlyBufferException ) {
+
+ try{
+
+ if( !buffer.empty() ) {
+ this->put( &buffer[0], 0, buffer.size() );
+ }
+
+ return *this;
+ }
+ DECAF_CATCH_RETHROW( BufferOverflowException )
+ DECAF_CATCH_RETHROW( ReadOnlyBufferException )
+ DECAF_CATCH_EXCEPTION_CONVERT( Exception, BufferOverflowException )
+ DECAF_CATCHALL_THROW( BufferOverflowException )
+}
+
+////////////////////////////////////////////////////////////////////////////////
+int LongBuffer::compareTo( const LongBuffer& value ) const {
+
+ std::size_t compareRemaining = Math::min( remaining(), value.remaining() );
+
+ std::size_t thisPos = this->position();
+ std::size_t otherPos = value.position();
+ long long thisVal, otherVal;
+
+ while( compareRemaining > 0 ) {
+
+ thisVal = get( thisPos );
+ otherVal = value.get( otherPos );
+
+ if( thisVal != otherVal ) {
+ return thisVal < otherVal ? -1 : 1;
+ }
+
+ thisPos++;
+ otherPos++;
+ compareRemaining--;
+ }
+
+ return remaining() - value.remaining();
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool LongBuffer::equals( const LongBuffer& value ) const {
+
+ if( &value == this ) {
+ return true;
+ }
+
+ if( this->remaining() != value.remaining() ) {
+ return false;
+ }
+
+ std::size_t myPosition = this->position();
+ std::size_t otherPosition = value.position();
+ bool equalSoFar = true;
+
+ while( equalSoFar && ( myPosition < this->limit() ) ) {
+ equalSoFar = get( myPosition++ ) == value.get( otherPosition++ );
+ }
+
+ return equalSoFar;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool LongBuffer::operator==( const LongBuffer& value ) const {
+ return this->equals( value );
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool LongBuffer::operator<( const LongBuffer& value ) const {
+ return this->compareTo( value ) < 0 ? true : false;
+}
Added: activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/LongBuffer.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/LongBuffer.h?rev=600140&view=auto
==============================================================================
--- activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/LongBuffer.h (added)
+++ activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/LongBuffer.h Sat Dec 1 06:35:00 2007
@@ -0,0 +1,388 @@
+/*
+ * 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_NIO_LONGBUFFER_H_
+#define _DECAF_NIO_LONGBUFFER_H_
+
+#include <decaf/nio/Buffer.h>
+#include <decaf/lang/Comparable.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>
+
+namespace decaf{
+namespace nio{
+
+ /**
+ * This class defines four categories of operations upon long long buffers:
+ *
+ * o Absolute and relative get and put methods that read and write single long longs;
+ * o Relative bulk get methods that transfer contiguous sequences of long longs from
+ * this buffer long longo an array; and
+ * o Relative bulk put methods that transfer contiguous sequences of long longs from a
+ * long long array or some other long long buffer long longo this buffer
+ * o Methods for compacting, duplicating, and slicing a long long buffer.
+ *
+ * Double buffers can be created either by allocation, which allocates space for the
+ * buffer's content, by wrapping an existing long long array long longo a buffer, or by
+ * creating a view of an existing byte buffer
+ *
+ * Methods in this class that do not otherwise have a value to return are specified
+ * to return the buffer upon which they are invoked. This allows method invocations
+ * to be chained.
+ */
+ class LongBuffer : public Buffer,
+ public lang::Comparable<LongBuffer> {
+ protected:
+
+ /**
+ * Creates a LongBuffer object that has its backing array allocated long longernally
+ * and is then owned and deleted when this object is deleted. The array is
+ * initially created with all elements initialized to zero.
+ * @param capacity - size and limit of the Buffer in doubles
+ */
+ LongBuffer( std::size_t capacity );
+
+ public:
+
+ virtual ~LongBuffer() {}
+
+ /**
+ * @returns a std::string describing this object
+ */
+ virtual std::string toString() const;
+
+ /**
+ * Returns the long long array that backs this buffer (optional operation).
+ * <p>
+ * Modifications to this buffer's content will cause the returned array's content
+ * to be modified, and vice versa.
+ * <p>
+ * Invoke the hasArray method before invoking this method in order to ensure that
+ * this buffer has an accessible backing array.
+ * @returns the array that backs this Buffer
+ * @throws ReadOnlyBufferException if this Buffer is read only.
+ * @throws UnsupportedOperationException if the underlying store has no array.
+ */
+ virtual long long* array()
+ throw( decaf::lang::exceptions::UnsupportedOperationException,
+ ReadOnlyBufferException ) = 0;
+
+ /**
+ * Returns the offset within this buffer's backing array of the first element of
+ * the buffer (optional operation).
+ * <p>
+ * Invoke the hasArray method before invoking this method in order to ensure that
+ * this buffer has an accessible backing array.
+ * @returns The offset long longo the backing array where index zero starts.
+ * @throws ReadOnlyBufferException if this Buffer is read only.
+ * @throws UnsupportedOperationException if the underlying store has no array.
+ */
+ virtual std::size_t arrayOffset()
+ throw( decaf::lang::exceptions::UnsupportedOperationException,
+ ReadOnlyBufferException ) = 0;
+
+ /**
+ * Creates a new, read-only long long buffer that shares this buffer's content.
+ * <p>
+ * The content of the new buffer will be that of this buffer. Changes to this
+ * buffer's content will be visible in the new buffer; the new buffer itself,
+ * however, will be read-only and will not allow the shared content to be
+ * modified. The two buffers' position, limit, and mark values will be
+ * independent.
+ * <p>
+ * If this buffer is itself read-only then this method behaves in exactly the
+ * same way as the duplicate method.
+ * <p>
+ * The new buffer's capacity, limit, position, and mark values will be
+ * identical to those of this buffer.
+ * @return The new, read-only long long buffer which the caller then owns.
+ */
+ virtual LongBuffer* asReadOnlyBuffer() const = 0;
+
+ /**
+ * Compacts this buffer
+ * <p>
+ * The bytes between the buffer's current position and its limit, if any, are
+ * copied to the beginning of the buffer. That is, the byte at index
+ * p = position() is copied to index zero, the byte at index p + 1 is copied
+ * to index one, and so forth until the byte at index limit() - 1 is copied
+ * to index n = limit() - 1 - p. The buffer's position is then set to n+1 and
+ * its limit is set to its capacity. The mark, if defined, is discarded.
+ * <p>
+ * The buffer's position is set to the number of bytes copied, rather than to
+ * zero, so that an invocation of this method can be followed immediately by
+ * an invocation of another relative put method.
+ * @returns a reference to this LongBuffer
+ * @throws ReadOnlyBufferException - If this buffer is read-only
+ */
+ virtual LongBuffer& compact() throw( ReadOnlyBufferException ) = 0;
+
+ /**
+ * Creates a new long long buffer that shares this buffer's content.
+ * <p>
+ * The content of the new buffer will be that of this buffer. Changes to this
+ * buffer's content will be visible in the new buffer, and vice versa; the two
+ * buffers' position, limit, and mark values will be independent.
+ * <p>
+ * The new buffer's capacity, limit, position, and mark values will be identical
+ * to those of this buffer. The new buffer will be read-only if, and only if,
+ * this buffer is read-only.
+ * @returns a new long long Buffer which the caller owns.
+ */
+ virtual LongBuffer* duplicate() = 0;
+
+ /**
+ * Relative get method. Reads the value at this buffer's current position,
+ * and then increments the position.
+ * @returns the long long at the current position
+ * @throws BufferUnderflowException if there no more data to return
+ */
+ virtual long long get() throw ( BufferUnderflowException ) = 0;
+
+ /**
+ * Absolute get method. Reads the value at the given index.
+ * @param index - the index in the Buffer where the long long is to be read
+ * @returns the long long that is located at the given index
+ * @throws IndexOutOfBoundsException - If index is not smaller than the
+ * buffer's limit
+ */
+ virtual long long get( std::size_t index ) const
+ throw ( lang::exceptions::IndexOutOfBoundsException ) = 0;
+
+ /**
+ * Relative bulk get method.
+ * <p>
+ * This method transfers values from this buffer long longo the given destination
+ * vector. An invocation of this method of the form src.get(a) behaves in
+ * exactly the same way as the invocation. The vector must be sized to the
+ * amount of data that is to be read, that is to say, the caller should call
+ * buffer.resize( N ) before calling this get method.
+ * @returns a reference to this Buffer
+ * @throws BufferUnderflowException - If there are fewer than length long longs
+ * remaining in this buffer
+ */
+ LongBuffer& get( std::vector<long long> buffer )
+ throw ( BufferUnderflowException );
+
+ /**
+ * Relative bulk get method.
+ * <p>
+ * This method transfers long longs from this buffer long longo the given destination array.
+ * If there are fewer long longs remaining in the buffer than are required to satisfy
+ * the request, that is, if length > remaining(), then no bytes are transferred
+ * and a BufferUnderflowException is thrown.
+ * <p>
+ * Otherwise, this method copies length long longs from this buffer long longo the given
+ * array, starting at the current position of this buffer and at the given offset
+ * in the array. The position of this buffer is then incremented by length.
+ * <p>
+ * @param buffer - polong longer to an allocated buffer to fill
+ * @param offset - position in the buffer to start filling
+ * @param length - amount of data to put in the passed buffer
+ * @returns a reference to this Buffer
+ * @throws BufferUnderflowException - If there are fewer than length long longs
+ * remaining in this buffer
+ * @throws NullPolong longerException if the passed buffer is null.
+ */
+ LongBuffer& get( long long* buffer, std::size_t offset, std::size_t length )
+ throw( BufferUnderflowException,
+ lang::exceptions::NullPointerException );
+
+ /**
+ * Tells whether or not this buffer is backed by an accessible long long array.
+ * If this method returns true then the array and arrayOffset methods may safely
+ * be invoked. Subclasses should override this method if they do not have a
+ * backing array as this class always returns true.
+ * @returns true if, and only if, this buffer is backed by an array and is not
+ * read-only
+ */
+ virtual bool hasArray() const = 0;
+
+ /**
+ * This method transfers the long longs remaining in the given source buffer long longo
+ * this buffer. If there are more long longs remaining in the source buffer than in
+ * this buffer, that is, if src.remaining() > remaining(), then no long longs are
+ * transferred and a BufferOverflowException is thrown.
+ * <p>
+ * Otherwise, this method copies n = src.remaining() long longs from the given
+ * buffer long longo this buffer, starting at each buffer's current position. The
+ * positions of both buffers are then incremented by n.
+ * @param src - the buffer to take long longs from an place in this one.
+ * @returns a reference to this buffer
+ * @throws BufferOverflowException - If there is insufficient space in this
+ * buffer for the remaining long longs in the source buffer
+ * @throws IllegalArgumentException - If the source buffer is this buffer
+ * @throws ReadOnlyBufferException - If this buffer is read-only
+ */
+ LongBuffer& put( LongBuffer& src )
+ throw( BufferOverflowException, ReadOnlyBufferException,
+ lang::exceptions::IllegalArgumentException );
+
+ /**
+ * This method transfers long longs long longo this buffer from the given source array.
+ * If there are more long longs to be copied from the array than remain in this buffer,
+ * that is, if length > remaining(), then no long longs are transferred and a
+ * BufferOverflowException is thrown.
+ * <p>
+ * Otherwise, this method copies length bytes from the given array long longo this
+ * buffer, starting at the given offset in the array and at the current position
+ * of this buffer. The position of this buffer is then incremented by length.
+ * @param buffer- The array from which long longs are to be read
+ * @param offset- The offset within the array of the first long long to be read;
+ * @param length - The number of long longs to be read from the given array
+ * @returns a reference to this buffer
+ * @throws BufferOverflowException - If there is insufficient space in this buffer
+ * @throws ReadOnlyBufferException - If this buffer is read-only
+ * @throws NullPolong longerException if the passed buffer is null.
+ */
+ LongBuffer& put( const long long* buffer, std::size_t offset, std::size_t length )
+ throw( BufferOverflowException, ReadOnlyBufferException,
+ lang::exceptions::NullPointerException );
+
+ /**
+ * This method transfers the entire content of the given source long longs array long longo
+ * this buffer. This is the same as calling put( &buffer[0], 0, buffer.size()
+ * @pparam buffer - The buffer whose contents are copied to this LongBuffer
+ * @returns a reference to this buffer
+ * @throws BufferOverflowException - If there is insufficient space in this buffer
+ * @throws ReadOnlyBufferException - If this buffer is read-only
+ */
+ LongBuffer& put( std::vector<long long>& buffer )
+ throw( BufferOverflowException, ReadOnlyBufferException );
+
+ /**
+ * Writes the given long longs long longo this buffer at the current position, and then
+ * increments the position.
+ * @param value - the long longs value to be written
+ * @returns a reference to this buffer
+ * @throws BufferOverflowException - If this buffer's current position is not
+ * smaller than its limit
+ * @throws ReadOnlyBufferException - If this buffer is read-only
+ */
+ virtual LongBuffer& put( long long value )
+ throw( BufferOverflowException, ReadOnlyBufferException ) = 0;
+
+ /**
+ * Writes the given long longs long longo this buffer at the given index.
+ * @param index - position in the Buffer to write the data
+ * @param value - the long longs to write.
+ * @returns a reference to this buffer
+ * @throws IndexOutOfBoundsException - If index greater than the buffer's limit
+ * minus the size of the type being written.
+ * @throws ReadOnlyBufferException - If this buffer is read-only
+ */
+ virtual LongBuffer& put( std::size_t index, long long value )
+ throw( lang::exceptions::IndexOutOfBoundsException,
+ ReadOnlyBufferException ) = 0;
+
+ /**
+ * Creates a new LongBuffer whose content is a shared subsequence of this
+ * buffer's content. The content of the new buffer will start at this buffer's
+ * current position. Changes to this buffer's content will be visible in the new
+ * buffer, and vice versa; the two buffers' position, limit, and mark values will
+ * be independent.
+ * <p>
+ * The new buffer's position will be zero, its capacity and its limit will be the
+ * number of bytes remaining in this buffer, and its mark will be undefined. The
+ * new buffer will be read-only if, and only if, this buffer is read-only.
+ * @returns the newly create LongBuffer which the caller owns.
+ */
+ virtual LongBuffer* slice() const = 0;
+
+ public: // Comparable
+
+ /**
+ * Compares this object with the specified object for order. Returns a
+ * negative long longeger, zero, or a positive long longeger as this object is less
+ * than, equal to, or greater than the specified object.
+ * @param value - the Object to be compared.
+ * @returns a negative long longeger, zero, or a positive long longeger as this
+ * object is less than, equal to, or greater than the specified object.
+ */
+ virtual int compareTo( const LongBuffer& value ) const;
+
+ /**
+ * @return true if this value is considered equal to the passed value.
+ */
+ virtual bool equals( const LongBuffer& value ) const;
+
+ /**
+ * Compares equality between this object and the one passed.
+ * @param value - the value to be compared to this one.
+ * @return true if this object is equal to the one passed.
+ */
+ virtual bool operator==( const LongBuffer& value ) const;
+
+ /**
+ * Compares this object to another and returns true if this object
+ * is considered to be less than the one passed. This
+ * @param value - the value to be compared to this one.
+ * @return true if this object is equal to the one passed.
+ */
+ virtual bool operator<( const LongBuffer& value ) const;
+
+ public: // Statics
+
+ /**
+ * Allocates a new Double buffer.
+ * <p>
+ * The new buffer's position will be zero, its limit will be its capacity, and
+ * its mark will be undefined. It will have a backing array, and its array offset
+ * will be zero.
+ * @param capacity - The size of the Double buffer in long longs
+ * @returns the LongBuffer that was allocated, caller owns.
+ */
+ static LongBuffer* allocate( std::size_t capacity );
+
+ /**
+ * Wraps the passed buffer with a new LongBuffer.
+ * <p>
+ * The new buffer will be backed by the given long long array; that is, modifications
+ * to the buffer will cause the array to be modified and vice versa. The new
+ * buffer's capacity will be array.length, its position will be offset, its limit
+ * will be offset + length, and its mark will be undefined. Its backing array
+ * will be the given array, and its array offset will be zero.
+ * @param buffer - The array that will back the new buffer
+ * @param offset - The offset of the subarray to be used
+ * @param length - The length of the subarray to be used
+ * @returns a new LongBuffer that is backed by buffer, caller owns.
+ */
+ static LongBuffer* wrap( long long* array, std::size_t offset, std::size_t length )
+ throw( lang::exceptions::NullPointerException );
+
+ /**
+ * Wraps the passed STL long long Vector in a LongBuffer.
+ * <p>
+ * The new buffer will be backed by the given long long array; modifications to the
+ * buffer will cause the array to be modified and vice versa. The new buffer's
+ * capacity and limit will be buffer.size(), its position will be zero, and its
+ * mark will be undefined. Its backing array will be the given array, and its
+ * array offset will be zero.
+ * @param buffer - The vector that will back the new buffer, the vector must
+ * have been sized to the desired size already by calling vector.resize( N ).
+ * @returns a new LongBuffer that is backed by buffer, caller owns.
+ */
+ static LongBuffer* wrap( std::vector<long long>& buffer );
+
+ };
+
+}}
+
+#endif /*_DECAF_NIO_LONGBUFFER_H_*/
Added: activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/ShortBuffer.cpp
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/ShortBuffer.cpp?rev=600140&view=auto
==============================================================================
--- activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/ShortBuffer.cpp (added)
+++ activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/ShortBuffer.cpp Sat Dec 1 06:35:00 2007
@@ -0,0 +1,252 @@
+/*
+ * 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.
+ */
+
+#include "ShortBuffer.h"
+
+#include <decaf/lang/Float.h>
+#include <decaf/lang/Math.h>
+
+using namespace std;
+using namespace decaf;
+using namespace decaf::nio;
+using namespace decaf::lang;
+using namespace decaf::lang::exceptions;
+
+////////////////////////////////////////////////////////////////////////////////
+ShortBuffer::ShortBuffer( std::size_t capacity )
+ : Buffer( capacity ) {
+
+}
+
+////////////////////////////////////////////////////////////////////////////////
+std::string ShortBuffer::toString() const {
+
+ std::string strbuf;
+
+ for( std::size_t i = this->position(); i < this->limit(); i++ ) {
+ strbuf.append( Float::valueOf( get( i ) ).toString() );
+ }
+
+ return strbuf;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+ShortBuffer& ShortBuffer::get( std::vector<short> buffer )
+ throw ( BufferUnderflowException ) {
+
+ try{
+
+ if( !buffer.empty() ) {
+ this->get( &buffer[0], 0, buffer.size() );
+ }
+ return *this;
+ }
+ DECAF_CATCH_RETHROW( BufferUnderflowException )
+ DECAF_CATCH_EXCEPTION_CONVERT( Exception, BufferUnderflowException )
+ DECAF_CATCHALL_THROW( BufferUnderflowException )
+}
+
+////////////////////////////////////////////////////////////////////////////////
+ShortBuffer& ShortBuffer::get( short* buffer, std::size_t offset, std::size_t length )
+ throw( BufferUnderflowException,
+ lang::exceptions::NullPointerException ) {
+
+ try{
+
+ if( length == 0 ) {
+ return *this;
+ }
+
+ if( buffer == NULL ) {
+ throw NullPointerException(
+ __FILE__, __LINE__,
+ "ShortBuffer::get - Passed Buffer is Null" );
+ }
+
+ if( length > remaining() ) {
+ throw BufferUnderflowException(
+ __FILE__, __LINE__,
+ "ShortBuffer::get - Not enough data to fill length = %d", length );
+ }
+
+ for( std::size_t ix = 0; ix < length; ++ix ){
+ buffer[offset + ix] = this->get();
+ }
+
+ return *this;
+ }
+ DECAF_CATCH_RETHROW( BufferUnderflowException )
+ DECAF_CATCH_EXCEPTION_CONVERT( Exception, BufferUnderflowException )
+ DECAF_CATCHALL_THROW( BufferUnderflowException )
+}
+
+////////////////////////////////////////////////////////////////////////////////
+ShortBuffer& ShortBuffer::put( ShortBuffer& src )
+ throw( BufferOverflowException, ReadOnlyBufferException,
+ lang::exceptions::IllegalArgumentException ) {
+
+ try{
+
+ if( this == &src ) {
+ throw IllegalArgumentException(
+ __FILE__, __LINE__,
+ "ShortBuffer::put - Can't put Self" );
+ }
+
+ if( this->isReadOnly() ) {
+ throw ReadOnlyBufferException(
+ __FILE__, __LINE__,
+ "ShortBuffer::put - This buffer is Read Only.");
+ }
+
+ if( src.remaining() > this->remaining() ) {
+ throw BufferOverflowException(
+ __FILE__, __LINE__,
+ "ShortBuffer::put - Not enough space remaining to put src." );
+ }
+
+ while( src.hasRemaining() ) {
+ this->put( src.get() );
+ }
+
+ return *this;
+ }
+ DECAF_CATCH_RETHROW( BufferOverflowException )
+ DECAF_CATCH_RETHROW( ReadOnlyBufferException )
+ DECAF_CATCH_RETHROW( IllegalArgumentException )
+ DECAF_CATCH_EXCEPTION_CONVERT( Exception, BufferOverflowException )
+ DECAF_CATCHALL_THROW( BufferOverflowException )
+}
+
+////////////////////////////////////////////////////////////////////////////////
+ShortBuffer& ShortBuffer::put( const short* buffer, std::size_t offset, std::size_t length )
+ throw( BufferOverflowException, ReadOnlyBufferException,
+ lang::exceptions::NullPointerException ) {
+
+ try{
+
+ if( length == 0 ) {
+ return *this;
+ }
+
+ if( this->isReadOnly() ) {
+ throw ReadOnlyBufferException(
+ __FILE__, __LINE__,
+ "ShortBuffer::put - This buffer is Read Only.");
+ }
+
+ if( buffer == NULL ) {
+ throw NullPointerException(
+ __FILE__, __LINE__,
+ "ShortBuffer::put - Passed Buffer is Null.");
+ }
+
+ if( length > this->remaining() ) {
+ throw BufferOverflowException(
+ __FILE__, __LINE__,
+ "ShortBuffer::put - Not Enough space to store requested Data.");
+ }
+
+ // read length bytes starting from the offset
+ for( std::size_t ix = 0; ix < length; ++ix ) {
+ this->put( buffer[ix + offset] );
+ }
+
+ return *this;
+ }
+ DECAF_CATCH_RETHROW( BufferOverflowException )
+ DECAF_CATCH_RETHROW( ReadOnlyBufferException )
+ DECAF_CATCH_RETHROW( NullPointerException )
+ DECAF_CATCH_EXCEPTION_CONVERT( Exception, BufferOverflowException )
+ DECAF_CATCHALL_THROW( BufferOverflowException )
+}
+
+////////////////////////////////////////////////////////////////////////////////
+ShortBuffer& ShortBuffer::put( std::vector<short>& buffer )
+ throw( BufferOverflowException, ReadOnlyBufferException ) {
+
+ try{
+
+ if( !buffer.empty() ) {
+ this->put( &buffer[0], 0, buffer.size() );
+ }
+
+ return *this;
+ }
+ DECAF_CATCH_RETHROW( BufferOverflowException )
+ DECAF_CATCH_RETHROW( ReadOnlyBufferException )
+ DECAF_CATCH_EXCEPTION_CONVERT( Exception, BufferOverflowException )
+ DECAF_CATCHALL_THROW( BufferOverflowException )
+}
+
+////////////////////////////////////////////////////////////////////////////////
+int ShortBuffer::compareTo( const ShortBuffer& value ) const {
+
+ int compareRemaining = Math::min( remaining(), value.remaining() );
+
+ std::size_t thisPos = this->position();
+ std::size_t otherPos = value.position();
+ short thisVal, otherVal;
+
+ while( compareRemaining > 0 ) {
+
+ thisVal = get( thisPos );
+ otherVal = value.get( otherPos );
+
+ if( thisVal != otherVal ) {
+ return thisVal < otherVal ? -1 : 1;
+ }
+
+ thisPos++;
+ otherPos++;
+ compareRemaining--;
+ }
+
+ return remaining() - value.remaining();
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool ShortBuffer::equals( const ShortBuffer& value ) const {
+
+ if( &value == this ) {
+ return true;
+ }
+
+ if( this->remaining() != value.remaining() ) {
+ return false;
+ }
+
+ std::size_t myPosition = this->position();
+ std::size_t otherPosition = value.position();
+ bool equalSoFar = true;
+
+ while( equalSoFar && ( myPosition < this->limit() ) ) {
+ equalSoFar = get( myPosition++ ) == value.get( otherPosition++ );
+ }
+
+ return equalSoFar;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool ShortBuffer::operator==( const ShortBuffer& value ) const {
+ return this->equals( value );
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool ShortBuffer::operator<( const ShortBuffer& value ) const {
+ return this->compareTo( value ) < 0 ? true : false;
+}
Added: activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/ShortBuffer.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/ShortBuffer.h?rev=600140&view=auto
==============================================================================
--- activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/ShortBuffer.h (added)
+++ activemq/activemq-cpp/decaf/trunk/src/main/decaf/nio/ShortBuffer.h Sat Dec 1 06:35:00 2007
@@ -0,0 +1,388 @@
+/*
+ * 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_NIO_SHORTBUFFER_H_
+#define _DECAF_NIO_SHORTBUFFER_H_
+
+#include <decaf/nio/Buffer.h>
+#include <decaf/lang/Comparable.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>
+
+namespace decaf{
+namespace nio{
+
+ /**
+ * This class defines four categories of operations upon short buffers:
+ *
+ * o Absolute and relative get and put methods that read and write single shorts;
+ * o Relative bulk get methods that transfer contiguous sequences of shorts from
+ * this buffer into an array; and
+ * o Relative bulk put methods that transfer contiguous sequences of shorts from a
+ * short array or some other short buffer into this buffer
+ * o Methods for compacting, duplicating, and slicing a short buffer.
+ *
+ * Double buffers can be created either by allocation, which allocates space for the
+ * buffer's content, by wrapping an existing short array into a buffer, or by
+ * creating a view of an existing byte buffer
+ *
+ * Methods in this class that do not otherwise have a value to return are specified
+ * to return the buffer upon which they are invoked. This allows method invocations
+ * to be chained.
+ */
+ class ShortBuffer : public Buffer,
+ public lang::Comparable<ShortBuffer> {
+ protected:
+
+ /**
+ * Creates a ShortBuffer 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 capacity - size and limit of the Buffer in doubles
+ */
+ ShortBuffer( std::size_t capacity );
+
+ public:
+
+ virtual ~ShortBuffer() {}
+
+ /**
+ * @returns a std::string describing this object
+ */
+ virtual std::string toString() const;
+
+ /**
+ * Returns the short array that backs this buffer (optional operation).
+ * <p>
+ * Modifications to this buffer's content will cause the returned array's content
+ * to be modified, and vice versa.
+ * <p>
+ * Invoke the hasArray method before invoking this method in order to ensure that
+ * this buffer has an accessible backing array.
+ * @returns the array that backs this Buffer
+ * @throws ReadOnlyBufferException if this Buffer is read only.
+ * @throws UnsupportedOperationException if the underlying store has no array.
+ */
+ virtual short* array()
+ throw( decaf::lang::exceptions::UnsupportedOperationException,
+ ReadOnlyBufferException ) = 0;
+
+ /**
+ * Returns the offset within this buffer's backing array of the first element of
+ * the buffer (optional operation).
+ * <p>
+ * Invoke the hasArray method before invoking this method in order to ensure that
+ * this buffer has an accessible backing array.
+ * @returns The offset into the backing array where index zero starts.
+ * @throws ReadOnlyBufferException if this Buffer is read only.
+ * @throws UnsupportedOperationException if the underlying store has no array.
+ */
+ virtual std::size_t arrayOffset()
+ throw( decaf::lang::exceptions::UnsupportedOperationException,
+ ReadOnlyBufferException ) = 0;
+
+ /**
+ * Creates a new, read-only short buffer that shares this buffer's content.
+ * <p>
+ * The content of the new buffer will be that of this buffer. Changes to this
+ * buffer's content will be visible in the new buffer; the new buffer itself,
+ * however, will be read-only and will not allow the shared content to be
+ * modified. The two buffers' position, limit, and mark values will be
+ * independent.
+ * <p>
+ * If this buffer is itself read-only then this method behaves in exactly the
+ * same way as the duplicate method.
+ * <p>
+ * The new buffer's capacity, limit, position, and mark values will be
+ * identical to those of this buffer.
+ * @return The new, read-only short buffer which the caller then owns.
+ */
+ virtual ShortBuffer* asReadOnlyBuffer() const = 0;
+
+ /**
+ * Compacts this buffer
+ * <p>
+ * The bytes between the buffer's current position and its limit, if any, are
+ * copied to the beginning of the buffer. That is, the byte at index
+ * p = position() is copied to index zero, the byte at index p + 1 is copied
+ * to index one, and so forth until the byte at index limit() - 1 is copied
+ * to index n = limit() - 1 - p. The buffer's position is then set to n+1 and
+ * its limit is set to its capacity. The mark, if defined, is discarded.
+ * <p>
+ * The buffer's position is set to the number of bytes copied, rather than to
+ * zero, so that an invocation of this method can be followed immediately by
+ * an invocation of another relative put method.
+ * @returns a reference to this ShortBuffer
+ * @throws ReadOnlyBufferException - If this buffer is read-only
+ */
+ virtual ShortBuffer& compact() throw( ReadOnlyBufferException ) = 0;
+
+ /**
+ * Creates a new short buffer that shares this buffer's content.
+ * <p>
+ * The content of the new buffer will be that of this buffer. Changes to this
+ * buffer's content will be visible in the new buffer, and vice versa; the two
+ * buffers' position, limit, and mark values will be independent.
+ * <p>
+ * The new buffer's capacity, limit, position, and mark values will be identical
+ * to those of this buffer. The new buffer will be read-only if, and only if,
+ * this buffer is read-only.
+ * @returns a new short Buffer which the caller owns.
+ */
+ virtual ShortBuffer* duplicate() = 0;
+
+ /**
+ * Relative get method. Reads the value at this buffer's current position,
+ * and then increments the position.
+ * @returns the short at the current position
+ * @throws BufferUnderflowException if there no more data to return
+ */
+ virtual short get() throw ( BufferUnderflowException ) = 0;
+
+ /**
+ * Absolute get method. Reads the value at the given index.
+ * @param index - the index in the Buffer where the short is to be read
+ * @returns the short that is located at the given index
+ * @throws IndexOutOfBoundsException - If index is not smaller than the
+ * buffer's limit
+ */
+ virtual short get( std::size_t index ) const
+ throw ( lang::exceptions::IndexOutOfBoundsException ) = 0;
+
+ /**
+ * Relative bulk get method.
+ * <p>
+ * This method transfers values from this buffer into the given destination
+ * vector. An invocation of this method of the form src.get(a) behaves in
+ * exactly the same way as the invocation. The vector must be sized to the
+ * amount of data that is to be read, that is to say, the caller should call
+ * buffer.resize( N ) before calling this get method.
+ * @returns a reference to this Buffer
+ * @throws BufferUnderflowException - If there are fewer than length shorts
+ * remaining in this buffer
+ */
+ ShortBuffer& get( std::vector<short> buffer )
+ throw ( BufferUnderflowException );
+
+ /**
+ * Relative bulk get method.
+ * <p>
+ * This method transfers shorts from this buffer into the given destination array.
+ * If there are fewer shorts remaining in the buffer than are required to satisfy
+ * the request, that is, if length > remaining(), then no bytes are transferred
+ * and a BufferUnderflowException is thrown.
+ * <p>
+ * Otherwise, this method copies length shorts from this buffer into the given
+ * array, starting at the current position of this buffer and at the given offset
+ * in the array. The position of this buffer is then incremented by length.
+ * <p>
+ * @param buffer - pointer to an allocated buffer to fill
+ * @param offset - position in the buffer to start filling
+ * @param length - amount of data to put in the passed buffer
+ * @returns a reference to this Buffer
+ * @throws BufferUnderflowException - If there are fewer than length shorts
+ * remaining in this buffer
+ * @throws NullPointerException if the passed buffer is null.
+ */
+ ShortBuffer& get( short* buffer, std::size_t offset, std::size_t length )
+ throw( BufferUnderflowException,
+ lang::exceptions::NullPointerException );
+
+ /**
+ * Tells whether or not this buffer is backed by an accessible short array.
+ * If this method returns true then the array and arrayOffset methods may safely
+ * be invoked. Subclasses should override this method if they do not have a
+ * backing array as this class always returns true.
+ * @returns true if, and only if, this buffer is backed by an array and is not
+ * read-only
+ */
+ virtual bool hasArray() const = 0;
+
+ /**
+ * This method transfers the shorts remaining in the given source buffer into
+ * this buffer. If there are more shorts remaining in the source buffer than in
+ * this buffer, that is, if src.remaining() > remaining(), then no shorts are
+ * transferred and a BufferOverflowException is thrown.
+ * <p>
+ * Otherwise, this method copies n = src.remaining() shorts from the given
+ * buffer into this buffer, starting at each buffer's current position. The
+ * positions of both buffers are then incremented by n.
+ * @param src - the buffer to take shorts from an place in this one.
+ * @returns a reference to this buffer
+ * @throws BufferOverflowException - If there is insufficient space in this
+ * buffer for the remaining shorts in the source buffer
+ * @throws IllegalArgumentException - If the source buffer is this buffer
+ * @throws ReadOnlyBufferException - If this buffer is read-only
+ */
+ ShortBuffer& put( ShortBuffer& src )
+ throw( BufferOverflowException, ReadOnlyBufferException,
+ lang::exceptions::IllegalArgumentException );
+
+ /**
+ * This method transfers shorts into this buffer from the given source array.
+ * If there are more shorts to be copied from the array than remain in this buffer,
+ * that is, if length > remaining(), then no shorts are transferred and a
+ * BufferOverflowException is thrown.
+ * <p>
+ * Otherwise, this method copies length bytes from the given array into this
+ * buffer, starting at the given offset in the array and at the current position
+ * of this buffer. The position of this buffer is then incremented by length.
+ * @param buffer- The array from which shorts are to be read
+ * @param offset- The offset within the array of the first short to be read;
+ * @param length - The number of shorts to be read from the given array
+ * @returns a reference to this buffer
+ * @throws BufferOverflowException - If there is insufficient space in this buffer
+ * @throws ReadOnlyBufferException - If this buffer is read-only
+ * @throws NullPointerException if the passed buffer is null.
+ */
+ ShortBuffer& put( const short* buffer, std::size_t offset, std::size_t length )
+ throw( BufferOverflowException, ReadOnlyBufferException,
+ lang::exceptions::NullPointerException );
+
+ /**
+ * This method transfers the entire content of the given source shorts array into
+ * this buffer. This is the same as calling put( &buffer[0], 0, buffer.size()
+ * @pparam buffer - The buffer whose contents are copied to this ShortBuffer
+ * @returns a reference to this buffer
+ * @throws BufferOverflowException - If there is insufficient space in this buffer
+ * @throws ReadOnlyBufferException - If this buffer is read-only
+ */
+ ShortBuffer& put( std::vector<short>& buffer )
+ throw( BufferOverflowException, ReadOnlyBufferException );
+
+ /**
+ * Writes the given shorts into this buffer at the current position, and then
+ * increments the position.
+ * @param value - the shorts value to be written
+ * @returns a reference to this buffer
+ * @throws BufferOverflowException - If this buffer's current position is not
+ * smaller than its limit
+ * @throws ReadOnlyBufferException - If this buffer is read-only
+ */
+ virtual ShortBuffer& put( short value )
+ throw( BufferOverflowException, ReadOnlyBufferException ) = 0;
+
+ /**
+ * Writes the given shorts into this buffer at the given index.
+ * @param index - position in the Buffer to write the data
+ * @param value - the shorts to write.
+ * @returns a reference to this buffer
+ * @throws IndexOutOfBoundsException - If index greater than the buffer's limit
+ * minus the size of the type being written.
+ * @throws ReadOnlyBufferException - If this buffer is read-only
+ */
+ virtual ShortBuffer& put( std::size_t index, short value )
+ throw( lang::exceptions::IndexOutOfBoundsException,
+ ReadOnlyBufferException ) = 0;
+
+ /**
+ * Creates a new ShortBuffer whose content is a shared subsequence of this
+ * buffer's content. The content of the new buffer will start at this buffer's
+ * current position. Changes to this buffer's content will be visible in the new
+ * buffer, and vice versa; the two buffers' position, limit, and mark values will
+ * be independent.
+ * <p>
+ * The new buffer's position will be zero, its capacity and its limit will be the
+ * number of bytes remaining in this buffer, and its mark will be undefined. The
+ * new buffer will be read-only if, and only if, this buffer is read-only.
+ * @returns the newly create ShortBuffer which the caller owns.
+ */
+ virtual ShortBuffer* slice() const = 0;
+
+ public: // Comparable
+
+ /**
+ * Compares this object with the specified object for order. Returns a
+ * negative integer, zero, or a positive integer as this object is less
+ * than, equal to, or greater than the specified object.
+ * @param value - the Object to be compared.
+ * @returns a negative integer, zero, or a positive integer as this
+ * object is less than, equal to, or greater than the specified object.
+ */
+ virtual int compareTo( const ShortBuffer& value ) const;
+
+ /**
+ * @return true if this value is considered equal to the passed value.
+ */
+ virtual bool equals( const ShortBuffer& value ) const;
+
+ /**
+ * Compares equality between this object and the one passed.
+ * @param value - the value to be compared to this one.
+ * @return true if this object is equal to the one passed.
+ */
+ virtual bool operator==( const ShortBuffer& value ) const;
+
+ /**
+ * Compares this object to another and returns true if this object
+ * is considered to be less than the one passed. This
+ * @param value - the value to be compared to this one.
+ * @return true if this object is equal to the one passed.
+ */
+ virtual bool operator<( const ShortBuffer& value ) const;
+
+ public: // Statics
+
+ /**
+ * Allocates a new Double buffer.
+ * <p>
+ * The new buffer's position will be zero, its limit will be its capacity, and
+ * its mark will be undefined. It will have a backing array, and its array offset
+ * will be zero.
+ * @param capacity - The size of the Double buffer in shorts
+ * @returns the ShortBuffer that was allocated, caller owns.
+ */
+ static ShortBuffer* allocate( std::size_t capacity );
+
+ /**
+ * Wraps the passed buffer with a new ShortBuffer.
+ * <p>
+ * The new buffer will be backed by the given short array; that is, modifications
+ * to the buffer will cause the array to be modified and vice versa. The new
+ * buffer's capacity will be array.length, its position will be offset, its limit
+ * will be offset + length, and its mark will be undefined. Its backing array
+ * will be the given array, and its array offset will be zero.
+ * @param buffer - The array that will back the new buffer
+ * @param offset - The offset of the subarray to be used
+ * @param length - The length of the subarray to be used
+ * @returns a new ShortBuffer that is backed by buffer, caller owns.
+ */
+ static ShortBuffer* wrap( short* array, std::size_t offset, std::size_t length )
+ throw( lang::exceptions::NullPointerException );
+
+ /**
+ * Wraps the passed STL short Vector in a ShortBuffer.
+ * <p>
+ * The new buffer will be backed by the given short array; modifications to the
+ * buffer will cause the array to be modified and vice versa. The new buffer's
+ * capacity and limit will be buffer.size(), its position will be zero, and its
+ * mark will be undefined. Its backing array will be the given array, and its
+ * array offset will be zero.
+ * @param buffer - The vector that will back the new buffer, the vector must
+ * have been sized to the desired size already by calling vector.resize( N ).
+ * @returns a new ShortBuffer that is backed by buffer, caller owns.
+ */
+ static ShortBuffer* wrap( std::vector<short>& buffer );
+
+ };
+
+}}
+
+#endif /*_DECAF_NIO_SHORTBUFFER_H_*/