com.dtolabs.rundeck.core.cli.CLIUtils.java Source code

Java tutorial

Introduction

Here is the source code for com.dtolabs.rundeck.core.cli.CLIUtils.java

Source

/*
 * Copyright 2010 DTO Labs, Inc. (http://dtolabs.com)
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

/*
* CLIUtils.java
* 
* User: Greg Schueler <a href="mailto:greg@dtosolutions.com">greg@dtosolutions.com</a>
* Created: Mar 31, 2010 8:43:34 AM
* $Id$
*/
package com.dtolabs.rundeck.core.cli;

import com.dtolabs.rundeck.core.utils.Converter;
import org.apache.commons.collections.Predicate;
import org.apache.commons.lang.CharUtils;
import org.apache.commons.lang.StringUtils;

import java.util.ArrayList;
import java.util.Arrays;

/**
 * CLIUtils provides utility functions
 *
 * @author Greg Schueler <a href="mailto:greg@dtosolutions.com">greg@dtosolutions.com</a>
 * @version $Revision$
 */
public class CLIUtils {
    /**
     * Create an appropriately quoted argline to use given the command (script path) and argument strings.
     *
     * @param scriptpath path to command or script
     * @param args       arguments to pass to the command
     *
     * @return a String of the command followed by the arguments, where each item which has spaces is appropriately
     *         quoted.  Pre-quoted items are not changed during "unsafe" quoting.
     *
     *         At this point in time, default behavior is "unsafe" quoting.
     */
    public static String generateArgline(final String scriptpath, final String[] args) {
        return generateArgline(scriptpath, args, " ", false);
    }

    /**
     * Create an appropriately quoted argline to use given the command (script path) and argument strings.
     *
     * @param scriptpath path to command or script
     * @param args       arguments to pass to the command
     * @param unsafe     whether to use backwards-compatible, known-insecure quoting
     *
     * @return a String of the command followed by the arguments, where each item which has spaces is appropriately
     *         quoted.  Pre-quoted items are not changed during "unsafe" quoting.
     */
    public static String generateArgline(final String scriptpath, final String[] args, final Boolean unsafe) {
        return generateArgline(scriptpath, args, " ", unsafe);
    }

    /**
     * Create an appropriately quoted argline to use given the command (script path) and argument strings.
     *
     * @param scriptpath path to command or script
     * @param args       arguments to pass to the command
     * @param separator  character to use to separate arguments
     * @param unsafe     whether to use backwards-compatible, known-insecure quoting
     *
     * @return a String of the command followed by the arguments, where each item which has spaces is appropriately
     *         quoted.  Pre-quoted items are not changed during "unsafe" quoting.
     */
    public static String generateArgline(final String scriptpath, final String[] args, final String separator,
            final Boolean unsafe) {
        final StringBuilder sb = new StringBuilder();
        final ArrayList<String> list = new ArrayList<String>();
        if (null != scriptpath) {
            list.add(scriptpath);
        }
        if (null != args) {
            list.addAll(Arrays.asList(args));
        }
        for (final String arg : list) {
            if (null == arg) {
                continue;
            }
            if (sb.length() > 0) {
                sb.append(separator);
            }
            if (unsafe) {
                /* DEPRECATED SECURITY RISK: Exists for backwards compatibility only. */
                if (arg.indexOf(" ") >= 0
                        && !(0 == arg.indexOf("'") && (arg.length() - 1) == arg.lastIndexOf("'"))) {
                    sb.append("'").append(arg).append("'");
                } else {
                    sb.append(arg);
                }
            } else {
                quoteUnixShellArg(sb, arg);
            }
        }
        return sb.toString();
    }

    /**
     * Return true if the string contains any whitespace
     * @param arg
     * @return
     */
    public static boolean containsSpace(String arg) {
        return StringUtils.containsAny(arg, " ");
    }

    /**
     * Return true if the string contains any whitespace
     * @param arg
     * @return
     */
    public static boolean containsQuote(String arg) {
        return StringUtils.containsAny(arg, "'");
    }

    /**
     * evaluates to true if a string contains a space
     */
    public static final Predicate stringContainsWhitespacePredicate = new Predicate() {
        @Override
        public boolean evaluate(Object o) {
            return CLIUtils.containsSpace((String) o);
        }
    };
    /**
     * evaluates to true if a string contains a quote
     */
    public static final Predicate stringContainsQuotePredicate = new Predicate() {
        @Override
        public boolean evaluate(Object o) {
            return CLIUtils.containsQuote((String) o);
        }
    };

    public static String quoteUnixShellArg(String arg) {
        StringBuilder stringBuilder = new StringBuilder();
        quoteUnixShellArg(stringBuilder, arg);
        return stringBuilder.toString();
    }

    private static void quoteUnixShellArg(StringBuilder sb, String arg) {
        if (StringUtils.containsNone(arg, UNIX_SHELL_CHARS) && StringUtils.containsNone(arg, WS_CHARS)
                && StringUtils.containsNone(arg, " ")) {
            if (arg != null) {
                sb.append(arg);
            }
            return;
        }
        sb.append("'");
        sb.append(arg.replace("'", "'\"'\"'"));
        sb.append("'");
    }

    public static Converter<String, String> characterEscapeForOperatingSystem(String type) {
        Converter<String, String> defaultConverter = UNIX_SHELL_ESCAPE;
        if ("unix".equalsIgnoreCase(type)) {
            return UNIX_SHELL_ESCAPE;
            //TODO: windows
        } else {
            return defaultConverter;
        }
    }

    public static Converter<String, String> argumentQuoteForOperatingSystem(String type) {
        Converter<String, String> defaultConverter = UNIX_ARGUMENT_QUOTE;
        if ("unix".equalsIgnoreCase(type)) {
            return UNIX_ARGUMENT_QUOTE;
            //TODO: windows
        } else {
            return defaultConverter;
        }
    }

    /**
     * Converter that can escape shell-special characters
     */
    public static final Converter<String, String> UNIX_ARGUMENT_QUOTE = new Converter<String, String>() {
        public String convert(String s) {
            return quoteUnixShellArg(s);
        }
    };
    /**
     * Converter that can escape shell-special characters
     */
    public static final Converter<String, String> UNIX_SHELL_ESCAPE = new Converter<String, String>() {
        public String convert(String s) {
            return escapeUnixShellChars(s);
        }
    };

    public static String escapeUnixShellChars(String str) {
        StringBuilder stringBuilder = new StringBuilder();
        escapeUnixShellChars(stringBuilder, str);
        return stringBuilder.toString();
    }

    private static final String UNIX_SHELL_CHARS = "\"';{}()&$\\|*?><";
    /**
     * non-space whitespace
     */
    private static final String WS_CHARS = "\n\r\t";

    public static void escapeUnixShellChars(StringBuilder out, String str) {
        if (StringUtils.containsNone(str, UNIX_SHELL_CHARS)) {
            if (str != null) {
                out.append(str);
            }
            return;
        }
        for (int i = 0; i < str.length(); i++) {
            char c = str.charAt(i);
            if (UNIX_SHELL_CHARS.indexOf(c) >= 0) {
                out.append('\\');
            } else if (WS_CHARS.indexOf(c) >= 0) {
                out.append('\\');
                if (c == CharUtils.CR) {
                    out.append('r');
                } else if (c == CharUtils.LF) {
                    out.append('n');
                } else if (c == '\t') {
                    out.append('t');
                }
                continue;
            }
            out.append(c);
        }
    }
}