Package de.gmxhome.conrad.jpos.jpos_base.msr

Class MSRService

java.lang.Object

de.gmxhome.conrad.jpos.jpos_base.JposBase

de.gmxhome.conrad.jpos.jpos_base.msr.MSRService

All Implemented Interfaces:

jpos.loader.JposServiceInstance, jpos.services.BaseService, jpos.services.MSRService110, jpos.services.MSRService111, jpos.services.MSRService112, jpos.services.MSRService113, jpos.services.MSRService114, jpos.services.MSRService115, jpos.services.MSRService116, jpos.services.MSRService12, jpos.services.MSRService13, jpos.services.MSRService14, jpos.services.MSRService15, jpos.services.MSRService16, jpos.services.MSRService17, jpos.services.MSRService18, jpos.services.MSRService19

public class MSRService
extends JposBase
implements jpos.services.MSRService116

MSR service implementation. For more details about getter, setter and method implementations, see JposBase.

Field Summary

Fields

Modifier and Type	Field	Description
MSRInterface	MSRInterface	Instance of a class implementing the MSRInterface for magnetic stripe reader specific setter and method calls bound to the property set.

Fields inherited from class de.gmxhome.conrad.jpos.jpos_base.JposBase

Device, DeviceInterface, Props

Constructor Summary

Constructors

Constructor	Description
MSRService(MSRProperties props, JposDevice device)	Constructor.

Method Summary

Modifier and Type	Method	Description
void	authenticateDevice(byte[] response)
void	clearInputProperties()	Common method clearInputProperties, see UPOS specification
void	deauthenticateDevice(byte[] response)
String	getAccountNumber()
byte[]	getAdditionalSecurityInformation()
String	getCapCardAuthentication()
int	getCapDataEncryption()
int	getCapDeviceAuthentication()
boolean	getCapISO()
boolean	getCapJISOne()
boolean	getCapJISTwo()
boolean	getCapTrackDataMasking()
boolean	getCapTransmitSentinels()
int	getCapWritableTracks()
byte[]	getCardAuthenticationData()
int	getCardAuthenticationDataLength()
String	getCardPropertyList()
String	getCardType()
String	getCardTypeList()
int	getDataEncryptionAlgorithm()
boolean	getDecodeData()
boolean	getDeviceAuthenticated()
int	getDeviceAuthenticationProtocol()
int	getEncodingMaxLength()
int	getErrorReportingType()
String	getExpirationDate()
String	getFirstName()
String	getMiddleInitial()
boolean	getParseDecodeData()
String	getServiceCode()
String	getSuffix()
String	getSurname()
String	getTitle()
byte[]	getTrack1Data()
byte[]	getTrack1DiscretionaryData()
byte[]	getTrack1EncryptedData()
int	getTrack1EncryptedDataLength()
byte[]	getTrack2Data()
byte[]	getTrack2DiscretionaryData()
byte[]	getTrack2EncryptedData()
int	getTrack2EncryptedDataLength()
byte[]	getTrack3Data()
byte[]	getTrack3EncryptedData()
int	getTrack3EncryptedDataLength()
byte[]	getTrack4Data()
byte[]	getTrack4EncryptedData()
int	getTrack4EncryptedDataLength()
int	getTracksToRead()
int	getTracksToWrite()
boolean	getTransmitSentinels()
String	getWriteCardType()
void	retrieveCardProperty(String name, String[] value)
void	retrieveDeviceAuthenticationData(byte[] challenge)
void	retrieveDeviceAuthenticationData(byte[][] challenge)
void	setDataEncryptionAlgorithm(int i)
void	setDecodeData(boolean b)
void	setErrorReportingType(int i)
void	setParseDecodeData(boolean b)
void	setTracksToRead(int i)
void	setTracksToWrite(int i)
void	setTransmitSentinels(boolean b)
void	setWriteCardType(String s)
void	updateKey(String key, String keyName)
void	writeTracks(byte[][] data, int timeout)

Methods inherited from class de.gmxhome.conrad.jpos.jpos_base.JposBase

callNowOrLater, check, check, check, check, checkBusy, checkClaimed, checkEnabled, checkEnabledUnclaimed, checkFirstEnabled, checkHealth, checkNoChangedOrClaimed, checkOpened, claim, clearInput, clearOutput, close, compareFirmwareVersion, deepToString, deleteInstance, directIO, getAsyncMode, getAutoDisable, getCapCompareFirmwareVersion, getCapPowerReporting, getCapStatisticsReporting, getCapUpdateFirmware, getCapUpdateStatistics, getCheckHealthText, getClaimed, getDataCount, getDataEventEnabled, getDeviceEnabled, getDeviceServiceDescription, getDeviceServiceVersion, getFreezeEvents, getOutputID, getPhysicalDeviceDescription, getPhysicalDeviceName, getPowerNotify, getPowerState, getPropertyString, getState, logAsyncCall, logCall, logCall, logGet, logGet, logPreCall, logPreCall, logPreSet, logSet, open, release, removeOuterArraySpecifier, resetStatistics, retrieveStatistics, setAsyncMode, setAutoDisable, setDataEventEnabled, setDeviceEnabled, setFreezeEvents, setPowerNotify, signalRelease, startClaiming, updateFirmware, updateStatistics

Methods inherited from class java.lang.Object

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

Methods inherited from interface jpos.services.BaseService

checkHealth, claim, close, directIO, getCheckHealthText, getClaimed, getDeviceEnabled, getDeviceServiceDescription, getDeviceServiceVersion, getFreezeEvents, getPhysicalDeviceDescription, getPhysicalDeviceName, getState, open, release, setDeviceEnabled, setFreezeEvents

Methods inherited from interface jpos.loader.JposServiceInstance

deleteInstance

Methods inherited from interface jpos.services.MSRService12

clearInput, getAutoDisable, getDataCount, getDataEventEnabled, setAutoDisable, setDataEventEnabled

Methods inherited from interface jpos.services.MSRService13

getCapPowerReporting, getPowerNotify, getPowerState, setPowerNotify

Methods inherited from interface jpos.services.MSRService18

getCapStatisticsReporting, getCapUpdateStatistics, resetStatistics, retrieveStatistics, updateStatistics

Methods inherited from interface jpos.services.MSRService19

compareFirmwareVersion, getCapCompareFirmwareVersion, getCapUpdateFirmware, updateFirmware

Field Details

MSRInterface

public MSRInterface MSRInterface

Instance of a class implementing the MSRInterface for magnetic stripe reader specific setter and method calls bound to the property set. Almost always the same object as Data.

Constructor Details

MSRService

public MSRService(MSRProperties props,
 JposDevice device)

Constructor. Stores given property set and device implementation object.

Parameters:

props - Property set.

device - Device implementation object.

Method Details

getCapCardAuthentication

public String getCapCardAuthentication()
                                throws jpos.JposException

Specified by:

getCapCardAuthentication in interface jpos.services.MSRService112

Throws:

jpos.JposException

getCapDataEncryption

public int getCapDataEncryption()
                         throws jpos.JposException

Specified by:

getCapDataEncryption in interface jpos.services.MSRService112

Throws:

jpos.JposException

getCapDeviceAuthentication

public int getCapDeviceAuthentication()
                               throws jpos.JposException

Specified by:

getCapDeviceAuthentication in interface jpos.services.MSRService112

Throws:

jpos.JposException

getCapTrackDataMasking

public boolean getCapTrackDataMasking()
                               throws jpos.JposException

Specified by:

getCapTrackDataMasking in interface jpos.services.MSRService112

Throws:

jpos.JposException

getCapWritableTracks

public int getCapWritableTracks()
                         throws jpos.JposException

Specified by:

getCapWritableTracks in interface jpos.services.MSRService110

Throws:

jpos.JposException

getCapTransmitSentinels

public boolean getCapTransmitSentinels()
                                throws jpos.JposException

Specified by:

