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

Class XKOS

java.lang.Object

it.uniroma2.art.semanticturkey.services.STServiceAdapter

it.uniroma2.art.semanticturkey.services.core.XKOS

All Implemented Interfaces:

NewerNewStyleService, STService

@STService
public class XKOS
extends STServiceAdapter

Field Summary

Fields

Modifier and Type	Field	Description
protected static org.slf4j.Logger	logger

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

applicationEventPublisher, cfManager, exptManager, stServiceContext

Constructor Summary

Constructors

Constructor	Description
XKOS()

Method Summary

Modifier and Type	Method	Description
void	exportAssociations(jakarta.servlet.http.HttpServletResponse oRes, org.eclipse.rdf4j.model.IRI correspondence, org.eclipse.rdf4j.rio.RDFFormat format)
Collection<AnnotatedValue<org.eclipse.rdf4j.model.Resource>>	filterAssociations(org.eclipse.rdf4j.model.IRI correspondence, boolean assConcepts, int assConcepsLimit, String searchString, boolean useLexicalizations, boolean useLocalName, boolean useURI, SearchMode searchMode, boolean useNotes, List<String> langs, boolean includeLocales, boolean searchInRDFSLabel, boolean searchInSKOSLabel, boolean searchInSKOSXLLabel, boolean searchInOntolex)	This returns the associations for a given correspondence by filtering them according to the matching concept in the xkos:sourceConcept
Collection<AnnotatedValue<org.eclipse.rdf4j.model.Resource>>	getAssociations(org.eclipse.rdf4j.model.IRI correspondence, boolean assConcepts, int assConcepsLimit)	This returns the associations for a given correspondence.
Collection<AnnotatedValue<org.eclipse.rdf4j.model.Resource>>	getCorrespondences(boolean numAss)	Returns the list of Correspondences (e.g. instances of the class xkos:Correspondence) and, optionally, the number of elements that are associated to each Correspondence with the property xkos:madeOf
Collection<AnnotatedValue<org.eclipse.rdf4j.model.Resource>>	getSingleAssociation(org.eclipse.rdf4j.model.IRI association)

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

addValue, checkNotLocallyDefined, createQueryBuilder, generateIRI, generateNatureSPARQLSelectPart, generateNatureSPARQLWherePart, generateResourceWithCustomConstructor, getCodaLexModeForSearchFromLexicalizationModel, getDeleteGraph, getGraphFromNature, getInitializedCodaCore, getManagedConnection, getMetadataGraph, getOptionalProject, 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

Field Details

logger

protected static org.slf4j.Logger logger

Constructor Details

XKOS

public XKOS()

Method Details

getCorrespondences

@STServiceOperation
@Read
@PreAuthorize("@auth.isAuthorized(\'rdf(resource, alignment)\', \'R\')")
public Collection<AnnotatedValue<org.eclipse.rdf4j.model.Resource>> getCorrespondences(@Optional(defaultValue="true")
 boolean numAss)

Returns the list of Correspondences (e.g. instances of the class xkos:Correspondence) and, optionally, the number of elements that are associated to each Correspondence with the property xkos:madeOf

Parameters:

numAss - true to get the number of elements in each Correspondence (using the property xkos:madeOf)

Returns:

getAssociations

@STServiceOperation
@Read
@PreAuthorize("@auth.isAuthorized(\'rdf(resource, alignment)\', \'R\')")
public Collection<AnnotatedValue<org.eclipse.rdf4j.model.Resource>> getAssociations(@LocallyDefined
 org.eclipse.rdf4j.model.IRI correspondence,
 @Optional(defaultValue="true")
 boolean assConcepts,
 @Optional(defaultValue="5")
 int assConcepsLimit)

This returns the associations for a given correspondence. As associations, on average, hold just one concept per side, the assConcepts parameter (defaulted to true) adds the concepts as annotations for the annotated value. As an annotation could even hold hundreds of concepts (yet not usually), a certain syntax is used to represent all URIs in the source/targetConcept properties. The syntax is: <http:...> single URI [<http:...>, <http:...>, <http:...>] for multiple URIs {<http:...>, <http:...>, <http:...>} for multiple URIs where the number exceeds assConceptsLimit and thus it is clear that the list is incomplete (it contains only a number of URIs = assConceptsLimit) so from the first bracket it is clear if there are multiple URIs.

Parameters:

correspondence -

assConcepts -

assConcepsLimit -

Returns:

getSingleAssociation

@STServiceOperation
@Read
@PreAuthorize("@auth.isAuthorized(\'rdf(resource, alignment)\', \'R\')")
public Collection<AnnotatedValue<org.eclipse.rdf4j.model.Resource>> getSingleAssociation(@LocallyDefined
 org.eclipse.rdf4j.model.IRI association)

exportAssociations

@STServiceOperation
@Read
@PreAuthorize("@auth.isAuthorized(\'rdf(resource, alignment)\', \'R\')")
public void exportAssociations(jakarta.servlet.http.HttpServletResponse oRes,
 @Optional
 org.eclipse.rdf4j.model.IRI correspondence,
 @Optional(defaultValue="TURTLE")
 org.eclipse.rdf4j.rio.RDFFormat format)
                        throws IOException

Throws:

IOException

filterAssociations

@STServiceOperation
@Read
@PreAuthorize("@auth.isAuthorized(\'rdf(resource, alignment)\', \'R\')")
public Collection<AnnotatedValue<org.eclipse.rdf4j.model.Resource>> filterAssociations(@LocallyDefined
 org.eclipse.rdf4j.model.IRI correspondence,
 @Optional(defaultValue="true")
 boolean assConcepts,
 @Optional(defaultValue="5")
 int assConcepsLimit,
 @Optional
 String searchString,
 @Optional(defaultValue="true")
 boolean useLexicalizations,
 @Optional(defaultValue="false")
 boolean useLocalName,
 @Optional(defaultValue="false")
 boolean useURI,
 SearchMode searchMode,
 @Optional(defaultValue="false")
 boolean useNotes,
 @Optional
 List<String> langs,
 @Optional(defaultValue="false")
 boolean includeLocales,
 @Optional(defaultValue="false")
 boolean searchInRDFSLabel,
 @Optional(defaultValue="false")
 boolean searchInSKOSLabel,
 @Optional(defaultValue="false")
 boolean searchInSKOSXLLabel,
 @Optional(defaultValue="false")
 boolean searchInOntolex)
                                                                                throws SearchStatusException,
STPropertyAccessException

This returns the associations for a given correspondence by filtering them according to the matching concept in the xkos:sourceConcept

Parameters:

searchString -

useLexicalizations -

useLocalName -

useURI -

searchMode -

useNotes -

langs -

includeLocales -

searchInRDFSLabel -

searchInSKOSLabel -

searchInSKOSXLLabel -

searchInOntolex -

Returns:

Throws:

SearchStatusException

STPropertyAccessException