diff options
Diffstat (limited to 'framework/inc/classes/protocolhandlercache.hxx')
-rw-r--r-- | framework/inc/classes/protocolhandlercache.hxx | 199 |
1 files changed, 199 insertions, 0 deletions
diff --git a/framework/inc/classes/protocolhandlercache.hxx b/framework/inc/classes/protocolhandlercache.hxx new file mode 100644 index 000000000000..77c4ca6a7f93 --- /dev/null +++ b/framework/inc/classes/protocolhandlercache.hxx @@ -0,0 +1,199 @@ +/************************************************************************* + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * 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_PROTOCOLHANDLERCACHE_HXX_ +#define __FRAMEWORK_CLASSES_PROTOCOLHANDLERCACHE_HXX_ + +//_________________________________________________________________________________________________________________ +// my own includes +//_________________________________________________________________________________________________________________ + +#include <general.h> +#include <stdtypes.h> +#include <macros/debug.hxx> + +//_________________________________________________________________________________________________________________ +// interface includes +//_________________________________________________________________________________________________________________ +#include <com/sun/star/util/URL.hpp> + +//_________________________________________________________________________________________________________________ +// other includes +//_________________________________________________________________________________________________________________ + +#include <unotools/configitem.hxx> +#include <rtl/ustring.hxx> + +//_________________________________________________________________________________________________________________ +// namespace +//_________________________________________________________________________________________________________________ + +namespace framework{ + +//_________________________________________________________________________________________________________________ +// exported const +//_________________________________________________________________________________________________________________ + +#define PACKAGENAME_PROTOCOLHANDLER DECLARE_ASCII("Office.ProtocolHandler" ) /// name of our configuration package + +#define CFG_PATH_SEPERATOR DECLARE_ASCII("/" ) /// seperator for configuration pathes +#define CFG_ENCODING_OPEN DECLARE_ASCII("[\'" ) /// used to start encoding of set names +#define CFG_ENCODING_CLOSE DECLARE_ASCII("\']" ) /// used to finish encoding of set names + +#define SETNAME_HANDLER DECLARE_ASCII("HandlerSet" ) /// name of configuration set inside package +#define PROPERTY_PROTOCOLS DECLARE_ASCII("Protocols" ) /// properties of a protocol handler + +//_________________________________________________________________________________________________________________ + +/** + Programmer can register his own services to handle different protocols. + Don't forget: It doesn't mean "handling of documents" ... these services could handle protocols ... + e.g. "mailto:", "file://", ".java:" + This struct holds the information about one such registered protocol handler. + A list of handler objects is defined as ProtocolHandlerHash. see below +*/ +struct ProtocolHandler +{ + /* member */ + public: + + /// the uno implementation name of this handler + ::rtl::OUString m_sUNOName; + /// list of URL pattern which defines the protocols which this handler is registered for + OUStringList m_lProtocols; +}; + +//_________________________________________________________________________________________________________________ + +/** + This hash use registered pattern of all protocol handlers as keys and provide her + uno implementation names as value. Overloading of the index operator makes it possible + to search for a key by using a full qualified URL on list of all possible pattern keys. +*/ +class PatternHash : public BaseHash< ::rtl::OUString > +{ + /* interface */ + public: + + PatternHash::iterator findPatternKey( const ::rtl::OUString& sURL ); +}; + +//_________________________________________________________________________________________________________________ + +/** + This hash holds protocol handler structs by her names. +*/ +typedef BaseHash< ProtocolHandler > HandlerHash; + +//_________________________________________________________________________________________________________________ + +/** + @short this hash makes it easy to find a protocol handler by using his uno implementation name. + @descr It holds two lists of informations: + - first holds all handler by her uno implementation names and + can be used to get her other properties + - another one maps her registered pattern to her uno names to + perform search on such data + But this lists a static for all instances of this class. So it's possible to + create new objects without opening configuration twice and free memory automaticly + if last object will gone. + + @attention We implement a singleton concept - so we doesn't need any mutex member here. + Because to safe access on static member we must use a static global lock + here too. + + @devstatus ready to use + @threadsafe yes + + @modified 30.04.2002 11:19, as96863 +*/ + +class HandlerCFGAccess; +class HandlerCache +{ + /* member */ + private: + + /// list of all registered handler registered by her uno implementation names + static HandlerHash* m_pHandler; + /// maps URL pattern to handler names + static PatternHash* m_pPattern; + /// informs about config updates + static HandlerCFGAccess* m_pConfig; + /// ref count to construct/destruct internal member lists on demand by using singleton mechanism + static sal_Int32 m_nRefCount; + + /* interface */ + public: + + HandlerCache(); + virtual ~HandlerCache(); + + sal_Bool search( const ::rtl::OUString& sURL, ProtocolHandler* pReturn ) const; + sal_Bool search( const css::util::URL& aURL, ProtocolHandler* pReturn ) const; + sal_Bool exists( const ::rtl::OUString& sURL ) const; + + void takeOver(HandlerHash* pHandler, PatternHash* pPattern); +}; + +//_________________________________________________________________________________________________________________ + +/** + @short implements configuration access for handler configuration + @descr We use the ConfigItem mechanism to read/write values from/to configuration. + We set a data container pointer for filling or reading ... this class use it temp. + After successfuly calling of read(), we can use filled container directly or merge it with an existing one. + After successfuly calling of write() all values of given data container are flushed to our configuration - + but current implementation doesn't support writeing realy. + + @base ::utl::ConfigItem + base mechanism for configuration access + + @devstatus ready to use + @threadsafe no + + @modified 30.04.2002 09:58, as96863 +*/ +class HandlerCFGAccess : public ::utl::ConfigItem +{ + private: + HandlerCache* m_pCache; + + /* interface */ + public: + HandlerCFGAccess( const ::rtl::OUString& sPackage ); + void read ( HandlerHash** ppHandler , + PatternHash** ppPattern ); + + void setCache(HandlerCache* pCache) {m_pCache = pCache;}; + virtual void Notify(const css::uno::Sequence< rtl::OUString >& lPropertyNames); + virtual void Commit(); +}; + +} // namespace framework + +#endif // #ifndef __FRAMEWORK_CLASSES_PROTOCOLHANDLERCACHE_HXX_ |