com.bigdata.rdf.sail.webapp.client

Class EncodeDecodeValue

java.lang.Object

com.bigdata.rdf.sail.webapp.client.EncodeDecodeValue

public class EncodeDecodeValue
extends Object

Utility class to encode/decode RDF Values for interchange with the REST API.

Version:

$Id$

Author:

Bryan Thompson

Constructor Summary

Constructors

Constructor and Description
EncodeDecodeValue()

Method Summary

Methods

Modifier and Type	Method and Description
static org.openrdf.model.Resource[]	decodeContexts(String[] strings) Decode an array of named graph contexts.
static org.openrdf.model.Resource	decodeResource(String param) Type safe variant for a Resource.
static org.openrdf.model.URI	decodeURI(String param) Type safe variant for a URI.
static org.openrdf.model.Value	decodeValue(String s) Decode a URI or Literal.
static String[]	encodeContexts(org.openrdf.model.Resource[] values) Encode each Resource.
static String	encodeValue(org.openrdf.model.Value v) Encode an RDF Value as it should appear if used in a SPARQL query.

Methods inherited from class java.lang.Object

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

Constructor Detail

EncodeDecodeValue

public EncodeDecodeValue()

Method Detail

decodeValue

public static org.openrdf.model.Value decodeValue(String s)

Decode a URI or Literal.

Parameters:

s - The value to be decoded.

Returns:

The URI or literal -or- null if the argument was null.

Throws:

IllegalArgumentException - if the request parameter could not be decoded as an RDF Value.

decodeResource

public static org.openrdf.model.Resource decodeResource(String param)

Type safe variant for a Resource.

Parameters:

param - The encoded value.

Returns:

The Resource -or- null if the argument was null.

decodeURI

public static org.openrdf.model.URI decodeURI(String param)

Type safe variant for a URI.

Parameters:

param - The encoded value.

Returns:

The URI -or- null if the argument was null.

encodeValue

public static String encodeValue(org.openrdf.model.Value v)

Encode an RDF Value as it should appear if used in a SPARQL query. E.g., a literal will look like "abc", "abc"@en or "3"^^xsd:int. A URI will look like <http://www.bigdata.com/> .

Parameters:

v - The value (optional).

Returns:

The encoded value -or- null if the argument is null.

Throws:

IllegalArgumentException - if the argument is a BNode.

decodeContexts

public static org.openrdf.model.Resource[] decodeContexts(String[] strings)

Decode an array of named graph contexts.

Parameters:

strings - An array of encoded named graph contexts (required).

Returns:

An array of decoded resources that is 1:1 with the original array.

Throws:

IllegalArgumentException - if the argument is null.

See Also:

com.bigdata.rdf.store.BD;#NULL_GRAPH, Resource... contexts not encoded/decoded according to openrdf semantics (REST API)

encodeContexts

public static String[] encodeContexts(org.openrdf.model.Resource[] values)

Encode each Resource.

Note: When generating URL parameters, we will have zero or more &c=... instances. These are turned into a Resource[]. If there are no such arguments, then the array needs to be turned into Resource[0] on receipt by the webapp in order to be correctly decoded by decodeContexts(String[]).

Parameters:

values - An array of RDF Values.

Returns:

An array of encoded RDF values that is 1:1 with the original array.

Throws:

IllegalArgumentException - if the argument is null.

See Also:

com.bigdata.rdf.store.BD;#NULL_GRAPH, Resource... contexts not encoded/decoded according to openrdf semantics (REST API)