it.uniroma2.art.semanticturkey.plugin.impls.urigen

Class CODAURIGenerator

java.lang.Object

it.uniroma2.art.semanticturkey.plugin.impls.urigen.CODAURIGenerator

All Implemented Interfaces:

URIGenerator

public class CODAURIGenerator
extends Object
implements URIGenerator

Implementation of the URIGenerator extension point that delegates to a CODA converter.

Nested Class Summary

Nested classes/interfaces inherited from interface it.uniroma2.art.semanticturkey.plugin.extpts.URIGenerator

URIGenerator.Parameters, URIGenerator.Roles

Field Summary

Fields

Modifier and Type	Field and Description
static String	CODA_RANDOM_ID_GENERATOR_CONTRACT Contract URL for random ID generation.

Constructor Summary

Constructors

Constructor and Description
CODAURIGenerator(CODAURIGeneratorConfiguration config, org.springframework.beans.factory.ObjectFactory<CODACoreProvider> codaCoreProviderFactory)

Method Summary

Methods

Modifier and Type	Method and Description
ARTURIResource	generateURI(STServiceContext stServiceContext, String xRole, Map<String,ARTNode> args) Generates a new URI for the identification of a resource.

Methods inherited from class java.lang.Object

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

Field Detail

CODA_RANDOM_ID_GENERATOR_CONTRACT

public static final String CODA_RANDOM_ID_GENERATOR_CONTRACT

Contract URL for random ID generation.

See Also:

Constant Field Values

Constructor Detail

CODAURIGenerator

public CODAURIGenerator(CODAURIGeneratorConfiguration config,
                org.springframework.beans.factory.ObjectFactory<CODACoreProvider> codaCoreProviderFactory)

Method Detail

generateURI

public ARTURIResource generateURI(STServiceContext stServiceContext,
                         String xRole,
                         Map<String,ARTNode> args)
                           throws URIGenerationException

Description copied from interface: URIGenerator

Generates a new URI for the identification of a resource. The parameter xRole holds the nature of the resource that will be identified with the given URI. Depending on the value of the parameter xRole, a conforming converter may generate differently shaped URIs, possibly using specific arguments passed via the map args. For each specific xRole, the client should provide some agreed-upon parameters to the converters. This contract defines the following parameters:

• concept (for skos:Concepts)
  • label (optional): the accompanying preferred label of the skos:Concept
  • scheme (optional): the concept scheme to which the concept is being attached at the moment of its creation
• conceptScheme (for skos:ConceptSchemes)
  • label (optional): the accompaying preferred label of the skos:Concept
• xLabel (for skosxl:Labelss)
  • lexicalForm: the lexical form of the skosxl:Label without its language tag
  • lexicalizedResource: the resource to which the skosxl:Label will be attached to
  • type: the property used for attaching the label
• xNote
(for reified skos:notes)
• value: the content of the note
• annotatedResource: the resource being annotated
• type: the property used for annotation

The parameters requested by additional xRoles are defined elsewhere by the party defining that xRole. Users of this extension point should always supply values for the required parameters associated with an xRole; therefore, they should not attempt to generate a URI for an xRole unless they known what arguments are requested. Conversely, it is a duty of the specific implementation of this extension point to verify that all relevant information has been provided by the client. In fact, it is suggested that implementations act defensively, that is to say they should:

• complain only about the absence of absolutely required parameters
• handle unknown xRoles gracefully, by means some fallback strategy

Specified by:

generateURI in interface URIGenerator

Returns:

Throws:

URIGenerationException