在API的CharSequence和String之间选择

Question

AStringis-aCharSequence。Java库中有许多方法可以接受，CharSequence因此它们的操作范围更广。某些类具有String方法（例如Writer.write(String)），并且还Appendable使用等效CharSequence方法（例如Writer.append(CharSequence)）实现。

如果我正在编写一个委托给此类的类，并且需要一些文本输入，则可以将输入选择为a String或a
CharSequence。通过为客户提供更多选择，选择后一种将使类更灵活。但是我看不到有太多这样做的代码：文本参数几乎总是a String而不是a
CharSequence。使用不利CharSequence吗？有表现上的打击吗？还是仅仅是程序员的天性或无知才导致使用String而不是CharSequence？

比较

class XMLWriter {
   private final Writer writer;

   // more stuff here

   public void writeComment(String text) {
      writer.write("<!-- ");
      writer.write(text);
      writer.write(" -->");
   }
}

与

class XMLWriter {
   private final Writer writer;

   // more stuff here

   public void writeComment(CharSequence text) {
      writer.write("<!-- ");
      writer.append(text);
      writer.write(" -->");
   }
}

Answer 1

引用CharSequenceJavadoc：

此接口不会完善equals和hashCode方法的常规协定。因此，测试两个实现CharSequence相等的对象的结果通常是不确定的。每个对象都可以由不同的类实现，并且不能保证每个类都能够测试其实例与另一个实例的相等性。因此，将任意CharSequence实例用作集合中的元素或用作映射中的键是不合适的。

因此，在使用CharSequnce代替String之前，IMO我们必须三思。