Base class to implement a UNO object supporting weak references, i.e. More...

#include <weakagg.hxx>

Inheritance diagram for cppu::OWeakAggObject:

Collaboration diagram for cppu::OWeakAggObject:

Public Member Functions
	OWeakAggObject ()
	Constructor. More...

virtual void SAL_CALL	acquire () SAL_NOEXCEPT SAL_OVERRIDE
	If a delegator is set, then the delegators gets acquired. More...

virtual void SAL_CALL	release () SAL_NOEXCEPT SAL_OVERRIDE
	If a delegator is set, then the delegators gets released. More...

virtual css::uno::Any SAL_CALL	queryInterface (const css::uno::Type &rType) SAL_OVERRIDE
	If a delegator is set, then the delegator is queried for the demanded interface. More...

virtual void SAL_CALL	setDelegator (const css::uno::Reference< css::uno::XInterface > &Delegator) SAL_OVERRIDE
	Set the delegator. More...

virtual css::uno::Any SAL_CALL	queryAggregation (const css::uno::Type &rType) SAL_OVERRIDE
	Called by the delegator or queryInterface. More...

Public Member Functions inherited from cppu::OWeakObject
	OWeakObject ()
	Default Constructor. More...

	OWeakObject (const OWeakObject &)
	Dummy copy constructor. More...

OWeakObject &SAL_CALL	operator= (const OWeakObject &)
	Dummy assignment operator. More...

virtual css::uno::Any SAL_CALL	queryInterface (const css::uno::Type &rType) SAL_OVERRIDE
	Basic queryInterface() implementation supporting com::sun::star::uno::XWeak and com::sun::star::uno::XInterface. More...

virtual void SAL_CALL	acquire () SAL_NOEXCEPT SAL_OVERRIDE
	increasing m_refCount More...

virtual void SAL_CALL	release () SAL_NOEXCEPT SAL_OVERRIDE
	decreasing m_refCount More...

virtual css::uno::Reference< css::uno::XAdapter > SAL_CALL	queryAdapter () SAL_OVERRIDE
	XWeak::queryAdapter() implementation. More...

SAL_CALL	operator css::uno::Reference< css::uno::XInterface > ()
	Cast operator to XInterface reference. More...

Protected Member Functions
virtual	~OWeakAggObject () SAL_OVERRIDE
	Virtual dtor. More...

Protected Member Functions inherited from cppu::OWeakObject
virtual	~OWeakObject () COVERITY_NOEXCEPT_FALSE
	Virtual dtor. More...

void	disposeWeakConnectionPoint ()
	disposes and resets m_pWeakConnectionPoint More...

Protected Attributes
css::uno::WeakReferenceHelper	xDelegator
	weak reference to delegator. More...

Protected Attributes inherited from cppu::OWeakObject
oslInterlockedCount	m_refCount
	reference count. More...

Private Member Functions
	OWeakAggObject (const OWeakAggObject &rObj) SAL_DELETED_FUNCTION

OWeakAggObject &	operator= (const OWeakAggObject &rObj) SAL_DELETED_FUNCTION

Detailed Description

Base class to implement a UNO object supporting weak references, i.e.

the object can be held weakly (by a css::uno::WeakReference) and aggregation, i.e. the object can be aggregated by another (delegator). This implementation copes with reference counting. Upon last release(), the virtual dtor is called.

Derive: \n: Inherit from this class and delegate acquire()/ release() calls. Re-implement XAggregation::queryInterface().

Definition at line 45 of file weakagg.hxx.

Constructor & Destructor Documentation

◆ OWeakAggObject() [1/2]

cppu::OWeakAggObject::OWeakAggObject ( )

inline

Constructor.

No delegator set.

Definition at line 52 of file weakagg.hxx.

◆ ~OWeakAggObject()

cppu::OWeakAggObject::~OWeakAggObject ( )

protectedvirtual

Virtual dtor.

Called when reference count is 0.

Attention: \n: Despite the fact that a RuntimeException is allowed to be thrown, you must not throw any exception upon destruction!

Definition at line 275 of file weak.cxx.

◆ OWeakAggObject() [2/2]

cppu::OWeakAggObject::OWeakAggObject ( const OWeakAggObject & rObj )

private

Member Function Documentation

◆ acquire()

void cppu::OWeakAggObject::acquire ( )

virtualnoexcept

If a delegator is set, then the delegators gets acquired.

Otherwise call is delegated to base class cppu::OWeakObject.

Reimplemented from cppu::OWeakObject.

Definition at line 280 of file weak.cxx.

References cppu::OWeakObject::acquire(), x, and xDelegator.

◆ operator=()

OWeakAggObject & cppu::OWeakAggObject::operator= ( const OWeakAggObject & rObj )

private

◆ queryAggregation()

Any cppu::OWeakAggObject::queryAggregation ( const css::uno::Type & rType )

virtual

Called by the delegator or queryInterface.

Re-implement this method instead of queryInterface.

See also: queryInterface

Definition at line 307 of file weak.cxx.

References Any, and cppu::queryInterface().

Referenced by queryInterface().

◆ queryInterface()

Any cppu::OWeakAggObject::queryInterface ( const css::uno::Type & rType )

virtual

If a delegator is set, then the delegator is queried for the demanded interface.

If the delegator cannot provide the demanded interface, it calls queryAggregation() on its aggregated objects.

Parameters

rType demanded interface type

Returns: demanded type or empty any

See also: queryAggregation.

Reimplemented from cppu::OWeakObject.

Definition at line 300 of file weak.cxx.

References Any, queryAggregation(), x, and xDelegator.

◆ release()

void cppu::OWeakAggObject::release ( )

virtualnoexcept

If a delegator is set, then the delegators gets released.

Otherwise call is delegated to base class cppu::OWeakObject.

Reimplemented from cppu::OWeakObject.

Definition at line 290 of file weak.cxx.

References cppu::OWeakObject::release(), x, and xDelegator.

◆ setDelegator()

void cppu::OWeakAggObject::setDelegator ( const css::uno::Reference< css::uno::XInterface > & Delegator )

virtual

Set the delegator.

The delegator member reference is a weak reference.

Parameters

Delegator the object that delegate its queryInterface to this aggregate.

Definition at line 317 of file weak.cxx.

References xDelegator.

Member Data Documentation

◆ xDelegator

css::uno::WeakReferenceHelper cppu::OWeakAggObject::xDelegator

protected

weak reference to delegator.

Definition at line 96 of file weakagg.hxx.

Referenced by acquire(), queryInterface(), release(), and setDelegator().

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ OWeakAggObject() [1/2]

◆ ~OWeakAggObject()

◆ OWeakAggObject() [2/2]

Member Function Documentation

◆ acquire()

◆ operator=()

◆ queryAggregation()

◆ queryInterface()

◆ release()

◆ setDelegator()

Member Data Documentation

◆ xDelegator