com.webobjects.foundation

Class NSArray<E>

java.lang.Object

com.webobjects.foundation.NSArray<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>

Direct Known Subclasses:

_EOCheapCopyArray, ERXEnterpriseObjectArrayCache.NotFoundArray, ERXFaultArray, NSMutableArray

public class NSArray<E>
extends Object
implements Cloneable, Serializable, com.webobjects.foundation.NSCoding, com.webobjects.foundation.NSKeyValueCoding, com.webobjects.foundation.NSKeyValueCodingAdditions, com.webobjects.foundation._NSFoundationCollection, List<E>

NSArray re-implementation to support JDK 1.5 templates. Use with

JDK 1.5 テンプレートをサポートする為の再実装。使用は

 NSArray<Bug> bugs = ds.fetchObjects();
 
 for(Bug : bugs) {
          ...
 }

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NSArray._AvgNumberOperator
static class	NSArray._CountOperator
static class	NSArray._MaxOperator
static class	NSArray._MinOperator
static class	NSArray._Operator
static class	NSArray._SumNumberOperator
static interface	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
static Class	_CLASS
protected int	_hashCache
protected static int	_NSArrayClassHashCode
protected Object[]	_objects
static String	AverageOperatorName
static boolean	CheckForNull
static String	CountOperatorName
static NSArray	EmptyArray
static boolean	IgnoreNull
static String	MaximumOperatorName
static String	MinimumOperatorName
static int	NotFound
static String	SumOperatorName

Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

_KeyPathSeparatorChar, KeyPathSeparator

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

NullValue

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
protected void	_initializeWithCapacity(int capacity)
protected boolean	_mustRecomputeHash()
static NSMutableArray<String>	_mutableComponentsSeparatedByString(String string, String separator)
protected Object[]	_objects()
protected void	_setCount(int count)
protected void	_setMustRecomputeHash(boolean change)
protected void	_setObjects(Object[] objects)
int	_shallowHashCode()
boolean	add(E element)
void	add(int index, E element)
boolean	addAll(Collection<? extends E> collection)
boolean	addAll(int index, Collection<? extends E> collection)
NSArray<E>	arrayByAddingObject(E object)
NSArray<E>	arrayByAddingObjectsFromArray(NSArray<? extends E> otherArray)
ArrayList<E>	arrayList()
Class	classForCoder()
void	clear()
Object	clone()
String	componentsJoinedByString(String separator)
static NSArray<String>	componentsSeparatedByString(String string, String separator)
boolean	contains(Object element)
boolean	containsAll(Collection<?> c)
boolean	containsObject(Object object)
int	count()
static Object	decodeObject(com.webobjects.foundation.NSCoder coder)
static <T> NSArray<T>	emptyArray()
void	encodeWithCoder(com.webobjects.foundation.NSCoder coder)
boolean	equals(Object object)
E	firstObjectCommonWithArray(NSArray<?> otherArray)
E	get(int index)
void	getObjects(Object[] objects) Deprecated. use objects() or objectsNoCopy()
void	getObjects(Object[] objects, com.webobjects.foundation.NSRange range) Deprecated. use objects(NSRange)
int	hashCode()
NSArray<E>	immutableClone()
int	indexOf(Object element)
int	indexOfIdenticalObject(Object object)
int	indexOfIdenticalObject(Object object, com.webobjects.foundation.NSRange range)
int	indexOfObject(Object object)
int	indexOfObject(Object object, com.webobjects.foundation.NSRange range)
boolean	isEmpty()
boolean	isEqualToArray(NSArray<?> otherArray)
Iterator<E>	iterator()
int	lastIndexOf(Object element)
E	lastObject()
ListIterator<E>	listIterator()
ListIterator<E>	listIterator(int index)
void	makeObjectsPerformSelector(com.webobjects.foundation.NSSelector selector, Object... parameters)
NSMutableArray<E>	mutableClone()
E	objectAtIndex(int index)
Enumeration<E>	objectEnumerator()
Object[]	objects()
Object[]	objects(com.webobjects.foundation.NSRange range)
protected Object[]	objectsNoCopy()
static NSArray.Operator	operatorForKey(String operatorName)
static NSArray<String>	operatorNames()
E	remove(int index)
boolean	remove(Object object)
boolean	removeAll(Collection<?> collection)
static void	removeOperatorForKey(String operatorName)
boolean	retainAll(Collection<?> collection)
Enumeration<E>	reverseObjectEnumerator()
E	set(int index, E element)
static void	setOperatorForKey(String operatorName, NSArray.Operator arrayOperator)
int	size()
NSArray<E>	sortedArrayUsingComparator(com.webobjects.foundation.NSComparator comparator)
NSArray	sortedArrayUsingSelector(com.webobjects.foundation.NSSelector selector) Deprecated. Method sortedArrayUsingSelector is deprecated
NSArray<E>	subarrayWithRange(com.webobjects.foundation.NSRange range)
List<E>	subList(int fromIndex, int toIndex)
void	takeValueForKey(Object value, String key)
void	takeValueForKeyPath(Object value, String keyPath)
Object[]	toArray()
<T> T[]	toArray(T[] objects)
String	toString()
<T> NSArray<T>	valueForKey(ERXKey<T> erxKey) A type-safe wrapper for valueForKey(String) that automatically does the following (in order) to the resulting array prior to returning it: remove NSKeyValueCoding.Null elements flatten all elements that are arrays (Only if ERXKey.isToManyRelationship() returns true, which can only possibly happen if ERXKey.type() has been set.) remove all duplicate objects
<T> NSArray<T>	valueForKey(ERXKey<T> erxKey, boolean removeNulls, boolean distinct, boolean flatten) A type-safe wrapper for valueForKeyPath(String) that calls valueForKeyPath(erxKey.key()) and attempts to cast the result to NSArray<T>.
Object	valueForKey(String key)
<T> NSArray<T>	valueForKeyPath(ERXKey<T> erxKey) A type-safe wrapper for valueForKeyPath(String) that simply calls valueForKeyPath(erxKey.key()) and attempts to cast the result to NSArray<T>.
Object	valueForKeyPath(String keyPath)
Vector<E>	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

