com.smartgwt.mobile.client.data

Class RecordList

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<Record>

com.smartgwt.mobile.client.data.RecordList

All Implemented Interfaces:

com.google.gwt.event.shared.HasHandlers, HasDataChangedHandlers, java.io.Serializable, java.lang.Cloneable, java.lang.Iterable<Record>, java.util.Collection<Record>, java.util.List<Record>, java.util.RandomAccess

Direct Known Subclasses:

ResultSet

public class RecordList
extends java.util.ArrayList<Record>
implements HasDataChangedHandlers

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected int	_dataChangeFlag

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
RecordList()
RecordList(java.util.Collection<? extends Record> records)
RecordList(Record... records) Construct a new RecordList containing the supplied records
RecordList(Record[] records, int start, int end) Construct a new RecordList containing the specified subset of the supplied records.
RecordList(RecordList recordList) Construct a new RecordList containing the same records as the supplied RecordList; the new RecordList is effectively a copy of the supplied RecordList
RecordList(RecordList recordList, int start, int end) Construct a new RecordList containing the specified subset of the Records contained in the supplied RecordList.

Method Summary

Modifier and Type	Method and Description
protected com.google.gwt.event.shared.HandlerManager	_createHandlerManager()
void	_doneChangingData()
protected com.google.gwt.event.shared.HandlerManager	_ensureHandlers()
java.util.Comparator<java.lang.Object>	_getDefaultComparator()
void	_maybeFireDataChangedEvent()
RecordList	_sortByProperties(SortSpecifier[] specifiers)
RecordList	_sortByProperties(SortSpecifier[] specifiers, java.util.Comparator<java.lang.Object> comparator)
RecordList	_sortByProperty(java.lang.String property, boolean up, java.util.Comparator<java.lang.Object> comparator) Sort the RecordList in-place, according to the value of the supplied property on each Record, using the supplied comparator
void	_startChangingData()
void	add(int index, Record record)
boolean	add(Record record)
boolean	addAll(java.util.Collection<? extends Record> c)
boolean	addAll(int index, java.util.Collection<? extends Record> c)
com.google.gwt.event.shared.HandlerRegistration	addDataChangedHandler(DataChangedHandler handler)
void	clear()
Record	find(java.util.Map<java.lang.String,?> properties) Find the first Record in the list where the values of all the properties in the parameter Map match the corresponding property in the Record
Record	find(java.util.Map<java.lang.String,?> properties, int start) Like find(), but inspects a range from startIndex to the end of the list
Record	find(java.util.Map<java.lang.String,?> properties, int start, int end) Like find(), but inspects a range from startIndex to endIndex
Record	find(java.lang.String property, java.lang.Object value) Find the first Record in the list where the value of the parameter property matches the parameter value
Record	find(java.lang.String property, java.lang.Object value, int start) Find the first Record where the value of the parameter property matches the parameter value a range from startIndex to the end of the list
protected Record	find(java.lang.String property, java.lang.Object value, int start, int end) Find the first Record where the value of the parameter property matches the parameter value a range from startIndex to endIndex
protected int	findIndex(java.util.Map<java.lang.String,?> properties) Find the index of the first Record in the list where the values of all the properties in the parameter Map match the corresponding property in the Record
protected int	findIndex(java.util.Map<java.lang.String,?> properties, int start) Find the index of the first Record where the values of all the properties in the parameter Map match the corresponding property in the Record in a range from startIndex to the end of the list.
int	findIndex(java.util.Map<java.lang.String,?> properties, int start, int end) Find the index of the first Record where the values of all the properties in the parameter Map match the corresponding property in the Record in a range from startIndex to endIndex.
protected int	findIndex(java.lang.String property, java.lang.Object value) Finds index of first Record in the list where the value of the parameter property matches the parameter value.
protected int	findIndex(java.lang.String property, java.lang.Object value, int start) Finds index of first Record where the value of the parameter property matches the parameter value in a range from startIndex to the end of the list.
protected int	findIndex(java.lang.String property, java.lang.Object value, int start, int end) Finds index of first Record where the value of the parameter property matches the parameter value in a range from startIndex to endIndex.
void	fireEvent(com.google.gwt.event.shared.GwtEvent<?> event)
Record[]	getRange(int start, int end) Returns a Record array made up of the Records in this list inside the range denoted by the start and end parameters (non-inclusive at the end).
Record	remove(int index)
boolean	remove(java.lang.Object o)
boolean	removeAll(java.util.Collection<?> c)
void	removeRange(int start, int end)
boolean	retainAll(java.util.Collection<?> c)
Record	set(int index, Record record)
RecordList	sortByProperty(java.lang.String property, boolean up) Sort the RecordList in-place, according to the value of the supplied property on each Record, using the default comparator
RecordList	subList(int start, int end) Returns a RecordList made up of the Records in this list inside the range denoted by the start and end parameters (non-inclusive at the end).
void	swap(int index1, int index2) Swap the positions of two Records in the list

