org.mule.umo.endpoint
Interface UMOEndpoint

All Superinterfaces:
java.lang.Cloneable, Initialisable, java.io.Serializable, UMOImmutableEndpoint
All Known Implementing Classes:
MuleEndpoint

public interface UMOEndpoint
extends UMOImmutableEndpoint

UMOEndpoint describes a Provider in the Mule Server. A endpoint is a grouping of an endpoint, an endpointUri and a transformer.

Version:
$Revision: 1.6 $
Author:
Ross Mason

Field Summary
 
Fields inherited from interface org.mule.umo.endpoint.UMOImmutableEndpoint
ENDPOINT_TYPE_RECEIVER, ENDPOINT_TYPE_RESPONSE, ENDPOINT_TYPE_SENDER, ENDPOINT_TYPE_SENDER_AND_RECEIVER
 
Method Summary
 UMOTransactionConfig getTransactionConfig()
          Returns the transaction configuration for this endpoint
 void setConnector(UMOConnector connector)
          The endpoint that will be used to send the message on.
 void setCreateConnector(int action)
           
 void setDeleteUnacceptedMessages(boolean delete)
          If a filter is configured on this endpoint, this property will determine if message that are not excepted by the filter are deleted
 void setEndpointURI(UMOEndpointURI endpointUri)
          This specifes the communication endpointUri.
 void setFilter(UMOFilter filter)
          The filter to apply to incoming messages
 void setName(java.lang.String name)
           
 void setProperties(java.util.Map props)
           
 void setSecurityFilter(UMOEndpointSecurityFilter filter)
          Sets an UMOEndpointSecurityFilter for this endpoint.
 void setSynchronous(boolean synchronous)
          Determines if requests originating from this endpoint should be synchronous i.e.
 void setTransactionConfig(UMOTransactionConfig config)
          Sets the Transaction configuration for the endpoint
 void setTransformer(UMOTransformer trans)
          The transformer is responsible for transforming data when it is received or sent by the UMO (depending on whether this endpoint is a receiver or not).
 void setType(java.lang.String type)
          Determines whether the message endpoint is a sender or receiver or both.
 
Methods inherited from interface org.mule.umo.endpoint.UMOImmutableEndpoint
canReceive, canSend, clone, getConnector, getCreateConnector, getEndpointURI, getFilter, getName, getProperties, getProtocol, getSecurityFilter, getTransformer, getType, isDeleteUnacceptedMessages, isReadOnly, isSynchronous
 
Methods inherited from interface org.mule.umo.lifecycle.Initialisable
initialise
 

Method Detail

setEndpointURI

public void setEndpointURI(UMOEndpointURI endpointUri)
                    throws EndpointException
This specifes the communication endpointUri. This will have a different format depending on the transport protocol being used i.e.

if an endpointUri is not specifed it will be assumed that it will be determined at run-time by the calling application. The endpointUri can be aliteral endpointUri such as an email address or it can be a logical name for an endpointUri as long as it is declared in a message-endpointUri block. When the message-provider is created the endpointUri is first lookup in the endpointUri registry and if nothing is returned the endpointUri value itself is used.

Parameters:
endpointUri - the endpointUri on which the Endpoint sends or receives data
Throws:
EndpointException - thrown if the EndpointUri cannot be processed by the Endpoint

setType

public void setType(java.lang.String type)
Determines whether the message endpoint is a sender or receiver or both. The possible values are-

Parameters:
type - the endpoint type

setConnector

public void setConnector(UMOConnector connector)
The endpoint that will be used to send the message on. It is important that the endpointUri and the connection correlate i.e. if your endpointUri is a jms queue your connection must be a JMS endpoint.

Parameters:
connector - the endpoint to associate with the endpoint

setName

public void setName(java.lang.String name)
Parameters:
name - the name to identify the endpoint

setTransformer

public void setTransformer(UMOTransformer trans)
The transformer is responsible for transforming data when it is received or sent by the UMO (depending on whether this endpoint is a receiver or not). A tranformation for an inbound event can be forced by the user by calling the inbound event.getTransformedMessage(). A tranformation for an outbound event is called or when the UMO dispatchEvent() or sendEvent() methods are called.

This attribute represents the name of the transformer to use as declared in the transformers section of the configuration file. IF a name for the transformer is not set on the configuration element, it will default to the name of the className attribute minus the package name.

Parameters:
trans - the transformer to use when receiving or sending data

setProperties

public void setProperties(java.util.Map props)
Parameters:
props - properties for this endpoint

getTransactionConfig

public UMOTransactionConfig getTransactionConfig()
Returns the transaction configuration for this endpoint

Specified by:
getTransactionConfig in interface UMOImmutableEndpoint
Returns:
transaction config for this endpoint

setTransactionConfig

public void setTransactionConfig(UMOTransactionConfig config)
Sets the Transaction configuration for the endpoint

Parameters:
config - the transaction config to use by this endpoint

setFilter

public void setFilter(UMOFilter filter)
The filter to apply to incoming messages

Parameters:
filter - the filter to use

setDeleteUnacceptedMessages

public void setDeleteUnacceptedMessages(boolean delete)
If a filter is configured on this endpoint, this property will determine if message that are not excepted by the filter are deleted

Parameters:
delete - if message should be deleted, false otherwise

setSecurityFilter

public void setSecurityFilter(UMOEndpointSecurityFilter filter)
Sets an UMOEndpointSecurityFilter for this endpoint. If a filter is set all traffice via this endpoint with be subject to authentication.

Parameters:
filter - the UMOSecurityFilter responsible for authenticating message flow via this endpoint.
See Also:
UMOEndpointSecurityFilter

setSynchronous

public void setSynchronous(boolean synchronous)
Determines if requests originating from this endpoint should be synchronous i.e. execute in a single thread and possibly return an result. This property is only used when the endpoint is of type 'receiver'.

Parameters:
synchronous - whether requests on this endpoint should execute in a single thread. This property is only used when the endpoint is of type 'receiver'

setCreateConnector

public void setCreateConnector(int action)


Copyright © 2003-2005 SymphonySoft Limited. All Rights Reserved.