1*2e2212a7SAndrew Rist /************************************************************** 2cdf0e10cSrcweir * 3*2e2212a7SAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one 4*2e2212a7SAndrew Rist * or more contributor license agreements. See the NOTICE file 5*2e2212a7SAndrew Rist * distributed with this work for additional information 6*2e2212a7SAndrew Rist * regarding copyright ownership. The ASF licenses this file 7*2e2212a7SAndrew Rist * to you under the Apache License, Version 2.0 (the 8*2e2212a7SAndrew Rist * "License"); you may not use this file except in compliance 9*2e2212a7SAndrew Rist * with the License. You may obtain a copy of the License at 10*2e2212a7SAndrew Rist * 11*2e2212a7SAndrew Rist * http://www.apache.org/licenses/LICENSE-2.0 12*2e2212a7SAndrew Rist * 13*2e2212a7SAndrew Rist * Unless required by applicable law or agreed to in writing, 14*2e2212a7SAndrew Rist * software distributed under the License is distributed on an 15*2e2212a7SAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16*2e2212a7SAndrew Rist * KIND, either express or implied. See the License for the 17*2e2212a7SAndrew Rist * specific language governing permissions and limitations 18*2e2212a7SAndrew Rist * under the License. 19*2e2212a7SAndrew Rist * 20*2e2212a7SAndrew Rist *************************************************************/ 21*2e2212a7SAndrew Rist 22*2e2212a7SAndrew Rist 23cdf0e10cSrcweir 24cdf0e10cSrcweir #ifndef DBAUI_ASYNCRONOUSLINK_HXX 25cdf0e10cSrcweir #define DBAUI_ASYNCRONOUSLINK_HXX 26cdf0e10cSrcweir 27cdf0e10cSrcweir #include <tools/link.hxx> 28cdf0e10cSrcweir #include <osl/mutex.hxx> 29cdf0e10cSrcweir 30cdf0e10cSrcweir namespace dbaui 31cdf0e10cSrcweir { 32cdf0e10cSrcweir // ========================================================================= 33cdf0e10cSrcweir // a helper for multi-threaded handling of async events 34cdf0e10cSrcweir // ------------------------------------------------------------------------- 35cdf0e10cSrcweir /** handles asynchronous links which may be called in multi-threaded environments 36cdf0e10cSrcweir If you use an instance of this class as member of your own class, it will handle 37cdf0e10cSrcweir several crucial points for you (for instance the case that somebody posts the 38cdf0e10cSrcweir event while another thread tries to delete this event in the _destructor_ of the 39cdf0e10cSrcweir class). 40cdf0e10cSrcweir */ 41cdf0e10cSrcweir class OAsyncronousLink 42cdf0e10cSrcweir { 43cdf0e10cSrcweir Link m_aHandler; 44cdf0e10cSrcweir 45cdf0e10cSrcweir protected: 46cdf0e10cSrcweir ::osl::Mutex m_aEventSafety; 47cdf0e10cSrcweir ::osl::Mutex m_aDestructionSafety; 48cdf0e10cSrcweir sal_uLong m_nEventId; 49cdf0e10cSrcweir 50cdf0e10cSrcweir public: 51cdf0e10cSrcweir /** constructs the object 52cdf0e10cSrcweir @param _rHandler The link to be called asyncronously 53cdf0e10cSrcweir */ 54cdf0e10cSrcweir OAsyncronousLink( const Link& _rHandler ); 55cdf0e10cSrcweir virtual ~OAsyncronousLink(); 56cdf0e10cSrcweir IsRunning() const57cdf0e10cSrcweir bool IsRunning() const { return m_nEventId != 0; } 58cdf0e10cSrcweir 59cdf0e10cSrcweir void Call( void* _pArgument = NULL ); 60cdf0e10cSrcweir void CancelCall(); 61cdf0e10cSrcweir 62cdf0e10cSrcweir protected: 63cdf0e10cSrcweir DECL_LINK(OnAsyncCall, void*); 64cdf0e10cSrcweir }; 65cdf0e10cSrcweir } 66cdf0e10cSrcweir #endif // DBAUI_ASYNCRONOUSLINK_HXX 67cdf0e10cSrcweir 68