org.crsh.cmdline.CommandDescriptor Maven / Gradle / Ivy
/*
* Copyright (C) 2012 eXo Platform SAS.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.crsh.cmdline;
import org.crsh.cmdline.binding.TypeBinding;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.HashSet;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.ListIterator;
import java.util.Map;
import java.util.Set;
public abstract class CommandDescriptor {
/** . */
private final String name;
/** . */
private final Description description;
/** . */
private final Map> optionMap;
/** . */
private final Set shortOptionNames;
/** . */
private final Set longOptionNames;
/** . */
private boolean listArgument;
/** . */
private final List> options;
/** . */
private final List> arguments;
/** . */
private final List> parameters;
/** . */
private final Map> uOptionMap;
/** . */
private final Set uShortOptionNames;
/** . */
private final Set uLongOptionNames;
/** . */
private final List> uOptions;
/** . */
private final List> uArguments;
/** . */
private final List> uParameters;
CommandDescriptor(String name, Description description) throws IntrospectionException {
//
this.description = description;
this.optionMap = new LinkedHashMap>();
this.arguments = new ArrayList>();
this.options = new ArrayList>();
this.name = name;
this.parameters = new ArrayList>();
this.listArgument = false;
this.shortOptionNames = new HashSet();
this.longOptionNames = new HashSet();
//
this.uOptionMap = Collections.unmodifiableMap(optionMap);
this.uParameters = Collections.unmodifiableList(parameters);
this.uOptions = Collections.unmodifiableList(options);
this.uArguments = Collections.unmodifiableList(arguments);
this.uShortOptionNames = shortOptionNames;
this.uLongOptionNames = longOptionNames;
}
/**
* Add a parameter to the command.
*
* @param parameter the parameter to add
* @throws IntrospectionException any introspection exception that would prevent the parameter to be added
* @throws NullPointerException if the parameter is null
* @throws IllegalArgumentException if the parameter is already associated with another command
*/
void addParameter(ParameterDescriptor parameter) throws IntrospectionException, NullPointerException, IllegalArgumentException {
//
if (parameter == null) {
throw new NullPointerException("No null parameter accepted");
}
if (parameter.owner != null) {
throw new IllegalArgumentException("The parameter is already associated with a command");
}
//
if (parameter instanceof OptionDescriptor) {
OptionDescriptor option = (OptionDescriptor)parameter;
for (String optionName : option.getNames()) {
String name;
if (optionName.length() == 1) {
name = "-" + optionName;
shortOptionNames.add(name);
} else {
name = "--" + optionName;
longOptionNames.add(name);
}
optionMap.put(name, option);
}
options.add(option);
ListIterator> i = parameters.listIterator();
while (i.hasNext()) {
ParameterDescriptor next = i.next();
if (next instanceof ArgumentDescriptor) {
i.previous();
break;
}
}
i.add(parameter);
parameter.owner = this;
} else if (parameter instanceof ArgumentDescriptor) {
ArgumentDescriptor argument = (ArgumentDescriptor)parameter;
if (argument.getMultiplicity() == Multiplicity.MULTI) {
if (listArgument) {
throw new IntrospectionException();
}
listArgument = true;
}
arguments.add(argument);
parameters.add(argument);
parameter.owner = this;
}
}
public abstract Class getType();
public abstract void printUsage(Appendable writer) throws IOException;
public abstract void printMan(Appendable writer) throws IOException;
/**
* Returns the command subordinates as a map.
*
* @return the subordinates
*/
public abstract Map> getSubordinates();
/**
* Returns the command parameters, the returned collection contains the command options and
* the command arguments.
*
* @return the command parameters
*/
public final Collection> getParameters() {
return uParameters;
}
/**
* Returns the command option names.
*
* @return the command option names
*/
public final Set getOptionNames() {
return uOptionMap.keySet();
}
/**
* Returns the command short option names.
*
* @return the command long option names
*/
public final Set getShortOptionNames() {
return uShortOptionNames;
}
/**
* Returns the command long option names.
*
* @return the command long option names
*/
public final Set getLongOptionNames() {
return uLongOptionNames;
}
/**
* Returns the command options.
*
* @return the command options
*/
public final Collection> getOptions() {
return uOptions;
}
/**
* Returns a command option by its name.
*
* @param name the option name
* @return the option
*/
public final OptionDescriptor getOption(String name) {
return optionMap.get(name);
}
/**
* Find an command option by its name.
*
* @param name the option name
* @return the option
*/
public abstract OptionDescriptor findOption(String name);
/**
* Returns a list of the command arguments.
*
* @return the command arguments
*/
public final List> getArguments() {
return uArguments;
}
/**
* Returns a a specified argument by its index.
*
* @param index the argument index
* @return the command argument
* @throws IllegalArgumentException if the index is not within the bounds
*/
public final ArgumentDescriptor getArgument(int index) throws IllegalArgumentException {
if (index < 0) {
throw new IllegalArgumentException();
}
if (index >= arguments.size()) {
throw new IllegalArgumentException();
}
return arguments.get(index);
}
/**
* Returns the command name.
*
* @return the command name
*/
public final String getName() {
return name;
}
/**
* Returns the command description.
*
* @return the command description
*/
public final Description getDescription() {
return description;
}
/**
* Returns the command usage, shortcut for invoking getDescription().getUsage() on this
* object.
*
* @return the command usage
*/
public final String getUsage() {
return description != null ? description.getUsage() : "";
}
}