=====================先来一点成就感=====================
package com.springMybatis.dao; import com.springMybatis.model.*; /**
* AuthorizationDao 定义Authorization接口
* @author g.qu
* @see java.lang
*/
public interface AuthorizationDao{ /**
* addAuthorization 添加授权
* @param authorization 授权对象
* @return 布尔值 true 成功;false 失败
*/
public boolean addAuthorization(Authorization authorization); /**
* deleteAuthorization 删除授权
* @param authorization 授权对象
* @return true 表示执行成功 ;false 失败
*/
public boolean deleteAuthorization(Authorization authorization); /**
* updateAuthorization 更新授权
* @param authorization 授权对象
* @return true 表示执行成功 ;false 失败
*/
public boolean updateAuthorization(Authorization authorization); /**
* getAuthorization 获取授权
* @param authorization 授权对象
*/
public void getAuthorization(Authorization authorization); }
生成的部分文档截图：
=========================风骚的分割线=========================
说明一下注释：
1、单行注释
2、块注释
3、尾端注释
4、行末注释
5、文档注释(生成开发帮助文档)
[1]、利用eclipse和javadoc工具生成开发API文档【自定义一个文件夹存放，否则生成一大堆文件；注意采用UTF-8编码 否则乱码】
类 接口 方法 字段声明前
[2]、默认只为public 和 protect 生成注释；private 和默认 需要在生成时候配置
[3]、注释命令
@author 作者信息
@version 版本信息
@param 参数信息
@return 返回值
@since 最早见于某个版本
@exception 异常信息 可以存在多个
@deprecated 不建议使用 将来可能会摒弃的方法
1 /**
2 *汽车类的简介
3 *<p>汽车类具体阐述第一行<br>
4 *汽车类具体阐述第二行
5 *@author man
6 *@author man2
7 *@version 1.0
8 *@see ship
9 *@see aircraft
10 */
11 public class BusTestJavaDoc{
12 /**
13 *用来标识汽车行驶当中最大速度
14 *@see #averageSpeed
15 */
16 public int maxSpeed;
17 /**用来标识汽车行驶当中平均速度*/
18 public int averageSpeed;
19 /**用来标识汽车行驶当中的水温*/
20 public int waterTemperature;
21 /**用来标识天气温度*/
22 public int Temperature;
23 BusTestJavaDoc(){
24
25 }
26 /**
27 *该方法用来测量一段时间内的平均速度
28 *@param start 起始时间
29 *@param end 截止时间
30 *@return 返回int型变量
31 *@exception java.lang.exceptionthrowwhenswitchis1
32 */
33 public int measureAverageSpeed(int start,int end ){
34 int aspeed=12;
35 return aspeed;
36 }
37 /**
38 * 该方法用来测量最大速度
39 */
40 public int measureMaxSpeed(){
41 return maxSpeed;
42 }
43 }
写好这些注释后，eclipse ->文件->export->java->javadoc->
下一步->
Next->选择Finish 完成；