org.dellroad.jibxbindings

Class ParseUtil

java.lang.Object

org.dellroad.jibxbindings.ParseUtil

public final class ParseUtil
extends java.lang.Object

JiBX parsing utility methods.

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	deserializeBoolean(java.lang.String string) Boolean parser that allows "yes" and "no" as well as the usual "true", "false", "0", "1".
static double	deserializeDouble(java.lang.String string) Deserialize a double, but treat empty string as NaN.
static double[]	deserializeDoubleArray(java.lang.String string) Deserialize an array of double values.
static double	deserializeDoubleOrNaN(java.lang.String string) Deserialize a double, but treat empty string as NaN.
static <T extends java.lang.Enum<T>> T	deserializeEnum(java.lang.String string, T[] values) Deserialize a Enum using the enum name, but treat empty string as null.
static <T extends java.lang.Enum<T>> T	deserializeEnumOrNull(java.lang.String string, java.lang.Class<T> type) Deserialize an Enum.
static int	deserializeInt(java.lang.String string) Deserialize an integer, but treat empty string as zero.
static int	deserializeIntOrZero(java.lang.String string) Deserialize an integer, but treat empty string as zero.
static java.lang.String	deserializeMatching(java.lang.String regex, java.lang.String string) JiBX String deserializer support method that verifies that the input string matches the given regular expression.
static java.util.Date	deserializeRFC3339Timestamp(java.lang.String string) Deserialize a timestamp in RFC 3339 format.
static java.util.Date	deserializeRFC5322Timestamp(java.lang.String string) Deserialize a timestamp in RFC 5322 format.
static java.util.List<java.lang.String>	deserializeStringList(java.lang.String string) Deserialize a list of strings.
static java.net.URI	deserializeURI(java.lang.String string) Deserialize an URI.
static java.util.Date	deserializeXSDDateTime(java.lang.String date) Deserialize a Date in XSD dateTime format.
static <T extends java.lang.Enum<T>> java.util.List<T>	getValues(java.lang.Class<T> enumClass) Get all instances of the given Enum class in a list in their natural ordering.
static java.lang.String	normalize(java.lang.String string) JiBX String deserializer that normalizes a string as is required by the xsd:token XSD type.
static java.lang.String	serializeDoubleArray(double[] values) Serialize an array of double values.
static <T extends java.lang.Enum<T>> java.lang.String	serializeEnumToString(T value) Serialize an Enum using Enum.toString().
static java.lang.String	serializeRFC3339Timestamp(java.util.Date timestamp) Serialize a timestamp in RFC 3339 format.
static java.lang.String	serializeRFC5322Timestamp(java.util.Date date) Serialize a timestamp in RFC 5322 format.
static java.lang.String	serializeStringList(java.util.List<java.lang.String> list) Serialize a list of strings.
static java.lang.String	serializeURI(java.net.URI uri) Serialize an URI.
static java.lang.String	serializeXSDDateTime(java.util.Date date) Serialize a Date to XSD dateTime format.

Methods inherited from class java.lang.Object

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

Method Detail

deserializeURI

public static java.net.URI deserializeURI(java.lang.String string)
                                   throws JiBXParseException

Deserialize an URI.

Throws:

JiBXParseException

See Also:

serializeURI(java.net.URI)

serializeURI

public static java.lang.String serializeURI(java.net.URI uri)

Serialize an URI.

See Also:

deserializeURI(java.lang.String)

normalize

public static java.lang.String normalize(java.lang.String string)

JiBX String deserializer that normalizes a string as is required by the xsd:token XSD type. This removes leading and trailing whitespace, and collapses all interior whitespace down to a single space character.

Throws:

java.lang.NullPointerException - if string is null

deserializeMatching

public static java.lang.String deserializeMatching(java.lang.String regex,
                                   java.lang.String string)
                                            throws JiBXParseException

JiBX String deserializer support method that verifies that the input string matches the given regular expression. This method can be invoked by custom deserializers that supply the regular expression to it.

Throws:

java.lang.NullPointerException - if string of regex is null

JiBXParseException - if string does not match regex

java.util.regex.PatternSyntaxException - if regex is not a valid regular expression

deserializeBoolean

public static boolean deserializeBoolean(java.lang.String string)
                                  throws JiBXParseException

Boolean parser that allows "yes" and "no" as well as the usual "true", "false", "0", "1".

Throws:

JiBXParseException - if the value is not recognizable as a boolean

deserializeRFC3339Timestamp

