// **********************************************************************
//
// Copyright (c) 2002
// MutableRealms, Inc.
// Huntsville, AL, USA
//
// All Rights Reserved
//
// **********************************************************************

#ifndef ICE_EVENT_HANDLER_H
#define ICE_EVENT_HANDLER_H

#include <IceUtil/Shared.h>
#include <Ice/EventHandlerF.h>
#include <Ice/InstanceF.h>
#include <Ice/ThreadPoolF.h>
#include <Ice/BasicStream.h>

namespace Ice
{

class LocalException;

}

namespace IceInternal
{

class EventHandler : public ::IceUtil::Shared
{
public:
    
    //
    // Returns true if the event handler belongs to the server-side of
    // an application. Client-side otherwise.
    //
    virtual bool server() const = 0;

    //
    // Return true if read() must be called before calling message().
    //
    virtual bool readable() const = 0;

    //
    // Read data via the event handler. May only be called if
    // readable() returns true.
    //
    virtual void read(BasicStream&) = 0;

    //
    // A complete message has been received.
    //
    virtual void message(BasicStream&) = 0;

    //
    // Signal exception during reading or unmarshaling.
    //
    virtual void exception(const ::Ice::LocalException&) = 0;

    //
    // Will be called if the event handler is finally
    // unregistered. (Calling unregister() does not unregister
    // immediately.)
    //
    virtual void finished() = 0;

    //
    // Try to destroy the event handler. Returns false if the event
    // handler cannot be destroyed because it is in use, or true
    // otherwise.
    //
    virtual bool tryDestroy() = 0;

protected:
    
    EventHandler(const InstancePtr&);
    virtual ~EventHandler();

    InstancePtr _instance;

private:

    //
    // The _stream data member is for use by ThreadPool only
    //
    BasicStream _stream;
    friend ThreadPool;
};

}

#endif