getCapTransmitSentinels in interface jpos.services.MSRService15

Throws:

jpos.JposException

getCapISO

public boolean getCapISO()
                  throws jpos.JposException

Specified by:

getCapISO in interface jpos.services.MSRService12

Throws:

jpos.JposException

getCapJISOne

public boolean getCapJISOne()
                     throws jpos.JposException

Specified by:

getCapJISOne in interface jpos.services.MSRService12

Throws:

jpos.JposException

getCapJISTwo

public boolean getCapJISTwo()
                     throws jpos.JposException

Specified by:

getCapJISTwo in interface jpos.services.MSRService12

Throws:

jpos.JposException

getAdditionalSecurityInformation

public byte[] getAdditionalSecurityInformation()
                                        throws jpos.JposException

Specified by:

getAdditionalSecurityInformation in interface jpos.services.MSRService112

Throws:

jpos.JposException

getCardAuthenticationData

public byte[] getCardAuthenticationData()
                                 throws jpos.JposException

Specified by:

getCardAuthenticationData in interface jpos.services.MSRService112

Throws:

jpos.JposException

getCardAuthenticationDataLength

public int getCardAuthenticationDataLength()
                                    throws jpos.JposException

Specified by:

getCardAuthenticationDataLength in interface jpos.services.MSRService112

Throws:

jpos.JposException

getCardPropertyList

public String getCardPropertyList()
                           throws jpos.JposException

Specified by:

getCardPropertyList in interface jpos.services.MSRService112

Throws:

jpos.JposException

getCardType

public String getCardType()
                   throws jpos.JposException

Specified by:

getCardType in interface jpos.services.MSRService112

Throws:

jpos.JposException

getCardTypeList

public String getCardTypeList()
                       throws jpos.JposException

Specified by:

getCardTypeList in interface jpos.services.MSRService112

Throws:

jpos.JposException

getDataEncryptionAlgorithm

public int getDataEncryptionAlgorithm()
                               throws jpos.JposException

Specified by:

getDataEncryptionAlgorithm in interface jpos.services.MSRService112

Throws:

jpos.JposException

setDataEncryptionAlgorithm

public void setDataEncryptionAlgorithm(int i)
                                throws jpos.JposException

Specified by:

setDataEncryptionAlgorithm in interface jpos.services.MSRService112

Throws:

jpos.JposException

getDeviceAuthenticated

public boolean getDeviceAuthenticated()
                               throws jpos.JposException

Specified by:

getDeviceAuthenticated in interface jpos.services.MSRService112

Throws:

jpos.JposException

getDeviceAuthenticationProtocol

public int getDeviceAuthenticationProtocol()
                                    throws jpos.JposException

Specified by:

getDeviceAuthenticationProtocol in interface jpos.services.MSRService112

Throws:

jpos.JposException

getTrack1EncryptedData

public byte[] getTrack1EncryptedData()
                              throws jpos.JposException

Specified by:

getTrack1EncryptedData in interface jpos.services.MSRService112

Throws:

jpos.JposException

getTrack1EncryptedDataLength

public int getTrack1EncryptedDataLength()
                                 throws jpos.JposException

Specified by:

getTrack1EncryptedDataLength in interface jpos.services.MSRService112

Throws:

jpos.JposException

getTrack2EncryptedData

public byte[] getTrack2EncryptedData()
                              throws jpos.JposException

Specified by:

getTrack2EncryptedData in interface jpos.services.MSRService112

Throws:

jpos.JposException

getTrack2EncryptedDataLength

public int getTrack2EncryptedDataLength()
                                 throws jpos.JposException

Specified by:

getTrack2EncryptedDataLength in interface jpos.services.MSRService112

Throws:

jpos.JposException

getTrack3EncryptedData

public byte[] getTrack3EncryptedData()
                              throws jpos.JposException

Specified by:

getTrack3EncryptedData in interface jpos.services.MSRService112

Throws:

jpos.JposException

getTrack3EncryptedDataLength

