Package org.wildfly.core.launcher

Class CliCommandBuilder

  • All Implemented Interfaces:
    CommandBuilder
    public class CliCommandBuilder
extends Object
implements CommandBuilder
    Builds a list of commands to create a new process for a CLI instance.

    This builder is not thread safe and the same instance should not be used in multiple threads.

    Author:
    James R. Perkins

    • Method Detail

      • asModularLauncher

        public static CliCommandBuilder asModularLauncher​(Path wildflyHome)
        Creates a command builder for a CLI instance.
        Parameters:
        wildflyHome - the path to the WildFly home directory
        Returns:
        a new builder

      • asModularLauncher

        public static CliCommandBuilder asModularLauncher​(String wildflyHome)
        Creates a command builder for a CLI instance.
        Parameters:
        wildflyHome - the path to the WildFly home directory
        Returns:
        a new builder

      • asJarLauncher

        public static CliCommandBuilder asJarLauncher​(Path wildflyHome)
        Creates a command builder for a non-modular CLI instance launched from wildflyHome/bin/client/jboss-client.jar.
        Parameters:
        wildflyHome - the path to the WildFly home directory
        Returns:
        a new builder

      • asJarLauncher

        public static CliCommandBuilder asJarLauncher​(String wildflyHome)
        Creates a command builder for a non-modular CLI instance launched from wildflyHome/bin/client/jboss-client.jar.
        Parameters:
        wildflyHome - the path to the WildFly home directory
        Returns:
        a new builder

      • setConnection

        public CliCommandBuilder setConnection​(String controller)
        Sets the hostname and port to connect to.

        This sets both the --connect and --controller arguments.

        Parameters:
        controller - the controller argument to use
        Returns:
        the builder

      • setConnection

        public CliCommandBuilder setConnection​(String hostname,
                                       int port)
        Sets the hostname and port to connect to.

        This sets both the --connect and --controller arguments.

        Parameters:
        hostname - the host name
        port - the port
        Returns:
        the builder

      • setConnection

        public CliCommandBuilder setConnection​(String protocol,
                                       String hostname,
                                       int port)
        Sets the protocol, hostname and port to connect to.

        This sets both the --connect and --controller arguments.

        Parameters:
        protocol - the protocol to use
        hostname - the host name
        port - the port
        Returns:
        the builder

      • setController

        public CliCommandBuilder setController​(String controller)
        Sets the hostname and port to connect to.
        Parameters:
        controller - the controller argument to use
        Returns:
        the builder

      • setController

        public CliCommandBuilder setController​(String hostname,
                                       int port)
        Sets the hostname and port to connect to.
        Parameters:
        hostname - the host name
        port - the port
        Returns:
        the builder

      • setController

        public CliCommandBuilder setController​(String protocol,
                                       String hostname,
                                       int port)
        Sets the protocol, hostname and port to connect to.
        Parameters:
        protocol - the protocol to use
        hostname - the host name
        port - the port
        Returns:
        the builder

      • setUser

        public CliCommandBuilder setUser​(String user)
        Sets the user to use when establishing a connection.
        Parameters:
        user - the user to use
        Returns:
        the builder

      • setPassword

        public CliCommandBuilder setPassword​(String password)
        Sets the password to use when establishing a connection.
        Parameters:
        password - the password to use
        Returns:
        the builder

      • setScriptFile

        public CliCommandBuilder setScriptFile​(String path)
        Sets the path to the script file to execute.
        Parameters:
        path - the path to the script file to execute
        Returns:
        the builder

      • setScriptFile

        public CliCommandBuilder setScriptFile​(Path path)
        Sets the path to the script file to execute.
        Parameters:
        path - the path to the script file to execute
        Returns:
        the builder

      • setCommand

        public CliCommandBuilder setCommand​(String command)
        Sets the command to execute.
        Parameters:
        command - the command to execute
        Returns:
        the builder

      • setCommands

        public CliCommandBuilder setCommands​(String... commands)
        Sets the commands to execute.
        Parameters:
        commands - the commands to execute
        Returns:
        the builder

      • setCommands

        public CliCommandBuilder setCommands​(Iterable<String> commands)
        Sets the commands to execute.
        Parameters:
        commands - the commands to execute
        Returns:
        the builder

      • setTimeout

        public CliCommandBuilder setTimeout​(int timeout)
        Sets the timeout used when connecting to the server.
        Parameters:
        timeout - the time out to use
        Returns:
        the builder

      • setUseGui

        public CliCommandBuilder setUseGui()
        Sets the command argument to use the GUI CLI client.
        Returns:
        the builder

      • addJavaOption

        public CliCommandBuilder addJavaOption​(String jvmArg)
        Adds a JVM argument to the command ignoring null arguments.
        Parameters:
        jvmArg - the JVM argument to add
        Returns:
        the builder

      • addJavaOptions

        public CliCommandBuilder addJavaOptions​(String... javaOpts)
        Adds the array of JVM arguments to the command.
        Parameters:
        javaOpts - the array of JVM arguments to add, null arguments are ignored
        Returns:
        the builder

      • addJavaOptions

        public CliCommandBuilder addJavaOptions​(Iterable<String> javaOpts)
        Adds the collection of JVM arguments to the command.
        Parameters:
        javaOpts - the collection of JVM arguments to add, null arguments are ignored
        Returns:
        the builder

      • setJavaOptions

        public CliCommandBuilder setJavaOptions​(Iterable<String> javaOpts)
        Sets the JVM arguments to use. This overrides any default JVM arguments that would normally be added and ignores null values in the collection.

        If the collection is null the JVM arguments will be cleared and no new arguments will be added.

        Parameters:
        javaOpts - the JVM arguments to use
        Returns:
        the builder

      • setJavaOptions

        public CliCommandBuilder setJavaOptions​(String... javaOpts)
        Sets the JVM arguments to use. This overrides any default JVM arguments that would normally be added and ignores null values in the array.

        If the array is null the JVM arguments will be cleared and no new arguments will be added.

        Parameters:
        javaOpts - the JVM arguments to use
        Returns:
        the builder

      • getJavaOptions

        public List<String> getJavaOptions()
        Returns the JVM arguments.
        Returns:
        the JVM arguments

      • addCliArgument

        public CliCommandBuilder addCliArgument​(String arg)
        Adds an argument to be passed to the CLI command ignore the argument if null.
        Parameters:
        arg - the argument to pass
        Returns:
        the builder

      • addCliArguments

        public CliCommandBuilder addCliArguments​(String... args)
        Adds the arguments to the collection of arguments that will be passed to the CLI command ignoring any null arguments.
        Parameters:
        args - the arguments to add
        Returns:
        the builder

      • addCliArguments

        public CliCommandBuilder addCliArguments​(Iterable<String> args)
        Adds the arguments to the collection of arguments that will be passed to the CLI command ignoring any null arguments.
        Parameters:
        args - the arguments to add
        Returns:
        the builder

      • addModuleDir

        public CliCommandBuilder addModuleDir​(String moduleDir)
        Adds a directory to the collection of module paths.
        Parameters:
        moduleDir - the module directory to add
        Returns:
        the builder
        Throws:
        IllegalArgumentException - if the path is null

      • addModuleDirs

        public CliCommandBuilder addModuleDirs​(String... moduleDirs)
        Adds all the module directories to the collection of module paths.
        Parameters:
        moduleDirs - an array of module paths to add
        Returns:
        the builder
        Throws:
        IllegalArgumentException - if any of the module paths are invalid or null

      • addModuleDirs

        public CliCommandBuilder addModuleDirs​(Iterable<String> moduleDirs)
        Adds all the module directories to the collection of module paths.
        Parameters:
        moduleDirs - a collection of module paths to add
        Returns:
        the builder
        Throws:
        IllegalArgumentException - if any of the module paths are invalid or null

      • setModuleDirs

        public CliCommandBuilder setModuleDirs​(Iterable<String> moduleDirs)
        Replaces any previously set module directories with the collection of module directories.

        The default module directory will NOT be used if this method is invoked.

        Parameters:
        moduleDirs - the collection of module directories to use
        Returns:
        the builder
        Throws:
        IllegalArgumentException - if any of the module paths are invalid or null

      • setModuleDirs

        public CliCommandBuilder setModuleDirs​(String... moduleDirs)
        Replaces any previously set module directories with the array of module directories.

        The default module directory will NOT be used if this method is invoked.

        Parameters:
        moduleDirs - the array of module directories to use
        Returns:
        the builder
        Throws:
        IllegalArgumentException - if any of the module paths are invalid or null

      • getModulePaths

        public String getModulePaths()
        Returns the modules paths used on the command line.
        Returns:
        the paths separated by the path separator

      • setJavaHome

        public CliCommandBuilder setJavaHome​(String javaHome)
        Sets the Java home where the Java executable can be found.
        Parameters:
        javaHome - the Java home or null to use te system property java.home
        Returns:
        the builder

      • setJavaHome

        public CliCommandBuilder setJavaHome​(Path javaHome)
        Sets the Java home where the Java executable can be found.
        Parameters:
        javaHome - the Java home or null to use te system property java.home
        Returns:
        the builder

      • getJavaHome

        public Path getJavaHome()
        Returns the Java home directory where the java executable command can be found.

        If the directory was not set the system property value, java.home, should be used.

        Returns:
        the path to the Java home directory

      • buildArguments

        public List<String> buildArguments()
        Description copied from interface: CommandBuilder
        A list of command arguments required to launch WildFly instance.

        These are the arguments the follow a java executable command.

        Specified by:
        buildArguments in interface CommandBuilder
        Returns:
        the list of arguments required to launch WildFly

      • build

        public List<String> build()
        Description copied from interface: CommandBuilder
        A list of commands, including a java executable, required to launch WildFly instance.
        Specified by:
        build in interface CommandBuilder
        Returns:
        the list of arguments required to launch WildFly