org.joda.primitives.list.impl
Class AbstractByteList

java.lang.Object
  org.joda.primitives.collection.impl.AbstractPrimitiveCollectable<Byte>
      org.joda.primitives.collection.impl.AbstractByteCollection
          org.joda.primitives.list.impl.AbstractByteList

All Implemented Interfaces:

Iterable<Byte>, Collection<Byte>, List<Byte>, ByteCollection, PrimitiveCollection<Byte>, ByteIterable, ByteList, PrimitiveList<Byte>, PrimitiveCollectable<Byte>

Direct Known Subclasses:

ArrayByteList, ImmutableArrayByteList

public abstract class AbstractByteList
extends AbstractByteCollection
implements ByteList

Abstract base class for lists of primitive byte elements.

This class implements Collection allowing seamless integration with other APIs.

The get(int) and size() methods must be implemented by subclases. To make the subclass modifiable, the add(int, byte), removeIndex(int) and set(int, byte) must also be implemented. Subclasses may override other methods to increase efficiency.

Since:

1.0

Version:

CODE GENERATED

Author:

Stephen Colebourne, Rodney Waldhoff, Jason Tiscione

Nested Class Summary

protected static class

AbstractByteList.PListIterator List iterator.

Constructor Summary

protected

AbstractByteList() Constructor.

Method Summary

boolean	add(byte value) Adds a primitive value to this collection (optional operation).
boolean	add(Byte value) Adds the Byte value to this collection (optional operation).
boolean	add(int index, byte value) Adds a primitive value to this list at an index (optional operation).
void	add(int index, Byte value) Adds the Byte value to this list at an index (optional operation).
boolean	addAll(byte[] values) Adds an array of primitive values to this list at an index (optional operation).
boolean	addAll(int index, byte[] values) Adds an array of primitive values to this list at an index (optional operation).
boolean	addAll(int index, Collection<? extends Byte> coll) Adds an array of Byte values to this list at an index (optional operation).
protected void	arrayCopy(int fromIndex, byte[] dest, int destIndex, int size) Copies data from this collection into the specified array.
protected void	checkIndex(int index) Checks whether an index is valid or not.
protected void	checkIndexExists(int index) Checks whether an index is valid or not.
protected void	checkRange(int fromIndexInclusive, int toIndexExclusive) Checks whether a range is valid or not.
protected void	checkSetModifiable() Check whether add is suported and throw an exception.
void	clear() Clears the listof all elements (optional operation).
boolean	contains(byte value) Checks whether this collection contains a specified primitive value.
boolean	equals(Object obj) Compares this list to another as per the contract of List.
Byte	first() Gets the first Byte value.
byte	firstByte() Gets the first primitive value.
Byte	get(int index) Gets the Byte value at the specified index.
int	hashCode() Gets the hashCode of this list as per the contract of List.
int	indexOf(byte value) Gets the first index of the specified primitive value.
int	indexOf(byte value, int fromIndexInclusive) Gets the first index of the specified primitive value from an index.
int	indexOf(Object value) Gets the first index of the specified Byte value.
int	indexOf(Object value, int fromIndexInclusive) Gets the first index of the specified Byte value from an index.
boolean	isModifiable() Is the collection modifiable in any way.
protected boolean	isSetModifiable() Are the set methods supported.
ByteListIterator	iterator() Gets an iterator over this list.
Byte	last() Gets the last Byte value.
byte	lastByte() Gets the last primitive value.
int	lastIndexOf(byte value) Gets the last index of the specified primitive value.
int	lastIndexOf(byte value, int fromIndexInclusive) Gets the first index of the specified primitive value from an index.
int	lastIndexOf(Object value) Gets the last index of the specified Byte value.
int	lastIndexOf(Object value, int fromIndexInclusive) Gets the first index of the specified Byte value from an index.
ByteListIterator	listIterator() Gets a list iterator over this list.
ByteListIterator	listIterator(int index) Gets a list iterator over this list from a start index.
Byte	remove(int index) Deprecated. This method should only be used when working with List and not when working with ByteList - use removeByteAt(int)
boolean	removeByte(byte value) Removes the first occurrence of a primitive value from the list (optional operation).
byte	removeByteAt(int index) Removes a primitive value by index from the list (optional operation).
boolean	removeRange(int fromIndexInclusive, int toIndexExclusive) Removes a range of values from the list (optional operation).
byte	set(int index, byte value) Sets the primitive value at a specified index.
Byte	set(int index, Byte value) Sets the Byte value at a specified index.
ByteList	subList(int fromIndexInclusive, int toIndexExclusive) Gets a range view of part of this list.
byte[]	toByteArray(int fromIndexInclusive, int toIndexExclusive) Gets a range of elements as an array.