NotFound

public static final int NotFound

See Also:

Constant Field Values

EmptyArray

public static final NSArray EmptyArray

CountOperatorName

public static final String CountOperatorName

See Also:

Constant Field Values

MaximumOperatorName

public static final String MaximumOperatorName

See Also:

Constant Field Values

MinimumOperatorName

public static final String MinimumOperatorName

See Also:

Constant Field Values

SumOperatorName

public static final String SumOperatorName

See Also:

Constant Field Values

AverageOperatorName

public static final String AverageOperatorName

See Also:

Constant Field Values

_NSArrayClassHashCode

protected static final int _NSArrayClassHashCode

_objects

protected Object[] _objects

_hashCache

protected transient int _hashCache

CheckForNull

public static final boolean CheckForNull

See Also:

Constant Field Values

IgnoreNull

public static final boolean IgnoreNull

See Also:

Constant Field Values

Constructor Detail

NSArray

public NSArray()

NSArray

public NSArray(E object)

NSArray

protected NSArray(Object[] objects,
                  int rangeLocation,
                  int rangeLength,
                  boolean checkForNull,
                  boolean ignoreNull)

NSArray

public NSArray(E[] objects)

NSArray

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

NSArray

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

NSArray

public NSArray(NSArray<? extends E> otherArray)

NSArray

public NSArray(List<? extends E> list,
               boolean checkForNull)

NSArray

public NSArray(Collection<? extends E> collection,
               boolean checkForNull)

NSArray

public NSArray(Collection<? extends E> collection)

NSArray

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

NSArray

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

Method Detail

operatorNames

public static NSArray<String> operatorNames()

setOperatorForKey

public static void setOperatorForKey(String operatorName,
                                     NSArray.Operator arrayOperator)

operatorForKey

public static NSArray.Operator operatorForKey(String operatorName)

removeOperatorForKey

public static void removeOperatorForKey(String operatorName)

_initializeWithCapacity

protected void _initializeWithCapacity(int capacity)

_setCount

protected void _setCount(int count)

_objects

protected Object[] _objects()

_setObjects

protected void _setObjects(Object[] objects)

objectsNoCopy

protected Object[] objectsNoCopy()

count

public int count()

objectAtIndex

public E objectAtIndex(int index)

arrayByAddingObject

public NSArray<E> arrayByAddingObject(E object)

arrayByAddingObjectsFromArray

public NSArray<E> arrayByAddingObjectsFromArray(NSArray<? extends E> otherArray)

