org.mule.components.rest
Class RestServiceWrapper

java.lang.Object
  extended byorg.mule.components.rest.RestServiceWrapper
All Implemented Interfaces:
Callable, Initialisable, UMOEventListener

public class RestServiceWrapper
extends Object
implements Callable, Initialisable

This component can used to proxy REST style services as local Mule Components. It can be configured with a service URL plus a number of properties that allow you to configure the parameters and error conditions on the service.

Version:
$Revision: 3798 $
Author:
Ross Mason

Field Summary
protected  Log logger
          logger used by this class
static String REST_SERVICE_URL
           
 
Constructor Summary
RestServiceWrapper()
           
 
Method Summary
 String getErrorExpression()
           
 UMOFilter getErrorFilter()
           
 String getHttpMethod()
           
 Map getOptionalParams()
           
 String getPayloadParameterName()
           
 Map getReqiredParams()
           
 String getServiceUrl()
           
protected  void handleException(RestServiceException e, UMOMessage result)
           
 void initialise()
          Method used to perform any initialisation work.
protected  boolean isErrorPayload(UMOMessage message)
           
 boolean isUrlFromMessage()
           
 Object onCall(UMOEventContext eventContext)
          Passes the event to the listener
 void setErrorExpression(String errorExpression)
           
 void setErrorFilter(UMOFilter errorFilter)
           
 void setHttpMethod(String httpMethod)
           
 void setOptionalParams(Map optionalParams)
           
 void setPayloadParameterName(String payloadParameterName)
           
 void setReqiredParams(Map reqiredParams)
           
 void setServiceUrl(String serviceUrl)
           
 void setUrlFromMessage(boolean urlFromMessage)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

REST_SERVICE_URL

public static final String REST_SERVICE_URL
See Also:
Constant Field Values

logger

protected transient Log logger
logger used by this class

Constructor Detail

RestServiceWrapper

public RestServiceWrapper()
Method Detail

getServiceUrl

public String getServiceUrl()

setServiceUrl

public void setServiceUrl(String serviceUrl)

isUrlFromMessage

public boolean isUrlFromMessage()

setUrlFromMessage

public void setUrlFromMessage(boolean urlFromMessage)

getReqiredParams

public Map getReqiredParams()

setReqiredParams

public void setReqiredParams(Map reqiredParams)

getOptionalParams

public Map getOptionalParams()

setOptionalParams

public void setOptionalParams(Map optionalParams)

getHttpMethod

public String getHttpMethod()

setHttpMethod

public void setHttpMethod(String httpMethod)

getPayloadParameterName

public String getPayloadParameterName()

setPayloadParameterName

public void setPayloadParameterName(String payloadParameterName)

getErrorFilter

public UMOFilter getErrorFilter()

setErrorFilter

public void setErrorFilter(UMOFilter errorFilter)

getErrorExpression

public String getErrorExpression()

setErrorExpression

public void setErrorExpression(String errorExpression)

initialise

public void initialise()
                throws InitialisationException,
                       RecoverableException
Description copied from interface: Initialisable
Method used to perform any initialisation work. If a fatal error occurs during initialisation an InitialisationException should be thrown, causing the Mule instance to shutdown. If the error is recoverable, say by retrying to connect, a RecoverableException should be thrown. There is no guarantee that by throwing a Recoverable exception that the Mule instance will not shut down.

Specified by:
initialise in interface Initialisable
Throws:
RecoverableException - if an error occurs that can be recovered from
InitialisationException - if a fatal error occurs causing the Mule instance to shutdown

onCall

public Object onCall(UMOEventContext eventContext)
              throws Exception
Description copied from interface: Callable
Passes the event to the listener

Specified by:
onCall in interface Callable
Parameters:
eventContext - the context of the current event being process
Returns:
Object this object can be anything. When the UMOLifecycleAdapter for the component receives this object it will first see if the Object is an UMOMessage if not and the Object is not null a new message will be created using the returned object as the payload. This new event will then get published via the configured outbound router if-
  1. One has been configured for the UMO.
  2. the setStopFurtherProcessing(true) wasn't called on the event context event.
Throws:
Exception - if the event fails to process properly. If exceptions aren't handled by the implementation they will be handled by the exceptionListener associated with the component

isErrorPayload

protected boolean isErrorPayload(UMOMessage message)

handleException

protected void handleException(RestServiceException e,
                               UMOMessage result)
                        throws Exception
Throws:
Exception


Copyright © 2003-2006 MuleSource Inc.. All Rights Reserved.