Methods inherited from class org.joda.primitives.collection.impl.AbstractByteCollection

addAll, addAll, addAll, checkAddModifiable, checkRemoveModifiable, contains, containsAll, containsAll, containsAll, containsAll, containsAny, containsAny, containsAny, containsAny, isAddModifiable, isRemoveModifiable, isToPrimitivePossible, remove, removeAll, removeAll, removeAll, removeAll, removeAll, removeFirst, retainAll, retainAll, retainAll, retainAll, toArray, toArray, toByteArray, toByteArray, toObject, toPrimitive, toPrimitiveArray, toString

Methods inherited from class org.joda.primitives.collection.impl.AbstractPrimitiveCollectable

clone, isEmpty, optimize

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.joda.primitives.list.ByteList

getByte

Methods inherited from interface org.joda.primitives.collection.PrimitiveCollection

containsAny

Methods inherited from interface org.joda.primitives.PrimitiveCollectable

clone, isEmpty, optimize, size

Methods inherited from interface java.util.List

addAll, contains, containsAll, isEmpty, remove, removeAll, retainAll, size, toArray, toArray

Methods inherited from interface org.joda.primitives.collection.ByteCollection

addAll, addAll, containsAll, containsAll, containsAll, containsAny, containsAny, containsAny, removeAll, removeAll, removeAll, removeAll, removeFirst, retainAll, retainAll, retainAll, toByteArray, toByteArray

Methods inherited from interface org.joda.primitives.collection.PrimitiveCollection

containsAny

Methods inherited from interface org.joda.primitives.PrimitiveCollectable

clone, isEmpty, optimize, size

Constructor Detail

AbstractByteList

protected AbstractByteList()

Constructor.

Method Detail

iterator

public ByteListIterator iterator()

Gets an iterator over this list.

Specified by:

iterator in interface Iterable<Byte>

Specified by:

iterator in interface Collection<Byte>

Specified by:

iterator in interface List<Byte>

Specified by:

iterator in interface ByteCollection

Specified by:

iterator in interface ByteIterable

Specified by:

iterator in interface ByteList

Returns:

an iterator over this list, not null

listIterator

public ByteListIterator listIterator()

Gets a list iterator over this list.

This implementation uses byteListIterator(int).

Specified by:

listIterator in interface List<Byte>

Specified by:

listIterator in interface ByteList

Returns:

an iterator over this list, not null

listIterator

public ByteListIterator listIterator(int index)

Gets a list iterator over this list from a start index.

Specified by:

listIterator in interface List<Byte>

Specified by:

listIterator in interface ByteList

Parameters:

index - the index to start from

Returns:

an iterator over this list, not null

Throws:

IndexOutOfBoundsException - if the index is invalid

firstByte

public byte firstByte()

Gets the first primitive value.

Specified by:

firstByte in interface ByteList

Returns:

value at index zero

Throws:

IndexOutOfBoundsException - if the size is zero

lastByte

public byte lastByte()

Gets the last primitive value.

Specified by:

lastByte in interface ByteList

Returns:

value at index size() - 1

Throws:

IndexOutOfBoundsException - if the size is zero

contains

public boolean contains(byte value)

Checks whether this collection contains a specified primitive value.

This implementation uses getByte(int).

Specified by:

contains in interface ByteCollection

Overrides:

contains in class AbstractByteCollection

Parameters:

value - the value to search for

Returns:

true if the value is found

indexOf

public int indexOf(byte value)

Gets the first index of the specified primitive value.

This implementation uses indexof(byte, int).

Specified by:

indexOf in interface ByteList

Parameters:

value - the value to search for

Returns:

the zero-based index, or -1 if not found

indexOf

public int indexOf(byte value,
                   int fromIndexInclusive)

