summaryrefslogtreecommitdiff
path: root/include/cppunit/plugin/PlugInManager.h
diff options
context:
space:
mode:
Diffstat (limited to 'include/cppunit/plugin/PlugInManager.h')
-rw-r--r--include/cppunit/plugin/PlugInManager.h101
1 files changed, 101 insertions, 0 deletions
diff --git a/include/cppunit/plugin/PlugInManager.h b/include/cppunit/plugin/PlugInManager.h
new file mode 100644
index 0000000..d3bbc5f
--- /dev/null
+++ b/include/cppunit/plugin/PlugInManager.h
@@ -0,0 +1,101 @@
+#ifndef CPPUNIT_PLUGIN_PLUGINMANAGER_H
+#define CPPUNIT_PLUGIN_PLUGINMANAGER_H
+
+#include <cppunit/Portability.h>
+
+#if !defined(CPPUNIT_NO_TESTPLUGIN)
+
+#if CPPUNIT_NEED_DLL_DECL
+#pragma warning( push )
+#pragma warning( disable: 4251 ) // X needs to have dll-interface to be used by clients of class Z
+#endif
+
+#include <cppunit/plugin/Parameters.h>
+struct CppUnitTestPlugIn;
+
+namespace CppUnit
+{
+
+class DynamicLibraryManager;
+class TestResult;
+
+
+/*! \brief Manges TestPlugIn.
+ */
+class CPPUNIT_API PlugInManager
+{
+public:
+ /*! Constructs a PlugInManager object.
+ */
+ PlugInManager();
+
+ /// Destructor.
+ virtual ~PlugInManager();
+
+ /*! Loads the specified plug-in.
+ *
+ * After being loaded, the CppUnitTestPlugIn::initialize() is called.
+ *
+ * \param libraryFileName Name of the file that contains the TestPlugIn.
+ * \param parameters List of string passed to the plug-in.
+ * \return Pointer on the DynamicLibraryManager associated to the library.
+ * Valid until the library is unloaded. Never \c NULL.
+ * \exception DynamicLibraryManager is thrown if an error occurs during loading.
+ */
+ void load( const std::string &libraryFileName,
+ const Parameters &parameters = Parameters() );
+
+ /*! Unloads the specified plug-in.
+ * \param libraryFileName Name of the file that contains the TestPlugIn passed
+ * to a previous call to load().
+ */
+ void unload( const std::string &libraryFileName );
+
+ /*! Gives a chance to each loaded plug-in to register TestListener.
+ *
+ * For each plug-in, call CppUnitTestPlugIn::addListener().
+ */
+ void addListener( TestResult *eventManager );
+
+ /*! Gives a chance to each loaded plug-in to unregister TestListener.
+ * For each plug-in, call CppUnitTestPlugIn::removeListener().
+ */
+ void removeListener( TestResult *eventManager );
+
+protected:
+ struct PlugInInfo
+ {
+ std::string m_fileName;
+ DynamicLibraryManager *m_manager;
+ CppUnitTestPlugIn *m_interface;
+ };
+
+ /*! Unloads the specified plug-in.
+ * \param plugIn Information about the plug-in.
+ */
+ void unload( PlugInInfo &plugIn );
+
+private:
+ /// Prevents the use of the copy constructor.
+ PlugInManager( const PlugInManager &copy );
+
+ /// Prevents the use of the copy operator.
+ void operator =( const PlugInManager &copy );
+
+private:
+ typedef std::deque<PlugInInfo> PlugIns;
+ PlugIns m_plugIns;
+};
+
+
+} // namespace CppUnit
+
+
+#if CPPUNIT_NEED_DLL_DECL
+#pragma warning( pop )
+#endif
+
+#endif // !defined(CPPUNIT_NO_TESTPLUGIN)
+
+
+#endif // CPPUNIT_PLUGIN_PLUGINMANAGER_H