包裝宣告
-
原始碼和註釋一般不應超過每行 80 個字元,每行最多不超過 100 個字元,包括縮排。
必須根據具體情況判斷字元限制。真正重要的是線條的語義密度和可讀性。無線長線使他們難以閱讀; 類似地,進行英雄嘗試以使它們適合 80 列也可能使它們難以閱讀。此處概述的靈活性旨在使開發人員能夠避免這些極端情況,而不是最大限度地利用監控房地產。
-
不應包裝 URL 或示例命令。
// Ok even though it might exceed max line width when indented.
Error e = isTypeParam
? Errors.InvalidRepeatableAnnotationNotApplicable(targetContainerType, on)
: Errors.InvalidRepeatableAnnotationNotApplicableInContext(targetContainerType));
// Wrapping preferable
String pretty = Stream.of(args)
.map(Argument::prettyPrint)
.collectors(joining(", "));
// Too strict interpretation of max line width. Readability suffers.
Error e = isTypeParam
? Errors.InvalidRepeatableAnnotationNotApplicable(
targetContainerType, on)
: Errors.InvalidRepeatableAnnotationNotApplicableInContext(
targetContainerType);
// Should be wrapped even though it fits within the character limit
String pretty = Stream.of(args).map(Argument::prettyPrint).collectors(joining(", "));
-
在較低的句法水平上包裝比在較高的句法水平上包裝更受歡迎。
-
每行最多應有 1 個語句。
-
延續線應採用以下四種方式之一縮排
- 變體 1 :相對於前一行的縮排有 8 個額外空格。
- 變體 2 :相對於包裝表示式的起始列有 8 個額外空格。
- 變體 3 :與先前的兄弟表示式一致(只要它是一個延續線)
- 變體 4 :與連結表示式中的先前方法呼叫對齊。