com.objsys.xbinder.runtime

Class XBSimpleType

java.lang.Object

com.objsys.xbinder.runtime.XBSimpleType

public class XBSimpleType
extends java.lang.Object

Helper class for dealing with XML simple types.

Constructor Summary

Constructors

Constructor and Description
XBSimpleType()

Method Summary

Modifier and Type	Method and Description
static void	formatBase64BinaryToStream(XBByteArray bytes, java.io.Writer stream)
static java.lang.String	formatBase64BinaryToString(XBByteArray bytes)
static java.lang.String	formatDecimal(java.math.BigDecimal value) Format the BigDecimal into a string without leading or trailing zeros.
static java.lang.String	formatDecimal(java.math.BigDecimal value, int totalDigits, int fractionDigits, int fractionMinDigits, int integerMinDigits, boolean signPresent, boolean pointPresent, boolean validate)
static XBByteArray	parseBase64Binary(java.lang.String text) Decode given base64Binary XML text into new XBByteArray.
static XBByteArray	parseBase64Binary(java.lang.String text, XBByteArray bytes) Decode given base64Binary XML text into given bytes object.
static boolean	parseBoolean(java.lang.String text) Convert text to a boolean value.
static byte	parseByte(java.lang.String value) Parses a String into a byte.
static java.math.BigDecimal	parseDecimal(java.lang.String text) Convert XML text to a decimal value.
static java.math.BigDecimal	parseDecimalAndValidate(java.lang.String text, int totalDigits, int fractionDigits) Parses an xsd:decimal value and validates the given facets.
static double	parseDouble(java.lang.String text) Convert XML text to a double value.
static float	parseFloat(java.lang.String text) Convert XML text to a float value.
static int	parseInteger(java.lang.String value) Parses a String into an int The string may have a leading +/-, otherwise all characters must be '0' - '9'.
static long	parseLong(java.lang.String value) Parses a String into a long The string may have a leading +/-, otherwise all characters must be '0' - '9'.
static short	parseShort(java.lang.String value) Parses a String into a short.
static java.lang.String[]	splitList(java.lang.String value) Return the items from an XSD list type in an array.
static java.lang.String	whitespaceCollapse(java.lang.String value) Apply the whitespace="collapse" facet.
static java.lang.String	whitespaceReplace(java.lang.String value) Apply the whitespace="replace" facet.

Methods inherited from class java.lang.Object

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

Constructor Detail

XBSimpleType

public XBSimpleType()

Method Detail

formatBase64BinaryToString

public static java.lang.String formatBase64BinaryToString(XBByteArray bytes)

formatBase64BinaryToStream

public static void formatBase64BinaryToStream(XBByteArray bytes,
                                              java.io.Writer stream)

formatDecimal

public static java.lang.String formatDecimal(java.math.BigDecimal value)

Format the BigDecimal into a string without leading or trailing zeros.

Parameters:

value -

formatDecimal

public static java.lang.String formatDecimal(java.math.BigDecimal value,
                                             int totalDigits,
                                             int fractionDigits,
                                             int fractionMinDigits,
                                             int integerMinDigits,
                                             boolean signPresent,
                                             boolean pointPresent,
                                             boolean validate)
                                      throws XBTotalDigitsVioException

Parameters:

totalDigits - The maximum totalDigits. Values < 1 are ignored. If validate is false, totalDigits may be exceeded, but if so, no fraction part will show. If validate is true, and the given number of totalDigits is exceeded, an exception will be thrown. Leading zeros in the integer part are not counted. Trailing zeros in the fraction part are not counted.

fractionDigits - The maximum number of fraction digits. Values < 0 are ignored. Extra fraction digits are rounded off. Trailing zeros are not counted.

fractionMinDigits - Minimum digits in fraction. Trailing zeros will be added if needed.

integerMinDigits - Minimum digits in integer part. Leading zeros will be added if needed.

signPresent - If true, a positive sign is shown.

pointPresent - If true, the decimal point will be shown.

validate - If true, an exception occurs if totalDigits is violated.

value -

Throws:

XBTotalDigitsVioException

parseBase64Binary

public static XBByteArray parseBase64Binary(java.lang.String text)

Decode given base64Binary XML text into new XBByteArray.

Parameters:

text -

Returns:

bytes

parseBase64Binary

public static XBByteArray parseBase64Binary(java.lang.String text,
                                            XBByteArray bytes)

Decode given base64Binary XML text into given bytes object.

