sort.java

来自「dm s preparing process. In this case we 」· Java 代码 · 共 60 行

/* created at 2006-1-3 */
package com.clustering.core.support;

import java.util.Comparator;
import java.util.Iterator;

/**
 * 该接口是所有排序的超类.
 * <p>
 * java.util.SortSet
 * 
 * @author Avon
 * @version 0.9
 * @since 0.9
 */
public interface Sort {

	/**
	 * 设置待排序序列.这里只支持数组排序，如果想排序List、Set、Map，还是用java.util中的类吧
	 * <P>
	 * 这里要求sequence数组中的所有元素都必须实现Comparable接口或设置排序的Comparator.如果
	 * 既设置了Comparator，有实现了Comparable，那么将以Comparator为标准进行排序.
	 * <P>
	 * 如果在遍历排序结果的时候使用这个方法，会发生奇怪的现象
	 * 
	 * @param sequence
	 *            待排序序列
	 */
	void setSortingSequence(Object[] sequence);

	Object[] getSortingSequence();

	/**
	 * 设置排序顺序.
	 * <p>
	 * 默认时降序排列
	 * 
	 * @param isDescending
	 */
	void setDescending(boolean isDescending);

	boolean isDescending();

	/**
	 * 返回排序结果
	 * 
	 * @return 排序结果的迭代器
	 */
	Iterator iterator();

	/**
	 * 如果在遍历排序结果的时候使用这个方法，会发生奇怪的现象
	 * 
	 * @param comparator
	 */
	void setComparator(Comparator comparator);

	Comparator getComparator();
}