公开PeekReader库中换行符的标准处理方式合规问询

针对你开发的继承自Reader的PeekReader类，需严格遵循Java Reader子类的规范要求，换行符处理需区分**核心字符读取方法（read()、peek()）与行读取方法（readLine()）**的不同逻辑：

一、核心规范原则 #

1. read()/peek()必须保留原始字符：Reader的核心契约是如实传递输入流中的字符，不得擅自修改或转换任何字符（包括各类换行符、行分隔序列），这是保证流处理正确性的基础。
2. readLine()需统一处理行分隔符：只有在实现readLine()时，才需要将所有标准行分隔符识别为行结束标记，按需进行统一转换。

二、需识别为行分隔符的字符/序列 #

按照Java官方规范及Unicode标准，以下字符/序列均应被视为行结束标记：

• \n（U+000A，标准换行符）
• \r（U+000D，回车符）
• \r\n（Windows标准换行序列）
• \u0085（U+0085，Unicode下一行）
• \u2028（U+2028，Unicode行分隔符）
• \u2029（U+2029，Unicode段落分隔符）
• \u0015（U+0015，IBM主机换行符）
• \f（U+000C，换页符）、\v（U+000B，垂直制表符）（对齐Apache Commons IO等成熟库的通用实践）
• \n\r（RISC OS换行序列）
• \u001E（U+001E，QNX行分隔符）

三、具体处理规则 #

• read()/peek()方法：直接返回原始字符/序列，不做任何转换，完全遵循Reader契约，保证流内容的完整性。
• readLine()方法：识别上述所有行分隔符序列作为行结束标记，若方法设计为返回包含换行符的行内容，则将所有识别到的行分隔符统一转换为\n；若遵循Java BufferedReader的标准行为，则返回不包含行终止符的行字符串，行分隔符仅作为终止判断依据。

四、参考处理逻辑示例 #

/* 非实际代码，仅展示readLine()方法内的转换逻辑 */
String seq = readEOL();
return switch(seq) {
  case "\n" -> "\n"; // 标准换行符
  case "\r" -> "\n"; // 回车符
  case "\f" -> "\n"; // 换页符
  case "\v" -> "\n"; // 垂直制表符
  case "\r\n" -> "\n"; // Windows换行序列
  case "\n\r" -> "\n"; // RISC OS换行序列
  case "\u0015" -> "\n"; // IBM主机换行符
  case "\u001E" -> "\n"; // QNX行分隔符
  case "\u0085" -> "\n"; // Unicode下一行
  case "\u2028" -> "\n"; // Unicode行分隔符
  case "\u2029" -> "\n"; // Unicode段落分隔符
  default -> seq;  
};

注意：上述逻辑仅适用于readLine()方法内部，绝对不能在read()或peek()中使用。

五、公开共享库构建建议 #

• 严格对齐Java SE中java.io.Reader和java.io.BufferedReader的官方规范，保证API行为一致性，降低使用者学习成本；
• 参考Apache Commons IO、Google Guava等成熟开源库的实现逻辑，对齐行业通用实践；
• 完善Javadoc注释，明确标注每个方法对换行符的处理规则，尤其是peek()方法的缓存行为与换行符的交互逻辑；
• 覆盖各类换行符场景的单元测试，保证边界情况的正确性。

内容的提问来源于stack exchange，提问作者Luca Scarcia