com.vaadin.base.devserver

Class WebpackHandler

java.lang.Object

com.vaadin.base.devserver.AbstractDevServerRunner

com.vaadin.base.devserver.WebpackHandler

All Implemented Interfaces:

DevModeHandler, RequestHandler, Serializable

public final class WebpackHandler
extends AbstractDevServerRunner

Runs a webpack dev server and provides files handles getting resources from webpack-dev-server.

This class is meant to be used during developing time. For a production mode site webpack generates the static bundles that will be served directly from the servlet (using a default servlet if such exists) or through a stand alone static file server.

For internal use only. May be renamed or removed in a future release.

Since:

2.0

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	WEBPACK_SERVER The local installation path of the webpack-dev-server node script.

Constructor Summary

Constructors

Constructor and Description
WebpackHandler(Lookup lookup, int runningPort, File npmFolder, CompletableFuture<Void> waitFor) Creates and starts the dev mode handler if none has been started yet.

Method Summary

Modifier and Type	Method and Description
protected File	getServerBinary() Gets the binary that starts the dev server.
protected File	getServerConfig() Gets the main configuration file for the dev server.
protected Pattern	getServerFailurePattern() Gets a pattern to match with the output to determine that the server has failed to start.
protected String	getServerName() Gets the name of the dev server for outputting to the user and statistics.
protected List<String>	getServerStartupCommand(String nodeExec) Gets the commands to run to start the dev server.
protected Pattern	getServerSuccessPattern() Gets a pattern to match with the output to determine that the server has started successfully.
protected void	onDevServerCompilation(DevServerOutputTracker.Result result) Called whenever the dev server output matche the success or failure pattern.
protected void	updateServerStartupEnvironment(FrontendTools frontendTools, Map<String,String> environment) Defines the environment variables to use when starting the dev server.

Methods inherited from class com.vaadin.base.devserver.AbstractDevServerRunner

checkConnection, doStartDevServer, getApplicationConfiguration, getFailedOutput, getPort, getProjectRoot, getWatchDog, handleRequest, prepareConnection, serveDevModeRequest, stop, triggerLiveReload, validateFiles, waitForDevServer, writeStream

Methods inherited from class java.lang.Object

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

Field Detail

WEBPACK_SERVER

public static final String WEBPACK_SERVER

The local installation path of the webpack-dev-server node script.

See Also:

Constant Field Values

Constructor Detail

WebpackHandler

public WebpackHandler(Lookup lookup,
                      int runningPort,
                      File npmFolder,
                      CompletableFuture<Void> waitFor)

Creates and starts the dev mode handler if none has been started yet.

Parameters:

lookup - the provided lookup to get required data

runningPort - a port on which webpack is already running or 0 to start a new process

npmFolder - folder with npm configuration files

waitFor - a completable future whose execution result needs to be available to start the dev server

Method Detail

onDevServerCompilation

protected void onDevServerCompilation(DevServerOutputTracker.Result result)

Description copied from class: AbstractDevServerRunner

Called whenever the dev server output matche the success or failure pattern.

Overrides:

onDevServerCompilation in class AbstractDevServerRunner

getServerStartupCommand

protected List<String> getServerStartupCommand(String nodeExec)

Description copied from class: AbstractDevServerRunner

Gets the commands to run to start the dev server.

Specified by:

getServerStartupCommand in class AbstractDevServerRunner

Parameters:

nodeExec - the path to the node binary

updateServerStartupEnvironment

protected void updateServerStartupEnvironment(FrontendTools frontendTools,
                                              Map<String,String> environment)

Description copied from class: AbstractDevServerRunner

Defines the environment variables to use when starting the dev server.

Overrides:

updateServerStartupEnvironment in class AbstractDevServerRunner

Parameters:

frontendTools - frontend tools metadata

environment - the environment variables to use

getServerName

protected String getServerName()

Description copied from class: AbstractDevServerRunner

Gets the name of the dev server for outputting to the user and statistics.

Specified by:

getServerName in class AbstractDevServerRunner

getServerBinary

protected File getServerBinary()

Description copied from class: AbstractDevServerRunner

Gets the binary that starts the dev server.

Specified by:

getServerBinary in class AbstractDevServerRunner

getServerConfig

protected File getServerConfig()

Description copied from class: AbstractDevServerRunner

Gets the main configuration file for the dev server.

Specified by:

getServerConfig in class AbstractDevServerRunner

getServerSuccessPattern

protected Pattern getServerSuccessPattern()

Description copied from class: AbstractDevServerRunner

Gets a pattern to match with the output to determine that the server has started successfully.

Specified by:

getServerSuccessPattern in class AbstractDevServerRunner

getServerFailurePattern

protected Pattern getServerFailurePattern()

Description copied from class: AbstractDevServerRunner

Gets a pattern to match with the output to determine that the server has failed to start.

Specified by:

getServerFailurePattern in class AbstractDevServerRunner