/*
* Svjatoslav Commons - shared library of common functionality.
- * Copyright ©2012-2013, Svjatoslav Agejenko, svjatoslav@svjatoslav.eu
- *
+ * Copyright ©2012-2014, Svjatoslav Agejenko, svjatoslav@svjatoslav.eu
+ *
* This program is free software; you can redistribute it and/or
- * modify it under the terms of version 2 of the GNU General Public License
- * as published by the Free Software Foundation.
+ * modify it under the terms of version 3 of the GNU Lesser General Public License
+ * or later as published by the Free Software Foundation.
*/
package eu.svjatoslav.commons.commandline.parameterparser;
-import java.io.File;
import java.util.ArrayList;
-import java.util.List;
-public class Parameter {
+public abstract class Parameter<T> {
/**
* Indicates that at least one argument is mandatory for this parameter.
*/
- private boolean mandatory;
-
- private final Argument argumentType;
+ protected boolean mandatory;
private final ArrayList<String> aliases = new ArrayList<String>();
public final String description;
- protected final ArrayList<String> arguments = new ArrayList<String>();
+ public final ArrayList<String> arguments = new ArrayList<String>();
- ArgumentCount argumentCount;
+ final ArgumentCount argumentCount;
/**
* If this parameter was present in the commandline, then this boolean will
*/
private boolean parameterSpecified;
- public Parameter(final Argument argumentType, final String description,
- final ArgumentCount argumentCount) {
-
- this.description = description;
- this.argumentType = argumentType;
- this.argumentCount = argumentCount;
- };
-
public Parameter(final boolean mandatory,
- final ArgumentCount argumentCount, final Argument argumentType,
- final String description, final String... aliases2) {
+ final ArgumentCount argumentCount, final String description,
+ final String... aliases2) {
this.mandatory = mandatory;
- this.argumentType = argumentType;
this.description = description;
this.argumentCount = argumentCount;
for (final String alias : aliases2)
aliases.add(alias);
+ };
+
+ public Parameter(final String description, final ArgumentCount argumentCount) {
+ this.description = description;
+ this.argumentCount = argumentCount;
}
- public Parameter addAliases(final String... aliasArray) {
+ @SuppressWarnings("unchecked")
+ public T addAliases(final String... aliasArray) {
// save aliases
for (final String alias : aliasArray)
aliases.add(alias);
- return this;
+ return (T) this;
}
/**
+ * @param argumentString
+ * argument to add
* @return <code>true</code> if no errors were found. <code>false</code>
* otherwise.
*/
return false;
}
- if (!argumentType.validate(argumentString)) {
+ if (!validate(argumentString)) {
System.out.println("Error! Invalid argument \"" + argumentString
- + "\". It shall be " + argumentType.describeFormat() + ".");
+ + "\". It shall be " + describeFormat() + ".");
return false;
}
return true;
}
+ /**
+ * @return Single line argument type description.
+ */
+ public abstract String describeFormat();
+
public String getAliases() {
final StringBuffer buffer = new StringBuffer();
return buffer.toString();
}
- public File getArgumentAsFile() {
- if (arguments.size() != 1)
- throw new RuntimeException("Parameter " + description
- + " shall have exactly 1 argument.");
- return new File(arguments.get(0));
- }
-
- public int getArgumentAsInteger() {
- if (arguments.size() != 1)
- throw new RuntimeException("Parameter " + description
- + " shall have exactly 1 argument.");
- return Integer.parseInt(arguments.get(0));
- }
-
- public List<File> getArgumentsAsFiles() {
- final ArrayList<File> result = new ArrayList<File>();
-
- for (final String argument : arguments) {
- final File file = new File(argument);
- result.add(file);
- }
-
- return result;
- }
-
- public List<Integer> getArgumentsAsIntegers() {
- final ArrayList<Integer> result = new ArrayList<Integer>();
-
- for (final String argument : arguments)
- result.add(Integer.valueOf(argument));
-
- return result;
- }
-
- public List<String> getArgumentsAsStrings() {
- final ArrayList<String> result = new ArrayList<String>(arguments);
- return result;
- }
-
public String getHelp() {
final StringBuffer buffer = new StringBuffer();
// first line
buffer.append(getAliases());
if (!argumentCount.equals(ArgumentCount.NONE)) {
- buffer.append(" (" + argumentType.describeFormat() + ")");
+ buffer.append(" (" + describeFormat() + ")");
if (argumentCount.equals(ArgumentCount.MULTI))
buffer.append("...");
return buffer.toString();
}
+ public abstract Object getValue();
+
public boolean isMandatory() {
return mandatory;
}
}
/**
+ * @param alias
+ * alias to check against
* @return <code>true</code> if given alias is registered for this
* parameter.
*/
/**
* Notifies this parameter that no more arguments will follow. This gives
* parameter chance to verify if this is ok.
- *
+ *
* @return <code>true</code> if no errors were found. <code>false</code>
* otherwise.
*/
return true;
}
- public Parameter setMandatory() {
+ @SuppressWarnings("unchecked")
+ public T setMandatory() {
mandatory = true;
- return this;
+ return (T) this;
}
/**
this.parameterSpecified = parameterSpecified;
}
+ /**
+ * @param value
+ * value to validate
+ * @return <code>true</code> if value is correct, <code>false</code>
+ * otherwise.
+ */
+ public abstract boolean validate(String value);
+
}