Package it.uniroma2.art.semanticturkey.mdr.services

Class MetadataRegistry

java.lang.Object

it.uniroma2.art.semanticturkey.services.STServiceAdapter

it.uniroma2.art.semanticturkey.mdr.services.MetadataRegistry

All Implemented Interfaces:

NewerNewStyleService, STService

@STService
public class MetadataRegistry
extends STServiceAdapter

This service class allows the management of the metadata about remote datasets.

Field Summary

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

applicationEventPublisher, cfManager, exptManager, stServiceContext

Constructor Summary

Constructors

Constructor	Description
MetadataRegistry()

Method Summary

Modifier and Type	Method	Description
void	addEmbeddedLexicalizationSet(org.eclipse.rdf4j.model.IRI distribution, org.eclipse.rdf4j.model.IRI lexicalizationSet, org.eclipse.rdf4j.model.IRI lexiconDataset, org.eclipse.rdf4j.model.IRI lexicalizationModel, String language, BigInteger references, BigInteger lexicalEntries, BigInteger lexicalizations, BigDecimal percentage, BigDecimal avgNumOfLexicalizations)	Adds an embedded lexicalization set for a dataset.
void	addLODRealization(org.eclipse.rdf4j.model.IRI datasetArchetype)
org.eclipse.rdf4j.model.IRI	addSparqlEndpoint(org.eclipse.rdf4j.model.IRI datasetDistribution, List<org.eclipse.rdf4j.model.Literal> titles, List<org.eclipse.rdf4j.model.Literal> descriptions, String endpointURL, Set<org.eclipse.rdf4j.model.IRI> limitations)
void	assessLexicalizationModel(org.eclipse.rdf4j.model.IRI distribution)	Consults the dataset distribution (in the best possible way going from more to less noble availabilities: localProject --> SPARQLendpoint --> http-dereferenciation) in order to assess its lexicalization model.
void	bulkSetMainShardsAsNonEditable()	Bulk change all main shards as non-editable
Boolean	checkShortNameExists(String shortName)
AnnotatedValue<org.eclipse.rdf4j.model.IRI>	createConcreteDataset(String datasetLocalName, String uriSpace, org.eclipse.rdf4j.model.Literal title, org.eclipse.rdf4j.model.Literal description, Boolean dereferenceable, it.uniroma2.art.semanticturkey.mdr.core.Distribution distribution, it.uniroma2.art.semanticturkey.mdr.core.DatasetAbstractionAttachment datasetAbstractionAttachment)	Creates a new concrete dataset.
AnnotatedValue<org.eclipse.rdf4j.model.IRI>	createDatasetAbstraction(@Pattern(regexp="^[\\w-]+$") String shortName, String uriSpace, List<@LanguageTaggedString org.eclipse.rdf4j.model.Literal> title, List<@LanguageTaggedString org.eclipse.rdf4j.model.Literal> description)
void	deleteCatalogRecord(org.eclipse.rdf4j.model.IRI catalogRecord)	Deletes a catalog record
void	deleteDatasetAbstraction(org.eclipse.rdf4j.model.IRI datasetAbstraction, boolean force)
void	deleteDeploymentForDistribution(org.eclipse.rdf4j.model.IRI deployment)
void	deleteEmbeddedLexicalizationSet(org.eclipse.rdf4j.model.IRI lexicalizationSet)	Delete an embedded lexicalization set
AnnotatedValue<org.eclipse.rdf4j.model.IRI>	discoverDataset(org.eclipse.rdf4j.model.IRI iri)	Discover the metadata for a dataset given an IRI.
it.uniroma2.art.semanticturkey.mdr.core.DatasetMetadata2	discoverDatasetMetadata(org.eclipse.rdf4j.model.IRI iri)	Discover the metadata for a dataset given an IRI.
void	downloadMetadata(jakarta.servlet.http.HttpServletResponse oRes)
com.fasterxml.jackson.databind.JsonNode	evaluateQuery(String query)
void	exportDatasetAbstractionMetadata(jakarta.servlet.http.HttpServletResponse oRes, org.eclipse.rdf4j.model.IRI datasetAbstraction, org.eclipse.rdf4j.rio.RDFFormat outputFormat)	Exports metadata about a dataset abstraction stored in its main graph
void	exportDatasetVersionMetadata(jakarta.servlet.http.HttpServletResponse oRes, org.eclipse.rdf4j.model.IRI datasetVersion, org.eclipse.rdf4j.rio.RDFFormat outputFormat)	Exports metadata about a dataset version stored in its main graph
Collection<it.uniroma2.art.semanticturkey.mdr.core.CatalogRecord2>	filterRootDatasets(org.eclipse.rdf4j.model.IRI datasetAbstraction, boolean sameUriSpace)
ResourcePosition	findDataset(org.eclipse.rdf4j.model.IRI iri)	Find a dataset matching the given IRI.
AnnotatedValue<org.eclipse.rdf4j.model.IRI>	findDatasetAbstractionForProject()
Collection<ResourcePosition>	findDatasets(org.eclipse.rdf4j.model.IRI iri)	Find all datasets matching the given IRI.
org.eclipse.rdf4j.model.IRI	findDeployedDistributionForProject()
it.uniroma2.art.semanticturkey.mdr.core.DatasetAbstraction	getAbstractionForDataset(org.eclipse.rdf4j.model.IRI dataset)
org.eclipse.rdf4j.model.IRI	getCatalogRecord(org.eclipse.rdf4j.model.IRI datasetArchetypeOrRealization)
Map<String,Integer>	getClassPartitions(org.eclipse.rdf4j.model.IRI datasetDistribution)
org.eclipse.rdf4j.model.IRI	getComputedLexicalizationModel(org.eclipse.rdf4j.model.IRI dataset)	Get lexicalization model
it.uniroma2.art.semanticturkey.mdr.core.DatasetVersion	getCurrentVersionForProject()
List<it.uniroma2.art.semanticturkey.mdr.core.DatasetAbstraction>	getDatasetAbstractions()
it.uniroma2.art.semanticturkey.mdr.core.DatasetCatalogConnector	getDatasetCatalogConnector(String extensionId, String catalogId)
List<it.uniroma2.art.semanticturkey.mdr.core.DatasetChangesetFile>	getDatasetChangesetFiles(org.eclipse.rdf4j.model.IRI datasetDistribution)
List<it.uniroma2.art.semanticturkey.mdr.core.DatasetDistribution>	getDatasetDistributions(org.eclipse.rdf4j.model.IRI dataset, boolean includeLocalDeployments)
it.uniroma2.art.semanticturkey.mdr.core.DatasetMetadata2	getDatasetMetadata2(org.eclipse.rdf4j.model.IRI dataset)
List<it.uniroma2.art.semanticturkey.mdr.core.DatasetVersion>	getDatasetRealizationsForProject(boolean excludeMutable)
List<it.uniroma2.art.semanticturkey.mdr.core.DatasetVersion>	getDatasetVersions(org.eclipse.rdf4j.model.IRI datasetAbstraction, boolean excludeMutable, boolean onlyLocallyDeployed, boolean reportLocalProjectShardLocator)
it.uniroma2.art.semanticturkey.mdr.core.DatasetMetadata2	getDeployedDataset(String projectName, String shardName)
it.uniroma2.art.semanticturkey.mdr.core.DatasetVersion	getDeployedDatasetVersion(String projectName, String shardName)
Collection<it.uniroma2.art.semanticturkey.mdr.core.LexicalizationSetMetadata>	getEmbeddedLexicalizationSets(org.eclipse.rdf4j.model.IRI distribution)	Returns metadata about the lexicalization sets embedded in a given dataset
Collection<it.uniroma2.art.semanticturkey.mdr.core.LinksetMetadata>	getEmbeddedLinksets(org.eclipse.rdf4j.model.IRI distribution, long threshold, boolean coalesce)	Returns metadata about the linksets sets embedded in a given dataset
Collection<it.uniroma2.art.semanticturkey.mdr.core.LinksetDistribution>	getLinksetDistributionFiles(org.eclipse.rdf4j.model.IRI datasetDistribution)
EnhancedProjectShardLocator	getLocalDeploymentLocation(String datasetAbstractionName, String version)
ProjectInfoSummary	getProjectsForDatasetAbstraction(org.eclipse.rdf4j.model.IRI datasetAbstraction)
Collection<org.eclipse.rdf4j.model.IRI>	getSPARQLEndpointLimitations(org.eclipse.rdf4j.model.IRI endpoint)	Returns the limitations associated with the provided endpoint
void	importDatasetAbstractionMetadata(org.springframework.web.multipart.MultipartFile inputFile, org.eclipse.rdf4j.rio.RDFFormat inputFormat, org.eclipse.rdf4j.model.IRI datasetAbstraction)	Imports metadata about a dataset abstraction stored in its main graph
void	importDatasetVersionMetadata(org.springframework.web.multipart.MultipartFile inputFile, org.eclipse.rdf4j.rio.RDFFormat inputFormat, org.eclipse.rdf4j.model.IRI datasetVersion)	Imports metadata about a dataset version stored in its main graph
Collection<it.uniroma2.art.semanticturkey.mdr.core.CatalogRecord2>	listConnectedDatasets(org.eclipse.rdf4j.model.IRI datasetAbstraction)	Returns the datasets connected to a given dataset abstraction, e.g.
Collection<it.uniroma2.art.semanticturkey.mdr.core.CatalogRecord2>	listRootDatasets()
void	mergeRootDatasets(org.eclipse.rdf4j.model.IRI datasetToMaintain, org.eclipse.rdf4j.model.IRI datasetToDelete)
void	removeSPARQLEndpointLimitation(org.eclipse.rdf4j.model.IRI endpoint, org.eclipse.rdf4j.model.IRI limitation)	Removes the given limitation from the provided endpoint
void	setAsCurrentVersion(org.eclipse.rdf4j.model.IRI dataset)
void	setDatasetRealizationVersion(org.eclipse.rdf4j.model.IRI datasetRealization, String newVersion)
void	setDereferenciability(org.eclipse.rdf4j.model.IRI dataset, Boolean value)	Sets whether a dataset is derefereanceable or not.
void	setMetadataRegistry(STMetadataRegistryBackend metadataRegistryBackend)
void	setResourceLocator(ResourceLocator resourceLocator)
void	setSPARQLEndpointLimitation(org.eclipse.rdf4j.model.IRI endpoint, org.eclipse.rdf4j.model.IRI limitation)	Sets the given limitation for the provided endpoint

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

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

