lib/jetty/org/eclipse/jetty/server/handler/AbstractHandler.java

   1 //
   2 //  ========================================================================
   3 //  Copyright (c) 1995-2016 Mort Bay Consulting Pty. Ltd.
   4 //  ------------------------------------------------------------------------
   5 //  All rights reserved. This program and the accompanying materials
   6 //  are made available under the terms of the Eclipse Public License v1.0
   7 //  and Apache License v2.0 which accompanies this distribution.
   8 //
   9 //      The Eclipse Public License is available at
  10 //      http://www.eclipse.org/legal/epl-v10.html
  11 //
  12 //      The Apache License v2.0 is available at
  13 //      http://www.opensource.org/licenses/apache2.0.php
  14 //
  15 //  You may elect to redistribute this code under either of these licenses.
  16 //  ========================================================================
  17 //
  18
  19 package org.eclipse.jetty.server.handler;
  20
  21
  22 import java.io.IOException;
  23
  24 import org.eclipse.jetty.server.Handler;
  25 import org.eclipse.jetty.server.Server;
  26 import org.eclipse.jetty.util.annotation.ManagedObject;
  27 import org.eclipse.jetty.util.component.ContainerLifeCycle;
  28 import org.eclipse.jetty.util.log.Log;
  29 import org.eclipse.jetty.util.log.Logger;
  30
  31
  32 /* ------------------------------------------------------------ */
  33 /** AbstractHandler.
  34  */
  35 @ManagedObject("Jetty Handler")
  36 public abstract class AbstractHandler extends ContainerLifeCycle implements Handler
  37 {
  38     private static final Logger LOG = Log.getLogger(AbstractHandler.class);
  39
  40     private Server _server;
  41
  42     /* ------------------------------------------------------------ */
  43     /**
  44      *
  45      */
  46     public AbstractHandler()
  47     {
  48     }
  49
  50     /* ------------------------------------------------------------ */
  51     /*
  52      * @see org.eclipse.thread.LifeCycle#start()
  53      */
  54     @Override
  55     protected void doStart() throws Exception
  56     {
  57         if (LOG.isDebugEnabled())
  58             LOG.debug("starting {}",this);
  59         if (_server==null)
  60             LOG.warn("No Server set for {}",this);
  61         super.doStart();
  62     }
  63
  64     /* ------------------------------------------------------------ */
  65     /*
  66      * @see org.eclipse.thread.LifeCycle#stop()
  67      */
  68     @Override
  69     protected void doStop() throws Exception
  70     {
  71         if (LOG.isDebugEnabled())
  72             LOG.debug("stopping {}",this);
  73         super.doStop();
  74     }
  75
  76     /* ------------------------------------------------------------ */
  77     @Override
  78     public void setServer(Server server)
  79     {
  80         if (_server==server)
  81             return;
  82         if (isStarted())
  83             throw new IllegalStateException(STARTED);
  84         _server=server;
  85     }
  86
  87     /* ------------------------------------------------------------ */
  88     @Override
  89     public Server getServer()
  90     {
  91         return _server;
  92     }
  93
  94     /* ------------------------------------------------------------ */
  95     @Override
  96     public void destroy()
  97     {
  98         if (!isStopped())
  99             throw new IllegalStateException("!STOPPED");
 100         super.destroy();
 101     }
 102
 103     /* ------------------------------------------------------------ */
 104     @Override
 105     public void dumpThis(Appendable out) throws IOException
 106     {
 107         out.append(toString()).append(" - ").append(getState()).append('\n');
 108     }
 109
 110 }