io.vertx.core

Class Launcher

java.lang.Object

io.vertx.core.cli.UsageMessageFormatter

io.vertx.core.impl.launcher.VertxCommandLauncher

io.vertx.core.Launcher

All Implemented Interfaces:

io.vertx.core.impl.launcher.VertxLifecycleHooks

public class Launcher
extends io.vertx.core.impl.launcher.VertxCommandLauncher
implements io.vertx.core.impl.launcher.VertxLifecycleHooks

A main() class that can be used to create Vert.x instance and deploy a verticle, or run a bare Vert.x instance.

This class is used by the vertx command line utility to deploy verticles from the command line. It is extensible as "commands" can be added using the CommandFactory SPI.

E.g.

vertx run myverticle.js vertx my-command ...

It can also be used as the main class of an executable jar so you can run verticles directly with:

java -jar myapp.jar

Author:

Clement Escoffier

Nested Class Summary

Nested classes/interfaces inherited from class io.vertx.core.impl.launcher.VertxCommandLauncher

io.vertx.core.impl.launcher.VertxCommandLauncher.CommandRegistration

Field Summary

Fields inherited from class io.vertx.core.impl.launcher.VertxCommandLauncher

commandByName, lookups, main, PROCESS_ARGS

Fields inherited from class io.vertx.core.cli.UsageMessageFormatter

DEFAULT_ARG_NAME, DEFAULT_DESC_PAD, DEFAULT_LEFT_PAD, DEFAULT_LONG_OPT_PREFIX, DEFAULT_LONG_OPT_SEPARATOR, DEFAULT_OPT_PREFIX, DEFAULT_USAGE_PREFIX, DEFAULT_WIDTH, optionComparator

Constructor Summary

Constructors

Constructor and Description
Launcher()

Method Summary

Modifier and Type	Method and Description
void	afterStartingVertx(Vertx vertx) Hook for sub-classes of Launcher after the vertx instance is started.
void	beforeDeployingVerticle(DeploymentOptions deploymentOptions) Hook for sub-classes of Launcher before the verticle is deployed.
void	beforeStartingVertx(VertxOptions options) Hook for sub-classes of Launcher before the vertx instance is started.
static void	executeCommand(String cmd, String... args) Utility method to execute a specific command.
void	handleDeployFailed(Vertx vertx, String mainVerticle, DeploymentOptions deploymentOptions, Throwable cause) A deployment failure has been encountered.
static void	main(String[] args) Main entry point.

Methods inherited from class io.vertx.core.impl.launcher.VertxCommandLauncher

dispatch, dispatch, execute, getCommandLinePrefix, getCommandNames, getDefaultCommand, getExistingCommandInstance, getMainVerticle, getNewCommandInstance, getPrintStream, getProcessArguments, isAskingForHelp, isAskingForVersion, load, printCommandNotFound, printCommandUsage, printGenericExecutionError, printGlobalUsage, printSpecificException, register, register, resetProcessArguments, unregister

Methods inherited from class io.vertx.core.cli.UsageMessageFormatter

appendArgument, appendOption, buildWrapped, buildWrapped, computeOptionsAndArguments, computeUsage, computeUsageLine, createPadding, findWrapPos, getArgName, getDescPadding, getLeftPadding, getLongOptionPrefix, getLongOptionSeparator, getNewLine, getOptionComparator, getOptionPrefix, getUsagePrefix, getWidth, isNullOrEmpty, renderCommands, renderOptionsAndArguments, renderWrappedText, renderWrappedTextBlock, rtrim, setArgName, setDescPadding, setLeftPadding, setLongOptionPrefix, setLongOptionSeparator, setNewLine, setOptionComparator, setOptionPrefix, setUsagePrefix, setWidth, usage, usage

Methods inherited from class java.lang.Object

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

Constructor Detail

Launcher

public Launcher()

Method Detail

main

public static void main(String[] args)

Main entry point.

Parameters:

args - the user command line arguments.

executeCommand

public static void executeCommand(String cmd,
                                  String... args)

Utility method to execute a specific command.

Parameters:

cmd - the command

args - the arguments

beforeStartingVertx

public void beforeStartingVertx(VertxOptions options)

Hook for sub-classes of Launcher before the vertx instance is started.

Specified by:

beforeStartingVertx in interface io.vertx.core.impl.launcher.VertxLifecycleHooks

Parameters:

options - the vert.x options

afterStartingVertx

public void afterStartingVertx(Vertx vertx)

Hook for sub-classes of Launcher after the vertx instance is started.

Specified by:

afterStartingVertx in interface io.vertx.core.impl.launcher.VertxLifecycleHooks

Parameters:

vertx - the vert.x instance

beforeDeployingVerticle

public void beforeDeployingVerticle(DeploymentOptions deploymentOptions)

Hook for sub-classes of Launcher before the verticle is deployed.

Specified by:

beforeDeployingVerticle in interface io.vertx.core.impl.launcher.VertxLifecycleHooks

Parameters:

deploymentOptions - the deployment options

handleDeployFailed

public void handleDeployFailed(Vertx vertx,
                               String mainVerticle,
                               DeploymentOptions deploymentOptions,
                               Throwable cause)

A deployment failure has been encountered. You can override this method to customize the behavior. By default it closes the `vertx` instance.

Specified by:

handleDeployFailed in interface io.vertx.core.impl.launcher.VertxLifecycleHooks

Parameters:

vertx - the vert.x instance

mainVerticle - the main verticle name

deploymentOptions - the deployment options

cause - the cause