Gets the first index of the specified primitive value from an index.

This method follows the conventions of String in that a negative index is treated as zero, and an index greater than the list size will simply return -1.

This implementation uses get(int).

Specified by:

indexOf in interface ByteList

Parameters:

value - the value to search for

fromIndexInclusive - the index to start searching from, inclusive

Returns:

the zero-based index, or -1 if not found

lastIndexOf

public int lastIndexOf(byte value)

Gets the last index of the specified primitive value.

This implementation uses lastIndexof(byte, int).

Specified by:

lastIndexOf in interface ByteList

Parameters:

value - the value to search for

Returns:

the zero-based index, or -1 if not found

lastIndexOf

public int lastIndexOf(byte value,
                       int fromIndexInclusive)

Gets the first index of the specified primitive value from an index.

This method follows the conventions of String in that an index greater than the list size will start searching at the list size, and a negative index simply returns -1.

This implementation uses get(int).

Specified by:

lastIndexOf in interface ByteList

Parameters:

value - the value to search for

fromIndexInclusive - the index to start searching from, inclusive

Returns:

the zero-based index, or -1 if not found

toByteArray

public byte[] toByteArray(int fromIndexInclusive,
                          int toIndexExclusive)

Gets a range of elements as an array.

Specified by:

toByteArray in interface ByteList

Parameters:

fromIndexInclusive - the index to start from, inclusive

toIndexExclusive - the index to end at, exclusive

Returns:

a new array containing a copy of the range of elements, not null

Throws:

IndexOutOfBoundsException - if either index is invalid

subList

public ByteList subList(int fromIndexInclusive,
                        int toIndexExclusive)

Gets a range view of part of this list.

This method allows operations to work on a range within the greater list. Changes made to the either object will affect the other.

Specified by:

subList in interface List<Byte>

Specified by:

subList in interface ByteList

Parameters:

fromIndexInclusive - the index to start from, inclusive

toIndexExclusive - the index to end at, exclusive

Returns:

a new ByteList for the subList, not null

Throws:

IndexOutOfBoundsException - if either index is invalid

clear

public void clear()

Clears the listof all elements (optional operation).

This implementation uses removeRange(int, int).

Specified by:

clear in interface Collection<Byte>

Specified by:

clear in interface List<Byte>

Specified by:

clear in interface PrimitiveCollectable<Byte>

Overrides:

clear in class AbstractByteCollection

Throws:

UnsupportedOperationException - if method not supported by this collection

add

public boolean add(byte value)

Adds a primitive value to this collection (optional operation).

This implementation uses add(int, byte).

Specified by:

add in interface ByteCollection

Overrides:

add in class AbstractByteCollection

Parameters:

value - the value to add to this collection

Returns:

true if this collection was modified by this method call

Throws:

IllegalArgumentException - if value is rejected by this collection

UnsupportedOperationException - if not supported by this collection

add

public boolean add(int index,
                   byte value)

Adds a primitive value to this list at an index (optional operation).

This implementation throws UnsupportedOperationException.

Specified by:

add in interface ByteList

Parameters:

index - the index to add at

value - the value to add to this collection

Returns:

true if this list was modified by this method call

Throws:

IndexOutOfBoundsException - if the index is invalid

IllegalArgumentException - if value is rejected by this collection

UnsupportedOperationException - if not supported by this collection

addAll

public boolean addAll(byte[] values)

Adds an array of primitive values to this list at an index (optional operation).

This implementation uses addAll(int, byte).

Specified by:

addAll in interface ByteCollection

Overrides:

addAll in class AbstractByteCollection

Parameters:

values - the values to add to this collection, null treated as empty array

Returns:

true if this list was modified by this method call

Throws:

IndexOutOfBoundsException - if the index is invalid

IllegalArgumentException - if value is rejected by this collection

UnsupportedOperationException - if not supported by this collection

addAll

public boolean addAll(int index,
                      byte[] values)

Adds an array of primitive values to this list at an index (optional operation).

This method is optional, throwing an UnsupportedOperationException if the collection cannot be added to.

Specified by:

addAll in interface ByteList

Parameters:

index - the index to add at

values - the values to add to this collection, null treated as empty array

Returns:

true if this list was modified by this method call

Throws:

