| /************************************************************** |
| * |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| * |
| *************************************************************/ |
| |
| |
| |
| #ifndef _SD_SIMPLEREFERENCECOMPONENT_HXX_ |
| #define _SD_SIMPLEREFERENCECOMPONENT_HXX_ |
| |
| #include "osl/interlck.h" |
| #include "sal/types.h" |
| |
| #include <cstddef> |
| #include <new> |
| |
| #include <sddllapi.h> |
| |
| namespace sd { |
| |
| /** A simple base implementation for reference-counted components. |
| acts like sal::SimpleReferenceObject but calls the virtual disposing() |
| methods before the ref count switches from 1 to zero. |
| */ |
| class SimpleReferenceComponent |
| { |
| public: |
| SimpleReferenceComponent(); |
| |
| /** @ATTENTION |
| The results are undefined if, for any individual instance of |
| SimpleReferenceComponent, the total number of calls to acquire() exceeds |
| the total number of calls to release() by a plattform dependent amount |
| (which, hopefully, is quite large). |
| */ |
| SD_DLLPUBLIC void acquire(); |
| SD_DLLPUBLIC void release(); |
| |
| void Dispose(); |
| |
| bool isDisposed() const { return mbDisposed; } |
| |
| /** see general class documentation |
| */ |
| static void * operator new(std::size_t nSize) SAL_THROW((std::bad_alloc)); |
| |
| /** see general class documentation |
| */ |
| static void * operator new(std::size_t nSize, |
| std::nothrow_t const & rNothrow) |
| ; |
| |
| /** see general class documentation |
| */ |
| static void operator delete(void * pPtr); |
| |
| /** see general class documentation |
| */ |
| static void operator delete(void * pPtr, std::nothrow_t const & rNothrow) |
| ; |
| |
| protected: |
| virtual void disposing(); |
| |
| virtual ~SimpleReferenceComponent(); |
| |
| private: |
| oslInterlockedCount m_nCount; |
| |
| /** not implemented |
| @internal |
| */ |
| SimpleReferenceComponent(SimpleReferenceComponent &); |
| |
| /** not implemented |
| @internal |
| */ |
| void operator =(SimpleReferenceComponent); |
| |
| /** not implemented (see general class documentation) |
| @internal |
| */ |
| static void * operator new[](std::size_t); |
| |
| /** not implemented (see general class documentation) |
| @internal |
| */ |
| static void operator delete[](void * pPtr); |
| |
| bool mbDisposed; |
| }; |
| |
| } |
| |
| #endif // _SALHELPER_SimpleReferenceComponent_HXX_ |