public int getTrack3EncryptedDataLength()
                                 throws jpos.JposException

Specified by:

getTrack3EncryptedDataLength in interface jpos.services.MSRService112

Throws:

jpos.JposException

getTrack4EncryptedData

public byte[] getTrack4EncryptedData()
                              throws jpos.JposException

Specified by:

getTrack4EncryptedData in interface jpos.services.MSRService112

Throws:

jpos.JposException

getTrack4EncryptedDataLength

public int getTrack4EncryptedDataLength()
                                 throws jpos.JposException

Specified by:

getTrack4EncryptedDataLength in interface jpos.services.MSRService112

Throws:

jpos.JposException

getWriteCardType

public String getWriteCardType()
                        throws jpos.JposException

Specified by:

getWriteCardType in interface jpos.services.MSRService112

Throws:

jpos.JposException

setWriteCardType

public void setWriteCardType(String s)
                      throws jpos.JposException

Specified by:

setWriteCardType in interface jpos.services.MSRService112

Throws:

jpos.JposException

getEncodingMaxLength

public int getEncodingMaxLength()
                         throws jpos.JposException

Specified by:

getEncodingMaxLength in interface jpos.services.MSRService110

Throws:

jpos.JposException

getTracksToWrite

public int getTracksToWrite()
                     throws jpos.JposException

Specified by:

getTracksToWrite in interface jpos.services.MSRService110

Throws:

jpos.JposException

setTracksToWrite

public void setTracksToWrite(int i)
                      throws jpos.JposException

Specified by:

setTracksToWrite in interface jpos.services.MSRService110

Throws:

jpos.JposException

getTrack4Data

public byte[] getTrack4Data()
                     throws jpos.JposException

Specified by:

getTrack4Data in interface jpos.services.MSRService15

Throws:

jpos.JposException

getTransmitSentinels

public boolean getTransmitSentinels()
                             throws jpos.JposException

Specified by:

getTransmitSentinels in interface jpos.services.MSRService15

Throws:

jpos.JposException

setTransmitSentinels

public void setTransmitSentinels(boolean b)
                          throws jpos.JposException

Specified by:

setTransmitSentinels in interface jpos.services.MSRService15

Throws:

jpos.JposException

getAccountNumber

public String getAccountNumber()
                        throws jpos.JposException

Specified by:

getAccountNumber in interface jpos.services.MSRService12

Throws:

jpos.JposException

getDecodeData

public boolean getDecodeData()
                      throws jpos.JposException

Specified by:

getDecodeData in interface jpos.services.MSRService12

Throws:

jpos.JposException

setDecodeData

public void setDecodeData(boolean b)
                   throws jpos.JposException

Specified by:

setDecodeData in interface jpos.services.MSRService12

Throws:

jpos.JposException

getErrorReportingType

public int getErrorReportingType()
                          throws jpos.JposException

Specified by:

getErrorReportingType in interface jpos.services.MSRService12

Throws:

jpos.JposException

setErrorReportingType

public void setErrorReportingType(int i)
                           throws jpos.JposException

Specified by:

setErrorReportingType in interface jpos.services.MSRService12

Throws:

jpos.JposException

getExpirationDate

public String getExpirationDate()
                         throws jpos.JposException

Specified by:

getExpirationDate in interface jpos.services.MSRService12

Throws:

jpos.JposException

getFirstName

public String getFirstName()
                    throws jpos.JposException

Specified by:

getFirstName in interface jpos.services.MSRService12

Throws:

jpos.JposException

getMiddleInitial

public String getMiddleInitial()
                        throws jpos.JposException

Specified by:

getMiddleInitial in interface jpos.services.MSRService12

Throws:

jpos.JposException

getParseDecodeData

public boolean getParseDecodeData()
                           throws jpos.JposException

Specified by:

getParseDecodeData in interface jpos.services.MSRService12

Throws:

jpos.JposException

setParseDecodeData

public void setParseDecodeData(boolean b)
                        throws jpos.JposException

Specified by:

setParseDecodeData in interface jpos.services.MSRService12

