org.eclipse.jetty.server.handler

Class ShutdownHandler

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.handler.AbstractHandler

org.eclipse.jetty.server.handler.AbstractHandlerContainer

org.eclipse.jetty.server.handler.HandlerWrapper

org.eclipse.jetty.server.handler.ShutdownHandler

All Implemented Interfaces:

Handler, HandlerContainer, Container, Destroyable, Dumpable, LifeCycle

public class ShutdownHandler
extends HandlerWrapper

A handler that shuts the server down on a valid request. Used to do "soft" restarts from Java. If _exitJvm ist set to true a hard System.exit() call is being made. This handler is a contribution from Johannes Brodwall: https://bugs.eclipse.org/bugs/show_bug.cgi?id=357687 Usage:

    Server server = new Server(8080);
    HandlerList handlers = new HandlerList();
    handlers.setHandlers(new Handler[]
    { someOtherHandler, new ShutdownHandler("secret password") });
    server.setHandler(handlers);
    server.start();
   

   public static void attemptShutdown(int port, String shutdownCookie) {
        try {
            URL url = new URL("http://localhost:" + port + "/shutdown?token=" + shutdownCookie);
            HttpURLConnection connection = (HttpURLConnection)url.openConnection();
            connection.setRequestMethod("POST");
            connection.getResponseCode();
            logger.info("Shutting down " + url + ": " + connection.getResponseMessage());
        } catch (SocketException e) {
            logger.debug("Not running");
            // Okay - the server is not running
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }
  

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

Container.InheritedListener, Container.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.server.handler.HandlerWrapper

_handler

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
ShutdownHandler(Server server, String shutdownToken) Deprecated.
ShutdownHandler(String shutdownToken)
ShutdownHandler(String shutdownToken, boolean exitJVM, boolean sendShutdownAtStart)

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doStart() Starts the managed lifecycle beans in the order they were added.
String	getShutdownToken()
void	handle(String target, Request baseRequest, HttpServletRequest request, HttpServletResponse response) Handle a request.
boolean	isExitJvm()
boolean	isSendShutdownAtStart()
void	sendShutdown()
void	setExitJvm(boolean exitJvm)
void	setSendShutdownAtStart(boolean sendShutdownAtStart)

Methods inherited from class org.eclipse.jetty.server.handler.HandlerWrapper

destroy, expandChildren, getHandler, getHandlers, setHandler, setServer

Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandlerContainer

expandHandler, findContainerOf, getChildHandlerByClass, getChildHandlers, getChildHandlersByClass

Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandler

doStop, dumpThis, getServer

Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

addBean, addBean, addBean, addEventListener, addManaged, contains, dump, dump, dump, dump, dump, dumpBeans, dumpObject, dumpStdErr, getBean, getBeans, getBeans, isManaged, manage, removeBean, removeBeans, removeEventListener, setBeans, setStopTimeout, start, stop, unmanage, updateBean, updateBeans

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.util.component.LifeCycle

addLifeCycleListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Constructor Detail

ShutdownHandler

@Deprecated
public ShutdownHandler(Server server,
                          String shutdownToken)

Deprecated.

Creates a listener that lets the server be shut down remotely (but only from localhost).

Parameters:

server - the Jetty instance that should be shut down

shutdownToken - a secret password to avoid unauthorized shutdown attempts

ShutdownHandler

public ShutdownHandler(String shutdownToken)

ShutdownHandler

public ShutdownHandler(String shutdownToken,
               boolean exitJVM,
               boolean sendShutdownAtStart)

Parameters:

shutdownToken -

sendShutdownAtStart - If true, a shutdown is sent as a HTTP post during startup, which will shutdown any previously running instances of this server with an identically configured ShutdownHandler

Method Detail

sendShutdown

public void sendShutdown()
                  throws IOException

Throws:

IOException

doStart

protected void doStart()
                throws Exception

Description copied from class: ContainerLifeCycle

Starts the managed lifecycle beans in the order they were added.

Overrides:

doStart in class AbstractHandler

Throws:

Exception

handle

public void handle(String target,
          Request baseRequest,
          HttpServletRequest request,
          HttpServletResponse response)
            throws IOException,
                   ServletException

Description copied from interface: Handler

Handle a request.

Specified by:

handle in interface Handler

Overrides:

handle in class HandlerWrapper

Parameters:

target - The target of the request - either a URI or a name.

baseRequest - The original unwrapped request object.

request - The request either as the Request object or a wrapper of that request. The HttpChannel.getCurrentHttpChannel() method can be used access the Request object if required.

response - The response as the Response object or a wrapper of that request. The HttpChannel.getCurrentHttpChannel() method can be used access the Response object if required.

Throws:

IOException

ServletException

setExitJvm

public void setExitJvm(boolean exitJvm)

isSendShutdownAtStart

public boolean isSendShutdownAtStart()

setSendShutdownAtStart

public void setSendShutdownAtStart(boolean sendShutdownAtStart)

getShutdownToken

public String getShutdownToken()

isExitJvm

public boolean isExitJvm()