com.webobjects.foundation

Class NSMutableArray<E>

java.lang.Object

com.webobjects.foundation.NSArray<E>

com.webobjects.foundation.NSMutableArray<E>

Type Parameters:

E - type of array contents

All Implemented Interfaces:

com.webobjects.foundation._NSFoundationCollection, com.webobjects.foundation.NSCoding, com.webobjects.foundation.NSKeyValueCoding, com.webobjects.foundation.NSKeyValueCodingAdditions, Serializable, Cloneable, Iterable<E>, Collection<E>, List<E>, RandomAccess

Direct Known Subclasses:

_EOCheapCopyMutableArray, ERXBatchingDisplayGroup.FakeArray, ERXMutableArray, ERXQueryAttributes, ERXSortOrdering.ERXSortOrderings

public class NSMutableArray<E>
extends NSArray<E>
implements RandomAccess

Bugfix reimplementation of NSMutableArray. To be able to use this class, the framework this class resides in must be before JavaFoundation.framework in your classpath.

It fixes a lot of issues:

• implements the correct Collection methods, so you can anArray.add(anObject)
• has several performance improvements that make EOF faster by several orders of magnitude when you have large record sets
• fixes a bug when the actual objects were handed out replaceObjectAtIndex()
• fixes a bug when the iterator method wasn't firing a fault in _EOCheapCopyMutableArray

Once these issues are resolved in a WO distribution, this class will go away and the Apple supplied will will be used again without changes in code on your side.

NSMutableArray のバッグフィックス再実装。 このクラスを使用する為には現フレームワークのクラスパスが JavaFoundation.framework の前にある必要があります。

次の問題を対応しています:

• 正しいコレクション・メソッドの実装：anArray.add(anObject) が可能
• 大きなレコード・セットの場合でのスピード改良で EOF が早くなるのです
• 実際のオブジェクトが replaceObjectAtIndex() の外で処理されるバッグフィックス
• _EOCheapCopyMutableArray でのフォルトはトリーガされない問題のバッグフィックス

See Also:

Serialized Form

Author:

ak

Nested Class Summary

Nested classes/interfaces inherited from class com.webobjects.foundation.NSArray

NSArray._AvgNumberOperator, NSArray._CountOperator, NSArray._MaxOperator, NSArray._MinOperator, NSArray._Operator, NSArray._SumNumberOperator, NSArray.Operator

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSCoding

com.webobjects.foundation.NSCoding._BigDecimalSupport, com.webobjects.foundation.NSCoding._BigIntegerSupport, com.webobjects.foundation.NSCoding._BooleanSupport, com.webobjects.foundation.NSCoding._ByteSupport, com.webobjects.foundation.NSCoding._CharacterSupport, com.webobjects.foundation.NSCoding._DateSupport, com.webobjects.foundation.NSCoding._DoubleSupport, com.webobjects.foundation.NSCoding._FloatSupport, com.webobjects.foundation.NSCoding._IntegerSupport, com.webobjects.foundation.NSCoding._LongSupport, com.webobjects.foundation.NSCoding._NumberSupport, com.webobjects.foundation.NSCoding._ShortSupport, com.webobjects.foundation.NSCoding._StringSupport, com.webobjects.foundation.NSCoding.Support

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

com.webobjects.foundation.NSKeyValueCodingAdditions.DefaultImplementation, com.webobjects.foundation.NSKeyValueCodingAdditions.Utility

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCoding

com.webobjects.foundation.NSKeyValueCoding._BooleanFieldBinding, com.webobjects.foundation.NSKeyValueCoding._BooleanMethodBinding, com.webobjects.foundation.NSKeyValueCoding._FieldBinding, com.webobjects.foundation.NSKeyValueCoding._ForwardingBinding, com.webobjects.foundation.NSKeyValueCoding._KeyBinding, com.webobjects.foundation.NSKeyValueCoding._KeyBindingCreation, com.webobjects.foundation.NSKeyValueCoding._MethodBinding, com.webobjects.foundation.NSKeyValueCoding._NumberFieldBinding, com.webobjects.foundation.NSKeyValueCoding._NumberMethodBinding, com.webobjects.foundation.NSKeyValueCoding._ReflectionKeyBindingCreation, com.webobjects.foundation.NSKeyValueCoding.ErrorHandling, com.webobjects.foundation.NSKeyValueCoding.MapImplementation, com.webobjects.foundation.NSKeyValueCoding.Null<T>, com.webobjects.foundation.NSKeyValueCoding.UnknownKeyException, com.webobjects.foundation.NSKeyValueCoding.ValueAccessor