public static java.util.Date deserializeRFC3339Timestamp(java.lang.String string)
                                                  throws JiBXParseException

Deserialize a timestamp in RFC 3339 format.

Throws:

JiBXParseException

See Also:

serializeRFC3339Timestamp(java.util.Date), RFC 3339

serializeRFC3339Timestamp

public static java.lang.String serializeRFC3339Timestamp(java.util.Date timestamp)

Serialize a timestamp in RFC 3339 format.

See Also:

deserializeRFC3339Timestamp(java.lang.String), RFC 3339

deserializeRFC5322Timestamp

public static java.util.Date deserializeRFC5322Timestamp(java.lang.String string)
                                                  throws JiBXParseException

Deserialize a timestamp in RFC 5322 format. Treat an empty string as null.

Throws:

JiBXParseException

See Also:

serializeRFC5322Timestamp(java.util.Date), RFC 5322

serializeRFC5322Timestamp

public static java.lang.String serializeRFC5322Timestamp(java.util.Date date)

Serialize a timestamp in RFC 5322 format.

See Also:

deserializeRFC5322Timestamp(java.lang.String), RFC 5322

deserializeXSDDateTime

public static java.util.Date deserializeXSDDateTime(java.lang.String date)
                                             throws JiBXParseException

Deserialize a Date in XSD dateTime format.

Throws:

JiBXParseException

See Also:

serializeXSDDateTime(java.util.Date), XSD dateTime datatype

serializeXSDDateTime

public static java.lang.String serializeXSDDateTime(java.util.Date date)
                                             throws JiBXParseException

Serialize a Date to XSD dateTime format.

Throws:

JiBXParseException

See Also:

deserializeXSDDateTime(java.lang.String), XSD dateTime datatype

deserializeInt

public static int deserializeInt(java.lang.String string)
                          throws JiBXParseException

Deserialize an integer, but treat empty string as zero.

Throws:

JiBXParseException

deserializeDouble

public static double deserializeDouble(java.lang.String string)
                                throws JiBXParseException

Deserialize a double, but treat empty string as NaN.

Throws:

JiBXParseException

deserializeEnum

public static <T extends java.lang.Enum<T>> T deserializeEnum(java.lang.String string,
                                              T[] values)
                                                throws JiBXParseException

Deserialize a Enum using the enum name, but treat empty string as null.

Throws:

JiBXParseException

deserializeEnumOrNull

public static <T extends java.lang.Enum<T>> T deserializeEnumOrNull(java.lang.String string,
                                                    java.lang.Class<T> type)
                                                      throws JiBXParseException

Deserialize an Enum. Either the name() or string value may match, and treat an empty string like null.

Throws:

JiBXParseException

serializeEnumToString

public static <T extends java.lang.Enum<T>> java.lang.String serializeEnumToString(T value)
                                              throws JiBXParseException

Serialize an Enum using Enum.toString().

Throws:

JiBXParseException

getValues

public static <T extends java.lang.Enum<T>> java.util.List<T> getValues(java.lang.Class<T> enumClass)

Get all instances of the given Enum class in a list in their natural ordering.

Returns:

unmodifiable list of enum values

deserializeIntOrZero

public static int deserializeIntOrZero(java.lang.String string)
                                throws JiBXParseException

Deserialize an integer, but treat empty string as zero.

Throws:

JiBXParseException

deserializeDoubleOrNaN

public static double deserializeDoubleOrNaN(java.lang.String string)
                                     throws JiBXParseException

Deserialize a double, but treat empty string as NaN.

Throws:

JiBXParseException

deserializeStringList

public static java.util.List<java.lang.String> deserializeStringList(java.lang.String string)
                                                              throws JiBXParseException

Deserialize a list of strings. The strings are separated by whitespace.

Throws:

JiBXParseException

See Also:

serializeStringList(java.util.List<java.lang.String>)

serializeStringList

public static java.lang.String serializeStringList(java.util.List<java.lang.String> list)

Serialize a list of strings. The strings are separated by space characters.

See Also:

deserializeStringList(java.lang.String)

deserializeDoubleArray

public static double[] deserializeDoubleArray(java.lang.String string)
                                       throws JiBXParseException

Deserialize an array of double values.

Throws:

JiBXParseException

See Also:

serializeDoubleArray(double[])

serializeDoubleArray

public static java.lang.String serializeDoubleArray(double[] values)

Serialize an array of double values.

See Also:

deserializeDoubleArray(java.lang.String)