Class PackagerWrapper

java.lang.Object

org.jpos.iso.packager.PackagerWrapper

All Implemented Interfaces:

Configurable, ISOPackager, LogSource

public abstract class PackagerWrapper
extends Object
implements ISOPackager, LogSource, Configurable

Wrapper on standard packager

See Also:

• ISOPackager

Field Summary

Fields

Modifier and Type	Field	Description
protected Configuration	cfg	Configuration applied to this wrapper (and propagated to the inner packager when configurable).
protected Logger	logger	Logger receiving wrapped pack/unpack diagnostic events.
protected String	realm	Logger realm associated with this packager.
protected ISOPackager	standardPackager	Underlying packager that this wrapper delegates to.

Constructor Summary

Constructors

Constructor	Description
PackagerWrapper()	Default constructor.

Method Summary

Modifier and Type	Method	Description
String	getFieldDescription(ISOComponent m, int fldNumber)	Emits a description of the field identified by fldno in the given message to the log event.
Logger	getLogger()	Returns the Logger associated with this source.
ISOPackager	getPackager()	Returns the underlying packager.
String	getRealm()	Returns the log realm associated with this source.
abstract byte[]	pack(ISOComponent c)	Packs an ISO-8583 message into a byte array.
void	setConfiguration(Configuration cfg)	requires inner-packager property
void	setLogger(Logger logger, String realm)	Attaches a Logger and realm to this log source.
void	setPackager(ISOPackager packger)	Replaces the underlying packager.
abstract int	unpack(ISOComponent c, byte[] b)	Unpacks an ISO-8583 byte array into the given message container.

Methods inherited from class Object

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

Methods inherited from interface ISOPackager

createISOMsg, getDescription, unpack

Modifier and Type	Method	Description
ISOMsg	createISOMsg()	Creates and returns a new ISOMsg instance appropriate for this packager.
String	getDescription()	Returns a human-readable description of this packager.
void	unpack(ISOComponent m, InputStream in)	Unpacks an ISO-8583 message from an input stream into the given container.

Field Details

logger

protected Logger logger

Logger receiving wrapped pack/unpack diagnostic events.

realm

protected String realm

Logger realm associated with this packager.

standardPackager

protected ISOPackager standardPackager

Underlying packager that this wrapper delegates to.

cfg

protected Configuration cfg

Configuration applied to this wrapper (and propagated to the inner packager when configurable).

Constructor Details

PackagerWrapper

public PackagerWrapper()

Default constructor.

Method Details

pack

public abstract byte[] pack(ISOComponent c)
                     throws ISOException

Description copied from interface: ISOPackager

Packs an ISO-8583 message into a byte array.

Specified by:

pack in interface ISOPackager

Parameters:

c - the Component to pack

Returns:

Message image

Throws:

ISOException - on packing error

unpack

public abstract int unpack(ISOComponent c,
 byte[] b)
                    throws ISOException

Description copied from interface: ISOPackager

Unpacks an ISO-8583 byte array into the given message container.

Specified by:

unpack in interface ISOPackager

Parameters:

c - the Container of this message

b - ISO message image

Returns:

consumed bytes

Throws:

ISOException - on unpacking error

getFieldDescription

public String getFieldDescription(ISOComponent m,
 int fldNumber)

Description copied from interface: ISOPackager

Emits a description of the field identified by fldno in the given message to the log event.

Specified by:

getFieldDescription in interface ISOPackager

Parameters:

m - the Container (i.e. an ISOMsg)

fldNumber - the Field Number

Returns:

Field Description

setPackager

public void setPackager(ISOPackager packger)

Replaces the underlying packager.

Parameters:

packger - inner packager to delegate to

getPackager

public ISOPackager getPackager()

Returns the underlying packager.

Returns:

the inner packager, or null if none is configured

setLogger

public void setLogger(Logger logger,
 String realm)

Description copied from interface: LogSource

Attaches a Logger and realm to this log source.

Specified by:

setLogger in interface LogSource

Parameters:

logger - the logger to use

realm - the log realm (diagnostic label)

getRealm

public String getRealm()

Description copied from interface: LogSource

Returns the log realm associated with this source.

Specified by:

getRealm in interface LogSource

Returns:

log realm

getLogger

public Logger getLogger()

Description copied from interface: LogSource

Returns the Logger associated with this source.

Specified by:

getLogger in interface LogSource

Returns:

the Logger

setConfiguration

public void setConfiguration(Configuration cfg)
                      throws ConfigurationException

requires inner-packager property

Specified by:

setConfiguration in interface Configurable

Parameters:

cfg - Configuration object

Throws:

ConfigurationException - if configuration is invalid