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.MappingExceptionjava.lang.Exceptionpublic ProvenanceServer(ProvenanceStore provConfig) throws org.hibernate.MappingException, java.lang.Exception
org.hibernate.MappingExceptionjava.lang.Exceptionpublic ProvenanceServer(ProvenanceServer server) throws org.hibernate.MappingException, java.lang.Exception
org.hibernate.MappingExceptionjava.lang.Exceptionpublic ProvenanceStore getProvConfig()
public java.util.Date getSyncTime()
throws java.lang.Exception
getSyncTime in interface ProvenanceStorageInterfacejava.lang.Exceptionpublic java.lang.String newGraph()
throws java.lang.Exception
ProvenanceStorageInterfacenewGraph in interface ProvenanceStorageInterfacejava.lang.Exceptionpublic java.lang.String getEntityURI(java.lang.String owl_opm_Class,
AnnotationSet annotations)
throws java.lang.Exception
ProvenanceStorageInterfacegetEntityURI in interface ProvenanceStorageInterfaceowl_opm_Class - class to which the opm entity belongsannotations - annotations associated to the entity to create/retrievejava.lang.Exceptionpublic java.lang.String addCausalDependence(java.lang.String uriEntityCause,
java.lang.String opmo_dependenceClass,
java.lang.String uriEntityDest)
throws java.lang.Exception
ProvenanceStorageInterfaceaddCausalDependence in interface ProvenanceStorageInterfacejava.lang.Exceptionpublic java.lang.String addCausalDependence(java.lang.String uriEntityCause,
java.lang.String uriEntityDest)
throws java.lang.Exception
ProvenanceStorageInterfaceaddCausalDependence in interface ProvenanceStorageInterfacejava.lang.Exceptionpublic java.lang.String addAnnotation(java.lang.String uriEntityOrDependence,
java.lang.String owl_prop,
java.lang.String value)
throws java.lang.Exception
ProvenanceStorageInterfaceaddAnnotation in interface ProvenanceStorageInterfacejava.lang.Exceptionpublic java.lang.String[] addAnnotations(java.lang.String uriEntityOrDependence,
AnnotationSet annotations)
throws java.lang.Exception
addAnnotations in interface ProvenanceStorageInterfacejava.lang.Exceptionpublic java.lang.String addAnnotation(OPMEntity entity, java.lang.String prop, java.lang.String value) throws java.lang.Exception
java.lang.Exceptionpublic void associateToAccount(java.lang.String uriEntity,
java.lang.String uriAccount)
throws java.lang.Exception
ProvenanceStorageInterfaceassociateToAccount in interface ProvenanceStorageInterfaceuriEntity - OPM entity URI of the entity to associate to the accounturiAccount - OPM Account URI for the OPM entity.java.lang.Exceptionpublic boolean openFileWriter(java.lang.String fileName)
public boolean writeToFile(java.io.Writer writer)
throws NoOpenFileWriterInServer
NoOpenFileWriterInServerpublic boolean closeFileWriter()
throws NoOpenFileWriterInServer
NoOpenFileWriterInServerpublic static ProvenanceServer getSimpleInstance(ProvenanceStore provConfig) throws org.hibernate.MappingException, java.lang.Exception
org.hibernate.MappingExceptionjava.lang.Exceptionpublic 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 ProvenanceQueryInterfacepublic java.util.List executeSPARQL(java.lang.String sparql)
executeSPARQL in interface ProvenanceQueryInterfacepublic 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.Exceptionpublic java.lang.Object[] getListResults_OPMGraphViewForSPARQLQuery(java.lang.String sparql,
int pathlenght)
throws java.lang.Exception
java.lang.Exceptionpublic OPMGraph getOPMGraphViewForOPMEntity(java.lang.String entityURI, int pathlenght) throws java.lang.Exception
java.lang.Exceptionpublic java.lang.String getSVGOPMGraphViewForEntities(java.util.HashSet<java.lang.String> entityURIs,
int pathlenght)
throws java.lang.Exception
java.lang.Exceptionpublic java.lang.String getTable_SVGViewForQuery(java.lang.String query,
int pathlenght,
boolean isSparql)
throws java.lang.Exception
getTable_SVGViewForQuery in interface ProvenanceQueryInterfacejava.lang.Exceptionpublic 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 ProvenanceQueryInterfacejava.lang.Exceptionpublic void setCurrentGraph(java.lang.String idGraph)
throws java.lang.Exception
ProvenanceStorageInterfacesetCurrentGraph in interface ProvenanceStorageInterfaceidGraph - URI of the graph for all new declared entities.java.lang.Exceptionpublic void printResults(java.util.List results)
public java.lang.String getOPMGraphForProject(java.lang.String projectName)
throws java.lang.Exception
ProvenanceStorageInterfacegetOPMGraphForProject in interface ProvenanceStorageInterfaceprojectName - name of the project described by the created graph.java.lang.Exceptionpublic java.lang.String getProjectNameOfEntity(java.lang.String entityURI)
throws java.lang.Exception
java.lang.Exceptionpublic void endProcess(java.lang.String processUri)
throws java.lang.Exception
ProvenanceStorageInterfaceendProcess in interface ProvenanceStorageInterfaceprocessUri - the process that has finishedjava.lang.Exceptionpublic void setProcessStatus(java.lang.String processUri,
java.lang.String processStatus)
throws java.lang.Exception
ProvenanceStorageInterfacesetProcessStatus in interface ProvenanceStorageInterfaceprocessStatus - 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.Exceptionpublic AnnotationSet composeAnnotation(java.lang.String owl_prop, java.lang.String value) throws java.lang.Exception
ProvenanceStorageInterfacecomposeAnnotation in interface ProvenanceStorageInterfacejava.lang.Exceptionpublic void endProcessWithStatus(java.lang.String processUri,
java.lang.String processStatus)
throws java.lang.Exception
ProvenanceStorageInterfaceendProcessWithStatus in interface ProvenanceStorageInterfaceprocessUri - the process that has finishedprocessStatus - status of the process that has finishedjava.lang.Exceptionpublic void setProcessStartAt(java.lang.String processUri,
java.util.Date timeStart)
throws java.lang.Exception
setProcessStartAt in interface ProvenanceStorageInterfacejava.lang.Exceptionpublic void setProcessEndAt(java.lang.String processUri,
java.util.Date timeEnd)
throws java.lang.Exception
setProcessEndAt in interface ProvenanceStorageInterfacejava.lang.Exceptionpublic OPMGraph getCurrGraph() throws java.lang.Exception
getCurrGraph in interface ProvenanceStorageInterfacejava.lang.Exceptionpublic OPMEntity getOPMEntity(java.lang.String entityURI) throws java.lang.Exception
ProvenanceStorageInterfacegetOPMEntity in interface ProvenanceStorageInterfaceentityURI - URI of the entity to recover.java.lang.Exceptionpublic java.lang.Object flushAndRefresh(java.lang.Object object)
throws java.lang.Exception
flushAndRefresh in interface ProvenanceStorageInterfacejava.lang.Exceptionpublic java.lang.String getURI(OPMEntity entity)
public java.lang.String getURI(OPMEntityType entityType) throws java.lang.Exception
java.lang.Exceptionpublic java.lang.String getURI(OPMDependenceType depType) throws java.lang.Exception
java.lang.Exceptionpublic void setId(java.lang.String entityUri,
java.lang.String newId)
throws java.lang.Exception
java.lang.Exceptionpublic OPMDependence addCausalDependence(OPMEntityNode entityCause, OPMEntityNode entityEffect) throws java.lang.Exception
java.lang.Exceptionpublic Property getProperty(java.lang.String prop) throws java.lang.Exception
java.lang.Exceptionpublic java.lang.Object[] addOPMEntityToGraph(OPMGraph g, OPMEntity entity) throws java.lang.Exception
java.lang.Exceptionpublic 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.Objectjava.sql.SQLExceptionpublic static void main(java.lang.String[] args)
throws java.lang.Exception
java.lang.Exceptionpublic 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