Package it.uniroma2.art.semanticturkey.services.core

Class InputOutput

java.lang.Object

it.uniroma2.art.semanticturkey.services.STServiceAdapter

it.uniroma2.art.semanticturkey.services.core.InputOutput

All Implemented Interfaces:

NewerNewStyleService, STService

@STService
public class InputOutput
extends STServiceAdapter

This class provides services for input/output.

Author:

Manuel Fiorelli

Field Summary

Fields inherited from class it.uniroma2.art.semanticturkey.services.STServiceAdapter

applicationEventPublisher, cfManager, exptManager, stServiceContext

Constructor Summary

Constructors

Constructor	Description
InputOutput()

Method Summary

Modifier and Type	Method	Description
void	clearData()	Clear the repository associated with the current project
Collection<org.eclipse.rdf4j.rio.RDFFormat>	getInputRDFFormats()	Gets RDFFormats for which a parser is available
String	getParserFormatForFileName(String fileName)	Tries to match the extension of a file name against the list of RDF formats that can be parsed (see: Rio.getParserFormatForFileName(String)).
List<DataFormat>	getSupportedFormats(String extensionID)	Returns the formats that are accepted by an extension implementing FormatCapabilityProvider.
String	getWriterFormatForFileName(String fileName)	Tries to match the extension of a file name against the list of RDF formats that can be written (see: Rio.getWriterFormatForFileName(String)).
Collection<OntologyImport>	loadRDF(org.springframework.web.multipart.MultipartFile inputFile, String baseURI, String format, TransitiveImportMethodAllowance transitiveImportAllowance, PluginSpecification loaderSpec, PluginSpecification rdfLifterSpec, TransformationPipeline transformationPipeline, boolean validateImplicitly, boolean targetGraphsFromData)	Adds RDF data directly to the ontology being edited (i.e. it is not a read-only import of an external ontology that the working ontology depends on, but a mass add of RDF triples to the main graph of the working ontology).
protected Collection<OntologyImport>	loadRDFInternal(org.springframework.web.multipart.MultipartFile inputFile, String baseURI, String format, TransitiveImportMethodAllowance transitiveImportAllowance, org.eclipse.rdf4j.repository.RepositoryConnection conn, PluginSpecification loaderSpec, PluginSpecification rdfLifterSpec, TransformationPipeline transformationPipeline, boolean targetGraphsFromData)

Methods inherited from class it.uniroma2.art.semanticturkey.services.STServiceAdapter

addValue, checkNotLocallyDefined, createQueryBuilder, generateIRI, generateNatureSPARQLSelectPart, generateNatureSPARQLWherePart, generateResourceWithCustomConstructor, getCodaLexModeForSearchFromLexicalizationModel, getDeleteGraph, getGraphFromNature, getInitializedCodaCore, getManagedConnection, getMetadataGraph, getPlatformTransactionManager, getProject, getRepository, getRoleFromNature, getUserNamedGraphs, getWorkingGraph, instantiateSearchStrategy, instantiateSearchStrategy, parseReference, publishResourceDeleted, publishResourceDeleted, removeReifiedValue, retrieveResources, shutDownCodaCore, updateTriplePredicate

Methods inherited from class java.lang.Object

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

Constructor Details

InputOutput

public InputOutput()

Method Details

getSupportedFormats

@STServiceOperation
public List<DataFormat> getSupportedFormats(String extensionID)

Returns the formats that are accepted by an extension implementing FormatCapabilityProvider.

Parameters:

extensionID -

Returns:

getParserFormatForFileName

@STServiceOperation
public String getParserFormatForFileName(String fileName)

Tries to match the extension of a file name against the list of RDF formats that can be parsed (see: Rio.getParserFormatForFileName(String)).

Parameters:

fileName -

Returns:

the name of the matched RDFFormat, or null if none is found

getWriterFormatForFileName