Parameters:

text -

bytes - XBByteArray to decode into, starting at 0 offset. If null, a new object will be created to decode into.

Returns:

bytes

parseBoolean

public static boolean parseBoolean(java.lang.String text)

Convert text to a boolean value. Whitespace processing should have already been applied.

Parameters:

text - A valid XML Schema lexical representation of a boolean.

Returns:

parseDecimal

public static java.math.BigDecimal parseDecimal(java.lang.String text)

Convert XML text to a decimal value. Whitespace processing should have already been applied. This method differs from the BigDecimal constructor in that it does not allow exponents.

parseDecimalAndValidate

public static java.math.BigDecimal parseDecimalAndValidate(java.lang.String text,
                                                           int totalDigits,
                                                           int fractionDigits)

Parses an xsd:decimal value and validates the given facets. This behaves the same as parseDecimal(text), except for the additional validation of the facets.

Parameters:

totalDigits - Values < 1 are ignored

fractionDigits - Values < 0 are ignored

parseDouble

public static double parseDouble(java.lang.String text)

Convert XML text to a double value. Whitespace processing should have already been applied. This method accepts strings that are legal lexical representations of the XML Schema double data type. Some differences from the standard Java Double.valueOf are: - hex representation is not allowed - leading/trailing whitespace (incl. ASCII control chars) not allowed - a float type suffix is not allowed - "INF" or "-INF" is allowed, not "+Infinity", "-Infinity", "Infinity" - "NaN" is allowed, but not with any sign.

Throws:

XBNumberFormatException - if the text is not a valid xsd:double

parseFloat

public static float parseFloat(java.lang.String text)

Convert XML text to a float value. Whitespace processing should have already been applied. This method accepts strings that are legal lexical representations of the XML Schema float data type. Some differences from the standard Java Float.valueOf are: - hex representation is not allowed - leading/trailing whitespace (incl. ASCII control chars) not allowed - a float type suffix is not allowed - "INF" or "-INF" is allowed, not "+Infinity", "-Infinity", "Infinity" - "NaN" is allowed, but not with any sign.

Throws:

XBNumberFormatException - if the text is not a valid xsd:double *

parseByte

public static byte parseByte(java.lang.String value)

Parses a String into a byte. The string may have a leading +/-, otherwise all characters must be '0' - '9'. Leading zeros are acceptable. Whitespace is not allowed.

Parameters:

value -

Returns:

Throws:

XBNumberFormatException - if any of the following: The string represents an integer out of range of a byte. The string is otherwise not valid, as described above.

parseInteger

public static int parseInteger(java.lang.String value)

Parses a String into an int The string may have a leading +/-, otherwise all characters must be '0' - '9'. Leading zeros are acceptable. Whitespace is not allowed.

Parameters:

value -

Returns:

Throws:

XBNumberFormatException - if any of the following: The string represents an integer out of range of a byte. The string is otherwise not valid, as described above.

parseLong

public static long parseLong(java.lang.String value)

Parses a String into a long The string may have a leading +/-, otherwise all characters must be '0' - '9'. Leading zeros are acceptable. Whitespace is not allowed.

Parameters:

value -

Returns:

Throws:

XBNumberFormatException - if any of the following: The string represents an integer out of range of a byte. The string is otherwise not valid, as described above.

parseShort

public static short parseShort(java.lang.String value)

Parses a String into a short. The string may have a leading +/-, otherwise all characters must be '0' - '9'. Leading zeros are acceptable. Whitespace is not allowed.

Parameters:

value -

Returns:

Throws:

XBNumberFormatException - if any of the following: The string represents an integer out of range of a byte. The string is otherwise not valid, as described above.

splitList

public static java.lang.String[] splitList(java.lang.String value)

Return the items from an XSD list type in an array. This assumes that the whitespace facet of "collapse" has already been applied to the input value. Note: java.util.StringTokenizer and String.split are not supported in Java ME CLDC 1.1.

Parameters:

value -

Returns:

whitespaceReplace

public static java.lang.String whitespaceReplace(java.lang.String value)

Apply the whitespace="replace" facet. This rule replaces any \t \r \n with a space.

whitespaceCollapse

public static java.lang.String whitespaceCollapse(java.lang.String value)

Apply the whitespace="collapse" facet. This rule replaces \t \n \r with space. It then replaces multiple spaces with a single space, and removes leading and trailing spaces.

Parameters:

value -

Returns: