Class DummyPackager

java.lang.Object

org.jpos.util.Log

org.jpos.iso.packager.DummyPackager

All Implemented Interfaces:

ISOPackager, LogSource

public class DummyPackager
extends Log
implements ISOPackager

Stub ISOPackager that throws on every operation; used for testing wiring without packing.

Field Summary

Fields inherited from class Log

DEBUG, defaultTags, ERROR, FATAL, INFO, logger, realm, TRACE, WARN

Modifier and Type	Field	Description
static final String	DEBUG	Level constant for debug events.
protected final Map<String,String>	defaultTags	Default tags applied to every LogEvent created by this Log.
static final String	ERROR	Level constant for error events.
static final String	FATAL	Level constant for fatal events.
static final String	INFO	Level constant for informational events.
protected Logger	logger	Logger receiving the events produced by this Log.
protected String	realm	Realm associated with events emitted through this Log.
static final String	TRACE	Level constant for trace events.
static final String	WARN	Level constant for warning events.

Constructor Summary

Constructors

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

Method Summary

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.
String	getFieldDescription(ISOComponent m, int fldNumber)	Emits a description of the field identified by fldno in the given message to the log event.
byte[]	pack(ISOComponent m)	Packs an ISO-8583 message into a byte array.
int	unpack(ISOComponent m, byte[] b)	Unpacks an ISO-8583 byte array into the given message container.
void	unpack(ISOComponent m, InputStream in)	Unpacks an ISO-8583 message from an input stream into the given container.

Methods inherited from class Log

applyDefaultTags, createDebug, createDebug, createError, createError, createFatal, createFatal, createInfo, createInfo, createLogEvent, createLogEvent, createTrace, createTrace, createWarn, createWarn, debug, debug, error, error, fatal, fatal, getDefaultTags, getLog, getLogger, getRealm, info, info, removeDefaultTag, setDefaultTag, setDefaultTags, setLogger, setLogger, setRealm, trace, trace, warn, warn

Modifier and Type	Method	Description
protected LogEvent	applyDefaultTags(LogEvent evt)	Decorates evt with this Log's default tags, if any.
LogEvent	createDebug()	Creates an empty debug-level event.
LogEvent	createDebug(Object detail)	Creates a debug-level event with the given payload.
LogEvent	createError()	Creates an empty error-level event.
LogEvent	createError(Object detail)	Creates an error-level event with the given payload.
LogEvent	createFatal()	Creates an empty fatal-level event.
LogEvent	createFatal(Object detail)	Creates a fatal-level event with the given payload.
LogEvent	createInfo()	Creates an empty info-level event.
LogEvent	createInfo(Object detail)	Creates an info-level event with the given payload.
LogEvent	createLogEvent(String level)	Creates a new LogEvent at the given level decorated with this Log's default tags.
LogEvent	createLogEvent(String level, Object detail)	Creates a new LogEvent at the given level with an initial payload.
LogEvent	createTrace()	Creates an empty trace-level event.
LogEvent	createTrace(Object detail)	Creates a trace-level event with the given payload.
LogEvent	createWarn()	Creates an empty warning-level event.
LogEvent	createWarn(Object detail)	Creates a warning-level event with the given payload.
void	debug(Object detail)	Logs a debug event with the given detail.
void	debug(Object detail, Object obj)	Logs a debug event with the given detail and an additional payload.
void	error(Object detail)	Logs an error event with the given detail.
void	error(Object detail, Object obj)	Logs an error event with the given detail and an additional payload.
void	fatal(Object detail)	Logs a fatal event with the given detail.
void	fatal(Object detail, Object obj)	Logs a fatal event with the given detail and an additional payload.
Map<String,String>	getDefaultTags()	Returns an unmodifiable snapshot of the current default tags.
static Log	getLog(String logName, String realm)	Convenience factory returning a Log bound to the given logger name and realm.
Logger	getLogger()	Returns the underlying logger.
String	getRealm()	Returns the realm associated with events emitted through this Log.
void	info(Object detail)	Logs an info event with the given detail.
void	info(Object detail, Object obj)	Logs an info event with the given detail and an additional payload.
void	removeDefaultTag(String key)	Removes a previously-registered default tag.
void	setDefaultTag(String key, String value)	Sets a default tag on every event produced by this Log; a null value removes the entry.
void	setDefaultTags(Map<String,String> tags)	Replaces the entire set of default tags.
void	setLogger(Logger logger)	Replaces the underlying logger, leaving the realm unchanged.
void	setLogger(Logger logger, String realm)	Replaces the underlying logger and realm.
void	setRealm(String realm)	Replaces the realm associated with emitted events.
void	trace(Object detail)	Logs a trace event with the given detail.
void	trace(Object detail, Object obj)	Logs a trace event with the given detail and an additional payload.
void	warn(Object detail)	Logs a warning event with the given detail.
void	warn(Object detail, Object obj)	Logs a warning event with the given detail and an additional payload.

Methods inherited from class Object

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

Constructor Details

DummyPackager

public DummyPackager()

Default constructor; no instance state to initialise.

Method Details

pack

public byte[] pack(ISOComponent m)
            throws ISOException

Description copied from interface: ISOPackager

Packs an ISO-8583 message into a byte array.

Specified by:

pack in interface ISOPackager

Parameters:

m - the Component to pack

Returns:

Message image

Throws:

ISOException - on packing error

unpack

public int unpack(ISOComponent m,
 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:

m - the Container of this message

b - ISO message image

Returns:

consumed bytes

Throws:

ISOException - on unpacking error

unpack

public void unpack(ISOComponent m,
 InputStream in)
            throws ISOException

Description copied from interface: ISOPackager

Unpacks an ISO-8583 message from an input stream into the given container.

Specified by:

unpack in interface ISOPackager

Parameters:

m - the container

in - the input stream

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

createISOMsg

public ISOMsg createISOMsg()

Description copied from interface: ISOPackager

Creates and returns a new ISOMsg instance appropriate for this packager.

Specified by:

createISOMsg in interface ISOPackager

Returns:

a new ISOMsg

getDescription

public String getDescription()

Description copied from interface: ISOPackager

Returns a human-readable description of this packager.

Specified by:

getDescription in interface ISOPackager

Returns:

Packager's Description