org.cip4.jdflib.util
Class JDFDuration

java.lang.Object
  org.cip4.jdflib.util.JDFDuration

All Implemented Interfaces:

java.lang.Comparable<JDFDuration>

public class JDFDuration
extends java.lang.Object
implements java.lang.Comparable<JDFDuration>

Author:

Dr. Rainer Prosi, Heidelberger Druckmaschinen AG Aug 10, 2009

Field Summary

private double	m_lDuration
private static java.lang.String	REGEX_DURATION
private static long	serialVersionUID

Constructor Summary

JDFDuration()
Allocates a JDFDuration object and initializes it with 0

JDFDuration(double s)
Allocates a JDFDuration object and initializes it with 's'

JDFDuration(int s)
Allocates a JDFDuration object and initializes it with 's'

JDFDuration(JDFDate start, JDFDate end)
creates a duration from two dates; may be negative if start later end

JDFDuration(JDFDuration d)
Makes a copy of theJDFDuration object 'd'

JDFDuration(java.lang.String strDuration)
Allocates a JDFDuration object and initializes it with a value of strDuration, represented as a formatted duration string.

Method Summary

double	addSeconds(double seconds) add seconds to a duration
int	compareTo(JDFDuration arg0)
boolean	equals(java.lang.Object other) Compares two JDFDuration objects for equality. The result is true if and only if the argument is not null and is a JDFDuration object that represents the same duration, as this object.
int	getDuration() the duration in seconds
java.lang.String	getDurationISO() Format and return the duration set by 'setDuration(int i)' or 'setDurationString(String a_aDuration)' as an ISO conforming String. For example: 'P1Y2M3DT10H30M'
int	hashCode() hashCode: complements equals() to fulfill the equals/hashCode contract
private void	init(java.lang.String strDuration) Method init handles Strings of type: "P1Y2M3DT10H30M" "PM8T12M" "PT30M" "PT30M40S" "PT30M40.3333S"
boolean	isLonger(JDFDuration x) isLess - tests if the duration of this JDFDuration is longer than the duration of the specified JDFDuration.
boolean	isShorter(JDFDuration x) isShorter - tests if the duration of this JDFDuration is less than the duration of the specified JDFDuration.
void	setDuration(double seconds) setDuration: sets a duration for this in seconds, including fractions.
void	setDuration(int seconds) setDuration: sets a duration for this in seconds.
boolean	setDurationISO(java.lang.String a_aDuration) Set a duration.
java.lang.String	toString() for debug purposes

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

m_lDuration

private double m_lDuration

REGEX_DURATION

private static final java.lang.String REGEX_DURATION

See Also:

Constant Field Values

Constructor Detail

JDFDuration

public JDFDuration()

Allocates a JDFDuration object and initializes it with 0

JDFDuration

public JDFDuration(JDFDuration d)

Makes a copy of theJDFDuration object 'd'

Parameters:

d - the duration

JDFDuration

public JDFDuration(JDFDate start,
                   JDFDate end)

creates a duration from two dates; may be negative if start later end

Parameters:

start - the starting point

end - the end point

JDFDuration

public JDFDuration(double s)

Allocates a JDFDuration object and initializes it with 's'

Parameters:

s - duration in seconds s may be fractional

JDFDuration

public JDFDuration(int s)

Allocates a JDFDuration object and initializes it with 's'

Parameters:

s - duration in seconds s may be fractional

JDFDuration

public JDFDuration(java.lang.String strDuration)
            throws java.util.zip.DataFormatException

Allocates a JDFDuration object and initializes it with a value of strDuration, represented as a formatted duration string.
Duration examples:

"P1Y2M3DT10H30M"

"P8MT12M"

Durations with overflows, e.g. P13M (13 Months) are also handled and correctly output, in this case P1Y1M

Parameters:

strDuration - - formatted duration

Throws:

java.util.zip.DataFormatException - if strDuration is not a valid string representation of JDFDuration

Method Detail

addSeconds

public double addSeconds(double seconds)

add seconds to a duration

Parameters:

seconds - number of seconds to add

Returns:

the new duration in seconds

toString

public java.lang.String toString()

for debug purposes

Overrides:

toString in class java.lang.Object

Returns:

Object informations

init

private void init(java.lang.String strDuration)
           throws java.util.zip.DataFormatException

Method init handles Strings of type:

"P1Y2M3DT10H30M"

"PM8T12M"

"PT30M"

"PT30M40S"

"PT30M40.3333S"

Parameters:

strDuration -

Throws:

java.util.zip.DataFormatException

getDurationISO

public java.lang.String getDurationISO()

Format and return the duration set by 'setDuration(int i)' or 'setDurationString(String a_aDuration)' as an ISO conforming String.
For example: 'P1Y2M3DT10H30M'

Returns:

String - the duration formatted as an ISO 8601 conforming String if duration is '0' return value is 'PT00M'

setDurationISO

public boolean setDurationISO(java.lang.String a_aDuration)

Set a duration. Durations are not bound to time or date and can be set independently

Parameters:

a_aDuration - formatted duration string 'P1Y2M3DT10H30M'

Returns:

true - the duration was set
false - the duration was not set, because a NumberFormatException was thrown (-> parseInt())

setDuration

public void setDuration(int seconds)

setDuration: sets a duration for this in seconds. This duration is used in multiple classes of the JDF (e.g. Heating time).

Parameters:

seconds - the duration in seconds.

setDuration

public void setDuration(double seconds)

setDuration: sets a duration for this in seconds, including fractions. This duration is used in multiple classes of the JDF (e.g. Heating time).

Parameters:

seconds - the duration in seconds.

getDuration

public int getDuration()

the duration in seconds

Returns:

int - the duration in seconds; '0' default

isLonger

public boolean isLonger(JDFDuration x)

isLess - tests if the duration of this JDFDuration is longer than the duration of the specified JDFDuration. Compares the integer durations, thus -PT15S is shorter than -PT5S

Parameters:

x - the JDFDuration object to compare to this

Returns:

boolean - true if the duration of this JDFDuration is longer than the duration of the JDFDuration 'x'.

isShorter

public boolean isShorter(JDFDuration x)

isShorter - tests if the duration of this JDFDuration is less than the duration of the specified JDFDuration. Compares the integer durations, thus -PT15S is shorter than -PT5S

Parameters:

x - the JDFDuration object to compare to this

Returns:

boolean - true if the duration of this JDFDuration is shorter than the duration of the JDFDuration 'x'.

equals

public boolean equals(java.lang.Object other)

Compares two JDFDuration objects for equality.
The result is true if and only if the argument is not null and is a JDFDuration object that represents the same duration, as this object.

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

hashCode: complements equals() to fulfill the equals/hashCode contract

Overrides:

hashCode in class java.lang.Object

compareTo

public int compareTo(JDFDuration arg0)

Specified by:

compareTo in interface java.lang.Comparable<JDFDuration>

Parameters:

arg0 -

Returns:

See Also:

Comparable.compareTo(java.lang.Object)