This class implements the interface Engines::DSC. More...

#include <DSC_interface.hxx>

Inheritance diagram for Engines_DSC_interface:

Data Structures
struct	port_t

Public Member Functions
	Engines_DSC_interface ()

virtual	~Engines_DSC_interface ()

virtual void	add_provides_port (Ports::Port_ptr ref, const char *provides_port_name, Ports::PortProperties_ptr port_prop) throw (Engines::DSC::PortAlreadyDefined, Engines::DSC::NilPort, Engines::DSC::BadProperty)

virtual void	add_uses_port (const char repository_id, const char uses_port_name, Ports::PortProperties_ptr port_prop) throw (Engines::DSC::PortAlreadyDefined, Engines::DSC::BadProperty)

virtual Ports::Port_ptr	get_provides_port (const char *provides_port_name, const CORBA::Boolean connection_error) throw (Engines::DSC::PortNotDefined, Engines::DSC::PortNotConnected, Engines::DSC::BadPortType)

virtual Engines::DSC::uses_port *	get_uses_port (const char *uses_port_name) throw (Engines::DSC::PortNotDefined, Engines::DSC::PortNotConnected, Engines::DSC::BadPortType)

virtual void	connect_provides_port (const char *provides_port_name) throw (Engines::DSC::PortNotDefined)

virtual void	connect_uses_port (const char *uses_port_name, Ports::Port_ptr provides_port_ref) throw (Engines::DSC::PortNotDefined, Engines::DSC::BadPortType, Engines::DSC::NilPort)

virtual CORBA::Boolean	is_connected (const char *port_name) throw (Engines::DSC::PortNotDefined)

virtual void	disconnect_provides_port (const char *provides_port_name, const Engines::DSC::Message message) throw (Engines::DSC::PortNotDefined, Engines::DSC::PortNotConnected)

virtual void	disconnect_uses_port (const char *uses_port_name, Ports::Port_ptr provides_port_ref, const Engines::DSC::Message message) throw (Engines::DSC::PortNotDefined, Engines::DSC::PortNotConnected, Engines::DSC::BadPortReference)

virtual Ports::PortProperties_ptr	get_port_properties (const char *port_name) throw (Engines::DSC::PortNotDefined)

virtual void	provides_port_changed (const char *provides_port_name, int connection_nbr, const Engines::DSC::Message message)=0
	This method is used by the component when the number of connection on a provides port changes. More...

virtual void	uses_port_changed (const char uses_port_name, Engines::DSC::uses_port new_uses_port, const Engines::DSC::Message message)=0
	This method is used by the component when the number of connection on a uses port changes. More...

Static Public Member Functions
static void	writeEvent (const char request, const std::string &containerName, const char instance_name, const char port_name, const char error, const char *message)
	Write a record in the trace file. More...

Protected Types
enum	port_type { uses, provides, none }

typedef std::map< std::string, port_t * >	ports

Protected Attributes
ports	my_ports

ports::iterator	my_ports_it

Detailed Description

This class implements the interface Engines::DSC.

This class is used by the sequential DSC implementation and the parallel DSC implementation.

Member Typedef Documentation

typedef std::map<std::string, port_t *> Engines_DSC_interface::ports

protected

Member Enumeration Documentation

enum Engines_DSC_interface::port_type

protected

Enumerator
uses
provides
none

Constructor & Destructor Documentation

Engines_DSC_interface::Engines_DSC_interface ( )

Engines_DSC_interface::~Engines_DSC_interface ( )

virtual

References my_ports, and my_ports_it.

Member Function Documentation

void Engines_DSC_interface::add_provides_port	(	Ports::Port_ptr	ref,
		const char *	provides_port_name,
		Ports::PortProperties_ptr	port_prop
	)		throw (Engines::DSC::PortAlreadyDefined, Engines::DSC::NilPort, Engines::DSC::BadProperty)

virtual

See Also: Engines::DSC::add_provides_port

Reimplemented in Engines_DSC_i, and Engines_ParallelDSC_i.

References Engines_DSC_interface::port_t::connection_nbr, Engines_DSC_interface::port_t::port_prop, Engines_DSC_interface::port_t::provides_port_ref, and Engines_DSC_interface::port_t::type.

Referenced by Superv_Component_i::add_port(), Engines_ParallelDSC_i::add_provides_port(), Engines_DSC_i::add_provides_port(), and Engines_ParallelDSC_i::set_paco_proxy().

void Engines_DSC_interface::add_uses_port	(	const char *	repository_id,
		const char *	uses_port_name,
		Ports::PortProperties_ptr	port_prop
	)		throw (Engines::DSC::PortAlreadyDefined, Engines::DSC::BadProperty)

virtual

See Also: Engines::DSC::add_uses_port

Reimplemented in Engines_DSC_i, and Engines_ParallelDSC_i.

References Engines_DSC_interface::port_t::connection_nbr, Engines_DSC_interface::port_t::port_prop, Engines_DSC_interface::port_t::repository_id, Engines_DSC_interface::port_t::type, and Engines_DSC_interface::port_t::uses_port_refs.

Referenced by Superv_Component_i::add_port(), Engines_ParallelDSC_i::add_uses_port(), and Engines_DSC_i::add_uses_port().

void Engines_DSC_interface::connect_provides_port ( const char * provides_port_name ) throw (Engines::DSC::PortNotDefined)

virtual

See Also: Engines::DSC::connect_provides_port

Note: This method uses Callbacks mechanism to inform the provides port how much uses ports are connected with. Currently, the provides port doesn't know its uses ports references. It's framework or application role to manage connections between ports.

Reimplemented in Engines_DSC_i, and Engines_ParallelDSC_i.

References Engines::DSC::AddingConnection.

Referenced by Engines_ParallelDSC_i::connect_provides_port(), and Engines_DSC_i::connect_provides_port().

void Engines_DSC_interface::connect_uses_port	(	const char *	uses_port_name,
		Ports::Port_ptr	provides_port_ref
	)		throw (Engines::DSC::PortNotDefined, Engines::DSC::BadPortType, Engines::DSC::NilPort)

virtual

See Also: Engines::DSC::connect_uses_port

Note: This method uses Callbacks mechanism to inform the uses port how much provides ports are connected with.

Reimplemented in Engines_DSC_i, and Engines_ParallelDSC_i.

References Engines::DSC::AddingConnection, Engines::DSC::BadPortType::expected, and Engines::DSC::BadPortType::received.

Referenced by Engines_ParallelDSC_i::connect_uses_port(), and Engines_DSC_i::connect_uses_port().

void Engines_DSC_interface::disconnect_provides_port	(	const char *	provides_port_name,
		const Engines::DSC::Message	message
	)		throw (Engines::DSC::PortNotDefined, Engines::DSC::PortNotConnected)

virtual

See Also: Engines::DSC::disconnect_provides_port

Note: This method uses Callbacks mechanism to inform the provides port how much uses ports are connected with. Currently, the provides port doesn't know its uses ports references. It's framework or application role to manage connections between ports.

Reimplemented in Engines_DSC_i, and Engines_ParallelDSC_i.

Referenced by Engines_ParallelDSC_i::disconnect_provides_port(), and Engines_DSC_i::disconnect_provides_port().

void Engines_DSC_interface::disconnect_uses_port	(	const char *	uses_port_name,
		Ports::Port_ptr	provides_port_ref,
		const Engines::DSC::Message	message
	)		throw (Engines::DSC::PortNotDefined, Engines::DSC::PortNotConnected, Engines::DSC::BadPortReference)

virtual

See Also: Engines::DSC::disconnect_uses_port

Note: This method uses Callbacks mechanism to inform the uses port how much provides ports are connected with.

