org.jboss.as.cli.scriptsupport

Class CLI

java.lang.Object

org.jboss.as.cli.scriptsupport.CLI

public class CLI
extends Object

This class is intended to be used with JVM-based scripting languages. It acts as a facade to the CLI public API, providing a single class that can be used to connect, run CLI commands, and disconnect. It also removes the need to catch checked exceptions.

Author:

Stan Silvert ssilvert@redhat.com (C) 2012 Red Hat Inc.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	CLI.Result The Result class provides all information about an executed CLI command.

Method Summary

Modifier and Type	Method and Description
CLI.Result	cmd(String cliCommand) Execute a CLI command.
void	connect() Connect to the server using the default host and port.
void	connect(String username, char[] password) Connect to the server using the default host and port.
void	connect(String controllerHost, int controllerPort, String username, char[] password) Connect to the server using a specified host and port.
void	connect(String controller, String username, char[] password) Connect to the server using a specified host and port.
void	connect(String protocol, String controllerHost, int controllerPort, String username, char[] password) Connect to the server using a specified host and port.
void	disconnect() Disconnect from the server.
CommandContext	getCommandContext() Return the CLI CommandContext that was created when connected to the server.
static CLI	newInstance() Create a new CLI instance.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

newInstance

public static CLI newInstance()

Create a new CLI instance.

Returns:

The CLI instance.

getCommandContext

public CommandContext getCommandContext()

Return the CLI CommandContext that was created when connected to the server. This allows a script developer full access to CLI facilities if needed.

Returns:

The CommandContext, or null if not connected.

connect

public void connect()

Connect to the server using the default host and port.

connect

public void connect(String username,
                    char[] password)

Connect to the server using the default host and port.

Parameters:

username - The user name for logging in.

password - The password for logging in.

connect

public void connect(String controller,
                    String username,
                    char[] password)

Connect to the server using a specified host and port.

Parameters:

controllerHost - The host name.

controllerPort - The port.

username - The user name for logging in.

password - The password for logging in.

connect

public void connect(String controllerHost,
                    int controllerPort,
                    String username,
                    char[] password)

Connect to the server using a specified host and port.

Parameters:

controllerHost - The host name.

controllerPort - The port.

username - The user name for logging in.

password - The password for logging in.

connect

public void connect(String protocol,
                    String controllerHost,
                    int controllerPort,
                    String username,
                    char[] password)

Connect to the server using a specified host and port.

Parameters:

protocol - The protocol

controllerHost - The host name.

controllerPort - The port.

username - The user name for logging in.

password - The password for logging in.

disconnect

public void disconnect()

Disconnect from the server.

cmd

public CLI.Result cmd(String cliCommand)

Execute a CLI command. This can be any command that you might execute on the CLI command line, including both server-side operations and local commands such as 'cd' or 'cn'.

Parameters:

cliCommand - A CLI command.

Returns:

A result object that provides all information about the execution of the command.