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

   1 //
   2 //  ========================================================================
   3 //  Copyright (c) 1995-2014 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         LOG.debug("starting {}",this);
  58         if (_server==null)
  59             LOG.warn("No Server set for {}",this);
  60         super.doStart();
  61     }
  62
  63     /* ------------------------------------------------------------ */
  64     /*
  65      * @see org.eclipse.thread.LifeCycle#stop()
  66      */
  67     @Override
  68     protected void doStop() throws Exception
  69     {
  70         LOG.debug("stopping {}",this);
  71         super.doStop();
  72     }
  73
  74     /* ------------------------------------------------------------ */
  75     @Override
  76     public void setServer(Server server)
  77     {
  78         if (_server==server)
  79             return;
  80         if (isStarted())
  81             throw new IllegalStateException(STARTED);
  82         _server=server;
  83     }
  84
  85     /* ------------------------------------------------------------ */
  86     @Override
  87     public Server getServer()
  88     {
  89         return _server;
  90     }
  91
  92     /* ------------------------------------------------------------ */
  93     @Override
  94     public void destroy()
  95     {
  96         if (!isStopped())
  97             throw new IllegalStateException("!STOPPED");
  98         super.destroy();
  99     }
 100
 101     /* ------------------------------------------------------------ */
 102     @Override
 103     public void dumpThis(Appendable out) throws IOException
 104     {
 105         out.append(toString()).append(" - ").append(getState()).append('\n');
 106     }
 107
 108 }