Module org.praxislive.launcher
Package org.praxislive.launcher

Class Launcher

java.lang.Object
org.praxislive.launcher.Launcher
public class Launcher extends Object
Main entry point for parsing command line arguments and launching a Hub. This launcher uses NetworkCoreFactory to build a distributed hub capable of proxying to other local or remote hubs. It can also support a server to allow the built hub to be controlled externally.

This class is mainly intended to be called from the main method entry point. The additional required context should provide support to launch another instance of this process.

This launcher understands the following command line switches -

  • -f / --file {file} : a script file or project directory to run.
  • -p / --port {auto | 0 .. 65535} : launch a server on the specified port. If 0 or auto, a port is automatically chosen. Unless --network is specified, connections are only supported over local loopback. The port is reported to standard out as "Listening at : [port]".
  • -n / --network {all | CIDR mask} : launch a server that supports remote connections, from all addresses or matching mask. Implies --port auto if not otherwise specified.
  • -i / --interactive : allow for controlling the hub via PCL commands over the command line.
  • --child : configure the process to run as a child process. Implies --port auto unless specified.

For other purposes, use the Hub.builder() directly to create and launch a Hub.

  • Constructor Details

    • Launcher

      public Launcher()

  • Method Details

    • main

      public static void main(Launcher.Context context, String[] args)
      Main entry point.
      Parameters:
      context - a context implementation providing for launching a child of this process
      args - the command line arguments, possibly amended