|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.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 scalar)
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_VALUE
public static int safeAdd(int val1,
int val2)
val1 - the first valueval2 - the second value
ArithmeticException - if the value is too big or too small
public static long safeAdd(long val1,
long val2)
val1 - the first valueval2 - the second value
ArithmeticException - if the value is too big or too small
public 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 small
public static int safeMultiply(int val1,
int val2)
val1 - the first valueval2 - the second value
ArithmeticException - if the value is too big or too small
public static long safeMultiply(long val1,
int scalar)
val1 - the first valuescalar - the second value
ArithmeticException - if the value is too big or too small
public 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 small
public static int safeMultiplyToInt(long val1,
long val2)
val1 - the first valueval2 - the second value
ArithmeticException - if the value is too big or too small
public 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 bounds
public 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 bounds
public 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 bounds
public 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 maxValue
public 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 maxValue
public 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 | |||||||||