Package com.mastfrog.acteur.server

Class ServerLifecycleHook

java.lang.Object

com.mastfrog.acteur.server.ServerLifecycleHook

public abstract class ServerLifecycleHook
extends Object

Implement and bind as an eager singleton if you have code that should run only in the case of (and after) the server is started.

Note: in the case you start the server instance repeatedly on several ports (say, ssl and non ssl), initialization code is run once the first port is opened.

A hook may throw an exception, which will be logged via the usual mechanism (ApplicationControl.internalOnError()). This will not prevent other hooks from being called.

Author:

Tim Boudreau

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	ServerLifecycleHook.Registry

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ServerLifecycleHook(ServerLifecycleHook.Registry reg)

Method Summary

Modifier and Type	Method	Description
protected void	onShutdown()	Called immediately after shutdown, when the server socket is closed.
protected abstract void	onStartup(Application application, io.netty.channel.Channel channel)	Called when the first server channel (socket) is opened.

Methods inherited from class java.lang.Object

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

Constructor Details

ServerLifecycleHook

protected ServerLifecycleHook(ServerLifecycleHook.Registry reg)

Method Details

onStartup

protected abstract void onStartup(Application application,
 io.netty.channel.Channel channel)
                           throws Exception

Called when the first server channel (socket) is opened.

Parameters:

application - The application

channel - The server socket channel

Throws:

Exception - If something goes wrong

onShutdown

protected void onShutdown()
                   throws Exception

Called immediately after shutdown, when the server socket is closed.

Throws:

Exception