Field Summary

Fields

Modifier and Type	Field and Description
protected int	_capacity
static Class	_CLASS
protected int	_count
protected Object[]	_objectsCache
static Object	ERX_MARKER
protected int	modCount

Fields inherited from class com.webobjects.foundation.NSArray

_hashCache, _NSArrayClassHashCode, _objects, AverageOperatorName, CheckForNull, CountOperatorName, EmptyArray, IgnoreNull, MaximumOperatorName, MinimumOperatorName, NotFound, SumOperatorName

Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

_KeyPathSeparatorChar, KeyPathSeparator

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

NullValue

Constructor Summary

Constructors

Constructor and Description
NSMutableArray()
NSMutableArray(Collection<? extends E> collection)
NSMutableArray(E object)
NSMutableArray(E[] objects)
NSMutableArray(E[] objects, com.webobjects.foundation.NSRange range)
NSMutableArray(E object, E... objects)
NSMutableArray(int capacity)
NSMutableArray(List<? extends E> list, com.webobjects.foundation.NSRange range, boolean ignoreNull)
NSMutableArray(NSArray<? extends E> otherArray)
NSMutableArray(Vector<? extends E> vector, com.webobjects.foundation.NSRange range, boolean ignoreNull)

Method Summary

Modifier and Type	Method and Description
protected void	_ensureCapacity(int capacity)
protected void	_initializeWithCapacity(int capacity)
void	_moveObjectAtIndexToIndex(int sourceIndex, int destIndex)
protected void	_setCount(int count)
boolean	add(E element)
void	add(int index, E element)
boolean	addAll(Collection<? extends E> collection)
boolean	addAll(int index, Collection<? extends E> collection)
void	addObject(E object)
void	addObjects(E... objects)
void	addObjectsFromArray(NSArray<? extends E> otherArray)
void	clear()
Object	clone()
int	count()
void	ensureCapacity(int capacity)
NSArray<E>	immutableClone()
void	insertObjectAtIndex(E object, int index)
Iterator<E>	iterator()
ListIterator<E>	listIterator()
ListIterator<E>	listIterator(int index)
NSMutableArray<E>	mutableClone()
protected Object[]	objectsNoCopy()
E	remove(int index)
boolean	remove(Object o)
boolean	removeAll(Collection<?> collection)
void	removeAllObjects()
boolean	removeIdenticalObject(Object object)
boolean	removeIdenticalObject(Object object, com.webobjects.foundation.NSRange range)
E	removeLastObject()
boolean	removeObject(Object object)
boolean	removeObject(Object object, com.webobjects.foundation.NSRange range)
E	removeObjectAtIndex(int index)
void	removeObjects(Object... otherObjects) Much faster implementation of the remove method for larger arrays.
void	removeObjectsInArray(NSArray<?> otherArray)
void	removeObjectsInRange(com.webobjects.foundation.NSRange range)
protected void	removeRange(int fromIndex, int toIndex)
E	replaceObjectAtIndex(E object, int index) Clears the objectsNoCopy too.
void	replaceObjectAtIndex(int index, E object) Deprecated. use replaceObjectAtIndex(Object, int)
void	replaceObjectsInRange(com.webobjects.foundation.NSRange range, NSArray<? extends E> otherArray, com.webobjects.foundation.NSRange otherRange)
boolean	retainAll(Collection<?> c)
E	set(int index, E element)
void	setArray(NSArray<? extends E> otherArray)
void	sortUsingComparator(com.webobjects.foundation.NSComparator comparator)
List<E>	subList(int fromIndex, int toIndex)
<T> T[]	toArray(T[] array) Bugfix for the broken implementation in NSArray.
void	trimToSize()

