读ServerSocket.java心得

读ServerSocket.java心得

 

一、            类的说明语句并不多

Bruce Eckel 在《Java编程思想》中告诫我们，如果不是非要不可，注释应该尽可能删减，与其拖沓这一大堆语无伦次的注释，不如给一个简单明了的名称，让人一看便知其义，如果确实需要，再加一句格式统一的说明。

例如：

* @(#)ServerSocket.java  1.75 03/01/23

这不长的一句注释告诉了我们类名、文件名、版本号、最后修改日期。

 

二、            包的引入都是精确的

import java.security.PrivilegedExceptionAction;

一般的Java初学者进行包的引入时，常常会用*，虽然简单，却十分地占用资源，在软件开发的项目中要避免这样的情况，应该使用精确引入

 

三、            JavaDoc的应用

SUN公司在自己的产品源代码之中给了我们一个使用JavaDoc的范例，对ServerSocket.java的所有成员函数和成员变量都有描述，通篇阅读后让人觉得这些并不是可有可无的东西，而是程序的一部分，而自己也会习惯于此。

 

四、            编码风格

(1)         花括号的位置风格：采用K&R风格，我也比较喜欢这种，相对于West Coast来说逻辑相关的代码比较紧凑。

(2)         成员声明顺序：先声明成员变量，再声明成员函数（方法），而在成员函数的声明中，由以构造函数为先。若有多个构造函数，则先声明缺省构造函数。

(3)         除了说明性的语句，程序本身所包含的语句都是简单明了的，单行都只有一个步骤，阅读起来比较舒服。

五、            异常捕捉

在任何有可能出现异常的地方都有对异常的捕捉，异常捕捉体系完善，在捕捉到异常而不进行处理的地方给与说明，例如：

    } catch (SocketException e) {

        // nothing

        // If we're bound, the the impl has been created

        // so we shouldn't get here

}