com.starteam
Class ChangeCollection

java.lang.Object
  com.starteam.StarTeamCollection
      com.starteam.ChangeCollection

All Implemented Interfaces:

java.lang.Iterable, java.util.Collection

public class ChangeCollection
extends StarTeamCollection

A collection of change objects.

See Also:

ChangePackage.getChanges(), Change.find(com.starteam.Item, com.starteam.Item)

Constructor Summary

ChangeCollection()
Constructs a new writable ChangeCollection.

ChangeCollection(ChangeCollection source)
Constructs a ChangeCollection that is a copy of an existing one.

Method Summary

Change	find(int ID) Finds a change by object ID.
CacheService	getCache() Gets the caching service associated with this collection.
ChangeCollection	reverse() Creates a copy of this collection whose elements are in the reverse order of this one.

Methods inherited from class com.starteam.StarTeamCollection

add, addAll, addAll, addTo, attach, clear, contains, containsAll, detach, get, getSyncRoot, indexOf, insert, isEmpty, isFixedSize, isModified, isReadOnly, isSynchronized, iterator, positionOf, remove, removeAll, removeAt, resetCapacity, retainAll, set, size, toArray, toArray

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.Collection

equals, hashCode

Constructor Detail

ChangeCollection

public ChangeCollection()

Constructs a new writable ChangeCollection.

ChangeCollection

public ChangeCollection(ChangeCollection source)

Constructs a ChangeCollection that is a copy of an existing one. Note that the new collection is writable, even if the source was read-only.

Parameters:

source - the collection to copy

Method Detail

getCache

public CacheService getCache()

Gets the caching service associated with this collection.

The caching service is used to populate, refresh and discard the cached objects in this collection.

Note that for writable ChangeCollections, the populate and refresh methods are no-ops.

Returns:

CacheService

reverse

public ChangeCollection reverse()

Creates a copy of this collection whose elements are in the reverse order of this one. Note that the new collection is writable, even if the source collection is read-only.

Returns:

A reversed copy of this collection.

find

public Change find(int ID)

Finds a change by object ID.

Parameters:

ID - The object ID.

Returns:

The change with this object ID, or null if no change with the given ID was found in this collection.