Methods inherited from class java.util.ArrayList

clone, contains, ensureCapacity, forEach, get, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, removeIf, replaceAll, size, sort, spliterator, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractList

equals, hashCode

Methods inherited from class java.util.AbstractCollection

containsAll, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.List

containsAll, equals, hashCode

Methods inherited from interface java.util.Collection

parallelStream, stream

Field Detail

_dataChangeFlag

@SGWTInternal
protected int _dataChangeFlag

Constructor Detail

RecordList

public RecordList()

RecordList

public RecordList(java.util.Collection<? extends Record> records)

RecordList

public RecordList(Record... records)

Construct a new RecordList containing the supplied records

Parameters:

records -

RecordList

public RecordList(Record[] records,
                  int start,
                  int end)

Construct a new RecordList containing the specified subset of the supplied records. Note that the range is non-inclusive at the end

Parameters:

records -

start -

end -

RecordList

public RecordList(RecordList recordList)

Construct a new RecordList containing the same records as the supplied RecordList; the new RecordList is effectively a copy of the supplied RecordList

Parameters:

recordList -

RecordList

public RecordList(RecordList recordList,
                  int start,
                  int end)

Construct a new RecordList containing the specified subset of the Records contained in the supplied RecordList. Note that the range is non-inclusive at the end

Parameters:

recordList -

start -

end -

Method Detail

_startChangingData

@SGWTInternal
public final void _startChangingData()

_maybeFireDataChangedEvent

@SGWTInternal
public final void _maybeFireDataChangedEvent()

_doneChangingData

@SGWTInternal
public final void _doneChangingData()

getRange

public Record[] getRange(int start,
                         int end)

Returns a Record array made up of the Records in this list inside the range denoted by the start and end parameters (non-inclusive at the end).

Parameters:

start - First Record to include in the subset

end - Include every Record up to (but not including) this one

Returns:

The requested range, as a Record array

subList

public RecordList subList(int start,
                          int end)

Returns a RecordList made up of the Records in this list inside the range denoted by the start and end parameters (non-inclusive at the end). Note that the returned object is a copy, not a view over the original list, though it is a shallow copy (so the actual Records involved are the same Records as in the original list)

Specified by:

subList in interface java.util.List<Record>

Overrides:

subList in class java.util.ArrayList<Record>

Parameters:

start - First Record to include in the subset

end - Include every Record up to (but not including) this one

Returns:

The requested range, as a RecordList

findIndex

protected int findIndex(java.lang.String property,
                        java.lang.Object value)

Finds index of first Record in the list where the value of the parameter property matches the parameter value.

Parameters:

property - The name of the property to find by

value - The property value to match

Returns:

The index of first matching Record, or -1 if there is no such record

findIndex

protected int findIndex(java.lang.String property,
                        java.lang.Object value,
                        int start)

