com.jayway.jsonpath.internal

Class Utils

java.lang.Object

com.jayway.jsonpath.internal.Utils

public final class Utils
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CR

Method Summary

Modifier and Type	Method and Description
static void	closeQuietly(java.io.Closeable closeable)
static int	countMatches(java.lang.CharSequence str, java.lang.CharSequence sub) Counts how many times the substring appears in the larger string.
static java.util.List<java.lang.Integer>	createRange(int start, int end) Creates a range of integers from start (inclusive) to end (exclusive)
static java.lang.Object	deserialize(byte[] objectData) Deserializes a single Object from an array of bytes.
static java.lang.Object	deserialize(java.io.InputStream inputStream) Deserializes an Object from the specified stream.
static boolean	isEmpty(java.lang.CharSequence cs) Checks if a CharSequence is empty ("") or null.
static boolean	isInt(java.lang.String str)
static boolean	isNumeric(java.lang.String str)
static void	isTrue(boolean expression, java.lang.String message) Validate that the argument condition is true; otherwise throwing an exception with the specified message.
static java.lang.String	join(java.lang.String delimiter, java.lang.Iterable<? extends java.lang.Object> objs)
static java.lang.String	join(java.lang.String delimiter, java.lang.String wrap, java.lang.Iterable<? extends java.lang.Object> objs)
static <T extends java.lang.CharSequence> T	notEmpty(T chars, java.lang.String message, java.lang.Object... values) Validate that the specified argument character sequence is neither null nor a length of zero (no characters); otherwise throwing an exception with the specified message.
static <T> T	notNull(T object, java.lang.String message, java.lang.Object... values) Validate that the specified argument is not null; otherwise throwing an exception with the specified message.
static byte[]	serialize(java.io.Serializable obj) Serializes an Object to a byte array for storage/serialization.
static void	serialize(java.io.Serializable obj, java.io.OutputStream outputStream) Serializes an Object to the specified stream.
static java.lang.String	toString(java.lang.Object o)

Methods inherited from class java.lang.Object

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

Field Detail

CR

public static final java.lang.String CR

Method Detail

createRange

public static java.util.List<java.lang.Integer> createRange(int start,
                                                            int end)

Creates a range of integers from start (inclusive) to end (exclusive)

Parameters:

start -

end -

Returns:

join

public static java.lang.String join(java.lang.String delimiter,
                                    java.lang.String wrap,
                                    java.lang.Iterable<? extends java.lang.Object> objs)

join

public static java.lang.String join(java.lang.String delimiter,
                                    java.lang.Iterable<? extends java.lang.Object> objs)

closeQuietly

public static void closeQuietly(java.io.Closeable closeable)

isInt

public static boolean isInt(java.lang.String str)

isNumeric

public static boolean isNumeric(java.lang.String str)

isEmpty

public static boolean isEmpty(java.lang.CharSequence cs)

Checks if a CharSequence is empty ("") or null.

 StringUtils.isEmpty(null)      = true
 StringUtils.isEmpty("")        = true
 StringUtils.isEmpty(" ")       = false
 StringUtils.isEmpty("bob")     = false
 StringUtils.isEmpty("  bob  ") = false
 

NOTE: This method changed in Lang version 2.0. It no longer trims the CharSequence. That functionality is available in isBlank().

Parameters:

cs - the CharSequence to check, may be null

Returns:

true if the CharSequence is empty or null

Since:

3.0 Changed signature from isEmpty(String) to isEmpty(CharSequence)

countMatches

public static int countMatches(java.lang.CharSequence str,
                               java.lang.CharSequence sub)

Counts how many times the substring appears in the larger string.

A null or empty ("") String input returns 0.

 StringUtils.countMatches(null, *)       = 0
 StringUtils.countMatches("", *)         = 0
 StringUtils.countMatches("abba", null)  = 0
 StringUtils.countMatches("abba", "")    = 0
 StringUtils.countMatches("abba", "a")   = 2
 StringUtils.countMatches("abba", "ab")  = 1
 StringUtils.countMatches("abba", "xxx") = 0
 

