CosTrading::Register Interface Reference

This interface is used export offers of service to the trader and manage these offers. More...

import "CosTrading.idl";

Inherits CosTrading::TraderComponents, and CosTrading::SupportAttributes.

List of all members.

Public Member Functions
OfferId	export (in Object reference, in ServiceTypeName type, in PropertySeq properties) raises ( InvalidObjectRef, IllegalServiceType, UnknownServiceType, InterfaceTypeMismatch, IllegalPropertyName, PropertyTypeMismatch, ReadonlyDynamicProperty, MissingMandatoryProperty, DuplicatePropertyName )
	This operation exports an offer of service to the trader with a set of properties it supports.
void	withdraw (in OfferId id) raises ( IllegalOfferId, UnknownOfferId, ProxyOfferId )
	This operation withdraws an offer of service from the trader.
OfferInfo	describe (in OfferId id) raises ( IllegalOfferId, UnknownOfferId, ProxyOfferId )
	This operation describes an offer of service from the trader.
void	modify (in OfferId id, in PropertyNameSeq del_list, in PropertySeq modify_list) raises ( NotImplemented, IllegalOfferId, UnknownOfferId, ProxyOfferId, IllegalPropertyName, UnknownPropertyName, PropertyTypeMismatch, ReadonlyDynamicProperty, MandatoryProperty, ReadonlyProperty, DuplicatePropertyName )
	This operation modifies the properties supported by a traded offer of service.
void	withdraw_using_constraint (in ServiceTypeName type, in Constraint constr) raises ( IllegalServiceType, UnknownServiceType, IllegalConstraint, NoMatchingOffers )
	This operation withdraws any offers matching the specified constraints.
Register	resolve (in TraderName name) raises ( IllegalTraderName, UnknownTraderName, RegisterNotSupported )
	This opreration resolves the Register interface of a linked trader.
Classes
exception	IllegalTraderName
exception	InterfaceTypeMismatch
exception	InvalidObjectRef
exception	MandatoryProperty
exception	NoMatchingOffers
struct	OfferInfo
	This structure holds information about an offer. More...
exception	ProxyOfferId
exception	ReadonlyProperty
exception	RegisterNotSupported
exception	UnknownPropertyName
exception	UnknownTraderName

---

Detailed Description

This interface is used export offers of service to the trader and manage these offers.

---

Member Function Documentation

OfferInfo CosTrading::Register::describe

(

in OfferId

id

)

raises ( IllegalOfferId, UnknownOfferId, ProxyOfferId )

This operation describes an offer of service from the trader.

Returns:

- An offer descriptor structure.

Parameters:

id

- The identifier of the offer to be described.

IllegalOfferId - If the format of the offer identifier is invalid. UnknownOfferId - If the trader knows nothing of the identified offer. ProxyOfferId - The trader cannot describe the proxy offer.

OfferId CosTrading::Register::export	(	in Object	reference,
		in ServiceTypeName	type,
		in PropertySeq	properties
	)			raises ( InvalidObjectRef, IllegalServiceType, UnknownServiceType, InterfaceTypeMismatch, IllegalPropertyName, PropertyTypeMismatch, ReadonlyDynamicProperty, MissingMandatoryProperty, DuplicatePropertyName )

This operation exports an offer of service to the trader with a set of properties it supports.

Returns:

- An offer identifier.

Parameters:

	reference	- The object making the offer.
	type	- The service type name of the offer.
	properties	- A sequence of supported properties.

InvalidObjectRef - If the object reference is not valid. IllegalServiceType - If the specified service type name is invalid. UnknownServiceType - If the specified service type has not been registered. InterfaceTypeMismatch - The object does not support the interface specified in the service definition. IllegalPropertyName - If a property name is illegal. DuplicatePropertyName - If duplicate property names are specified. PropertyTypeMismatch - If the type of a property does not match the type specified in the service definition. ReadonlyDynamicProperty - If an attempt has been made to assign a dynamic property value to a property defined as read-only in the service definition. MissingMandatoryProperty - If a property defined as mandatory in the service definition has not been supplied.

void CosTrading::Register::modify	(	in OfferId	id,
		in PropertyNameSeq	del_list,
		in PropertySeq	modify_list
	)			raises ( NotImplemented, IllegalOfferId, UnknownOfferId, ProxyOfferId, IllegalPropertyName, UnknownPropertyName, PropertyTypeMismatch, ReadonlyDynamicProperty, MandatoryProperty, ReadonlyProperty, DuplicatePropertyName )

This operation modifies the properties supported by a traded offer of service.

Properties that are read-only or mandatory may not be deleted and properties that are read-only may not be modified.

Parameters:

	id	- The identifier of the offer to be modified.
	del_list	- The list of properties to be deleted.
	modify_list	- The list of properties to be added or modified.

NotImplemented - If this operation is not implemented by the trader. IllegalOfferId - If the format of the offer identifier is invalid. UnknownOfferId - If the trader knows nothing of the identified offer. ProxyOfferId - The trader cannot withdraw the proxy offer. IllegalPropertyName - If a property name is illegal. UnknownPropertyName - If the offer does not support the named property. PropertyTypeMismatch - If the type of a property does not match the type specified in the service definition. ReadonlyDynamicProperty - If an attempt has been made to assign a dynamic property value to a mandatory property. MandatoryProperty - If an attemp has been made to delete a mandatory property ReadonlyProperty - If an attemp has been made to modify a read-only property DuplicatePropertyName - If duplicate property names are specified.

Register CosTrading::Register::resolve

(

in TraderName

name

)

raises ( IllegalTraderName, UnknownTraderName, RegisterNotSupported )

This opreration resolves the Register interface of a linked trader.

Parameters:

name

- The name of the linked trader.

IllegalTraderName - If the specified trader name has invalid syntax. UnknownTraderName - If the specified trader cannot be found. RegisterNotSupported - If the specified trader does not support the Register interface.

void CosTrading::Register::withdraw

(

in OfferId

id

)

raises ( IllegalOfferId, UnknownOfferId, ProxyOfferId )

This operation withdraws an offer of service from the trader.

Parameters:

id

- The identifier of the offer to be withdrawn.

IllegalOfferId - If the format of the offer identifier is invalid. UnknownOfferId - If the trader knows nothing of the identified offer. ProxyOfferId - The trader cannot withdraw the proxy offer.

void CosTrading::Register::withdraw_using_constraint	(	in ServiceTypeName	type,
		in Constraint	constr
	)			raises ( IllegalServiceType, UnknownServiceType, IllegalConstraint, NoMatchingOffers )

This operation withdraws any offers matching the specified constraints.

Parameters:

	type	- The service type of offers to check.
	type	- The constraint string to check offers against.

IllegalServiceType - If the specified service type name is invalid. UnknownServiceType - If the specified service type has not been registered. IllegalConstraint - If the constraint string is illegal. NoMatchingOffers - If no offers corresponding to the service type and satisfying the constraints were found.