objects

public Object[] objects()

objects

public Object[] objects(com.webobjects.foundation.NSRange range)

vector

public Vector<E> vector()

arrayList

public ArrayList<E> arrayList()

containsObject

public boolean containsObject(Object object)

firstObjectCommonWithArray

public E firstObjectCommonWithArray(NSArray<?> otherArray)

getObjects

@Deprecated
public void getObjects(Object[] objects)

Deprecated. use objects() or objectsNoCopy()

getObjects

@Deprecated
public void getObjects(Object[] objects,
                                   com.webobjects.foundation.NSRange range)

Deprecated. use objects(NSRange)

indexOfObject

public int indexOfObject(Object object)

indexOfObject

public int indexOfObject(Object object,
                         com.webobjects.foundation.NSRange range)

indexOfIdenticalObject

public int indexOfIdenticalObject(Object object)

indexOfIdenticalObject

public int indexOfIdenticalObject(Object object,
                                  com.webobjects.foundation.NSRange range)

subarrayWithRange

public NSArray<E> subarrayWithRange(com.webobjects.foundation.NSRange range)

lastObject

public E lastObject()

isEqualToArray

public boolean isEqualToArray(NSArray<?> otherArray)

equals

public boolean equals(Object object)

Specified by:

equals in interface Collection<E>

Specified by:

equals in interface List<E>

Overrides:

equals in class Object

objectEnumerator

public Enumeration<E> objectEnumerator()

reverseObjectEnumerator

public Enumeration<E> reverseObjectEnumerator()

sortedArrayUsingSelector

@Deprecated
public NSArray sortedArrayUsingSelector(com.webobjects.foundation.NSSelector selector)
                                             throws com.webobjects.foundation.NSComparator.ComparisonException

Deprecated. Method sortedArrayUsingSelector is deprecated

Throws:

com.webobjects.foundation.NSComparator.ComparisonException

sortedArrayUsingComparator

public NSArray<E> sortedArrayUsingComparator(com.webobjects.foundation.NSComparator comparator)
                                      throws com.webobjects.foundation.NSComparator.ComparisonException

Throws:

com.webobjects.foundation.NSComparator.ComparisonException

componentsJoinedByString

public String componentsJoinedByString(String separator)

componentsSeparatedByString

public static NSArray<String> componentsSeparatedByString(String string,
                                                          String separator)

_mutableComponentsSeparatedByString

public static NSMutableArray<String> _mutableComponentsSeparatedByString(String string,
                                                                         String separator)

valueForKey

public Object valueForKey(String key)

Specified by:

valueForKey in interface com.webobjects.foundation.NSKeyValueCoding

takeValueForKey

public void takeValueForKey(Object value,
                            String key)

Specified by:

takeValueForKey in interface com.webobjects.foundation.NSKeyValueCoding

valueForKeyPath

public Object valueForKeyPath(String keyPath)

Specified by:

valueForKeyPath in interface com.webobjects.foundation.NSKeyValueCodingAdditions

takeValueForKeyPath

public void takeValueForKeyPath(Object value,
                                String keyPath)

Specified by:

takeValueForKeyPath in interface com.webobjects.foundation.NSKeyValueCodingAdditions

classForCoder

public Class classForCoder()

Specified by:

classForCoder in interface com.webobjects.foundation.NSCoding

decodeObject

public static Object decodeObject(com.webobjects.foundation.NSCoder coder)

encodeWithCoder

public void encodeWithCoder(com.webobjects.foundation.NSCoder coder)

Specified by:

encodeWithCoder in interface com.webobjects.foundation.NSCoding

makeObjectsPerformSelector

public void makeObjectsPerformSelector(com.webobjects.foundation.NSSelector selector,
                                       Object... parameters)

_shallowHashCode

public int _shallowHashCode()

Specified by:

_shallowHashCode in interface com.webobjects.foundation._NSFoundationCollection

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<E>

Specified by:

hashCode in interface List<E>

Overrides:

hashCode in class Object

clone

public Object clone()

Overrides:

clone in class Object

immutableClone

public NSArray<E> immutableClone()

mutableClone

public NSMutableArray<E> mutableClone()

toString

public String toString()

Overrides:

toString in class Object

_mustRecomputeHash

protected boolean _mustRecomputeHash()

_setMustRecomputeHash