Finds index of first Record where the value of the parameter property matches the parameter value in a range from startIndex to the end of the list.

Parameters:

property - The name of the property to find by

value - The property value to match

start - The index of the first Record to include in the search

Returns:

The index of first matching Record, or -1 if there is no such record

findIndex

protected int findIndex(java.lang.String property,
                        java.lang.Object value,
                        int start,
                        int end)

Finds index of first Record where the value of the parameter property matches the parameter value in a range from startIndex to endIndex.

Parameters:

property - The name of the property to find by

value - The property value to match

start - The index of the first Record to include in the search

end - The index of the end of the range (non-inclusive)

Returns:

The index of first matching Record, or -1 if there is no such record

findIndex

protected int findIndex(java.util.Map<java.lang.String,?> properties)

Find the index of the first Record in the list where the values of all the properties in the parameter Map match the corresponding property in the Record

Parameters:

properties - A Map of property/value pairs to match

Returns:

The index of the first matching Record, or -1 if there is no such record

findIndex

protected int findIndex(java.util.Map<java.lang.String,?> properties,
                        int start)

Find the index of the first Record where the values of all the properties in the parameter Map match the corresponding property in the Record in a range from startIndex to the end of the list.

Parameters:

properties - A Map of property/value pairs to match

start - The index of the first Record to include in the search

Returns:

The first matching Record, or null if there is no such record

findIndex

public int findIndex(java.util.Map<java.lang.String,?> properties,
                     int start,
                     int end)

Find the index of the first Record where the values of all the properties in the parameter Map match the corresponding property in the Record in a range from startIndex to endIndex.

Parameters:

properties - A Map of property/value pairs to match

start - The index of the first Record to include in the search

end - The index of the end of the range (non-inclusive)

Returns:

The first matching Record, or null if there is no such record

find

public Record find(java.lang.String property,
                   java.lang.Object value)

Find the first Record in the list where the value of the parameter property matches the parameter value

Parameters:

property - The name of the property to find by

value - The property value to match

Returns:

The first matching Record, or null if there is no such record

find

public Record find(java.lang.String property,
                   java.lang.Object value,
                   int start)

Find the first Record where the value of the parameter property matches the parameter value a range from startIndex to the end of the list

Parameters:

property - The name of the property to find by

value - The property value to match

start - The index of the first Record to include in the search

Returns:

The first matching Record, or null if there is no such record

find

protected Record find(java.lang.String property,
                      java.lang.Object value,
                      int start,
                      int end)

Find the first Record where the value of the parameter property matches the parameter value a range from startIndex to endIndex

Parameters:

property - The name of the property to find by

value - The property value to match

start - The index of the first Record to include in the search

end - The index of the end of the range (non-inclusive)

Returns:

The first matching Record, or null if there is no such record

find

public Record find(java.util.Map<java.lang.String,?> properties)

Find the first Record in the list where the values of all the properties in the parameter Map match the corresponding property in the Record

Parameters:

properties - A Map of property/value pairs to match

Returns:

The first matching Record, or null if there is no such record

find

public Record find(java.util.Map<java.lang.String,?> properties,
                   int start)

Like find(), but inspects a range from startIndex to the end of the list

Parameters:

properties - A Map of property/value pairs to match

start - The index of the first Record to include in the search

Returns:

The first matching Record, or null if there is no such record

find

public Record find(java.util.Map<java.lang.String,?> properties,
                   int start,
                   int end)

Like find(), but inspects a range from startIndex to endIndex

Parameters:

properties - A Map of property/value pairs to match

start - The index of the first Record to include in the search

end - The index of the end of the range (non-inclusive)

Returns:

The first matching Record, or null if there is no such record

sortByProperty

public RecordList sortByProperty(java.lang.String property,
                                 boolean up)

Sort the RecordList in-place, according to the value of the supplied property on each Record, using the default comparator

Parameters:

property - The name of the property to sort by

up - If true, sort in ascending order; otherwise in descending order

