Class VISA1Packager

java.lang.Object

org.jpos.util.SimpleLogSource

org.jpos.iso.packager.VISA1Packager

All Implemented Interfaces:

ISOPackager, VISA1ResponseFilter, LogSource

public class VISA1Packager
extends SimpleLogSource
implements ISOPackager, VISA1ResponseFilter

ISO-8583 packager for the VISA-1 message format.

See Also:

• ISOPackager
• ISOBasePackager
• ISOComponent

Field Summary

Fields

Modifier and Type	Field	Description
static final byte[]	FS	ASCII Field Separator (0x1C) used between VISA1 sub-fields.

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.

Constructor Summary

Constructors

Constructor	Description
VISA1Packager(int[] sequence, int respField, String badResultCode, String okPattern)	Constructs a VISA1Packager with the given field sequence and response-handling rules.

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.
String	guessAutNumber(String s)	Inspects response and returns the embedded authorization number, if any.
protected int	handleSpecialField35(ISOMsg m, ByteArrayOutputStream bout)	Handles the VISA1-specific encoding of field 35 (track-2 data with entry mode).
byte[]	pack(ISOComponent c)	Packs an ISO-8583 message into a byte array.
void	setVISA1ResponseFilter(VISA1ResponseFilter filter)	Replaces the VISA1 response filter used to inspect inbound responses.
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 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

FS

public static final byte[] FS

ASCII Field Separator (0x1C) used between VISA1 sub-fields.

Constructor Details

VISA1Packager

public VISA1Packager(int[] sequence,
 int respField,
 String badResultCode,
 String okPattern)

Constructs a VISA1Packager with the given field sequence and response-handling rules.

Parameters:

sequence - array of fields that go to VISA1 request

respField - where to put response

badResultCode - (i.e. "05")

okPattern - (i.e. "AUT. ")

Method Details

setVISA1ResponseFilter

public void setVISA1ResponseFilter(VISA1ResponseFilter filter)

Replaces the VISA1 response filter used to inspect inbound responses.

Parameters:

filter - the new response filter

handleSpecialField35

protected int handleSpecialField35(ISOMsg m,
 ByteArrayOutputStream bout)
                            throws ISOException,
IOException

Handles the VISA1-specific encoding of field 35 (track-2 data with entry mode).

Parameters:

m - message being packed

bout - destination byte stream

Returns:

number of bytes written

Throws:

ISOException - on field-access failure

IOException - if writing to bout fails

pack

public 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

guessAutNumber

public String guessAutNumber(String s)

Description copied from interface: VISA1ResponseFilter

Inspects response and returns the embedded authorization number, if any.

Specified by:

guessAutNumber in interface VISA1ResponseFilter

Parameters:

s - raw VISA1 response payload

Returns:

authorization number or null

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

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

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