Methods inherited from class com.webobjects.foundation.NSArray

_mustRecomputeHash, _mutableComponentsSeparatedByString, _objects, _setMustRecomputeHash, _setObjects, _shallowHashCode, arrayByAddingObject, arrayByAddingObjectsFromArray, arrayList, classForCoder, componentsJoinedByString, componentsSeparatedByString, contains, containsAll, containsObject, decodeObject, emptyArray, encodeWithCoder, equals, firstObjectCommonWithArray, get, getObjects, getObjects, hashCode, indexOf, indexOfIdenticalObject, indexOfIdenticalObject, indexOfObject, indexOfObject, isEmpty, isEqualToArray, lastIndexOf, lastObject, makeObjectsPerformSelector, objectAtIndex, objectEnumerator, objects, objects, operatorForKey, operatorNames, removeOperatorForKey, reverseObjectEnumerator, setOperatorForKey, size, sortedArrayUsingComparator, sortedArrayUsingSelector, subarrayWithRange, takeValueForKey, takeValueForKeyPath, toArray, toString, valueForKey, valueForKey, valueForKey, valueForKeyPath, valueForKeyPath, vector

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.List

replaceAll, sort, spliterator

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Field Detail

_CLASS

public static final Class _CLASS

ERX_MARKER

public static final Object ERX_MARKER

modCount

protected transient int modCount

_capacity

protected transient int _capacity

_objectsCache

protected transient Object[] _objectsCache

_count

protected transient int _count

Constructor Detail

NSMutableArray

public NSMutableArray()

NSMutableArray

public NSMutableArray(Collection<? extends E> collection)

NSMutableArray

public NSMutableArray(int capacity)

NSMutableArray

public NSMutableArray(E object)

NSMutableArray

public NSMutableArray(E[] objects)

NSMutableArray

public NSMutableArray(E object,
                      E... objects)

NSMutableArray

public NSMutableArray(E[] objects,
                      com.webobjects.foundation.NSRange range)

NSMutableArray

public NSMutableArray(NSArray<? extends E> otherArray)

NSMutableArray

public NSMutableArray(Vector<? extends E> vector,
                      com.webobjects.foundation.NSRange range,
                      boolean ignoreNull)

NSMutableArray

public NSMutableArray(List<? extends E> list,
                      com.webobjects.foundation.NSRange range,
                      boolean ignoreNull)

Method Detail

_initializeWithCapacity

protected void _initializeWithCapacity(int capacity)

Overrides:

_initializeWithCapacity in class NSArray<E>

_ensureCapacity

protected void _ensureCapacity(int capacity)

ensureCapacity

public void ensureCapacity(int capacity)

trimToSize

public void trimToSize()

_setCount

protected void _setCount(int count)

Overrides:

_setCount in class NSArray<E>

setArray

public void setArray(NSArray<? extends E> otherArray)

objectsNoCopy

protected Object[] objectsNoCopy()

Overrides:

objectsNoCopy in class NSArray<E>

count

public int count()

Overrides:

count in class NSArray<E>

addObject

public void addObject(E object)

addObjects

public void addObjects(E... objects)

replaceObjectAtIndex

@Deprecated
public void replaceObjectAtIndex(int index,
                                             E object)

Deprecated. use replaceObjectAtIndex(Object, int)

insertObjectAtIndex

public void insertObjectAtIndex(E object,
                                int index)

removeObjectAtIndex

public E removeObjectAtIndex(int index)

removeAllObjects

public void removeAllObjects()

sortUsingComparator

public void sortUsingComparator(com.webobjects.foundation.NSComparator comparator)
                         throws com.webobjects.foundation.NSComparator.ComparisonException

Throws:

com.webobjects.foundation.NSComparator.ComparisonException

addObjectsFromArray

public void addObjectsFromArray(NSArray<? extends E> otherArray)

replaceObjectsInRange

