解析org.apache.commons.io.IOCase.checkCompareTo()方法及其应用

本文深入探讨了 Java 中 org.apache.commons.io.IOCase 类的 checkCompareTo() 方法。该方法用于根据指定的大小写敏感规则比较两个字符串。这些代码示例主要来源于 GitHub、StackOverflow 和 Maven 等平台，是从精选项目中提取出来的高质量代码片段，具有较高的参考价值。

IOCase.checkCompareTo 介绍

此方法模拟了 String#compareTo 的行为，但考虑了大小写敏感性。具体来说，它根据提供的大小写敏感规则对两个字符串进行比较。

代码示例

文件名比较：

/**
 * 根据指定的大小写敏感规则比较两个文件的名称。
 *
 * @param file1 第一个文件
 * @param file2 第二个文件
 * @return 如果第一个文件的名称小于第二个，则返回负值；如果相同则返回零；如果大于则返回正值。
 */
@Override
public int compare(final File file1, final File file2) {
  return caseSensitivity.checkCompareTo(file1.getName(), file2.getName());
}

文件路径比较：

/**
 * 根据指定的大小写敏感规则比较两个文件的路径。
 *
 * @param file1 第一个文件
 * @param file2 第二个文件
 * @return 如果第一个文件的路径小于第二个，则返回负值；如果相同则返回零；如果大于则返回正值。
 */
@Override
public int compare(final File file1, final File file2) {
  return caseSensitivity.checkCompareTo(file1.getPath(), file2.getPath());
}

文件扩展名比较：

/**
 * 根据指定的大小写敏感规则比较两个文件的扩展名。
 *
 * @param file1 第一个文件
 * @param file2 第二个文件
 * @return 如果第一个文件的扩展名小于第二个，则返回负值；如果相同则返回零；如果大于则返回正值。
 */
@Override
public int compare(final File file1, final File file2) {
  final String suffix1 = FilenameUtils.getExtension(file1.getName());
  final String suffix2 = FilenameUtils.getExtension(file2.getName());
  return caseSensitivity.checkCompareTo(suffix1, suffix2);
}

URI 比较：

@Override
public int compare(Path o1, Path o2) {
  return IOCase.SENSITIVE.checkCompareTo(o1.toUri().toString(), o2.toUri().toString());
}

测试用例：

@Test
public void test_checkCompare_case() throws Exception {
  assertEquals(0, IOCase.SENSITIVE.checkCompareTo("ABC", "ABC"));
  assertTrue(IOCase.SENSITIVE.checkCompareTo("ABC", "abc") <0);
  assertTrue(IOCase.SENSITIVE.checkCompareTo("abc", "ABC") > 0);
  assertEquals(0, IOCase.INSENSITIVE.checkCompareTo("ABC", "ABC"));
  assertEquals(0, IOCase.INSENSITIVE.checkCompareTo("ABC", "abc"));
  assertEquals(0, IOCase.INSENSITIVE.checkCompareTo("abc", "ABC"));
  assertEquals(0, IOCase.SYSTEM.checkCompareTo("ABC", "ABC"));
  assertEquals(WINDOWS, IOCase.SYSTEM.checkCompareTo("ABC", "abc") == 0);
  assertEquals(WINDOWS, IOCase.SYSTEM.checkCompareTo("abc", "ABC") == 0);
}

功能测试：

@Test
public void test_checkCompare_functionality() throws Exception {
  assertTrue(IOCase.SENSITIVE.checkCompareTo("ABC", "") > 0);
  assertTrue(IOCase.SENSITIVE.checkCompareTo("", "ABC") <0);
  assertTrue(IOCase.SENSITIVE.checkCompareTo("ABC", "DEF") <0);
  assertTrue(IOCase.SENSITIVE.checkCompareTo("DEF", "ABC") > 0);
  assertEquals(0, IOCase.SENSITIVE.checkCompareTo("ABC", "ABC"));
  assertEquals(0, IOCase.SENSITIVE.checkCompareTo("", ""));
  try {
    IOCase.SENSITIVE.checkCompareTo("ABC", null);
    fail();
  } catch (final NullPointerException ignore) {}
  try {
    IOCase.SENSITIVE.checkCompareTo(null, "ABC");
    fail();
  } catch (final NullPointerException ignore) {}
  try {
    IOCase.SENSITIVE.checkCompareTo(null, null);
    fail();
  } catch (final NullPointerException ignore) {}
}