Used by administrative clients to view, update, and receive observer updates from the IceGrid registry. More...

#include <IceGrid/IceGrid.h>

Inheritance diagram for IceGrid::AdminSession:

[legend]

Collaboration diagram for IceGrid::AdminSession:

[legend]

Public Types
typedef AdminSessionPtr	PointerType
typedef AdminSessionPrx	ProxyType
Public Types inherited from Glacier2::Session
typedef SessionPtr	PointerType
typedef SessionPrx	ProxyType

Public Member Functions
virtual void	finishUpdate (const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Finish updating the registry and release the exclusive lock.
virtual AdminPrx	getAdmin (const ::Ice::Current &current=::Ice::emptyCurrent) const =0
	Get the admin interface.
virtual::Ice::ObjectPrx	getAdminCallbackTemplate (const ::Ice::Current &current=::Ice::emptyCurrent) const =0
	Get a "template" proxy for admin callback objects.
virtual::std::string	getReplicaName (const ::Ice::Current &current=::Ice::emptyCurrent) const =0
	Get the name of the registry replica hosting this session.
virtual const ::std::string &	ice_id (const ::Ice::Current &current=::Ice::emptyCurrent) const
	Obtains a Slice type ID representing the most-derived interface supported by this object.
virtual ::std::vector< ::std::string >	ice_ids (const ::Ice::Current &current=::Ice::emptyCurrent) const
	Obtains a list of the Slice type IDs representing the interfaces supported by this object.
virtual bool	ice_isA (const ::std::string &id, const ::Ice::Current &current=::Ice::emptyCurrent) const
	Determines whether this object supports an interface with the given Slice type ID.
virtual void	keepAlive (const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Keep the session alive.
virtual FileIteratorPrx	openNodeStdErr (const ::std::string &name, ::Ice::Int count, const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Open the given node stderr file for reading.
virtual FileIteratorPrx	openNodeStdOut (const ::std::string &name, ::Ice::Int count, const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Open the given node stdout file for reading.
virtual FileIteratorPrx	openRegistryStdErr (const ::std::string &name, ::Ice::Int count, const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Open the given registry stderr file for reading.
virtual FileIteratorPrx	openRegistryStdOut (const ::std::string &name, ::Ice::Int count, const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Open the given registry stdout file for reading.
virtual FileIteratorPrx	openServerLog (const ::std::string &id, const ::std::string &path, ::Ice::Int count, const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Open the given server log file for reading.
virtual FileIteratorPrx	openServerStdErr (const ::std::string &id, ::Ice::Int count, const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Open the given server stderr file for reading.
virtual FileIteratorPrx	openServerStdOut (const ::std::string &id, ::Ice::Int count, const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Open the given server stdout file for reading.
virtual void	setObservers (const RegistryObserverPrx &registryObs, const NodeObserverPrx &nodeObs, const ApplicationObserverPrx &appObs, const AdapterObserverPrx &adptObs, const ObjectObserverPrx &objObs, const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Set the observer proxies that receive notifications when the state of the registry or nodes changes.
virtual void	setObserversByIdentity (const ::Ice::Identity &registryObs, const ::Ice::Identity &nodeObs, const ::Ice::Identity &appObs, const ::Ice::Identity &adptObs, const ::Ice::Identity &objObs, const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Set the observer identities that receive notifications the state of the registry or nodes changes.
virtual::Ice::Int	startUpdate (const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Acquires an exclusive lock to start updating the registry applications.
virtual	~AdminSession ()
Public Member Functions inherited from Glacier2::Session
virtual void	destroy (const ::Ice::Current &current=::Ice::emptyCurrent)=0
	Destroy the session.
virtual ::std::vector< ::std::string >	ice_ids (const ::Ice::Current &current=::Ice::emptyCurrent) const
	Obtains a list of the Slice type IDs representing the interfaces supported by this object.
virtual	~Session ()
Public Member Functions inherited from Ice::Object
virtual ObjectPtr	ice_clone () const
	Returns a shallow copy of the object.
virtual void	ice_collectable (bool b)
	Determines whether this object, and by extension the graph of all objects reachable from this object, are eligible for garbage collection when all external references to the graph have been released.
virtual bool	ice_dispatch (Ice::Request &request, const DispatchInterceptorAsyncCallbackPtr &cb=0)
	Dispatches an invocation to a servant.
virtual SlicedDataPtr	ice_getSlicedData () const
	Obtains the sliced data associated with this instance.
virtual const std::string &	ice_id (const Current &current=Ice::emptyCurrent) const
	Returns the Slice type ID of the most-derived interface supported by this object.
virtual std::vector< std::string >	ice_ids (const Current &current=Ice::emptyCurrent) const
	Returns the Slice type IDs of the interfaces supported by this object.
virtual bool	ice_isA (const std::string &s, const Current &current=Ice::emptyCurrent) const
	Tests whether this object supports a specific Slice interface.
virtual Int	ice_operationAttributes (const std::string &operation) const
	Returns the Freeze metadata attributes for an operation.
virtual void	ice_ping (const Current &current=Ice::emptyCurrent) const
	Tests whether this object can be reached.
virtual void	ice_postUnmarshal ()
	The Ice run time invokes this method vafter unmarshaling an object's data members.
virtual void	ice_preMarshal ()
	The Ice run time invokes this method prior to marshaling an object's data members.
virtual bool	operator< (const Object &) const
virtual bool	operator== (const Object &) 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 ()

Static Public Member Functions
static const ::std::string &	ice_staticId ()
	Obtains the Slice type ID corresponding to this class.
Static Public Member Functions inherited from Glacier2::Session
static const ::std::string &	ice_staticId ()
	Obtains the Slice type ID corresponding to this class.
Static Public Member Functions inherited from Ice::Object
static const std::string &	ice_staticId ()
	Obtains the Slice type ID of this type.

Additional Inherited Members
Static Public Attributes inherited from IceUtil::Shared
static const unsigned char	NoDelete
Protected Member Functions inherited from Ice::Object
	Object ()
virtual	~Object ()
Protected Attributes inherited from IceUtil::Shared
unsigned char	_flags
IceUtilInternal::Atomic	_ref

Detailed Description

Used by administrative clients to view, update, and receive observer updates from the IceGrid registry.

Admin sessions are created either via the Registry object or via the registry admin SessionManager object.

See also: Registry

Member Typedef Documentation

◆ PointerType

typedef AdminSessionPtr IceGrid::AdminSession::PointerType

◆ ProxyType

typedef AdminSessionPrx IceGrid::AdminSession::ProxyType

Constructor & Destructor Documentation

◆ ~AdminSession()

virtual IceGrid::AdminSession::~AdminSession ( )

virtual

Member Function Documentation

◆ finishUpdate()

virtual void IceGrid::AdminSession::finishUpdate ( const ::Ice::Current & current = ::Ice::emptyCurrent )

pure virtual

Finish updating the registry and release the exclusive lock.

Parameters

current The Current object for the invocation.

Exceptions

IceGrid::AccessDeniedException Raised if the session doesn't hold the exclusive lock.

◆ getAdmin()

virtual AdminPrx IceGrid::AdminSession::getAdmin ( const ::Ice::Current & current = ::Ice::emptyCurrent ) const

pure virtual

Get the admin interface.

The admin object returned by this operation can only be accessed by the session.

Parameters

current The Current object for the invocation.

Returns: The admin interface proxy.

◆ getAdminCallbackTemplate()

virtual::Ice::ObjectPrx IceGrid::AdminSession::getAdminCallbackTemplate ( const ::Ice::Current & current = ::Ice::emptyCurrent ) const

pure virtual

Get a "template" proxy for admin callback objects.

An Admin client uses this proxy to set the category of its callback objects, and the published endpoints of the object adapter hosting the admin callback objects.

Parameters

current The Current object for the invocation.

Returns: A template proxy. The returned proxy is null when the Admin session was established using Glacier2.

◆ getReplicaName()

virtual::std::string IceGrid::AdminSession::getReplicaName ( const ::Ice::Current & current = ::Ice::emptyCurrent ) const

pure virtual

Get the name of the registry replica hosting this session.

Parameters

current The Current object for the invocation.

Returns: The replica name of the registry.

◆ ice_id()

virtual const ::std::string & IceGrid::AdminSession::ice_id ( const ::Ice::Current & current = ::Ice::emptyCurrent ) const

virtual

Obtains a Slice type ID representing the most-derived interface supported by this object.

Parameters

current The Current object for the invocation.

Returns: A fully-scoped type ID.

Reimplemented from Glacier2::Session.

◆ ice_ids()

virtual ::std::vector< ::std::string > IceGrid::AdminSession::ice_ids ( const ::Ice::Current & current = ::Ice::emptyCurrent ) const

Obtains a list of the Slice type IDs representing the interfaces supported by this object.

Parameters

current The Current object for the invocation.

Returns: A list of fully-scoped type IDs.

◆ ice_isA()

virtual bool IceGrid::AdminSession::ice_isA	(	const ::std::string &	id,
		const ::Ice::Current &	current = ::Ice::emptyCurrent ) const

virtual

Determines whether this object supports an interface with the given Slice type ID.

Parameters

id	The fully-scoped Slice type ID.
current	The Current object for the invocation.

Returns: True if this object supports the interface, false, otherwise.

Reimplemented from Glacier2::Session.

◆ ice_staticId()

const ::std::string & IceGrid::AdminSession::ice_staticId ( )

static

Obtains the Slice type ID corresponding to this class.

Returns: A fully-scoped type ID.

◆ keepAlive()

virtual void IceGrid::AdminSession::keepAlive ( const ::Ice::Current & current = ::Ice::emptyCurrent )

pure virtual

Keep the session alive.

Clients should call this operation regularly to prevent the server from reaping the session.

Parameters

current The Current object for the invocation.

See also: Registry::getSessionTimeout

◆ openNodeStdErr()

virtual FileIteratorPrx IceGrid::AdminSession::openNodeStdErr	(	const ::std::string &	name,
		::Ice::Int	count,
		const ::Ice::Current &	current = ::Ice::emptyCurrent )

pure virtual

Open the given node stderr file for reading.

The file can be read with the returned file iterator.

Parameters

name	The node name.
count	Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last `count` lines.
current	The Current object for the invocation.

Returns: An iterator to read the file.

Exceptions

IceGrid::FileNotAvailableException	Raised if the file can't be read.
IceGrid::NodeNotExistException	Raised if the node doesn't exist.
IceGrid::NodeUnreachableException	Raised if the node could not be reached.

◆ openNodeStdOut()

virtual FileIteratorPrx IceGrid::AdminSession::openNodeStdOut	(	const ::std::string &	name,
		::Ice::Int	count,
		const ::Ice::Current &	current = ::Ice::emptyCurrent )

pure virtual

Open the given node stdout file for reading.

The file can be read with the returned file iterator.

Parameters

name	The node name.
count	Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last `count` lines.
current	The Current object for the invocation.

Returns: An iterator to read the file.

Exceptions

IceGrid::FileNotAvailableException	Raised if the file can't be read.
IceGrid::NodeNotExistException	Raised if the node doesn't exist.
IceGrid::NodeUnreachableException	Raised if the node could not be reached.

◆ openRegistryStdErr()

virtual FileIteratorPrx IceGrid::AdminSession::openRegistryStdErr	(	const ::std::string &	name,
		::Ice::Int	count,
		const ::Ice::Current &	current = ::Ice::emptyCurrent )

pure virtual

Open the given registry stderr file for reading.

The file can be read with the returned file iterator.

Parameters

name	The registry name.
count	Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last `count` lines.
current	The Current object for the invocation.

Returns: An iterator to read the file.

Exceptions

IceGrid::FileNotAvailableException	Raised if the file can't be read.
IceGrid::RegistryNotExistException	Raised if the registry doesn't exist.
IceGrid::RegistryUnreachableException	Raised if the registry could not be reached.

◆ openRegistryStdOut()

virtual FileIteratorPrx IceGrid::AdminSession::openRegistryStdOut	(	const ::std::string &	name,
		::Ice::Int	count,
		const ::Ice::Current &	current = ::Ice::emptyCurrent )

pure virtual

Open the given registry stdout file for reading.

The file can be read with the returned file iterator.

Parameters

name	The registry name.
count	Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last `count` lines.
current	The Current object for the invocation.

Returns: An iterator to read the file.

Exceptions

IceGrid::FileNotAvailableException	Raised if the file can't be read.
IceGrid::RegistryNotExistException	Raised if the registry doesn't exist.
IceGrid::RegistryUnreachableException	Raised if the registry could not be reached.

◆ openServerLog()

virtual FileIteratorPrx IceGrid::AdminSession::openServerLog	(	const ::std::string &	id,
		const ::std::string &	path,
		::Ice::Int	count,
		const ::Ice::Current &	current = ::Ice::emptyCurrent )

pure virtual

Open the given server log file for reading.

The file can be read with the returned file iterator.

Parameters

id	The server id.
path	The path of the log file. A log file can be opened only if it's declared in the server or service deployment descriptor.
count	Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last `count` lines.
current	The Current object for the invocation.

Returns: An iterator to read the file.

Exceptions

IceGrid::DeploymentException	Raised if the server couldn't be deployed on the node.
IceGrid::FileNotAvailableException	Raised if the file can't be read.
IceGrid::NodeUnreachableException	Raised if the node could not be reached.
IceGrid::ServerNotExistException	Raised if the server doesn't exist.

◆ openServerStdErr()

virtual FileIteratorPrx IceGrid::AdminSession::openServerStdErr	(	const ::std::string &	id,
		::Ice::Int	count,
		const ::Ice::Current &	current = ::Ice::emptyCurrent )

pure virtual

Open the given server stderr file for reading.

The file can be read with the returned file iterator.

Parameters

id	The server id.
count	Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last `count` lines.
current	The Current object for the invocation.

Returns: An iterator to read the file.

Exceptions

IceGrid::DeploymentException	Raised if the server couldn't be deployed on the node.
IceGrid::FileNotAvailableException	Raised if the file can't be read.
IceGrid::NodeUnreachableException	Raised if the node could not be reached.
IceGrid::ServerNotExistException	Raised if the server doesn't exist.

◆ openServerStdOut()

virtual FileIteratorPrx IceGrid::AdminSession::openServerStdOut	(	const ::std::string &	id,
		::Ice::Int	count,
		const ::Ice::Current &	current = ::Ice::emptyCurrent )

pure virtual

Open the given server stdout file for reading.

The file can be read with the returned file iterator.

Parameters

id	The server id.
count	Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last `count` lines.
current	The Current object for the invocation.

Returns: An iterator to read the file.

Exceptions

IceGrid::DeploymentException	Raised if the server couldn't be deployed on the node.
IceGrid::FileNotAvailableException	Raised if the file can't be read.
IceGrid::NodeUnreachableException	Raised if the node could not be reached.
IceGrid::ServerNotExistException	Raised if the server doesn't exist.

◆ setObservers()

virtual void IceGrid::AdminSession::setObservers	(	const RegistryObserverPrx &	registryObs,
		const NodeObserverPrx &	nodeObs,
		const ApplicationObserverPrx &	appObs,
		const AdapterObserverPrx &	adptObs,
		const ObjectObserverPrx &	objObs,
		const ::Ice::Current &	current = ::Ice::emptyCurrent )

pure virtual

Set the observer proxies that receive notifications when the state of the registry or nodes changes.

Parameters

registryObs	The registry observer.
nodeObs	The node observer.
appObs	The application observer.
adptObs	The adapter observer.
objObs	The object observer.
current	The Current object for the invocation.

Exceptions

IceGrid::ObserverAlreadyRegisteredException Raised if an observer is already registered with this registry.

◆ setObserversByIdentity()

virtual void IceGrid::AdminSession::setObserversByIdentity	(	const ::Ice::Identity &	registryObs,
		const ::Ice::Identity &	nodeObs,
		const ::Ice::Identity &	appObs,
		const ::Ice::Identity &	adptObs,
		const ::Ice::Identity &	objObs,
		const ::Ice::Current &	current = ::Ice::emptyCurrent )

pure virtual

Set the observer identities that receive notifications the state of the registry or nodes changes.

This operation should be used by clients that are using a bidirectional connection to communicate with the session.

Parameters

registryObs	The registry observer identity.
nodeObs	The node observer identity.
appObs	The application observer.
adptObs	The adapter observer.
objObs	The object observer.
current	The Current object for the invocation.

Exceptions

IceGrid::ObserverAlreadyRegisteredException Raised if an observer is already registered with this registry.

◆ startUpdate()

virtual::Ice::Int IceGrid::AdminSession::startUpdate ( const ::Ice::Current & current = ::Ice::emptyCurrent )

pure virtual

Acquires an exclusive lock to start updating the registry applications.

Parameters

current The Current object for the invocation.

Returns: The current serial.

Exceptions

IceGrid::AccessDeniedException Raised if the exclusive lock can't be acquired. This might happen if the lock is currently acquired by another session.

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

generated/cpp98/x64/Release/IceGrid/Admin.h

Public Types

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ PointerType

◆ ProxyType

Constructor & Destructor Documentation

◆ ~AdminSession()

Member Function Documentation

◆ finishUpdate()

◆ getAdmin()

◆ getAdminCallbackTemplate()

◆ getReplicaName()

◆ ice_id()

◆ ice_ids()

◆ ice_isA()

◆ ice_staticId()

◆ keepAlive()

◆ openNodeStdErr()

◆ openNodeStdOut()

◆ openRegistryStdErr()

◆ openRegistryStdOut()

◆ openServerLog()

◆ openServerStdErr()

◆ openServerStdOut()

◆ setObservers()

◆ setObserversByIdentity()

◆ startUpdate()