国外工业设计网站,网站建设费用详细表,怎么在外管局的网站做延期,ppt做的比较好的网站几乎没有什么Deprecated没有适当的文档看到Deprecated方法更令人生气的了。 我感到失落。 我应该仍然使用该方法吗#xff1f; 可能这不是开发人员的意图#xff0c;这就是为什么他/她添加了弃用注释。 我应该使用其他东西吗#xff1f; 所以…。 使用Deprecated的规则是什… 几乎没有什么Deprecated没有适当的文档看到Deprecated方法更令人生气的了。 我感到失落。 我应该仍然使用该方法吗 可能这不是开发人员的意图这就是为什么他/她添加了弃用注释。 我应该使用其他东西吗 所以…。 使用Deprecated的规则是什么 规则1做Javadoc怎么做 每当您不赞成使用方法时请创建一个JavaDoc该JavaDoc告诉程序员如何不再使用该方法。 不仅要说“不赞成使用此方法请不要使用它”。 这正是弃用注释和JavaDoc deprecated单词所说的。 没有必要用英语重复它。 目标读者是Java程序员应该知道过时意味着什么。 为新方法命名以替代旧方法。 使用link 这可能不够也可能不够。 新方法将包含一些说明如何使用它的文档。 不要在JavaDoc中重复文本或含义。 只是不要重复自己文档也应该干燥。 另一方面您可能要描述如何用新的电话替换旧的电话。 您可能会提示重构。 规则2不要Javadoc如何 删除旧的JavaDoc文档。 有人可能会争辩说维护旧代码的用户可能仍然需要它。 事实是它们在库的旧版本中使用该方法的旧版本。 旧版本的文档仍然存在它们被冷冻雕刻成石头或者雕刻成版本库中的发行版。 弃用该方法的实际版本不应包含过时的文档。 这将鼓励程序员继续使用该方法。 有一种使用不推荐使用的方法的方式不使用它。 如上规则1中所述JavaDoc应该仅是当前的描述。 规则3JavaDoc中不得道歉 不要在JavaDoc中解释为什么不赞成使用该方法。 您是负责任的开发人员。 这是你的决定。 您做出了选择。 其他人必须忍受它。 如果您愿意可以写一篇关于建筑决策背景的博客。 这可能会有所帮助但是JavaDoc并不是放置它的地方。 不推荐使用的API JavaDoc仅用于解释如何不使用。 重点是如何 。 不是“为什么不使用它”。 规则4不赞成使用 如果您想弃用一种方法那就去做吧 如果您害怕用户并且不想让他们的生活变得悲惨而弃用某种方法那么此决定将使您的生活变得悲惨。 采取所有措施以拥有尽可能长的时间不需要弃用的API。 但是如果需要弃用某些东西请立即将其丢弃。 不要感到内为什么在设计api时就看不到未来。 我们谁也看不到未来完美。 毕竟生活对未来是无聊的。 如果您对stakcoverflow有关此主题的意见感兴趣请访问链接的页面。 或者如果您愿意可以在这里开始一场火焰大战。 我很 参考 Java Deep博客上的JCG合作伙伴 Peter Verhas 不赞成使用Java注释 。 翻译自: https://www.javacodegeeks.com/2014/02/use-java-annotation-deprecated-the-right-way.html
