com.luciad.realtime

LuciadLightspeedClass ALcdSimulatorModel

java.lang.Object

com.luciad.realtime.ALcdSimulatorModel

All Implemented Interfaces:

ILcdSimulatorModel, ILcdPropertyChangeSource

Direct Known Subclasses:

ALcdTimeIndexedSimulatorModel

public abstract class ALcdSimulatorModel
extends Object
implements ILcdSimulatorModel

Abstract convenience implementation of ILcdSimulatorModel that handles all properties and their property change events. Setters are protected as they should only be used from a subclass.

Subclasses must implement updateTrackModels to let the simulator data match the current date.

Since:

7.2

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ALcdSimulatorModel() Creates a new ALcdSimulatorModel.
protected	ALcdSimulatorModel(ILcdModel[] aTrackModels, Date aBeginDate, Date aEndDate) Creates a new ALcdSimulatorModel with the given track models, begin date and end date.

Method Summary

Modifier and Type	Method and Description
void	addPropertyChangeListener(PropertyChangeListener aListener) Adds the given listener to the list of listeners, so that it will receive property change events.
protected void	firePropertyChangeEvent(PropertyChangeEvent aEvent) Fires the given PropertyChangeEvent to all associated listeners.
Date	getBeginDate() Returns the begin Date of the simulation.
Date	getDate() Gets the Date corresponding to the current state of the domain objects (tracks) this ILcdSimulatorModel contains.
Date	getEndDate() Returns the end Date of the simulation.
ILcdModel[]	getTrackModels() Returns the array of ILcdModels holding the simulated domain data.
void	removePropertyChangeListener(PropertyChangeListener aListener) Removes the given listener so that it no longer receives property change events.
protected void	setBeginDate(Date aBeginDate) Sets the begin date.
void	setDate(Date aDate) Sets a new date.
protected void	setEndDate(Date aEndDate) Sets the end date.
protected void	setTrackModels(ILcdModel[] aTrackModels) Sets the track models property.
protected abstract void	updateTrackModels(Date aOldDate, Date aNewDate) Updates the track models of this ALcdSimulatorModel to the given new Date.

Methods inherited from class java.lang.Object

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

Constructor Detail

ALcdSimulatorModel

protected ALcdSimulatorModel()

Creates a new ALcdSimulatorModel. One must call setTrackModels, setBeginDate and setEndDate to have a useful instance.

See Also:

setTrackModels(com.luciad.model.ILcdModel[]), setBeginDate(java.util.Date), setEndDate(java.util.Date)

ALcdSimulatorModel

protected ALcdSimulatorModel(ILcdModel[] aTrackModels,
                             Date aBeginDate,
                             Date aEndDate)

Creates a new ALcdSimulatorModel with the given track models, begin date and end date.

Parameters:

aTrackModels - The track models.

aBeginDate - The begin date.

aEndDate - The end date.

See Also:

setTrackModels(com.luciad.model.ILcdModel[]), setBeginDate(java.util.Date), setEndDate(java.util.Date)

Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener aListener)

Adds the given listener to the list of listeners, so that it will receive property change events.

Specified by:

addPropertyChangeListener in interface ILcdPropertyChangeSource

Parameters:

aListener - The listener to add.

See Also:

ALcdWeakPropertyChangeListener, ILcdPropertyChangeSource.removePropertyChangeListener(java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener aListener)

Removes the given listener so that it no longer receives property change events.

Specified by:

removePropertyChangeListener in interface ILcdPropertyChangeSource

Parameters:

aListener - The listener to remove.

See Also:

ILcdPropertyChangeSource.addPropertyChangeListener(java.beans.PropertyChangeListener)

firePropertyChangeEvent

protected void firePropertyChangeEvent(PropertyChangeEvent aEvent)

Fires the given PropertyChangeEvent to all associated listeners.

Parameters:

aEvent - The event to fire.

getTrackModels

public ILcdModel[] getTrackModels()

Description copied from interface: ILcdSimulatorModel

Returns the array of ILcdModels holding the simulated domain data. The state of the domain objects in these models is updated when setDate is called.

A property change event must be fired whenever the return value of this method changes.

Specified by:

getTrackModels in interface ILcdSimulatorModel

Returns:

The array of ILcdModels holding the simulated domain data. This must not be null.

See Also:

ILcdSimulatorModel.setDate(java.util.Date)

setTrackModels

protected void setTrackModels(ILcdModel[] aTrackModels)

Sets the track models property. A property change event is fired.

Parameters:

aTrackModels - The new array of track models.

See Also:

getTrackModels()

getBeginDate

public Date getBeginDate()

Description copied from interface: ILcdSimulatorModel

Returns the begin Date of the simulation.

A property change event must be fired whenever the return value of this method changes.

Specified by:

getBeginDate in interface ILcdSimulatorModel

Returns:

The begin Date of the simulation. This must not be null.

setBeginDate

protected void setBeginDate(Date aBeginDate)

Sets the begin date. A property change event is fired.

Parameters:

aBeginDate - The new begin date.

See Also:

getBeginDate()

getEndDate

public Date getEndDate()

Description copied from interface: ILcdSimulatorModel

Returns the end Date of the simulation.

A property change event must be fired whenever the return value of this method changes.

Specified by:

getEndDate in interface ILcdSimulatorModel

Returns:

The end Date of the simulation. This must not be null.

setEndDate

protected void setEndDate(Date aEndDate)

Sets the end date. A property change event is fired.

Parameters:

aEndDate - The new end date.

See Also:

getEndDate()

getDate

public Date getDate()

Description copied from interface: ILcdSimulatorModel

Gets the Date corresponding to the current state of the domain objects (tracks) this ILcdSimulatorModel contains.

Specified by:

getDate in interface ILcdSimulatorModel

Returns:

The Date of the current state.

See Also:

ILcdSimulatorModel.setDate(Date)

setDate

public void setDate(Date aDate)

Sets a new date. Calls updateTrackModels(java.util.Date, java.util.Date) to update the simulator data represented by this ALcdSimulatorModel.

Note that no property change event is fired.

Specified by:

setDate in interface ILcdSimulatorModel

Parameters:

aDate - The new date.

See Also:

ILcdSimulatorModel.getTrackModels(), ILcdSimulatorModel.getDate(), TLcdLockUtil.writeLock(Object)

updateTrackModels

protected abstract void updateTrackModels(Date aOldDate,
                                          Date aNewDate)

Updates the track models of this ALcdSimulatorModel to the given new Date. This method is called by setDate.

Parameters:

aOldDate - The old date, given as contextual information.

aNewDate - The date to update the track models of this ALcdSimulatorModel to.