| //------------------------------------------------------------------------------ |
| // |
| // This software is provided "AS IS". The JavaPOS working group (including |
| // each of the Corporate members, contributors and individuals) MAKES NO |
| // REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF THE SOFTWARE, |
| // EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED |
| // WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND |
| // NON-INFRINGEMENT. The JavaPOS working group shall not be liable for |
| // any damages suffered as a result of using, modifying or distributing this |
| // software or its derivatives.Permission to use, copy, modify, and distribute |
| // the software and its documentation for any purpose is hereby granted. |
| // |
| // Keylock.java - A JavaPOS 1.14.0 device control |
| // |
| //------------------------------------------------------------------------------ |
| |
| package jpos; |
| |
| import jpos.events.*; |
| import jpos.services.*; |
| import java.util.Vector; |
| import jpos.loader.*; |
| |
| public class Keylock |
| extends BaseJposControl |
| implements KeylockControl114, JposConst |
| { |
| //-------------------------------------------------------------------------- |
| // Variables |
| //-------------------------------------------------------------------------- |
| |
| protected KeylockService12 service12; |
| protected KeylockService13 service13; |
| protected KeylockService14 service14; |
| protected KeylockService15 service15; |
| protected KeylockService16 service16; |
| protected KeylockService17 service17; |
| protected KeylockService18 service18; |
| protected KeylockService19 service19; |
| protected KeylockService110 service110; |
| protected KeylockService111 service111; |
| protected KeylockService112 service112; |
| protected KeylockService113 service113; |
| protected KeylockService114 service114; |
| protected Vector directIOListeners; |
| protected Vector statusUpdateListeners; |
| |
| |
| //-------------------------------------------------------------------------- |
| // Constructor |
| //-------------------------------------------------------------------------- |
| |
| public Keylock() |
| { |
| // Initialize base class instance data |
| deviceControlDescription = "JavaPOS Keylock Device Control"; |
| deviceControlVersion = deviceVersion114; |
| |
| // Initialize instance data. Initializations are commented out for |
| // efficiency if the Java default is correct. |
| //service12 = null; |
| //service13 = null; |
| //service14 = null; |
| //service15 = null; |
| //service16 = null; |
| //service17 = null; |
| //service18 = null; |
| //service19 = null; |
| //service110 = null; |
| //service111 = null; |
| //service112 = null; |
| //service113 = null; |
| //service114 = null; |
| directIOListeners = new Vector(); |
| statusUpdateListeners = new Vector(); |
| } |
| |
| |
| //-------------------------------------------------------------------------- |
| // Capabilities |
| //-------------------------------------------------------------------------- |
| |
| public int getCapPowerReporting() |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.3.0 |
| if(serviceVersion < deviceVersion13) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.3.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| return service13.getCapPowerReporting(); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public boolean getCapStatisticsReporting() |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.8.0 |
| if(serviceVersion < deviceVersion18) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.8.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| return service18.getCapStatisticsReporting(); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public boolean getCapUpdateStatistics() |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.8.0 |
| if(serviceVersion < deviceVersion18) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.8.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| return service18.getCapUpdateStatistics(); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public boolean getCapCompareFirmwareVersion() |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.9.0 |
| if(serviceVersion < deviceVersion19) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.9.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| return service19.getCapCompareFirmwareVersion(); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public boolean getCapUpdateFirmware() |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.9.0 |
| if(serviceVersion < deviceVersion19) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.9.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| return service19.getCapUpdateFirmware(); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public int getCapKeylockType() |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.11.0 |
| if(serviceVersion < deviceVersion111) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.11.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| return service111.getCapKeylockType(); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| |
| //-------------------------------------------------------------------------- |
| // Properties |
| //-------------------------------------------------------------------------- |
| |
| public int getKeyPosition() |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Perform the operation |
| try |
| { |
| return service12.getKeyPosition(); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public int getPositionCount() |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Perform the operation |
| try |
| { |
| return service12.getPositionCount(); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public int getPowerNotify() |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.3.0 |
| if(serviceVersion < deviceVersion13) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.3.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| return service13.getPowerNotify(); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public void setPowerNotify(int powerNotify) |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.3.0 |
| if(serviceVersion < deviceVersion13) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.3.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| service13.setPowerNotify(powerNotify); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public int getPowerState() |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.3.0 |
| if(serviceVersion < deviceVersion13) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.3.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| return service13.getPowerState(); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public byte[] getElectronicKeyValue() |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.11.0 |
| if(serviceVersion < deviceVersion111) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.11.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| return service111.getElectronicKeyValue(); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| |
| //-------------------------------------------------------------------------- |
| // Methods |
| //-------------------------------------------------------------------------- |
| |
| public void waitForKeylockChange(int keyPosition, int timeout) |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Perform the operation |
| try |
| { |
| service12.waitForKeylockChange(keyPosition, timeout); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public void resetStatistics(String statisticsBuffer) |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.8.0 |
| if(serviceVersion < deviceVersion18) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.8.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| service18.resetStatistics(statisticsBuffer); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public void retrieveStatistics(String[] statisticsBuffer) |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.8.0 |
| if(serviceVersion < deviceVersion18) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.8.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| service18.retrieveStatistics(statisticsBuffer); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public void updateStatistics(String statisticsBuffer) |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.8.0 |
| if(serviceVersion < deviceVersion18) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.8.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| service18.updateStatistics(statisticsBuffer); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public void compareFirmwareVersion(String firmwareFileName, int[] result) |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.9.0 |
| if(serviceVersion < deviceVersion19) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.9.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| service19.compareFirmwareVersion(firmwareFileName, result); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| public void updateFirmware(String firmwareFileName) |
| throws JposException |
| { |
| // Make sure control is opened |
| if(!bOpen) |
| { |
| throw new JposException(JPOS_E_CLOSED, "Control not opened"); |
| } |
| |
| // Make sure service supports at least version 1.9.0 |
| if(serviceVersion < deviceVersion19) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Device Service is not 1.9.0 compliant."); |
| } |
| |
| // Perform the operation |
| try |
| { |
| service19.updateFirmware(firmwareFileName); |
| } |
| catch(JposException je) |
| { |
| throw je; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_FAILURE, |
| "Unhandled exception from Device Service", e); |
| } |
| } |
| |
| |
| //-------------------------------------------------------------------------- |
| // Framework Methods |
| //-------------------------------------------------------------------------- |
| |
| // Create an EventCallbacks interface implementation object for this Control |
| protected EventCallbacks createEventCallbacks() |
| { |
| return new KeylockCallbacks(); |
| } |
| |
| // Store the reference to the Device Service |
| protected void setDeviceService(BaseService service, int nServiceVersion) |
| throws JposException |
| { |
| // Special case: service == null to free references |
| if(service == null) |
| { |
| |
| service12 = null; |
| service13 = null; |
| service14 = null; |
| service15 = null; |
| service16 = null; |
| service17 = null; |
| service18 = null; |
| service19 = null; |
| service110 = null; |
| service111 = null; |
| service112 = null; |
| service113 = null; |
| service114 = null; |
| } |
| else |
| { |
| // Make sure that the service actually conforms to the interfaces it |
| // claims to. |
| if(serviceVersion >= deviceVersion12) |
| { |
| try |
| { |
| service12 = (KeylockService12)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService12 interface", |
| e); |
| } |
| } |
| |
| if(serviceVersion >= deviceVersion13) |
| { |
| try |
| { |
| service13 = (KeylockService13)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService13 interface", |
| e); |
| } |
| } |
| |
| if(serviceVersion >= deviceVersion14) |
| { |
| try |
| { |
| service14 = (KeylockService14)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService14 interface", |
| e); |
| } |
| } |
| |
| if(serviceVersion >= deviceVersion15) |
| { |
| try |
| { |
| service15 = (KeylockService15)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService15 interface", |
| e); |
| } |
| } |
| |
| if(serviceVersion >= deviceVersion16) |
| { |
| try |
| { |
| service16 = (KeylockService16)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService16 interface", |
| e); |
| } |
| } |
| |
| if(serviceVersion >= deviceVersion17) |
| { |
| try |
| { |
| service17 = (KeylockService17)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService17 interface", |
| e); |
| } |
| } |
| |
| if(serviceVersion >= deviceVersion18) |
| { |
| try |
| { |
| service18 = (KeylockService18)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService18 interface", |
| e); |
| } |
| } |
| |
| if(serviceVersion >= deviceVersion19) |
| { |
| try |
| { |
| service19 = (KeylockService19)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService19 interface", |
| e); |
| } |
| } |
| |
| if(serviceVersion >= deviceVersion110) |
| { |
| try |
| { |
| service110 = (KeylockService110)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService110 interface", |
| e); |
| } |
| } |
| |
| if(serviceVersion >= deviceVersion111) |
| { |
| try |
| { |
| service111 = (KeylockService111)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService111 interface", |
| e); |
| } |
| } |
| |
| if(serviceVersion >= deviceVersion112) |
| { |
| try |
| { |
| service112 = (KeylockService112)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService112 interface", |
| e); |
| } |
| } |
| |
| if(serviceVersion >= deviceVersion113) |
| { |
| try |
| { |
| service113 = (KeylockService113)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService113 interface", |
| e); |
| } |
| } |
| |
| if(serviceVersion >= deviceVersion114) |
| { |
| try |
| { |
| service114 = (KeylockService114)service; |
| } |
| catch(Exception e) |
| { |
| throw new JposException(JPOS_E_NOSERVICE, |
| "Service does not fully implement KeylockService114 interface", |
| e); |
| } |
| } |
| |
| } |
| } |
| |
| |
| //-------------------------------------------------------------------------- |
| // Event Listener Methods |
| //-------------------------------------------------------------------------- |
| |
| public void addDirectIOListener(DirectIOListener l) |
| { |
| synchronized(directIOListeners) |
| { |
| directIOListeners.addElement(l); |
| } |
| } |
| |
| public void removeDirectIOListener(DirectIOListener l) |
| { |
| synchronized(directIOListeners) |
| { |
| directIOListeners.removeElement(l); |
| } |
| } |
| |
| public void addStatusUpdateListener(StatusUpdateListener l) |
| { |
| synchronized(statusUpdateListeners) |
| { |
| statusUpdateListeners.addElement(l); |
| } |
| } |
| |
| public void removeStatusUpdateListener(StatusUpdateListener l) |
| { |
| synchronized(statusUpdateListeners) |
| { |
| statusUpdateListeners.removeElement(l); |
| } |
| } |
| |
| |
| //-------------------------------------------------------------------------- |
| // EventCallbacks inner class |
| //-------------------------------------------------------------------------- |
| |
| protected class KeylockCallbacks |
| implements EventCallbacks |
| { |
| public BaseControl getEventSource() |
| { |
| return (BaseControl)Keylock.this; |
| } |
| |
| public void fireDataEvent(DataEvent e) |
| { |
| } |
| |
| public void fireDirectIOEvent(DirectIOEvent e) |
| { |
| synchronized(Keylock.this.directIOListeners) |
| { |
| // deliver the event to all registered listeners |
| for(int x = 0; x < directIOListeners.size(); x++) |
| { |
| ((DirectIOListener)directIOListeners.elementAt(x)).directIOOccurred(e); |
| } |
| } |
| } |
| |
| public void fireErrorEvent(ErrorEvent e) |
| { |
| } |
| |
| public void fireOutputCompleteEvent(OutputCompleteEvent e) |
| { |
| } |
| |
| public void fireStatusUpdateEvent(StatusUpdateEvent e) |
| { |
| synchronized(Keylock.this.statusUpdateListeners) |
| { |
| // deliver the event to all registered listeners |
| for(int x = 0; x < statusUpdateListeners.size(); x++) |
| { |
| ((StatusUpdateListener)statusUpdateListeners.elementAt(x)).statusUpdateOccurred(e); |
| } |
| } |
| } |
| } |
| } |