nixonftp.list

Class NXSortedListModel

java.lang.Object

javax.swing.AbstractListModel

nixonftp.list.NXSortedListModel

All Implemented Interfaces:

java.io.Serializable, javax.swing.ListModel, NXListModel

public class NXSortedListModel
extends javax.swing.AbstractListModel
implements NXListModel

SortedListModel decorates an unsorted ListModel to provide a sorted model. You can create a SortedListModel from models you already have. Place the SortedListModel into a JList, for example, to provide a sorted view of your underlying model.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NXSortedListModel.SortOrder

Field Summary

Fields inherited from class javax.swing.AbstractListModel

listenerList

Constructor Summary

Constructors

Constructor and Description
NXSortedListModel(NXDefaultListModel model) Create a SortedListModel from an existing model using a default text comparator for the default Locale.
NXSortedListModel(NXDefaultListModel model, NXSortedListModel.SortOrder sortOrder) Create a SortedListModel from an existing model using a specific comparator and sort order.
NXSortedListModel(NXDefaultListModel model, NXSortedListModel.SortOrder sortOrder, java.util.Comparator comp) Create a SortedListModel from an existing model.

Method Summary

Methods

Modifier and Type	Method and Description
void	addElement(java.lang.Object obj)
java.lang.Object	getElementAt(int index) Retrieve the sorted entry from the original model
int	getSize() Retrieve the size of the underlying model
void	removeElementAt(int obj)
void	setComparator(java.util.Comparator comp)
void	setSortOrder(NXSortedListModel.SortOrder sortOrder) Change the sort order of the model at runtime
int	toSortedModelIndex(int unsortedIndex) Convert an unsorted model index to a sorted model index.
int[]	toSortedModelIndices(int[] unsortedModelIndices) Convert an array of unsorted model selection indices to indices in the sorted model.
int	toUnsortedModelIndex(int index) Convert sorted model index to an unsorted model index.
int[]	toUnsortedModelIndices(int[] sortedSelectedIndices) Convert an array of sorted model indices to their unsorted model indices.

Methods inherited from class javax.swing.AbstractListModel

addListDataListener, fireContentsChanged, fireIntervalAdded, fireIntervalRemoved, getListDataListeners, getListeners, removeListDataListener

Methods inherited from class java.lang.Object

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

Constructor Detail

NXSortedListModel

public NXSortedListModel(NXDefaultListModel model)

Create a SortedListModel from an existing model using a default text comparator for the default Locale. Sort in ascending order.

Parameters:

model - the underlying, unsorted ListModel

NXSortedListModel

public NXSortedListModel(NXDefaultListModel model,
                 NXSortedListModel.SortOrder sortOrder)

Create a SortedListModel from an existing model using a specific comparator and sort order. Use a default text comparator.

Parameters:

model - the unsorted list model

sortOrder - that should be used

NXSortedListModel

public NXSortedListModel(NXDefaultListModel model,
                 NXSortedListModel.SortOrder sortOrder,
                 java.util.Comparator comp)

Create a SortedListModel from an existing model. Sort the model in the specified sort order using the given comparator.

Parameters:

model -

sortOrder -

comp -

Method Detail

addElement

public void addElement(java.lang.Object obj)

Specified by:

addElement in interface NXListModel

getElementAt

public java.lang.Object getElementAt(int index)
                              throws java.lang.IndexOutOfBoundsException

Retrieve the sorted entry from the original model

Specified by:

getElementAt in interface javax.swing.ListModel

Specified by:

getElementAt in interface NXListModel

Parameters:

index - index of an entry in the sorted model

Returns:

element in the original model to which our entry points

Throws:

java.lang.IndexOutOfBoundsException

getSize

public int getSize()

Retrieve the size of the underlying model

Specified by:

getSize in interface javax.swing.ListModel

Specified by:

getSize in interface NXListModel

Returns:

size of the model

toUnsortedModelIndex

public int toUnsortedModelIndex(int index)
                         throws java.lang.IndexOutOfBoundsException

Convert sorted model index to an unsorted model index.

Parameters:

index - an index in the sorted model

Returns:

modelIndex an index in the unsorted model

Throws:

java.lang.IndexOutOfBoundsException

toUnsortedModelIndices

public int[] toUnsortedModelIndices(int[] sortedSelectedIndices)

Convert an array of sorted model indices to their unsorted model indices. Sort the resulting set of indices.

Parameters:

sortedSelectedIndices - indices of selected elements in the sorted model or sorted view

Returns:

unsortedSelectedIndices selected indices in the unsorted model

toSortedModelIndex

public int toSortedModelIndex(int unsortedIndex)

Convert an unsorted model index to a sorted model index.

Parameters:

unsortedIndex - an element index in the unsorted model

Returns:

sortedIndex an element index in the sorted model

toSortedModelIndices

public int[] toSortedModelIndices(int[] unsortedModelIndices)

Convert an array of unsorted model selection indices to indices in the sorted model. Sort the model indices from low to high to duplicate JList's getSelectedIndices method

Parameters:

unsortedModelIndices -

Returns:

an array of selected indices in the sorted model

setComparator

public void setComparator(java.util.Comparator comp)

setSortOrder

public void setSortOrder(NXSortedListModel.SortOrder sortOrder)

Change the sort order of the model at runtime

Parameters:

sortOrder -

removeElementAt

public void removeElementAt(int obj)

Specified by:

removeElementAt in interface NXListModel