org.jpos.transaction.participant
Class BSHMethod

java.lang.Object
  org.jpos.transaction.participant.BSHMethod

public class BSHMethod
extends Object

This is a utility class that makes it a bit easier to work with beanshell scripts. Check out the execute methods.

Author:

AMarques

Constructor Summary

BSHMethod(String bshData, boolean source)
Creates a BSHMethod.

Method Summary

static BSHMethod	createBshMethod(org.jdom.Element e) Creates a BSHMethod from a JDom Element.
Map	execute(Map arguments, Collection returnNames) Sets the given arguments to the Interpreter, evaluates the script and returns a map that has the Strings of the returnNames collection as keys and the objects stored in the variables thus named as values.
Object	execute(Map arguments, String resultName) Sets the given arguments to the Interpreter, evaluates the script and returns the object stored on the variable named resultName.
protected bsh.Interpreter	initInterpreter(Map arguments)
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

BSHMethod

public BSHMethod(String bshData,
                 boolean source)

Creates a BSHMethod.

Parameters:

bshData - - May either be the file to source or the script itself to evaluate.

source - - If true indicates that the bshData passed is a file to source. Otherwise the string itself is evaluated.

Method Detail

createBshMethod

public static BSHMethod createBshMethod(org.jdom.Element e)
                                 throws FileNotFoundException,
                                        IOException

Creates a BSHMethod from a JDom Element. The element is not requiered to have a specific name. If the given element defines an attribute named 'file' the file specified as its value will be sourced by the created BSHMethod. If the 'file' attribute is specified, a 'cache' attribute may be specified as well which can take the values true|false and indicates wether to load the script to memory or to read from the file for every script evaluation. If the 'file' attibute is not specified then the text contained by the element is set to be evaluated by the new BSHMethod.

  Example 1 : 
          <prepare>
                  import org.jpos.iso.*;
                import org.jpos.transaction.*;

                        msg = context.get("txnRequest");
                        BaseChannel.getChannel("loop-channel").send(msg);
                        result=TransactionConstants.PREPARED | TransactionConstants.READONLY;
                </prepare>

  Example 2 :
          <routing file='cfg\files\routing1.bsh' cache='false'/>
  

Throws:

FileNotFoundException

IOException

execute

public Object execute(Map arguments,
                      String resultName)
               throws bsh.EvalError,
                      FileNotFoundException,
                      IOException

Sets the given arguments to the Interpreter, evaluates the script and returns the object stored on the variable named resultName.

Parameters:

arguments - Parameters to set to the Interpreter. For every Map.Entry (key, value), interpreter.set(key, value) is called. All keys must be Strings.

returnName - The names of the variables wich`s content is to be returned.

Throws:

bsh.EvalError

FileNotFoundException

IOException

execute

public Map execute(Map arguments,
                   Collection returnNames)
            throws bsh.EvalError,
                   FileNotFoundException,
                   IOException

Sets the given arguments to the Interpreter, evaluates the script and returns a map that has the Strings of the returnNames collection as keys and the objects stored in the variables thus named as values.

Parameters:

arguments - Parameters to set to the Interpreter. For every Map.Entry (key, value), interpreter.set(key, value) is called. All keys must be Strings.

returnNames - Collection of Strings. The names of the variables wich`s contents are to be returned.

Throws:

bsh.EvalError

FileNotFoundException

IOException

initInterpreter

protected bsh.Interpreter initInterpreter(Map arguments)
                                   throws bsh.EvalError,
                                          FileNotFoundException,
                                          IOException

Throws:

bsh.EvalError

FileNotFoundException

IOException

toString

public String toString()

Overrides:

toString in class Object