//
   //  ========================================================================
   //  Copyright (c) 1995-2012 Mort Bay Consulting Pty. Ltd.
   //  ------------------------------------------------------------------------
   //  All rights reserved. This program and the accompanying materials
   //  are made available under the terms of the Eclipse Public License v1.0
   //  and Apache License v2.0 which accompanies this distribution.
   //
   //      The Eclipse Public License is available at
  //      http://www.eclipse.org/legal/epl-v10.html
  //
  //      The Apache License v2.0 is available at
  //      http://www.opensource.org/licenses/apache2.0.php
  //
  //  You may elect to redistribute this code under either of these licenses.
  //  ========================================================================
  //
  
  package org.eclipse.jetty.io;
  
  import java.util.List;
  import java.util.concurrent.CopyOnWriteArrayList;
  import java.util.concurrent.Executor;
  import java.util.concurrent.TimeoutException;
  import java.util.concurrent.atomic.AtomicReference;
  
  import org.eclipse.jetty.util.Callback;
  import org.eclipse.jetty.util.ExecutorCallback;
  import org.eclipse.jetty.util.log.Log;
  import org.eclipse.jetty.util.log.Logger;
  
  /**
   * <p>A convenience base implementation of {@link Connection}.</p>
   * <p>This class uses the capabilities of the {@link EndPoint} API to provide a
   * more traditional style of async reading.  A call to {@link #fillInterested()}
   * will schedule a callback to {@link #onFillable()} or {@link #onFillInterestedFailed(Throwable)}
   * as appropriate.</p>
   */
  public abstract class AbstractConnection implements Connection
  {
      private static final Logger LOG = Log.getLogger(AbstractConnection.class);
  
      private final List<Listener> listeners = new CopyOnWriteArrayList<>();
      private final AtomicReference<State> _state = new AtomicReference<>(State.IDLE);
      private final long _created=System.currentTimeMillis();
      private final EndPoint _endPoint;
      private final Executor _executor;
      private final Callback<Void> _readCallback;
      private int _inputBufferSize=8192;
  
      public AbstractConnection(EndPoint endp, Executor executor)
      {
          this(endp, executor, true);
      }
  
      public AbstractConnection(EndPoint endp, Executor executor, final boolean dispatchCompletion)
      {
          if (executor == null)
              throw new IllegalArgumentException("Executor must not be null!");
          _endPoint = endp;
          _executor = executor;
          _readCallback = new ExecutorCallback<Void>(executor)
          {
              @Override
              protected void onCompleted(Void context)
              {
                  if (_state.compareAndSet(State.INTERESTED,State.FILLING))
                  {
                      try
                      {
                          onFillable();
                      }
                      finally
                      {
                          loop:while(true)
                          {
                              switch(_state.get())
                              {
                                  case IDLE:
                                  case INTERESTED:
                                      throw new IllegalStateException();
  
                                  case FILLING:
                                      if (_state.compareAndSet(State.FILLING,State.IDLE))
                                          break loop;
                                      break;
  
                                  case FILLING_INTERESTED:
                                      if (_state.compareAndSet(State.FILLING_INTERESTED,State.INTERESTED))
                                      {
                                          getEndPoint().fillInterested(null, _readCallback);
                                          break loop;
                                      }
                                      break;
                              }
                          }
  
                      }
                  }
                 else
                     LOG.warn(new Throwable());
             }
 
             @Override
             protected void onFailed(Void context, Throwable x)
             {
                 onFillInterestedFailed(x);
             }
 
             @Override
             protected boolean alwaysDispatchCompletion()
             {
                 return dispatchCompletion;
             }
 
             @Override
             public String toString()
             {
                 return String.format("AC.ReadCB@%x", AbstractConnection.this.hashCode());
             }
         };
     }
 
     @Override
     public void addListener(Listener listener)
     {
         listeners.add(listener);
     }
 
     public int getInputBufferSize()
     {
         return _inputBufferSize;
     }
 
     public void setInputBufferSize(int inputBufferSize)
     {
         _inputBufferSize = inputBufferSize;
     }
 
     public Executor getExecutor()
     {
         return _executor;
     }
 
     /**
      * <p>Utility method to be called to register read interest.</p>
      * <p>After a call to this method, {@link #onFillable()} or {@link #onFillInterestedFailed(Throwable)}
      * will be called back as appropriate.</p>
      * @see #onFillable()
      */
     public void fillInterested()
     {
         LOG.debug("fillInterested {}",this);
 
         loop:while(true)
         {
             switch(_state.get())
             {
                 case IDLE:
                     if (_state.compareAndSet(State.IDLE,State.INTERESTED))
                     {
                         getEndPoint().fillInterested(null, _readCallback);
                         break loop;
                     }
                     break;
 
                 case FILLING:
                     if (_state.compareAndSet(State.FILLING,State.FILLING_INTERESTED))
                         break loop;
                     break;
 
                 case FILLING_INTERESTED:
                 case INTERESTED:
                     break loop;
             }
         }
     }
 
     /**
      * <p>Callback method invoked when the endpoint is ready to be read.</p>
      * @see #fillInterested()
      */
     public abstract void onFillable();
 
     /**
      * <p>Callback method invoked when the endpoint failed to be ready to be read.</p>
      * @param cause the exception that caused the failure
      */
     public void onFillInterestedFailed(Throwable cause)
     {
         LOG.debug("{} onFillInterestedFailed {}", this, cause);
         if (_endPoint.isOpen())
         {
             boolean close = true;
             if (cause instanceof TimeoutException)
                 close = onReadTimeout();
             if (close)
             {
                 if (_endPoint.isOutputShutdown())
                     _endPoint.close();
                 else
                     _endPoint.shutdownOutput();
             }
         }
     }
 
     /**
      * <p>Callback method invoked when the endpoint failed to be ready to be read after a timeout</p>
      * @return true to signal that the endpoint must be closed, false to keep the endpoint open
      */
     protected boolean onReadTimeout()
     {
         return true;
     }
 
     // TODO remove this when open/close refactored
     final AtomicReference<Throwable> _opened = new AtomicReference<>(null);
     @Override
     public void onOpen()
     {
         LOG.debug("onOpen {}", this);
 
         for (Listener listener : listeners)
             listener.onOpened(this);
 
         if (!_opened.compareAndSet(null,new Throwable()))
         {
             LOG.warn("ALREADY OPENED ", _opened.get());
             LOG.warn("EXTRA OPEN AT ",new Throwable());
         }
     }
 
     @Override
     public void onClose()
     {
         LOG.debug("onClose {}",this);
 
         for (Listener listener : listeners)
             listener.onClosed(this);
     }
 
     @Override
     public EndPoint getEndPoint()
     {
         return _endPoint;
     }
 
     @Override
     public void close()
     {
         getEndPoint().close();
     }
 
     @Override
     public int getMessagesIn()
     {
         return 0;
     }
 
     @Override
     public int getMessagesOut()
     {
         return 0;
     }
 
     @Override
     public long getBytesIn()
     {
         // TODO Auto-generated method stub
         return 0;
     }
 
     @Override
     public long getBytesOut()
     {
         // TODO Auto-generated method stub
         return 0;
     }
 
     @Override
     public long getCreatedTimeStamp()
     {
         return _created;
     }
 
     @Override
     public String toString()
     {
         return String.format("%s@%x{%s}", getClass().getSimpleName(), hashCode(), _state.get());
     }
 
     private enum State
     {
         IDLE, INTERESTED, FILLING, FILLING_INTERESTED
     }
 }