(面相对象) Java帮助文档的制作和使用

 需要在该工具类的目录下执行:javadoc指令

    如何制作一个说明书呢?
        A:写一个工具类
        B:对这个类加入文档注释
            怎么加呢?
            加些什么东西呢?
        C:用工具解析文档注释
            javadoc工具
        D:格式
            javadoc -d 目录 -author -version ArrayTool.java
            
            目录:就可以写一个文件夹的路径
            
    制作帮助文档出错:
        找不到可以文档化的公共或受保护的类:告诉我们类的权限不够

/**
* 这是针对数组进行操作的工具类
* @author Jayson
* @version V.10
*/
public class ArrayTool {
	
	//把构造方法私有,外界就不能在创建对象了
	/**
	* 这是私有构造
	*/
	private ArrayTool(){}

	/**
	* 这是遍历数组的方法,遍历后的格式是:[元素1, 元素2, 元素3, ...]
	* @param arr 这是要被遍历的数组
	*/
	public static void printArray(int[] arr) {
		System.out.print("[");
		for(int x=0; x<arr.length; x++) {
			if(x == arr.length-1) {
				System.out.println(arr[x]+"]");
			}else {
				System.out.print(arr[x]+", ");
			}
		}
	}
	
	/**
	* 这是获取数组中最大值的方法
	* @param  arr 这是要获取最大值的数组
	* @return 返回数组中的最大值
	*/
	public static int getMax(int[] arr) {
		int max = arr[0];
		
		for(int x=1; x<arr.length; x++) {
			if(arr[x] > max) {
				max = arr[x];
			}
		}
		
		return max;
	}
	
	/**
	* 获取指定元素在数组中第一次出现的索引,如果元素不存在,就返回-1
	* @param arr 被查找的数组 
	* @param value 要查找的元素
	* @return 返回元素在数组中的索引,如果不存在,返回-1
	*/
	public static int getIndex(int[] arr,int value) {
		int index = -1;
		
		for(int x=0; x<arr.length; x++) {
			if(arr[x] == value) {
				index = x;
				break;
			}
		}
		
		return index;
	}
}

如何使用说明书:

1:打开帮助文档
2:点击显示,找到索引,看到输入框
3:知道你要找谁?以Scanner举例
4:在输入框里面输入Scanner,然后回车
5:看包
    java.lang包下的类不需要导入,其他的全部需要导入。
    
    要导入:
    java.util.Scanner
6:再简单的看看类的解释和说明,别忘了看看该类的版本
7:看类的结构
    成员变量    字段摘要     
    构造方法    构造方法摘要 
    成员方法     方法摘要
8:学习构造方法    
    A:有构造方法    就创建对象
    B:没有构造方法    成员可能都是静态的
9:看成员方法
    A:左边
        是否静态:如果静态,可以通过类名调用
        返回值类型:人家返回什么,你就用什么接收。
    B:右边
        看方法名:方法名称不要写错
        参数列表:人家要什么,你就给什么;人家要几个,你就给几个

 

 

 

 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值