protected void _setMustRecomputeHash(boolean change)

add

public void add(int index,
                E element)

Specified by:

add in interface List<E>

add

public boolean add(E element)

Specified by:

add in interface Collection<E>

Specified by:

add in interface List<E>

addAll

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

Specified by:

addAll in interface Collection<E>

Specified by:

addAll in interface List<E>

addAll

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

Specified by:

addAll in interface List<E>

contains

public boolean contains(Object element)

Specified by:

contains in interface Collection<E>

Specified by:

contains in interface List<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>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<E>

Specified by:

toArray in interface List<E>

toArray

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

Specified by:

toArray in interface Collection<E>

Specified by:

toArray in interface List<E>

containsAll

public boolean containsAll(Collection<?> c)

Specified by:

containsAll in interface Collection<E>

Specified by:

containsAll in interface List<E>

listIterator

public ListIterator<E> listIterator()

Specified by:

listIterator in interface List<E>

listIterator

public ListIterator<E> listIterator(int index)

Specified by:

listIterator in interface List<E>

get

public E get(int index)

Specified by:

get in interface List<E>

set

public E set(int index,
             E element)

Specified by:

set in interface List<E>

indexOf

public int indexOf(Object element)

Specified by:

indexOf in interface List<E>

lastIndexOf

public int lastIndexOf(Object element)

Specified by:

lastIndexOf in interface List<E>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<E>

Specified by:

isEmpty in interface List<E>

size

public int size()

Specified by:

size in interface Collection<E>

Specified by:

size in interface List<E>

remove

public E remove(int index)

Specified by:

remove in interface List<E>

remove

public boolean remove(Object object)

Specified by:

remove in interface Collection<E>

Specified by:

remove in interface List<E>

clear

public void clear()

Specified by:

clear in interface Collection<E>

Specified by:

clear in interface List<E>

retainAll

public boolean retainAll(Collection<?> collection)

Specified by:

retainAll in interface Collection<E>

Specified by:

retainAll in interface List<E>

removeAll

public boolean removeAll(Collection<?> collection)

Specified by:

removeAll in interface Collection<E>

Specified by:

removeAll in interface List<E>

subList

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

Specified by:

subList in interface List<E>

emptyArray

public static final <T> NSArray<T> emptyArray()

valueForKeyPath

public <T> NSArray<T> valueForKeyPath(ERXKey<T> erxKey)

A type-safe wrapper for valueForKeyPath(String) that simply calls valueForKeyPath(erxKey.key()) and attempts to cast the result to NSArray<T>. If the value returned cannot be cast it will throw a ClassCastException.

Type Parameters:

T - the Type of elements in the returned NSArray

Parameters:

erxKey -

Returns:

an NSArray of T objects.

Author:

David Avendasora

valueForKey

public <T> NSArray<T> valueForKey(ERXKey<T> erxKey)

A type-safe wrapper for valueForKey(String) that automatically does the following (in order) to the resulting array prior to returning it:

1. remove NSKeyValueCoding.Null elements
2. flatten all elements that are arrays (Only if ERXKey.isToManyRelationship() returns true, which can only possibly happen if ERXKey.type() has been set.)
3. remove all duplicate objects

Type Parameters:

T - the Type of elements in the returned NSArray

Parameters:

erxKey -

Returns:

an NSArray of T objects.

Author:

David Avendasora

valueForKey

public <T> NSArray<T> valueForKey(ERXKey<T> erxKey,
                                  boolean removeNulls,
                                  boolean distinct,
                                  boolean flatten)

A type-safe wrapper for valueForKeyPath(String) that calls valueForKeyPath(erxKey.key()) and attempts to cast the result to NSArray<T>.

Then, depending upon the parameters,

1. remove NSKeyValueCoding.Null elements
2. flatten all elements that are arrays (Only if ERXKey.isToManyRelationship() returns true, which can only possibly happen if ERXKey.type() has been set.)
3. remove all duplicate objects

If the value cannot be cast it will throw a ClassCastException .

Type Parameters:

T - the Type of elements in the returned NSArray

Parameters:

erxKey -

removeNulls - if true all NSKeyValueCoding.Null elements will be removed

distinct - if true all duplicate elements will be removed

flatten - if true all NSArray elements will be flattened

Returns:

an NSArray of T objects.

Author:

David Avendasora