ie.nuigalway.ecrg.jade.jmsmtp.common
Interface JmsProviderManager

All Known Implementing Classes:
ProviderManager

public interface JmsProviderManager


Method Summary
 void activate(jade.mtp.InChannel.Dispatcher disp, JMSAddress jmsTA)
          Address specific activation of a MTP
 void deactivate()
          Deactivate the MTP
 void deactivate(JMSAddress jmsTA)
          Deactivate a specific transport address
 void deliver(JMSAddress jmsTA, jade.domain.FIPAAgentManagement.Envelope env, byte[] payload)
          Deliver a message to a jmsTA
 javax.jms.QueueConnection getBrokerConnection(JMSAddress jmsTA)
          Return a broker connetion
 ProviderAdmin getProviderAdmin(java.lang.String providerType)
          Get the Admin interface for a specific JMS provider
 

Method Detail

activate

public void activate(jade.mtp.InChannel.Dispatcher disp,
                     JMSAddress jmsTA)
              throws jade.mtp.MTPException
Address specific activation of a MTP

Parameters:
disp - Dispatcher for messages to the platform
jmsTA - Address to activate on
Throws:
jade.mtp.MTPException - Error with activation

deactivate

public void deactivate(JMSAddress jmsTA)
                throws jade.mtp.MTPException
Deactivate a specific transport address

Parameters:
jmsTA - Address to deactivate
Throws:
jade.mtp.MTPException - Error with address deactivation

deactivate

public void deactivate()
                throws jade.mtp.MTPException
Deactivate the MTP

Throws:
jade.mtp.MTPException - Error with MTP deactivation

deliver

public void deliver(JMSAddress jmsTA,
                    jade.domain.FIPAAgentManagement.Envelope env,
                    byte[] payload)
             throws jade.mtp.MTPException
Deliver a message to a jmsTA

Parameters:
jmsTA - Address to deliver too
env - Envelope of message
payload - Message payload
Throws:
jade.mtp.MTPException - Error during message send

getBrokerConnection

public javax.jms.QueueConnection getBrokerConnection(JMSAddress jmsTA)
                                              throws jade.mtp.MTPException
Return a broker connetion

Parameters:
jmsTA - Broker details to return
Returns:
a QueueConnectionFactory to the specified broker
Throws:
jade.mtp.MTPException - Description of the Exception
java.lang.Exception - Error in creating connection to broker

getProviderAdmin

public ProviderAdmin getProviderAdmin(java.lang.String providerType)
                               throws jade.mtp.MTPException
Get the Admin interface for a specific JMS provider

Parameters:
providerType - Providers interface to return
Returns:
JMS providers admin interface
Throws:
jade.mtp.MTPException - Description of the Exception
java.lang.Exception - Error in creating the provider interface