javax.microedition.ipdr.callback
Interface TemplateNegotiator

public interface TemplateNegotiator

The interface enables to custom templates negotiation. This interface is being returned by the TemplateNegotiatorFactory

The TemplateNegotiator is used by the ETA implementation whenever "modify template" message from the collection system is received. In such case, the ETA implementation MUST invoke the negotiateTemplate method (with the vector of TemplateConfig it got from the collection system as a parameter) and use the return value (vector of TemplateConfig) when it sends the "modify template response". The ETA implementer MUST instantiate and use at least one TemplateNegotiator object per thread. Two threads MUST NOT share the same TemplateNegotiator object. If it is invoked, it MUST be done before open method is invoked (or after close is invoked). Invoking setTemplateNegotiatorFactory after open was invoked will cause the ETA implementation to throw InvalidApplicationStateException exception. If the application did not invoked the setTemplateNegotiatorFactory or set null as parameter then the ETA implementation will response to "modify template" always with the templates as defined by the configuration (ExporterConfig).

See Also:

TemplateNegotiatorFactory.getTemplateNegotiator(javax.microedition.ipdr.configuration.CollectorConfig)

Method Summary

java.util.Vector

negotiateTemplate(byte sessionId, java.util.Vector incomingTemplates) Enables the negotiation of templates.

Method Detail

negotiateTemplate

public java.util.Vector negotiateTemplate(byte sessionId,
                                          java.util.Vector incomingTemplates)

Enables the negotiation of templates.

Parameters:

sessionId - the relevant session id

incomingTemplates - vector of TemplateConfig (incoming templates as sent by the collector)

Returns:

Vector of TemplateConfig outgoing templates (will be sent to collector as is)

See Also:

TemplateConfig