ioobj.h

Go to the documentation of this file.

#ifndef ioobj_h
#define ioobj_h

/*+
________________________________________________________________________

 (C) dGB Beheer B.V.; (LICENSE) http://opendtect.org/OpendTect_license.txt
 Author:        A.H. Bril
 Date:          31-7-1995
 RCS:           $Id$
________________________________________________________________________

-*/


#include "generalmod.h"
#include "multiid.h"
#include "namedobj.h"
#include "uistring.h"

class Conn;
class IOObj;
class CallBack;
class ascistream;
class ascostream;
class Translator;


/*\brief factory entry for IOObjs. Should deliver IOObj of certain type. */

mExpClass(General) IOObjProducer
{
public:
virtual         ~IOObjProducer()                {}
    virtual bool        canMake(const char*) const      = 0;
    virtual IOObj*      make(const char*,const MultiID&,
                             bool fill_defs) const      = 0;

};

/*\brief object describing how to do I/O for objects

The IOMan object manager manages IODir directories of IOObj objects. These
objects contain the information needed to do the I/O needed for the storage
that is accessed in OpendTect software.

Every IOObj has a unique key in the form of a MultiID. This key
holds (a) the position of the IOObj in the IOMan/IODir tree (b) a unique
integer as an index in the IOObj's own IODir.

If you know an IOObj is actually pointing to a simple file (i.e. if it's an
IOStream), then you can get the full filename (i.e. with path) using
fullUserExpr().

*/


mExpClass(General) IOObj : public NamedObject
{
public:
    uiString                    uiName() const { return toUiString(name()); }

    IOObj*                      clone() const;
    virtual const MultiID&      key() const                     { return key_; }

    virtual                     ~IOObj();
    virtual bool                isBad() const                   = 0;
    virtual void                copyFrom(const IOObj*)          = 0;
    virtual bool                hasConnType( const char* s ) const
                                { return connType() == s; }

    virtual const char*         connType() const                = 0;
    virtual Conn*               getConn(bool forread) const     = 0;

    virtual const OD::String&   translator() const             {return transl_;}
    virtual void                setTranslator( const char* s ) {transl_ = s; }
    virtual const OD::String&   group() const                   {return group_;}
    virtual void                setGroup( const char* s )       {group_ = s; }
    virtual const char*         fullUserExpr(bool forread=true) const = 0;
    virtual BufferString        mainFileName() const { return fullUserExpr(); }

    virtual bool                implExists(bool forread) const  = 0;
    virtual bool                implReadOnly() const            { return true; }
    virtual bool                implRemove() const              { return false;}
    virtual bool                implManagesObjects() const      { return false;}
    virtual bool                implRename(const char*,const CallBack* cb=0)
                                                        { return false; }
    virtual bool                implSetReadOnly(bool) const     { return false;}

    virtual const char*         dirName() const         { return dirnm_; }
    virtual IOPar&              pars() const                    { return pars_;}
    void                        updateCreationPars() const;

    static bool                 isKey(const char*);
    static bool                 isSurveyDefault(const MultiID&);
    void                        setSurveyDefault(const char* subsel = 0) const;
    Translator*                 createTranslator() const;
    void                        acquireNewKeyIn(const MultiID&);

    static int                  tmpID()         { return  999999; }
    inline bool                 isTmp() const   {return key_.leafID()>=tmpID();}
    bool                        isProcTmp() const;
    bool                        isUserSelectable(bool forread=true) const;
    bool                        isInCurrentSurvey() const;

protected:

    BufferString        dirnm_;
    MultiID             key_;
    BufferString        transl_;
    BufferString        group_;

                        IOObj(const char* nm=0,const char* ky=0);
                        IOObj(const IOObj&);
    static IOObj*       get(ascistream&,const char*,const char*);
    bool                put(ascostream&) const;
    virtual bool        getFrom(ascistream&)            = 0;
    virtual bool        putTo(ascostream&) const        = 0;
    int                 myKey() const;

private:

    friend class        IODir;

    static IOObj*       produce(const char*,const char* nm=0,const char* ky=0,
                                bool initdefaults=true);
    void                copyStuffFrom(const IOObj&);

    IOPar&              pars_;

public:

    void                setKey( const char* nm )        { key_ = nm; }
    virtual void        setDirName( const char* s )     { dirnm_ = s; }
    virtual bool        isSubdir() const                { return false; }
    static int          addProducer(IOObjProducer*);

};

mGlobal(General) bool equalIOObj(const MultiID&,const MultiID&);
mGlobal(General) bool areEqual(const IOObj*,const IOObj*);
mGlobal(General) bool fullImplRemove(const IOObj&);

#endif