Parameters:

str - the CharSequence to check, may be null

sub - the substring to count, may be null

Returns:

the number of occurrences, 0 if either CharSequence is null

Since:

3.0 Changed signature from countMatches(String, String) to countMatches(CharSequence, CharSequence)

notNull

public static <T> T notNull(T object,
                            java.lang.String message,
                            java.lang.Object... values)

Validate that the specified argument is not null; otherwise throwing an exception with the specified message.

Validate.notNull(myObject, "The object must not be null");

Type Parameters:

T - the object type

Parameters:

object - the object to check

message - the String.format(String, Object...) exception message if invalid, not null

values - the optional values for the formatted exception message

Returns:

the validated object (never null for method chaining)

Throws:

java.lang.NullPointerException - if the object is null

isTrue

public static void isTrue(boolean expression,
                          java.lang.String message)

Validate that the argument condition is true; otherwise throwing an exception with the specified message. This method is useful when validating according to an arbitrary boolean expression, such as validating a primitive number or using your own custom validation expression.

Validate.isTrue(i > 0.0, "The value must be greater than zero: %d", i);

For performance reasons, the long value is passed as a separate parameter and appended to the exception message only in the case of an error.

Parameters:

expression - the boolean expression to check

message -

Throws:

java.lang.IllegalArgumentException - if expression is false

notEmpty

public static <T extends java.lang.CharSequence> T notEmpty(T chars,
                                                            java.lang.String message,
                                                            java.lang.Object... values)

Validate that the specified argument character sequence is neither null nor a length of zero (no characters); otherwise throwing an exception with the specified message.

Validate.notEmpty(myString, "The string must not be empty");

Type Parameters:

T - the character sequence type

Parameters:

chars - the character sequence to check, validated not null by this method

message - the String.format(String, Object...) exception message if invalid, not null

values - the optional values for the formatted exception message, null array not recommended

Returns:

the validated character sequence (never null method for chaining)

Throws:

java.lang.NullPointerException - if the character sequence is null

java.lang.IllegalArgumentException - if the character sequence is empty

toString

public static java.lang.String toString(java.lang.Object o)

serialize

public static void serialize(java.io.Serializable obj,
                             java.io.OutputStream outputStream)

Serializes an Object to the specified stream.

The stream will be closed once the object is written. This avoids the need for a finally clause, and maybe also exception handling, in the application code.

The stream passed in is not buffered internally within this method. This is the responsibility of your application if desired.

Parameters:

obj - the object to serialize to bytes, may be null

outputStream - the stream to write to, must not be null

Throws:

java.lang.IllegalArgumentException - if outputStream is null

java.lang.RuntimeException - (runtime) if the serialization fails

serialize

public static byte[] serialize(java.io.Serializable obj)

Serializes an Object to a byte array for storage/serialization.

Parameters:

obj - the object to serialize to bytes

Returns:

a byte[] with the converted Serializable

Throws:

java.lang.RuntimeException - (runtime) if the serialization fails

deserialize

public static java.lang.Object deserialize(java.io.InputStream inputStream)

Deserializes an Object from the specified stream.

The stream will be closed once the object is written. This avoids the need for a finally clause, and maybe also exception handling, in the application code.

The stream passed in is not buffered internally within this method. This is the responsibility of your application if desired.

Parameters:

inputStream - the serialized object input stream, must not be null

Returns:

the deserialized object

Throws:

java.lang.IllegalArgumentException - if inputStream is null

java.lang.RuntimeException - (runtime) if the serialization fails

deserialize

public static java.lang.Object deserialize(byte[] objectData)

Deserializes a single Object from an array of bytes.

Parameters:

objectData - the serialized object, must not be null

Returns:

the deserialized object

Throws:

java.lang.IllegalArgumentException - if objectData is null

java.lang.RuntimeException - (runtime) if the serialization fails