initial checkin - helper class for implementing module-functionality in SFX-less components

2 files changed, 724 insertions, 0 deletions

diff --git a/extensions/source/inc/componentmodule.cxx b/extensions/source/inc/componentmodule.cxx
new file mode 100644
index 000000000..4cd3a47b3
--- /dev/null
+++ b/extensions/source/inc/componentmodule.cxx
@@ -0,0 +1,390 @@
+/*************************************************************************
+ *
+ *  $RCSfile: componentmodule.cxx,v $
+ *
+ *  $Revision: 1.1 $
+ *
+ *  last change: $Author: fs $ $Date: 2001-02-12 07:06:08 $
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 by Sun Microsystems, Inc.
+ *  901 San Antonio Road, Palo Alto, CA 94303, USA
+ *
+ *  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.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ *  MA  02111-1307  USA
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc..
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+#ifndef _EXTENSIONS_COMPONENT_MODULE_HXX_
+#include "componentmodule.hxx"
+#endif
+
+#ifndef _TOOLS_RESMGR_HXX
+#include <tools/resmgr.hxx>
+#endif
+#ifndef _SOLAR_HRC
+#include <svtools/solar.hrc>
+#endif
+#ifndef _COMPHELPER_SEQUENCE_HXX_
+#include <comphelper/sequence.hxx>
+#endif
+#include <tools/debug.hxx>
+
+#define ENTER_MOD_METHOD()	\
+    ::osl::MutexGuard aGuard(s_aMutex);	\
+    ensureImpl()
+    
+//.........................................................................
+namespace COMPMOD_NAMESPACE
+{
+//.........................................................................
+
+    using namespace ::com::sun::star::uno;
+    using namespace ::com::sun::star::lang;
+    using namespace ::com::sun::star::registry;
+    using namespace ::comphelper;
+    using namespace ::cppu;
+
+    //=========================================================================
+    //= OModuleImpl
+    //=========================================================================
+    /** implementation for <type>OModule</type>. not threadsafe, has to be guarded by it's owner
+    */
+    class OModuleImpl
+    {
+        ResMgr*		m_pRessources;
+        sal_Bool	m_bInitialized;
+        ByteString	m_sFilePrefix;
+
+    public:
+        /// ctor
+        OModuleImpl();
+        ~OModuleImpl();
+
+        /// get the manager for the ressources of the module
+        ResMgr*	getResManager();
+        void	setResourceFilePrefix(const ::rtl::OString& _rPrefix) { m_sFilePrefix = _rPrefix; }
+    };
+
+    //-------------------------------------------------------------------------
+    OModuleImpl::OModuleImpl()
+        :m_pRessources(NULL)
+        ,m_bInitialized(sal_False)
+    {
+    }
+
+    //-------------------------------------------------------------------------
+    OModuleImpl::~OModuleImpl()
+    {
+        if (m_pRessources)
+            delete m_pRessources;
+    }
+
+    //-------------------------------------------------------------------------
+    ResMgr*	OModuleImpl::getResManager()
+    {
+        // note that this method is not threadsafe, which counts for the whole class !
+        if (!m_pRessources && !m_bInitialized)
+        {
+            DBG_ASSERT(m_sFilePrefix.Len(), "OModuleImpl::getResManager: no resource file prefix!");
+            // create a manager with a fixed prefix
+            ByteString aMgrName = m_sFilePrefix;
+            aMgrName += ByteString::CreateFromInt32(SOLARUPD); // current build number
+
+            m_pRessources = ResMgr::CreateResMgr(aMgrName.GetBuffer());
+            DBG_ASSERT(m_pRessources, 
+                    (ByteString("OModuleImpl::getResManager: could not create the resource manager (file name: ")
+                +=	aMgrName
+                +=	ByteString(")!")).GetBuffer());
+
+            m_bInitialized = sal_True;
+        }
+        return m_pRessources;
+    }
+
+    //=========================================================================
+    //= OModule
+    //=========================================================================
+    ::osl::Mutex	OModule::s_aMutex;
+    sal_Int32		OModule::s_nClients = 0;
+    OModuleImpl*	OModule::s_pImpl = NULL;
+    ::rtl::OString	OModule::s_sResPrefix;
+    //-------------------------------------------------------------------------
+    ResMgr*	OModule::getResManager()
+    {
+        ENTER_MOD_METHOD();
+        return s_pImpl->getResManager();
+    }
+
+    //-------------------------------------------------------------------------
+    void OModule::setResourceFilePrefix(const ::rtl::OString& _rPrefix)
+    {
+        ::osl::MutexGuard aGuard(s_aMutex);
+        s_sResPrefix = _rPrefix;
+        if (s_pImpl)
+            s_pImpl->setResourceFilePrefix(_rPrefix);
+    }
+
+    //-------------------------------------------------------------------------
+    void OModule::registerClient()
+    {
+        ::osl::MutexGuard aGuard(s_aMutex);
+        ++s_nClients;
+    }
+
+    //-------------------------------------------------------------------------
+    void OModule::revokeClient()
+    {
+        ::osl::MutexGuard aGuard(s_aMutex);
+        if (!--s_nClients && s_pImpl)
+        {
+            delete s_pImpl;
+            s_pImpl = NULL;
+        }
+    }
+
+    //-------------------------------------------------------------------------
+    void OModule::ensureImpl()
+    {
+        if (s_pImpl)
+            return;
+        s_pImpl = new OModuleImpl();
+        s_pImpl->setResourceFilePrefix(s_sResPrefix);
+    }
+
+    //--------------------------------------------------------------------------
+    //- registration helper
+    //--------------------------------------------------------------------------
+
+    Sequence< ::rtl::OUString >*				OModule::s_pImplementationNames = NULL;
+    Sequence< Sequence< ::rtl::OUString > >*	OModule::s_pSupportedServices = NULL;
+    Sequence< sal_Int64 >*						OModule::s_pCreationFunctionPointers = NULL;
+    Sequence< sal_Int64 >*						OModule::s_pFactoryFunctionPointers = NULL;
+
+    //--------------------------------------------------------------------------
+    void OModule::registerComponent(
+        const ::rtl::OUString& _rImplementationName,
+        const Sequence< ::rtl::OUString >& _rServiceNames,
+        ComponentInstantiation _pCreateFunction,
+        FactoryInstantiation _pFactoryFunction)
+    {
+        if (!s_pImplementationNames)
+        {
+            OSL_ENSHURE(!s_pSupportedServices && !s_pCreationFunctionPointers && !s_pFactoryFunctionPointers,
+                "OModule::registerComponent : inconsistent state (the pointers (1)) !");
+            s_pImplementationNames = new Sequence< ::rtl::OUString >;
+            s_pSupportedServices = new Sequence< Sequence< ::rtl::OUString > >;
+            s_pCreationFunctionPointers = new Sequence< sal_Int64 >;
+            s_pFactoryFunctionPointers = new Sequence< sal_Int64 >;
+        }
+        OSL_ENSHURE(s_pImplementationNames && s_pSupportedServices && s_pCreationFunctionPointers && s_pFactoryFunctionPointers,
+            "OModule::registerComponent : inconsistent state (the pointers (2)) !");
+
+        OSL_ENSHURE(	(s_pImplementationNames->getLength() == s_pSupportedServices->getLength())
+                    &&	(s_pImplementationNames->getLength() == s_pCreationFunctionPointers->getLength())
+                    &&	(s_pImplementationNames->getLength() == s_pFactoryFunctionPointers->getLength()),
+            "OModule::registerComponent : inconsistent state !");
+
+        sal_Int32 nOldLen = s_pImplementationNames->getLength();
+        s_pImplementationNames->realloc(nOldLen + 1);
+        s_pSupportedServices->realloc(nOldLen + 1);
+        s_pCreationFunctionPointers->realloc(nOldLen + 1);
+        s_pFactoryFunctionPointers->realloc(nOldLen + 1);
+
+        s_pImplementationNames->getArray()[nOldLen] = _rImplementationName;
+        s_pSupportedServices->getArray()[nOldLen] = _rServiceNames;
+        s_pCreationFunctionPointers->getArray()[nOldLen] = reinterpret_cast<sal_Int64>(_pCreateFunction);
+        s_pFactoryFunctionPointers->getArray()[nOldLen] = reinterpret_cast<sal_Int64>(_pFactoryFunction);
+    }
+
+    //--------------------------------------------------------------------------
+    void OModule::revokeComponent(const ::rtl::OUString& _rImplementationName)
+    {
+        if (!s_pImplementationNames)
+        {
+            OSL_ASSERT("OModule::revokeComponent : have no class infos ! Are you sure called this method at the right time ?");
+            return;
+        }
+        OSL_ENSHURE(s_pImplementationNames && s_pSupportedServices && s_pCreationFunctionPointers && s_pFactoryFunctionPointers,
+            "OModule::revokeComponent : inconsistent state (the pointers) !");
+        OSL_ENSHURE(	(s_pImplementationNames->getLength() == s_pSupportedServices->getLength())
+                    &&	(s_pImplementationNames->getLength() == s_pCreationFunctionPointers->getLength())
+                    &&	(s_pImplementationNames->getLength() == s_pFactoryFunctionPointers->getLength()),
+            "OModule::revokeComponent : inconsistent state !");
+
+        sal_Int32 nLen = s_pImplementationNames->getLength();
+        const ::rtl::OUString* pImplNames = s_pImplementationNames->getConstArray();
+        for (sal_Int32 i=0; i<nLen; ++i, ++pImplNames)
+        {
+            if (pImplNames->equals(_rImplementationName))
+            {
+                removeElementAt(*s_pImplementationNames, i);
+                removeElementAt(*s_pSupportedServices, i);
+                removeElementAt(*s_pCreationFunctionPointers, i);
+                removeElementAt(*s_pFactoryFunctionPointers, i);
+                break;
+            }
+        }
+
+        if (s_pImplementationNames->getLength() == 0)
+        {
+            delete s_pImplementationNames; s_pImplementationNames = NULL;
+            delete s_pSupportedServices; s_pSupportedServices = NULL;
+            delete s_pCreationFunctionPointers; s_pCreationFunctionPointers = NULL;
+            delete s_pFactoryFunctionPointers; s_pFactoryFunctionPointers = NULL;
+        }
+    }
+
+    //--------------------------------------------------------------------------
+    sal_Bool OModule::writeComponentInfos(
+            const Reference< XMultiServiceFactory >& /*_rxServiceManager*/,
+            const Reference< XRegistryKey >& _rxRootKey)
+    {
+        OSL_ENSHURE(_rxRootKey.is(), "OModule::writeComponentInfos : invalid argument !");
+
+        if (!s_pImplementationNames)
+        {
+            OSL_ASSERT("OModule::writeComponentInfos : have no class infos ! Are you sure called this method at the right time ?");
+            return sal_True;
+        }
+        OSL_ENSHURE(s_pImplementationNames && s_pSupportedServices && s_pCreationFunctionPointers && s_pFactoryFunctionPointers,
+            "OModule::writeComponentInfos : inconsistent state (the pointers) !");
+        OSL_ENSHURE(	(s_pImplementationNames->getLength() == s_pSupportedServices->getLength())
+                    &&	(s_pImplementationNames->getLength() == s_pCreationFunctionPointers->getLength())
+                    &&	(s_pImplementationNames->getLength() == s_pFactoryFunctionPointers->getLength()),
+            "OModule::writeComponentInfos : inconsistent state !");
+
+        sal_Int32 nLen = s_pImplementationNames->getLength();
+        const ::rtl::OUString* pImplName = s_pImplementationNames->getConstArray();
+        const Sequence< ::rtl::OUString >* pServices = s_pSupportedServices->getConstArray();
+
+        ::rtl::OUString sRootKey("/", 1, RTL_TEXTENCODING_ASCII_US);
+        for (sal_Int32 i=0; i<nLen; ++i, ++pImplName, ++pServices)
+        {
+            ::rtl::OUString aMainKeyName(sRootKey);
+            aMainKeyName += *pImplName;
+            aMainKeyName += ::rtl::OUString::createFromAscii("/UNO/SERVICES");
+
+            try
+            {
+                Reference< XRegistryKey >  xNewKey( _rxRootKey->createKey(aMainKeyName) );
+
+                const ::rtl::OUString* pService = pServices->getConstArray();
+                for (sal_Int32 j=0; j<pServices->getLength(); ++j, ++pService)
+                    xNewKey->createKey(*pService);
+            }
+            catch(Exception&)
+            {
+                OSL_ASSERT("OModule::writeComponentInfos : something went wrong while creating the keys !");
+                return sal_False;
+            }
+        }
+
+        return sal_True;
+    }
+
+    //--------------------------------------------------------------------------
+    Reference< XInterface > OModule::getComponentFactory(
+        const ::rtl::OUString& _rImplementationName,
+        const Reference< XMultiServiceFactory >& _rxServiceManager)
+    {
+        OSL_ENSHURE(_rxServiceManager.is(), "OModule::getComponentFactory : invalid argument (service manager) !");
+        OSL_ENSHURE(_rImplementationName.getLength(), "OModule::getComponentFactory : invalid argument (implementation name) !");
+
+        if (!s_pImplementationNames)
+        {
+            OSL_ASSERT("OModule::getComponentFactory : have no class infos ! Are you sure called this method at the right time ?");
+            return NULL;
+        }
+        OSL_ENSHURE(s_pImplementationNames && s_pSupportedServices && s_pCreationFunctionPointers && s_pFactoryFunctionPointers,
+            "OModule::getComponentFactory : inconsistent state (the pointers) !");
+        OSL_ENSHURE(	(s_pImplementationNames->getLength() == s_pSupportedServices->getLength())
+                    &&	(s_pImplementationNames->getLength() == s_pCreationFunctionPointers->getLength())
+                    &&	(s_pImplementationNames->getLength() == s_pFactoryFunctionPointers->getLength()),
+            "OModule::getComponentFactory : inconsistent state !");
+
+
+        Reference< XInterface > xReturn;
+
+
+        sal_Int32 nLen = s_pImplementationNames->getLength();
+        const ::rtl::OUString* pImplName = s_pImplementationNames->getConstArray();
+        const Sequence< ::rtl::OUString >* pServices = s_pSupportedServices->getConstArray();
+        const sal_Int64* pComponentFunction = s_pCreationFunctionPointers->getConstArray();
+        const sal_Int64* pFactoryFunction = s_pFactoryFunctionPointers->getConstArray();
+
+        for (sal_Int32 i=0; i<nLen; ++i, ++pImplName, ++pServices, ++pComponentFunction, ++pFactoryFunction)
+        {
+            if (pImplName->equals(_rImplementationName))
+            {
+                const FactoryInstantiation FactoryInstantiationFunction = reinterpret_cast<const FactoryInstantiation>(*pFactoryFunction);
+                const ComponentInstantiation ComponentInstantiationFunction = reinterpret_cast<const ComponentInstantiation>(*pComponentFunction);
+
+                xReturn = FactoryInstantiationFunction( _rxServiceManager, *pImplName, ComponentInstantiationFunction, *pServices);
+                if (xReturn.is())
+                {
+                    xReturn->acquire();
+                    return xReturn.get();
+                }
+            }
+        }
+
+        return NULL;
+    }
+
+
+//.........................................................................
+}	// namespace COMPMOD_NAMESPACE
+//.........................................................................
+
+/*************************************************************************
+ * history:
+ *	$Log: not supported by cvs2svn $
+ *
+ *	Revision 1.0 30.01.01 15:18:48  fs
+ ************************************************************************/
+
diff --git a/extensions/source/inc/componentmodule.hxx b/extensions/source/inc/componentmodule.hxx
new file mode 100644
index 000000000..a73df4763
--- /dev/null
+++ b/extensions/source/inc/componentmodule.hxx
@@ -0,0 +1,334 @@
+/*************************************************************************
+ *
+ *  $RCSfile: componentmodule.hxx,v $
+ *
+ *  $Revision: 1.1 $
+ *
+ *  last change: $Author: fs $ $Date: 2001-02-12 07:06:08 $
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 by Sun Microsystems, Inc.
+ *  901 San Antonio Road, Palo Alto, CA 94303, USA
+ *
+ *  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.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ *  MA  02111-1307  USA
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc..
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+#ifndef _EXTENSIONS_COMPONENT_MODULE_HXX_
+#define _EXTENSIONS_COMPONENT_MODULE_HXX_
+
+/** you may find this file helpfull if you implement a component (in it's own library) which can't use
+    the usual infrastructure.<br/>
+    More precise, you find helper classes to ease the use of resources and the registration of services.
+    <p>
+    You need to define a preprocessor variable COMPMOD_NAMESPACE in order to use this file. Set it to a string
+    which should be used as namespace for the classes defined herein.</p>
+*/
+
+#ifndef _OSL_MUTEX_HXX_
+#include <osl/mutex.hxx>
+#endif
+#ifndef _TOOLS_RESID_HXX
+#include <tools/resid.hxx>
+#endif
+#ifndef _COM_SUN_STAR_LANG_XMULTISERVICEFACTORY_HPP_
+#include <com/sun/star/lang/XMultiServiceFactory.hpp>
+#endif
+#ifndef _COM_SUN_STAR_LANG_XSINGLESERVICEFACTORY_HPP_
+#include <com/sun/star/lang/XSingleServiceFactory.hpp>
+#endif
+#ifndef _COM_SUN_STAR_UNO_SEQUENCE_HXX_
+#include <com/sun/star/uno/Sequence.hxx>
+#endif
+#ifndef _COM_SUN_STAR_REGISTRY_XREGISTRYKEY_HPP_
+#include <com/sun/star/registry/XRegistryKey.hpp>
+#endif
+#ifndef _CPPUHELPER_FACTORY_HXX_ 
+#include <cppuhelper/factory.hxx>
+#endif
+#ifndef _RTL_STRING_HXX_
+#include <rtl/string.hxx>
+#endif
+
+class ResMgr;
+
+//.........................................................................
+namespace COMPMOD_NAMESPACE
+{
+//.........................................................................
+
+typedef ::com::sun::star::uno::Reference< ::com::sun::star::lang::XSingleServiceFactory > (SAL_CALL *FactoryInstantiation)
+        (
+            const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >& _rServiceManager,
+            const ::rtl::OUString & _rComponentName,
+            ::cppu::ComponentInstantiation _pCreateFunction,
+            const ::com::sun::star::uno::Sequence< ::rtl::OUString > & _rServiceNames
+        );
+
+    //=========================================================================
+    //= OModule
+    //=========================================================================
+    class OModuleImpl;
+    class OModule
+    {
+        friend class OModuleResourceClient;
+
+    private:
+        OModule();
+            // not implemented. OModule is a static class
+
+    protected:
+        // resource administration
+        static ::osl::Mutex		s_aMutex;		/// access safety
+        static sal_Int32		s_nClients;		/// number of registered clients
+        static OModuleImpl*		s_pImpl;		/// impl class. lives as long as at least one client for the module is registered
+        static ::rtl::OString	s_sResPrefix;
+
+        // auto registration administration
+        static	::com::sun::star::uno::Sequence< ::rtl::OUString >*
+            s_pImplementationNames;
+        static	::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::rtl::OUString > >*
+            s_pSupportedServices;
+        static	::com::sun::star::uno::Sequence< sal_Int64 >*
+            s_pCreationFunctionPointers;
+        static	::com::sun::star::uno::Sequence< sal_Int64 >*
+            s_pFactoryFunctionPointers;
+
+    public:
+        // cna be set as long as no resource has been accessed ...
+        static void		setResourceFilePrefix(const ::rtl::OString& _rPrefix);
+
+        /// get the vcl res manager of the module
+        static ResMgr*	getResManager();
+
+        /** register a component implementing a service with the given data.
+            @param	_rImplementationName
+                        the implementation name of the component
+            @param	_rServiceNames
+                        the services the component supports
+            @param	_pCreateFunction
+                        a function for creating an instance of the component
+            @param	_pFactoryFunction
+                        a function for creating a factory for that component
+            @see revokeComponent
+        */
+        static void registerComponent(
+            const ::rtl::OUString& _rImplementationName,
+            const ::com::sun::star::uno::Sequence< ::rtl::OUString >& _rServiceNames,
+            ::cppu::ComponentInstantiation _pCreateFunction,
+            FactoryInstantiation _pFactoryFunction);
+
+        /** revoke the registration for the specified component
+            @param	_rImplementationName
+                the implementation name of the component
+        */
+        static void revokeComponent(
+            const ::rtl::OUString& _rImplementationName);
+
+        /** write the registration information of all known components
+            <p>writes the registration information of all components which are currently registered into the
+            specified registry.<p/>
+            <p>Usually used from within component_writeInfo.<p/>
+            @param	_rxServiceManager
+                        the service manager
+            @param	_rRootKey
+                        the registry key under which the information will be stored
+            @return
+                        sal_True if the registration of all implementations was successfull, sal_False otherwise
+        */
+        static sal_Bool writeComponentInfos(
+            const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >& _rxServiceManager,
+            const ::com::sun::star::uno::Reference< ::com::sun::star::registry::XRegistryKey >& _rRootKey);
+
+        /** creates a Factory for the component with the given implementation name.
+            <p>Usually used from within component_getFactory.<p/>
+            @param	_rxServiceManager
+                        a pointer to an XMultiServiceFactory interface as got in component_getFactory
+            @param	_pImplementationName
+                        the implementation name of the component
+            @return
+                        the XInterface access to a factory for the component
+        */
+        static ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > getComponentFactory(
+            const ::rtl::OUString& _rImplementationName,
+            const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >& _rxServiceManager
+            );
+
+    protected:
+        /// register a client for the module
+        static void	registerClient();
+        /// revoke a client for the module
+        static void	revokeClient();
+
+    private:
+        /** ensure that the impl class exists
+            @precond m_aMutex is guarded when this method gets called
+        */
+        static void ensureImpl();
+    };
+
+    //=========================================================================
+    //= OModuleResourceClient
+    //=========================================================================
+    /** base class for objects which uses any global module-specific ressources 
+    */
+    class OModuleResourceClient
+    {
+    public:
+        OModuleResourceClient()		{ OModule::registerClient(); }
+        ~OModuleResourceClient()	{ OModule::revokeClient(); }
+    };
+
+    //=========================================================================
+    //= ModuleRes
+    //=========================================================================
+    /** specialized ResId, using the ressource manager provided by the global module
+    */
+    class ModuleRes : public ::ResId
+    {
+    public:
+        ModuleRes(USHORT _nId) : ResId(_nId, OModule::getResManager()) { }
+    };
+
+    //==========================================================================
+    //= OMultiInstanceAutoRegistration
+    //==========================================================================
+    template <class TYPE>
+    class OMultiInstanceAutoRegistration
+    {
+    public:
+        /** automatically registeres a multi instance component
+            <p>Assumed that the template argument has the three methods
+                <ul>
+                    <li><code>static ::rtl::OUString getImplementationName_Static()</code><li/>
+                    <li><code>static ::com::sun::star::uno::Sequence< ::rtl::OUString > getSupportedServiceNames_Static()</code><li/>
+                    <li><code>static ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >
+                        Create(const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >&)</code>
+                        </li>
+                <ul/>
+            the instantiation of this object will automatically register the class via <method>OModule::registerComponent</method>.
+            <p/>
+            The factory creation function used is <code>::cppu::createSingleFactory</code>.
+            @see OOneInstanceAutoRegistration
+        */
+        OMultiInstanceAutoRegistration();
+        ~OMultiInstanceAutoRegistration();
+    };
+
+    template <class TYPE>
+    OMultiInstanceAutoRegistration<TYPE>::OMultiInstanceAutoRegistration()
+    {
+        OModule::registerComponent(
+            TYPE::getImplementationName_Static(),
+            TYPE::getSupportedServiceNames_Static(),
+            TYPE::Create,
+            ::cppu::createSingleFactory
+            );
+    }
+
+    template <class TYPE>
+    OMultiInstanceAutoRegistration<TYPE>::~OMultiInstanceAutoRegistration()
+    {
+        OModule::revokeComponent(TYPE::getImplementationName_Static());
+    }
+
+    //==========================================================================
+    //= OOneInstanceAutoRegistration
+    //==========================================================================
+    template <class TYPE>
+    class OOneInstanceAutoRegistration
+    {
+    public:
+        /** automatically registeres a single instance component
+            <p>Assumed that the template argument has the three methods
+                <ul>
+                    <li><code>static ::rtl::OUString getImplementationName_Static()</code><li/>
+                    <li><code>static ::com::sun::star::uno::Sequence< ::rtl::OUString > getSupportedServiceNames_Static()</code><li/>
+                    <li><code>static ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >
+                        Create(const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >&)</code>
+                        </li>
+                <ul/>
+            the instantiation of this object will automatically register the class via <method>OModule::registerComponent</method>.
+            <p/>
+            The factory creation function used is <code>::cppu::createOneInstanceFactory</code>.
+            @see OOneInstanceAutoRegistration
+        */
+        OOneInstanceAutoRegistration();
+        ~OOneInstanceAutoRegistration();
+    };
+
+    template <class TYPE>
+    OOneInstanceAutoRegistration<TYPE>::OOneInstanceAutoRegistration()
+    {
+        OModule::registerComponent(
+            TYPE::getImplementationName_Static(),
+            TYPE::getSupportedServiceNames_Static(),
+            TYPE::Create,
+            ::cppu::createOneInstanceFactory
+            );
+    }
+
+    template <class TYPE>
+    OOneInstanceAutoRegistration<TYPE>::~OOneInstanceAutoRegistration()
+    {
+        OModule::revokeComponent(TYPE::getImplementationName_Static());
+    }
+
+//.........................................................................
+}	// namespace COMPMOD_NAMESPACE
+//.........................................................................
+
+#endif // _EXTENSIONS_COMPONENT_MODULE_HXX_
+
+/*************************************************************************
+ * history:
+ *	$Log: not supported by cvs2svn $
+ *
+ *	Revision 1.0 30.01.01 15:07:32  fs
+ ************************************************************************/
+