@STServiceOperation
public String getWriterFormatForFileName(String fileName)

Tries to match the extension of a file name against the list of RDF formats that can be written (see: Rio.getWriterFormatForFileName(String)).

Parameters:

fileName -

Returns:

the name of the matched RDFFormat, or null if none is found

loadRDF

@STServiceOperation(method=POST)
@Write
@PreAuthorize("#validateImplicitly ? @auth.isAuthorized(\'rdf(code)\', \'CV\') : @auth.isAuthorized(\'rdf(code)\', \'C\')")
public Collection<OntologyImport> loadRDF(@Optional
 org.springframework.web.multipart.MultipartFile inputFile,
 String baseURI,
 @Optional
 String format,
 TransitiveImportMethodAllowance transitiveImportAllowance,
 @Optional
 PluginSpecification loaderSpec,
 @Optional
 PluginSpecification rdfLifterSpec,
 @Optional(defaultValue="[]")
 TransformationPipeline transformationPipeline,
 @Optional(defaultValue="false")
 boolean validateImplicitly,
 @Optional(defaultValue="false")
 boolean targetGraphsFromData)
                                   throws FileNotFoundException,
IOException,
org.eclipse.rdf4j.common.exception.RDF4JException,
IllegalStateException,
IllegalArgumentException,
NoSuchExtensionException,
WrongPropertiesException,
STPropertyAccessException,
InvalidConfigurationException,
LiftingException

Adds RDF data directly to the ontology being edited (i.e. it is not a read-only import of an external ontology that the working ontology depends on, but a mass add of RDF triples to the main graph of the working ontology). The data can originate from the body of the request (inputFile is non-null) or be fetched from some source, by means of a Loader (loaderSpec is non-null). A Loader can be associated with an RDFLifter (rdfLifter is non-null), when the data source is not a triple store (interpreted broadly as a source of RDF data). Whatever the source of the data is, it is possible to setup a transformationPipeline, to transform the data before feeding it to the repository. The presence of a transformation pipeline requires the creation of a temporary repository, where data are first loaded and processed.

Parameters:

inputFile -

baseURI -

format -

transitiveImportAllowance -

loaderSpec -

rdfLifterSpec -

transformationPipeline -

validateImplicitly -

Throws:

FileNotFoundException

IOException

InvalidConfigurationException

STPropertyAccessException

WrongPropertiesException

NoSuchExtensionException

IllegalArgumentException

IllegalStateException

org.eclipse.rdf4j.common.exception.RDF4JException

LiftingException

loadRDFInternal

protected Collection<OntologyImport> loadRDFInternal(@Nullable
 org.springframework.web.multipart.MultipartFile inputFile,
 String baseURI,
 @Nullable
 String format,
 TransitiveImportMethodAllowance transitiveImportAllowance,
 org.eclipse.rdf4j.repository.RepositoryConnection conn,
 @Nullable
 PluginSpecification loaderSpec,
 PluginSpecification rdfLifterSpec,
 TransformationPipeline transformationPipeline,
 boolean targetGraphsFromData)
                                              throws IOException,
IllegalStateException,
IllegalArgumentException,
org.eclipse.rdf4j.common.exception.RDF4JException,
NoSuchExtensionException,
WrongPropertiesException,
STPropertyAccessException,
InvalidConfigurationException,
LiftingException

Throws:

IOException

IllegalStateException

IllegalArgumentException

org.eclipse.rdf4j.common.exception.RDF4JException

NoSuchExtensionException

WrongPropertiesException

STPropertyAccessException

InvalidConfigurationException

LiftingException

clearData

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'rdf(code)\', \'D\')")
public void clearData()
               throws Exception

Clear the repository associated with the current project

Throws:

Exception

getInputRDFFormats

@STServiceOperation
public Collection<org.eclipse.rdf4j.rio.RDFFormat> getInputRDFFormats()

Gets RDFFormats for which a parser is available

Returns: