java编写自定义类.doc

下面是编写自定义类的过程以及要注意的一些细节： 类文件是以文档注释开头的，其中包含对代码的基本描述以及作者信息和版本信息。 ????注释规范 ?????定义这个规范的目的是让项目中所有的文档都看起来像一个人写的，增加可读性，减少项目组中因为换人而带来的损失。（这些规范并不是一定要绝对遵守，但是一定要让程序有良好的可读性）。? ?????Java?的语法与?C++?及为相似，那么，你知道?Java?的注释有几种吗？是两种？?　　? //?注释一行　　 ?注释若干行 不完全对，除了以上两种之外，还有第三种，文档注释：?　　 ?注释若干行，并写入?javadoc?文档?注释要简单明了。 String?userName?=?null;?//用户名 边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性。 在必要的地方注释，注释量要适中。注释的内容要清楚、明了，含义准确，防止注释二义性。保持注释与其描述的代码相邻，即注释的就近原则。 对代码的注释应放在其上方相邻位置，不可放在下面。对数据结构的注释应放在其上方相邻位置，不可放在下面；对结构中的每个域的注释应放在此域的右方；同一结构中不同域的注释要对齐。 变量、常量的注释应放在其上方相邻位置或右方。? 全局变量要有较详细的注释，包括对其功能、取值范围、哪些函数或过程存取它以及存取时注意事项等的说明。 在每个源文件的头部要有必要的注释信息，包括：文件名；版本号；作者；生成日期；模块功能描述（如功能、主要算法、内部各部分之间的关系、该文件与其它文件关系等）；主要函数或过程清单及本文件历史修改记录等。 在每个函数或过程的前面要有必要的注释信息，包括：函数或过程名称；功能描述；输入、输出及返回值说明；调用关系及被调用关系说明等????????public?String?checkout(Hashtable?htCart,???????????????????????????OrderBean?orderBean)????????????????????????????throws?Exception{????} javadoc注释标签语法 @author?对类的说明?标明开发该类模块的作者?@version?对类的说明?标明该类模块的版本?@see?对类、属性、方法的说明?参考转向，也就是相关主题?@param?对方法的说明?对方法中某参数的说明?@return?对方法的说明?对方法返回值的说明?@exception?对方法的说明?对方法可能抛出的异常进行说明添加?import?语句。 ?????程序员可以使用两种import语句： ????单类型导入(single-type-import)，例如import?java.io.File; ????按需类型导入(type-import-on-demand)，例如 import java.io.*; ????关于这两种导入类型大家各有所爱，众说纷纭。这里分析一下这两种导入类型的大致工作原理供大家参考。 ????单类型导入比较好理解，仅仅导入一个public类或者接口。而对于按需类型导入，有人误解为导入一个包下的所有类，其实不然，看名字就知道，他只会按需导入，也就是说它并非导入整个包，而仅仅导入当前类需要使用的类。既然如此是不是就可以放心的使用按需类型导入呢？非也，非也。因为单类型导入和按需类型导入对类文件的定位算法是不一样的。java编译器会从启动目录(bootstrap)，扩展目录(extension)和用户类路径下去定位需要导入的类，而这些目录进仅仅是给出了类的顶层目录。编译器的类文件定位方法大致可以理解为如下公式： ????顶层路径名 \ 包名 \ 文件名.class = 绝对路径 ????对于单类型导入很简单，因为包明和文件名都已经确定，所以可以一次性查找定位。 ????对于按需类型导入则比较复杂，编译器会把包名和文件名进行排列组合，然后对所有的可能性进行类文件查找定位。例如： ????package com; ????import java.io.*; ????import java.util.*; ????当你的类文件中用到了File类，那么可能出现File类的地方如下 ????File??\\ File类属于无名包，就是说File类没有package语句，编译器会首先搜索无名包 ????com.File??\\ File类属于当前包 ????java.lang.File??\\编译器会自动导入java.lang包 ????java.io.File ????java.util.File ????需要注意的地方就是，编译器找到java.io.File类之后并不会停止下一步的寻找，而要把所有的可能