|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.joda.time.field.FieldUtils
public class FieldUtils
General utilities that don't fit elsewhere.
FieldUtils is thread-safe and immutable.
Method Summary | |
---|---|
static boolean |
equals(Object object1,
Object object2)
Compares two objects as equals handling null. |
static int |
getWrappedValue(int value,
int minValue,
int maxValue)
Utility method that ensures the given value lies within the field's legal value range. |
static int |
getWrappedValue(int currentValue,
int wrapValue,
int minValue,
int maxValue)
Utility method used by addWrapField implementations to ensure the new value lies within the field's legal value range. |
static int |
safeAdd(int val1,
int val2)
Add two values throwing an exception if overflow occurs. |
static long |
safeAdd(long val1,
long val2)
Add two values throwing an exception if overflow occurs. |
static int |
safeMultiply(int val1,
int val2)
Multiply two values throwing an exception if overflow occurs. |
static long |
safeMultiply(long val1,
int val2)
Multiply two values throwing an exception if overflow occurs. |
static long |
safeMultiply(long val1,
long val2)
Multiply two values throwing an exception if overflow occurs. |
static int |
safeMultiplyToInt(long val1,
long val2)
Multiply two values to return an int throwing an exception if overflow occurs. |
static int |
safeNegate(int value)
Negates the input throwing an exception if it can't negate it. |
static long |
safeSubtract(long val1,
long val2)
Subtracts two values throwing an exception if overflow occurs. |
static int |
safeToInt(long value)
Casts to an int throwing an exception if overflow occurs. |
static void |
verifyValueBounds(DateTimeField field,
int value,
int lowerBound,
int upperBound)
Verify that input values are within specified bounds. |
static void |
verifyValueBounds(DateTimeFieldType fieldType,
int value,
int lowerBound,
int upperBound)
Verify that input values are within specified bounds. |
static void |
verifyValueBounds(String fieldName,
int value,
int lowerBound,
int upperBound)
Verify that input values are within specified bounds. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static int safeNegate(int value)
value
- the value to negate
ArithmeticException
- if the value is Integer.MIN_VALUEpublic static int safeAdd(int val1, int val2)
val1
- the first valueval2
- the second value
ArithmeticException
- if the value is too big or too smallpublic static long safeAdd(long val1, long val2)
val1
- the first valueval2
- the second value
ArithmeticException
- if the value is too big or too smallpublic static long safeSubtract(long val1, long val2)
val1
- the first value, to be taken away fromval2
- the second value, the amount to take away
ArithmeticException
- if the value is too big or too smallpublic static int safeMultiply(int val1, int val2)
val1
- the first valueval2
- the second value
ArithmeticException
- if the value is too big or too smallpublic static long safeMultiply(long val1, int val2)
val1
- the first valueval2
- the second value
ArithmeticException
- if the value is too big or too smallpublic static long safeMultiply(long val1, long val2)
val1
- the first valueval2
- the second value
ArithmeticException
- if the value is too big or too smallpublic static int safeToInt(long value)
value
- the value
ArithmeticException
- if the value is too big or too smallpublic static int safeMultiplyToInt(long val1, long val2)
val1
- the first valueval2
- the second value
ArithmeticException
- if the value is too big or too smallpublic static void verifyValueBounds(DateTimeField field, int value, int lowerBound, int upperBound)
value
- the value to checklowerBound
- the lower bound allowed for valueupperBound
- the upper bound allowed for value
IllegalFieldValueException
- if value is not in the specified boundspublic static void verifyValueBounds(DateTimeFieldType fieldType, int value, int lowerBound, int upperBound)
value
- the value to checklowerBound
- the lower bound allowed for valueupperBound
- the upper bound allowed for value
IllegalFieldValueException
- if value is not in the specified boundspublic static void verifyValueBounds(String fieldName, int value, int lowerBound, int upperBound)
value
- the value to checklowerBound
- the lower bound allowed for valueupperBound
- the upper bound allowed for value
IllegalFieldValueException
- if value is not in the specified boundspublic static int getWrappedValue(int currentValue, int wrapValue, int minValue, int maxValue)
currentValue
- the current value of the data, which may lie outside
the wrapped value rangewrapValue
- the value to add to current value before
wrapping. This may be negative.minValue
- the wrap range minimum value.maxValue
- the wrap range maximum value. This must be
greater than minValue (checked by the method).
IllegalArgumentException
- if minValue is greater
than or equal to maxValuepublic static int getWrappedValue(int value, int minValue, int maxValue)
value
- the value to fit into the wrapped value rangeminValue
- the wrap range minimum value.maxValue
- the wrap range maximum value. This must be
greater than minValue (checked by the method).
IllegalArgumentException
- if minValue is greater
than or equal to maxValuepublic static boolean equals(Object object1, Object object2)
object1
- the first objectobject2
- the second object
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |