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

Field Summary

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

commandByName, lookups, main

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

Constructor Summary

Constructors

Constructor and Description
Launcher()

Method Summary

Modifier and Type	Method and Description
void	afterStartingVertx(Vertx vertx) Hook for sub-classes of Starter after the vertx instance is started.
void	beforeDeployingVerticle(DeploymentOptions deploymentOptions) Hook for sub-classes of Starter before the verticle is deployed.
void	beforeStartingVertx(VertxOptions options) Hook for sub-classes of Starter before the vertx instance is started.
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, load, printCommandNotFound, printGenericExecutionError, printGlobalUsage, printSpecificException, resetProcessArguments

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

buildWrapped, buildWrapped, computeOptionsAndArguments, computeUsage, computeUsageLine, createPadding, findWrapPos, getArgName, getDescPadding, getLeftPadding, getLongOptionPrefix, getLongOptionSeparator, getNewLine, getOptionComparator, getOptionPrefix, getUsagePrefix, getWidth, renderCommands, renderOptionsAndArguments, renderWrappedText, 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.

beforeStartingVertx

public void beforeStartingVertx(VertxOptions options)

Hook for sub-classes of Starter 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 Starter 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 Starter 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