--- /dev/null
+// Created on: 1997-08-07
+// Created by: Jean-Louis Frenkel
+// Copyright (c) 1997-1999 Matra Datavision
+// Copyright (c) 1999-2014 OPEN CASCADE SAS
+//
+// This file is part of Open CASCADE Technology software library.
+//
+// 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, with special exception defined in the file
+// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
+// distribution for complete text of the license and disclaimer of any warranty.
+//
+// Alternatively, this file may be used under the terms of Open CASCADE
+// commercial license or contractual agreement.
+
+#ifndef _CDF_Application_HeaderFile
+#define _CDF_Application_HeaderFile
+
+#include <Standard.hxx>
+#include <Standard_Type.hxx>
+
+#include <TCollection_ExtendedString.hxx>
+#include <PCDM_ReaderStatus.hxx>
+#include <CDM_Application.hxx>
+#include <CDM_CanCloseStatus.hxx>
+#include <Standard_Boolean.hxx>
+#include <TColStd_SequenceOfExtendedString.hxx>
+#include <CDF_TypeOfActivation.hxx>
+#include <Standard_ExtString.hxx>
+#include <Standard_Integer.hxx>
+class Standard_NoSuchObject;
+class CDF_Session;
+class Standard_GUID;
+class CDM_Document;
+class TCollection_ExtendedString;
+class PCDM_Reader;
+class CDM_MetaData;
+
+
+class CDF_Application;
+DEFINE_STANDARD_HANDLE(CDF_Application, CDM_Application)
+
+
+class CDF_Application : public CDM_Application
+{
+
+public:
+
+
+ //! plugs an application.
+ //!
+ //! Open is used
+ //! - for opening a Document that has been created in an application
+ //! - for opening a Document from the database
+ //! - for opening a Document from a file.
+ //! The Open methods always add the document in the session directory and
+ //! calls the virtual Activate method. The document is considered to be
+ //! opened until Close is used. To be storable, a document must be
+ //! opened by an application since the application resources are
+ //! needed to store it.
+ Standard_EXPORT static Handle(CDF_Application) Load (const Standard_GUID& aGUID);
+
+ //! puts the document in the current session directory
+ //! and calls the virtual method Activate on it.
+ Standard_EXPORT void Open (const Handle(CDM_Document)& aDocument);
+
+ Standard_EXPORT CDM_CanCloseStatus CanClose (const Handle(CDM_Document)& aDocument);
+
+ //! removes the document of the current session directory
+ //! and closes the document;
+ Standard_EXPORT void Close (const Handle(CDM_Document)& aDocument);
+
+ //! This method retrieves a document from the database.
+ //! If the Document references other documents which have
+ //! been updated, the latest version of these documents will
+ //! be used if {UseStorageConfiguration} is Standard_True.
+ //! The content of {aFolder}, {aName} and {aVersion} depends on
+ //! the Database Manager system. If the DBMS is only based on
+ //! the OS, {aFolder} is a directory and {aName} is the name of a
+ //! file. In this case the use of the syntax with {aVersion}
+ //! has no sense. For example:
+ //!
+ //! Handle(CDM_Document) theDocument=myApplication->Retrieve("/home/cascade","box.dsg");
+ //! If the DBMS is EUCLID/Design Manager, {aFolder}, {aName}
+ //! have the form they have in EUCLID/Design Manager. For example:
+ //!
+ //! Handle(CDM_Document) theDocument=myApplication->Retrieve("|user|cascade","box");
+ //!
+ //! Since the version is not specified in this syntax, the latest wil be used.
+ //! A link is kept with the database through an instance of CDM_MetaData
+ Standard_EXPORT Handle(CDM_Document) Retrieve (const TCollection_ExtendedString& aFolder, const TCollection_ExtendedString& aName, const Standard_Boolean UseStorageConfiguration = Standard_True);
+
+ //! This method retrieves a document from the database.
+ //! If the Document references other documents which have
+ //! been updated, the latest version of these documents
+ //! will be used if {UseStorageConfiguration} is
+ //! Standard_True. -- If the DBMS is only based on the
+ //! OS, this syntax should not be used.
+ //!
+ //! If the DBMS is EUCLID/Design Manager, {aFolder}, {aName}
+ //! and {aVersion} have the form they have in
+ //! EUCLID/Design Manager. For example:
+ //!
+ //! Handle(CDM_Document) theDocument=myApplication->Retrieve("|user|cascade","box","2");
+ //! A link is kept with the database through an instance
+ //! of CDM_MetaData
+ Standard_EXPORT Handle(CDM_Document) Retrieve (const TCollection_ExtendedString& aFolder, const TCollection_ExtendedString& aName, const TCollection_ExtendedString& aVersion, const Standard_Boolean UseStorageConfiguration = Standard_True);
+
+ Standard_EXPORT PCDM_ReaderStatus CanRetrieve (const TCollection_ExtendedString& aFolder, const TCollection_ExtendedString& aName);
+
+ Standard_EXPORT PCDM_ReaderStatus CanRetrieve (const TCollection_ExtendedString& aFolder, const TCollection_ExtendedString& aName, const TCollection_ExtendedString& aVersion);
+
+ Standard_EXPORT virtual void Formats (TColStd_SequenceOfExtendedString& Formats) = 0;
+
+ //! Checks status after Retrieve
+ PCDM_ReaderStatus GetRetrieveStatus() const;
+
+ Standard_EXPORT Standard_Boolean FindReader (const TCollection_ExtendedString& aFileName);
+
+ Standard_EXPORT Handle(PCDM_Reader) Reader (const TCollection_ExtendedString& aFileName);
+
+ Standard_EXPORT Standard_Boolean FindReaderFromFormat (const TCollection_ExtendedString& aFormat);
+
+ Standard_EXPORT Handle(PCDM_Reader) ReaderFromFormat (const TCollection_ExtendedString& aFormat);
+
+ //! try to retrieve a Format directly in the file or in
+ //! application resource by using extension. returns
+ //! True if found;
+ Standard_EXPORT Standard_Boolean Format (const TCollection_ExtendedString& aFileName, TCollection_ExtendedString& theFormat);
+
+ Standard_EXPORT Standard_ExtString DefaultFolder();
+
+ Standard_EXPORT Standard_Boolean SetDefaultFolder (const Standard_ExtString aFolder);
+
+ Standard_EXPORT Standard_ExtString DefaultExtension();
+
+
+friend class CDF_Session;
+
+
+ DEFINE_STANDARD_RTTI(CDF_Application,CDM_Application)
+
+protected:
+
+
+ Standard_EXPORT CDF_Application();
+
+ PCDM_ReaderStatus myRetrievableStatus;
+
+
+private:
+
+
+ //! Informs the application that aDocument has been
+ //! activated. A document is activated when it is created or
+ //! retrieved.
+ //! aTypeOfActivation will be:
+ //! - CDF_TOA_New if the document is a new one
+ //! (even empty or retrieved from the database for
+ //! the first time).
+ //! - CDF_TOA_Unchanged if the document was already
+ //! retrieved but had no changes since the previous retrieval.
+ //! - CDF_TOA_Modified if the document was already
+ //! retrieved and modified since the previous retrieval.
+ //! You do not need to call <Activate>, but you should redefine
+ //! this method to implement application specific behavior.
+ Standard_EXPORT virtual void Activate (const Handle(CDM_Document)& aDocument, const CDF_TypeOfActivation aTypeOfActivation);
+
+ Standard_EXPORT Handle(CDM_Document) Retrieve (const Handle(CDM_MetaData)& aMetaData, const Standard_Boolean UseStorageConfiguration);
+
+ Standard_EXPORT Handle(CDM_Document) Retrieve (const Handle(CDM_MetaData)& aMetaData, const Standard_Boolean UseStorageConfiguration, const Standard_Boolean IsComponent);
+
+ Standard_EXPORT Standard_Integer DocumentVersion (const Handle(CDM_MetaData)& theMetaData);
+
+ Standard_EXPORT Standard_Boolean FindReader (const TCollection_ExtendedString& aFileName, Standard_GUID& PluginIn, TCollection_ExtendedString& ResourceName);
+
+ Standard_EXPORT Standard_Boolean FindReaderFromFormat (const TCollection_ExtendedString& aFormat, Standard_GUID& PluginIn, TCollection_ExtendedString& ResourceName);
+
+ Standard_EXPORT CDF_TypeOfActivation TypeOfActivation (const Handle(CDM_MetaData)& aMetaData);
+
+ Standard_EXPORT PCDM_ReaderStatus CanRetrieve (const Handle(CDM_MetaData)& aMetaData);
+
+ TCollection_ExtendedString myDefaultFolder;
+
+
+};
+
+
+#include <CDF_Application.lxx>
+
+
+
+
+
+#endif // _CDF_Application_HeaderFile