public void replaceObjectsInRange(com.webobjects.foundation.NSRange range,
                                  NSArray<? extends E> otherArray,
                                  com.webobjects.foundation.NSRange otherRange)

removeLastObject

public E removeLastObject()

removeObject

public boolean removeObject(Object object)

removeObject

public boolean removeObject(Object object,
                            com.webobjects.foundation.NSRange range)

removeIdenticalObject

public boolean removeIdenticalObject(Object object)

removeIdenticalObject

public boolean removeIdenticalObject(Object object,
                                     com.webobjects.foundation.NSRange range)

removeObjectsInArray

public void removeObjectsInArray(NSArray<?> otherArray)

removeObjectsInRange

public void removeObjectsInRange(com.webobjects.foundation.NSRange range)

clone

public Object clone()

Overrides:

clone in class NSArray<E>

immutableClone

public NSArray<E> immutableClone()

Overrides:

immutableClone in class NSArray<E>

mutableClone

public NSMutableArray<E> mutableClone()

Overrides:

mutableClone in class NSArray<E>

_moveObjectAtIndexToIndex

public void _moveObjectAtIndexToIndex(int sourceIndex,
                                      int destIndex)

replaceObjectAtIndex

public E replaceObjectAtIndex(E object,
                              int index)

Clears the objectsNoCopy too. It's wrong not to clear it.

Parameters:

object - the replacement object

index - index of object to replace

Returns:

object that has been replaced

removeObjects

public void removeObjects(Object... otherObjects)

Much faster implementation of the remove method for larger arrays.

Parameters:

otherObjects - objects to remove

toArray

public <T> T[] toArray(T[] array)

Bugfix for the broken implementation in NSArray.

Specified by:

toArray in interface Collection<E>

Specified by:

toArray in interface List<E>

Overrides:

toArray in class NSArray<E>

set

public E set(int index,
             E element)

Specified by:

set in interface List<E>

Overrides:

set in class NSArray<E>

add

public void add(int index,
                E element)

Specified by:

add in interface List<E>

Overrides:

add in class NSArray<E>

add

public boolean add(E element)

Specified by:

add in interface Collection<E>

Specified by:

add in interface List<E>

Overrides:

add in class NSArray<E>

addAll

public boolean addAll(Collection<? extends E> collection)

Specified by:

addAll in interface Collection<E>

Specified by:

addAll in interface List<E>

Overrides:

addAll in class NSArray<E>

addAll

public boolean addAll(int index,
                      Collection<? extends E> collection)

Specified by:

addAll in interface List<E>

Overrides:

addAll in class NSArray<E>

remove

public E remove(int index)

Specified by:

remove in interface List<E>

Overrides:

remove in class NSArray<E>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<E>

Specified by:

remove in interface List<E>

Overrides:

remove in class NSArray<E>

clear

public void clear()

Specified by:

clear in interface Collection<E>

Specified by:

clear in interface List<E>

Overrides:

clear in class NSArray<E>

retainAll

public boolean retainAll(Collection<?> c)

Specified by:

retainAll in interface Collection<E>

Specified by:

retainAll in interface List<E>

Overrides:

retainAll in class NSArray<E>

removeAll

public boolean removeAll(Collection<?> collection)

Specified by:

removeAll in interface Collection<E>

Specified by:

removeAll in interface List<E>

Overrides:

removeAll in class NSArray<E>

iterator

public Iterator<E> iterator()

Specified by:

iterator in interface Iterable<E>

Specified by:

iterator in interface Collection<E>

Specified by:

iterator in interface List<E>

Overrides:

iterator in class NSArray<E>

listIterator

public ListIterator<E> listIterator()

Specified by:

listIterator in interface List<E>

Overrides:

listIterator in class NSArray<E>

listIterator

public ListIterator<E> listIterator(int index)

Specified by:

listIterator in interface List<E>

Overrides:

listIterator in class NSArray<E>

subList

public List<E> subList(int fromIndex,
                       int toIndex)

Specified by:

subList in interface List<E>

Overrides:

subList in class NSArray<E>

removeRange

protected void removeRange(int fromIndex,
                           int toIndex)