com.chemaxon.screen.desktop

Class JettyStarter

java.lang.Object

com.chemaxon.screen.desktop.JettyStarter

public final class JettyStarter
extends Object

Utilities for launching embedded Jetty.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	JettyStarter.ServerWrapper Encapsulates embedded server.
static interface	JettyStarter.SslKeystoreSpec SSL keystore specification.

Method Summary

Modifier and Type	Method and Description
JettyStarter	additionalResourceDirectory(String dir) Specify additional resource directory.
JettyStarter	logFile(String logFile) Specify logfile.
JettyStarter	setAllowedOrigins(String value) Set allowed origins.
JettyStarter	socketStopper(int port, String secret) Create a socket based server stopper.
JettyStarter	ssl(String keystorePath, String keystorePassword) Specify keystore for ssl connections.
JettyStarter.ServerWrapper	start() Configure and start server, register socket listening stopper if specified.
JettyStarter.ServerWrapper	start(String res) Configure and start server, register socket listening stopper if specified.
void	startBlocking(String res) Start server in blocking mode.
void	startBlockingWithBrowse(String res) Start server and try to launch browser.
static JettyStarter	starter(int port, String webapp) Default starter.
JettyStarter.ServerWrapper	startWithBrowse(String res) Configure and start server, register socket listening stopper if specified.

Methods inherited from class java.lang.Object

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

Method Detail

ssl

public JettyStarter ssl(String keystorePath,
                        String keystorePassword)

Specify keystore for ssl connections. If specified only ssl connections will be accepted.

Parameters:

keystorePath - Keystore path. Typically passed to SslContextFactory.setKeyStorePath(java.lang.String).

keystorePassword - Keystore password. Typically passed to SslContextFactory.setKeyStorePassword(java.lang.String).

Returns:

Reference to this builder

logFile

public JettyStarter logFile(String logFile)

Specify logfile.

Parameters:

logFile - Logfile to use.

Returns:

Reference to this builder

additionalResourceDirectory

public JettyStarter additionalResourceDirectory(String dir)

Specify additional resource directory.

Parameters:

dir - Additional resource directory to expose

Returns:

Reference to this builder

socketStopper

public JettyStarter socketStopper(int port,
                                  String secret)

Create a socket based server stopper.

Parameters:

port - Port to listen to

secret - Secret expected

Returns:

Reference to this builder

setAllowedOrigins

public JettyStarter setAllowedOrigins(String value)

Set allowed origins. Install a CrossOriginFilter and set allowedOrigins parameter.

Parameters:

value - Value

Returns:

Reference to this builder

start

public JettyStarter.ServerWrapper start()
                                 throws Exception

Configure and start server, register socket listening stopper if specified.

Returns:

Server instance

Throws:

Exception

start

public JettyStarter.ServerWrapper start(String res)
                                 throws Exception

Configure and start server, register socket listening stopper if specified. Verbose messages are printed to stderr.

Returns:

Server instance

Throws:

Exception

startWithBrowse

public JettyStarter.ServerWrapper startWithBrowse(String res)
                                           throws Exception

Configure and start server, register socket listening stopper if specified. Verbose messages are printed to stderr. In case of failure in underlying Desktop.browse(java.net.URI) message is printed to stderr but exception is not propagated.

Returns:

Server instance

Throws:

Exception

startBlocking

public void startBlocking(String res)
                   throws Exception

Start server in blocking mode. Verbose messages are printed to stderr.

Parameters:

res - Resource to recommend for loading. Must start with "/".

Throws:

InterruptedException - propagated

Exception

startBlockingWithBrowse

public void startBlockingWithBrowse(String res)
                             throws Exception

Start server and try to launch browser. Verbose messages are printed to stderr. In case of failure in underlying Desktop.browse(java.net.URI) message is printed to stderr but exception is not propagated.

Parameters:

res - Resource to load in browser. Must start with "/".

Throws:

Exception - propagated

starter

public static JettyStarter starter(int port,
                                   String webapp)

Default starter.

Parameters:

webapp - Webapp location; delegated to WebAppContext.WebAppContext(java.lang.String, java.lang.String). Can be null, if no webapp dir.

Returns:

Default started