基于Java的实例源码-命令行处理类库 JArgs.zip

package jargs.gnu; import java.text.NumberFormat; import java.text.ParseException; import java.util.Hashtable; import java.util.Vector; import java.util.Enumeration; import java.util.Locale; /** * Largely GNU-compatible command-line options parser. Has short (-v) and * long-form (--verbose) option support, and also allows options with * associated values (-d 2, --debug 2, --debug=2). Option processing * can be explicitly terminated by the argument '--'. * * @author Steve Purcell * @version $Revision: 1.10 $ * @see jargs.examples.gnu.OptionTest */ public class CmdLineParser { /** * Base class for exceptions that may be thrown when options are parsed */ public static abstract class OptionException extends Exception { OptionException(String msg) { super(msg); } } /** * Thrown when the parsed command-line contains an option that is not * recognised. <code>getMessage()</code> returns * an error string suitable for reporting the error to the user (in * English). */ public static class UnknownOptionException extends OptionException { UnknownOptionException( String optionName ) { this(optionName, "Unknown option '" + optionName + "'"); } UnknownOptionException( String optionName, String msg ) { super(msg); this.optionName = optionName; } /** * @return the name of the option that was unknown (e.g. "-u") */ public String getOptionName() { return this.optionName; } private String optionName = null; } /** * Thrown when the parsed commandline contains multiple concatenated * short options, such as -abcd, where one is unknown. * <code>getMessage()</code> returns an english human-readable error * string. * @author Vidar Holen */ public static class UnknownSuboptionException extends UnknownOptionException { private char suboption; UnknownSuboptionException( String option, char suboption ) { super(option, "Illegal option: '"+suboption+"' in '"+option+"'"); this.suboption=suboption; } public char getSuboption() { return suboption; } } /** * Thrown when the parsed commandline contains multiple concatenated * short options, such as -abcd, where one or more requires a value. * <code>getMessage()</code> returns an english human-readable error * string. * @author Vidar Holen */ public static class NotFlagException extends UnknownOptionException { private char notflag; NotFlagException( String option, char unflaggish ) { super(option, "Illegal option: '"+option+"', '"+ unflaggish+"' requires a value"); notflag=unflaggish; } /** * @return the first character which wasn't a boolean (e.g 'c') */ public char getOptionChar() { return notflag; } } /** * Thrown when an illegal or missing value is given by the user for * an option that takes a value. <code>getMessage()</code> returns * an error string suitable for reporting the error to the user (in * English). */ public static class IllegalOptionValueException extends OptionException { public IllegalOptionValueException( Option opt, String value ) { super("Illegal value '" + value + "' for option " + (opt.shortForm() != null ? "-" + opt.shortForm() + "/" : "") + "--" + opt.longForm()); this.option = opt; this.value = value; } /** * @return the name of the option whose value was illegal (e.g. "-u") */ public Option getOption() { return this.option; } /** * @return the illegal value */ public String getValue() { return this.value; } private Option option; private String value; } /** * Representation of a command-line option */ public static abstract class Option { protected Option( String longForm, boolean wantsValue ) { this(null, longForm, wantsValue); } protected Option( char shortForm, String longForm, boolean wantsValue ) { this(new String(new char[]{shortForm}), longForm, wantsValue); } private Option( String shortForm, String longForm, boolean wantsValue ) { if ( longForm == null ) throw new IllegalArgumentException("Null longForm not allowed"); this.shortForm = shortForm; this.longForm = longForm; this.wantsValue = wantsValue; } public String shortForm() { return this.shortForm; } public String longForm() { return this.longForm; } /** * Tells whether or not this option wants a value */ public boolean wantsValue() { return this.wantsValue; } public final Object getValue( String arg, Locale locale ) throws IllegalOptionValueException { if ( this.wantsValue ) { if ( arg == null ) { throw new IllegalOptionValueException(this, ""); } return this.parseValue(arg, locale); } else { return Boolean.TRUE; } } /** * Override to extract and convert an option value passed on the * command-line */ protected Object parseValue( String arg, Locale locale ) throws IllegalOptionValueException { return null; } private String shortForm = null; private String longForm = null; private boolean wantsValue = false; public static class BooleanOption extends Option { public BooleanOption( char shortForm, String longForm ) { super(shortForm, longForm, false); } public BooleanOption( String longForm ) { super(longForm, false); } } /** * An option that expects an integer value */ public static class IntegerOption extends Option { public IntegerOption( char shortForm, String longForm ) { super(shortForm, longForm, true); } public IntegerOption( String longForm ) { super(longForm, true); } protected Object parseValue( String arg, Locale locale ) throws IllegalOptionValueException { try { return new Integer(arg); } catch (NumberFormatException e) { throw new IllegalOptionValueException(this, arg); } } } /** * An option that expects a long integer value */ public static class LongOption extends Option { public LongOption( char shortForm, String longForm ) { super(shortForm, longForm, true); } public LongOption( String longForm ) { super(longForm, true); } protected Object parseValue( String arg, Locale locale ) throws IllegalOptionValueException { try { return new Long(arg); } catch (NumberFormatException e) { throw new IllegalOptionValueException(this, arg); } } } /** * An option that expects a floating-point value */ public static class DoubleOption extends Option { public DoubleOption( char shortForm, String longForm ) { super(shortForm, longForm, true); } public DoubleOption( String longForm ) { super(