| |
- Acspy.Nc.Supplier.Supplier(CosNotifyComm__POA.StructuredPushSupplier, Acspy.Nc.CommonNC.CommonNC)
-
- ArchiveSupplier
class ArchiveSupplier(Acspy.Nc.Supplier.Supplier) |
|
ArchiveSupplier is a a Supplier-derived class designed solely for the purpose of
sending notification channel structured events automatically by BACI |
|
- Method resolution order:
- ArchiveSupplier
- Acspy.Nc.Supplier.Supplier
- CosNotifyComm__POA.StructuredPushSupplier
- CosNotifyComm__POA.NotifySubscribe
- omniORB.PortableServer.Servant
- Acspy.Nc.CommonNC.CommonNC
Methods defined here:
- __init__(self)
- Constructor.
Params:
- handler
Returns: Nothing
Raises: ACSErrTypeCommonImpl.CORBAProblemExImpl on critical failures
- getChannelDomain(self)
- Overridden.
Parameters: None
Returns: pointer to a constant string.
Raises: Nothing
- getChannelKind(self)
- Overridden.
Parameters: None
Returns: pointer to a constant string.
Raises: Nothing
- getNotificationFactoryName(self)
- Overridden.
Parameters: None
Returns: pointer to a constant string. Normally
acscommon::ARCHIVE_NOTIFICATION_FACTORY_NAME
Raises: Nothing
- publishEvent(self, simple_data=None, type_name=None, event_name='', se=None, supplier_name=None)
- publishEvent is the one method developers have to use.
Params:
- simple_data is a user-defined IDL struct. If this parameter is not
specified by the developer, se MUST be used. 99% of the time developers
should specify the simple_data parameter and NOTHING ELSE!
- type_name is literally the type_name field of a structured event. This
is an optional parameter and should not be specified under normal
circumstances. If unspecified, the name of the simple_data object is used.
- event_name is the event_name field of the structured event. Not really
useful.
- se is a fully-defined structured event. If this parameter is specified,
all other parameters will be completely ignored. A check is made to ensure
that this object is really what it claims to be. This parameter is
reserved for ACS internal usage.
- suppier_name is the name of the supplier publishing the event. This
parameter is reserved for ACS internal usage.
Returns: Nothing
Raises:
- ACSErrTypeCommonImpl.CORBAProblemExImpl
- ACSErrTypeCommonImpl.CouldntPerformActionExImpl
- ACSErrTypeCommonImpl.TypeNotSupportedExImpl
Methods inherited from Acspy.Nc.Supplier.Supplier:
- disconnect(self)
- User code MUST call this method when the Supplier is no longer useful.
Failure to do so can result in remote memory leaks!
Params: None
Returns: Nothing
Raises: Nothing
- disconnect_structured_push_supplier(self)
- Override this method to do something when a consumer unsubscribes from the
channel. Developer code must never invoke this method!
Params: Nothing
Returns: Nothing
Raises: Nothing
- initCORBA(self)
- Handles all the CORBA involved in creating a Supplier.
Parameters: None
Returns: Nothing
Raises: ACSErrTypeCommonImpl.CORBAProblemExImpl on critical failures
- reconnect(self, ecf)
- subscription_change(self, added, removed)
- Override this method so a "smart" Supplier subclass can publish (or not
pubish) events based on Consumer demands. Not very useful when there is
more than one Supplier instance for a given channel.
Params:
- added subscription list
- removed subscription list
Returns: Nothing
Raises:
- InvalidEventType Throw this exception when a consumer subscribes (or
unsubscribes) to a bad domain/type
Methods inherited from Acspy.Nc.CommonNC.CommonNC:
- configAdminProps(self)
- Configures the administrative properties for this channel.
Only useful if the channel has not been created yet and this particular
method is being overriden.
Parameters: None
Returns: A sequence of Administrative properties.
Raises: Nothing
- configQofS(self)
- Configures the quality of service properties for this channel.
Only useful if the channel has not been created yet and this particular
method is being overriden.
Parameters: None
Returns: A sequence of Quality of Service properties.
Raises: Nothing
- createNotificationChannel(self)
- Creates the notification channel. Only to be called if it does not already
exist.
Parameters: None
Returns: Nothing
Raises: ACSErrTypeCommonImpl.CORBAProblemExImpl on critical failures
- destroyNotificationChannel(self)
- Destroys the channel and unregisters it from the naming service. ONLY
USE THIS METHOD IF YOU KNOW FOR CERTAIN THERE IS ONLY ONE SUPPLIER FOR
THE CHANNEL!!! To be used with extreme caution. Likely to be removed with
future versions of ACS.
Parameters: None
Returns: 1 on success and 0 on failure
Raises: Nothing
- getNotificationFactoryNameForChannel(self, channel, domain=None)
- This method returns the name of the notification service for the channel
or domain from the configuration information given in the CDB.
Parameters:
- channel is the channel name of the desired factory
- domain is the domain of the desired factory
Returns: string containing the factory name or None
Raises: Nothing
| |