Returns:

The sorted RecordList itself

_sortByProperty

@SGWTInternal
public RecordList _sortByProperty(java.lang.String property,
                                                boolean up,
                                                java.util.Comparator<java.lang.Object> comparator)

Sort the RecordList in-place, according to the value of the supplied property on each Record, using the supplied comparator

Parameters:

property - The name of the property to sort by

up - If true, sort in ascending order; otherwise in descending order

comparator - A Comparator that is able to provide meaningful comparisons between two values of the property being sorted by

Returns:

The sorted RecordList itself

_sortByProperties

@SGWTInternal
public RecordList _sortByProperties(SortSpecifier[] specifiers)

_sortByProperties

@SGWTInternal
public RecordList _sortByProperties(SortSpecifier[] specifiers,
                                                  java.util.Comparator<java.lang.Object> comparator)

_getDefaultComparator

@SGWTInternal
public java.util.Comparator<java.lang.Object> _getDefaultComparator()

swap

public void swap(int index1,
                 int index2)

Swap the positions of two Records in the list

Parameters:

index1 -

index2 -

add

public boolean add(Record record)

Specified by:

add in interface java.util.Collection<Record>

Specified by:

add in interface java.util.List<Record>

Overrides:

add in class java.util.ArrayList<Record>

add

public void add(int index,
                Record record)

Specified by:

add in interface java.util.List<Record>

Overrides:

add in class java.util.ArrayList<Record>

addAll

public boolean addAll(java.util.Collection<? extends Record> c)

Specified by:

addAll in interface java.util.Collection<Record>

Specified by:

addAll in interface java.util.List<Record>

Overrides:

addAll in class java.util.ArrayList<Record>

addAll

public boolean addAll(int index,
                      java.util.Collection<? extends Record> c)

Specified by:

addAll in interface java.util.List<Record>

Overrides:

addAll in class java.util.ArrayList<Record>

remove

public Record remove(int index)

Specified by:

remove in interface java.util.List<Record>

Overrides:

remove in class java.util.ArrayList<Record>

remove

public boolean remove(java.lang.Object o)

Specified by:

remove in interface java.util.Collection<Record>

Specified by:

remove in interface java.util.List<Record>

Overrides:

remove in class java.util.ArrayList<Record>

removeRange

public void removeRange(int start,
                        int end)

Overrides:

removeRange in class java.util.ArrayList<Record>

removeAll

public boolean removeAll(java.util.Collection<?> c)

Specified by:

removeAll in interface java.util.Collection<Record>

Specified by:

removeAll in interface java.util.List<Record>

Overrides:

removeAll in class java.util.ArrayList<Record>

retainAll

public boolean retainAll(java.util.Collection<?> c)

Specified by:

retainAll in interface java.util.Collection<Record>

Specified by:

retainAll in interface java.util.List<Record>

Overrides:

retainAll in class java.util.ArrayList<Record>

set

public Record set(int index,
                  Record record)

Specified by:

set in interface java.util.List<Record>

Overrides:

set in class java.util.ArrayList<Record>

clear

public void clear()

Specified by:

clear in interface java.util.Collection<Record>

Specified by:

clear in interface java.util.List<Record>

Overrides:

clear in class java.util.ArrayList<Record>

_createHandlerManager

@SGWTInternal
protected com.google.gwt.event.shared.HandlerManager _createHandlerManager()

_ensureHandlers

@SGWTInternal
protected final com.google.gwt.event.shared.HandlerManager _ensureHandlers()

addDataChangedHandler

public com.google.gwt.event.shared.HandlerRegistration addDataChangedHandler(DataChangedHandler handler)

Specified by:

addDataChangedHandler in interface HasDataChangedHandlers

fireEvent

public final void fireEvent(com.google.gwt.event.shared.GwtEvent<?> event)

Specified by:

fireEvent in interface com.google.gwt.event.shared.HasHandlers