com.unitech.lib.engine

Class BaseEngine

java.lang.Object

com.unitech.lib.engine.BaseEngine

public class BaseEngine
extends java.lang.Object

Provides the base functionality for interacting with a barcode reader engine.

Field Summary

Fields

Modifier and Type	Field and Description
protected EngineParamID[]	_supportedParameterIds
protected EngineParam[]	_supportedParameters
protected BarcodeReader	reader
protected java.lang.String	strVersion
protected java.lang.String	TAG
protected int	version

Constructor Summary

Constructors

Constructor and Description
BaseEngine(BarcodeReader reader, EngineModel engineModel) Constructs a new BaseEngine object.

Method Summary

Modifier and Type	Method and Description
void	addListener(IBarcodeEventListener listener) Adds a listener for barcode events.
protected void	assertEngineParamId(EngineParamID id) Asserts that the specified EngineParamID is supported by the engine.
void	clearListener() Removes all listeners for barcode events.
protected void	convertVersion(java.lang.String version) Convert the engine version string to an integer.
void	destroy() Destroys the BaseEngine object and releases any resources it holds.
EngineModel	getEngineModel() Returns the EngineModel of the engine.
void	getParameter(EngineParamID engineParamID, IParameterEventListener listener) Get a specific engine parameter setting.
void	getParameter(int id, EngineParamID engineParamID, IParameterEventListener listener) Get a specific engine parameter setting.
void	getParameters(EngineParamID[] engineParamIDs, IParameterEventListener listener) Get multiple engine parameter settings.
void	getParameters(int id, EngineParamID[] engineParamIDs, IParameterEventListener listener) Get multiple engine parameter settings.
java.lang.String	getStrVersion() Returns the version of the engine as a string.
EngineParamID[]	getSupportedParameterIds() Returns an array of EngineParamID objects that are supported by the engine.
EngineParam[]	getSupportedParameters() Returns an array of EngineParam objects that are supported by the engine.
void	pumpEvent(com.unitech.lib.event.params.ProtocolEventArgs args) Handles protocol events.
void	removeListener(IBarcodeEventListener listener) Removes a listener for barcode events.
void	setParameter(EngineParam engineParam, IParameterEventListener listener) Set an engine parameter setting.
void	setParameter(int id, EngineParam engineParam, IParameterEventListener listener) Set an engine parameter setting.
void	setParameters(EngineParam[] engineParams, IParameterEventListener listener) Set multiple engine parameter settings.
void	setParameters(int id, EngineParam[] engineParams, IParameterEventListener listener) Set multiple engine parameter settings.
protected void	triggerParameterTransferEvent(boolean enabled) Triggers a parameter transfer event.

Methods inherited from class java.lang.Object

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

Field Detail

TAG

protected java.lang.String TAG

reader

protected final BarcodeReader reader

_supportedParameterIds

protected EngineParamID[] _supportedParameterIds

_supportedParameters

protected EngineParam[] _supportedParameters

strVersion

protected java.lang.String strVersion

version

protected int version

Constructor Detail

BaseEngine

public BaseEngine(BarcodeReader reader,
                  EngineModel engineModel)

Constructs a new BaseEngine object.

Parameters:

reader - The BarcodeReader object to use for communication with the engine.

engineModel - The EngineModel of the engine.

Method Detail

destroy

public void destroy()

Destroys the BaseEngine object and releases any resources it holds.

getEngineModel

public EngineModel getEngineModel()

Returns the EngineModel of the engine.

Returns:

The EngineModel of the engine.

getSupportedParameterIds

public EngineParamID[] getSupportedParameterIds()

Returns an array of EngineParamID objects that are supported by the engine.

Returns:

An array of EngineParamID objects.

getSupportedParameters

public EngineParam[] getSupportedParameters()

Returns an array of EngineParam objects that are supported by the engine.

Returns:

An array of EngineParam objects.

getStrVersion

public java.lang.String getStrVersion()

Returns the version of the engine as a string.

Returns:

The version of the engine.

addListener

public void addListener(IBarcodeEventListener listener)

Adds a listener for barcode events.

Parameters:

listener - The listener to add.

removeListener

public void removeListener(IBarcodeEventListener listener)

Removes a listener for barcode events.

Parameters:

listener - The listener to remove.

clearListener

public void clearListener()

Removes all listeners for barcode events.

triggerParameterTransferEvent

protected void triggerParameterTransferEvent(boolean enabled)

Triggers a parameter transfer event.

Parameters:

enabled - Whether the parameter transfer is enabled.

pumpEvent

public void pumpEvent(com.unitech.lib.event.params.ProtocolEventArgs args)

Handles protocol events.

Parameters:

args - The ProtocolEventArgs object containing event data.

convertVersion

protected void convertVersion(java.lang.String version)

Convert the engine version string to an integer.

Parameters:

version - The version string.

assertEngineParamId

protected void assertEngineParamId(EngineParamID id)
                            throws ReaderException

Asserts that the specified EngineParamID is supported by the engine.

Parameters:

id - The EngineParamID to check.

Throws:

ReaderException - If the EngineParamID is not supported.

getParameter

public void getParameter(int id,
                         EngineParamID engineParamID,
                         IParameterEventListener listener)

Get a specific engine parameter setting.

Parameters:

id - The request ID.

engineParamID - The parameter ID.

listener - The listener to receive the result.

setParameter

public void setParameter(int id,
                         EngineParam engineParam,
                         IParameterEventListener listener)

Set an engine parameter setting.

Parameters:

id - The request ID.

engineParam - The parameter setting.

listener - The listener to receive the result.

getParameters

public void getParameters(int id,
                          EngineParamID[] engineParamIDs,
                          IParameterEventListener listener)

Get multiple engine parameter settings.

Parameters:

id - The request ID.

engineParamIDs - The parameter IDs.

listener - The listener to receive the result.

setParameters

public void setParameters(int id,
                          EngineParam[] engineParams,
                          IParameterEventListener listener)

Set multiple engine parameter settings.

Parameters:

id - The request ID.

engineParams - The parameter settings.

listener - The listener to receive the result.

getParameter

public void getParameter(EngineParamID engineParamID,
                         IParameterEventListener listener)

Get a specific engine parameter setting. (Request ID = 0)

Parameters:

engineParamID - The parameter ID.

listener - The listener to receive the result.

setParameter

public void setParameter(EngineParam engineParam,
                         IParameterEventListener listener)

Set an engine parameter setting. (Request ID = 1)

Parameters:

engineParam - The parameter setting.

listener - The listener to receive the result.

getParameters

public void getParameters(EngineParamID[] engineParamIDs,
                          IParameterEventListener listener)

Get multiple engine parameter settings. (Request ID = 0)

Parameters:

engineParamIDs - The parameter IDs.

listener - The listener to receive the result.

setParameters

public void setParameters(EngineParam[] engineParams,
                          IParameterEventListener listener)

Set multiple engine parameter settings. (Request ID = 1)

Parameters:

engineParams - The parameter settings.

listener - The listener to receive the result.