Package org.eclipse.lyo.oslc4j.provider.jena

Class JenaModelHelper

java.lang.Object

org.eclipse.lyo.oslc4j.provider.jena.JenaModelHelper

public final class JenaModelHelper
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static final String	OSLC4J_STRICT_DATATYPES	Deprecated.

Method Summary

Modifier and Type	Method	Description
static Model	createJenaModel(Object[] objects)
static <R extends IResource> R	followLink(Model m, Link l, Class<R> rClass)	Extracts a resource from the Jena model pointed to by a Link.
static Object[]	fromJenaModel(Model model, Class<?> beanClass)	Deprecated. Use unmarshal(Model, Class) instead.
static Object	fromJenaResource(Resource resource, Class<?> beanClass)	Deprecated. Use unmarshal(Resource, Class) or unmarshalSingle(Model, Class) instead.
protected static void	handleExtendedProperties(Class<?> resourceClass, Model model, Resource mainResource, IExtendedResource extendedResource, Map<String,Object> properties, Map<IExtendedResource,Resource> visitedResources)
static void	skolemize(Model m)	Skolemize all blank node by replacing them with equivalent resources with an ephemeral URI of form 'urn:skolem:%blankNodeId%''
static void	skolemize(Model m, Function<BlankNodeId,String> skolemUriFunction)	Skolemize all blank node by replacing them with equivalent resources with a URI generated by the supplied lambda function.
static <T> T[]	unmarshal(Model model, Class<T> clazz)	Wrapper around fromJenaModel(Model, Class) to provide generics support and group exceptions.
static <T> T	unmarshal(Resource resource, Class<T> clazz)	Wrapper around fromJenaResource(Resource, Class) to provide generics support and group exceptions.
static <T> T	unmarshalSingle(Model model, Class<T> clazz)	Wrapper around unmarshal(Model, Class) to unmarshal a single resource instance.

Methods inherited from class java.lang.Object

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

Field Details

OSLC4J_STRICT_DATATYPES

@Deprecated
public static final String OSLC4J_STRICT_DATATYPES

Deprecated.

System property "org.eclipse.lyo.oslc4j.strictDatatypes" : When "true" (default), fail on when reading a property value that is not a legal instance of a datatype. When "false", skip over invalid values in extended properties.

See Also:

• Constant Field Values

Method Details

createJenaModel

public static Model createJenaModel(Object[] objects)
                             throws DatatypeConfigurationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException,
OslcCoreApplicationException

Throws:

DatatypeConfigurationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

OslcCoreApplicationException

unmarshalSingle

public static <T> T unmarshalSingle(Model model,
 Class<T> clazz)
                             throws IllegalArgumentException,
LyoModelException

Wrapper around unmarshal(Model, Class) to unmarshal a single resource instance.

Throws:

IllegalArgumentException - if anything but 1 resource was unmarshaled exactly.

LyoModelException

unmarshal

public static <T> T unmarshal(Resource resource,
 Class<T> clazz)
                       throws LyoModelException

Wrapper around fromJenaResource(Resource, Class) to provide generics support and group exceptions.

Type Parameters:

T - Same resource class/interface to make the method generic

Parameters:

resource - Jena resource to be unmarshalled

clazz - Lyo resource class/interface instance to assist reflection

Returns:

an unmarshalled resource class instance

Throws:

LyoModelException - if the model cannot be unmarshalled into instances of the provided class

fromJenaResource

@Deprecated
public static Object fromJenaResource(Resource resource,
 Class<?> beanClass)
                               throws DatatypeConfigurationException,
IllegalAccessException,
IllegalArgumentException,
InstantiationException,
InvocationTargetException,
OslcCoreApplicationException,
URISyntaxException,
SecurityException,
NoSuchMethodException

Deprecated.

Use unmarshal(Resource, Class) or unmarshalSingle(Model, Class) instead.

Throws:

DatatypeConfigurationException

IllegalAccessException

IllegalArgumentException

InstantiationException

InvocationTargetException

OslcCoreApplicationException

URISyntaxException

SecurityException

NoSuchMethodException

unmarshal

public static <T> T[] unmarshal(Model model,
 Class<T> clazz)
                         throws LyoModelException

Wrapper around fromJenaModel(Model, Class) to provide generics support and group exceptions.

Type Parameters:

T - Same resource class to make the method generic

Parameters:

model - Jena model with RDF resources to be unmarshalled

clazz - Lyo resource class instance to assist reflection

Returns:

an array of unmarshalled resource class instances

Throws:

LyoModelException - if the model cannot be unmarshalled into instances of the provided class

fromJenaModel

@Deprecated
public static Object[] fromJenaModel(Model model,
 Class<?> beanClass)
                              throws DatatypeConfigurationException,
IllegalAccessException,
IllegalArgumentException,
InstantiationException,
InvocationTargetException,
OslcCoreApplicationException,
URISyntaxException,
SecurityException,
NoSuchMethodException

Deprecated.

Use unmarshal(Model, Class) instead.

Throws:

DatatypeConfigurationException

IllegalAccessException

IllegalArgumentException

InstantiationException

InvocationTargetException

OslcCoreApplicationException

URISyntaxException

SecurityException

NoSuchMethodException

followLink

public static <R extends IResource> R followLink(Model m,
 Link l,
 Class<R> rClass)
                                          throws IllegalArgumentException,
LyoModelException

Extracts a resource from the Jena model pointed to by a Link.

Useful in case of following links of a just unmarshaled resource using unmarshal(Model, Class) or unmarshalSingle(Model, Class).

Type Parameters:

R - Same class argument to make method generic

Parameters:

m - Jena model

l - Link that points to resouce inside the model

rClass - Lyo resource class to unmarshall the OSLC resource into.

Returns:

An instance of a resource class

Throws:

IllegalArgumentException - if the link does not point a resource in the model.

LyoModelException

skolemize

public static void skolemize(Model m)

Skolemize all blank node by replacing them with equivalent resources with an ephemeral URI of form 'urn:skolem:%blankNodeId%''

Parameters:

m - Jena model to skolemize

skolemize

public static void skolemize(Model m,
 Function<BlankNodeId,String> skolemUriFunction)

Skolemize all blank node by replacing them with equivalent resources with a URI generated by the supplied lambda function.

See RDF 1.1 // Replacing Blank Nodes with IRIs for further guidance.

Parameters:

m - Jena model to skolemize

skolemUriFunction - Lambda function that returns ("mints") a resource URI for a BNode.

handleExtendedProperties

protected static void handleExtendedProperties(Class<?> resourceClass,
 Model model,
 Resource mainResource,
 IExtendedResource extendedResource,
 Map<String,Object> properties,
 Map<IExtendedResource,Resource> visitedResources)
                                        throws DatatypeConfigurationException,
IllegalAccessException,
InvocationTargetException,
OslcCoreApplicationException

Throws:

DatatypeConfigurationException

IllegalAccessException

InvocationTargetException

OslcCoreApplicationException