IT_Bus::ClientProxyBase Class Reference

#include <it_bus/client_proxy_base.h>

List of all members.

---

Detailed Description

Base class for proxy code generated from a port type.

Use an instance of this base class if the client application needs to construct an operation call without using a generated proxy.

Definition at line 38 of file client_proxy_base.h.

Public Member Functions
	ClientProxyBase (const IT_Bus::String &wsdl, const IT_Bus::QName &service_name, const IT_Bus::String &port_name=String::EMPTY, IT_Bus::Bus *bus=0)
	Constructor.
	ClientProxyBase (const WS_Addressing::EndpointReferenceType &epr_ref, IT_Bus::Bus_ptr bus=0)
	Constructor.
	ClientProxyBase (const WS_Addressing::EndpointReferenceType &epr_ref, const IT_Bus::String &wsdl_location, const IT_Bus::QName &service_name, const IT_Bus::String &port_name, IT_Bus::Bus_ptr bus=0)
	Constructor.
	ClientProxyBase (const IT_Bus::QName &service_name, const IT_Bus::String &port_name=String::EMPTY, IT_Bus::Bus_ptr bus=0)
	Constructor.
	ClientProxyBase (const IT_Bus::Reference &reference, const IT_Bus::String &port_name=String::EMPTY, IT_Bus::Bus_ptr bus=0)
	Constructor.
	ClientProxyBase (const IT_Bus::EndpointReference &epr, IT_Bus::Bus_ptr bus=0)
	Constructor.
virtual	~ClientProxyBase ()
	Destructor.
virtual Bus_ptr	get_bus ()
	Returns a pointer to the IT_Bus::Bus.
virtual Port &	get_port ()
	Returns a reference to the proxy's IT_Bus::Port.
virtual ClientService &	_get_service ()
	Obtain a reference to the object that represents the service within a client application.
virtual ClientOperation *	create_operation (const String &operation_name) IT_THROW_DECL((Exception))
	Creates a ClientOperation object for the specified operation.
IT_Bus::String	get_wsdl_location ()
	Obtain the location of the WSDL file used to initialize the proxy (or client proxy base) instance.
Private Attributes
ClientProxyDelegate *	m_delegate

---

Constructor & Destructor Documentation

IT_Bus::ClientProxyBase::ClientProxyBase	(	const IT_Bus::String &	wsdl,
		const IT_Bus::QName &	service_name,
		const IT_Bus::String &	port_name = String::EMPTY,
		IT_Bus::Bus *	bus = 0
	)

Constructor.

This version of the constructor is invoked by three of the constructors generated into each proxy. If the application code does not invoke the proxy constructors with a valid pointer to the Bus, the code within this base class uses the static Bus::create_reference() method to obtain a pointer to the Bus.

IT_Bus::ClientProxyBase::ClientProxyBase	(	const WS_Addressing::EndpointReferenceType &	epr_ref,
		IT_Bus::Bus_ptr	bus = 0
	)

Constructor.

This version of the constructor is invoked by the proxy constructor that requires an EndpointReferenceType and Bus. If the application code does not invoke the proxy constructor with a valid pointer to the Bus, the code within this base class uses the static Bus::create_reference() method to obtain a pointer to the Bus.

IT_Bus::ClientProxyBase::ClientProxyBase	(	const WS_Addressing::EndpointReferenceType &	epr_ref,
		const IT_Bus::String &	wsdl_location,
		const IT_Bus::QName &	service_name,
		const IT_Bus::String &	port_name,
		IT_Bus::Bus_ptr	bus = 0
	)

Constructor.

This version of the constructor is invoked by the proxy constructor that requires an EndpointReferenceType, wsdl_location, service name and port name as arguments. If the application code does not invoke the proxy constructor with a valid pointer to the Bus, the code within this base class uses the static Bus::create_reference() method to obtain a pointer to the Bus.

If this constructor is used for acessing SOAP service, the proxy is configured to use specified port difinition within the service definition. For non-SOAP services, the proxy is configured to use specified port definition within the service definition. The information contained in the constructs of <wsa:EndpointReference> takes precedence over out of band data

IT_Bus::ClientProxyBase::ClientProxyBase	(	const IT_Bus::QName &	service_name,
		const IT_Bus::String &	port_name = String::EMPTY,
		IT_Bus::Bus_ptr	bus = 0
	)

Constructor.

This version of the constructor is invoked by the proxy constructor that requires a QName and a Bus. This constructor is not provided with enough details to create the endpoint intentionally and it tells the Bus to use resolve_initial_reference to obtain the endpoint details. If this endpoint fails at any stage this proxy will attempt to re-establish the endpoint using Bus::resolve_initial_reference again.

If the application code does not invoke the proxy constructor with a valid pointer to the Bus, the code within this base class uses the static Bus::create_reference() method to obtain a pointer to the Bus.

IT_Bus::ClientProxyBase::ClientProxyBase	(	const IT_Bus::Reference &	reference,
		const IT_Bus::String &	port_name = String::EMPTY,
		IT_Bus::Bus_ptr	bus = 0
	)

Constructor.

This version of the constructor is not used by the constructor code generated into each proxy. To use this constructor, the generated proxy code must be edited.

If the application code does not invoke the proxy constructor with a valid pointer to the Bus, the code within this base class uses the static Bus::create_reference() method to obtain a pointer to the Bus.

IT_Bus::ClientProxyBase::ClientProxyBase	(	const IT_Bus::EndpointReference &	epr,
		IT_Bus::Bus_ptr	bus = 0
	)

Constructor.

This version of the constructor is not used by the constructor code generated into each proxy. To use this constructor, the generated proxy code must be edited.

---

Member Function Documentation

virtual ClientService& IT_Bus::ClientProxyBase::_get_service

(

)

[virtual]

Obtain a reference to the object that represents the service within a client application.

Returns:

A reference to the service.

virtual ClientOperation* IT_Bus::ClientProxyBase::create_operation

(

const String &

operation_name

)

[virtual]

Creates a ClientOperation object for the specified operation.

Use the ClientOperation object to construct an operation call without using proxy code generated from a WSDL file.

Parameters:

String

containing the name of the desired operation.

virtual Bus_ptr IT_Bus::ClientProxyBase::get_bus

(

)

[virtual]

Returns a pointer to the IT_Bus::Bus.

Returns:

Pointer to the Bus.

virtual Port& IT_Bus::ClientProxyBase::get_port

(

)

[virtual]

Returns a reference to the proxy's IT_Bus::Port.

Application code may use the Port instance to obtain transport configuration information.

IT_Bus::String IT_Bus::ClientProxyBase::get_wsdl_location

(

)

Obtain the location of the WSDL file used to initialize the proxy (or client proxy base) instance.

Returns:

String containing the URL of the WSDL file.

---