Package de.gmxhome.conrad.jpos.jpos_base.coindispenser

Interface CoinDispenserInterface

All Superinterfaces:

JposBaseInterface

All Known Implementing Classes:

CoinDispenserProperties

public interface CoinDispenserInterface
extends JposBaseInterface

Interface for methods that implement property setter and method calls for the CoinDispenser device category. For details about properties, methods and method parameters, see UPOS specification, chapter Coin Dispenser. Further details about error handling can be found in introduction - Device Behavior Models - Errors.

Method Summary

Modifier and Type	Method	Description
void	adjustCashCounts(String cashCounts)	Final part of AdjustCashCounts method.
void	dispenseChange(int amount)	Final part of DispenseChange method.
void	readCashCounts(String[] cashCounts, boolean[] discrepancy)	Final part of ReadCashCounts method.

Methods inherited from interface de.gmxhome.conrad.jpos.jpos_base.JposBaseInterface

asyncMode, autoDisable, checkHealth, claim, clearInput, clearOutput, close, compareFirmwareVersion, dataEventEnabled, deviceEnabled, directIO, directIO, flagWhenIdle, freezeEvents, handlePowerStateOnEnable, newJposOutputRequest, open, powerNotify, release, removeFromPropertySetList, resetStatistics, retrieveStatistics, retryInput, retryOutput, unitDataCount, updateFirmware, updateFirmware, updateStatistics

Method Details

adjustCashCounts

void adjustCashCounts(String cashCounts)
               throws jpos.JposException

Final part of AdjustCashCounts method. Can be overwritten within derived classes, if necessary. This method will be called only if the following plausibility checks lead to a positive result:

• Device is enabled,
• cashCounts is a string consisting of comma separated pairs of double-point separated positive integer values,
• The second value of each pair is > 0,

Parameters:

cashCounts - The cashCounts parameter contains cash types and amounts to be initialized.

Throws:

jpos.JposException - If an error occurs.

readCashCounts

void readCashCounts(String[] cashCounts,
 boolean[] discrepancy)
             throws jpos.JposException

Final part of ReadCashCounts method. Can be overwritten within derived classes, if necessary. This method will be called only if the following plausibility checks lead to a positive result:

• Device is enabled,
• Both parameters are arrays with dimension 1.

Parameters:

cashCounts - The cash count data is placed into cashCounts.

discrepancy - If discrepancy is set to true by this method, then there is some cash which was not able to be included in the counts reported in cashCounts. Otherwise it is set to false.

Throws:

jpos.JposException - If an error occurs.

dispenseChange

void dispenseChange(int amount)
             throws jpos.JposException

Final part of DispenseChange method. Can be overwritten within derived classes, if necessary. This method will be called only if the following plausibility checks lead to a positive result:

• Device is enabled,
• The given amount is > 0.

Parameters:

amount - The amount parameter contains the amount of change to be dispensed.

Throws:

jpos.JposException - If an error occurs.