Ice::PluginManager Class Reference

Each communicator has a plug-in manager to administer the set of plug-ins. More...

#include <Ice/Ice.h>

Inheritance diagram for Ice::PluginManager:

Collaboration diagram for Ice::PluginManager:

Public Types
typedef PluginManagerPtr	PointerType

Public Member Functions
virtual void	addPlugin (const ::std::string &name, const PluginPtr &pi)=0
	Install a new plug-in.
virtual void	destroy () throw () =0
	Called when the communicator is being destroyed.
virtual PluginPtr	getPlugin (const ::std::string &name)=0
	Obtain a plug-in by name.
virtual StringSeq	getPlugins () throw () =0
	Get a list of plugins installed.
virtual void	initializePlugins ()=0
	Initialize the configured plug-ins.
virtual	~PluginManager ()
Public Member Functions inherited from Ice::LocalObject
virtual bool	operator< (const LocalObject &) const
virtual bool	operator== (const LocalObject &) const
Public Member Functions inherited from IceUtil::Shared
void	__clearFlag (unsigned char flag)
virtual void	__decRef ()
virtual int	__getRef () const
bool	__hasFlag (unsigned char flag)
virtual void	__incRef ()
void	__setFlag (unsigned char flag)
virtual void	__setNoDelete (bool)
Shared &	operator= (const Shared &)
	Shared ()
	Shared (const Shared &)
virtual	~Shared ()

Additional Inherited Members
Static Public Attributes inherited from IceUtil::Shared
static const unsigned char	NoDelete
Protected Attributes inherited from IceUtil::Shared
unsigned char	_flags
IceUtilInternal::Atomic	_ref

Detailed Description

Each communicator has a plug-in manager to administer the set of plug-ins.

Member Typedef Documentation

PointerType

typedef PluginManagerPtr Ice::PluginManager::PointerType

Constructor & Destructor Documentation

~PluginManager()

virtual Ice::PluginManager::~PluginManager ( )

virtual

Member Function Documentation

addPlugin()

virtual void Ice::PluginManager::addPlugin ( const ::std::string & name, const PluginPtr & pi )

pure virtual

Install a new plug-in.

Parameters

name	The plug-in's name.
pi	The plug-in.

Exceptions

AlreadyRegisteredException

Raised if a plug-in already exists with the given name.

destroy()

virtual void Ice::PluginManager::destroy ( ) throw (  )

pure virtual

Called when the communicator is being destroyed.

getPlugin()

virtual PluginPtr Ice::PluginManager::getPlugin ( const ::std::string & name )

pure virtual

Obtain a plug-in by name.

Parameters

name	The plug-in's name.

Returns

The plug-in.

Exceptions

NotRegisteredException

Raised if no plug-in is found with the given name.

getPlugins()

virtual StringSeq Ice::PluginManager::getPlugins ( ) throw (  )

pure virtual

Get a list of plugins installed.

Returns

The names of the plugins installed.

See also

getPlugin

initializePlugins()

virtual void Ice::PluginManager::initializePlugins ( )

pure virtual

Initialize the configured plug-ins.

The communicator automatically initializes the plug-ins by default, but an application may need to interact directly with a plug-in prior to initialization. In this case, the application must set Ice.InitPlugins=0 and then invoke initializePlugins manually. The plug-ins are initialized in the order in which they are loaded. If a plug-in raises an exception during initialization, the communicator invokes destroy on the plug-ins that have already been initialized.

Exceptions

InitializationException

Raised if the plug-ins have already been initialized.

---

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

• generated/cpp98/x64/Release/Ice/Plugin.h