com.ionic.sdk.core.value.Value Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of ionic-sdk Show documentation
Show all versions of ionic-sdk Show documentation
The Ionic Java SDK provides an easy-to-use interface to the Ionic Platform.
package com.ionic.sdk.core.value;
import java.text.NumberFormat;
import java.text.ParseException;
import java.util.Collection;
/**
* Utilities for working with generic values.
*/
public final class Value {
/**
* Constructor.
* http://checkstyle.sourceforge.net/config_design.html#FinalClass
*/
private Value() {
}
/**
* Check input object for data.
*
* @param value input to be checked
* @return true iff [value is null, or value is empty (zero length)]
*/
public static boolean isEmpty(final byte[] value) {
return ((value == null) || (value.length == 0));
}
/**
* Check input objects for any occurrence of a null value.
*
* @param objects objects to check for null values
* @return true if any null is found in the input data
*/
public static boolean hasNull(final Object... objects) {
boolean hasNull = false;
for (final Object object : objects) {
hasNull |= (object == null);
}
return hasNull;
}
/**
* Check input object for data.
*
* @param value input to be checked
* @return true iff [value is null, or value is empty (zero length)]
*/
public static boolean isEmpty(final String value) {
return ((value == null) || (value.length() == 0));
}
/**
* Allow specification of a default value, if no data found in original input.
*
* @param value input to be checked
* @param defaultValue value to substitute iff no data found in original input
* @return value, iff it contains data, otherwise defaultValue
*/
public static String defaultOnEmpty(final String value, final String defaultValue) {
return (((value == null) || (value.length() == 0)) ? defaultValue : value);
}
/**
* Check input objects for equality.
*
* @param left input object
* @param right input object
* @return true iff the two objects are either (1) both null, or (2) both strings, and equal to each other
*/
public static boolean isEqual(final String left, final String right) {
return (left == null) ? (right == null) : left.equals(right);
}
/**
* Check input objects for equality.
*
* @param left input object
* @param right input object
* @return true iff the two objects are either (1) both null, or (2) both strings, and equal to each other
*/
public static boolean isEqualIgnoreCase(final String left, final String right) {
return (left == null) ? (right == null) : left.equalsIgnoreCase(right);
}
/**
* Assemble input atoms into a string, with a defined separator between each.
*
* @param connector the token which should delimit each input atom
* @param value the first object to render
* @param values the objects to render
* @return the string assembled from the input atoms
*/
public static String join(final String connector, final Object value, final Object... values) {
final StringBuilder buffer = new StringBuilder();
buffer.append(value);
for (final Object valueIt : values) {
if (valueIt != null) {
buffer.append(connector); //buffer.append((buffer.length() == 0) ? "" : connector);
buffer.append(valueIt);
}
}
return buffer.toString();
}
/**
* Assemble input atoms into a string, with a defined separator between each.
*
* @param connector the token which should delimit each input atom
* @param values the objects to render
* @return the string assembled from the input atoms
*/
public static String joinArray(final String connector, final Object[] values) {
final StringBuilder buffer = new StringBuilder();
for (final Object valueIt : values) {
append(connector, buffer, valueIt);
}
return buffer.toString();
}
/**
* Assemble input atoms into a string, with a defined separator between each.
*
* @param connector the token which should delimit each input atom
* @param values the objects to render
* @return the string assembled from the input atoms
*/
public static String joinCollection(final String connector, final Collection values) {
final StringBuilder buffer = new StringBuilder();
for (final Object valueIt : values) {
append(connector, buffer, valueIt);
}
return buffer.toString();
}
/**
* Helper function to assemble a conglomerate string from a set of inputs.
*
* @param connector the token which should delimit each input atom
* @param buffer the buffer into which the output should be written
* @param valueIt the object to render
*/
private static void append(final String connector, final StringBuilder buffer, final Object valueIt) {
if (valueIt != null) {
buffer.append((buffer.length() == 0) ? "" : connector);
buffer.append(valueIt);
}
}
/**
* Convert input string into integral representation.
*
* @param value the string which should be converted
* @param valueDefault the default value, on non-parsable input
* @return the integral representation of the input value, if it can be parsed
*/
public static int toInt(final String value, final int valueDefault) {
Number number;
try {
number = ((value == null) ? valueDefault : NumberFormat.getInstance().parse(value));
} catch (ParseException e) {
number = valueDefault;
}
return number.intValue();
}
/**
* Generate a string consisting of count occurrences of value.
*
* @param value the base string to use
* @param count the number of repeated occurrences in the resulting string
* @return a string containing repeated occurrences of value
*/
public static String generate(final String value, final int count) {
final StringBuilder buffer = new StringBuilder();
for (int i = 0; (i < count); ++i) {
buffer.append(value);
}
return buffer.toString();
}
/**
* Delimiter that can be used when joining strings together.
*/
public static final String DELIMITER_SLASH = "/";
/**
* Delimiter that can be used when joining filename tokens together.
*/
public static final String DOT = ".";
}