0032565: Foundation Classes, OSD_FileSystem - expose interface for registering global...

Added methods OSD_FileSystem::AddDefaultProtocol()/::RemoveDefaultProtocol()
and fixed misleading description of OSD_FileSystemSelector::AddProtocol().

diff --git a/src/OSD/OSD_FileSystem.cxx b/src/OSD/OSD_FileSystem.cxx
index 81fc4c2de1cafa3b208c2995cf79aeb2504b5e91..ccb0a25c4810cafd8b0ba12609a52d5bdebfcf15 100644 (file)
--- a/src/OSD/OSD_FileSystem.cxx
+++ b/src/OSD/OSD_FileSystem.cxx
@@ -54,6 +54,26 @@ const Handle(OSD_FileSystem)& OSD_FileSystem::DefaultFileSystem()
   return aDefSystem;
 }
 
+//=======================================================================
+// function : AddDefaultProtocol
+// purpose :
+//=======================================================================
+void OSD_FileSystem::AddDefaultProtocol (const Handle(OSD_FileSystem)& theFileSystem, bool theIsPreferred)
+{
+  Handle(OSD_FileSystemSelector) aFileSelector = Handle(OSD_FileSystemSelector)::DownCast (DefaultFileSystem());
+  aFileSelector->AddProtocol (theFileSystem, theIsPreferred);
+}
+
+//=======================================================================
+// function : RemoveDefaultProtocol
+// purpose :
+//=======================================================================
+void OSD_FileSystem::RemoveDefaultProtocol (const Handle(OSD_FileSystem)& theFileSystem)
+{
+  Handle(OSD_FileSystemSelector) aFileSelector = Handle(OSD_FileSystemSelector)::DownCast (DefaultFileSystem());
+  aFileSelector->RemoveProtocol (theFileSystem);
+}
+
 //=======================================================================
 // function : openIStream
 // purpose :

diff --git a/src/OSD/OSD_FileSystem.hxx b/src/OSD/OSD_FileSystem.hxx
index 19334f9068421cb75412729378a7c5d6a651704a..f741dc09a9f8eaf039eb7a076634854e3788257a 100644 (file)
--- a/src/OSD/OSD_FileSystem.hxx
+++ b/src/OSD/OSD_FileSystem.hxx
@@ -24,9 +24,18 @@ class OSD_FileSystem : public Standard_Transient
   DEFINE_STANDARD_RTTIEXT(OSD_FileSystem, Standard_Transient)
 public:
 
-  //! Returns a global file system, which a selector between registered file systems.
+  //! Returns a global file system, which a selector between registered file systems (OSD_FileSystemSelector).
   Standard_EXPORT static const Handle(OSD_FileSystem)& DefaultFileSystem();
 
+  //! Registers file system within the global file system selector returned by OSD_FileSystem::DefaultFileSystem().
+  //! Note that registering protocols is not thread-safe operation and expected to be done once at application startup.
+  //! @param[in] theFileSystem  file system to register
+  //! @param[in] theIsPreferred add to the beginning of the list when TRUE, or add to the end otherwise
+  Standard_EXPORT static void AddDefaultProtocol (const Handle(OSD_FileSystem)& theFileSystem, bool theIsPreferred = false);
+
+  //! Unregisters file system within the global file system selector returned by OSD_FileSystem::DefaultFileSystem().
+  Standard_EXPORT static void RemoveDefaultProtocol (const Handle(OSD_FileSystem)& theFileSystem);
+
 public:
 
   //! Returns TRUE if URL defines a supported protocol.

diff --git a/src/OSD/OSD_FileSystemSelector.hxx b/src/OSD/OSD_FileSystemSelector.hxx
index 60aa5e1fd685738b703f5755b14ef7349edf2c1d..89777f4175ed8d7fda29bfd9d23d7c337d47109a 100644 (file)
--- a/src/OSD/OSD_FileSystemSelector.hxx
+++ b/src/OSD/OSD_FileSystemSelector.hxx
@@ -27,12 +27,12 @@ public:
   //! Constructor.
   OSD_FileSystemSelector() {}
 
-  //! Registers file system within the global file system selector returned by OSD_FileSystem::DefaultFileSystem().
+  //! Registers file system within this selector.
   //! @param theFileSystem  [in] file system to register
   //! @param theIsPreferred [in] add to the beginning of the list when TRUE, or add to the end otherwise
   Standard_EXPORT void AddProtocol (const Handle(OSD_FileSystem)& theFileSystem, bool theIsPreferred = false);
 
-  //! Unregisters file system within the global file system selector returned by OSD_FileSystem::DefaultFileSystem().
+  //! Unregisters file system within this selector.
   Standard_EXPORT void RemoveProtocol (const Handle(OSD_FileSystem)& theFileSystem);
 
 public: