IT_Bus::Bus Class Reference

#include <it_bus/bus.h>

Inheritance diagram for IT_Bus::Bus:

List of all members.

---

Detailed Description

The IT_Bus::Bus class manages a collection of plugins, which provide the underlying functional capabilities of a Bus application.

The Bus provides integration between the application components generated from the WSDL file and the Bus runtime environment.

Bus plugins provide functionality for data marshalling, transport specifics, security, implementation of and integration with enterprise services such as logging and session management, routing, and access to raw and encoded messages.

Definition at line 53 of file bus.h.

Public Member Functions
virtual void	run ()=0
	Put event processing into an infinite loop to prevent the current thread from exiting.
virtual Service_ptr	get_service (const QName &service_name)=0
	Obtain a pointer to a specific service.
virtual void	remove_service (const QName &service_name)=0
	Inactivate and destroy a specific service.
virtual void	populate_endpoint_reference (const IT_WSDL::WSDLService &service, Reference &endpoint_reference)=0
	Create a Service Reference for a specific service.
virtual IT_Bus::Boolean	register_initial_reference (const Reference &service_reference) IT_THROW_DECL((Exception))=0
	Register a Service Reference with the Bus so that others can resolve it using Bus::resolve_initial_reference.
virtual IT_Bus::Boolean	unregister_initial_reference (const QName &service_name) IT_THROW_DECL((Exception))=0
	Remove the Reference from the Bus so that others can no longer resolve it using resolve_initial_reference.
virtual IT_Bus::Boolean	resolve_initial_reference (const QName &service_name, Reference &endpoint_reference) IT_THROW_DECL((Exception))=0
	Find or resolve a Service Reference for a specific service.
virtual void	populate_endpoint_reference (const IT_WSDL::WSDLService &service, WS_Addressing::EndpointReferenceType &epr_reference)=0
	Create EndpointReferenceType to a specific service.
virtual IT_Bus::Boolean	resolve_initial_reference (const QName &service_name, WS_Addressing::EndpointReferenceType &epr_reference) IT_THROW_DECL((Exception))=0
	Find or resolve a Service EndpointReferenceType for a specific service.
virtual IT_Bus::Boolean	register_initial_reference (const WS_Addressing::EndpointReferenceType &service_epr) IT_THROW_DECL((Exception))=0
	Register a Service EndpointReferenceType with the Bus so that others can resolve it using Bus::resolve_initial_reference.
virtual PDKBus *	get_pdk_bus ()=0
	Return a pointer to the PDKBus instance associated with this bus.
Static Public Member Functions
static Bus *	create_reference (CORBA::ORB *orb=0)
	Return a pointer to the active Bus.
static void	release_reference (Bus *bus)
	Release memory associated with Bus.
static Bus *	_duplicate (Bus *bus)
	Increment the reference count for the memory associated with the Bus and return a pointer to the Bus.
Protected Member Functions
	Bus ()
	Constructor.
virtual	~Bus ()
	Destructor.

---

Constructor & Destructor Documentation

IT_Bus::Bus::Bus

(

)

[protected]

Constructor.

Not called by application code. Applications initialize a Bus instance and obtain a pointer to the Bus instance by invoking the method IT_Bus::init, which is defined within the IT_Bus namespace in the file bus.h.

 Bus_var init(
   int& argc,
   char* argv[],
   const char* orb_identifier = ""
 );
 

virtual IT_Bus::Bus::~Bus

(

)

[protected, virtual]

Destructor.

Not called by application code. Applications destroy a Bus instance by invoking the method IT_Bus::shutdown, which is defined within the IT_Bus namespace in the file bus.h.

 void shutdown(
   IT_Bool wait_for_completion = true
 ) IT_THROW_DECL((IT_Bus::Exception));
 

---

Member Function Documentation

static Bus* IT_Bus::Bus::_duplicate

(

Bus *

bus

)

[static]

Increment the reference count for the memory associated with the Bus and return a pointer to the Bus.

Parameters:

Pointer

to IT_Bus::Bus

Returns:

Pointer to IT_Bus::Bus

static Bus* IT_Bus::Bus::create_reference

(

CORBA::ORB *

orb = 0

)

[static]

Return a pointer to the active Bus.

Parameters:

Default

null.

Returns:

IT_Bus::Bus

virtual PDKBus* IT_Bus::Bus::get_pdk_bus

(

)

[pure virtual]

Return a pointer to the PDKBus instance associated with this bus.

The PDKBus implements some of the core and service functionality of the Bus class.

Returns:

A pointer to an instance of PDKBus.

virtual Service_ptr IT_Bus::Bus::get_service

(

const QName &

service_name

)

[pure virtual]

Obtain a pointer to a specific service.

Parameters:

QName

of the desired service.

Returns:

Pointer to the Service.

virtual void IT_Bus::Bus::populate_endpoint_reference	(	const IT_WSDL::WSDLService &	service,
		WS_Addressing::EndpointReferenceType &	epr_reference
	)			[pure virtual]

Create EndpointReferenceType to a specific service.

Parameters:

	IT_WSDL::WSDLService	object corresponding to the in-memory representation of the service.
	EndpointReferenceType	to the Service; NOTE that this is an out parameter.

virtual void IT_Bus::Bus::populate_endpoint_reference	(	const IT_WSDL::WSDLService &	service,
		Reference &	endpoint_reference
	)			[pure virtual]

Create a Service Reference for a specific service.

Parameters:

	IT_WSDL::WSDLService	object corresponding to the in-memory representation of the service.
	Reference	to the Service; NOTE that this is an out parameter.

virtual IT_Bus::Boolean IT_Bus::Bus::register_initial_reference

(

const WS_Addressing::EndpointReferenceType &

service_epr

)

[pure virtual]

Register a Service EndpointReferenceType with the Bus so that others can resolve it using Bus::resolve_initial_reference.

Parameters:

EndpointReferenceType

to the Service being registered.

virtual IT_Bus::Boolean IT_Bus::Bus::register_initial_reference

(

const Reference &

service_reference

)

[pure virtual]

Register a Service Reference with the Bus so that others can resolve it using Bus::resolve_initial_reference.

Parameters:

Reference

to the Service being registered.

virtual void IT_Bus::Bus::remove_service

(

const QName &

service_name

)

[pure virtual]

Inactivate and destroy a specific service.

Parameters:

QName

of the service to remove.

virtual IT_Bus::Boolean IT_Bus::Bus::resolve_initial_reference	(	const QName &	service_name,
		WS_Addressing::EndpointReferenceType &	epr_reference
	)			[pure virtual]

Find or resolve a Service EndpointReferenceType for a specific service.

Parameters:

	QName	of the service to resolve/find.
	EndpointReferenceType	to the Service; NOTE that this is an out parameter and can not be used to instantiate a client proxy to communicate with the Service.

virtual IT_Bus::Boolean IT_Bus::Bus::resolve_initial_reference	(	const QName &	service_name,
		Reference &	endpoint_reference
	)			[pure virtual]

Find or resolve a Service Reference for a specific service.

Parameters:

	QName	of the service to resolve/find.
	Reference	to the Service; NOTE that this is an out parameter and can not be used to instantiate a client proxy to communicate with the Service.

virtual void IT_Bus::Bus::run

(

)

[pure virtual]

Put event processing into an infinite loop to prevent the current thread from exiting.

It is not necessary to call run() to process incoming requests; run prevents the process from exiting. Once a servant is registered with the Bus, it will receive incoming requests.

virtual IT_Bus::Boolean IT_Bus::Bus::unregister_initial_reference

(

const QName &

service_name

)

[pure virtual]

Remove the Reference from the Bus so that others can no longer resolve it using resolve_initial_reference.

This assumes that user has previously called Bus::register_initial_reference

Parameters:

Reference

to the Service being unregistered.

---