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

Class CoinDispenserProperties

java.lang.Object

de.gmxhome.conrad.jpos.jpos_base.JposCommonProperties

de.gmxhome.conrad.jpos.jpos_base.coindispenser.CoinDispenserProperties

All Implemented Interfaces:

CoinDispenserInterface, JposBaseInterface

public class CoinDispenserProperties
extends JposCommonProperties
implements CoinDispenserInterface

Class containing the CoinDispenser specific properties, their default values and default implementations of CoinDispenserInterface. For details about properties, methods and method parameters, see UPOS specification, chapter Coin Dispenser.

Field Summary

Fields

Modifier and Type	Field	Description
boolean	CapEmptySensor	UPOS property CapEmptySensor.
boolean	CapJamSensor	UPOS property CapJamSensor.
boolean	CapNearEmptySensor	UPOS property CapNearEmptySensor.
int	DispenserStatus	UPOS property DispenserStatus.

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

AllowAlwaysSetProperties, AllowDeprecatedMethods, AsyncInputActive, AsyncMode, AutoDisable, CapStatisticsReporting, CapUpdateStatistics, CheckHealthText, Claimed, Claiming, ClaimWaiters, CurrentCommands, CurrentUnitID, DataCount, DataEventEnabled, DataEventList, Device, DeviceEnabled, DeviceServiceDescription, DeviceServiceVersion, DevProps, ErrorString, ErrorUnits, EventCB, EventList, EventSource, EventString, EventUnitID, EventUnits, ExclusiveAllowed, ExclusiveNo, ExclusiveUse, ExclusiveYes, FirstEnableHappened, FlagWhenIdle, FlagWhenIdleStatusValue, FreezeEvents, Index, LogicalName, MaximumConfirmationEventWaitingTime, OutputID, PowerNotify, PowerState, SerializedRequestRunner, SerializedRequests, State, StrictFIFOEventHandling, SuspendedCommands, SuspendedConcurrentCommands, UnitsOnline, UsesSubsystemUnits

Constructor Summary

Constructors

Constructor	Description
CoinDispenserProperties(int dev)	Constructor.

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	initOnEnable(boolean enable)	Initialization of properties that must be initialized during deviceEnable.
void	initOnOpen()	Initialization of properties that must be initialized during open.
void	readCashCounts(String[] cashCounts, boolean[] discrepancy)	Final part of ReadCashCounts method.

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

addProperties, asyncMode, attachWaiter, autoDisable, checkForDeprecation, checkHealth, checkProperties, claim, clearDataProperties, clearErrorProperties, clearInput, clearOutput, clearOutputErrorProperties, close, compareFirmwareVersion, dataEventEnabled, deviceEnabled, directIO, directIO, flagWhenIdle, freezeEvents, getClaimingInstance, handlePowerStateOnEnable, initOnClaim, initOnFirstEnable, newJposOutputRequest, open, powerNotify, release, releaseWaiter, removeFromPropertySetList, resetStatistics, retrieveStatistics, retryInput, retryOutput, signalWaiter, unitDataCount, updateFirmware, updateFirmware, updateStatistics, waitWaiter

Methods inherited from class java.lang.Object

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

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

Field Details

CapEmptySensor

public boolean CapEmptySensor

UPOS property CapEmptySensor. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method.

CapJamSensor

public boolean CapJamSensor

UPOS property CapJamSensor. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method.

CapNearEmptySensor

public boolean CapNearEmptySensor

UPOS property CapNearEmptySensor. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method.

DispenserStatus

public int DispenserStatus

UPOS property DispenserStatus.

Constructor Details

CoinDispenserProperties

public CoinDispenserProperties(int dev)

Constructor.

Parameters:

dev - Device index

Method Details

initOnOpen

public void initOnOpen()

Description copied from class: JposCommonProperties

Initialization of properties that must be initialized during open.

Overrides:

initOnOpen in class JposCommonProperties

initOnEnable

public void initOnEnable(boolean enable)

Description copied from class: JposCommonProperties

Initialization of properties that must be initialized during deviceEnable.

Overrides:

initOnEnable in class JposCommonProperties

Parameters:

enable - True: initialize properties, false: do nothing

adjustCashCounts

public void adjustCashCounts(String cashCounts)
                      throws jpos.JposException

Description copied from interface: CoinDispenserInterface

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,

Specified by:

adjustCashCounts in interface CoinDispenserInterface

Parameters:

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

Throws:

jpos.JposException - If an error occurs.

readCashCounts

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

Description copied from interface: CoinDispenserInterface

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.

Specified by:

readCashCounts in interface CoinDispenserInterface

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

public void dispenseChange(int amount)
                    throws jpos.JposException

Description copied from interface: CoinDispenserInterface

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.

Specified by:

dispenseChange in interface CoinDispenserInterface

Parameters:

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

Throws:

jpos.JposException - If an error occurs.