ioobj.h

Go to the documentation of this file.

#pragma once
 
/*+
________________________________________________________________________
 
 (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;
 
    uiString                    phrCannotOpenObj() const;
    uiString                    phrCannotReadObj() const;
    uiString                    phrCannotLoadObj() const;
    uiString                    phrCannotWriteObj() const;
    uiString                    phrCannotWriteToDB() 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*);
 
mDeprecated("Use IOMam::implRemove instead")
mGlobal(General) bool fullImplRemove(const IOObj&);