ACE_Dynamic_Service_Dependency Class Reference

Provides a way to declare dependency on specific service, thus helping to avoid order of initialization issues with instances of an objects whose implementation code resides in dynamically loaded services. More...

#include <Dynamic_Service_Dependency.h>

Collaboration diagram for ACE_Dynamic_Service_Dependency:

Public Member Functions
	ACE_Dynamic_Service_Dependency (const ACE_Service_Gestalt *cfg, const ACE_TCHAR *principal)
	ACE_Dynamic_Service_Dependency (const ACE_TCHAR *principal)
	~ACE_Dynamic_Service_Dependency (void)

Private Member Functions
void	init (const ACE_Service_Gestalt *cfg, const ACE_TCHAR *principal)

Private Attributes
ACE_DLL	tracker_

Detailed Description

Provides a way to declare dependency on specific service, thus helping to avoid order of initialization issues with instances of an objects whose implementation code resides in dynamically loaded services.

It is disastrous to have dynamically loadable services create and give away ownership of objects and then ending up being unloaded before all those instances have been deleted. Normally the code for such objects classes resides within the TEXT segment of the DLL, which implements the service. If a service gets removed, its DLL may be unmapped from memory and then any attempt to invoke a method on the said objects will cause SEGV.

Such instances must contain a member of ACE_Dynamic_Service_Dependency initialized with the service they depend on. ACE_Dynamic_Service_Dependency's constructor and destructor are "magical" - they work by maintaining the underlying dynamic service's DLL reference count.

Constructor & Destructor Documentation

ACE_Dynamic_Service_Dependency::ACE_Dynamic_Service_Dependency	(	const ACE_Service_Gestalt *	cfg,
		const ACE_TCHAR *	principal
	)

ACE_Dynamic_Service_Dependency::ACE_Dynamic_Service_Dependency

(

const ACE_TCHAR *

principal

)

ACE_Dynamic_Service_Dependency::~ACE_Dynamic_Service_Dependency

(

void

)

Member Function Documentation

void ACE_Dynamic_Service_Dependency::init ( const ACE_Service_Gestalt *  cfg, const ACE_TCHAR *  principal  )

private

Member Data Documentation

ACE_DLL ACE_Dynamic_Service_Dependency::tracker_

private

---

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

• Dynamic_Service_Dependency.h
• Dynamic_Service_Dependency.cpp