1*cdf0e10cSrcweir /************************************************************************* 2*cdf0e10cSrcweir * 3*cdf0e10cSrcweir * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4*cdf0e10cSrcweir * 5*cdf0e10cSrcweir * Copyright 2000, 2010 Oracle and/or its affiliates. 6*cdf0e10cSrcweir * 7*cdf0e10cSrcweir * OpenOffice.org - a multi-platform office productivity suite 8*cdf0e10cSrcweir * 9*cdf0e10cSrcweir * This file is part of OpenOffice.org. 10*cdf0e10cSrcweir * 11*cdf0e10cSrcweir * OpenOffice.org is free software: you can redistribute it and/or modify 12*cdf0e10cSrcweir * it under the terms of the GNU Lesser General Public License version 3 13*cdf0e10cSrcweir * only, as published by the Free Software Foundation. 14*cdf0e10cSrcweir * 15*cdf0e10cSrcweir * OpenOffice.org is distributed in the hope that it will be useful, 16*cdf0e10cSrcweir * but WITHOUT ANY WARRANTY; without even the implied warranty of 17*cdf0e10cSrcweir * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 18*cdf0e10cSrcweir * GNU Lesser General Public License version 3 for more details 19*cdf0e10cSrcweir * (a copy is included in the LICENSE file that accompanied this code). 20*cdf0e10cSrcweir * 21*cdf0e10cSrcweir * You should have received a copy of the GNU Lesser General Public License 22*cdf0e10cSrcweir * version 3 along with OpenOffice.org. If not, see 23*cdf0e10cSrcweir * <http://www.openoffice.org/license.html> 24*cdf0e10cSrcweir * for a copy of the LGPLv3 License. 25*cdf0e10cSrcweir * 26*cdf0e10cSrcweir ************************************************************************/ 27*cdf0e10cSrcweir 28*cdf0e10cSrcweir // MARKER(update_precomp.py): autogen include statement, do not remove 29*cdf0e10cSrcweir #include "precompiled_framework.hxx" 30*cdf0e10cSrcweir 31*cdf0e10cSrcweir /*TODO 32*cdf0e10cSrcweir - change "singleton" behaviour by using new helper ::comhelper::SingletonRef 33*cdf0e10cSrcweir - rename method exist() to existHandlerForURL() or similar one 34*cdf0e10cSrcweir - may its a good idea to replace struct ProtocolHandler by css::beans::NamedValue type?! 35*cdf0e10cSrcweir */ 36*cdf0e10cSrcweir 37*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 38*cdf0e10cSrcweir // my own includes 39*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 40*cdf0e10cSrcweir 41*cdf0e10cSrcweir #include <classes/protocolhandlercache.hxx> 42*cdf0e10cSrcweir #include <classes/converter.hxx> 43*cdf0e10cSrcweir #include <threadhelp/readguard.hxx> 44*cdf0e10cSrcweir #include <threadhelp/writeguard.hxx> 45*cdf0e10cSrcweir #include <threadhelp/lockhelper.hxx> 46*cdf0e10cSrcweir 47*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 48*cdf0e10cSrcweir // interface includes 49*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 50*cdf0e10cSrcweir 51*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 52*cdf0e10cSrcweir // other includes 53*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 54*cdf0e10cSrcweir #include <tools/wldcrd.hxx> 55*cdf0e10cSrcweir #include <unotools/configpathes.hxx> 56*cdf0e10cSrcweir #include <rtl/ustrbuf.hxx> 57*cdf0e10cSrcweir 58*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 59*cdf0e10cSrcweir // namespace 60*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 61*cdf0e10cSrcweir 62*cdf0e10cSrcweir namespace framework{ 63*cdf0e10cSrcweir 64*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 65*cdf0e10cSrcweir // non exported const 66*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 67*cdf0e10cSrcweir 68*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 69*cdf0e10cSrcweir // non exported definitions 70*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 71*cdf0e10cSrcweir 72*cdf0e10cSrcweir /** 73*cdf0e10cSrcweir @short overloaded index operator of hash map to support pattern key search 74*cdf0e10cSrcweir @descr All keys inside this hash map are URL pattern which points to an uno 75*cdf0e10cSrcweir implementation name of a protocol handler service which is registered 76*cdf0e10cSrcweir for this pattern. This operator makes it easy to find such registered 77*cdf0e10cSrcweir handler by using a full qualified URL and compare it with all pattern 78*cdf0e10cSrcweir keys. 79*cdf0e10cSrcweir 80*cdf0e10cSrcweir @param sURL 81*cdf0e10cSrcweir the full qualified URL which should match to a registered pattern 82*cdf0e10cSrcweir 83*cdf0e10cSrcweir @return An iterator which points to the found item inside the hash or PatternHash::end() 84*cdf0e10cSrcweir if no pattern match this given <var>sURL</var>. 85*cdf0e10cSrcweir 86*cdf0e10cSrcweir @modified 30.04.2002 09:52, as96863 87*cdf0e10cSrcweir */ 88*cdf0e10cSrcweir PatternHash::iterator PatternHash::findPatternKey( const ::rtl::OUString& sURL ) 89*cdf0e10cSrcweir { 90*cdf0e10cSrcweir PatternHash::iterator pItem = this->begin(); 91*cdf0e10cSrcweir while( pItem!=this->end() ) 92*cdf0e10cSrcweir { 93*cdf0e10cSrcweir WildCard aPattern(pItem->first); 94*cdf0e10cSrcweir if (aPattern.Matches(sURL)) 95*cdf0e10cSrcweir break; 96*cdf0e10cSrcweir ++pItem; 97*cdf0e10cSrcweir } 98*cdf0e10cSrcweir return pItem; 99*cdf0e10cSrcweir } 100*cdf0e10cSrcweir 101*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 102*cdf0e10cSrcweir 103*cdf0e10cSrcweir /** 104*cdf0e10cSrcweir @short initialize static member of class HandlerCache 105*cdf0e10cSrcweir @descr We use a singleton pattern to implement this handler cache. 106*cdf0e10cSrcweir That means it use two static member list to hold all neccessary informations 107*cdf0e10cSrcweir and a ref count mechanism to create/destroy it on demand. 108*cdf0e10cSrcweir 109*cdf0e10cSrcweir @modified 30.04.2002 11:13, as96863 110*cdf0e10cSrcweir */ 111*cdf0e10cSrcweir HandlerHash* HandlerCache::m_pHandler = NULL; 112*cdf0e10cSrcweir PatternHash* HandlerCache::m_pPattern = NULL; 113*cdf0e10cSrcweir sal_Int32 HandlerCache::m_nRefCount = 0 ; 114*cdf0e10cSrcweir HandlerCFGAccess* HandlerCache::m_pConfig = NULL; 115*cdf0e10cSrcweir 116*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 117*cdf0e10cSrcweir 118*cdf0e10cSrcweir /** 119*cdf0e10cSrcweir @short ctor of the cache of all registered protoco handler 120*cdf0e10cSrcweir @descr It tries to open the right configuration package automaticly 121*cdf0e10cSrcweir and fill the internal structures. After that the cache can be 122*cdf0e10cSrcweir used for read access on this data and perform some search 123*cdf0e10cSrcweir operations on it. 124*cdf0e10cSrcweir 125*cdf0e10cSrcweir @modified 30.04.2002 10:02, as96863 126*cdf0e10cSrcweir */ 127*cdf0e10cSrcweir HandlerCache::HandlerCache() 128*cdf0e10cSrcweir { 129*cdf0e10cSrcweir /* SAFE */{ 130*cdf0e10cSrcweir WriteGuard aGlobalLock( LockHelper::getGlobalLock() ); 131*cdf0e10cSrcweir 132*cdf0e10cSrcweir if (m_nRefCount==0) 133*cdf0e10cSrcweir { 134*cdf0e10cSrcweir m_pHandler = new HandlerHash(); 135*cdf0e10cSrcweir m_pPattern = new PatternHash(); 136*cdf0e10cSrcweir m_pConfig = new HandlerCFGAccess(PACKAGENAME_PROTOCOLHANDLER); 137*cdf0e10cSrcweir m_pConfig->read(&m_pHandler,&m_pPattern); 138*cdf0e10cSrcweir m_pConfig->setCache(this); 139*cdf0e10cSrcweir } 140*cdf0e10cSrcweir 141*cdf0e10cSrcweir ++m_nRefCount; 142*cdf0e10cSrcweir /* SAFE */} 143*cdf0e10cSrcweir } 144*cdf0e10cSrcweir 145*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 146*cdf0e10cSrcweir 147*cdf0e10cSrcweir /** 148*cdf0e10cSrcweir @short dtor of the cache 149*cdf0e10cSrcweir @descr It frees all used memory. In further implementations (may if we support write access too) 150*cdf0e10cSrcweir it's a good place to flush changes back to the configuration - but not needed yet. 151*cdf0e10cSrcweir 152*cdf0e10cSrcweir @modified 30.04.2002 09:54, as96863 153*cdf0e10cSrcweir */ 154*cdf0e10cSrcweir HandlerCache::~HandlerCache() 155*cdf0e10cSrcweir { 156*cdf0e10cSrcweir /* SAFE */{ 157*cdf0e10cSrcweir WriteGuard aGlobalLock( LockHelper::getGlobalLock() ); 158*cdf0e10cSrcweir 159*cdf0e10cSrcweir if( m_nRefCount==1) 160*cdf0e10cSrcweir { 161*cdf0e10cSrcweir m_pConfig->setCache(NULL); 162*cdf0e10cSrcweir m_pHandler->free(); 163*cdf0e10cSrcweir m_pPattern->free(); 164*cdf0e10cSrcweir 165*cdf0e10cSrcweir delete m_pConfig; 166*cdf0e10cSrcweir delete m_pHandler; 167*cdf0e10cSrcweir delete m_pPattern; 168*cdf0e10cSrcweir m_pConfig = NULL; 169*cdf0e10cSrcweir m_pHandler= NULL; 170*cdf0e10cSrcweir m_pPattern= NULL; 171*cdf0e10cSrcweir } 172*cdf0e10cSrcweir 173*cdf0e10cSrcweir --m_nRefCount; 174*cdf0e10cSrcweir /* SAFE */} 175*cdf0e10cSrcweir } 176*cdf0e10cSrcweir 177*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 178*cdf0e10cSrcweir 179*cdf0e10cSrcweir /** 180*cdf0e10cSrcweir @short dtor of the cache 181*cdf0e10cSrcweir @descr It frees all used memory. In further implementations (may if we support write access too) 182*cdf0e10cSrcweir it's a good place to flush changes back to the configuration - but not needed yet. 183*cdf0e10cSrcweir 184*cdf0e10cSrcweir @modified 30.04.2002 09:54, as96863 185*cdf0e10cSrcweir */ 186*cdf0e10cSrcweir sal_Bool HandlerCache::search( const ::rtl::OUString& sURL, ProtocolHandler* pReturn ) const 187*cdf0e10cSrcweir { 188*cdf0e10cSrcweir sal_Bool bFound = sal_False; 189*cdf0e10cSrcweir /* SAFE */{ 190*cdf0e10cSrcweir ReadGuard aReadLock( LockHelper::getGlobalLock() ); 191*cdf0e10cSrcweir PatternHash::const_iterator pItem = m_pPattern->findPatternKey(sURL); 192*cdf0e10cSrcweir if (pItem!=m_pPattern->end()) 193*cdf0e10cSrcweir { 194*cdf0e10cSrcweir *pReturn = (*m_pHandler)[pItem->second]; 195*cdf0e10cSrcweir bFound = sal_True; 196*cdf0e10cSrcweir } 197*cdf0e10cSrcweir /* SAFE */} 198*cdf0e10cSrcweir return bFound; 199*cdf0e10cSrcweir } 200*cdf0e10cSrcweir 201*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 202*cdf0e10cSrcweir 203*cdf0e10cSrcweir /** 204*cdf0e10cSrcweir @short search for a registered handler by using an URL struct 205*cdf0e10cSrcweir @descr We combine neccessary parts of this struct to a valid URL string 206*cdf0e10cSrcweir and call our other search method ... 207*cdf0e10cSrcweir It's a helper for outside code. 208*cdf0e10cSrcweir 209*cdf0e10cSrcweir @modified 30.04.2002 09:54, as96863 210*cdf0e10cSrcweir */ 211*cdf0e10cSrcweir sal_Bool HandlerCache::search( const css::util::URL& aURL, ProtocolHandler* pReturn ) const 212*cdf0e10cSrcweir { 213*cdf0e10cSrcweir return search( aURL.Complete, pReturn ); 214*cdf0e10cSrcweir } 215*cdf0e10cSrcweir 216*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 217*cdf0e10cSrcweir 218*cdf0e10cSrcweir sal_Bool HandlerCache::exists( const ::rtl::OUString& sURL ) const 219*cdf0e10cSrcweir { 220*cdf0e10cSrcweir sal_Bool bFound = sal_False; 221*cdf0e10cSrcweir /* SAFE */{ 222*cdf0e10cSrcweir ReadGuard aReadLock( LockHelper::getGlobalLock() ); 223*cdf0e10cSrcweir PatternHash::const_iterator pItem = m_pPattern->findPatternKey(sURL); 224*cdf0e10cSrcweir bFound = pItem!=m_pPattern->end(); 225*cdf0e10cSrcweir /* SAFE */} 226*cdf0e10cSrcweir return bFound; 227*cdf0e10cSrcweir } 228*cdf0e10cSrcweir 229*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 230*cdf0e10cSrcweir void HandlerCache::takeOver(HandlerHash* pHandler, PatternHash* pPattern) 231*cdf0e10cSrcweir { 232*cdf0e10cSrcweir // SAFE -> 233*cdf0e10cSrcweir WriteGuard aWriteLock( LockHelper::getGlobalLock() ); 234*cdf0e10cSrcweir 235*cdf0e10cSrcweir HandlerHash* pOldHandler = m_pHandler; 236*cdf0e10cSrcweir PatternHash* pOldPattern = m_pPattern; 237*cdf0e10cSrcweir 238*cdf0e10cSrcweir m_pHandler = pHandler; 239*cdf0e10cSrcweir m_pPattern = pPattern; 240*cdf0e10cSrcweir 241*cdf0e10cSrcweir pOldHandler->free(); 242*cdf0e10cSrcweir pOldPattern->free(); 243*cdf0e10cSrcweir delete pOldHandler; 244*cdf0e10cSrcweir delete pOldPattern; 245*cdf0e10cSrcweir 246*cdf0e10cSrcweir aWriteLock.unlock(); 247*cdf0e10cSrcweir // <- SAFE 248*cdf0e10cSrcweir } 249*cdf0e10cSrcweir 250*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 251*cdf0e10cSrcweir 252*cdf0e10cSrcweir /** 253*cdf0e10cSrcweir @short dtor of the config access class 254*cdf0e10cSrcweir @descr It opens the configuration package automaticly by using base class mechanism. 255*cdf0e10cSrcweir After that "read()" method of this class should be called to use it. 256*cdf0e10cSrcweir 257*cdf0e10cSrcweir @param sPackage 258*cdf0e10cSrcweir specifies the package name of the configuration data which should be used 259*cdf0e10cSrcweir 260*cdf0e10cSrcweir @modified 30.04.2002 10:06, as96863 261*cdf0e10cSrcweir */ 262*cdf0e10cSrcweir HandlerCFGAccess::HandlerCFGAccess( const ::rtl::OUString& sPackage ) 263*cdf0e10cSrcweir : ConfigItem( sPackage ) 264*cdf0e10cSrcweir { 265*cdf0e10cSrcweir css::uno::Sequence< ::rtl::OUString > lListenPathes(1); 266*cdf0e10cSrcweir lListenPathes[0] = SETNAME_HANDLER; 267*cdf0e10cSrcweir EnableNotification(lListenPathes); 268*cdf0e10cSrcweir } 269*cdf0e10cSrcweir 270*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 271*cdf0e10cSrcweir 272*cdf0e10cSrcweir /** 273*cdf0e10cSrcweir @short use base class mechanism to fill given structures 274*cdf0e10cSrcweir @descr User use us as a wrapper between configuration api and his internal structures. 275*cdf0e10cSrcweir He give us some pointer to his member and we fill it. 276*cdf0e10cSrcweir 277*cdf0e10cSrcweir @param pHandler 278*cdf0e10cSrcweir pointer to a list of protocol handler infos 279*cdf0e10cSrcweir 280*cdf0e10cSrcweir @param pPattern 281*cdf0e10cSrcweir reverse map of handler pattern to her uno names 282*cdf0e10cSrcweir 283*cdf0e10cSrcweir @modified 30.04.2002 09:54, as96863 284*cdf0e10cSrcweir */ 285*cdf0e10cSrcweir void HandlerCFGAccess::read( HandlerHash** ppHandler , 286*cdf0e10cSrcweir PatternHash** ppPattern ) 287*cdf0e10cSrcweir { 288*cdf0e10cSrcweir // list of all uno implementation names without encoding 289*cdf0e10cSrcweir css::uno::Sequence< ::rtl::OUString > lNames = GetNodeNames( SETNAME_HANDLER, ::utl::CONFIG_NAME_LOCAL_PATH ); 290*cdf0e10cSrcweir sal_Int32 nSourceCount = lNames.getLength(); 291*cdf0e10cSrcweir sal_Int32 nTargetCount = nSourceCount; 292*cdf0e10cSrcweir // list of all full qualified path names of configuration entries 293*cdf0e10cSrcweir css::uno::Sequence< ::rtl::OUString > lFullNames ( nTargetCount ); 294*cdf0e10cSrcweir 295*cdf0e10cSrcweir // expand names to full path names 296*cdf0e10cSrcweir sal_Int32 nSource=0; 297*cdf0e10cSrcweir sal_Int32 nTarget=0; 298*cdf0e10cSrcweir for( nSource=0; nSource<nSourceCount; ++nSource ) 299*cdf0e10cSrcweir { 300*cdf0e10cSrcweir ::rtl::OUStringBuffer sPath( SETNAME_HANDLER ); 301*cdf0e10cSrcweir sPath.append(CFG_PATH_SEPERATOR); 302*cdf0e10cSrcweir sPath.append(lNames[nSource]); 303*cdf0e10cSrcweir sPath.append(CFG_PATH_SEPERATOR); 304*cdf0e10cSrcweir sPath.append(PROPERTY_PROTOCOLS); 305*cdf0e10cSrcweir 306*cdf0e10cSrcweir lFullNames[nTarget] = sPath.makeStringAndClear(); 307*cdf0e10cSrcweir ++nTarget; 308*cdf0e10cSrcweir } 309*cdf0e10cSrcweir 310*cdf0e10cSrcweir // get values at all 311*cdf0e10cSrcweir css::uno::Sequence< css::uno::Any > lValues = GetProperties( lFullNames ); 312*cdf0e10cSrcweir LOG_ASSERT2( lFullNames.getLength()!=lValues.getLength(), "HandlerCFGAccess::read()", "Miss some configuration values of handler set!" ) 313*cdf0e10cSrcweir 314*cdf0e10cSrcweir // fill structures 315*cdf0e10cSrcweir nSource = 0; 316*cdf0e10cSrcweir for( nTarget=0; nTarget<nTargetCount; ++nTarget ) 317*cdf0e10cSrcweir { 318*cdf0e10cSrcweir // create it new for every loop to guarantee a real empty object! 319*cdf0e10cSrcweir ProtocolHandler aHandler; 320*cdf0e10cSrcweir aHandler.m_sUNOName = ::utl::extractFirstFromConfigurationPath(lNames[nSource]); 321*cdf0e10cSrcweir 322*cdf0e10cSrcweir // unpack all values of this handler 323*cdf0e10cSrcweir css::uno::Sequence< ::rtl::OUString > lTemp; 324*cdf0e10cSrcweir lValues[nTarget] >>= lTemp; 325*cdf0e10cSrcweir aHandler.m_lProtocols = Converter::convert_seqOUString2OUStringList(lTemp); 326*cdf0e10cSrcweir 327*cdf0e10cSrcweir // register his pattern into the performance search hash 328*cdf0e10cSrcweir for (OUStringList::iterator pItem =aHandler.m_lProtocols.begin(); 329*cdf0e10cSrcweir pItem!=aHandler.m_lProtocols.end() ; 330*cdf0e10cSrcweir ++pItem ) 331*cdf0e10cSrcweir { 332*cdf0e10cSrcweir (**ppPattern)[*pItem] = lNames[nSource]; 333*cdf0e10cSrcweir } 334*cdf0e10cSrcweir 335*cdf0e10cSrcweir // ï¿œnsert the handler info into the normal handler cache 336*cdf0e10cSrcweir (**ppHandler)[lNames[nSource]] = aHandler; 337*cdf0e10cSrcweir ++nSource; 338*cdf0e10cSrcweir } 339*cdf0e10cSrcweir } 340*cdf0e10cSrcweir 341*cdf0e10cSrcweir //_________________________________________________________________________________________________________________ 342*cdf0e10cSrcweir void HandlerCFGAccess::Notify(const css::uno::Sequence< rtl::OUString >& /*lPropertyNames*/) 343*cdf0e10cSrcweir { 344*cdf0e10cSrcweir HandlerHash* pHandler = new HandlerHash; 345*cdf0e10cSrcweir PatternHash* pPattern = new PatternHash; 346*cdf0e10cSrcweir 347*cdf0e10cSrcweir read(&pHandler, &pPattern); 348*cdf0e10cSrcweir if (m_pCache) 349*cdf0e10cSrcweir m_pCache->takeOver(pHandler, pPattern); 350*cdf0e10cSrcweir else 351*cdf0e10cSrcweir { 352*cdf0e10cSrcweir delete pHandler; 353*cdf0e10cSrcweir delete pPattern; 354*cdf0e10cSrcweir } 355*cdf0e10cSrcweir } 356*cdf0e10cSrcweir 357*cdf0e10cSrcweir void HandlerCFGAccess::Commit() 358*cdf0e10cSrcweir { 359*cdf0e10cSrcweir } 360*cdf0e10cSrcweir 361*cdf0e10cSrcweir } // namespace framework 362