guarana.toolkit.task.mappers
Class Stream2XML

java.lang.Object
  extended by guarana.util.observer.smart.SmartObservable
      extended by guarana.framework.task.Task
          extended by guarana.toolkit.task.mappers.Mapper
              extended by guarana.toolkit.task.mappers.Stream2XML
All Implemented Interfaces:
ISource, guarana.util.observer.smart.ISmartObserver

public abstract class Stream2XML
extends Mapper

Maps an inbound message body from stream format to XML format. This task does not add or remove content from the inbound messages, it keeps all the original content. For this reason the outbound message has the same MESSAGE_ID the inbound message has.

Graphical notation:


This is an Integration Pattern implementation

Problem: How do you map messages with unstructured data into messages with data structured?

Solution: Use an stream two xml mapper to map the body in stream format to an xml format. Details:


Since:
Guaranį SDK 1.0.0
Author:
Rafael Z. Frantz

Field Summary
 
Fields inherited from class guarana.framework.task.Task
input, output
 
Constructor Summary
Stream2XML(String name)
          Constructs a new stream mapper task.
Stream2XML(String name, int numberOfInputs, int numberOfOutputs)
          Constructs a new stream mapper task.
 
Method Summary
abstract  void doWork(Exchange exchange)
          This method implements the business logic of this task.
 void update(guarana.util.observer.smart.SmartObservable slot, Object arg)
          This method is automatically called by the observable slot to notify the slot has received a message.
 
Methods inherited from class guarana.framework.task.Task
execute, getName, getTriggerInterval, isTriggerTask, setName, setTriggerInterval
 
Methods inherited from class guarana.util.observer.smart.SmartObservable
addSmartObserver, containsSmartObserver, containsSmartObserver, countSmartObservers, deleteSmartObserver, deleteSmartObservers, hasChanged, notifySmartObservers, notifySmartObservers
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Stream2XML

public Stream2XML(String name)
Constructs a new stream mapper task.

Parameters:
name - The name of the mapper task.

Stream2XML

public Stream2XML(String name,
                  int numberOfInputs,
                  int numberOfOutputs)
Constructs a new stream mapper task.

Parameters:
name - The name of this task.
numberOfInputs - The number of input gateways this task must have.
numberOfOutputs - The number of output gateways this task must have.
Method Detail

doWork

public abstract void doWork(Exchange exchange)
                     throws TaskExecutionException
This method implements the business logic of this task.
Maps an inbound message body in stream format into an XML format.

Overrides:
doWork in class Task
Parameters:
exchange - An exchange object that holds the inbound messages of this task.
Throws:
TaskExecutionException - to report any exception that has occurred during the execution of this method.

update

public void update(guarana.util.observer.smart.SmartObservable slot,
                   Object arg)
This method is automatically called by the observable slot to notify the slot has received a message. For all those tasks that can execute with one or more messages in its input slots, this method will add the task to the executable task reporter, so it can be executed. In this case the task execution will consume messages from all input slots.
Please, do not call this method by yourself. Overrides the implementation at Task for performance reasons.

Specified by:
update in interface guarana.util.observer.smart.ISmartObserver
Overrides:
update in class Task
Parameters:
slot - The Slot associated with this task.
arg - THIS PARAMETHER IS NOT USED.


Guaranį DSL Home