【韩顺平utility工具类】

/**
工具类的作用:
处理各种情况的用户输入，并且能够按照程序员的需求，得到用户的控制台输入。
*/

import java.util.*;
/**


*/
public class Utility {
//静态属性。。。
private static Scanner scanner = new Scanner(System.in);


/**
 * 功能：读取键盘输入的一个菜单选项，值：1——5的范围
 * @return 1——5
 */
public static char readMenuSelection() {
    char c;
    for (; ; ) {
        String str = readKeyBoard(1, false);//包含一个字符的字符串
        c = str.charAt(0);//将字符串转换成字符char类型
        if (c != '1' && c != '2' && 
            c != '3' && c != '4' && c != '5') {
            System.out.print("选择错误，请重新输入：");
        } else break;
    }
    return c;
}

/**
 * 功能：读取键盘输入的一个字符
 * @return 一个字符
 */
public static char readChar() {
    String str = readKeyBoard(1, false);//就是一个字符
    return str.charAt(0);
}
/**
 * 功能：读取键盘输入的一个字符，如果直接按回车，则返回指定的默认值；否则返回输入的那个字符
 * @param defaultValue 指定的默认值
 * @return 默认值或输入的字符
 */

public static char readChar(char defaultValue) {
    String str = readKeyBoard(1, true);//要么是空字符串，要么是一个字符
    return (str.length() == 0) ? defaultValue : str.charAt(0);
}

/**
 * 功能：读取键盘输入的整型，长度小于2位
 * @return 整数
 */
public static int readInt() {
    int n;
    for (; ; ) {
        String str = readKeyBoard(10, false);//一个整数，长度<=10位
        try {
            n = Integer.parseInt(str);//将字符串转换成整数
            break;
        } catch (NumberFormatException e) {
            System.out.print("数字输入错误，请重新输入：");
        }
    }
    return n;
}
/**
 * 功能：读取键盘输入的 整数或默认值，如果直接回车，则返回默认值，否则返回输入的整数
 * @param defaultValue 指定的默认值
 * @return 整数或默认值
 */
public static int readInt(int defaultValue) {
    int n;
    for (; ; ) {
        String str = readKeyBoard(10, true);
        if (str.equals("")) {
            return defaultValue;
        }
		
		//异常处理...
        try {
            n = Integer.parseInt(str);
            break;
        } catch (NumberFormatException e) {
            System.out.print("数字输入错误，请重新输入：");
        }
    }
    return n;
}

/**
 * 功能：读取键盘输入的指定长度的字符串
 * @param limit 限制的长度
 * @return 指定长度的字符串
 */

public static String readString(int limit) {
    return readKeyBoard(limit, false);
}

/**
 * 功能：读取键盘输入的指定长度的字符串或默认值，如果直接回车，返回默认值，否则返回字符串
 * @param limit 限制的长度
 * @param defaultValue 指定的默认值
 * @return 指定长度的字符串
 */

public static String readString(int limit, String defaultValue) {
    String str = readKeyBoard(limit, true);
    return str.equals("")? defaultValue : str;
}


/**
 * 功能：读取键盘输入的确认选项，Y或N
 * 将小的功能，封装到一个方法中.
 * @return Y或N
 */
public static char readConfirmSelection() {
    System.out.println("请输入你的选择(Y/N): 请小心选择");
    char c;
    for (; ; ) {//无限循环
    	//在这里，将接受到字符，转成了大写字母
    	//y => Y n=>N
        String str = readKeyBoard(1, false).toUpperCase();
        c = str.charAt(0);
        if (c == 'Y' || c == 'N') {
            break;
        } else {
            System.out.print("选择错误，请重新输入：");
        }
    }
    return c;
}

/**
 * 功能： 读取一个字符串
 * @param limit 读取的长度
 * @param blankReturn 如果为true ,表示 可以读空字符串。 
 * 					  如果为false表示 不能读空字符串。
 * 			
 *	如果输入为空，或者输入大于limit的长度，就会提示重新输入。
 * @return
 */
private static String readKeyBoard(int limit, boolean blankReturn) {
    
	//定义了字符串
	String line = "";

	//scanner.hasNextLine() 判断有没有下一行
    while (scanner.hasNextLine()) {
        line = scanner.nextLine();//读取这一行
       
		//如果line.length=0, 即用户没有输入任何内容，直接回车
		if (line.length() == 0) {
            if (blankReturn) return line;//如果blankReturn=true,可以返回空串
            else continue; //如果blankReturn=false,不接受空串，必须输入内容
        }

		//如果用户输入的内容大于了 limit，就提示重写输入  
		//如果用户如的内容 >0 <= limit ,我就接受
        if (line.length() < 1 || line.length() > limit) {
            System.out.print("输入长度（不能大于" + limit + "）错误，请重新输入：");
            continue;
        }
        break;
    }

    return line;
}
}