zoukankan      html  css  js  c++  java
  • 第六十二条:每个方法抛出的异常都要有文档

    花点时间仔细为每个方法抛出的异常建立文档是特别重要的。

    始终要单独的声明受检的异常,并且利用Javadoc的@throws标记,准确的记录下抛出每个异常的条件。

    如果一个方法可能抛出多个受检异常,则不要使用“快捷方式”声明这个方法会抛出这些异常类的超类,如永远不要声明一个方法“throws Exception”,

    或者更糟糕的是声明这个方法“throws Throwable”。因为这样的声明不仅没有为程序员提供关于“这个方法能够抛出哪些受检异常”的任何知道信息,

    而且还大大妨碍了该方法的使用,因为它实际上掩盖了该方法在同样的执行环境上可能抛出的任何其他异常。

    虽然Java语言并不要求程序员在一个方法的声明中写出它可能会抛出的未受检异常,但是,如同受检异常一样,仔细的为未受检异常建立文档是非常明智的。

    未受检的异常通常代表编程上的错误,是不可恢复的,让程序员了解所有这些错误都有助于帮助他们避免犯这样的错误。使用Javadoc的@throws标签记录

    一个方法可能抛出的每个未受检异常,但是不要使用throws关键字将未受检异常包含在方法的声明中。这样,程序员在使用这个方法时结合Javadoc的@throws

    和方法声明的throws后面的异常,可以明确的知道这个方法抛出的异常哪些是受检的异常,哪些是未受检的异常。

  • 相关阅读:
    js 字符中 带 函数 再传对象参数
    window server 2012 II8 假陌生 碰到的问题
    IIS 下载文件 报错“401
    easyui使用时出现这个Uncaught TypeError: Cannot read property 'combo' of undefined
    eclipse+gnuarm+使用报错
    mini2440:通过JLink烧写BootLoader到Nor Flash
    在Linux中搭建一个FTP服务器
    SPFA模板
    Bellman_ford模板
    前向星&链式前向星
  • 原文地址:https://www.cnblogs.com/wangliyue/p/4546437.html
Copyright © 2011-2022 走看看