Examples of com.mucommander.command.Command

com.mucommander.command.Command

Compiled shell commands.

A command is composed of three elements:

An {@link #getAlias() alias}, used to identify the command through the application.
A {@link #getCommand() command}, which is what will be executed by the instance of Command.
A {@link #getType() type}, which can be any of {@link #SYSTEM_COMMAND system} (invisible and inmutable),{@link #INVISIBLE_COMMAND invisible} (invisible and mutable) or {@link #NORMAL_COMMAND} (visible and mutable).

The basic command syntax is fairly simple:

Any non-escaped \ character will escape the following character and be removed from the tokens.
Any non-escaped " character will escape all characters until the next occurence of ", except for \.
Non-escaped space characters are used as token separators.

It is important to remember that " characters are not removed from the resulting tokens.

It's also possible to include keywords in a command:

$f is replaced by a file's full path.
$n is replaced by a file's name.
$e is replaced by a file's extension.
$N is replaced by a file's name without its extension.
$p is replaced by a file's parent's path.
$j is replaced by the path of the folder in which the JVM was started.

Once a Command instance has been retrieved, execution tokens can be retrieved through the {@link #getTokens(AbstractFile)} method. This will return a tokenized version of the command and replace anykeyword by the corresponding file value . It's also possible to skip keyword replacement through the {@link #getTokens()} method.

A command's executable tokens are typically meant to be used with {@link com.mucommander.process.ProcessRunner#execute(String[],AbstractFile)}in order to generate instances of {@link com.mucommander.process.AbstractProcess}.

@author Nicolas Rinaudo @see CommandManager @see com.mucommander.process.ProcessRunner @see com.mucommander.process.AbstractProcess

    private static void migrateCommand(String useName, String commandName, String alias) {
        String command;


        if(MuConfigurations.getPreferences().getBooleanVariable(useName) && (command = MuConfigurations.getPreferences().getVariable(commandName)) != null) {
            try {
                CommandManager.registerCommand(new Command(alias, command, CommandType.SYSTEM_COMMAND));}
            catch(CommandException e) {
                // Ignore this: the command didn't work in the first place, we might as well get rid of it.
            }
            MuConfigurations.getPreferences().removeVariable(useName);
            MuConfigurations.getPreferences().removeVariable(commandName);

        return CommandManager.getCommandForFile(file, false) != null;
    }


    @Override
    public void execute(AbstractFile file) throws IOException {
        Command command;


        // Attemps to find a command that matches the specified target.
        if((command = CommandManager.getCommandForFile(file, allowDefault)) == null)
            throw new UnsupportedOperationException();


        // If found, executes it.
        ProcessRunner.execute(command.getTokens(file), file);
    }

Examples of com.mucommander.command.Command

Related Classes of com.mucommander.command.Command