Package de.gmxhome.conrad.jpos.jpos_base

Class UpdateFirmware

java.lang.Object

de.gmxhome.conrad.jpos.jpos_base.JposOutputRequest

de.gmxhome.conrad.jpos.jpos_base.UpdateFirmware

All Implemented Interfaces:

Runnable

public class UpdateFirmware
extends JposOutputRequest

Output request executor for common method UpdateFirmware.

Nested Class Summary

Nested classes/interfaces inherited from class de.gmxhome.conrad.jpos.jpos_base.JposOutputRequest

JposOutputRequest.JposRequestThread

Field Summary

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

Abort, AdditionalData, Device, EndSync, Exception, Finished, OutputID, Props, Waiting

Constructor Summary

Constructors

Constructor	Description
UpdateFirmware(JposCommonProperties props, String firmwareFileName)	Constructor.

Method Summary

Modifier and Type	Method	Description
JposOutputCompleteEvent	createOutputEvent()	Factory for output complete events.
String	getFirmwareFileName()	Common method UpdateFirmware parameter firmwareFileName, see UPOS specification.
void	invoke()	Invokes the command.
void	setResult(int result)	Sets result of firmware update for the case that updateFirmware throws a JposException.

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

abortCommand, abortCommand, catchedInvocation, clearAll, clearInput, clearOutput, countCommands, createErrorEvent, createIdleEvent, dequeue, enqueue, enqueueSynchronous, finishAsyncProcessing, finished, reactivate, reactivate, reset, run

Methods inherited from class java.lang.Object

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

Constructor Details

UpdateFirmware

public UpdateFirmware(JposCommonProperties props,
 String firmwareFileName)

Constructor. Stores given parameters for later use.

Parameters:

props - Property set of device service.

firmwareFileName - Name of a firmware file or a container file, see UPOS specification.

Method Details

getFirmwareFileName

public String getFirmwareFileName()

Common method UpdateFirmware parameter firmwareFileName, see UPOS specification.

Returns:

Parameter firmwareFileName.

setResult

public void setResult(int result)
               throws jpos.JposException

Sets result of firmware update for the case that updateFirmware throws a JposException. Must be one of SUE_UF_COMPLETE_DEV_NOT_RESTORED, SUE_UF_FAILED_DEV_OK, SUE_UF_FAILED_DEV_UNRECOVERABLE, SUE_UF_FAILED_DEV_NEEDS_FIRMWARE or SUE_UF_FAILED_DEV_UNKNOWN. Default is SUE_UF_FAILED_DEV_UNKNOWN.
If updateFirmware throws a JposException with ErrorCodeExtended set to one of the allowed values, Result will be set to ErrorCodeExtended internally.
If updateFirmware ends normally, Result will be set to SUE_UF_COMPLETE internally.

Parameters:

result - Result value as explained above.

Throws:

jpos.JposException - if result is invalid.

createOutputEvent

public JposOutputCompleteEvent createOutputEvent()

Description copied from class: JposOutputRequest

Factory for output complete events. Must be overwritten whenever a device specific output complete event shall be created.

Overrides:

createOutputEvent in class JposOutputRequest

Returns:

The resulting output complete event or null if no output complete event shall be enqueued.

invoke

public void invoke()
            throws jpos.JposException

Description copied from class: JposOutputRequest

Invokes the command. Must be implemented in derived class. Calls finished() to wake up potentially waiting threads.

Overrides:

invoke in class JposOutputRequest

Throws:

jpos.JposException - JposException thrown by the command to be executed.