Throws:

jpos.JposException

getServiceCode

public String getServiceCode()
                      throws jpos.JposException

Specified by:

getServiceCode in interface jpos.services.MSRService12

Throws:

jpos.JposException

getSuffix

public String getSuffix()
                 throws jpos.JposException

Specified by:

getSuffix in interface jpos.services.MSRService12

Throws:

jpos.JposException

getSurname

public String getSurname()
                  throws jpos.JposException

Specified by:

getSurname in interface jpos.services.MSRService12

Throws:

jpos.JposException

getTitle

public String getTitle()
                throws jpos.JposException

Specified by:

getTitle in interface jpos.services.MSRService12

Throws:

jpos.JposException

getTrack1Data

public byte[] getTrack1Data()
                     throws jpos.JposException

Specified by:

getTrack1Data in interface jpos.services.MSRService12

Throws:

jpos.JposException

getTrack1DiscretionaryData

public byte[] getTrack1DiscretionaryData()
                                  throws jpos.JposException

Specified by:

getTrack1DiscretionaryData in interface jpos.services.MSRService12

Throws:

jpos.JposException

getTrack2Data

public byte[] getTrack2Data()
                     throws jpos.JposException

Specified by:

getTrack2Data in interface jpos.services.MSRService12

Throws:

jpos.JposException

getTrack2DiscretionaryData

public byte[] getTrack2DiscretionaryData()
                                  throws jpos.JposException

Specified by:

getTrack2DiscretionaryData in interface jpos.services.MSRService12

Throws:

jpos.JposException

getTrack3Data

public byte[] getTrack3Data()
                     throws jpos.JposException

Specified by:

getTrack3Data in interface jpos.services.MSRService12

Throws:

jpos.JposException

getTracksToRead

public int getTracksToRead()
                    throws jpos.JposException

Specified by:

getTracksToRead in interface jpos.services.MSRService12

Throws:

jpos.JposException

setTracksToRead

public void setTracksToRead(int i)
                     throws jpos.JposException

Specified by:

setTracksToRead in interface jpos.services.MSRService12

Throws:

jpos.JposException

clearInputProperties

public void clearInputProperties()
                          throws jpos.JposException

Description copied from class: JposBase

Common method clearInputProperties, see UPOS specification

Specified by:

clearInputProperties in interface jpos.services.MSRService110

Overrides:

clearInputProperties in class JposBase

Throws:

jpos.JposException - see UPOS specification

authenticateDevice

public void authenticateDevice(byte[] response)
                        throws jpos.JposException

Specified by:

authenticateDevice in interface jpos.services.MSRService112

Throws:

jpos.JposException

deauthenticateDevice

public void deauthenticateDevice(byte[] response)
                          throws jpos.JposException

Specified by:

deauthenticateDevice in interface jpos.services.MSRService112

Throws:

jpos.JposException

retrieveCardProperty

public void retrieveCardProperty(String name,
 String[] value)
                          throws jpos.JposException

Specified by:

retrieveCardProperty in interface jpos.services.MSRService112

Throws:

jpos.JposException

retrieveDeviceAuthenticationData

public void retrieveDeviceAuthenticationData(byte[][] challenge)
                                      throws jpos.JposException

Specified by:

retrieveDeviceAuthenticationData in interface jpos.services.MSRService113

Throws:

jpos.JposException

retrieveDeviceAuthenticationData

public void retrieveDeviceAuthenticationData(byte[] challenge)
                                      throws jpos.JposException

Specified by:

retrieveDeviceAuthenticationData in interface jpos.services.MSRService112

Throws:

jpos.JposException

updateKey

public void updateKey(String key,
 String keyName)
               throws jpos.JposException

Specified by:

updateKey in interface jpos.services.MSRService112

Throws:

jpos.JposException

writeTracks

public void writeTracks(byte[][] data,
 int timeout)
                 throws jpos.JposException

Specified by:

writeTracks in interface jpos.services.MSRService110

Throws:

jpos.JposException