涿州网站建设公司,建设个直播网站要多少钱,网站制作器软件下载,如何做网站豆瓣尽管在一个人的代码中应添加多少注释之间存在意见分歧#xff0c;但我认为可以肯定地说#xff0c;大多数开发人员都同意以下代码段中的注释是多余的#xff1a; // increment the total
total;在该示例中#xff0c;代码很简单#xff0c;并且实际上是不言自明的#x… 尽管在一个人的代码中应添加多少注释之间存在意见分歧但我认为可以肯定地说大多数开发人员都同意以下代码段中的注释是多余的 // increment the total
total; 在该示例中代码很简单并且实际上是不言自明的用标准的Java运算符递增了一个得体的命名变量total 。 幸运的是我现在没有像以前那样看到明显不必要的评论类型。 我仍然在其中似乎比我更希望看到多余注释的一个方面与导致解释性日志语句的代码情况相关。 尤其是当导致log语句的情况有些棘手时似乎有时会希望向将来将要阅读和维护该代码的开发人员写评论并希望记录相关信息以供使用。在以后调试特殊条件。 在大多数情况下精心设计的日志消息如其他精心设计的可执行代码可以说明一切而无需其他注释。 尽管编写自我记录的日志记录代码与编写自我记录的任何可执行代码在很大程度上相似但是日志记录代码具有能够在日志消息中表达任意详细信息的优点。 普通代码受编程语言支持的结构的限制并且有时语言的结构可能不如人们希望的那样表达意图。 记录的消息在可表达的内容方面的限制要少得多。 不利的一面是更改代码后记录的消息通常更容易被忽略。 必须进行代码更改但是日志消息通常可以保持不变即使它们应该已经更改并且直到将来某个时候记录该语句时才会注意到这种遗漏。 尽管如此与注释相比已记录的消息具有更好的机会来进行更改/更新注释仅在代码读取期间才被公开。 使用日志消息来表达特殊条件而不是代码注释的附带好处是这可以导致编写简洁而透彻的日志消息时要遵守更多的纪律。 通过记录的消息而不是代码内注释进行“注释”的另一个好处是可以在情况发生时在运行时编写消息并提供对代码行为的宝贵见解而这些行为在分析静态代码时根本不可用。 以下是两个代码清单一个使用代码内注释另一个使用日志记录以表达对将来维护此代码的开发人员相同的看法。 在这两种情况下都记录了业务逻辑考虑因素即2016年美国国家橄榄球联盟 NFL超级碗 丹佛野马队获胜没有使用传统的罗马数字命名约定来命名 。 它没有像以前的超级碗那样被冠以“ L”的称号而是被冠以“ 50”的称号。 这是业务逻辑规则类型的精心设计的示例通常以代码注释形式表示。 第10行是此处列出的每个代码的重点。 private int convertToSuperBowlYear(final String superBowlNumber)
{int superBowlYear;if (superBowlNumber null || superBowlNumber.isEmpty()){superBowlYear 0;}else if (superBowlNumber.equals(L)){// Super Bowl 50 was not named with the conventional Roman Numeral, so using 50 instead of LsuperBowlYear 2016;}else{superBowlYear getSuperBowlYearFromNumber(getDecimalNumber(superBowlNumber));}return superBowlYear;
}private int convertToSuperBowlYear(final String superBowlNumber)
{int superBowlYear;if (superBowlNumber null || superBowlNumber.isEmpty()){superBowlYear 0;}else if (superBowlNumber.equals(L)){logger.fine(Super Bowl 50 was not named with the conventional Roman Numeral, so using 50 instead of L.);superBowlYear 2016;}else{superBowlYear getSuperBowlYearFromNumber(getDecimalNumber(superBowlNumber));}return superBowlYear;
} 这里未显示方法getSuperBowlYearFromNumber(int)和getDecimalNumber(String)实现因为它们对本次讨论不重要。 这里重要的是“ L”不是有效的超级碗编号因此在确定超级碗的年份时必须使用“ 50”而不是“ L”。 如果开发人员不熟悉NFL或它的超级碗命名约定并且不熟悉2016年超级碗的命名约定则需要某种类型的注释以了解为什么一个超级碗与其他超级碗区别对待。 作为旁注并谈到罗马数字令人惊讶的是网络上有多少Java代码示例可在罗马数字和基于十进制的整数之间进行转换。 其中包括 将罗马数字转换为十进制 将罗马数字转换为介于1到3999之间的 十进制使用Java 将罗马数字转换为十进制在Java中将罗马数字转换为十进制以及如何将罗马数字转换为整数 。 我怀疑有很多家庭作业问题会 激发大量的代码示例。 Alexey最近发布了博客文章“ 用警告日志消息替换代码中的TODO注释 他指出在他以前曾写过“ TODO”注释的情况下他已经开始写警告和错误级别的日志消息。 这是使用日志消息代替注释的更具体更明显的示例。 就阿列克谢而言他之所以这样做是因为他意识到自己“总是忘记”“待办事项”而且“很少被发现而且几乎永远无法解决”。 Alexey的结论是“这就是为什么我建议您尝试通过在日志中写下您的评论您的想法甚至是您的疑问来尝试这种方法这将帮助您甚至可以使您和您的同事开心” 在某些情况下可能添加到源注释中的内容可能不适合添加到日志消息中。 这样的情况包括评论的冗长或评论的敏感性。 还值得注意的是某些注释级别的日志消息可能永远不会被记录因为它们的日志级别设置得如此具体以致在代码执行过程中永远不会真正启用日志级别。 但是在许多情况下使用简洁而透彻的日志消息而不是代码内注释来与将来的开发人员和您将来的自己进行通信具有优势。 翻译自: https://www.javacodegeeks.com/2017/12/log-message-executable-code-comment.html
