javax.realtime

Class Clock

java.lang.Object

javax.realtime.Clock

All Implemented Interfaces:

Chronograph

public abstract class Clock
extends java.lang.Object
implements Chronograph

Jamaica Real-Time Specification for Java class Clock.

A clock provides means to determine the current time (now) with a given resolution.

Constructor Summary

Constructors

Constructor and Description
Clock() Constructor to be called by subclasses of Clock.

Method Summary

Modifier and Type	Method and Description
RelativeTime	getEpochOffset() Determines the time on the UTC clock when this chronograph was zero.
RelativeTime	getQueryPrecision() Obtain the precision with which time can be read, i.e., the nominal interval between ticks.
RelativeTime	getQueryPrecision(RelativeTime dest) Obtain the precision with which time can be read, i.e., the nominal interval between ticks.
static Clock	getRealtimeClock() Returns the default RealtimeClock.
abstract RelativeTime	getResolution() Returns the resolution of this clock, i.e.
AbsoluteTime	getTime() Determines the current time.
abstract AbsoluteTime	getTime(AbsoluteTime time) Obtain the current time.
abstract void	setResolution(RelativeTime resolution) Sets the resolution of this time to the provided value.

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.realtime.Chronograph

getEpochOffset

Constructor Detail

Clock

public Clock()

Constructor to be called by subclasses of Clock.

Since this class is abstract, this constructor cannot be called from a class that is not a sub-class of Clock, it should therefore better be protected.

Method Detail

getRealtimeClock

public static Clock getRealtimeClock()

Returns the default RealtimeClock. The result is the singleton instance of this clock.

For JamaicaVM, on systems that have a timer that is synchronized with the external world, this returns a RealtimeClock that is synchronized with the external world. On systems whose timer is not synchronized with the external world, the time of the returned RealtimeClock may be different to the time used by the external world (e.g., the epoch may start at system boot time).

Returns:

the default RealtimeClock, will be located in HeapMemory.

getEpochOffset

public RelativeTime getEpochOffset()
                            throws StaticUnsupportedOperationException,
                                   UninitializedStateException

Determines the time on the UTC clock when this chronograph was zero.

Specified by:

getEpochOffset in interface Chronograph

Returns:

A newly allocated RelativeTime object in the current execution context with the realtime clock as its chronograph and containing time when this chronograph was zero.

Throws:

StaticUnsupportedOperationException

UninitializedStateException - when UTC time is not yet available.

Since:

RTSJ 1.0.1

getResolution

public abstract RelativeTime getResolution()

Returns the resolution of this clock, i.e. the constant time interval between two consecutive ticks.

Returns:

the resolution of this clock, allocated in a new object

getTime

public AbsoluteTime getTime()

Description copied from interface: Chronograph

Determines the current time. This method returns an absolute time value representing the chronograph's notion of absolute time. For chronographs that do not measure calendar time, this absolute time may not represent a wall clock time.

Specified by:

getTime in interface Chronograph

Returns:

A newly allocated instance of AbsoluteTime in the current allocation context, representing the current time. The returned object has this its chronograph.

getTime

public abstract AbsoluteTime getTime(AbsoluteTime time)

Obtain the current time. The time represented by the given AbsoluteTime is changed at some time between the invocation of the method and the return of the method. This method will return an absolute time value that represents this chronograph's notion of the absolute time. For chronographs that do not measure calendar time, this absolute time may not represent a wall clock time.

Specified by:

getTime in interface Chronograph

Parameters:

time - The instance of AbsoluteTime object which will be updated in place.

Returns:

The instance of AbsoluteTime passed as parameter, or a new object when dest is null. The returned object represents the current time and is associated with this chronograph.

Since:

RTSJ V1.0.1 the return value is AbsoluteTime and no longer void.

setResolution

public abstract void setResolution(RelativeTime resolution)

Sets the resolution of this time to the provided value.

Parameters:

resolution - the new resolution.

Throws:

StaticIllegalArgumentException - if parameter is null or represents a negative or zero interval.

java.lang.UnsupportedOperationException - if setting of the timer is not supported for the given system.

getQueryPrecision

public RelativeTime getQueryPrecision()

Description copied from interface: Chronograph

Obtain the precision with which time can be read, i.e., the nominal interval between ticks. It is the same as calling Chronograph.getQueryPrecision(RelativeTime) with null as an argument.

Specified by:

getQueryPrecision in interface Chronograph

Returns:

a newly allocated time value holding the read precision.

getQueryPrecision

public RelativeTime getQueryPrecision(RelativeTime dest)

Description copied from interface: Chronograph

Obtain the precision with which time can be read, i.e., the nominal interval between ticks.

Specified by:

getQueryPrecision in interface Chronograph

Parameters:

dest - is a time object in which to return the results.

Returns:

the read precision in dest, when dest is not null, or in a newly created object otherwise.