com.bankframe.ei.txnhandler.dataformat
Interface DataFormat

All Known Implementing Classes:

BasicDataFormat, JDBCDataFormat, TestAccountDataFormat, TestCustomerDataFormat, XMLDataFormat

public interface DataFormat

This is an interface to a Data-Format class, all Data-Format classes must use this interface.

Method Summary

Object	buildRequestTxn(DataPacket txnDataPacket, String txnCode, String txnType) This method converts a Data Packet request to a Host System format using a List of Transaction Fields.
boolean	moreToRequest() More Packets to process from host system, the method toDataPackets() sets this flag if it determines that there is more data to be requested from the host system.
void	notifyProcessingFinished() This method is called by the Transaction Handler bean when all processing for a transaction is complete.
void	toDataPacketsMap(Object txnData, Map responseEntitiesMap, DataPacket txnDataPacket, String txnCode, String txnType) This method converts the Vector of Host System Txn Fields byte-array elements into a Map of Data Packets, this method is called by the txn handler method processFindRequest( )
void	toDataPacketsVector(Object txnData, Vector responseEntitiesVector, DataPacket txnDataPacket, String txnCode, String txnType) This method converts the Vector of Host System Txn Fields byte-array elements into a Vector of result Data Packets, this method is called by the txn handler method processRequest( )

Method Detail

buildRequestTxn

Object buildRequestTxn(DataPacket txnDataPacket,
                       String txnCode,
                       String txnType)
                       throws ProcessingErrorException

This method converts a Data Packet request to a Host System format using a List of Transaction Fields.

Parameters:

txnDataPacket - is DataPacket of transaction settings

txnCode - is the transaction code

txnType - is the transaction type

Returns:

Host System formatted Object

Throws:

ProcessingErrorException

moreToRequest

boolean moreToRequest()

More Packets to process from host system, the method toDataPackets() sets this flag if it determines that there is more data to be requested from the host system. This is required for systems that break the response into sub-parts. Transaction Handler checks this to determine if another request is to be posted to the host system..

Returns:

boolean indicating more data to request

notifyProcessingFinished

void notifyProcessingFinished()

This method is called by the Transaction Handler bean when all processing for a transaction is complete. This allows the Data-Format class to clean up any temporary data and variables.

toDataPacketsMap

void toDataPacketsMap(Object txnData,
                      Map responseEntitiesMap,
                      DataPacket txnDataPacket,
                      String txnCode,
                      String txnType)
                      throws ProcessingErrorException,
                             HostProcessingErrorException

This method converts the Vector of Host System Txn Fields byte-array elements into a Map of Data Packets, this method is called by the txn handler method processFindRequest( )

Parameters:

txnData - data from host system.

responseEntitiesMap - is Map of Data Packet entities created.

txnDataPacket - DataPacket of request settings.

txnCode - is transaction code

txnType - is transaction type

Throws:

ProcessingErrorException

HostProcessingErrorException

toDataPacketsVector

void toDataPacketsVector(Object txnData,
                         Vector responseEntitiesVector,
                         DataPacket txnDataPacket,
                         String txnCode,
                         String txnType)
                         throws ProcessingErrorException,
                                HostProcessingErrorException

This method converts the Vector of Host System Txn Fields byte-array elements into a Vector of result Data Packets, this method is called by the txn handler method processRequest( )

Parameters:

txnData - data from host system.

responseEntitiesVector - is Vector of Data Packet entities updated/created from host system data.

txnDataPacket - DataPacket of request settings.

txnCode - is transaction code

txnType - is transaction type

Throws:

ProcessingErrorException

HostProcessingErrorException