net/object.h

/* Copyright (c) 2005-2010, Stefan Eilemann <eile@equalizergraphics.com> 
 *
 * This library is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License version 2.1 as published
 * by the Free Software Foundation.
 *  
 * This library is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more
 * details.
 * 
 * You should have received a copy of the GNU Lesser General Public License
 * along with this library; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */

#ifndef EQNET_OBJECT_H
#define EQNET_OBJECT_H

#include <eq/net/dispatcher.h>    // base class
#include <eq/net/node.h>          // used in RefPtr
#include <eq/net/types.h>         // for Nodes
#include <eq/net/version.h>       // used as default parameter

namespace eq
{
namespace net
{
    class DataIStream;
    class DataOStream;
    class Node;
    class ObjectCM;
    class Session;
    struct ObjectPacket;

    class Object : public Dispatcher
    {
    public:
        enum ChangeType
        {
            STATIC,            
            INSTANCE,          
            DELTA,             
            UNBUFFERED,        
#ifdef EQ_USE_DEPRECATED
            DELTA_UNBUFFERED = UNBUFFERED
#endif
        };

        EQ_EXPORT Object();

        EQ_EXPORT virtual ~Object();

        EQ_EXPORT virtual void makeThreadSafe();  

        EQ_EXPORT virtual bool dispatchCommand( Command& command );

        bool isThreadSafe() const      { return _threadSafe; }

        bool isAttached() const { return getID() <= EQ_ID_MAX; }

        EQ_EXPORT NodePtr getLocalNode();

        const Session* getSession() const { return _session; }

        Session* getSession()             { return _session; }

        uint32_t getID() const         { return _id; }

        uint32_t getInstanceID() const { return _instanceID; }

        EQ_EXPORT uint32_t getMasterInstanceID() const;

        EQ_EXPORT bool isMaster() const;

        virtual ChangeType getChangeType() const { return STATIC; }

        virtual bool isDirty() const { return true; }

        EQ_EXPORT uint32_t commit();

        EQ_EXPORT virtual uint32_t commitNB();
        
        EQ_EXPORT virtual uint32_t commitSync( const uint32_t commitID );

        EQ_EXPORT void obsolete( const uint32_t version );

        EQ_EXPORT void setAutoObsolete( const uint32_t count );

        EQ_EXPORT uint32_t getAutoObsoleteCount() const;

        EQ_EXPORT uint32_t sync( const uint32_t version = VERSION_HEAD );

        EQ_EXPORT uint32_t getHeadVersion() const;

        EQ_EXPORT uint32_t getVersion() const;

        EQ_EXPORT uint32_t getOldestVersion() const;

        virtual void notifyNewHeadVersion( const uint32_t version )
            { EQASSERT( getVersion()==VERSION_NONE||version<getVersion()+100 );}

        virtual void notifyNewVersion() {}

        virtual void getInstanceData( DataOStream& os ) = 0;

        virtual void applyInstanceData( DataIStream& is ) = 0;

        virtual void pack( DataOStream& os ) { getInstanceData( os ); }

        virtual void unpack( DataIStream& is ) { applyInstanceData( is ); }

        EQ_EXPORT bool send( NodePtr node, ObjectPacket& packet );

        EQ_EXPORT bool send( NodePtr node, ObjectPacket& packet,
                             const std::string& string );

        EQ_EXPORT bool send( NodePtr node, ObjectPacket& packet, 
                             const void* data, const uint64_t size );

        virtual void notifyAttached() {};

        virtual void notifyDetach() {};

    protected:
        EQ_EXPORT Object( const Object& );

        EQ_EXPORT const Object& operator = ( const Object& ) { return *this; }

        void setupChangeManager( const Object::ChangeType type, 
                                  const bool master, 
                              const uint32_t masterInstanceID = EQ_ID_INVALID );

        EQ_EXPORT virtual void attachToSession( const uint32_t id, 
                                                const uint32_t instanceID, 
                                                Session* session );

        EQ_EXPORT virtual void detachFromSession();

    private:
        Session*     _session;
        friend class Session;

        friend class DeltaMasterCM;
        friend class FullMasterCM;
        friend class MasterCM;
        friend class StaticMasterCM;
        friend class StaticSlaveCM;
        friend class UnbufferedMasterCM;
        friend class VersionedSlaveCM;

        uint32_t     _id;

        uint32_t     _instanceID;

        ObjectCM* _cm;

        bool _threadSafe;

        void _setChangeManager( ObjectCM* cm );
        const Nodes* _getSlaveNodes() const;

        /* The command handlers. */
        bool _cmdForward( Command& command );

        EQ_TS_VAR( _thread );
    };
    EQ_EXPORT std::ostream& operator << ( std::ostream&, const Object& );
}
}

#endif // EQNET_OBJECT_H