org.eaglei.repository.util
Class Utils

java.lang.Object
  org.eaglei.repository.util.Utils

public class Utils
extends java.lang.Object

Utility methods

Version:

$Id: $

Author:

Larry Stone

Constructor Summary

Utils()

Method Summary

static void	copyStream(java.io.InputStream in, java.io.OutputStream out) The canonical file copy loop.
static boolean	isValidURI(java.lang.String s) Test whether a string is a well-formed-enough absolute URI that it will not cause createURI to fail.
static boolean	parseBooleanParameter(java.lang.String name, java.lang.String argName, boolean required, boolean defaultValue) Special query arg parser for args with boolean values.
static java.lang.Enum	parseKeywordArg(java.lang.Class et, java.lang.String name, java.lang.String argName, boolean required, java.lang.Enum defaultValue) Parse a query arg value that is supposed to belong to an Enum set.
static org.openrdf.model.URI	parseURI(java.lang.String s, java.lang.String argName, boolean required) Translates string to URI with sanity check.
static javax.xml.datatype.XMLGregorianCalendar	parseXMLDate(java.lang.String raw)
static java.lang.String	prettyPrint(org.openrdf.query.Dataset ds) Formatted human-readable view of Dataset contents which works even when some members are null.

Methods inherited from class java.lang.Object

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

Constructor Detail

Utils

public Utils()

Method Detail

copyStream

public static void copyStream(java.io.InputStream in,
                              java.io.OutputStream out)
                       throws java.io.IOException

The canonical file copy loop. Closes streams when done.

Parameters:

in - source, a InputStream object.

out - destination, a OutputStream object.

Throws:

java$io$IOException - if anything goes wrong.

java.io.IOException

prettyPrint

public static java.lang.String prettyPrint(org.openrdf.query.Dataset ds)

Formatted human-readable view of Dataset contents which works even when some members are null. Needed because Sesame's toString() breaks on a null URI, even though that is allowed and necessary(!) for temporary fix of inferencing context problem..

Parameters:

ds - a Dataset object.

Returns:

multi-line prettyprint in a String object.

isValidURI

public static boolean isValidURI(java.lang.String s)

Test whether a string is a well-formed-enough absolute URI that it will not cause createURI to fail.

Parameters:

s - possible URI

Returns:

a boolean, true if s is a valid URI.

parseURI

public static org.openrdf.model.URI parseURI(java.lang.String s,
                                             java.lang.String argName,
                                             boolean required)

Translates string to URI with sanity check.

Parameters:

s - possible URI

argName - name of parameter for error messages

required - true if arg is required

Returns:

a URI

parseKeywordArg

public static java.lang.Enum parseKeywordArg(java.lang.Class et,
                                             java.lang.String name,
                                             java.lang.String argName,
                                             boolean required,
                                             java.lang.Enum defaultValue)

Parse a query arg value that is supposed to belong to an Enum set. If a value is required, throw the BadRequest exception if not present, and in any case throw BadRequest if it is not a valid enumerated value. NOTE: This _ought_ to be shared in utils or some such but then all the arg enums would haev to be public, and they shouldn't be.

Parameters:

et - the enumerated type class

name - value of the argument

argName - name of the argument, e.g. parameter name

required - when true this arg MUST have a value.

defaultValue - default to subsitute when arg is not required and missing

Returns:

the enum or null only if required is false and there is no value.

Throws:

BadRequestException - if arg is missing or illegal

parseBooleanParameter

public static boolean parseBooleanParameter(java.lang.String name,
                                            java.lang.String argName,
                                            boolean required,
                                            boolean defaultValue)

Special query arg parser for args with boolean values. If a value is "required", throw the BadRequest exception if not present, and in any case throw BadRequest if it is not a valid enumerated value. Use the enum as a convenient table of strings and values.

Parameters:

name - value of the argument

argName - name of the argument, e.g. parameter name

required - when true this arg MUST have a value.

defaultValue - default to subsitute when arg is not required and missing

Returns:

the boolean result of parsed or defaulted arg

Throws:

BadRequestException - if arg is missing or illegal

parseXMLDate

public static javax.xml.datatype.XMLGregorianCalendar parseXMLDate(java.lang.String raw)