Class BSHGroupSelector

java.lang.Object

org.jpos.util.SimpleLogSource

org.jpos.transaction.participant.BSHTransactionParticipant

org.jpos.transaction.participant.BSHGroupSelector

All Implemented Interfaces:

XmlConfigurable, AbortParticipant, GroupSelector, TransactionConstants, TransactionParticipant, LogSource

public class BSHGroupSelector
extends BSHTransactionParticipant
implements GroupSelector

BeanShell-backed GroupSelector that evaluates a <select> script to choose the next participant group, falling back to defaultSelect(long, Serializable) when the script returns null.

Field Summary

Fields

Modifier and Type	Field	Description
protected BSHMethod	selectMethod	Compiled BSH method invoked to determine the active group.

Fields inherited from class BSHTransactionParticipant

abortMethod, commitMethod, prepareForAbortMethod, prepareMethod

Modifier and Type	Field	Description
protected BSHMethod	abortMethod	BeanShell method for the abort phase.
protected BSHMethod	commitMethod	BeanShell method for the commit phase.
protected BSHMethod	prepareForAbortMethod	BeanShell method for the prepare-for-abort phase.
protected BSHMethod	prepareMethod	BeanShell method for the prepare phase.

Fields inherited from class SimpleLogSource

logger, realm

Modifier and Type	Field	Description
protected Logger	logger	The logger used by this log source.
protected String	realm	The logging realm for this log source.

Fields inherited from interface TransactionConstants

ABORTED, FAIL, NO_JOIN, PAUSE, PREPARED, READONLY, RETRY

Modifier and Type	Field	Description
static final int	ABORTED	Transaction has been aborted.
static final int	FAIL	Shortcut for a read-only, non-joining abort (READONLY | NO_JOIN).
static final int	NO_JOIN	This participant does not join the transaction
static final int	PAUSE	Transaction is paused.
static final int	PREPARED	Transaction has been prepared successfully.
static final int	READONLY	Context has not been modified (no need to persist a snapshot)
static final int	RETRY	Transaction should be retried.

Constructor Summary

Constructors

Constructor	Description
BSHGroupSelector()	Default constructor; no instance state to initialise.

Method Summary

Modifier and Type	Method	Description
String	defaultSelect(long id, Serializable context)	Hook returning the default group when the BSH script returns null.
String	select(long id, Serializable context)	Selects the transaction group to execute.
void	setConfiguration(org.jdom2.Element e)	Configures this object from an XML element.

Methods inherited from class BSHTransactionParticipant

abort, commit, defaultAbort, defaultCommit, defaultPrepare, executeMethod, prepare, prepareForAbort

Modifier and Type	Method	Description
void	abort(long id, Serializable context)	Called by TransactionManager upon transaction commit.
void	commit(long id, Serializable context)	Called by TransactionManager upon transaction commit.
protected void	defaultAbort(long id, Serializable context, LogEvent ev)	Default abort handling when no BeanShell abort method is configured (no-op).
protected void	defaultCommit(long id, Serializable context, LogEvent ev)	Default commit implementation (no-op).
protected int	defaultPrepare(long id, Serializable context, LogEvent ev)	Default prepare implementation; returns PREPARED|READONLY.
protected Object	executeMethod(BSHMethod m, long id, Serializable context, LogEvent evt, String resultName)	Executes the given BSHMethod with the standard transaction parameters.
int	prepare(long id, Serializable context)	Called by TransactionManager in preparation for a transaction
int	prepareForAbort(long id, Serializable context)	Called by TransactionManager in preparation for a transaction that is known to abort.

Methods inherited from class SimpleLogSource

error, error, getLogger, getRealm, info, info, setLogger, setRealm, warning, warning

Modifier and Type	Method	Description
void	error(String detail)	Logs an error message.
void	error(String detail, Object obj)	Logs an error message with an attached object.
Logger	getLogger()	Returns the logger.
String	getRealm()	Returns the logging realm.
void	info(String detail)	Logs an informational message.
void	info(String detail, Object obj)	Logs an informational message with an attached object.
void	setLogger(Logger logger, String realm)	Sets the logger and realm for this log source.
void	setRealm(String realm)	Sets the logging realm.
void	warning(String detail)	Logs a warning message.
void	warning(String detail, Object obj)	Logs a warning message with an attached object.

Methods inherited from class Object

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

Field Details

selectMethod

protected BSHMethod selectMethod

Compiled BSH method invoked to determine the active group.

Constructor Details

BSHGroupSelector

public BSHGroupSelector()

Default constructor; no instance state to initialise.

Method Details

setConfiguration

public void setConfiguration(org.jdom2.Element e)
                      throws ConfigurationException

Description copied from interface: XmlConfigurable

Configures this object from an XML element.

Specified by:

setConfiguration in interface XmlConfigurable

Overrides:

setConfiguration in class BSHTransactionParticipant

Parameters:

e - Configuration element

Throws:

ConfigurationException - on error

select

public String select(long id,
 Serializable context)

Description copied from interface: GroupSelector

Selects the transaction group to execute.

Specified by:

select in interface GroupSelector

Parameters:

id - transaction id

context - transaction context

Returns:

group name or null for no-action

defaultSelect

public String defaultSelect(long id,
 Serializable context)

Hook returning the default group when the BSH script returns null. Subclasses may override to provide deterministic fallback selection.

Parameters:

id - transaction id

context - transaction context

Returns:

default group identifier (empty string by default)