org.fosstrak.ale.server.readers.hal
Class HALAdaptor

java.lang.Object
  java.util.Observable
      org.fosstrak.ale.server.readers.LogicalReader
          org.fosstrak.ale.server.readers.BaseReader
              org.fosstrak.ale.server.readers.hal.HALAdaptor

public class HALAdaptor
extends BaseReader

adaptor for all HAL devices. this adaptor allows to attach HAL devices directly to the ale

Author:

sawielan

Field Summary

static java.lang.String

DEFAULT_IMPLCLASS the name of the default implementing class to be chosen.

Fields inherited from class org.fosstrak.ale.server.readers.BaseReader

connected

Fields inherited from class org.fosstrak.ale.server.readers.LogicalReader

logicalReaderProperties, logicalReaderSpec, properties, readerName, started

Constructor Summary

HALAdaptor()
constructor for the HAL adaptor.

Method Summary

void	addTag(Tag tag) whenever a new Tag is read a notification is sent to the observers.
void	addTags(java.util.List<Tag> tags) whenever new Tags are read a notification is sent to the observers.
void	cleanup() this method is called whenever a reader is undefined. a basereader can override this method with its own cleanup routine.
void	connectReader() sets up a reader.
void	disconnectReader() destroys a reader.
org.fosstrak.hal.Observation[]	identify(java.lang.String[] readPointNames) Triggers the identification of all tags that are currently available on the reader. this method is used when the IdentifyThread is used to poll the adaptor.
void	initialize(java.lang.String name, org.fosstrak.ale.xsd.ale.epcglobal.LRSpec spec) initializes a HALAdaptor. this method must be called befor the Adaptor can be used.
void	start() starts a base reader to read tags.
void	stop() stops a reader from reading tags.
void	update(org.fosstrak.ale.xsd.ale.epcglobal.LRSpec spec) updates a reader according the specified LRSpec.

Methods inherited from class org.fosstrak.ale.server.readers.BaseReader

isConnected, setConnected, setDisconnected

Methods inherited from class org.fosstrak.ale.server.readers.LogicalReader

createReader, getLRSpec, getName, getProperties, isStarted, setLRSpec, setName, setProperties, setStarted, setStopped

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_IMPLCLASS

public static final java.lang.String DEFAULT_IMPLCLASS

the name of the default implementing class to be chosen.

See Also:

Constant Field Values

Constructor Detail

HALAdaptor

public HALAdaptor()

constructor for the HAL adaptor.

Method Detail

initialize

public void initialize(java.lang.String name,
                       org.fosstrak.ale.xsd.ale.epcglobal.LRSpec spec)
                throws org.fosstrak.ale.wsdl.ale.epcglobal.ImplementationExceptionResponse

initializes a HALAdaptor. this method must be called befor the Adaptor can be used.

Overrides:

initialize in class BaseReader

Parameters:

name - the name for the reader encapsulated by this adaptor.

spec - the specification that describes the current reader.

Throws:

org.fosstrak.ale.wsdl.ale.epcglobal.ImplementationException - whenever an internal error occurs.

org.fosstrak.ale.wsdl.ale.epcglobal.ImplementationExceptionResponse

connectReader

public void connectReader()
                   throws org.fosstrak.ale.wsdl.ale.epcglobal.ImplementationExceptionResponse

sets up a reader.

Specified by:

connectReader in class BaseReader

Throws:

org.fosstrak.ale.wsdl.ale.epcglobal.ImplementationException - whenever an internal error occured

org.fosstrak.ale.wsdl.ale.epcglobal.ImplementationExceptionResponse

disconnectReader

public void disconnectReader()
                      throws org.fosstrak.ale.wsdl.ale.epcglobal.ImplementationExceptionResponse

destroys a reader.

Specified by:

disconnectReader in class BaseReader

Throws:

org.fosstrak.ale.wsdl.ale.epcglobal.ImplementationException - whenever an internal error occured

org.fosstrak.ale.wsdl.ale.epcglobal.ImplementationExceptionResponse

start

public void start()

starts a base reader to read tags.

Specified by:

start in class BaseReader

stop

public void stop()

stops a reader from reading tags.

Specified by:

stop in class BaseReader

update

public void update(org.fosstrak.ale.xsd.ale.epcglobal.LRSpec spec)
            throws org.fosstrak.ale.wsdl.ale.epcglobal.ImplementationExceptionResponse

updates a reader according the specified LRSpec.

Specified by:

update in class BaseReader

Parameters:

spec - LRSpec for the reader

Throws:

org.fosstrak.ale.wsdl.ale.epcglobal.ImplementationException - whenever an internal error occurs

org.fosstrak.ale.wsdl.ale.epcglobal.ImplementationExceptionResponse

addTag

public void addTag(Tag tag)

whenever a new Tag is read a notification is sent to the observers.

Specified by:

addTag in class BaseReader

Parameters:

tag - a tag read on the reader

addTags

public void addTags(java.util.List<Tag> tags)

whenever new Tags are read a notification is sent to the observers.

Specified by:

addTags in class BaseReader

Parameters:

tags - a list of tags to be added to the reader

identify

public org.fosstrak.hal.Observation[] identify(java.lang.String[] readPointNames)
                                        throws org.fosstrak.hal.HardwareException

Triggers the identification of all tags that are currently available on the reader. this method is used when the IdentifyThread is used to poll the adaptor.

Specified by:

identify in class BaseReader

Parameters:

readPointNames - the readers/sources that have to be polled

Returns:

a set of Observations

Throws:

org.fosstrak.hal.HardwareException - whenever an internal hardware error occurs (as reader not available...)

cleanup

public void cleanup()

Description copied from class: BaseReader

this method is called whenever a reader is undefined. a basereader can override this method with its own cleanup routine.

Overrides:

cleanup in class BaseReader