org.openrdf.model.util

Class Literals

java.lang.Object

org.openrdf.model.util.Literals

Direct Known Subclasses:

LiteralUtil

public class Literals
extends Object

Various utility methods related to Literal.

Author:

Arjohn Kampman, Peter Ansell

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Literals()

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	canCreateLiteral(Object object) Helper method for determining whether a literal could be created from an object using a ValueFactory.
static Literal	createLiteral(ValueFactory valueFactory, Object object) Creates a typed Literal out of the supplied object, mapping the runtime type of the object to the appropriate XML Schema type.
static Literal	createLiteralOrFail(ValueFactory valueFactory, Object object) Creates a typed Literal out of the supplied object, mapping the runtime type of the object to the appropriate XML Schema type.
static boolean	getBooleanValue(Literal l, boolean fallback) Gets the boolean value of the supplied literal.
static boolean	getBooleanValue(Value v, boolean fallback) Returns the result of getBooleanValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.
static byte	getByteValue(Literal l, byte fallback) Gets the byte value of the supplied literal.
static byte	getByteValue(Value v, byte fallback) Returns the result of getByteValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.
static XMLGregorianCalendar	getCalendarValue(Literal l, XMLGregorianCalendar fallback) Gets the calendar value of the supplied literal.
static XMLGregorianCalendar	getCalendarValue(Value v, XMLGregorianCalendar fallback) Returns the result of getCalendarValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.
static BigDecimal	getDecimalValue(Literal l, BigDecimal fallback) Gets the decimal value of the supplied literal.
static BigDecimal	getDecimalValue(Value v, BigDecimal fallback) Returns the result of getDecimalValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.
static double	getDoubleValue(Literal l, double fallback) Gets the double value of the supplied literal.
static double	getDoubleValue(Value v, double fallback) Returns the result of getDoubleValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.
static float	getFloatValue(Literal l, float fallback) Gets the float value of the supplied literal.
static float	getFloatValue(Value v, float fallback) Returns the result of getFloatValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.
static BigInteger	getIntegerValue(Literal l, BigInteger fallback) Gets the integer value of the supplied literal.
static BigInteger	getIntegerValue(Value v, BigInteger fallback) Returns the result of getIntegerValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.
static int	getIntValue(Literal l, int fallback) Gets the int value of the supplied literal.
static int	getIntValue(Value v, int fallback) Returns the result of getIntValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.
static String	getLabel(Literal l, String fallback) Gets the label of the supplied literal.
static String	getLabel(Value v, String fallback) Returns the result of getLabel((Literal)v, fallback in case the supplied value is a literal, returns the fallback value otherwise.
static Locale	getLocale(Literal l, Locale fallback) Determine the Locale from a literal's language tag, as specified by RFC 3166.
static long	getLongValue(Literal l, long fallback) Gets the long value of the supplied literal.
static long	getLongValue(Value v, long fallback) Returns the result of getLongValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.
static short	getShortValue(Literal l, short fallback) Gets the short value of the supplied literal.
static short	getShortValue(Value v, short fallback) Returns the result of getShortValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.

Methods inherited from class java.lang.Object

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

Constructor Detail

Literals

protected Literals()

Method Detail

getLabel

public static String getLabel(Literal l,
              String fallback)

Gets the label of the supplied literal. The fallback value is returned in case the supplied literal is null.

Parameters:

l - The literal to get the label for.

fallback - The value to fall back to in case the supplied literal is null.

Returns:

Either the literal's label, or the fallback value.

getLabel

public static String getLabel(Value v,
              String fallback)

Returns the result of getLabel((Literal)v, fallback in case the supplied value is a literal, returns the fallback value otherwise.

getByteValue

public static byte getByteValue(Literal l,
                byte fallback)

Gets the byte value of the supplied literal. The fallback value is returned in case Literal.byteValue() throws a NumberFormatException.

Parameters:

l - The literal to get the byte value for.

fallback - The value to fall back to in case no byte value could gotten from the literal.

Returns:

Either the literal's byte value, or the fallback value.

getByteValue

public static byte getByteValue(Value v,
                byte fallback)

Returns the result of getByteValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.

getShortValue

public static short getShortValue(Literal l,
                  short fallback)

Gets the short value of the supplied literal. The fallback value is returned in case Literal.shortValue() throws a NumberFormatException.

Parameters:

l - The literal to get the short value for.

fallback - The value to fall back to in case no short value could gotten from the literal.

Returns:

Either the literal's short value, or the fallback value.

getShortValue

public static short getShortValue(Value v,
                  short fallback)

Returns the result of getShortValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.

getIntValue

public static int getIntValue(Literal l,
              int fallback)

Gets the int value of the supplied literal. The fallback value is returned in case Literal.intValue() throws a NumberFormatException.

Parameters:

l - The literal to get the int value for.

fallback - The value to fall back to in case no int value could gotten from the literal.

Returns:

Either the literal's int value, or the fallback value.

getIntValue

public static int getIntValue(Value v,
              int fallback)

Returns the result of getIntValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.

getLongValue

public static long getLongValue(Literal l,
                long fallback)

Gets the long value of the supplied literal. The fallback value is returned in case Literal.longValue() throws a NumberFormatException.

Parameters:

l - The literal to get the long value for.

fallback - The value to fall back to in case no long value could gotten from the literal.

Returns:

Either the literal's long value, or the fallback value.

getLongValue

public static long getLongValue(Value v,
                long fallback)

Returns the result of getLongValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.

getIntegerValue

public static BigInteger getIntegerValue(Literal l,
                         BigInteger fallback)

Gets the integer value of the supplied literal. The fallback value is returned in case Literal.integerValue() throws a NumberFormatException.

Parameters:

l - The literal to get the integer value for.

fallback - The value to fall back to in case no integer value could gotten from the literal.

Returns:

Either the literal's integer value, or the fallback value.

getIntegerValue

public static BigInteger getIntegerValue(Value v,
                         BigInteger fallback)

Returns the result of getIntegerValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.

getDecimalValue

public static BigDecimal getDecimalValue(Literal l,
                         BigDecimal fallback)

Gets the decimal value of the supplied literal. The fallback value is returned in case Literal.decimalValue() throws a NumberFormatException.

Parameters:

l - The literal to get the decimal value for.

fallback - The value to fall back to in case no decimal value could gotten from the literal.

Returns:

Either the literal's decimal value, or the fallback value.

getDecimalValue

public static BigDecimal getDecimalValue(Value v,
                         BigDecimal fallback)

Returns the result of getDecimalValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.

getFloatValue

public static float getFloatValue(Literal l,
                  float fallback)

Gets the float value of the supplied literal. The fallback value is returned in case Literal.floatValue() throws a NumberFormatException.

Parameters:

l - The literal to get the float value for.

fallback - The value to fall back to in case no float value could gotten from the literal.

Returns:

Either the literal's float value, or the fallback value.

getFloatValue

public static float getFloatValue(Value v,
                  float fallback)

Returns the result of getFloatValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.

getDoubleValue

public static double getDoubleValue(Literal l,
                    double fallback)

Gets the double value of the supplied literal. The fallback value is returned in case Literal.doubleValue() throws a NumberFormatException.

Parameters:

l - The literal to get the double value for.

fallback - The value to fall back to in case no double value could gotten from the literal.

Returns:

Either the literal's double value, or the fallback value.

getDoubleValue

public static double getDoubleValue(Value v,
                    double fallback)

Returns the result of getDoubleValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.

getBooleanValue

public static boolean getBooleanValue(Literal l,
                      boolean fallback)

Gets the boolean value of the supplied literal. The fallback value is returned in case Literal.booleanValue() throws a NumberFormatException.

Parameters:

l - The literal to get the boolean value for.

fallback - The value to fall back to in case no boolean value could gotten from the literal.

Returns:

Either the literal's boolean value, or the fallback value.

getBooleanValue

public static boolean getBooleanValue(Value v,
                      boolean fallback)

Returns the result of getBooleanValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.

getCalendarValue

public static XMLGregorianCalendar getCalendarValue(Literal l,
                                    XMLGregorianCalendar fallback)

Gets the calendar value of the supplied literal. The fallback value is returned in case Literal.calendarValue() throws a NumberFormatException.

Parameters:

l - The literal to get the calendar value for.

fallback - The value to fall back to in case no calendar value could gotten from the literal.

Returns:

Either the literal's calendar value, or the fallback value.

getCalendarValue

public static XMLGregorianCalendar getCalendarValue(Value v,
                                    XMLGregorianCalendar fallback)

Returns the result of getCalendarValue((Literal)value, fallback) in case the supplied value is a literal, returns the fallback value otherwise.

getLocale

public static Locale getLocale(Literal l,
               Locale fallback)

Determine the Locale from a literal's language tag, as specified by RFC 3166. Note that RFC 3166 isn't fully covered by the current (JSE 6) implementation of java.util.Locale. Therefore, this method will only return a specific locale for language tags that comply with the Locale API, i.e. those that contain an ISO639 language, an optional ISO3166 country and an optional variant. In all other cases (i.e. if an error occurs or the language tag represents an IANA-registred language tag), the fallback value will be returned.

Parameters:

l - the literal

fallback - a fallback value for the locale

Returns:

the Locale, or the fallback if a suitable Locale could not be constructed for the language tag.

See Also:

RFC 3066

createLiteral

public static Literal createLiteral(ValueFactory valueFactory,
                    Object object)

Creates a typed Literal out of the supplied object, mapping the runtime type of the object to the appropriate XML Schema type. If no mapping is available, the method returns a literal with the string representation of the supplied object as the value, and XMLSchema.STRING as the datatype. Recognized types are Boolean, Byte, Double, Float, Integer, Long, Short, XMLGregorianCalendar , and Date.

Parameters:

valueFactory -

object - an object to be converted to a typed literal.

Returns:

a typed literal representation of the supplied object.

Throws:

NullPointerException - If the object was null.

Since:

2.7.0

createLiteralOrFail

public static Literal createLiteralOrFail(ValueFactory valueFactory,
                          Object object)
                                   throws LiteralUtilException

Creates a typed Literal out of the supplied object, mapping the runtime type of the object to the appropriate XML Schema type. If no mapping is available, the method throws a LiteralUtilException. Recognized types are Boolean, Byte, Double, Float, Integer, Long, Short, XMLGregorianCalendar , and Date.

Parameters:

valueFactory -

object - an object to be converted to a typed literal.

Returns:

a typed literal representation of the supplied object.

Throws:

LiteralUtilException - If the literal could not be created.

NullPointerException - If the object was null.

Since:

2.7.0

canCreateLiteral

public static boolean canCreateLiteral(Object object)

Helper method for determining whether a literal could be created from an object using a ValueFactory.

Parameters:

object - an object to check for the possibility of being converted to a typed literal.

Returns:

True if a literal could be created from the given object, based solely on its type and the methods available on the ValueFactory interface and false otherwise. Returns false if the object is null.

Since:

2.7.0