Main Page   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members  

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 Methods

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. More...

void withdraw (in OfferId id) raises ( IllegalOfferId, UnknownOfferId, ProxyOfferId )
 This operation withdraws an offer of service from the trader. More...

OfferInfo describe (in OfferId id) raises ( IllegalOfferId, UnknownOfferId, ProxyOfferId )
 This operation describes an offer of service from the trader. More...

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. More...

void withdraw_using_constraint (in ServiceTypeName type, in Constraint constr) raises ( IllegalServiceType, UnknownServiceType, IllegalConstraint, NoMatchingOffers )
 This operation withdraws any offers matching the specified constraints. More...

Register resolve (in TraderName name) raises ( IllegalTraderName, UnknownTraderName, RegisterNotSupported )
 This opreration resolves the Register interface of a linked trader. More...


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.
@raises IllegalOfferId - If the format of the offer identifier is invalid. @raises UnknownOfferId - If the trader knows nothing of the identified offer. @raises 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.
@raises InvalidObjectRef - If the object reference is not valid. @raises IllegalServiceType - If the specified service type name is invalid. @raises UnknownServiceType - If the specified service type has not been registered. @raises InterfaceTypeMismatch - The object does not support the interface specified in the service definition. @raises IllegalPropertyName - If a property name is illegal. @raises DuplicatePropertyName - If duplicate property names are specified. @raises PropertyTypeMismatch - If the type of a property does not match the type specified in the service definition. @raises ReadonlyDynamicProperty - If an attempt has been made to assign a dynamic property value to a property defined as read-only in the service definition. @raises 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.
@raises NotImplemented - If this operation is not implemented by the trader. @raises IllegalOfferId - If the format of the offer identifier is invalid. @raises UnknownOfferId - If the trader knows nothing of the identified offer. @raises ProxyOfferId - The trader cannot withdraw the proxy offer. @raises IllegalPropertyName - If a property name is illegal. @raises UnknownPropertyName - If the offer does not support the named property. @raises PropertyTypeMismatch - If the type of a property does not match the type specified in the service definition. @raises ReadonlyDynamicProperty - If an attempt has been made to assign a dynamic property value to a mandatory property. @raises MandatoryProperty - If an attemp has been made to delete a mandatory property @raises ReadonlyProperty - If an attemp has been made to modify a read-only property @raises 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.
@raises IllegalTraderName - If the specified trader name has invalid syntax. @raises UnknownTraderName - If the specified trader cannot be found. @raises 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.
@raises IllegalOfferId - If the format of the offer identifier is invalid. @raises UnknownOfferId - If the trader knows nothing of the identified offer. @raises 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.
@raises IllegalServiceType - If the specified service type name is invalid. @raises UnknownServiceType - If the specified service type has not been registered. @raises IllegalConstraint - If the constraint string is illegal. @raises NoMatchingOffers - If no offers corresponding to the service type and satisfying the constraints were found.