1c45d927aSAndrew Rist /************************************************************** 2cdf0e10cSrcweir * 3c45d927aSAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one 4c45d927aSAndrew Rist * or more contributor license agreements. See the NOTICE file 5c45d927aSAndrew Rist * distributed with this work for additional information 6c45d927aSAndrew Rist * regarding copyright ownership. The ASF licenses this file 7c45d927aSAndrew Rist * to you under the Apache License, Version 2.0 (the 8c45d927aSAndrew Rist * "License"); you may not use this file except in compliance 9c45d927aSAndrew Rist * with the License. You may obtain a copy of the License at 10c45d927aSAndrew Rist * 11c45d927aSAndrew Rist * http://www.apache.org/licenses/LICENSE-2.0 12c45d927aSAndrew Rist * 13c45d927aSAndrew Rist * Unless required by applicable law or agreed to in writing, 14c45d927aSAndrew Rist * software distributed under the License is distributed on an 15c45d927aSAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16c45d927aSAndrew Rist * KIND, either express or implied. See the License for the 17c45d927aSAndrew Rist * specific language governing permissions and limitations 18c45d927aSAndrew Rist * under the License. 19c45d927aSAndrew Rist * 20c45d927aSAndrew Rist *************************************************************/ 21c45d927aSAndrew Rist 22c45d927aSAndrew Rist 23cdf0e10cSrcweir 24cdf0e10cSrcweir #ifndef _SD_SIMPLEREFERENCECOMPONENT_HXX_ 25cdf0e10cSrcweir #define _SD_SIMPLEREFERENCECOMPONENT_HXX_ 26cdf0e10cSrcweir 27cdf0e10cSrcweir #include "osl/interlck.h" 28cdf0e10cSrcweir #include "sal/types.h" 29cdf0e10cSrcweir 30cdf0e10cSrcweir #include <cstddef> 31cdf0e10cSrcweir #include <new> 32cdf0e10cSrcweir 33cdf0e10cSrcweir #include <sddllapi.h> 34cdf0e10cSrcweir 35cdf0e10cSrcweir namespace sd { 36cdf0e10cSrcweir 37cdf0e10cSrcweir /** A simple base implementation for reference-counted components. 38cdf0e10cSrcweir acts like sal::SimpleReferenceObject but calls the virtual disposing() 39cdf0e10cSrcweir methods before the ref count switches from 1 to zero. 40cdf0e10cSrcweir */ 41cdf0e10cSrcweir class SimpleReferenceComponent 42cdf0e10cSrcweir { 43cdf0e10cSrcweir public: 44cdf0e10cSrcweir SimpleReferenceComponent(); 45cdf0e10cSrcweir 46cdf0e10cSrcweir /** @ATTENTION 47cdf0e10cSrcweir The results are undefined if, for any individual instance of 48cdf0e10cSrcweir SimpleReferenceComponent, the total number of calls to acquire() exceeds 49*6d678023Smseidel the total number of calls to release() by a platform dependent amount 50cdf0e10cSrcweir (which, hopefully, is quite large). 51cdf0e10cSrcweir */ 52cdf0e10cSrcweir SD_DLLPUBLIC void acquire(); 53cdf0e10cSrcweir SD_DLLPUBLIC void release(); 54cdf0e10cSrcweir 55cdf0e10cSrcweir void Dispose(); 56cdf0e10cSrcweir isDisposed() const57cdf0e10cSrcweir bool isDisposed() const { return mbDisposed; } 58cdf0e10cSrcweir 59cdf0e10cSrcweir /** see general class documentation 60cdf0e10cSrcweir */ 61cdf0e10cSrcweir static void * operator new(std::size_t nSize) SAL_THROW((std::bad_alloc)); 62cdf0e10cSrcweir 63cdf0e10cSrcweir /** see general class documentation 64cdf0e10cSrcweir */ 65cdf0e10cSrcweir static void * operator new(std::size_t nSize, 66cdf0e10cSrcweir std::nothrow_t const & rNothrow) 67cdf0e10cSrcweir ; 68cdf0e10cSrcweir 69cdf0e10cSrcweir /** see general class documentation 70cdf0e10cSrcweir */ 71cdf0e10cSrcweir static void operator delete(void * pPtr); 72cdf0e10cSrcweir 73cdf0e10cSrcweir /** see general class documentation 74cdf0e10cSrcweir */ 75cdf0e10cSrcweir static void operator delete(void * pPtr, std::nothrow_t const & rNothrow) 76cdf0e10cSrcweir ; 77cdf0e10cSrcweir 78cdf0e10cSrcweir protected: 79cdf0e10cSrcweir virtual void disposing(); 80cdf0e10cSrcweir 81cdf0e10cSrcweir virtual ~SimpleReferenceComponent(); 82cdf0e10cSrcweir 83cdf0e10cSrcweir private: 84cdf0e10cSrcweir oslInterlockedCount m_nCount; 85cdf0e10cSrcweir 86cdf0e10cSrcweir /** not implemented 87cdf0e10cSrcweir @internal 88cdf0e10cSrcweir */ 89cdf0e10cSrcweir SimpleReferenceComponent(SimpleReferenceComponent &); 90cdf0e10cSrcweir 91cdf0e10cSrcweir /** not implemented 92cdf0e10cSrcweir @internal 93cdf0e10cSrcweir */ 94cdf0e10cSrcweir void operator =(SimpleReferenceComponent); 95cdf0e10cSrcweir 96cdf0e10cSrcweir /** not implemented (see general class documentation) 97cdf0e10cSrcweir @internal 98cdf0e10cSrcweir */ 99cdf0e10cSrcweir static void * operator new[](std::size_t); 100cdf0e10cSrcweir 101cdf0e10cSrcweir /** not implemented (see general class documentation) 102cdf0e10cSrcweir @internal 103cdf0e10cSrcweir */ 104cdf0e10cSrcweir static void operator delete[](void * pPtr); 105cdf0e10cSrcweir 106cdf0e10cSrcweir bool mbDisposed; 107cdf0e10cSrcweir }; 108cdf0e10cSrcweir 109cdf0e10cSrcweir } 110cdf0e10cSrcweir 111cdf0e10cSrcweir #endif // _SALHELPER_SimpleReferenceComponent_HXX_ 112