eu.transformproject.provenance.service
public class ProvenanceServer extends java.lang.Object implements ProvenanceServerInterface
Modifier and Type | Field and Description |
---|---|
static int |
ACCOUNT |
static java.lang.String |
ACCOUNT_URI |
static int |
AGENT |
static java.lang.String |
AGENT_URI |
static int |
ANNOTATION |
static java.lang.String |
ANNOTATION_URI |
static int |
ARTIFACT |
static java.lang.String |
ARTIFACT_URI |
static java.lang.String |
defaultAccount |
static int |
DEPENDENCE |
static java.lang.String |
DEPENDENCE_URI |
static java.lang.String[] |
ENTITY_TYPES_STR |
static int |
GRAPH |
static java.lang.String |
GRAPH_URI |
static java.util.Map<java.lang.String,java.lang.String> |
MINIMAL_PROV_ONTO_NAMES
Minimal set of ontologies with their prefixes.
|
static java.util.HashSet<AbstractOnto> |
MINIMAL_PROV_ONTOS |
static java.util.Map<java.lang.String,java.lang.Class> |
opm_uri2class |
java.util.Map<DependenceType,OPMDependenceType> |
opmDependenceTypes
The OPM dependence types.
|
java.util.Map<EntityType,OPMEntityType> |
opmEntityTypes
The OPM entity types.
|
static java.lang.String |
OPMextended_namespace |
static java.lang.String |
OPMO_namespace |
static java.lang.String |
OPMV_namespace |
static int |
PROCESS |
static java.lang.String |
PROCESS_URI |
static java.lang.String |
PROP_TYPE_URI |
static java.lang.String |
PROV_PROCESSSTATUS_ERROR |
static java.lang.String |
PROV_PROCESSSTATUS_OK |
static java.lang.String |
PROV_URI_GRAPH_FOR_PROJECT |
static java.lang.String |
RDF_namespace |
static java.lang.String |
RDFS_namespace |
static java.lang.String |
USED_URI |
static java.lang.String |
WAS_CONTROLLED_BY_URI |
static java.lang.String |
WAS_DERIVED_FROM |
static java.lang.String |
WAS_GENERATED_BY_URI |
static java.lang.String |
WAS_TRIGGERED_BY_URI |
Constructor and Description |
---|
ProvenanceServer() |
ProvenanceServer(ProvenanceServer server) |
ProvenanceServer(ProvenanceStore provConfig) |
ProvenanceServer(java.lang.String zoneName) |
Modifier and Type | Method and Description |
---|---|
java.lang.String |
addAnnotation(OPMEntity entity,
java.lang.String prop,
java.lang.String value) |
java.lang.String |
addAnnotation(java.lang.String uriEntityOrDependence,
java.lang.String owl_prop,
java.lang.String value)
Adds an annotation to an entity or a dependence, owl_prop is the property to annotate which must appear in the ontology profile
(or set of domain-user ontologies) associated to the server, the value associated to the property is value.
|
java.lang.String[] |
addAnnotations(java.lang.String uriEntityOrDependence,
AnnotationSet annotations) |
OPMDependence |
addCausalDependence(OPMEntityNode entityCause,
OPMEntityNode entityEffect) |
java.lang.String |
addCausalDependence(java.lang.String uriEntityCause,
java.lang.String uriEntityDest)
As the previous method but the causal dependences to create must correspond with one of the five defined in \cite{Moreau2010}.
|
java.lang.String |
addCausalDependence(java.lang.String uriEntityCause,
java.lang.String opmo_dependenceClass,
java.lang.String uriEntityDest)
Defines a causal dependence from the entity uriEntityDest to uriEntityCause in the graph idGraph.
|
java.lang.Object[] |
addOPMEntityToGraph(OPMGraph g,
OPMEntity entity) |
OPMEntity |
allowAnnotationUpdating(OPMEntity entity) |
OPMEntityNode |
allowDependenceUpdating(OPMEntityNode entity) |
void |
associateToAccount(java.lang.String uriEntity,
java.lang.String uriAccount)
Specify an account for which an specific OPM entity can be viewed.
|
boolean |
closeFileWriter() |
AnnotationSet |
composeAnnotation(java.lang.String owl_prop,
java.lang.String value)
Create an AnnotationSet object, initialising it with the annotation defined by the pair: owl_prop, value.
|
void |
endProcess(java.lang.String processUri)
Allows to store the date-time in which a process has finalised.
|
void |
endProcessWithStatus(java.lang.String processUri,
java.lang.String processStatus)
Allows to store the date-time in which a process has finalised together with its status.
|
java.util.List |
executeSPARQL_inf(java.lang.String sparql,
boolean toString) |
java.util.List |
executeSPARQL(java.lang.String sparql) |
java.util.List |
executeSQL(java.lang.String sql) |
void |
finalize() |
java.lang.Object |
flushAndRefresh(java.lang.Object object) |
OPMGraph |
getCurrGraph() |
OPMDependenceType |
getDependenceType(DependenceType dtype) |
OPMDependenceType |
getDependenceType(OPMDependence dep) |
OPMEntityType |
getEntityType(EntityType etype) |
OPMEntityType |
getEntityType(OPMEntity etemplate) |
java.lang.String |
getEntityURI(java.lang.String owl_opm_Class,
AnnotationSet annotations)
Generate or retrieve an URI associated to the given parameters.
|
java.lang.Object[] |
getListResults_OPMGraphViewForSPARQLQuery(java.lang.String sparql,
int pathlenght) |
java.lang.Object[] |
getListResults_OPMGraphViewForSQLQuery(java.lang.String sql,
int pathlenght) |
OPMEntity |
getOPMEntity(java.lang.String entityURI)
Recover an OPMEntity given its URI.
|
OPMEntity |
getOPMEntityWithValue(java.lang.String value) |
java.lang.String |
getOPMGraphForProject(java.lang.String projectName)
If it exists a graph associated to this project name, this method returns it, otherwise,
it creates a new graph, and adds to it an annotation associating it with a project.
|
OPMGraph |
getOPMGraphViewForEntities(java.util.HashSet<java.lang.String> entityURIs,
int pathlenght,
java.util.HashMap<java.lang.String,java.lang.Object> cloneMap) |
OPMGraph |
getOPMGraphViewForOPMEntity(java.lang.String entityURI,
int pathlenght) |
java.lang.String |
getProjectNameOfEntity(java.lang.String entityURI) |
Property |
getProperty(java.lang.String prop) |
ProvenanceStore |
getProvConfig() |
static ProvenanceServer |
getRemoteInstance(java.lang.String serverURL,
java.lang.String serverName) |
static ProvenanceServer |
getSimpleInstance(ProvenanceStore provConfig) |
java.util.Set<java.lang.String> |
getSurroundNodes(java.lang.String entityURI,
int pathlenght) |
java.lang.String |
getSVGOPMGraphViewForEntities(java.util.HashSet<java.lang.String> entityURIs,
int pathlenght) |
java.util.Date |
getSyncTime() |
java.lang.String |
getTable_SVGViewForQuery(java.lang.String query,
int pathlenght,
boolean isSparql) |
java.lang.String |
getTable_SVGViewForQueryAndHighlight(java.lang.String query,
int pathlenght,
boolean isSparql,
java.lang.String e_uri) |
java.lang.String |
getURI(OPMDependenceType depType) |
java.lang.String |
getURI(OPMEntity entity) |
java.lang.String |
getURI(OPMEntityType entityType) |
static ProvenanceServer |
getWebServiceInstance(java.lang.String serverURL,
java.lang.String serverName) |
static void |
main(java.lang.String[] args) |
java.lang.String |
newGraph()
Adds a new graph in the provenance store.
|
boolean |
openFileWriter(java.lang.String fileName) |
void |
printResults(java.util.List results) |
void |
setCurrentGraph(java.lang.String idGraph)
Specify that all the new entity definitions belong to the OPM graph with URI idGraph.
|
void |
setId(java.lang.String entityUri,
java.lang.String newId) |
void |
setProcessEndAt(java.lang.String processUri,
java.util.Date timeEnd) |
void |
setProcessStartAt(java.lang.String processUri,
java.util.Date timeStart) |
void |
setProcessStatus(java.lang.String processUri,
java.lang.String processStatus)
Allows to set the status of a process.
|
void |
showGraph(OPMGraph g) |
boolean |
writeToFile(java.io.Writer writer) |
public static final java.lang.String OPMO_namespace
public static final java.lang.String OPMV_namespace
public static final java.lang.String OPMextended_namespace
public static final java.lang.String RDF_namespace
public static final java.lang.String RDFS_namespace
public static java.util.Map<java.lang.String,java.lang.String> MINIMAL_PROV_ONTO_NAMES
public static java.util.HashSet<AbstractOnto> MINIMAL_PROV_ONTOS
public static final java.lang.String PROCESS_URI
public static final java.lang.String ARTIFACT_URI
public static final java.lang.String AGENT_URI
public static final java.lang.String DEPENDENCE_URI
public static final java.lang.String ACCOUNT_URI
public static final java.lang.String ANNOTATION_URI
public static final java.lang.String GRAPH_URI
public static final java.lang.String USED_URI
public static final java.lang.String WAS_GENERATED_BY_URI
public static final java.lang.String WAS_CONTROLLED_BY_URI
public static final java.lang.String WAS_TRIGGERED_BY_URI
public static final java.lang.String WAS_DERIVED_FROM
public static final java.lang.String PROP_TYPE_URI
public static final java.lang.String defaultAccount
public static final java.lang.String PROV_URI_GRAPH_FOR_PROJECT
public static final java.lang.String PROV_PROCESSSTATUS_OK
public static final java.lang.String PROV_PROCESSSTATUS_ERROR
public static final java.util.Map<java.lang.String,java.lang.Class> opm_uri2class
public static final int ARTIFACT
public static final int PROCESS
public static final int AGENT
public static final int DEPENDENCE
public static final int ACCOUNT
public static final int ANNOTATION
public static final int GRAPH
public static final java.lang.String[] ENTITY_TYPES_STR
public java.util.Map<EntityType,OPMEntityType> opmEntityTypes
public java.util.Map<DependenceType,OPMDependenceType> opmDependenceTypes
public ProvenanceServer()
public ProvenanceServer(java.lang.String zoneName) throws org.hibernate.MappingException, java.lang.Exception
org.hibernate.MappingException
java.lang.Exception
public ProvenanceServer(ProvenanceStore provConfig) throws org.hibernate.MappingException, java.lang.Exception
org.hibernate.MappingException
java.lang.Exception
public ProvenanceServer(ProvenanceServer server) throws org.hibernate.MappingException, java.lang.Exception
org.hibernate.MappingException
java.lang.Exception
public ProvenanceStore getProvConfig()
public java.util.Date getSyncTime() throws java.lang.Exception
getSyncTime
in interface ProvenanceStorageInterface
java.lang.Exception
public java.lang.String newGraph() throws java.lang.Exception
ProvenanceStorageInterface
newGraph
in interface ProvenanceStorageInterface
java.lang.Exception
public java.lang.String getEntityURI(java.lang.String owl_opm_Class, AnnotationSet annotations) throws java.lang.Exception
ProvenanceStorageInterface
getEntityURI
in interface ProvenanceStorageInterface
owl_opm_Class
- class to which the opm entity belongsannotations
- annotations associated to the entity to create/retrievejava.lang.Exception
public java.lang.String addCausalDependence(java.lang.String uriEntityCause, java.lang.String opmo_dependenceClass, java.lang.String uriEntityDest) throws java.lang.Exception
ProvenanceStorageInterface
addCausalDependence
in interface ProvenanceStorageInterface
java.lang.Exception
public java.lang.String addCausalDependence(java.lang.String uriEntityCause, java.lang.String uriEntityDest) throws java.lang.Exception
ProvenanceStorageInterface
addCausalDependence
in interface ProvenanceStorageInterface
java.lang.Exception
public java.lang.String addAnnotation(java.lang.String uriEntityOrDependence, java.lang.String owl_prop, java.lang.String value) throws java.lang.Exception
ProvenanceStorageInterface
addAnnotation
in interface ProvenanceStorageInterface
java.lang.Exception
public java.lang.String[] addAnnotations(java.lang.String uriEntityOrDependence, AnnotationSet annotations) throws java.lang.Exception
addAnnotations
in interface ProvenanceStorageInterface
java.lang.Exception
public java.lang.String addAnnotation(OPMEntity entity, java.lang.String prop, java.lang.String value) throws java.lang.Exception
java.lang.Exception
public void associateToAccount(java.lang.String uriEntity, java.lang.String uriAccount) throws java.lang.Exception
ProvenanceStorageInterface
associateToAccount
in interface ProvenanceStorageInterface
uriEntity
- OPM entity URI of the entity to associate to the accounturiAccount
- OPM Account URI for the OPM entity.java.lang.Exception
public boolean openFileWriter(java.lang.String fileName)
public boolean writeToFile(java.io.Writer writer) throws NoOpenFileWriterInServer
NoOpenFileWriterInServer
public boolean closeFileWriter() throws NoOpenFileWriterInServer
NoOpenFileWriterInServer
public static ProvenanceServer getSimpleInstance(ProvenanceStore provConfig) throws org.hibernate.MappingException, java.lang.Exception
org.hibernate.MappingException
java.lang.Exception
public static ProvenanceServer getRemoteInstance(java.lang.String serverURL, java.lang.String serverName) throws ProvenanceServerConnectionException
public static ProvenanceServer getWebServiceInstance(java.lang.String serverURL, java.lang.String serverName)
public java.util.List executeSQL(java.lang.String sql)
executeSQL
in interface ProvenanceQueryInterface
public java.util.List executeSPARQL(java.lang.String sparql)
executeSPARQL
in interface ProvenanceQueryInterface
public java.util.List executeSPARQL_inf(java.lang.String sparql, boolean toString)
public java.util.Set<java.lang.String> getSurroundNodes(java.lang.String entityURI, int pathlenght)
public java.lang.Object[] getListResults_OPMGraphViewForSQLQuery(java.lang.String sql, int pathlenght) throws java.lang.Exception
java.lang.Exception
public java.lang.Object[] getListResults_OPMGraphViewForSPARQLQuery(java.lang.String sparql, int pathlenght) throws java.lang.Exception
java.lang.Exception
public OPMGraph getOPMGraphViewForOPMEntity(java.lang.String entityURI, int pathlenght) throws java.lang.Exception
java.lang.Exception
public java.lang.String getSVGOPMGraphViewForEntities(java.util.HashSet<java.lang.String> entityURIs, int pathlenght) throws java.lang.Exception
java.lang.Exception
public java.lang.String getTable_SVGViewForQuery(java.lang.String query, int pathlenght, boolean isSparql) throws java.lang.Exception
getTable_SVGViewForQuery
in interface ProvenanceQueryInterface
java.lang.Exception
public java.lang.String getTable_SVGViewForQueryAndHighlight(java.lang.String query, int pathlenght, boolean isSparql, java.lang.String e_uri) throws java.lang.Exception
getTable_SVGViewForQueryAndHighlight
in interface ProvenanceQueryInterface
java.lang.Exception
public void setCurrentGraph(java.lang.String idGraph) throws java.lang.Exception
ProvenanceStorageInterface
setCurrentGraph
in interface ProvenanceStorageInterface
idGraph
- URI of the graph for all new declared entities.java.lang.Exception
public void printResults(java.util.List results)
public java.lang.String getOPMGraphForProject(java.lang.String projectName) throws java.lang.Exception
ProvenanceStorageInterface
getOPMGraphForProject
in interface ProvenanceStorageInterface
projectName
- name of the project described by the created graph.java.lang.Exception
public java.lang.String getProjectNameOfEntity(java.lang.String entityURI) throws java.lang.Exception
java.lang.Exception
public void endProcess(java.lang.String processUri) throws java.lang.Exception
ProvenanceStorageInterface
endProcess
in interface ProvenanceStorageInterface
processUri
- the process that has finishedjava.lang.Exception
public void setProcessStatus(java.lang.String processUri, java.lang.String processStatus) throws java.lang.Exception
ProvenanceStorageInterface
setProcessStatus
in interface ProvenanceStorageInterface
processStatus
- string representing the status of a process. Only the current status of a process is maintained.
In future versions, other status annotations would be maintained at different times.java.lang.Exception
public AnnotationSet composeAnnotation(java.lang.String owl_prop, java.lang.String value) throws java.lang.Exception
ProvenanceStorageInterface
composeAnnotation
in interface ProvenanceStorageInterface
java.lang.Exception
public void endProcessWithStatus(java.lang.String processUri, java.lang.String processStatus) throws java.lang.Exception
ProvenanceStorageInterface
endProcessWithStatus
in interface ProvenanceStorageInterface
processUri
- the process that has finishedprocessStatus
- status of the process that has finishedjava.lang.Exception
public void setProcessStartAt(java.lang.String processUri, java.util.Date timeStart) throws java.lang.Exception
setProcessStartAt
in interface ProvenanceStorageInterface
java.lang.Exception
public void setProcessEndAt(java.lang.String processUri, java.util.Date timeEnd) throws java.lang.Exception
setProcessEndAt
in interface ProvenanceStorageInterface
java.lang.Exception
public OPMGraph getCurrGraph() throws java.lang.Exception
getCurrGraph
in interface ProvenanceStorageInterface
java.lang.Exception
public OPMEntity getOPMEntity(java.lang.String entityURI) throws java.lang.Exception
ProvenanceStorageInterface
getOPMEntity
in interface ProvenanceStorageInterface
entityURI
- URI of the entity to recover.java.lang.Exception
public java.lang.Object flushAndRefresh(java.lang.Object object) throws java.lang.Exception
flushAndRefresh
in interface ProvenanceStorageInterface
java.lang.Exception
public java.lang.String getURI(OPMEntity entity)
public java.lang.String getURI(OPMEntityType entityType) throws java.lang.Exception
java.lang.Exception
public java.lang.String getURI(OPMDependenceType depType) throws java.lang.Exception
java.lang.Exception
public void setId(java.lang.String entityUri, java.lang.String newId) throws java.lang.Exception
java.lang.Exception
public OPMDependence addCausalDependence(OPMEntityNode entityCause, OPMEntityNode entityEffect) throws java.lang.Exception
java.lang.Exception
public Property getProperty(java.lang.String prop) throws java.lang.Exception
java.lang.Exception
public java.lang.Object[] addOPMEntityToGraph(OPMGraph g, OPMEntity entity) throws java.lang.Exception
java.lang.Exception
public OPMEntityType getEntityType(OPMEntity etemplate)
public OPMEntityType getEntityType(EntityType etype)
public OPMDependenceType getDependenceType(DependenceType dtype)
public OPMDependenceType getDependenceType(OPMDependence dep)
public void finalize() throws java.sql.SQLException
finalize
in class java.lang.Object
java.sql.SQLException
public static void main(java.lang.String[] args) throws java.lang.Exception
java.lang.Exception
public void showGraph(OPMGraph g)
public OPMEntity getOPMEntityWithValue(java.lang.String value)
public OPMEntityNode allowDependenceUpdating(OPMEntityNode entity)
public OPMGraph getOPMGraphViewForEntities(java.util.HashSet<java.lang.String> entityURIs, int pathlenght, java.util.HashMap<java.lang.String,java.lang.Object> cloneMap) throws java.lang.Exception
java.lang.Exception