Class SelectDestination

java.lang.Object

org.jpos.transaction.participant.SelectDestination

All Implemented Interfaces:

Configurable, XmlConfigurable, TransactionConstants, TransactionParticipant

public class SelectDestination
extends Object
implements TransactionParticipant, Configurable, XmlConfigurable

Transaction participant that picks a routing destination for an inbound request based on the cardholder's BIN ranges and PAN regular expressions declared in its XML configuration.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SelectDestination.BinRange	Inclusive numeric BIN range mapped to a routing destination.

Field Summary

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
SelectDestination()	Default constructor; no instance state to initialise.

Method Summary

Modifier and Type	Method	Description
int	prepare(long id, Serializable context)	Called by TransactionManager in preparation for a transaction
void	setConfiguration(org.jdom2.Element xml)	SelectDestination expects an XML configuration in the following format:
void	setConfiguration(Configuration cfg)	Configures this object with the supplied Configuration.

Methods inherited from class Object

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

Methods inherited from interface TransactionParticipant

abort, commit

Modifier and Type	Method	Description
default void	abort(long id, Serializable context)	Called by TransactionManager upon transaction commit.
default void	commit(long id, Serializable context)	Called by TransactionManager upon transaction commit.

Constructor Details

SelectDestination

public SelectDestination()

Default constructor; no instance state to initialise.

Method Details

prepare

public int prepare(long id,
 Serializable context)

Description copied from interface: TransactionParticipant

Called by TransactionManager in preparation for a transaction

Specified by:

prepare in interface TransactionParticipant

Parameters:

id - the Transaction identifier

context - transaction context

Returns:

PREPARED or ABORTED (| NO_JOIN | READONLY)

setConfiguration

public void setConfiguration(Configuration cfg)

Description copied from interface: Configurable

Configures this object with the supplied Configuration.

Specified by:

setConfiguration in interface Configurable

Parameters:

cfg - Configuration object

setConfiguration

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

SelectDestination expects an XML configuration in the following format:

<endpoint destination="XXX">
  4000000..499999
  4550000..455999
  5
</endpoint>

Specified by:

setConfiguration in interface XmlConfigurable

Parameters:

xml - Configuration element

Throws:

ConfigurationException - if the XML cannot be parsed into BIN ranges or regexes