IndexOutOfBoundsException - if the index is invalid

IllegalArgumentException - if value is rejected by this collection

UnsupportedOperationException - if not supported by this collection

removeByteAt

public byte removeByteAt(int index)

Removes a primitive value by index from the list (optional operation).

This implementation throws UnsupportedOperationException.

Specified by:

removeByteAt in interface ByteList

Parameters:

index - the index to remove from

Returns:

the primitive value previously at this index

Throws:

IndexOutOfBoundsException - if the index is invalid

UnsupportedOperationException - if not supported by this collection

removeByte

public boolean removeByte(byte value)

Removes the first occurrence of a primitive value from the list (optional operation).

This implementation uses get(int) and removeByteAt(int).

Parameters:

value - the value to remove

Returns:

the primitive value previously at this index

Throws:

UnsupportedOperationException - if not supported by this collection

removeRange

public boolean removeRange(int fromIndexInclusive,
                           int toIndexExclusive)

Removes a range of values from the list (optional operation).

This implementation uses removeByteAt(int).

Specified by:

removeRange in interface PrimitiveList<Byte>

Parameters:

fromIndexInclusive - the start of the range to remove, inclusive

toIndexExclusive - the end of the range to remove, exclusive

Returns:

true if the collection was modified

Throws:

IndexOutOfBoundsException - if the index is invalid

UnsupportedOperationException - if remove is not supported

set

public byte set(int index,
                byte value)

Sets the primitive value at a specified index.

This implementation throws UnsupportedOperationException.

Specified by:

set in interface ByteList

Parameters:

index - the index to set

value - the value to store

Returns:

the previous value at the index

Throws:

IndexOutOfBoundsException - if the index is invalid

IllegalArgumentException - if value is rejected by this collection

UnsupportedOperationException - if not supported by this collection

get

public Byte get(int index)

Gets the Byte value at the specified index.

Specified by:

get in interface List<Byte>

Parameters:

index - the index to get from

Returns:

value at the index

Throws:

IndexOutOfBoundsException - if the index is invalid

first

public Byte first()

Gets the first Byte value.

Specified by:

first in interface PrimitiveList<Byte>

Returns:

value at index zero or null if the size is zero

last

public Byte last()

Gets the last Byte value.

Specified by:

last in interface PrimitiveList<Byte>

Returns:

value at index size() - 1 or null if the size is zero

indexOf

public int indexOf(Object value)

Gets the first index of the specified Byte value.

Specified by:

indexOf in interface List<Byte>

Parameters:

value - the value to search for

Returns:

the zero-based index, or -1 if not found

Throws:

NullPointerException - if the value if null

ClassCastException - if the object is not Byte

indexOf

public int indexOf(Object value,
                   int fromIndexInclusive)

Gets the first index of the specified Byte value from an index.

This method follows the conventions of String in that a negative index is treated as zero, and an index greater than the list size will simply return -1.

Parameters:

value - the value to search for

fromIndexInclusive - the index to start searching from, inclusive

Returns:

the zero-based index, or -1 if not found

Throws:

NullPointerException - if the value if null

ClassCastException - if the object is not Byte

lastIndexOf

public int lastIndexOf(Object value)

Gets the last index of the specified Byte value.

Specified by:

lastIndexOf in interface List<Byte>

Parameters:

value - the value to search for

Returns:

the zero-based index, or -1 if not found

Throws:

NullPointerException - if the value if null

ClassCastException - if the object is not Byte

lastIndexOf

public int lastIndexOf(Object value,
                       int fromIndexInclusive)

Gets the first index of the specified Byte value from an index.

This method follows the conventions of String in that an index greater than the list size will start searching at the list size, and a negative index simply returns -1.

Parameters:

value - the value to search for

fromIndexInclusive - the index to start searching from, inclusive

Returns:

the zero-based index, or -1 if not found

Throws:

NullPointerException - if the value if null

ClassCastException - if the object is not Byte

add

public boolean add(Byte value)

Adds the Byte value to this collection (optional operation).

This method is optional, throwing an UnsupportedOperationException if the collection cannot be added to.

Specified by:

add in interface Collection<Byte>

Specified by:

add in interface List<Byte>

Overrides:

add in class AbstractByteCollection

Parameters:

