/**

 The contents of this file are subject to the Mozilla Public License Version 1.1 

 (the "License"); you may not use this file except in compliance with the License. 

 You may obtain a copy of the License at http://www.mozilla.org/MPL/ 

 Software distributed under the License is distributed on an "AS IS" basis, 

 WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the 

 specific language governing rights and limitations under the License. 

 The Original Code is "ManagedRunnable.java".  Description: 

 "Base class for a unified management of threads with a defined lifecycle." 

 The Initial Developer of the Original Code is University Health Network. Copyright (C) 

 2001.  All Rights Reserved. 

 Contributor(s): ______________________________________. 

 Alternatively, the contents of this file may be used under the terms of the 

 GNU General Public License (the  "GPL"), in which case the provisions of the GPL are 

 applicable instead of those above.  If you wish to allow use of your version of this 

 file only under the terms of the GPL and not to allow others to use your version 

 of this file under the MPL, indicate your decision by deleting  the provisions above 

 and replace  them with the notice and other provisions required by the GPL License.  

 If you do not delete the provisions above, a recipient may use your version of 

 this file under either the MPL or the GPL. 

  */

 package ca.uhn.hl7v2.concurrent;

 import java.util.concurrent.CountDownLatch;

 import java.util.concurrent.ExecutionException;

 import java.util.concurrent.ExecutorService;

 import java.util.concurrent.Future;

 import java.util.concurrent.TimeUnit;

 import java.util.concurrent.TimeoutException;

 import org.slf4j.Logger;

 import org.slf4j.LoggerFactory;

 /**

  * Base class for a unified management of threads with a defined lifecycle. It

  * uses a {@link #keepRunning} flag to regularly terminate a thread. Classes

  * implementing this class must implement {@link #handle()} to do the main

  * processing. {@link #afterStartup()} and {@link #afterTermination()} can be

  * overridden to acquire and release resources required for processing.

  */

 public abstract class Service implements Runnable {

         private static final Logger log = LoggerFactory

                         .getLogger(Service.class);

         private volatile boolean keepRunning;

         private long shutdownTimeout = 3000L;

         private final String name;

         private final ExecutorService executorService;

         private Future<?> thread;

         private Throwable serviceExitedWithException;

         private CountDownLatch startupLatch = new CountDownLatch(1);

         public Service(String name, ExecutorService executorService) {

                 super();

                 this.name = name;

                 this.executorService = executorService;

         }

         /**

          * @return Returns <code>true</code> if the server has been started, and has

          *         not yet been stopped.

          */

         public boolean isRunning() {

                 return keepRunning;

         }

         public ExecutorService getExecutorService() {

                 return executorService;

         }

         /**

          * Sets the time in milliseconds how long {@link #stopAndWait()} should wait

          * for the thread to terminate. Defaults to 3000ms.

          * 

          * @param shutdownTimeout timout in milliseconds

          */

         public void setShutdownTimeout(long shutdownTimeout) {

                 this.shutdownTimeout = shutdownTimeout;

         }

         /**

          * Starts the server listening for connections in a new thread. This

          * continues until <code>stop()</code> is called.

          * 

          * @throws IllegalStateException If the service is already running (i.e.

          *                               start() has already been called.

          * 

          */

         public void start() {

                 if (keepRunning) {

                         throw new IllegalStateException("Service is already running");

                 }

                 log.debug("Starting service {}", name);

                 keepRunning = true;

                 ExecutorService service = getExecutorService();

                 if (service.isShutdown()) {

                         throw new IllegalStateException("ExecutorService is shut down");

                 }

                 thread = service.submit(this);

         }

         /**

          * <p>

          * Starts the server listening for connections in a new thread. This

          * continues until <code>stop()</code> is called.

          * </p>

          * <p>

          * Unlike {@link #start()}, this method will not return until the processing

          * loop has completed at least once. This does not imply any kind of successful

          * processing, but should at least provide a guarantee that the service

          * has finished initializing itself.

          * </p>

          */

         public void startAndWait() throws InterruptedException {

                 start();

                 startupLatch.await();

         }

         /**

          * Prepare any resources before entering the main thread.

          * 

          * @throws RuntimeException

          *             if resources could not acquired. In this case, the thread

          *             will shutdown. Note that {@link #afterTermination()} is

          *             called before.

          */

         protected void afterStartup() {

         }

         /**

          * The main task of the thread, called in a loop as long as

          * {@link #isRunning()} returns true. Overridden methods are responsible for

          * yielding or pausing the thread when it's idle. The method must also not

          * block indefinitely so that a call to {@link #stop()} is able to

          * gracefully terminate the thread.

          */

         protected abstract void handle();

         /**

          * Advises the thread to leave its main loop. {@link #prepareTermination()} is

          * called before this method returns. {@link #afterTermination()} is

          * called after the thread has left its main loop.

          */

         public void stop() {

                 if (isRunning()) {

                         prepareTermination();

                 }

         }

         public void waitForTermination() {

                 if (!thread.isDone())

                         try {

                                 thread.get(shutdownTimeout, TimeUnit.MILLISECONDS);

                         } catch (ExecutionException ee) {

                 // empty

                         } catch (TimeoutException te) {

                                 log.warn(

                                                 "Thread did not stop after {} milliseconds. Now cancelling.",

                                                 shutdownTimeout);

                                 thread.cancel(true);

                         } catch (InterruptedException e) {

                 // empty

                         }

         }

         /**

          * Stops the thread by leaving its main loop. {@link #afterTermination()} is

          * called before the thread is terminated. The method waits until the thread

          * has stopped.

          */

         public final void stopAndWait() {

                 stop();

                 waitForTermination();

         }

         /**

          * Clean up any resources initialized in {@link #afterStartup()}.

          */

         protected void afterTermination() {

         }

         /**

          * Prepare thread to leave its main loop. By default sets {@link #keepRunning}

          * to false, but some implementations may need to do additional stuff.

          */

         protected void prepareTermination() {

                 log.debug("Prepare to stop thread {}", name);

                 keepRunning = false;

         }

         /**

          * Runs the thread.

          * 

          * @see java.lang.Runnable#run()

          */

         public final void run() {

                 try {

                         afterStartup();

                         log.debug("Thread {} entering main loop", name);

                         while (isRunning()) {

                                 handle();

                                 startupLatch.countDown();

                         }

                         log.debug("Thread {} leaving main loop", name);

                 } catch (RuntimeException t) {

                         if (t.getCause() != null) {

                                 serviceExitedWithException = t.getCause();

                         } else {

                                 serviceExitedWithException = t;

                         }

                         log.warn("Thread exiting main loop due to exception:", t);

                 } catch (Throwable t) {

                         serviceExitedWithException = t;

                         log.warn("Thread exiting main loop due to exception:", t);

                 } finally {

                         startupLatch.countDown();

                         afterTermination();

                 }

         }

         /**

          * Provide the exception which caused this service to fail

          */

         protected void setServiceExitedWithException(Throwable theThreadExitedWithException) {

                 serviceExitedWithException = theThreadExitedWithException;

         }

         /**

          * If this service exited with an exception, ths method returns that exception. This is useful for

          * detecting if the service failed unexpectedly

          */

         public Throwable getServiceExitedWithException() {

                 return serviceExitedWithException;

         }

 }