Methods inherited from class java.lang.Object

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

Constructor Details

MetadataRegistry

public MetadataRegistry()

Method Details

downloadMetadata

@STServiceOperation
@PreAuthorize("@auth.isAdmin()")
public void downloadMetadata(jakarta.servlet.http.HttpServletResponse oRes)
                      throws IOException

Throws:

IOException

createDatasetAbstraction

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isSuperUser(false) || @auth.isAuthorized(\'sys(metadataRegistry)\', \'C\')")
public AnnotatedValue<org.eclipse.rdf4j.model.IRI> createDatasetAbstraction(@Pattern(regexp="^[\\w-]+$")
 @Pattern(regexp="^[\\w-]+$") String shortName,
 String uriSpace,
 @Optional(defaultValue="")
 List<@LanguageTaggedString org.eclipse.rdf4j.model.Literal> title,
 @Optional(defaultValue="")
 List<@LanguageTaggedString org.eclipse.rdf4j.model.Literal> description)
                                                                     throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

addLODRealization

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'U\')")
public void addLODRealization(org.eclipse.rdf4j.model.IRI datasetArchetype)
                       throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

deleteDatasetAbstraction

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'D\')")
public void deleteDatasetAbstraction(org.eclipse.rdf4j.model.IRI datasetAbstraction,
 @Optional(defaultValue="false")
 boolean force)
                              throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

checkShortNameExists

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public Boolean checkShortNameExists(String shortName)
                             throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

getDatasetAbstractions

@STServiceOperation
@PreAuthorize("@auth.isSuperUser(false) || @auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public List<it.uniroma2.art.semanticturkey.mdr.core.DatasetAbstraction> getDatasetAbstractions()
                                                                                        throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

getLocalDeploymentLocation

@STServiceOperation
public EnhancedProjectShardLocator getLocalDeploymentLocation(String datasetAbstractionName,
 String version)
                                                       throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException,
ProjectAccessException,
ProjectInexistentException,
InvalidProjectNameException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

ProjectAccessException

ProjectInexistentException

InvalidProjectNameException

getDatasetVersions

@STServiceOperation
@PreAuthorize("@auth.isSuperUser(false) || @auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public List<it.uniroma2.art.semanticturkey.mdr.core.DatasetVersion> getDatasetVersions(org.eclipse.rdf4j.model.IRI datasetAbstraction,
 @Optional(defaultValue="false")
 boolean excludeMutable,
 @Optional(defaultValue="true")
 boolean onlyLocallyDeployed,
 @Optional(defaultValue="true")
 boolean reportLocalProjectShardLocator)
                                                                                throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

getDatasetRealizationsForProject

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public List<it.uniroma2.art.semanticturkey.mdr.core.DatasetVersion> getDatasetRealizationsForProject(@Optional(defaultValue="false")
 boolean excludeMutable)
                                                                                              throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

getDatasetDistributions

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public List<it.uniroma2.art.semanticturkey.mdr.core.DatasetDistribution> getDatasetDistributions(org.eclipse.rdf4j.model.IRI dataset,
 boolean includeLocalDeployments)
                                                                                          throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

getDatasetChangesetFiles

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public List<it.uniroma2.art.semanticturkey.mdr.core.DatasetChangesetFile> getDatasetChangesetFiles(org.eclipse.rdf4j.model.IRI datasetDistribution)
                                                                                            throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

getDatasetCatalogConnector

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public it.uniroma2.art.semanticturkey.mdr.core.DatasetCatalogConnector getDatasetCatalogConnector(String extensionId,
 String catalogId)
                                                                                           throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

getDeployedDataset

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public it.uniroma2.art.semanticturkey.mdr.core.DatasetMetadata2 getDeployedDataset(String projectName,
 String shardName)
                                                                            throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

getDeployedDatasetVersion

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public it.uniroma2.art.semanticturkey.mdr.core.DatasetVersion getDeployedDatasetVersion(String projectName,
 String shardName)
                                                                                 throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

getCurrentVersionForProject

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public it.uniroma2.art.semanticturkey.mdr.core.DatasetVersion getCurrentVersionForProject()
                                                                                   throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

setAsCurrentVersion

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'U\')")
public void setAsCurrentVersion(org.eclipse.rdf4j.model.IRI dataset)
                         throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

setDatasetRealizationVersion

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'U\')")
public void setDatasetRealizationVersion(org.eclipse.rdf4j.model.IRI datasetRealization,
 String newVersion)
                                  throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

getAbstractionForDataset

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public it.uniroma2.art.semanticturkey.mdr.core.DatasetAbstraction getAbstractionForDataset(org.eclipse.rdf4j.model.IRI dataset)
                                                                                    throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

findDatasetAbstractionForProject

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public AnnotatedValue<org.eclipse.rdf4j.model.IRI> findDatasetAbstractionForProject()
                                                                             throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

findDeployedDistributionForProject

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public org.eclipse.rdf4j.model.IRI findDeployedDistributionForProject()
                                                               throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

getProjectsForDatasetAbstraction

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public ProjectInfoSummary getProjectsForDatasetAbstraction(org.eclipse.rdf4j.model.IRI datasetAbstraction)
                                                    throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

listRootDatasets

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public Collection<it.uniroma2.art.semanticturkey.mdr.core.CatalogRecord2> listRootDatasets()

filterRootDatasets

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public Collection<it.uniroma2.art.semanticturkey.mdr.core.CatalogRecord2> filterRootDatasets(org.eclipse.rdf4j.model.IRI datasetAbstraction,
 @Optional(defaultValue="false")
 boolean sameUriSpace)

mergeRootDatasets

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'D\')")
public void mergeRootDatasets(org.eclipse.rdf4j.model.IRI datasetToMaintain,
 org.eclipse.rdf4j.model.IRI datasetToDelete)

listConnectedDatasets

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public Collection<it.uniroma2.art.semanticturkey.mdr.core.CatalogRecord2> listConnectedDatasets(org.eclipse.rdf4j.model.IRI datasetAbstraction)

Returns the datasets connected to a given dataset abstraction, e.g. as a version

Parameters:

datasetAbstraction - a dataset abstraction

Returns:

a collection of datasets connected to the given dataset abstractions

getDatasetMetadata2

@STServiceOperation
public it.uniroma2.art.semanticturkey.mdr.core.DatasetMetadata2 getDatasetMetadata2(org.eclipse.rdf4j.model.IRI dataset)
                                                                             throws it.uniroma2.art.semanticturkey.mdr.core.NoSuchDatasetMetadataException,
it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryStateException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.NoSuchDatasetMetadataException

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryStateException

getEmbeddedLexicalizationSets

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public Collection<it.uniroma2.art.semanticturkey.mdr.core.LexicalizationSetMetadata> getEmbeddedLexicalizationSets(org.eclipse.rdf4j.model.IRI distribution)

Returns metadata about the lexicalization sets embedded in a given dataset

deleteEmbeddedLexicalizationSet

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'D\')")
public void deleteEmbeddedLexicalizationSet(org.eclipse.rdf4j.model.IRI lexicalizationSet)
                                     throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException,
it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryStateException

Delete an embedded lexicalization set

Parameters:

lexicalizationSet -

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryStateException

addEmbeddedLexicalizationSet

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'C\')")
public void addEmbeddedLexicalizationSet(org.eclipse.rdf4j.model.IRI distribution,
 @Optional
 org.eclipse.rdf4j.model.IRI lexicalizationSet,
 @Optional
 org.eclipse.rdf4j.model.IRI lexiconDataset,
 org.eclipse.rdf4j.model.IRI lexicalizationModel,
 String language,
 @Optional
 BigInteger references,
 @Optional
 BigInteger lexicalEntries,
 @Optional
 BigInteger lexicalizations,
 @Optional
 BigDecimal percentage,
 @Optional
 BigDecimal avgNumOfLexicalizations)
                                  throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

Adds an embedded lexicalization set for a dataset.

Parameters:

distribution -

lexicalizationSet - if null is passed, a local IRI is created

lexiconDataset -

lexicalizationModel -

language -

references -

lexicalEntries -

lexicalizations -

percentage -

avgNumOfLexicalizations -

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

assessLexicalizationModel

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'U\')")
public void assessLexicalizationModel(org.eclipse.rdf4j.model.IRI distribution)
                               throws it.uniroma2.art.maple.orchestration.AssessmentException

Consults the dataset distribution (in the best possible way going from more to less noble availabilities: localProject --> SPARQLendpoint --> http-dereferenciation) in order to assess its lexicalization model.

Parameters:

distribution -

Throws:

it.uniroma2.art.maple.orchestration.AssessmentException

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

getEmbeddedLinksets

@STServiceOperation
public Collection<it.uniroma2.art.semanticturkey.mdr.core.LinksetMetadata> getEmbeddedLinksets(org.eclipse.rdf4j.model.IRI distribution,
 @Optional(defaultValue="0")
 long threshold,
 @Optional(defaultValue="false")
 boolean coalesce)

Returns metadata about the linksets sets embedded in a given dataset

Parameters:

distribution -

threshold - minimum number of links (before linkset coalescing)

coalesce - whether merge linksets for the same pair of datasets

Returns:

getLinksetDistributionFiles

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public Collection<it.uniroma2.art.semanticturkey.mdr.core.LinksetDistribution> getLinksetDistributionFiles(org.eclipse.rdf4j.model.IRI datasetDistribution)
                                                                                                    throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

getClassPartitions

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public Map<String,Integer> getClassPartitions(org.eclipse.rdf4j.model.IRI datasetDistribution)

addSparqlEndpoint

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'U\')")
public org.eclipse.rdf4j.model.IRI addSparqlEndpoint(org.eclipse.rdf4j.model.IRI datasetDistribution,
 List<org.eclipse.rdf4j.model.Literal> titles,
 List<org.eclipse.rdf4j.model.Literal> descriptions,
 String endpointURL,
 @Optional(defaultValue="")
 Set<org.eclipse.rdf4j.model.IRI> limitations)
                                              throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

deleteDeploymentForDistribution

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'U\')")
public void deleteDeploymentForDistribution(org.eclipse.rdf4j.model.IRI deployment)

evaluateQuery

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
@Read
public com.fasterxml.jackson.databind.JsonNode evaluateQuery(String query)

getComputedLexicalizationModel

@STServiceOperation(method=GET)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public org.eclipse.rdf4j.model.IRI getComputedLexicalizationModel(org.eclipse.rdf4j.model.IRI dataset)
                                                           throws it.uniroma2.art.maple.orchestration.AssessmentException,
it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

Get lexicalization model

Parameters:

dataset -

Returns:

the lexicalization model or null if it can't be determined

Throws:

it.uniroma2.art.maple.orchestration.AssessmentException

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

setMetadataRegistry

@Autowired
public void setMetadataRegistry(STMetadataRegistryBackend metadataRegistryBackend)

setResourceLocator

@Autowired
public void setResourceLocator(ResourceLocator resourceLocator)

createConcreteDataset

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'C\')")
public AnnotatedValue<org.eclipse.rdf4j.model.IRI> createConcreteDataset(String datasetLocalName,
 String uriSpace,
 @Optional
 org.eclipse.rdf4j.model.Literal title,
 @Optional
 org.eclipse.rdf4j.model.Literal description,
 @Optional
 Boolean dereferenceable,
 @Optional @JsonSerialized
 it.uniroma2.art.semanticturkey.mdr.core.Distribution distribution,
 @Optional @JsonSerialized
 it.uniroma2.art.semanticturkey.mdr.core.DatasetAbstractionAttachment datasetAbstractionAttachment)
                                                                  throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException,
ProjectAccessException,
ProjectInexistentException,
InvalidProjectNameException

Creates a new concrete dataset.

Parameters:

datasetLocalName - if null passed, a named is generated for the dataset

uriSpace - the current URI space of the dataset, as its concrete distributions may introduce futher ones

title - the current title of the dataset

description - the current description of the dataset

dereferenceable - whether the dataset is dereferenceable: null means unknown

distribution - the distribution associated with the dataset, which also determines the dataset nature

datasetAbstractionAttachment - optional connection to an abstract dataset

Returns:

the IRI of the newly created dataset

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

ProjectAccessException

ProjectInexistentException

InvalidProjectNameException

setDereferenciability

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'U\')")
public void setDereferenciability(org.eclipse.rdf4j.model.IRI dataset,
 @Optional
 Boolean value)
                           throws IllegalArgumentException,
it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

Sets whether a dataset is derefereanceable or not. If value is true, then sets mdreg:standardDereferenciation and if false sets mdreg:noDereferenciation. If is not passed, the dereferenciation system is left unspecified.

Parameters:

dataset -

value -

Throws:

IllegalArgumentException

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

setSPARQLEndpointLimitation

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'U\')")
public void setSPARQLEndpointLimitation(org.eclipse.rdf4j.model.IRI endpoint,
 org.eclipse.rdf4j.model.IRI limitation)
                                 throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

Sets the given limitation for the provided endpoint

Parameters:

endpoint -

limitation -

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

removeSPARQLEndpointLimitation

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'U\')")
public void removeSPARQLEndpointLimitation(org.eclipse.rdf4j.model.IRI endpoint,
 org.eclipse.rdf4j.model.IRI limitation)
                                    throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

Removes the given limitation from the provided endpoint

Parameters:

endpoint -

limitation -

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

getSPARQLEndpointLimitations

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public Collection<org.eclipse.rdf4j.model.IRI> getSPARQLEndpointLimitations(org.eclipse.rdf4j.model.IRI endpoint)

Returns the limitations associated with the provided endpoint

Parameters:

endpoint -

getCatalogRecord

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public org.eclipse.rdf4j.model.IRI getCatalogRecord(org.eclipse.rdf4j.model.IRI datasetArchetypeOrRealization)
                                             throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

deleteCatalogRecord

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'D\')")
public void deleteCatalogRecord(org.eclipse.rdf4j.model.IRI catalogRecord)
                         throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

Deletes a catalog record

Parameters:

catalogRecord -

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryWritingException

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

findDataset

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public ResourcePosition findDataset(org.eclipse.rdf4j.model.IRI iri)
                             throws ProjectAccessException

Find a dataset matching the given IRI.

Parameters:

iri -

Returns:

Throws:

ProjectAccessException

findDatasets

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public Collection<ResourcePosition> findDatasets(org.eclipse.rdf4j.model.IRI iri)
                                          throws ProjectAccessException

Find all datasets matching the given IRI.

Parameters:

iri -

Returns:

Throws:

ProjectAccessException

discoverDatasetMetadata

@STServiceOperation
public it.uniroma2.art.semanticturkey.mdr.core.DatasetMetadata2 discoverDatasetMetadata(org.eclipse.rdf4j.model.IRI iri)
                                                                                 throws DeniedOperationException,
it.uniroma2.art.semanticturkey.mdr.core.MetadataDiscoveryException

Discover the metadata for a dataset given an IRI. If discovery is unsuccessful, an exception is thrown.

Parameters:

iri -

Returns:

the newly created dcat:CatalogRecord for the discovered dataset

Throws:

ProjectAccessException

DeniedOperationException

it.uniroma2.art.semanticturkey.mdr.core.MetadataDiscoveryException

discoverDataset

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'C\')")
public AnnotatedValue<org.eclipse.rdf4j.model.IRI> discoverDataset(org.eclipse.rdf4j.model.IRI iri)
                                                            throws it.uniroma2.art.semanticturkey.mdr.core.MetadataDiscoveryException

Discover the metadata for a dataset given an IRI. If discovery is unsuccessful, an exception is thrown.

Parameters:

iri -

Returns:

the newly created dcat:CatalogRecord for the discovered dataset

Throws:

ProjectAccessException

DeniedOperationException

it.uniroma2.art.semanticturkey.mdr.core.MetadataDiscoveryException

exportDatasetVersionMetadata

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public void exportDatasetVersionMetadata(jakarta.servlet.http.HttpServletResponse oRes,
 org.eclipse.rdf4j.model.IRI datasetVersion,
 org.eclipse.rdf4j.rio.RDFFormat outputFormat)
                                  throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException,
IOException

Exports metadata about a dataset version stored in its main graph

Parameters:

oRes -

datasetVersion -

outputFormat -

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

IOException

exportDatasetAbstractionMetadata

@STServiceOperation
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'R\')")
public void exportDatasetAbstractionMetadata(jakarta.servlet.http.HttpServletResponse oRes,
 org.eclipse.rdf4j.model.IRI datasetAbstraction,
 org.eclipse.rdf4j.rio.RDFFormat outputFormat)
                                      throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException,
IOException

Exports metadata about a dataset abstraction stored in its main graph

Parameters:

oRes -

datasetAbstraction -

outputFormat -

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

IOException

importDatasetVersionMetadata

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'U\')")
public void importDatasetVersionMetadata(org.springframework.web.multipart.MultipartFile inputFile,
 org.eclipse.rdf4j.rio.RDFFormat inputFormat,
 org.eclipse.rdf4j.model.IRI datasetVersion)
                                  throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException,
IOException

Imports metadata about a dataset version stored in its main graph

Parameters:

inputFile -

inputFormat -

datasetVersion -

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

IOException

importDatasetAbstractionMetadata

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'U\')")
public void importDatasetAbstractionMetadata(org.springframework.web.multipart.MultipartFile inputFile,
 org.eclipse.rdf4j.rio.RDFFormat inputFormat,
 org.eclipse.rdf4j.model.IRI datasetAbstraction)
                                      throws it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException,
IOException

Imports metadata about a dataset abstraction stored in its main graph

Parameters:

inputFile -

inputFormat -

datasetAbstraction -

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

IOException

bulkSetMainShardsAsNonEditable

@STServiceOperation(method=POST)
@PreAuthorize("@auth.isAuthorized(\'sys(metadataRegistry)\', \'U\')")
public void bulkSetMainShardsAsNonEditable()
                                    throws ProjectAccessException

Bulk change all main shards as non-editable

Throws:

it.uniroma2.art.semanticturkey.mdr.core.MetadataRegistryException

ProjectAccessException