DistributionHandler (JORAM 5.24.0 API)

All Known Implementing Classes:

AmqpDistribution, JMSDistribution, MailDistribution, NotificationDistributionHandler, RESTDistribution
```
public interface DistributionHandler
```
DistributionHandler interface is made to work with a distribution queue or topic via a DistributionModule. Its purpose is to easily extend Joram destinations in order to deliver JMS messages outside of the JMS world, for example using e-mail or ftp.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`close()`	Closes this handler and releases any system resources associated to it.
`void`	`distribute(Message message)`	Distributes the given message outside of the JORAM server.
`void`	`init(Properties properties, boolean firstTime)`	Configures the handler with the given properties.

- Method Detail
  - distribute
```
void distribute(Message message)
         throws Exception
```
    Distributes the given message outside of the JORAM server.
    
    Parameters:
    
    message - the message to distribute
    
    Throws:
    
    Exception - if the message could not be distributed. The message will be forwarded to a DMQ, if any.
  - init
```
void init(Properties properties,
          boolean firstTime)
```
    Configures the handler with the given properties.
    
    Parameters:
    
    properties - The initial set of properties.
  - close
```
void close()
```
    Closes this handler and releases any system resources associated to it. There will be no subsequent call to this handler after it has been closed.