Warning: The new sequence of the uses port is sended by the callback. The old sequence is not destoyed. Is uses port user's role to destroy the sequence.

Reimplemented in Engines_DSC_i, and Engines_ParallelDSC_i.

Referenced by Engines_ParallelDSC_i::disconnect_uses_port(), and Engines_DSC_i::disconnect_uses_port().

Ports::PortProperties_ptr Engines_DSC_interface::get_port_properties ( const char * port_name ) throw (Engines::DSC::PortNotDefined)

virtual

See Also: Engines::DSC::get_port_properties

Reimplemented in Engines_DSC_i, and Engines_ParallelDSC_i.

Referenced by Engines_ParallelDSC_i::get_port_properties(), and Engines_DSC_i::get_port_properties().

Ports::Port_ptr Engines_DSC_interface::get_provides_port	(	const char *	provides_port_name,
		const CORBA::Boolean	connection_error
	)		throw (Engines::DSC::PortNotDefined, Engines::DSC::PortNotConnected, Engines::DSC::BadPortType)

virtual

See Also: Engines::DSC::get_provides_port

Reimplemented in Engines_DSC_i, and Engines_ParallelDSC_i.

References Engines::DSC::BadPortType::expected, and Engines::DSC::BadPortType::received.

Referenced by Superv_Component_i::get_port(), Engines_ParallelDSC_i::get_provides_port(), Engines_DSC_i::get_provides_port(), and Engines_ParallelDSC_i::get_proxy().

Engines::DSC::uses_port * Engines_DSC_interface::get_uses_port ( const char * uses_port_name ) throw (Engines::DSC::PortNotDefined, Engines::DSC::PortNotConnected, Engines::DSC::BadPortType)

virtual

See Also: Engines::DSC::get_uses_port

Reimplemented in Engines_DSC_i, and Engines_ParallelDSC_i.

References Engines::DSC::BadPortType::expected, and Engines::DSC::BadPortType::received.

Referenced by Engines_ParallelDSC_i::get_uses_port(), and Engines_DSC_i::get_uses_port().

CORBA::Boolean Engines_DSC_interface::is_connected ( const char * port_name ) throw (Engines::DSC::PortNotDefined)

virtual

See Also: Engines::DSC::is_connected

Reimplemented in Engines_DSC_i, and Engines_ParallelDSC_i.

Referenced by Engines_ParallelDSC_i::is_connected(), and Engines_DSC_i::is_connected().

virtual void DSC_Callbacks::provides_port_changed	(	const char *	provides_port_name,
		int	connection_nbr,
		const Engines::DSC::Message	message
	)

pure virtualinherited

This method is used by the component when the number of connection on a provides port changes.

  This information helps the user code to detect operation on its ports.

Parameters

provides_port_name	the name of the provides name that has changed.
connection_nbr	the new number of connection on the provides port.
message	contains informations about the modification of the port.

Implemented in Superv_Component_i.

virtual void DSC_Callbacks::uses_port_changed	(	const char *	uses_port_name,
		Engines::DSC::uses_port *	new_uses_port,
		const Engines::DSC::Message	message
	)

pure virtualinherited

This method is used by the component when the number of connection on a uses port changes.

  This information helps the user code to detect operation on its ports.

Parameters

uses_port_name	the name of the uses name that has changed.
new_uses_port	the new sequence representing the uses port.
message	contains informations about the modification of the port.

Implemented in Superv_Component_i.

void Engines_DSC_interface::writeEvent	(	const char *	request,
		const std::string &	containerName,
		const char *	instance_name,
		const char *	port_name,
		const char *	error,
		const char *	message
	)

static

Write a record in the trace file.

Parameters

request	the name of the request executed
containerName	the name of the container where the request is executed
instance_name	the name of the component where the request is executed
port_name	the name of the port that is concerned
error	if an error has occured, a string that identifies the error
message	informations about error or about the request