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