//
// ========================================================================
// 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.util.thread;
import java.util.Arrays;
import java.util.List;
import java.util.concurrent.CopyOnWriteArrayList;
import org.eclipse.jetty.util.component.Destroyable;
import org.eclipse.jetty.util.component.LifeCycle;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
ShutdownThread is a shutdown hook thread implemented as
singleton that maintains a list of lifecycle instances
that are registered with it and provides ability to stop
these lifecycles upon shutdown of the Java Virtual Machine
/**
* ShutdownThread is a shutdown hook thread implemented as
* singleton that maintains a list of lifecycle instances
* that are registered with it and provides ability to stop
* these lifecycles upon shutdown of the Java Virtual Machine
*/
public class ShutdownThread extends Thread
{
private static final Logger LOG = LoggerFactory.getLogger(ShutdownThread.class);
private static final ShutdownThread _thread = new ShutdownThread();
private final AutoLock _lock = new AutoLock();
private boolean _hooked;
private final List<LifeCycle> _lifeCycles = new CopyOnWriteArrayList<LifeCycle>();
Default constructor for the singleton
Registers the instance as shutdown hook with the Java Runtime
/**
* Default constructor for the singleton
*
* Registers the instance as shutdown hook with the Java Runtime
*/
private ShutdownThread()
{
super("JettyShutdownThread");
}
private void hook()
{
try (AutoLock l = _lock.lock())
{
if (!_hooked)
Runtime.getRuntime().addShutdownHook(this);
_hooked = true;
}
catch (Exception e)
{
LOG.trace("IGNORED", e);
LOG.info("shutdown already commenced");
}
}
private void unhook()
{
try (AutoLock l = _lock.lock())
{
_hooked = false;
Runtime.getRuntime().removeShutdownHook(this);
}
catch (Exception e)
{
LOG.trace("IGNORED", e);
LOG.debug("shutdown already commenced");
}
}
Returns the instance of the singleton
Returns: the singleton instance of the ShutdownThread
/**
* Returns the instance of the singleton
*
* @return the singleton instance of the {@link ShutdownThread}
*/
public static ShutdownThread getInstance()
{
return _thread;
}
public static void register(LifeCycle... lifeCycles)
{
try (AutoLock l = _thread._lock.lock())
{
_thread._lifeCycles.addAll(Arrays.asList(lifeCycles));
if (_thread._lifeCycles.size() > 0)
_thread.hook();
}
}
public static void register(int index, LifeCycle... lifeCycles)
{
try (AutoLock l = _thread._lock.lock())
{
_thread._lifeCycles.addAll(index, Arrays.asList(lifeCycles));
if (_thread._lifeCycles.size() > 0)
_thread.hook();
}
}
public static void deregister(LifeCycle lifeCycle)
{
try (AutoLock l = _thread._lock.lock())
{
_thread._lifeCycles.remove(lifeCycle);
if (_thread._lifeCycles.size() == 0)
_thread.unhook();
}
}
public static boolean isRegistered(LifeCycle lifeCycle)
{
try (AutoLock l = _thread._lock.lock())
{
return _thread._lifeCycles.contains(lifeCycle);
}
}
@Override
public void run()
{
for (LifeCycle lifeCycle : _thread._lifeCycles)
{
try
{
if (lifeCycle.isStarted())
{
lifeCycle.stop();
LOG.debug("Stopped {}", lifeCycle);
}
if (lifeCycle instanceof Destroyable)
{
((Destroyable)lifeCycle).destroy();
LOG.debug("Destroyed {}", lifeCycle);
}
}
catch (Exception ex)
{
LOG.debug("Unable to stop", ex);
}
}
}
}