1 /************************************************************** 2 * 3 * Licensed to the Apache Software Foundation (ASF) under one 4 * or more contributor license agreements. See the NOTICE file 5 * distributed with this work for additional information 6 * regarding copyright ownership. The ASF licenses this file 7 * to you under the Apache License, Version 2.0 (the 8 * "License"); you may not use this file except in compliance 9 * with the License. You may obtain a copy of the License at 10 * 11 * http://www.apache.org/licenses/LICENSE-2.0 12 * 13 * Unless required by applicable law or agreed to in writing, 14 * software distributed under the License is distributed on an 15 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16 * KIND, either express or implied. See the License for the 17 * specific language governing permissions and limitations 18 * under the License. 19 * 20 *************************************************************/ 21 22 23 24 // MARKER(update_precomp.py): autogen include statement, do not remove 25 #include "precompiled_cppuhelper.hxx" 26 #include <rtl/string.hxx> 27 #include <osl/diagnose.h> 28 #include <cppuhelper/component.hxx> 29 #include <cppuhelper/queryinterface.hxx> 30 #include <cppuhelper/typeprovider.hxx> 31 #include "com/sun/star/uno/RuntimeException.hpp" 32 33 using namespace osl; 34 using namespace rtl; 35 using namespace com::sun::star; 36 using namespace com::sun::star::uno; 37 using namespace com::sun::star::lang; 38 39 namespace cppu 40 { 41 42 // ---------------------------------------------------- 43 // class OComponentHelper 44 // ---------------------------------------------------- 45 46 OComponentHelper::OComponentHelper( Mutex & rMutex ) SAL_THROW( () ) 47 : rBHelper( rMutex ) 48 { 49 } 50 OComponentHelper::~OComponentHelper() SAL_THROW( (RuntimeException) ) 51 { 52 } 53 54 Any OComponentHelper::queryInterface( Type const & rType ) throw (RuntimeException) 55 { 56 return OWeakAggObject::queryInterface( rType ); 57 } 58 Any OComponentHelper::queryAggregation( Type const & rType ) throw (RuntimeException) 59 { 60 if (rType == ::getCppuType( (Reference< lang::XComponent > const *)0 )) 61 { 62 void * p = static_cast< lang::XComponent * >( this ); 63 return Any( &p, rType ); 64 } 65 else if (rType == ::getCppuType( (Reference< lang::XTypeProvider > const *)0 )) 66 { 67 void * p = static_cast< lang::XTypeProvider * >( this ); 68 return Any( &p, rType ); 69 } 70 return OWeakAggObject::queryAggregation( rType ); 71 } 72 void OComponentHelper::acquire() throw () 73 { 74 OWeakAggObject::acquire(); 75 } 76 77 void OComponentHelper::release() throw() 78 { 79 Reference<XInterface > x( xDelegator ); 80 if (! x.is()) 81 { 82 if (osl_decrementInterlockedCount( &m_refCount ) == 0) 83 { 84 if (! rBHelper.bDisposed) 85 { 86 // *before* again incrementing our ref count, ensure that our weak connection point 87 // will not create references to us anymore (via XAdapter::queryAdapted) 88 disposeWeakConnectionPoint(); 89 90 Reference<XInterface > xHoldAlive( *this ); 91 // First dispose 92 try 93 { 94 dispose(); 95 } 96 catch (::com::sun::star::uno::RuntimeException & exc) 97 { 98 // release should not throw exceptions 99 #if OSL_DEBUG_LEVEL > 0 100 OString msg( OUStringToOString( exc.Message, RTL_TEXTENCODING_ASCII_US ) ); 101 OSL_ENSURE( 0, msg.getStr() ); 102 #else 103 (void) exc; // avoid warning about unused variable 104 #endif 105 } 106 107 // only the alive ref holds the object 108 OSL_ASSERT( m_refCount == 1 ); 109 // destroy the object if xHoldAlive decrement the refcount to 0 110 return; 111 } 112 } 113 // restore the reference count 114 osl_incrementInterlockedCount( &m_refCount ); 115 } 116 OWeakAggObject::release(); 117 } 118 119 Sequence< Type > OComponentHelper::getTypes() throw (RuntimeException) 120 { 121 static OTypeCollection * s_pTypes = 0; 122 if (! s_pTypes) 123 { 124 MutexGuard aGuard( Mutex::getGlobalMutex() ); 125 if (! s_pTypes) 126 { 127 static OTypeCollection s_aTypes( 128 ::getCppuType( (const Reference< lang::XComponent > *)0 ), 129 ::getCppuType( (const Reference< lang::XTypeProvider > *)0 ), 130 ::getCppuType( (const Reference< XAggregation > *)0 ), 131 ::getCppuType( (const Reference< XWeak > *)0 ) ); 132 s_pTypes = &s_aTypes; 133 } 134 } 135 return s_pTypes->getTypes(); 136 } 137 138 // XComponent 139 void OComponentHelper::disposing() 140 { 141 } 142 143 // XComponent 144 void OComponentHelper::dispose() 145 throw(::com::sun::star::uno::RuntimeException) 146 { 147 // An frequently programming error is to release the last 148 // reference to this object in the disposing message. 149 // Make it rubust, hold a self Reference. 150 Reference<XComponent > xSelf( this ); 151 152 // Guard dispose against multible threading 153 // Remark: It is an error to call dispose more than once 154 sal_Bool bDoDispose = sal_False; 155 { 156 MutexGuard aGuard( rBHelper.rMutex ); 157 if( !rBHelper.bDisposed && !rBHelper.bInDispose ) 158 { 159 // only one call go into this section 160 rBHelper.bInDispose = sal_True; 161 bDoDispose = sal_True; 162 } 163 } 164 165 // Do not hold the mutex because we are broadcasting 166 if( bDoDispose ) 167 { 168 // Create an event with this as sender 169 try 170 { 171 try 172 { 173 Reference<XInterface > xSource( 174 Reference<XInterface >::query( (XComponent *)this ) ); 175 EventObject aEvt; 176 aEvt.Source = xSource; 177 // inform all listeners to release this object 178 // The listener container are automaticly cleared 179 rBHelper.aLC.disposeAndClear( aEvt ); 180 // notify subclasses to do their dispose 181 disposing(); 182 } 183 catch (...) 184 { 185 MutexGuard aGuard( rBHelper.rMutex ); 186 // bDispose and bInDisposing must be set in this order: 187 rBHelper.bDisposed = sal_True; 188 rBHelper.bInDispose = sal_False; 189 throw; 190 } 191 MutexGuard aGuard( rBHelper.rMutex ); 192 // bDispose and bInDisposing must be set in this order: 193 rBHelper.bDisposed = sal_True; 194 rBHelper.bInDispose = sal_False; 195 } 196 catch (RuntimeException &) 197 { 198 throw; 199 } 200 catch (Exception & exc) 201 { 202 throw RuntimeException( 203 OUString( RTL_CONSTASCII_USTRINGPARAM( 204 "unexpected UNO exception caught: ") ) + 205 exc.Message, Reference< XInterface >() ); 206 } 207 } 208 else 209 { 210 // in a multithreaded environment, it can't be avoided, 211 // that dispose is called twice. 212 // However this condition is traced, because it MAY indicate an error. 213 OSL_TRACE( "OComponentHelper::dispose() - dispose called twice" ); 214 } 215 } 216 217 // XComponent 218 void OComponentHelper::addEventListener( 219 const Reference<XEventListener > & rxListener ) 220 throw(::com::sun::star::uno::RuntimeException) 221 { 222 ClearableMutexGuard aGuard( rBHelper.rMutex ); 223 if (rBHelper.bDisposed || rBHelper.bInDispose) 224 { 225 aGuard.clear(); 226 Reference< XInterface > x( (XComponent *)this, UNO_QUERY ); 227 rxListener->disposing( EventObject( x ) ); 228 } 229 else 230 { 231 rBHelper.addListener( ::getCppuType( &rxListener ) , rxListener ); 232 } 233 } 234 235 // XComponent 236 void OComponentHelper::removeEventListener( 237 const Reference<XEventListener > & rxListener ) 238 throw(::com::sun::star::uno::RuntimeException) 239 { 240 rBHelper.removeListener( ::getCppuType( &rxListener ) , rxListener ); 241 } 242 243 } 244 245