Package org.joda.time

Class IllegalFieldValueException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

java.lang.IllegalArgumentException

org.joda.time.IllegalFieldValueException

All Implemented Interfaces:

java.io.Serializable

public class IllegalFieldValueException
extends java.lang.IllegalArgumentException

Exception thrown when attempting to set a field outside its supported range.

Since:

1.1

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private DateTimeFieldType	iDateTimeFieldType
private DurationFieldType	iDurationFieldType
private java.lang.String	iFieldName
private java.lang.Number	iLowerBound
private java.lang.String	iMessage
private java.lang.Number	iNumberValue
private java.lang.String	iStringValue
private java.lang.Number	iUpperBound
private static long	serialVersionUID	Serialization lock.

Constructor Summary

Constructors

Constructor	Description
IllegalFieldValueException(java.lang.String fieldName, java.lang.Number value, java.lang.Number lowerBound, java.lang.Number upperBound)	Constructor.
IllegalFieldValueException(java.lang.String fieldName, java.lang.String value)	Constructor.
IllegalFieldValueException(DateTimeFieldType fieldType, java.lang.Number value, java.lang.Number lowerBound, java.lang.Number upperBound)	Constructor.
IllegalFieldValueException(DateTimeFieldType fieldType, java.lang.Number value, java.lang.String explain)	Constructor.
IllegalFieldValueException(DateTimeFieldType fieldType, java.lang.String value)	Constructor.
IllegalFieldValueException(DurationFieldType fieldType, java.lang.Number value, java.lang.Number lowerBound, java.lang.Number upperBound)	Constructor.
IllegalFieldValueException(DurationFieldType fieldType, java.lang.String value)	Constructor.

Method Summary

Modifier and Type	Method	Description
private static java.lang.String	createMessage(java.lang.String fieldName, java.lang.Number value, java.lang.Number lowerBound, java.lang.Number upperBound, java.lang.String explain)	Creates a message for the exception.
private static java.lang.String	createMessage(java.lang.String fieldName, java.lang.String value)	Creates a message for the exception.
DateTimeFieldType	getDateTimeFieldType()	Returns the DateTimeFieldType whose value was invalid, or null if not applicable.
DurationFieldType	getDurationFieldType()	Returns the DurationFieldType whose value was invalid, or null if not applicable.
java.lang.String	getFieldName()	Returns the name of the field whose value was invalid.
java.lang.Number	getIllegalNumberValue()	Returns the illegal integer value assigned to the field, or null if not applicable.
java.lang.String	getIllegalStringValue()	Returns the illegal string value assigned to the field, or null if not applicable.
java.lang.String	getIllegalValueAsString()	Returns the illegal value assigned to the field as a non-null string.
java.lang.Number	getLowerBound()	Returns the lower bound of the legal value range, or null if not applicable.
java.lang.String	getMessage()
java.lang.Number	getUpperBound()	Returns the upper bound of the legal value range, or null if not applicable.
void	prependMessage(java.lang.String message)	Provide additional detail by prepending a message to the existing message.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

Serialization lock.

See Also:

Constant Field Values

iDateTimeFieldType

private final DateTimeFieldType iDateTimeFieldType

iDurationFieldType

private final DurationFieldType iDurationFieldType

iFieldName

private final java.lang.String iFieldName

iNumberValue

private final java.lang.Number iNumberValue

iStringValue

private final java.lang.String iStringValue

iLowerBound

private final java.lang.Number iLowerBound

iUpperBound

private final java.lang.Number iUpperBound

iMessage

private java.lang.String iMessage

Constructor Detail

IllegalFieldValueException

public IllegalFieldValueException(DateTimeFieldType fieldType,
                                  java.lang.Number value,
                                  java.lang.Number lowerBound,
                                  java.lang.Number upperBound)

Constructor.

Parameters:

fieldType - type of field being set

value - illegal value being set

lowerBound - lower legal field value, or null if not applicable

