CDF_Application Class Referenceabstract

#include <CDF_Application.hxx>

Inheritance diagram for CDF_Application:

Public Member Functions
void	Open (const Handle< CDM_Document > &aDocument)
	puts the document in the current session directory and calls the virtual method Activate on it. More...
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; More...
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. 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: More...
Handle< CDM_Document >	Retrieve (const TCollection_ExtendedString &aFolder, const TCollection_ExtendedString &aName, const TCollection_ExtendedString &aVersion, 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. More...
PCDM_ReaderStatus	CanRetrieve (const TCollection_ExtendedString &aFolder, const TCollection_ExtendedString &aName)
PCDM_ReaderStatus	CanRetrieve (const TCollection_ExtendedString &aFolder, const TCollection_ExtendedString &aName, const TCollection_ExtendedString &aVersion)
virtual void	Formats (TColStd_SequenceOfExtendedString &Formats)=0
PCDM_ReaderStatus	GetRetrieveStatus () const
	Checks status after Retrieve. More...
Standard_Boolean	FindReader (const TCollection_ExtendedString &aFileName)
Handle< PCDM_Reader >	Reader (const TCollection_ExtendedString &aFileName)
Standard_Boolean	FindReaderFromFormat (const TCollection_ExtendedString &aFormat)
Handle< PCDM_Reader >	ReaderFromFormat (const TCollection_ExtendedString &aFormat)
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; More...
Standard_ExtString	DefaultFolder ()
Standard_Boolean	SetDefaultFolder (const Standard_ExtString aFolder)
Standard_ExtString	DefaultExtension ()
Public Member Functions inherited from CDM_Application
virtual Handle< Resource_Manager >	Resources ()=0
	the manager returned by this virtual method will be used to search for Format`.Retrieval resource items. More...
virtual Handle< CDM_MessageDriver >	MessageDriver ()
	By default returns a NullMessageDriver;. More...
virtual void	BeginOfUpdate (const Handle< CDM_Document > &aDocument)
	this method is called before the update of a document. By default, writes in MessageDriver(). More...
virtual void	EndOfUpdate (const Handle< CDM_Document > &aDocument, const Standard_Boolean Status, const TCollection_ExtendedString &ErrorString)
	this method is called affter the update of a document. By default, writes in MessageDriver(). More...
void	Write (const Standard_ExtString aString)
	writes the string in the application MessagerDriver. More...
Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor. More...
	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing. More...
Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter. More...
virtual	~Standard_Transient ()
	Destructor must be virtual. More...
virtual void	Delete () const
	Memory deallocator for transient classes. More...
virtual const Handle_Standard_Type &	DynamicType () const
	Returns a type information object about this object. More...
Standard_Boolean	IsInstance (const Handle_Standard_Type &theType) const
	Returns a true value if this is an instance of Type. More...
Standard_Boolean	IsInstance (const Standard_CString theTypeName) const
	Returns a true value if this is an instance of TypeName. More...
Standard_Boolean	IsKind (const 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. More...
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. More...
virtual Handle_Standard_Transient	This () const
	Returns a Handle which references this object. Must never be called to objects created in stack. More...
Standard_Integer	GetRefCount () const
	Get the reference counter of this object. More...

Static Public Member Functions
static Handle< CDF_Application >	Load (const Standard_GUID &aGUID)
	plugs an application. More...

Protected Member Functions
	CDF_Application ()
Protected Member Functions inherited from CDM_Application
void	SetDocumentVersion (const Handle< CDM_Document > &aDocument, const Handle< CDM_MetaData > &aMetaData) const
void	SetReferenceCounter (const Handle< CDM_Document > &aDocument, const Standard_Integer aReferenceCounter)

Protected Attributes
PCDM_ReaderStatus	myRetrievableStatus

Constructor & Destructor Documentation

CDF_Application::CDF_Application ( )

protected

Member Function Documentation

CDM_CanCloseStatus CDF_Application::CanClose

(

const Handle< CDM_Document > &

aDocument

)

PCDM_ReaderStatus CDF_Application::CanRetrieve	(	const TCollection_ExtendedString &	aFolder,
		const TCollection_ExtendedString &	aName
	)

PCDM_ReaderStatus CDF_Application::CanRetrieve	(	const TCollection_ExtendedString &	aFolder,
		const TCollection_ExtendedString &	aName,
		const TCollection_ExtendedString &	aVersion
	)

void CDF_Application::Close

(

const Handle< CDM_Document > &

aDocument

)

removes the document of the current session directory and closes the document;

Standard_ExtString CDF_Application::DefaultExtension

(

)

Standard_ExtString CDF_Application::DefaultFolder

(

)

Standard_Boolean CDF_Application::FindReader

(

const TCollection_ExtendedString &

aFileName

)

Standard_Boolean CDF_Application::FindReaderFromFormat

(

const TCollection_ExtendedString &

aFormat

)

Standard_Boolean CDF_Application::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;

virtual void CDF_Application::Formats ( TColStd_SequenceOfExtendedString &  Formats )

pure virtual

Implemented in TDocStd_Application, TObj_Application, AppStdL_Application, AppStd_Application, and XCAFApp_Application.

PCDM_ReaderStatus CDF_Application::GetRetrieveStatus

(

)

const

Checks status after Retrieve.

static Handle< CDF_Application > CDF_Application::Load ( const Standard_GUID &  aGUID )

static

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.

void CDF_Application::Open

(

const Handle< CDM_Document > &

aDocument

)

puts the document in the current session directory and calls the virtual method Activate on it.

Handle< PCDM_Reader > CDF_Application::Reader

(

const TCollection_ExtendedString &

aFileName

)

Handle< PCDM_Reader > CDF_Application::ReaderFromFormat

(

const TCollection_ExtendedString &

aFormat

)

Handle< CDM_Document > CDF_Application::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. 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

Handle< CDM_Document > CDF_Application::Retrieve	(	const TCollection_ExtendedString &	aFolder,
		const TCollection_ExtendedString &	aName,
		const TCollection_ExtendedString &	aVersion,
		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_Boolean CDF_Application::SetDefaultFolder

(

const Standard_ExtString

aFolder

)

Field Documentation

PCDM_ReaderStatus CDF_Application::myRetrievableStatus

protected

---

The documentation for this class was generated from the following file:

• CDF_Application.hxx