org.apache.commons.io.comparator

类 NameFileComparator

java.lang.Object

org.apache.commons.io.comparator.NameFileComparator

所有已实现的接口:

Serializable, Comparator<File>

public class NameFileComparator
extends Object
implements Serializable

Compare the names of two files for order (see File.getName()).

This comparator can be used to sort lists or arrays of files by their name either in a case-sensitive, case-insensitive or system dependent case sensitive way. A number of singleton instances are provided for the various case sensitivity options (using IOCase) and the reverse of those options.

Example of a case-sensitive file name sort using the NAME_COMPARATOR singleton instance:

       List<File> list = ...
       ((AbstractFileComparator) NameFileComparator.NAME_COMPARATOR).sort(list);
 

Example of a reverse case-insensitive file name sort using the NAME_INSENSITIVE_REVERSE singleton instance:

       File[] array = ...
       ((AbstractFileComparator) NameFileComparator.NAME_INSENSITIVE_REVERSE).sort(array);
 

从以下版本开始:

1.4

另请参阅:

序列化表格

字段概要

字段

限定符和类型	字段和说明
static Comparator<File>	NAME_COMPARATOR Case-sensitive name comparator instance (see IOCase.SENSITIVE)
static Comparator<File>	NAME_INSENSITIVE_COMPARATOR Case-insensitive name comparator instance (see IOCase.INSENSITIVE)
static Comparator<File>	NAME_INSENSITIVE_REVERSE Reverse case-insensitive name comparator instance (see IOCase.INSENSITIVE)
static Comparator<File>	NAME_REVERSE Reverse case-sensitive name comparator instance (see IOCase.SENSITIVE)
static Comparator<File>	NAME_SYSTEM_COMPARATOR System sensitive name comparator instance (see IOCase.SYSTEM)
static Comparator<File>	NAME_SYSTEM_REVERSE Reverse system sensitive name comparator instance (see IOCase.SYSTEM)

构造器概要

构造器

构造器和说明
NameFileComparator() Construct a case sensitive file name comparator instance.
NameFileComparator(IOCase caseSensitivity) Construct a file name comparator instance with the specified case-sensitivity.

方法概要

限定符和类型	方法和说明
int	compare(File file1, File file2) Compare the names of two files with the specified case sensitivity.
File[]	sort(File... files) Sort an array of files.
List<File>	sort(List<File> files) Sort a List of files.
String	toString() String representation of this file comparator.

从类继承的方法 java.lang.Object

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

从接口继承的方法 java.util.Comparator

comparing, comparing, comparingDouble, comparingInt, comparingLong, equals, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong

字段详细资料

NAME_COMPARATOR

public static final Comparator<File> NAME_COMPARATOR

Case-sensitive name comparator instance (see IOCase.SENSITIVE)

NAME_REVERSE

public static final Comparator<File> NAME_REVERSE

Reverse case-sensitive name comparator instance (see IOCase.SENSITIVE)

NAME_INSENSITIVE_COMPARATOR

public static final Comparator<File> NAME_INSENSITIVE_COMPARATOR

Case-insensitive name comparator instance (see IOCase.INSENSITIVE)

NAME_INSENSITIVE_REVERSE

public static final Comparator<File> NAME_INSENSITIVE_REVERSE

Reverse case-insensitive name comparator instance (see IOCase.INSENSITIVE)

NAME_SYSTEM_COMPARATOR

public static final Comparator<File> NAME_SYSTEM_COMPARATOR

System sensitive name comparator instance (see IOCase.SYSTEM)

NAME_SYSTEM_REVERSE

public static final Comparator<File> NAME_SYSTEM_REVERSE

Reverse system sensitive name comparator instance (see IOCase.SYSTEM)

构造器详细资料

NameFileComparator

public NameFileComparator()

Construct a case sensitive file name comparator instance.

NameFileComparator

public NameFileComparator(IOCase caseSensitivity)

Construct a file name comparator instance with the specified case-sensitivity.

参数:

caseSensitivity - how to handle case sensitivity, null means case-sensitive

方法详细资料

compare

public int compare(File file1,
                   File file2)

Compare the names of two files with the specified case sensitivity.

指定者:

compare 在接口中 Comparator<File>

参数:

file1 - The first file to compare

file2 - The second file to compare

返回:

a negative value if the first file's name is less than the second, zero if the names are the same and a positive value if the first files name is greater than the second file.

toString

public String toString()

String representation of this file comparator.

返回:

String representation of this file comparator

sort

public File[] sort(File... files)

Sort an array of files.

This method uses Arrays.sort(Object[], Comparator) and returns the original array.

参数:

files - The files to sort, may be null

返回:

The sorted array

从以下版本开始:

2.0

sort

public List<File> sort(List<File> files)

Sort a List of files.

This method uses Collections.sort(List, Comparator) and returns the original list.

参数:

files - The files to sort, may be null

返回:

The sorted list

从以下版本开始:

2.0