Class ElectronicValueRWProperties
java.lang.Object
de.gmxhome.conrad.jpos.jpos_base.JposCommonProperties
de.gmxhome.conrad.jpos.jpos_base.electronicvaluerw.ElectronicValueRWProperties
- All Implemented Interfaces:
ElectronicValueRWInterface,JposBaseInterface
public class ElectronicValueRWProperties
extends JposCommonProperties
implements ElectronicValueRWInterface
Class containing the electronic value reader / writer specific properties, their default values and default implementations of
ElectronicValueRWInterface.
For details about properties, methods and method parameters, see UPOS specification, chapter Electronic Value Reader / Writer.
-
Field Summary
FieldsModifier and TypeFieldDescriptionUPOS property AccountNumber.UPOS property AdditionalSecurityInformation.longUPOS property Amount.UPOS property ApprovalCode.longUPOS property Balance.longUPOS property BalanceOfPoint.booleanUPOS property CapActivateService.booleanUPOS property CapAdditionalSecurityInformation.booleanUPOS property CapAddValue.booleanUPOS property CapAuthorizeCompletion.booleanUPOS property CapAuthorizePreSales.booleanUPOS property CapAuthorizeRefund.booleanUPOS property CapAuthorizeVoid.booleanUPOS property CapAuthorizeVoidPreSales.booleanUPOS property CapCancelValue.intUPOS property CapCardSensor.booleanUPOS property CapCashDeposit.booleanUPOS property CapCenterResultCode.booleanUPOS property CapCheckCard.intUPOS property CapDailyLog.intUPOS property CapDetectionControl.booleanUPOS property CapElectronicMoney.booleanUPOS property CapEnumerateCardServices.booleanUPOS property CapIndirectTransactionLog.booleanUPOS property CapInstallments.booleanUPOS property CapLockTerminal.booleanUPOS property CapLogStatus.booleanUPOS property CapMediumID.booleanUPOS property CapMembershipCertificate.booleanUPOS property CapPaymentDetail.booleanUPOS property CapPINDevice.booleanUPOS property CapPoint.booleanUPOS property CapSubtractValue.booleanUPOS property CapTaxOthers.booleanUPOS property CapTrainingMode.booleanUPOS property CapTransaction.booleanUPOS property CapTransactionLog.booleanUPOS property CapTransactionNumber.booleanUPOS property CapUnlockTerminal.booleanUPOS property CapUpdateKey.booleanUPOS property CapVoucher.booleanUPOS property CapWriteValue.UPOS property CardCompanyID.UPOS property CardServiceList.UPOS property CenterResultCode.UPOS property CurrentService.UPOS property DailyLog.booleanUPOS property DetectionControl.intUPOS property DetectionStatus.UPOS property ExpirationDate.UPOS property LastUsedDate.UPOS property LogStatus.UPOS property MediumID.Deprecated.UPOS property PaymentCondition.UPOS property PaymentDetail.intUPOS property PaymentMedia.intUPOS property PINEntry.longUPOS property Point.UPOS property ReaderWriterServiceList.Deprecated.intUPOS property SequenceNumber.intUPOS property ServiceType.longUPOS property SettledAmount.longUPOS property SettledPoint.UPOS property SlipNumber.booleanSpecifies whether enumeration values will be checked against the list of enumerations specified in the corresponding UPOS specification (true) or not (false).intUPOS property TrainingModeState.UPOS property TransactionLog.UPOS property TransactionNumber.intUPOS property TransactionType.Tag names and values set by setParameterInformation.Tag names and values hold for method retrieveResultInformation.booleanSpecifies whether enumerated values will be passed by value (true) or by name (false).UPOS property VoucherID.UPOS property VoucherIDList.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 -
Method Summary
Modifier and TypeMethodDescriptionaccessDailyLog(int sequenceNumber, int type, int timeout)Validation part of AccessDailyLog method.voidaccessDailyLog(AccessDailyLog request)Final part of AccessData method.accessData(int dataType, int[] data, Object[] obj)Validation part of AccessData method.voidaccessData(AccessData request)Final part of AccessData method.accessLog(int sequenceNumber, int type, int timeout)Validation part of AccessLog method.voidFinal part of AccessLog method.activateEVService(int[] data, Object[] obj)Validation part of ActivateEVService method.voidactivateEVService(ActivateEVService request)Final part of ActivateEVService method.activateService(int[] data, Object[] obj)Validation part of ActivateService method.voidactivateService(ActivateService request)Final part of ActivateService method.voidadditionalSecurityInformation(String addInfo)Final part of setting AdditionalSecurityInformation.addValue(int sequenceNumber, int timeout)Validation part of AddValue method.voidFinal part of AddValue method.voidamount(long amount)Final part of setting Amount.voidapprovalCode(String code)Final part of setting ApprovalCode.authorizeCompletion(int sequenceNumber, long amount, long taxOthers, int timeout)Validation part of AuthorizeCompletion method.voidauthorizeCompletion(AuthorizeCompletion request)Final part of AuthorizeCompletion method.authorizePreSales(int sequenceNumber, long amount, long taxOthers, int timeout)Validation part of AuthorizePreSales method.voidauthorizePreSales(AuthorizePreSales request)Final part of AuthorizePreSales method.authorizeRefund(int sequenceNumber, long amount, long taxOthers, int timeout)Validation part of AuthorizeRefund method.voidauthorizeRefund(AuthorizeRefund request)Final part of AuthorizeRefund method.authorizeSales(int sequenceNumber, long amount, long taxOthers, int timeout)Validation part of AuthorizeSales method.voidauthorizeSales(AuthorizeSales request)Final part of AuthorizeSales method.authorizeVoid(int sequenceNumber, long amount, long taxOthers, int timeout)Validation part of AuthorizeVoid method.voidauthorizeVoid(AuthorizeVoid request)Final part of AuthorizeVoid method.authorizeVoidPreSales(int sequenceNumber, long amount, long taxOthers, int timeout)Validation part of AuthorizeVoidPreSales method.voidauthorizeVoidPreSales(AuthorizeVoidPreSales request)Final part of AuthorizeVoidPreSales method.voidbeginDetection(int type, int timeout)final part of BeginDetection method.voidbeginRemoval(int timeout)final part of BeginRemoval method.cancelValue(int sequenceNumber, int timeout)Validation part of CancelValue method.voidcancelValue(CancelValue request)Final part of CancelValue method.voidfinal part of CaptureCard method.cashDeposit(int sequenceNumber, long amount, int timeout)Validation part of CashDeposit method.voidcashDeposit(CashDeposit request)Final part of CashDeposit method.checkCard(int sequenceNumber, int timeout)Validation part of CheckCard method.voidFinal part of CheckCard method.voidcheckProperties(jpos.config.JposEntry entry)Checks jpos entries for service specific jpos property values and set corresponding service values.checkServiceRegistrationToMedium(int sequenceNumber, int timeout)Validation part of CheckServiceRegistrationToMedium method.voidFinal part of CheckServiceRegistrationToMedium method.jpos.JposExceptioncheckTagValueFormat(String tag, String value)Method to verify whether the format of a value matches the format specified for the given tag.voidfinal part of ClearParameterInformation method.closeDailyEVService(int[] data, Object[] obj)Validation part of CloseDailyEVService method.voidcloseDailyEVService(CloseDailyEVService request)Final part of CloseDailyEVService method.voidcurrentService(String service)Final part of setting CurrentService.deactivateEVService(int[] data, Object[] obj)Validation part of DeactivateEVService method.voiddeactivateEVService(DeactivateEVService request)Final part of DeactivateEVService method.voiddetectionControl(boolean flag)Final part of setting DetectionControl.voidfinal part of ClearParameterInformation method.voidfinal part of ClearParameterInformation method.voidfinal part of EnumerateCardServices method.getEnumTagFromPropertyValue(String name, int value)Convert property value into tag value.getPropertyValueFromEnumTag(String name, int value)Deprecated.getPropertyValueFromEnumTag(String name, String valstr)Deprecated.voidInitialize properties that must be initialized whenever the device will be claimed.voidInitialization of properties that must be initialized during open.Validation part of LockTerminal method.voidlockTerminal(LockTerminal request)Final part of LockTerminal method.voidFinal part of setting MediumID.openDailyEVService(int[] data, Object[] obj)Validation part of OpenDailyEVService method.voidopenDailyEVService(OpenDailyEVService request)Final part of OpenDailyEVService method.voidpaymentMedia(int media)Final part of setting PaymentMedia.voidPINEntry(int value)Final part of setting PINEntry.voidpoint(long count)Final part of setting Point.Validation part of QueryLastSuccessfulTransactionResult method.voidFinal part of QueryLastSuccessfulTransactionResult method.readValue(int sequenceNumber, int timeout)Validation part of ReadValue method.voidFinal part of ReadValue method.registerServiceToMedium(int sequenceNumber, int timeout)Validation part of RegisterServiceToMedium method.voidFinal part of RegisterServiceToMedium method.voidretrieveResultInformation(String name, String[] value)final part of RetrieveResultInformation method.voidsetParameterInformation(String name, String value)final part of SetParameterInformation method.subtractValue(int sequenceNumber, int timeout)Validation part of SubtractValue method.voidsubtractValue(SubtractValue request)Final part of SubtractValue method.voidtrainingModeState(int state)Final part of setting TrainingModeState.transactionAccess(int control)Validation part of TransactionAccess method.voidtransactionAccess(TransactionAccess request)Final part of TransactionAccess method.Validation part of UnlockTerminal method.voidunlockTerminal(UnlockTerminal request)Final part of UnlockTerminal method.unregisterServiceToMedium(int sequenceNumber, int timeout)Validation part of UnregisterServiceToMedium method.voidFinal part of UnregisterServiceToMedium method.updateData(int dataType, int[] data, Object[] obj)Validation part of UpdateData method.voidupdateData(UpdateData request)Final part of UpdateData method.Validation part of UpdateKey method.voidFinal part of UpdateKey method.voidFinal part of setting VoucherID.voidvoucherIDList(String ids)Final part of setting VoucherIDList.writeValue(int sequenceNumber, int timeout)Validation part of WriteValue method.voidwriteValue(WriteValue request)Final part of WriteValue method.Methods inherited from class de.gmxhome.conrad.jpos.jpos_base.JposCommonProperties
addProperties, asyncMode, attachWaiter, autoDisable, checkForDeprecation, checkHealth, claim, clearDataProperties, clearErrorProperties, clearInput, clearOutput, clearOutputErrorProperties, close, compareFirmwareVersion, dataEventEnabled, deviceEnabled, directIO, directIO, flagWhenIdle, freezeEvents, getClaimingInstance, handlePowerStateOnEnable, initOnEnable, initOnFirstEnable, newJposOutputRequest, open, powerNotify, release, releaseWaiter, removeFromPropertySetList, resetStatistics, retrieveStatistics, retryInput, retryOutput, signalWaiter, unitDataCount, updateFirmware, updateFirmware, updateStatistics, waitWaiterMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods 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
-
AccountNumber
UPOS property AccountNumber. -
AdditionalSecurityInformation
UPOS property AdditionalSecurityInformation. -
Amount
public long AmountUPOS property Amount. -
ApprovalCode
UPOS property ApprovalCode. -
Balance
public long BalanceUPOS property Balance. -
BalanceOfPoint
public long BalanceOfPointUPOS property BalanceOfPoint. -
CapActivateService
public boolean CapActivateServiceUPOS property CapActivateService. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapAdditionalSecurityInformation
public boolean CapAdditionalSecurityInformationUPOS property CapAdditionalSecurityInformation. Default: true. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapAddValue
public boolean CapAddValueUPOS property CapAddValue. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapAuthorizeCompletion
public boolean CapAuthorizeCompletionUPOS property CapAuthorizeCompletion. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapAuthorizePreSales
public boolean CapAuthorizePreSalesUPOS property CapAuthorizePreSales. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapAuthorizeRefund
public boolean CapAuthorizeRefundUPOS property CapAuthorizeRefund. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapAuthorizeVoid
public boolean CapAuthorizeVoidUPOS property CapAuthorizeVoid. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapAuthorizeVoidPreSales
public boolean CapAuthorizeVoidPreSalesUPOS property CapAuthorizeVoidPreSales. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapCancelValue
public boolean CapCancelValueUPOS property CapCancelValue. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapCardSensor
public int CapCardSensorUPOS property CapCardSensor. Default: 0. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapCashDeposit
public boolean CapCashDepositUPOS property CapCashDeposit. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapCenterResultCode
public boolean CapCenterResultCodeUPOS property CapCenterResultCode. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapCheckCard
public boolean CapCheckCardUPOS property CapCheckCard. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapDailyLog
public int CapDailyLogUPOS property CapDailyLog. Default: DL_NONE. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapDetectionControl
public int CapDetectionControlUPOS property CapDetectionControl. Default: CDC_RWCONTROL. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapElectronicMoney
public boolean CapElectronicMoneyUPOS property CapElectronicMoney. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapEnumerateCardServices
public boolean CapEnumerateCardServicesUPOS property CapEnumerateCardServices. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapIndirectTransactionLog
public boolean CapIndirectTransactionLogUPOS property CapIndirectTransactionLog. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapInstallments
public boolean CapInstallmentsUPOS property CapInstallments. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapLockTerminal
public boolean CapLockTerminalUPOS property CapLockTerminal. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapLogStatus
public boolean CapLogStatusUPOS property CapLogStatus. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapMediumID
public boolean CapMediumIDUPOS property CapMediumID. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapMembershipCertificate
public boolean CapMembershipCertificateUPOS property CapMembershipCertificate. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapPaymentDetail
public boolean CapPaymentDetailUPOS property CapPaymentDetail. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapPINDevice
public boolean CapPINDeviceUPOS property CapPINDevice. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapPoint
public boolean CapPointUPOS property CapPoint. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapSubtractValue
public boolean CapSubtractValueUPOS property CapSubtractValue. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapTaxOthers
public boolean CapTaxOthersUPOS property CapTaxOthers. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapTrainingMode
public boolean CapTrainingModeUPOS property CapTrainingMode. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapTransaction
public boolean CapTransactionUPOS property CapTransaction. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapTransactionLog
public boolean CapTransactionLogUPOS property CapTransactionLog. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapTransactionNumber
public boolean CapTransactionNumberUPOS property CapTransactionNumber. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapUnlockTerminal
public boolean CapUnlockTerminalUPOS property CapUnlockTerminal. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapUpdateKey
public boolean CapUpdateKeyUPOS property CapUpdateKey. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapVoucher
public boolean CapVoucherUPOS property CapVoucher. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CapWriteValue
public boolean CapWriteValueUPOS property CapWriteValue. Default: false. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
CardCompanyID
UPOS property CardCompanyID. -
CardServiceList
UPOS property CardServiceList. -
CenterResultCode
UPOS property CenterResultCode. -
CurrentService
UPOS property CurrentService. -
DailyLog
UPOS property DailyLog. -
DetectionControl
public boolean DetectionControlUPOS property DetectionControl. -
DetectionStatus
public int DetectionStatusUPOS property DetectionStatus. -
ExpirationDate
UPOS property ExpirationDate. -
LastUsedDate
UPOS property LastUsedDate. -
LogStatus
UPOS property LogStatus. Default: null. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
MediumID
UPOS property MediumID. -
PaymentCondition
UPOS property PaymentCondition. Default: null. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
PaymentDetail
UPOS property PaymentDetail. Default: null. Can be overwritten by objects derived from JposDevice within the changeDefaults method. -
PaymentMedia
public int PaymentMediaUPOS property PaymentMedia. -
PINEntry
public int PINEntryUPOS property PINEntry. -
Point
public long PointUPOS property Point. -
ReaderWriterServiceList
UPOS property ReaderWriterServiceList. Default: null. Must be overwritten by objects derived from JposDevice within the changeDefaults method. -
SequenceNumber
public int SequenceNumberUPOS property SequenceNumber. -
ServiceType
public int ServiceTypeUPOS property ServiceType. -
SettledAmount
public long SettledAmountUPOS property SettledAmount. -
SettledPoint
public long SettledPointUPOS property SettledPoint. -
SlipNumber
UPOS property SlipNumber. -
TrainingModeState
public int TrainingModeStateUPOS property TrainingModeState. -
TransactionLog
UPOS property TransactionLog. -
TransactionNumber
UPOS property TransactionNumber. -
TransactionType
public int TransactionTypeUPOS property TransactionType. -
VoucherID
UPOS property VoucherID. -
VoucherIDList
UPOS property VoucherIDList. -
Parameters
Deprecated.Tag names and values set by setParameterInformation. Will be initialized to an empty Map during claim and by invocation of method clearParameterInformation. Deprecated because replaced by TypedParameters. -
TypedParameters
Tag names and values set by setParameterInformation. Will be initialized to an empty Map during claim and by invocation of method clearParameterInformation. -
Results
Deprecated.Tag names and values hold for method retrieveResultInformation. Must be initialized to an empty Map whenever the service has read a new card. Automatic initialized to an empty Map by this framework will occur during successful claim and endDetection. This implies that initialization by the service is not necessary during the first card reading after claim and whenever the card detection process has been controlled by methods beginDetection and endDetection. -
TypedResults
Tag names and values hold for method retrieveResultInformation. Must be initialized to an empty Map whenever the service has read a new card. Automatic initialized to an empty Map by this framework will occur during successful claim and endDetection. This implies that initialization by the service is not necessary during the first card reading after claim and whenever the card detection process has been controlled by methods beginDetection and endDetection. -
UseEnumeratedValues
public boolean UseEnumeratedValuesSpecifies whether enumerated values will be passed by value (true) or by name (false). Default is true. -
StrongEnumerationCheck
public boolean StrongEnumerationCheckSpecifies whether enumeration values will be checked against the list of enumerations specified in the corresponding UPOS specification (true) or not (false). In the latter case, any value can be passes for an enumeration value and the specific service implementation must decide whether the given value shall be supported. Default is true.
-
-
Constructor Details
-
ElectronicValueRWProperties
protected ElectronicValueRWProperties(int dev)Constructor.- Parameters:
dev- Device index
-
-
Method Details
-
checkProperties
public void checkProperties(jpos.config.JposEntry entry) throws jpos.JposExceptionDescription copied from class:JposCommonPropertiesChecks jpos entries for service specific jpos property values and set corresponding service values.- Overrides:
checkPropertiesin classJposCommonProperties- Parameters:
entry- JposEntry instance that contains all jpos properties for the device. Only service specific entries are of interest here, device specific entries should be processed by the corresponding checkProperties method of the device implementation derived from JposDevice.- Throws:
jpos.JposException- a service related property is invalid or a mandatory service related property is missing.
-
initOnOpen
public void initOnOpen()Description copied from class:JposCommonPropertiesInitialization of properties that must be initialized during open.- Overrides:
initOnOpenin classJposCommonProperties
-
initOnClaim
public void initOnClaim()Description copied from class:JposCommonPropertiesInitialize properties that must be initialized whenever the device will be claimed.- Overrides:
initOnClaimin classJposCommonProperties
-
checkTagValueFormat
Method to verify whether the format of a value matches the format specified for the given tag. See the UPOS specification, chapter 15.5.31 retrieveResultInformation Method for the general layout.- Parameters:
tag- tag name.value- value to be checked.- Returns:
- JposException if value is invalid for tag, null if format of value matches the specification.
-
additionalSecurityInformation
Description copied from interface:ElectronicValueRWInterfaceFinal part of setting AdditionalSecurityInformation. 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 open,
- CapAdditionalSecurityInformation is true,
- internal property AllowAlwaysSetProperties is true or addInfo equals the previous value of AdditionalSecurityInformation.
- Specified by:
additionalSecurityInformationin interfaceElectronicValueRWInterface- Parameters:
addInfo- New value for AdditionalSecurityInformation property..- Throws:
jpos.JposException- If an error occurs.
-
amount
public void amount(long amount) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceFinal part of setting Amount. 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 open,
- internal property AllowAlwaysSetProperties is true or amount equals the previous value of Amount.
- Specified by:
amountin interfaceElectronicValueRWInterface- Parameters:
amount- Payment amount for electronic money operation.- Throws:
jpos.JposException- If an error occurs.
-
approvalCode
Description copied from interface:ElectronicValueRWInterfaceFinal part of setting ApprovalCode. 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 open,
- code is not null,
- internal property AllowAlwaysSetProperties is true or code equals the previous value of ApprovalCode.
- Specified by:
approvalCodein interfaceElectronicValueRWInterface- Parameters:
code- New value for ApprovalCode property..- Throws:
jpos.JposException- If an error occurs.
-
currentService
Description copied from interface:ElectronicValueRWInterfaceFinal part of setting CurrentService. 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 open,
- service is one of the services specified in property ReaderWriterServiceList or an empty string,
- internal property AllowAlwaysSetProperties is true or service equals the previous value of CurrentService.
- Specified by:
currentServicein interfaceElectronicValueRWInterface- Parameters:
service- New service specifier.- Throws:
jpos.JposException- If an error occurs.
-
detectionControl
public void detectionControl(boolean flag) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceFinal part of setting DetectionControl. 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 open,
- CDC_APPLICATIONCONTROL is set in CapDetectionControl or flag is false,
- internal property AllowAlwaysSetProperties is true or flag equals the previous value of DetectionControl.
- Specified by:
detectionControlin interfaceElectronicValueRWInterface- Parameters:
flag- New value for DetectionControl property..- Throws:
jpos.JposException- If an error occurs.
-
mediumID
Description copied from interface:ElectronicValueRWInterfaceFinal part of setting MediumID. 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 open,
- id is not null,
- internal property AllowAlwaysSetProperties is true or id equals the previous value of MediumID.
- Specified by:
mediumIDin interfaceElectronicValueRWInterface- Parameters:
id- New value for MediumID property..- Throws:
jpos.JposException- If an error occurs.
-
paymentMedia
public void paymentMedia(int media) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceFinal part of setting PaymentMedia. 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 open,
- media is one of MEDIA_UNSPECIFIED, MEDIA_CREDIT, MEDIA_DEBIT or MEDIA_ELECTRONIC_MONEY,
- internal property AllowAlwaysSetProperties is true or media equals the previous value of PaymentMedia.
- Specified by:
paymentMediain interfaceElectronicValueRWInterface- Parameters:
media- PaymentMedia for subsequent CAT service operations.- Throws:
jpos.JposException- If an error occurs.
-
PINEntry
public void PINEntry(int value) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceFinal part of setting PINEntry. 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 open,
- value is one of PIN_ENTRY_NONE, PIN_ENTRY_EXTERNAL, PIN_ENTRY_INTERNAL or PIN_ENTRY_UNKNOWN,
- internal property AllowAlwaysSetProperties is true or value equals the previous value of PINEntry.
- Specified by:
PINEntryin interfaceElectronicValueRWInterface- Parameters:
value- New value for PINEntry property.- Throws:
jpos.JposException- If an error occurs.
-
point
public void point(long count) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceFinal part of setting Point. 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 open,
- internal property AllowAlwaysSetProperties is true or count equals the previous value of Point.
- Specified by:
pointin interfaceElectronicValueRWInterface- Parameters:
count- New value for Point property.- Throws:
jpos.JposException- If an error occurs.
-
trainingModeState
public void trainingModeState(int state) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceFinal part of setting TrainingModeState. 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 open,
- CapTrainingMode is true or state is not TM_TRUE,
- state is one of TM_FALSE, TM_TRUE or TM_UNKNOWN,
- internal property AllowAlwaysSetProperties is true or state equals the previous value of TrainingModeState.
- Specified by:
trainingModeStatein interfaceElectronicValueRWInterface- Parameters:
state- TrainingModeState for subsequent operation.- Throws:
jpos.JposException- If an error occurs.
-
voucherID
Description copied from interface:ElectronicValueRWInterfaceFinal part of setting VoucherID. 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 open,
- id is not null.
- id id has the form "ttt:cc", where ttt is a voucher/ticket identifier and cc the corresponding count > 0,
- internal property AllowAlwaysSetProperties is true or id equals the previous value of VoucherID.
- Specified by:
voucherIDin interfaceElectronicValueRWInterface- Parameters:
id- New value for VoucherID property..- Throws:
jpos.JposException- If an error occurs.
-
voucherIDList
Description copied from interface:ElectronicValueRWInterfaceFinal part of setting VoucherIDList. 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 open,
- id is not null,
- id id has the form "ttt1:cc1[,ttt2:cc2[,...]]", where ttt1 and tt2 are voucher/ticket identifiers, cc1 and cc2 the corresponding counts, where ttt2:cc2 is optional as well as further identifier:count pairs, represented by "...".
- internal property AllowAlwaysSetProperties is true or ids equals the previous value of VoucherIDList.
- Specified by:
voucherIDListin interfaceElectronicValueRWInterface- Parameters:
ids- New value for VoucherIDList property..- Throws:
jpos.JposException- If an error occurs.
-
beginDetection
public void beginDetection(int type, int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfacefinal part of BeginDetection 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,
- State is S_IDLE,
- DetectionControl is true,
- type is one of BD_ANY or BD_SPECIFIC,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
beginDetectionin interfaceElectronicValueRWInterface- Parameters:
type- BD_ANY or BD_SPECIFIC.timeout- operation timeout.- Throws:
jpos.JposException- If an error occurs.
-
beginRemoval
public void beginRemoval(int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfacefinal part of BeginRemoval 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,
- State is S_IDLE,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
beginRemovalin interfaceElectronicValueRWInterface- Parameters:
timeout- operation timeout.- Throws:
jpos.JposException- If an error occurs.
-
captureCard
public void captureCard() throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfacefinal part of CaptureCard 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,
- Specified by:
captureCardin interfaceElectronicValueRWInterface- Throws:
jpos.JposException- If an error occurs.
-
clearParameterInformation
public void clearParameterInformation() throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfacefinal part of ClearParameterInformation 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.
- Specified by:
clearParameterInformationin interfaceElectronicValueRWInterface- Throws:
jpos.JposException- If an error occurs.
-
endDetection
public void endDetection() throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfacefinal part of ClearParameterInformation 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,
- DetectionControl is true.
- Specified by:
endDetectionin interfaceElectronicValueRWInterface- Throws:
jpos.JposException- If an error occurs.
-
endRemoval
public void endRemoval() throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfacefinal part of ClearParameterInformation 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,
- DetectionControl is true.
- Specified by:
endRemovalin interfaceElectronicValueRWInterface- Throws:
jpos.JposException- If an error occurs.
-
enumerateCardServices
public void enumerateCardServices() throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfacefinal part of EnumerateCardServices 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.
- Specified by:
enumerateCardServicesin interfaceElectronicValueRWInterface- Throws:
jpos.JposException- If an error occurs.
-
retrieveResultInformation
Description copied from interface:ElectronicValueRWInterfacefinal part of RetrieveResultInformation 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 claimed,
- name is not null and value is an array with dimension 1.
- Specified by:
retrieveResultInformationin interfaceElectronicValueRWInterface- Parameters:
name- Tag namevalue- Array to be filled with tag value on return.- Throws:
jpos.JposException- If an error occurs.
-
setParameterInformation
Description copied from interface:ElectronicValueRWInterfacefinal part of SetParameterInformation method. Can be overwritten within derived classes, if necessary.- Device is claimed,
- name and value are not null,
- Since the UPOS specification for tag VoidTransactionType and VOIDorRETURN is unclear, only numerical values "1" and "2" are supported for these tags.
- Tag SettledVoucherID will be handled the same way as tag SetttledVoucherID.
- In case of a Date tag, parsing value is successful.
- Currency values passed in value must be passed as decimal string with decimal dot, where trailing zeros up to and inclusive the decimal dot may be truncated. For example, a value of 123.45 can be returned as "123.45" or "123.4500", 100.00 can be returned as "100", "100.00" or "100.0000". Even if a value of 123.45 will be stored as 1234500 within a variable of type long, it must not be passed as "1234500".
- In case of Enumerated tag values, only the values specified in the UPOS specification must be passed in value.
- Specified by:
setParameterInformationin interfaceElectronicValueRWInterface- Parameters:
name- Tag namevalue- Array to be filled with tag value on return.- Throws:
jpos.JposException- If an error occurs.
-
getEnumTagFromPropertyValue
Convert property value into tag value.- Parameters:
name- Name of the parameter tag, e.g. "PaymentCondition"value- Property value.- Returns:
- The corresponding tag value, null if no corresponding tag value exists or value is invalid.
-
getPropertyValueFromEnumTag
Deprecated.Convert parameter tag value into corresponding property value.- Parameters:
name- Name of the parameter tag, e.g. "PaymentCondition"value- Enumerated number.- Returns:
- The corresponding property value, null if no corresponding property value exists or if tag or value is invalid.
-
getPropertyValueFromEnumTag
Deprecated.Convert parameter tag value into corresponding property value. Deprecated.- Parameters:
name- Name of the parameter tag, e.g. "PaymentCondition"valstr- String representing the corresponding Enumerated number.- Returns:
- The corresponding property value, null if no corresponding property value exists or if tag or valstr is invalid.
-
accessDailyLog
public AccessDailyLog accessDailyLog(int sequenceNumber, int type, int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceValidation part of AccessDailyLog method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- CapDailyLog is true,
- State is S_IDLE,
- type is one of DL_REPORTING or DL_SETTLEMENT and is contained in CapDailyLog,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
accessDailyLogin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.type- DL_REPORTING or DL_SETTLEMENT.timeout- operation timeout.- Returns:
- AccessDailyLog object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
accessDailyLog
Description copied from interface:ElectronicValueRWInterfaceFinal part of AccessData method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a AccessData object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
accessDailyLogin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by AccessData.- Throws:
jpos.JposException- If an error occurs.
-
accessData
Description copied from interface:ElectronicValueRWInterfaceValidation part of AccessData method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- dataType is one of AD_KEY, AD_NEGATIVE_LIST or AD_OTHERS,
- data and type are non-null arrays with dimension 1.
- Specified by:
accessDatain interfaceElectronicValueRWInterface- Parameters:
dataType- Data type.data- vendor specific data.obj- vendor specific Object.- Returns:
- AccessData object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
accessData
Description copied from interface:ElectronicValueRWInterfaceFinal part of AccessData method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a AccessData object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
accessDatain interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by AccessData.- Throws:
jpos.JposException- If an error occurs.
-
accessLog
Description copied from interface:ElectronicValueRWInterfaceValidation part of AccessLog method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- type is one of AL_REPORTING or AL_SETTLEMENT and is contained in CapDailyLog,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
accessLogin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.type- AL_REPORTING or AL_SETTLEMENT.timeout- operation timeout.- Returns:
- AccessLog object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
accessLog
Description copied from interface:ElectronicValueRWInterfaceFinal part of AccessLog method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a AccessLog object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
accessLogin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by AccessLog.- Throws:
jpos.JposException- If an error occurs.
-
activateEVService
Description copied from interface:ElectronicValueRWInterfaceValidation part of ActivateEVService method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- data and obj are arrays with dimension 0 or 1.
- Specified by:
activateEVServicein interfaceElectronicValueRWInterface- Parameters:
data- Vendor specific.obj- vendor specific.- Returns:
- ActivateEVService object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
activateEVService
Description copied from interface:ElectronicValueRWInterfaceFinal part of ActivateEVService method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a ActivateEVService object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
activateEVServicein interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by ActivateEVService.- Throws:
jpos.JposException- If an error occurs.
-
activateService
Description copied from interface:ElectronicValueRWInterfaceValidation part of ActivateService method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- CapActivateService is true,
- data and obj are arrays with dimension 0 or 1.
- Specified by:
activateServicein interfaceElectronicValueRWInterface- Parameters:
data- Vendor specific.obj- vendor specific.- Returns:
- ActivateService object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
activateService
Description copied from interface:ElectronicValueRWInterfaceFinal part of ActivateService method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a ActivateService object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
activateServicein interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by ActivateService.- Throws:
jpos.JposException- If an error occurs.
-
addValue
Description copied from interface:ElectronicValueRWInterfaceValidation part of AddValue method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- CapAddValue is true,
- State is S_IDLE,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
addValuein interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.timeout- operation timeout.- Returns:
- AddValue object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
addValue
Description copied from interface:ElectronicValueRWInterfaceFinal part of AddValue method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a AddValue object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
addValuein interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by AddValue.- Throws:
jpos.JposException- If an error occurs.
-
authorizeCompletion
public AuthorizeCompletion authorizeCompletion(int sequenceNumber, long amount, long taxOthers, int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceValidation part of AuthorizeCompletion method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- CapAuthorizeCompletion is true,
- amount > 0, taxOthers $ge; 0,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
authorizeCompletionin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.amount- Purchase amount for approval.taxOthers- Tax and other amounts for approval.timeout- operation timeout.- Returns:
- AuthorizeCompletion object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
authorizeCompletion
Description copied from interface:ElectronicValueRWInterfaceFinal part of AuthorizeCompletion method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a AuthorizeCompletion object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
authorizeCompletionin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by AuthorizeCompletion.- Throws:
jpos.JposException- If an error occurs.
-
authorizePreSales
public AuthorizePreSales authorizePreSales(int sequenceNumber, long amount, long taxOthers, int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceValidation part of AuthorizePreSales method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- CapAuthorizePreSales is true,
- amount > 0, taxOthers $ge; 0,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
authorizePreSalesin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.amount- Purchase amount for approval.taxOthers- Tax and other amounts for approval.timeout- operation timeout.- Returns:
- AuthorizePreSales object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
authorizePreSales
Description copied from interface:ElectronicValueRWInterfaceFinal part of AuthorizePreSales method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a AuthorizePreSales object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
authorizePreSalesin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by AuthorizePreSales.- Throws:
jpos.JposException- If an error occurs.
-
authorizeRefund
public AuthorizeRefund authorizeRefund(int sequenceNumber, long amount, long taxOthers, int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceValidation part of AuthorizeRefund method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- CapAuthorizeRefund is true,
- amount > 0, taxOthers $ge; 0,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
authorizeRefundin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.amount- Purchase amount for approval.taxOthers- Tax and other amounts for approval.timeout- operation timeout.- Returns:
- AuthorizeRefund object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
authorizeRefund
Description copied from interface:ElectronicValueRWInterfaceFinal part of AuthorizeRefund method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a AuthorizeRefund object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
authorizeRefundin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by AuthorizeRefund.- Throws:
jpos.JposException- If an error occurs.
-
authorizeSales
public AuthorizeSales authorizeSales(int sequenceNumber, long amount, long taxOthers, int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceValidation part of AuthorizeSales method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- amount > 0, taxOthers $ge; 0,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
authorizeSalesin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.amount- Purchase amount for approval.taxOthers- Tax and other amounts for approval.timeout- operation timeout.- Returns:
- AuthorizeSales object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
authorizeSales
Description copied from interface:ElectronicValueRWInterfaceFinal part of AuthorizeSales method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a AuthorizeSales object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
authorizeSalesin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by AuthorizeSales.- Throws:
jpos.JposException- If an error occurs.
-
authorizeVoid
public AuthorizeVoid authorizeVoid(int sequenceNumber, long amount, long taxOthers, int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceValidation part of AuthorizeVoid method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- CapAuthorizeVoid is true,
- amount > 0, taxOthers $ge; 0,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
authorizeVoidin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.amount- Purchase amount for approval.taxOthers- Tax and other amounts for approval.timeout- operation timeout.- Returns:
- AuthorizeVoid object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
authorizeVoid
Description copied from interface:ElectronicValueRWInterfaceFinal part of AuthorizeVoid method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a AuthorizeVoid object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
authorizeVoidin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by AuthorizeVoid.- Throws:
jpos.JposException- If an error occurs.
-
authorizeVoidPreSales
public AuthorizeVoidPreSales authorizeVoidPreSales(int sequenceNumber, long amount, long taxOthers, int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceValidation part of AuthorizeVoidPreSales method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- CapAuthorizeVoidPreSales is true,
- amount > 0, taxOthers $ge; 0,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
authorizeVoidPreSalesin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.amount- Purchase amount for approval.taxOthers- Tax and other amounts for approval.timeout- operation timeout.- Returns:
- AuthorizeVoidPreSales object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
authorizeVoidPreSales
Description copied from interface:ElectronicValueRWInterfaceFinal part of AuthorizeVoidPreSales method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a AuthorizeVoidPreSales object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
authorizeVoidPreSalesin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by AuthorizeVoidPreSales.- Throws:
jpos.JposException- If an error occurs.
-
cancelValue
Description copied from interface:ElectronicValueRWInterfaceValidation part of CancelValue method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- CapCancelValue is true,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
cancelValuein interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.timeout- operation timeout.- Returns:
- CancelValue object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
cancelValue
Description copied from interface:ElectronicValueRWInterfaceFinal part of CancelValue method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a CancelValue object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
cancelValuein interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by CancelValue.- Throws:
jpos.JposException- If an error occurs.
-
cashDeposit
public CashDeposit cashDeposit(int sequenceNumber, long amount, int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceValidation part of CashDeposit method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- CapCashDeposit is true,
- amount > 0,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
cashDepositin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.amount- Purchase amount for approval.timeout- operation timeout.- Returns:
- CashDeposit object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
cashDeposit
Description copied from interface:ElectronicValueRWInterfaceFinal part of CashDeposit method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a CashDeposit object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
cashDepositin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by CashDeposit.- Throws:
jpos.JposException- If an error occurs.
-
checkCard
Description copied from interface:ElectronicValueRWInterfaceValidation part of CheckCard method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- CapCheckCard is true,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
checkCardin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.timeout- operation timeout.- Returns:
- CheckCard object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
checkCard
Description copied from interface:ElectronicValueRWInterfaceFinal part of CheckCard method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a CheckCard object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
checkCardin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by CheckCard.- Throws:
jpos.JposException- If an error occurs.
-
checkServiceRegistrationToMedium
public CheckServiceRegistrationToMedium checkServiceRegistrationToMedium(int sequenceNumber, int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceValidation part of CheckServiceRegistrationToMedium method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
checkServiceRegistrationToMediumin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.timeout- operation timeout.- Returns:
- CheckServiceRegistrationToMedium object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
checkServiceRegistrationToMedium
public void checkServiceRegistrationToMedium(CheckServiceRegistrationToMedium request) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceFinal part of CheckServiceRegistrationToMedium method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a CheckCard object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
checkServiceRegistrationToMediumin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by CheckServiceRegistrationToMedium.- Throws:
jpos.JposException- If an error occurs.
-
closeDailyEVService
Description copied from interface:ElectronicValueRWInterfaceValidation part of CloseDailyEVService method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- data and obj are arrays with dimension 0 or 1.
- Specified by:
closeDailyEVServicein interfaceElectronicValueRWInterface- Parameters:
data- Vendor specific.obj- vendor specific.- Returns:
- CloseDailyEVService object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
closeDailyEVService
Description copied from interface:ElectronicValueRWInterfaceFinal part of CloseDailyEVService method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a CheckCard object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
closeDailyEVServicein interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by CloseDailyEVService.- Throws:
jpos.JposException- If an error occurs.
-
deactivateEVService
Description copied from interface:ElectronicValueRWInterfaceValidation part of DeactivateEVService method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- data and obj are arrays with dimension 0 or 1.
- Specified by:
deactivateEVServicein interfaceElectronicValueRWInterface- Parameters:
data- Vendor specific.obj- vendor specific.- Returns:
- DeactivateEVService object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
deactivateEVService
Description copied from interface:ElectronicValueRWInterfaceFinal part of DeactivateEVService method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a CheckCard object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
deactivateEVServicein interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method that contains all parameters to be used by DeactivateEVService.- Throws:
jpos.JposException- If an error occurs.
-
lockTerminal
Description copied from interface:ElectronicValueRWInterfaceValidation part of LockTerminal method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- CapLockTerminal is true.
- Specified by:
lockTerminalin interfaceElectronicValueRWInterface- Returns:
- LockTerminal object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
lockTerminal
Description copied from interface:ElectronicValueRWInterfaceFinal part of LockTerminal method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a LockTerminal object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
lockTerminalin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method to be used by LockTerminal.- Throws:
jpos.JposException- If an error occurs.
-
openDailyEVService
Description copied from interface:ElectronicValueRWInterfaceValidation part of OpenDailyEVService method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- data and obj are arrays with dimension 0 or 1.
- Specified by:
openDailyEVServicein interfaceElectronicValueRWInterface- Parameters:
data- Vendor specific.obj- vendor specific.- Returns:
- OpenDailyEVService object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
openDailyEVService
Description copied from interface:ElectronicValueRWInterfaceFinal part of OpenDailyEVService method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a OpenDailyEVService object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
openDailyEVServicein interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method to be used by OpenDailyEVService.- Throws:
jpos.JposException- If an error occurs.
-
queryLastSuccessfulTransactionResult
public QueryLastSuccessfulTransactionResult queryLastSuccessfulTransactionResult() throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceValidation part of QueryLastSuccessfulTransactionResult method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled.
- Specified by:
queryLastSuccessfulTransactionResultin interfaceElectronicValueRWInterface- Returns:
- QueryLastSuccessfulTransactionResult object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
queryLastSuccessfulTransactionResult
public void queryLastSuccessfulTransactionResult(QueryLastSuccessfulTransactionResult request) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceFinal part of QueryLastSuccessfulTransactionResult method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a QueryLastSuccessfulTransactionResult object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
queryLastSuccessfulTransactionResultin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method to be used by QueryLastSuccessfulTransactionResult.- Throws:
jpos.JposException- If an error occurs.
-
readValue
Description copied from interface:ElectronicValueRWInterfaceValidation part of ReadValue method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
readValuein interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.timeout- operation timeout.- Returns:
- ReadValue object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
readValue
Description copied from interface:ElectronicValueRWInterfaceFinal part of ReadValue method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a ReadValue object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
readValuein interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method to be used by ReadValue.- Throws:
jpos.JposException- If an error occurs.
-
registerServiceToMedium
public RegisterServiceToMedium registerServiceToMedium(int sequenceNumber, int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceValidation part of RegisterServiceToMedium method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
registerServiceToMediumin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.timeout- operation timeout.- Returns:
- RegisterServiceToMedium object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
registerServiceToMedium
Description copied from interface:ElectronicValueRWInterfaceFinal part of RegisterServiceToMedium method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a RegisterServiceToMedium object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
registerServiceToMediumin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method to be used by RegisterServiceToMedium.- Throws:
jpos.JposException- If an error occurs.
-
subtractValue
Description copied from interface:ElectronicValueRWInterfaceValidation part of SubtractValue method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- CapSubtractValue is true,
- State is S_IDLE,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
subtractValuein interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.timeout- operation timeout.- Returns:
- SubtractValue object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
subtractValue
Description copied from interface:ElectronicValueRWInterfaceFinal part of SubtractValue method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a SubtractValue object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
subtractValuein interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method to be used by SubtractValue.- Throws:
jpos.JposException- If an error occurs.
-
transactionAccess
Description copied from interface:ElectronicValueRWInterfaceValidation part of TransactionAccess method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- CapTransaction is true,
- control is one of TA_TRANSACTION or TA_NORMAL,
- Either a transaction has not been started or control is TA_NORMAL.
- Specified by:
transactionAccessin interfaceElectronicValueRWInterface- Parameters:
control- The transaction control.- Returns:
- TransactionAccess object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
transactionAccess
Description copied from interface:ElectronicValueRWInterfaceFinal part of TransactionAccess method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a TransactionAccess object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
transactionAccessin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method to be used by TransactionAccess.- Throws:
jpos.JposException- If an error occurs.
-
unlockTerminal
Description copied from interface:ElectronicValueRWInterfaceValidation part of UnlockTerminal method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- CapUnlockTerminal is true,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
unlockTerminalin interfaceElectronicValueRWInterface- Returns:
- UnlockTerminal object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
unlockTerminal
Description copied from interface:ElectronicValueRWInterfaceFinal part of UnlockTerminal method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a UnlockTerminal object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
unlockTerminalin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method to be used by UnlockTerminal.- Throws:
jpos.JposException- If an error occurs.
-
unregisterServiceToMedium
public UnregisterServiceToMedium unregisterServiceToMedium(int sequenceNumber, int timeout) throws jpos.JposExceptionDescription copied from interface:ElectronicValueRWInterfaceValidation part of UnregisterServiceToMedium method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
unregisterServiceToMediumin interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.timeout- operation timeout.- Returns:
- UnregisterServiceToMedium object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
unregisterServiceToMedium
Description copied from interface:ElectronicValueRWInterfaceFinal part of UnregisterServiceToMedium method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a UnregisterServiceToMedium object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
unregisterServiceToMediumin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method to be used by UnregisterServiceToMedium.- Throws:
jpos.JposException- If an error occurs.
-
updateData
Description copied from interface:ElectronicValueRWInterfaceValidation part of UpdateData method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- dataType is one of AD_KEY, AD_NEGATIVE_LIST or AD_OTHERS,
- data and obj are arrays with dimension 0 or 1.
- Specified by:
updateDatain interfaceElectronicValueRWInterface- Parameters:
dataType- Type of data.data- Vendor specific.obj- vendor specific.- Returns:
- UpdateData object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
updateData
Description copied from interface:ElectronicValueRWInterfaceFinal part of UpdateData method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a UpdateData object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
updateDatain interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method to be used by UpdateData.- Throws:
jpos.JposException- If an error occurs.
-
updateKey
Description copied from interface:ElectronicValueRWInterfaceValidation part of UpdateKey method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- State is S_IDLE,
- data and obj are arrays with dimension 0 or 1.
- Specified by:
updateKeyin interfaceElectronicValueRWInterface- Parameters:
data- Vendor specific.obj- vendor specific.- Returns:
- UpdateKey object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
updateKey
Description copied from interface:ElectronicValueRWInterfaceFinal part of UpdateKey method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a UpdateKey object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
updateKeyin interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method to be used by UpdateKey.- Throws:
jpos.JposException- If an error occurs.
-
writeValue
Description copied from interface:ElectronicValueRWInterfaceValidation part of WriteValue method. Can be overwritten within derived classes, if necessary. This method shall only perform additional validation. It will be called before the service buffers the method call for synchronous or asynchronous execution. This method will be called only if the following plausibility checks lead to a positive result:- Device is enabled,
- CapWriteValue is true,
- State is S_IDLE,
- timeout is JPOS_FOREVER or ≥ 0.
- Specified by:
writeValuein interfaceElectronicValueRWInterface- Parameters:
sequenceNumber- Sequence number, any value.timeout- operation timeout.- Returns:
- WriteValue object for use in final part.
- Throws:
jpos.JposException- If an error occurs.
-
writeValue
Description copied from interface:ElectronicValueRWInterfaceFinal part of WriteValue method. Can be overwritten within derived classes, if necessary. The parameters of the method will be passed via a WriteValue object. This method will be called when the corresponding operation shall be performed, either synchronously or asynchronously. All plausibility checks have been made before, only runtime errors can occur.- Specified by:
writeValuein interfaceElectronicValueRWInterface- Parameters:
request- Output request object returned by validation method to be used by WriteValue.- Throws:
jpos.JposException- If an error occurs.
-