MessengerService (Policy Manager Scripting API)

```
public interface MessengerService
```
A MessengerService provides a messaging bus for exchanging messages with web services. The MessengerService will provide access to an ExchangeFactory for creating Exchanges and a Messenger for executing them. The following shows how an ExchangeFactory is obtained.
```
 exchangeFactory = msgrService.createExchangeFactory();
 
```
The following shows how an ExchangeFactory that will use the same target service name for all Exchanges it creates so the client does not have to set the service name repeatedly on the Exchanges.
```
 exchangeFactory = msgrService.createExchangeFactory("{http://myns}MyService");
 
```
The following shows how an ExchangeFactory that will use the same target service endpoint for all Exchanges it creates.
```
 exchangeFactory = msgrService.createExchangeFactory("{http://myns}MyService", "ep1");
 
```
The following shows how a Messenger is obtained for executing exchanges.
```
 messenger = msgrService.getMessenger();
 messenger.send(exchange);
 
```

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`ExchangeFactory`	`createExchangeFactory()` Creates an `ExchangeFactory` for creating exchanges.
`ExchangeFactory`	`createExchangeFactory(javax.xml.namespace.QName serviceName)` Creates an `ExchangeFactory` for creating exchanges.
`ExchangeFactory`	`createExchangeFactory(javax.xml.namespace.QName serviceName, java.lang.String endpointName)` Creates an `ExchangeFactory` for creating exchanges.
`ExchangeFactory`	`createExchangeFactory(java.lang.String serviceName)` Creates an `ExchangeFactory` for creating exchanges.
`ExchangeFactory`	`createExchangeFactory(java.lang.String serviceName, java.lang.String endpointName)` Creates an `ExchangeFactory` for creating exchanges.
`Messenger`	`getMessenger()` Returns a `Messenger` for executing message exchanges.

- Method Detail
  - getMessenger
```
Messenger getMessenger()
```
    Returns a Messenger for executing message exchanges.
    
    Returns:
    
    Messenger.
  - createExchangeFactory
```
ExchangeFactory createExchangeFactory()
```
    Creates an ExchangeFactory for creating exchanges. The exchanges will not be addressed.
    
    Returns:
    
    ExchangeFactory
  - createExchangeFactory
```
ExchangeFactory createExchangeFactory(java.lang.String serviceName)
```
    Creates an ExchangeFactory for creating exchanges. The exchanges will be addressed to the given service.
    
    Parameters:
    
    serviceName - String representation of the QName of the service all exchanges created by the returned factory should be addressed to.
    
    Returns:
    
    ExchangeFactory
  - createExchangeFactory
```
ExchangeFactory createExchangeFactory(javax.xml.namespace.QName serviceName)
```
    Creates an ExchangeFactory for creating exchanges. The exchanges will be addressed to the given service.
    
    Parameters:
    
    serviceName - QName of the service all exchanges created by the returned factory should be addressed to.
    
    Returns:
    
    ExchangeFactory
  - createExchangeFactory
```
ExchangeFactory createExchangeFactory(java.lang.String serviceName,
                                      java.lang.String endpointName)
```
    Creates an ExchangeFactory for creating exchanges. The exchanges will be addressed to the given service endpoint.
    
    Parameters:
    
    serviceName - String representation of the QName of the service all exchanges created by the returned factory should be addressed to.
    
    endpointName - Name of the endpoint all exchanges created by the returned factory should be addressed to.
    
    Returns:
    
    ExchangeFactory
  - createExchangeFactory
```
ExchangeFactory createExchangeFactory(javax.xml.namespace.QName serviceName,
                                      java.lang.String endpointName)
```
    Creates an ExchangeFactory for creating exchanges. The exchanges will be addressed to the given service endpoint.
    
    Parameters:
    
    serviceName - QName of the service all exchanges created by the returned factory should be addressed to.
    
    endpointName - Name of the endpoint all exchanges created by the returned factory should be addressed to.
    
    Returns:
    
    ExchangeFactory

This software is the confidential and proprietary information of Perforce, Inc. and is subject to copyright protection under laws of the United States of America and other countries. The use of this software should be in accordance with the license agreement terms you entered into with Perforce, Inc.

Interface MessengerService

Method Summary

Method Detail

getMessenger

createExchangeFactory

createExchangeFactory

createExchangeFactory

createExchangeFactory

createExchangeFactory