|
| TDocStd_Application () |
| Constructs the new instance and registers it in CDM_Session.
|
|
Standard_Boolean | IsDriverLoaded () const |
| Check if meta data driver was successfully loaded by the application constructor.
|
|
virtual Handle< Resource_Manager > | Resources () override |
| Returns resource manager defining supported persistent formats.
|
|
virtual Standard_CString | ResourcesName () |
| Returns the name of the file containing the resources of this application, for support of legacy method of loading formats data from resource files.
|
|
void | DefineFormat (const TCollection_AsciiString &theFormat, const TCollection_AsciiString &theDescription, const TCollection_AsciiString &theExtension, const Handle< PCDM_RetrievalDriver > &theReader, const Handle< PCDM_StorageDriver > &theWriter) |
| Sets up resources and registers read and storage drivers for the specified format.
|
|
void | ReadingFormats (TColStd_SequenceOfAsciiString &theFormats) |
| Returns the sequence of reading formats supported by the application.
|
|
void | WritingFormats (TColStd_SequenceOfAsciiString &theFormats) |
| Returns the sequence of writing formats supported by the application.
|
|
Standard_Integer | NbDocuments () const |
| returns the number of documents handled by the current applicative session.
|
|
void | GetDocument (const Standard_Integer index, Handle< TDocStd_Document > &aDoc) const |
| Constructs the new document aDoc. aDoc is identified by the index index which is any integer between 1 and n where n is the number of documents returned by NbDocument. Example Handle(TDocStd_Application) anApp; if (!CafTest::Find(A)) return 1; Handle(TDocStd) aDoc; Standard_Integer nbdoc = anApp->NbDocuments(); for (Standard_Integer i = 1; i <= nbdoc; i++) { aApp->GetDocument(i,aDoc);.
|
|
virtual void | NewDocument (const TCollection_ExtendedString &format, Handle< CDM_Document > &aDoc) override |
| Constructs the empty new document aDoc. This document will have the format format. If InitDocument is redefined for a specific application, the new document is handled by the applicative session.
|
|
void | NewDocument (const TCollection_ExtendedString &format, Handle< TDocStd_Document > &aDoc) |
| A non-virtual method taking a TDocStd_Documment object as an input. Internally it calls a virtual method NewDocument() with CDM_Document object.
|
|
virtual void | InitDocument (const Handle< CDM_Document > &aDoc) const override |
| Initialize the document aDoc for the applicative session. This virtual function is called by NewDocument and is to be redefined for each specific application.
|
|
void | Close (const Handle< TDocStd_Document > &aDoc) |
| Close the given document. the document is not any more handled by the applicative session.
|
|
Standard_Integer | IsInSession (const TCollection_ExtendedString &path) const |
| Returns an index for the document found in the path path in this applicative session. If the returned value is 0, the document is not present in the applicative session. This method can be used for the interactive part of an application. For instance, on a call to Open, the document to be opened may already be in memory. IsInSession checks to see if this is the case. Open can be made to depend on the value of the index returned: if IsInSession returns 0, the document is opened; if it returns another value, a message is displayed asking the user if he wants to override the version of the document in memory. Example: Standard_Integer insession = A->IsInSession(aDoc); if (insession > 0) { std::cout << "document " << insession << " is already in session" << std::endl; return 0; }.
|
|
PCDM_ReaderStatus | Open (const TCollection_ExtendedString &thePath, Handle< TDocStd_Document > &theDoc, const Handle< PCDM_ReaderFilter > &theFilter, const Message_ProgressRange &theRange=Message_ProgressRange()) |
| Retrieves the document from specified file. In order not to override a version of the document which is already in memory, this method can be made to depend on the value returned by IsInSession.
|
|
PCDM_ReaderStatus | Open (const TCollection_ExtendedString &thePath, Handle< TDocStd_Document > &theDoc, const Message_ProgressRange &theRange=Message_ProgressRange()) |
| Retrieves the document from specified file. In order not to override a version of the document which is already in memory, this method can be made to depend on the value returned by IsInSession.
|
|
PCDM_ReaderStatus | Open (Standard_IStream &theIStream, Handle< TDocStd_Document > &theDoc, const Handle< PCDM_ReaderFilter > &theFilter, const Message_ProgressRange &theRange=Message_ProgressRange()) |
| Retrieves document from standard stream.
|
|
PCDM_ReaderStatus | Open (Standard_IStream &theIStream, Handle< TDocStd_Document > &theDoc, const Message_ProgressRange &theRange=Message_ProgressRange()) |
| Retrieves document from standard stream.
|
|
PCDM_StoreStatus | SaveAs (const Handle< TDocStd_Document > &theDoc, const TCollection_ExtendedString &path, const Message_ProgressRange &theRange=Message_ProgressRange()) |
| Save the active document in the file <name> in the path <path> ; o verwrites the file if it already exists.
|
|
PCDM_StoreStatus | SaveAs (const Handle< TDocStd_Document > &theDoc, Standard_OStream &theOStream, const Message_ProgressRange &theRange=Message_ProgressRange()) |
| Save theDoc to standard SEEKABLE stream theOStream. the stream should support SEEK functionality.
|
|
PCDM_StoreStatus | Save (const Handle< TDocStd_Document > &theDoc, const Message_ProgressRange &theRange=Message_ProgressRange()) |
| Save aDoc active document. Exceptions: Standard_NotImplemented if the document was not retrieved in the applicative session by using Open.
|
|
PCDM_StoreStatus | SaveAs (const Handle< TDocStd_Document > &theDoc, const TCollection_ExtendedString &path, TCollection_ExtendedString &theStatusMessage, const Message_ProgressRange &theRange=Message_ProgressRange()) |
| Save the active document in the file <name> in the path <path> . overwrite the file if it already exist.
|
|
PCDM_StoreStatus | SaveAs (const Handle< TDocStd_Document > &theDoc, Standard_OStream &theOStream, TCollection_ExtendedString &theStatusMessage, const Message_ProgressRange &theRange=Message_ProgressRange()) |
| Save theDoc TO standard SEEKABLE stream theOStream. the stream should support SEEK functionality.
|
|
PCDM_StoreStatus | Save (const Handle< TDocStd_Document > &theDoc, TCollection_ExtendedString &theStatusMessage, const Message_ProgressRange &theRange=Message_ProgressRange()) |
| Save the document overwriting the previous file.
|
|
virtual void | OnOpenTransaction (const Handle< TDocStd_Document > &theDoc) |
| Notification that is fired at each OpenTransaction event.
|
|
virtual void | OnCommitTransaction (const Handle< TDocStd_Document > &theDoc) |
| Notification that is fired at each CommitTransaction event.
|
|
virtual void | OnAbortTransaction (const Handle< TDocStd_Document > &theDoc) |
| Notification that is fired at each AbortTransaction event.
|
|
void | DumpJson (Standard_OStream &theOStream, Standard_Integer theDepth=-1) const |
| Dumps the content of me into the stream.
|
|
void | Open (const Handle< CDM_Document > &aDocument) |
| puts the document in the current session directory and calls the virtual method Activate on it.
|
|
CDM_CanCloseStatus | CanClose (const Handle< CDM_Document > &aDocument) |
|
void | Close (const Handle< CDM_Document > &aDocument) |
| removes the document of the current session directory and closes the document;
|
|
Handle< CDM_Document > | Retrieve (const TCollection_ExtendedString &aFolder, const TCollection_ExtendedString &aName, const Standard_Boolean UseStorageConfiguration=Standard_True, const Handle< PCDM_ReaderFilter > &theFilter=Handle< PCDM_ReaderFilter >(), const Message_ProgressRange &theRange=Message_ProgressRange()) |
| 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 > | Retrieve (const TCollection_ExtendedString &aFolder, const TCollection_ExtendedString &aName, const TCollection_ExtendedString &aVersion, const Standard_Boolean UseStorageConfiguration=Standard_True, const Handle< PCDM_ReaderFilter > &theFilter=Handle< PCDM_ReaderFilter >(), const Message_ProgressRange &theRange=Message_ProgressRange()) |
| 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.
|
|
PCDM_ReaderStatus | CanRetrieve (const TCollection_ExtendedString &theFolder, const TCollection_ExtendedString &theName, const bool theAppendMode) |
|
PCDM_ReaderStatus | CanRetrieve (const TCollection_ExtendedString &theFolder, const TCollection_ExtendedString &theName, const TCollection_ExtendedString &theVersion, const bool theAppendMode) |
|
PCDM_ReaderStatus | GetRetrieveStatus () const |
| Checks status after Retrieve.
|
|
void | Read (Standard_IStream &theIStream, Handle< CDM_Document > &theDocument, const Handle< PCDM_ReaderFilter > &theFilter=Handle< PCDM_ReaderFilter >(), const Message_ProgressRange &theRange=Message_ProgressRange()) |
| Reads theDocument from standard SEEKABLE stream theIStream, the stream should support SEEK functionality.
|
|
virtual Handle< PCDM_Reader > | ReaderFromFormat (const TCollection_ExtendedString &aFormat) |
| Returns instance of read driver for specified format.
|
|
virtual Handle< PCDM_StorageDriver > | WriterFromFormat (const TCollection_ExtendedString &aFormat) |
| Returns instance of storage driver for specified format.
|
|
Standard_Boolean | Format (const TCollection_ExtendedString &aFileName, TCollection_ExtendedString &theFormat) |
| try to retrieve a Format directly in the file or in application resource by using extension. returns True if found;
|
|
Standard_ExtString | DefaultFolder () |
|
Standard_Boolean | SetDefaultFolder (const Standard_ExtString aFolder) |
|
Handle< CDF_MetaDataDriver > | MetaDataDriver () const |
| returns MetaDatdDriver of this application
|
|
virtual Handle< Message_Messenger > | MessageDriver () |
| Returns default messenger;.
|
|
virtual void | BeginOfUpdate (const Handle< CDM_Document > &aDocument) |
| this method is called before the update of a document. By default, writes in MessageDriver().
|
|
virtual void | EndOfUpdate (const Handle< CDM_Document > &aDocument, const Standard_Boolean theStatus, const TCollection_ExtendedString &ErrorString) |
| this method is called affter the update of a document. By default, writes in MessageDriver().
|
|
void | Write (const Standard_ExtString aString) |
| writes the string in the application MessagerDriver.
|
|
virtual TCollection_ExtendedString | Name () const |
| Returns the application name.
|
|
virtual TCollection_AsciiString | Version () const |
| Returns the application version.
|
|
virtual CDM_MetaDataLookUpTable & | MetaDataLookUpTable () |
| Returns MetaData LookUpTable.
|
|
void | DumpJson (Standard_OStream &theOStream, Standard_Integer theDepth=-1) const |
| Dumps the content of me into the stream.
|
|
Public Member Functions inherited from Standard_Transient |
| Standard_Transient () |
| Empty constructor.
|
|
| Standard_Transient (const Standard_Transient &) |
| Copy constructor – does nothing.
|
|
Standard_Transient & | operator= (const Standard_Transient &) |
| Assignment operator, needed to avoid copying reference counter.
|
|
virtual | ~Standard_Transient () |
| Destructor must be virtual.
|
|
virtual const opencascade::handle< Standard_Type > & | DynamicType () const |
| Returns a type descriptor about this object.
|
|
Standard_Boolean | IsInstance (const opencascade::handle< Standard_Type > &theType) const |
| Returns a true value if this is an instance of Type.
|
|
Standard_Boolean | IsInstance (const Standard_CString theTypeName) const |
| Returns a true value if this is an instance of TypeName.
|
|
Standard_Boolean | IsKind (const opencascade::handle< Standard_Type > &theType) const |
| Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism.
|
|
Standard_Boolean | IsKind (const Standard_CString theTypeName) const |
| Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism.
|
|
Standard_Transient * | This () const |
| Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero.
|
|
Standard_Integer | GetRefCount () const noexcept |
| Get the reference counter of this object.
|
|
void | IncrementRefCounter () noexcept |
| Increments the reference counter of this object.
|
|
Standard_Integer | DecrementRefCounter () noexcept |
| Decrements the reference counter of this object; returns the decremented value.
|
|
virtual void | Delete () const |
| Memory deallocator for transient classes.
|
|
The abstract root class for all application classes. They are in charge of:
- Creating documents
- Storing documents and retrieving them
- Initializing document views. To create a useful OCAF-based application, you derive a class from Application and implement the methods below. You will have to redefine the deferred (virtual) methods Formats, InitDocument, and Resources, and override others. The application is a container for a document, which in its turn is the container of the data framework made up of labels and attributes. Besides furnishing a container for documents, TDocStd_Application provides the following services for them:
- Creation of new documents
- Activation of documents in sessions of an application
- Storage and retrieval of documents
- Initialization of document views. Note: If a client needs detailed information concerning the events during the Open/Store operation, a MessageDriver based on Message_PrinterOStream may be used. In case of need client can implement his own version inheriting from Message_Printer class and add it to the Messenger. Also the trace level of messages can be tuned by setting trace level (SetTraceLevel (Gravity )) for the used Printer. By default, trace level is Message_Info, so that all messages are output.