upperBound - upper legal field value, or null if not applicable

IllegalFieldValueException

public IllegalFieldValueException(DateTimeFieldType fieldType,
                                  java.lang.Number value,
                                  java.lang.String explain)

Constructor.

Parameters:

fieldType - type of field being set

value - illegal value being set

explain - an explanation

Since:

1.5

IllegalFieldValueException

public IllegalFieldValueException(DurationFieldType fieldType,
                                  java.lang.Number value,
                                  java.lang.Number lowerBound,
                                  java.lang.Number upperBound)

Constructor.

Parameters:

fieldType - type of field being set

value - illegal value being set

lowerBound - lower legal field value, or null if not applicable

upperBound - upper legal field value, or null if not applicable

IllegalFieldValueException

public IllegalFieldValueException(java.lang.String fieldName,
                                  java.lang.Number value,
                                  java.lang.Number lowerBound,
                                  java.lang.Number upperBound)

Constructor.

Parameters:

fieldName - name of field being set

value - illegal value being set

lowerBound - lower legal field value, or null if not applicable

upperBound - upper legal field value, or null if not applicable

IllegalFieldValueException

public IllegalFieldValueException(DateTimeFieldType fieldType,
                                  java.lang.String value)

Constructor.

Parameters:

fieldType - type of field being set

value - illegal value being set

IllegalFieldValueException

public IllegalFieldValueException(DurationFieldType fieldType,
                                  java.lang.String value)

Constructor.

Parameters:

fieldType - type of field being set

value - illegal value being set

IllegalFieldValueException

public IllegalFieldValueException(java.lang.String fieldName,
                                  java.lang.String value)

Constructor.

Parameters:

fieldName - name of field being set

value - illegal value being set

Method Detail

createMessage

private static java.lang.String createMessage(java.lang.String fieldName,
                                              java.lang.Number value,
                                              java.lang.Number lowerBound,
                                              java.lang.Number upperBound,
                                              java.lang.String explain)

Creates a message for the exception.

Parameters:

fieldName - the field name

value - the value rejected

lowerBound - the lower bound allowed

upperBound - the upper bound allowed

explain - an explanation

Returns:

the message

createMessage

private static java.lang.String createMessage(java.lang.String fieldName,
                                              java.lang.String value)

Creates a message for the exception.

Parameters:

fieldName - the field name

value - the value rejected

Returns:

the message

getDateTimeFieldType

public DateTimeFieldType getDateTimeFieldType()

Returns the DateTimeFieldType whose value was invalid, or null if not applicable.

Returns:

the datetime field type

getDurationFieldType

public DurationFieldType getDurationFieldType()

Returns the DurationFieldType whose value was invalid, or null if not applicable.

Returns:

the duration field type

getFieldName

public java.lang.String getFieldName()

Returns the name of the field whose value was invalid.

Returns:

the field name

getIllegalNumberValue

public java.lang.Number getIllegalNumberValue()

Returns the illegal integer value assigned to the field, or null if not applicable.

Returns:

the value

getIllegalStringValue

public java.lang.String getIllegalStringValue()

Returns the illegal string value assigned to the field, or null if not applicable.

Returns:

the value

getIllegalValueAsString

public java.lang.String getIllegalValueAsString()

Returns the illegal value assigned to the field as a non-null string.

Returns:

the value

getLowerBound

public java.lang.Number getLowerBound()

Returns the lower bound of the legal value range, or null if not applicable.

Returns:

the lower bound

getUpperBound

public java.lang.Number getUpperBound()

Returns the upper bound of the legal value range, or null if not applicable.

Returns:

the upper bound

getMessage

public java.lang.String getMessage()

Overrides:

getMessage in class java.lang.Throwable

prependMessage

public void prependMessage(java.lang.String message)

Provide additional detail by prepending a message to the existing message. A colon is separator is automatically inserted between the messages.

Since:

1.3