jadex.bridge.service.clock

Class ClockService

java.lang.Object

jadex.bridge.service.BasicService

jadex.bridge.service.clock.ClockService

All Implemented Interfaces:

IClockService, IInternalService, IService, IPropertiesProvider

public class ClockService
extends BasicService
implements IClockService, IPropertiesProvider

A clock service abstracts away from clock implementations. The clock service is meant to be kept constant during runtime.

Field Summary

Fields inherited from interface jadex.bridge.service.clock.IClockService

TYPE

Fields inherited from interface jadex.bridge.service.IService

EMPTY_SERVICES

Constructor Summary

Constructors

Constructor and Description
ClockService(ClockCreationInfo cinfo, IServiceProvider provider) Create a new clock service.
ClockService(ClockCreationInfo cinfo, IServiceProvider provider, Map properties) Create a new clock service.

Method Summary

Methods

Modifier and Type	Method and Description
void	addChangeListener(IChangeListener listener) Add a change listener.
boolean	advanceEvent() Advance one event.
static IClock	createClock(ClockCreationInfo cinfo, IThreadPool tp) Create a clock.
ITimer	createTickTimer(ITimedObject to) Create a new tick timer.
ITimer	createTimer(long time, ITimedObject to) Create a new timer.
String	getClockType() Get the clock type.
long	getDelta() Get the clock delta.
double	getDilation() Get the clocks dilation.
ITimer	getNextTimer() Get the next timer.
IFuture<Properties>	getProperties() Write current state into properties.
long	getStarttime() Get the clocks start time.
String	getState() Get the clock state.
double	getTick() Get the current tick.
long	getTime() Get the current time.
ITimer[]	getTimers() Get all active timers.
void	removeChangeListener(IChangeListener listener) Remove a change listener.
void	setClock(String type, IThreadPool tp) Set the clock.
void	setDelta(long delta) Set the clock delta.
void	setDilation(double dilation) Set the clocks dilation.
IFuture<Void>	setProperties(Properties props) Update from given properties.
IFuture	shutdownService() Shutdown the service.
void	start() Start the clock.
IFuture<Void>	startService() Start the service.
void	stop() Stop the clock.

Methods inherited from class jadex.bridge.service.BasicService

createServiceIdentifier, createServiceIdentifier, equals, generateServiceName, getPropertyMap, getServiceIdentifier, isValid, setPropertyMap

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface jadex.bridge.service.IService

getPropertyMap, getServiceIdentifier, isValid

Constructor Detail

ClockService

public ClockService(ClockCreationInfo cinfo,
            IServiceProvider provider)

Create a new clock service.

ClockService

public ClockService(ClockCreationInfo cinfo,
            IServiceProvider provider,
            Map properties)

Create a new clock service.

Method Detail

getTime

public long getTime()

Get the current time.

Specified by:

getTime in interface IClockService

Returns:

The current time.

getTick

public double getTick()

Get the current tick.

Specified by:

getTick in interface IClockService

Returns:

The current tick.

getStarttime

public long getStarttime()

Get the clocks start time.

Specified by:

getStarttime in interface IClockService

Returns:

The start time.

getDelta

public long getDelta()

Get the clock delta.

Specified by:

getDelta in interface IClockService

Returns:

The clock delta.

setDelta

public void setDelta(long delta)

Set the clock delta. param delta The new clock delta.

Specified by:

setDelta in interface IClockService

Parameters:

delta - The new clock delta.

getState

public String getState()

Get the clock state.

Specified by:

getState in interface IClockService

Returns:

The clock state.

getDilation

public double getDilation()

Get the clocks dilation.

Specified by:

getDilation in interface IClockService

Returns:

The clocks dilation. // Hack!!! only for continuous clock.

setDilation

public void setDilation(double dilation)

Set the clocks dilation.

Specified by:

setDilation in interface IClockService

Parameters:

dilation - The clocks dilation. // Hack. Remove? only for continuous

getClockType

public String getClockType()

Get the clock type.

Specified by:

getClockType in interface IClockService

Returns:

The clock type.

createTimer

public ITimer createTimer(long time,
                 ITimedObject to)

Create a new timer. The unit of the timespan value depends on the clock implementation. For system clocks, the time value should adhere to the time representation as used by System.currentTimeMillis().

Specified by:

createTimer in interface IClockService

Parameters:

timespan - The relative timespan after which the timed object should be notified.

to - The timed object.

createTickTimer

public ITimer createTickTimer(ITimedObject to)

Create a new tick timer. todo: @param tickcount The number of ticks.

Specified by:

createTickTimer in interface IClockService

Parameters:

to - The timed object.

getNextTimer

public ITimer getNextTimer()

Get the next timer.

Specified by:

getNextTimer in interface IClockService

Returns:

The next timer.

getTimers

public ITimer[] getTimers()

Get all active timers.

Specified by:

getTimers in interface IClockService

Returns:

The active timers.

addChangeListener

public void addChangeListener(IChangeListener listener)

Add a change listener.

Specified by:

addChangeListener in interface IClockService

Parameters:

listener - The change listener.

removeChangeListener

public void removeChangeListener(IChangeListener listener)

Remove a change listener.

Specified by:

removeChangeListener in interface IClockService

Parameters:

listener - The change listener.

advanceEvent

public boolean advanceEvent()

Advance one event.

Specified by:

advanceEvent in interface IClockService

Returns:

True, if clock could be advanced.

start

public void start()

Start the clock.

Specified by:

start in interface IClockService

stop

public void stop()

Stop the clock.

Specified by:

stop in interface IClockService

startService

public IFuture<Void> startService()

Start the service.

Specified by:

startService in interface IInternalService

Overrides:

startService in class BasicService

Returns:

A future that is done when the service has completed starting.

shutdownService

public IFuture shutdownService()

Shutdown the service.

Specified by:

shutdownService in interface IInternalService

Overrides:

shutdownService in class BasicService

Parameters:

listener - The listener.

Returns:

A future that is done when the service has completed its shutdown.

setClock

public void setClock(String type,
            IThreadPool tp)

Set the clock.

Specified by:

setClock in interface IClockService

Parameters:

clock - The new clock.

createClock

public static IClock createClock(ClockCreationInfo cinfo,
                 IThreadPool tp)

Create a clock.

setProperties

public IFuture<Void> setProperties(Properties props)

Update from given properties.

Specified by:

setProperties in interface IPropertiesProvider

getProperties

public IFuture<Properties> getProperties()

Write current state into properties.

Specified by:

getProperties in interface IPropertiesProvider