Package org.glassfish.embeddable

Interface CommandRunner

public interface CommandRunner
GlassFish has a very sophisticated command line interface (CLI) viz., 'asadmin' to executive administrative commands.

This is a programmatic interface equivalent to 'asadmin'.

This interface allows the execution of the adminstrative commands from an application which embeds GlassFish.

A command runner is obtained by calling GlassFish.getCommandRunner().

A command runner is a per-lookup type object, which means each time GlassFish.getCommandRunner() is called, it returns a new instance of command runner. Command specific options are passed in the var-args argument of run(String, String...) method.

Author:
Sanjeeb.Sahoo@Sun.COM

  • Method Summary

    Modifier and Type
    Method
    Description
    CommandResult
    run(String command, String... args)
    Execute an administrative command in GlassFish using the supplied command arguments.
    void
    setTerse(boolean terse)
    Set the terse level.

  • Method Details

    • run

      CommandResult run(String command, String... args)
      Execute an administrative command in GlassFish using the supplied command arguments. Refer to GlassFish Administration Guide to know about the commands supported in GlassFish and their usage.

      Example: To add an additional http listener 9090 : 

            commandRunner.run("create-http-listener", "--listenerport", "9090",
                                       "--listeneraddress", "0.0.0.0",
                                       "--defaultvs", "server",
                                       "--securityenabled", "false",
                                       "listener_id", "my-http-listener-1");
      asadmin commands also allow option values to be specified using '=', so the above example can be written as: 
            commandRunner.run("create-http-listener", "--listenerport=9090",
                                       "--listeneraddress=0.0.0.0",
                                       "--defaultvs=server",
                                       "--securityenabled=false",
                                       "listener_id=my-http-listener-1");
      Parameters:
      command - command to be executed.
      args - command arguments.
      Returns:
      CommandResult which encapsulates exit status, command output, failure cause (if any).

    • setTerse

      void setTerse(boolean terse)
      Set the terse level. If true, output data is very concise and in a format that is optimized for use in programs instead of for reading by humans. Typically, descriptive text and detailed status messages are also omitted from the output data. Default is true.
      Parameters:
      terse - true to get concise output, false otherwise.