//
// ========================================================================
// Copyright (c) 1995-2020 Mort Bay Consulting Pty Ltd and others.
//
// This program and the accompanying materials are made available under
// the terms of the Eclipse Public License 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0
//
// This Source Code may also be made available under the following
// Secondary Licenses when the conditions for such availability set
// forth in the Eclipse Public License, v. 2.0 are satisfied:
// the Apache License v2.0 which is available at
// https://www.apache.org/licenses/LICENSE-2.0
//
// SPDX-License-Identifier: EPL-2.0 OR Apache-2.0
// ========================================================================
//

package org.eclipse.jetty.server.handler;

import java.io.IOException;
import java.util.List;

import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.eclipse.jetty.server.Handler;
import org.eclipse.jetty.server.Request;
import org.eclipse.jetty.server.Server;

A HandlerContainer that allows a hot swap of a wrapped handler.
/** * A <code>HandlerContainer</code> that allows a hot swap of a wrapped handler. */
public class HotSwapHandler extends AbstractHandlerContainer { private volatile Handler _handler; /** * */ public HotSwapHandler() { }
Returns:Returns the handlers.
/** * @return Returns the handlers. */
public Handler getHandler() { return _handler; }
Returns:Returns the handlers.
/** * @return Returns the handlers. */
@Override public Handler[] getHandlers() { Handler handler = _handler; if (handler == null) return new Handler[0]; return new Handler[]{handler}; }
Params:
  • handler – Set the Handler which should be wrapped.
/** * @param handler Set the {@link Handler} which should be wrapped. */
public void setHandler(Handler handler) { try { Server server = getServer(); if (handler != null) handler.setServer(server); updateBean(_handler, handler, true); _handler = handler; } catch (Exception e) { throw new RuntimeException(e); } } @Override protected void doStart() throws Exception { super.doStart(); } @Override protected void doStop() throws Exception { super.doStop(); } @Override public void handle(String target, Request baseRequest, HttpServletRequest request, HttpServletResponse response) throws IOException, ServletException { Handler handler = _handler; if (handler != null && isStarted() && handler.isStarted()) { handler.handle(target, baseRequest, request, response); } } @Override protected void expandChildren(List<Handler> list, Class<?> byClass) { Handler handler = _handler; if (handler != null) expandHandler(handler, list, byClass); } @Override public void destroy() { if (!isStopped()) throw new IllegalStateException("!STOPPED"); Handler child = getHandler(); if (child != null) { setHandler(null); child.destroy(); } super.destroy(); } }