diff options
Diffstat (limited to 'framework/inc/classes/propertysethelper.hxx')
-rw-r--r-- | framework/inc/classes/propertysethelper.hxx | 260 |
1 files changed, 260 insertions, 0 deletions
diff --git a/framework/inc/classes/propertysethelper.hxx b/framework/inc/classes/propertysethelper.hxx new file mode 100644 index 000000000000..d6b24561da51 --- /dev/null +++ b/framework/inc/classes/propertysethelper.hxx @@ -0,0 +1,260 @@ +/************************************************************************* + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2008 by Sun Microsystems, Inc. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * $RCSfile: propertysethelper.hxx,v $ + * $Revision: 1.7 $ + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org 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 version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************/ + +#ifndef __FRAMEWORK_CLASSES_PROPERTYSETHELPER_HXX_ +#define __FRAMEWORK_CLASSES_PROPERTYSETHELPER_HXX_ + +//_________________________________________________________________________________________________________________ +// my own includes + +#include <threadhelp/threadhelpbase.hxx> +#include <threadhelp/transactionbase.hxx> +#include <macros/debug.hxx> +#include <general.h> +#include <stdtypes.h> + +//_________________________________________________________________________________________________________________ +// interface includes +#include <com/sun/star/lang/XMultiServiceFactory.hpp> +#include <com/sun/star/beans/XPropertySet.hpp> +#include <com/sun/star/beans/XPropertySetInfo.hpp> +#include <com/sun/star/beans/PropertyExistException.hpp> +#include <com/sun/star/beans/UnknownPropertyException.hpp> + +//_________________________________________________________________________________________________________________ +// other includes + +#include <cppuhelper/weakref.hxx> + +//_________________________________________________________________________________________________________________ +// namespace + +namespace framework{ + +//_________________________________________________________________________________________________________________ + +/** supports the API XPropertySet and XPropertySetInfo. + * + * It must be used as baseclass. The internal list of supported + * properties can be changed everytimes so dynamic property set's + * can be implemented. + * + * Further the derived and this base class share the same lock. + * So it's possible to be threadsafe if it's needed. +*/ +class PropertySetHelper : public css::beans::XPropertySet + , public css::beans::XPropertySetInfo +{ + //------------------------------------------------------------------------- + /* types */ + protected: + + typedef BaseHash< css::beans::Property > TPropInfoHash; + + //------------------------------------------------------------------------- + /* member */ + protected: + + css::uno::Reference< css::lang::XMultiServiceFactory > m_xSMGR; + + PropertySetHelper::TPropInfoHash m_lProps; + + ListenerHash m_lSimpleChangeListener; + ListenerHash m_lVetoChangeListener; + + sal_Bool m_bReleaseLockOnCall; + + // hold it weak ... otherwhise this helper has to be "killed" explicitly .-) + css::uno::WeakReference< css::uno::XInterface > m_xBroadcaster; + + LockHelper& m_rLock; + TransactionManager& m_rTransactionManager; + + //------------------------------------------------------------------------- + /* native interface */ + public: + + //--------------------------------------------------------------------- + /** initialize new instance of this helper. + * + * @param xSMGR + * points to an uno service manager, which is used internaly to create own + * needed uno services. + * + * @param pExternalLock + * this helper must be used as a baseclass ... + * but then it should synchronize its own calls + * with the same lock then it's superclass uses. + * + * @param pExternalTransactionManager + * this helper must be used as a baseclass ... + * but then it should synchronize its own calls + * with the same transaction manager then it's superclass. + * + * @param bReleaseLockOnCall + * see member m_bReleaseLockOnCall + */ + PropertySetHelper(const css::uno::Reference< css::lang::XMultiServiceFactory >& xSMGR , + LockHelper* pExternalLock , + TransactionManager* pExternalTransactionManager , + sal_Bool bReleaseLockOnCall ); + + //--------------------------------------------------------------------- + /** free all needed memory. + */ + virtual ~PropertySetHelper(); + + //--------------------------------------------------------------------- + /** set a new owner for this helper. + * + * This owner is used as source for all broadcasted events. + * Further we hold it weak, because we dont wish to be disposed() .-) + */ + void impl_setPropertyChangeBroadcaster(const css::uno::Reference< css::uno::XInterface >& xBroadcaster); + + //--------------------------------------------------------------------- + /** add a new property info to the set of supported ones. + * + * @param aProperty + * describes the new property. + * + * @throw [com::sun::star::beans::PropertyExistException] + * if a property with the same name already exists. + * + * Note: The consistence of the whole set of properties is not checked here. + * Means e.g. ... a handle which exists more then once is not detected. + * The owner of this class has to be sure, that every new property does + * not clash with any existing one. + */ + virtual void SAL_CALL impl_addPropertyInfo(const css::beans::Property& aProperty) + throw(css::beans::PropertyExistException, + css::uno::Exception ); + + //--------------------------------------------------------------------- + /** remove an existing property info from the set of supported ones. + * + * @param sProperty + * the name of the property. + * + * @throw [com::sun::star::beans::UnknownPropertyException] + * if no property with the specified name exists. + */ + virtual void SAL_CALL impl_removePropertyInfo(const ::rtl::OUString& sProperty) + throw(css::beans::UnknownPropertyException, + css::uno::Exception ); + + //--------------------------------------------------------------------- + /** mark the object as "useable for working" or "dead". + * + * This correspond to the lifetime handling implemented by the base class TransactionBase. + * There is no chance to reactive a "dead" object by calling impl_enablePropertySet() + * again! + */ + virtual void SAL_CALL impl_enablePropertySet(); + virtual void SAL_CALL impl_disablePropertySet(); + + //--------------------------------------------------------------------- + /** + */ + virtual void SAL_CALL impl_setPropertyValue(const ::rtl::OUString& sProperty, + sal_Int32 nHandle , + const css::uno::Any& aValue ) = 0; + + virtual css::uno::Any SAL_CALL impl_getPropertyValue(const ::rtl::OUString& sProperty, + sal_Int32 nHandle ) = 0; + + //------------------------------------------------------------------------- + /* uno interface */ + public: + + // XPropertySet + virtual css::uno::Reference< css::beans::XPropertySetInfo > SAL_CALL getPropertySetInfo() + throw(css::uno::RuntimeException); + + virtual void SAL_CALL setPropertyValue(const ::rtl::OUString& sProperty, + const css::uno::Any& aValue ) + throw(css::beans::UnknownPropertyException, + css::beans::PropertyVetoException , + css::lang::IllegalArgumentException , + css::lang::WrappedTargetException , + css::uno::RuntimeException ); + + virtual css::uno::Any SAL_CALL getPropertyValue(const ::rtl::OUString& sProperty) + throw(css::beans::UnknownPropertyException, + css::lang::WrappedTargetException , + css::uno::RuntimeException ); + + virtual void SAL_CALL addPropertyChangeListener(const ::rtl::OUString& sProperty, + const css::uno::Reference< css::beans::XPropertyChangeListener >& xListener) + throw(css::beans::UnknownPropertyException, + css::lang::WrappedTargetException , + css::uno::RuntimeException ); + + virtual void SAL_CALL removePropertyChangeListener(const ::rtl::OUString& sProperty, + const css::uno::Reference< css::beans::XPropertyChangeListener >& xListener) + throw(css::beans::UnknownPropertyException, + css::lang::WrappedTargetException , + css::uno::RuntimeException ); + + virtual void SAL_CALL addVetoableChangeListener(const ::rtl::OUString& sProperty, + const css::uno::Reference< css::beans::XVetoableChangeListener >& xListener) + throw(css::beans::UnknownPropertyException, + css::lang::WrappedTargetException , + css::uno::RuntimeException ); + + virtual void SAL_CALL removeVetoableChangeListener(const ::rtl::OUString& sProperty, + const css::uno::Reference< css::beans::XVetoableChangeListener >& xListener) + throw(css::beans::UnknownPropertyException, + css::lang::WrappedTargetException , + css::uno::RuntimeException ); + + // XPropertySetInfo + virtual css::uno::Sequence< css::beans::Property > SAL_CALL getProperties() + throw(css::uno::RuntimeException); + + virtual css::beans::Property SAL_CALL getPropertyByName(const ::rtl::OUString& sName) + throw(css::beans::UnknownPropertyException, + css::uno::RuntimeException ); + + virtual sal_Bool SAL_CALL hasPropertyByName(const ::rtl::OUString& sName) + throw(css::uno::RuntimeException); + + //------------------------------------------------------------------------- + /* internal helper */ + private: + + sal_Bool impl_existsVeto(const css::beans::PropertyChangeEvent& aEvent); + + void impl_notifyChangeListener(const css::beans::PropertyChangeEvent& aEvent); +}; + +} // namespace framework + +#endif // #ifndef __FRAMEWORK_CLASSES_PROPERTYSETHELPER_HXX_ |