value - the value to add to this collection

Returns:

true if this collection was modified by this method call

Throws:

IllegalArgumentException - if value is rejected by this collection

UnsupportedOperationException - if not supported by this collection

add

public void add(int index,
                Byte value)

Adds the Byte value to this list at an index (optional operation).

This method is optional, throwing an UnsupportedOperationException if the collection cannot be added to.

Specified by:

add in interface List<Byte>

Parameters:

index - the index to add at

value - the value to add to this collection

Throws:

IndexOutOfBoundsException - if the index is invalid

ClassCastException - if the object is not Byte

IllegalArgumentException - if value is rejected by this collection

UnsupportedOperationException - if not supported by this collection

addAll

public boolean addAll(int index,
                      Collection<? extends Byte> coll)

Adds an array of Byte values to this list at an index (optional operation).

This method is optional, throwing an UnsupportedOperationException if the collection cannot be added to.

Specified by:

addAll in interface List<Byte>

Parameters:

index - the index to add at

coll - the values to add to this collection

Returns:

true if this list was modified by this method call

Throws:

IndexOutOfBoundsException - if the index is invalid

ClassCastException - if any object is not Byte

IllegalArgumentException - if value is rejected by this collection

UnsupportedOperationException - if not supported by this collection

remove

public Byte remove(int index)

Deprecated. This method should only be used when working with List and not when working with ByteList - use removeByteAt(int)

Removes a primitive value by index from the list (optional operation).

This implementation uses removeByteAt(int).

Specified by:

remove in interface List<Byte>

Specified by:

remove in interface ByteList

Parameters:

index - the index to remove from

Returns:

the primitive value previously at this index

Throws:

IndexOutOfBoundsException - if the index is invalid

UnsupportedOperationException - if not supported by this collection

set

public Byte set(int index,
                Byte value)

Sets the Byte value at a specified index.

This implementation uses set(int, byte).

Specified by:

set in interface List<Byte>

Parameters:

index - the index to set

value - the value to store

Returns:

the previous value at the index

Throws:

IndexOutOfBoundsException - if the index is invalid

IllegalArgumentException - if value is rejected by this collection

UnsupportedOperationException - if not supported by this collection

equals

public boolean equals(Object obj)

Compares this list to another as per the contract of List.

Specified by:

equals in interface Collection<Byte>

Specified by:

equals in interface List<Byte>

Overrides:

equals in class Object

Parameters:

obj - the object to compare to

Returns:

true if the lists are equal

hashCode

public int hashCode()

Gets the hashCode of this list as per the contract of List.

Specified by:

hashCode in interface Collection<Byte>

Specified by:

hashCode in interface List<Byte>

Overrides:

hashCode in class Object

Returns:

the hash code for this list

arrayCopy

protected void arrayCopy(int fromIndex,
                         byte[] dest,
                         int destIndex,
                         int size)

Copies data from this collection into the specified array. This method is pre-validated.

Overrides:

arrayCopy in class AbstractByteCollection

Parameters:

fromIndex - the index to start from

dest - the destination array

destIndex - the destination start index

size - the number of items to copy

isSetModifiable

protected boolean isSetModifiable()

Are the set methods supported.

This implementation returns false.

Returns:

true if supported

isModifiable

public boolean isModifiable()

Is the collection modifiable in any way.

Specified by:

isModifiable in interface PrimitiveCollectable<Byte>

Overrides:

isModifiable in class AbstractByteCollection

Returns:

true if supported

checkSetModifiable

protected void checkSetModifiable()

Check whether add is suported and throw an exception.

checkIndexExists

protected void checkIndexExists(int index)

Checks whether an index is valid or not.

Parameters:

index - the index to check

Throws:

IndexOutOfBoundsException - if either index is invalid

checkIndex

protected void checkIndex(int index)

Checks whether an index is valid or not.

Parameters:

index - the index to check

Throws:

IndexOutOfBoundsException - if either index is invalid

checkRange

protected void checkRange(int fromIndexInclusive,
                          int toIndexExclusive)

Checks whether a range is valid or not.

Parameters:

fromIndexInclusive - the index to start from, inclusive

toIndexExclusive - the index to end at, exclusive

Throws:

IndexOutOfBoundsException - if either index is invalid