org.salespointframework.core
Interface Time

All Known Implementing Classes:

CalendarTime, Date, Step

public interface Time

Interface used by implementations of the Timer interface.

So, it is possible for a timer to deal with different time formats.

Since:

v2.0

Version:

2.0 11/06/1999

Author:

Stephan Gambke

Method Summary

java.lang.Object	getDefaultInterval() Get the default interval to be used by timers.
java.lang.Object	getTime() Get the current time.
java.lang.Comparable<java.lang.String>	getTimeStamp(long lStampNumber) Create and return a time stamp.
void	goAhead(java.lang.Object oInterval) Increases the current time by the given interval.
void	setTime(java.lang.Object oTime) Set the time.

Method Detail

setTime

void setTime(java.lang.Object oTime)
             throws java.lang.IllegalArgumentException

Set the time.

Parameters:

oTime - the time to be set

Throws:

java.lang.IllegalArgumentException - if the time does not meet the time object's class or format requirements

getTime

java.lang.Object getTime()

Get the current time.

The returned object should have a useful toString() method, so that the time can be printed in a meaningful way.

Returns:

an object representing the current time.

goAhead

void goAhead(java.lang.Object oInterval)
             throws java.lang.IllegalArgumentException

Increases the current time by the given interval.

Parameters:

oInterval - the interval

Throws:

java.lang.IllegalArgumentException - if the interval does not meet the time object's class or format requirements

getDefaultInterval

java.lang.Object getDefaultInterval()

Get the default interval to be used by timers.

This method is required for calls of Timer.goAhead() before the Timer.setInterval() method was called.

Returns:

an object representing a valid interval for this Time object

getTimeStamp

java.lang.Comparable<java.lang.String> getTimeStamp(long lStampNumber)

Create and return a time stamp.

The returned time stamps have to be in a natural order that is identical to the order of creation. A good idea would be a String consisting of the time in a correctly sortable format followed by a value representing the stamp number in this time interval.

More formally two time stamps a and b must fulfil the following conditions:

• a.compareTo (b) < 0 iff a was obtained before b.
• a.compareTo (b) > 0 iff a was obtained after b.
• a.compareTo (b) == 0 iff a was obtained at the same time as b, i.e. iff a == b.

Parameters:

lStampNumber - the number of the stamp

Returns:

a time stamp that fulfills the above conditions.