@Path(value="/") @DeclareRoles(value={"ROLE_tavernauser","ROLE_tavernasuperuser"}) @WSDLDocumentation(value="An instance of Taverna 3.1.0 Server.") public abstract class TavernaServer extends Object implements TavernaServerSOAP, TavernaServerREST, TavernaServerBean
TavernaServerREST.EnabledNotificationFabrics, TavernaServerREST.EventFeed, TavernaServerREST.PathNames, TavernaServerREST.PermittedListeners, TavernaServerREST.PermittedWorkflows, TavernaServerREST.PolicyView, TavernaServerREST.RunList, TavernaServerREST.ServerDescription, TavernaServerREST.WorkflowReference
Modifier and Type | Field and Description |
---|---|
static String |
JMX_ROOT
The root of descriptions of the server in JMX.
|
org.apache.commons.logging.Log |
log
The logger for the server framework.
|
Constructor and Description |
---|
TavernaServer() |
Modifier and Type | Method and Description |
---|---|
String |
addRunListener(String runName,
String listenerType,
String configuration)
Adds an event listener to the run.
|
void |
deleteRunCertificates(String runName,
String certificateID)
Delete a certificate collection associated with the run.
|
void |
deleteRunCredential(String runName,
String credentialID)
Delete a credential associated with the run.
|
TavernaServerREST.ServerDescription |
describeService(javax.ws.rs.core.UriInfo ui)
Produces the description of the service.
|
void |
destroyRun(String runName)
Destroy a run immediately.
|
void |
destroyRunDirectoryEntry(String runName,
DirEntry d)
Destroy an entry (file or directory) in or beneath a run's working
directory.
|
javax.ws.rs.core.UriBuilder |
getBaseUriBuilder() |
abstract TavernaServerREST.PolicyView |
getPolicyDescription() |
FileContents |
getRunBundle(String runName)
Returns the run bundle of a run.
|
Trust[] |
getRunCertificates(String runName)
Get the certificate collections associated with the run.
|
Date |
getRunCreationTime(String runName)
Get the time when the run was created.
|
Credential[] |
getRunCredentials(String runName)
Get the credentials associated with the run.
|
String |
getRunDescriptiveName(String runName)
Get the descriptive name of the workflow run.
|
byte[] |
getRunDirectoryAsZip(String runName,
DirEntry d)
Get the contents of any directory (and its subdirectories) at/under the
run's working directory, returning it as a compressed ZIP file.
|
ZippedDirectory |
getRunDirectoryAsZipMTOM(String runName,
DirEntry d)
Get the contents of any directory (and its subdirectories) at/under the
run's working directory, returning it as a compressed ZIP file that is
streamed via MTOM.
|
DirEntry[] |
getRunDirectoryContents(String runName,
DirEntry d)
Get the contents of any directory at/under the run's working directory.
|
Date |
getRunExpiry(String runName)
Get the time when the run will be eligible to be automatically deleted.
|
byte[] |
getRunFileContents(String runName,
DirEntry d)
Get the contents of a file under the run's working directory.
|
FileContents |
getRunFileContentsMTOM(String runName,
DirEntry d)
Get the contents of a file under the run's working directory via MTOM.
|
long |
getRunFileLength(String runName,
DirEntry d)
Get the length of any file (in bytes) at/under the run's working
directory.
|
Date |
getRunFileModified(String runName,
DirEntry d)
Get the time that the file or directory (at/under the run's working
directory) was last modified.
|
String |
getRunFileType(String runName,
DirEntry d)
Get the content type of any file at/under the run's working directory.
|
Date |
getRunFinishTime(String runName)
Get the time when the run was detected as having finished.
|
boolean |
getRunGenerateProvenance(String runName)
Gets whether to generate provenance (in a run bundle) for a run.
|
InputDescription |
getRunInputDescriptor(String runName)
Get a description of what inputs the workflow run expects to
receive.
|
InputDescription |
getRunInputs(String runName)
Get the description of the inputs to the workflow run.
|
String |
getRunListenerConfiguration(String runName,
String listenerName)
Get the configuration document for an event listener attached to a run.
|
String[] |
getRunListenerProperties(String runName,
String listenerName)
Get the list of properties supported by an event listener attached to a
run.
|
String |
getRunListenerProperty(String runName,
String listenerName,
String propName)
Get the value of a property for an event listener attached to a run.
|
String[] |
getRunListeners(String runName)
Get the names of the event listeners attached to the run.
|
String |
getRunLog(String runName)
Returns the log of the workflow run.
|
String |
getRunOutputBaclavaFile(String runName)
Get the Baclava file where the output of the run will be written.
|
OutputDescription |
getRunOutputDescription(String runName)
Return a description of the outputs of a run.
|
String |
getRunOwner(String runName)
Get the owner of the run.
|
TavernaServerRunREST |
getRunResource(String runName,
javax.ws.rs.core.UriInfo ui)
Get a particular named run resource.
|
Date |
getRunStartTime(String runName)
Get the time when the run was started.
|
Status |
getRunStatus(String runName)
Get the current status of the run.
|
String |
getRunStderr(String runName)
Returns the standard error of the workflow run.
|
String |
getRunStdout(String runName)
Returns the standard output of the workflow run.
|
javax.ws.rs.core.UriBuilder |
getRunUriBuilder(TavernaRun run)
Given a run, get a factory for RESTful URIs to resources associated
with it.
|
JobUsageRecord |
getRunUsageRecord(String runName)
Returns the usage record for the workflow run.
|
Workflow |
getRunWorkflow(String runName)
Get the workflow document used to create the given run.
|
WrappedWorkflow |
getRunWorkflowMTOM(String runName)
Get the workflow document used to create the given run.
|
ProfileList |
getRunWorkflowProfiles(String runName)
Get a description of the profiles supported by the workflow document used
to create the given run.
|
List<Capability> |
getServerCapabilities() |
String[] |
getServerListeners()
Get the list of allowed event listeners.
|
int |
getServerMaxRuns()
Get the upper limit on the number of runs that the user may create at
once.
|
String[] |
getServerNotifiers()
Get the list of notification fabrics.
|
String |
getServerStatus()
Gets the status of the server.
|
URI[] |
getServerWorkflows()
Get the list of allowed workflows.
|
boolean |
initObsoleteRESTSecurity(TavernaSecurityContext c)
The nastier parts of security initialisation in REST calls, which we want
to go away.
|
boolean |
initObsoleteSOAPSecurity(TavernaSecurityContext c)
The nastier parts of security initialisation in SOAP calls, which we want
to go away.
|
PermissionList |
listRunPermissions(String runName)
Get the list of permissions associated with a workflow run.
|
RunReference[] |
listRuns()
Get the list of existing runs owned by the user.
|
TavernaServerREST.RunList |
listUsersRuns(javax.ws.rs.core.UriInfo ui)
Produces a description of the list of runs.
|
DirEntry |
makeRunDirectory(String runName,
DirEntry parent,
String name)
Make a new empty directory beneath an existing one, which must be the
run's working directory or a directory beneath it.
|
DirEntry |
makeRunFile(String runName,
DirEntry parent,
String name)
Make a new empty file in an existing directory, which may be the run's
working directory or any directory beneath it.
|
protected abstract org.apache.taverna.server.master.RunREST |
makeRunInterface()
Construct a RESTful interface to a run.
|
String |
resolve(String uri)
Resolves a URI with respect to the base URI of the factory.
|
javax.ws.rs.core.Response |
runsOptions()
Get an outline of the operations supported.
|
javax.ws.rs.core.Response |
serviceOptions()
Get an outline of the operations supported.
|
void |
setContentsDescriptorBuilder(ContentsDescriptorBuilder cdBuilder) |
void |
setEventSource(EventDAO eventSource) |
void |
setFileUtils(FilenameUtils converter) |
void |
setInteractionFeed(String interactionFeed)
The location of a service-wide interaction feed, derived from a
properties file.
|
void |
setNotificationEngine(NotificationEngine notificationEngine) |
void |
setPolicy(Policy policy) |
String |
setRunCertificates(String runName,
String certificateID,
Trust certificate)
Set a certificate collection associated with the run.
|
String |
setRunCredential(String runName,
String credentialID,
Credential credential)
Set a credential associated with the run.
|
void |
setRunDescriptiveName(String runName,
String descriptiveName)
Set the descriptive name of the workflow run.
|
void |
setRunExpiry(String runName,
Date d)
Set when the run will be eligible to be automatically deleted.
|
void |
setRunFileContents(String runName,
DirEntry d,
byte[] newContents)
Set the contents of a file under the run's working directory.
|
void |
setRunFileContentsFromURI(String runName,
DirEntryReference file,
URI reference)
Set the contents of a file under the run's working directory to the
contents of a publicly readable URI.
|
void |
setRunFileContentsMTOM(String runName,
FileContents newContents)
Set the contents of a file under the run's working directory.
|
void |
setRunGenerateProvenance(String runName,
boolean generate)
Sets whether to generate provenance (in a run bundle) for a run.
|
void |
setRunInputBaclavaFile(String runName,
String fileName)
Tells the run to use the given Baclava file for all inputs.
|
void |
setRunInputPortFile(String runName,
String portName,
String portFilename)
Tells the run to use the given file for input on the given port.
|
void |
setRunInputPortListDelimiter(String runName,
String portName,
String delimiter)
Tells the given run to use the given list delimiter (a single-character
string value) for splitting the input on the given port.
|
void |
setRunInputPortValue(String runName,
String portName,
String portValue)
Tells the run to use the given value for input on the given port.
|
void |
setRunListenerProperty(String runName,
String listenerName,
String propName,
String value)
Set the value of a property for an event listener attached to a run.
|
void |
setRunOutputBaclavaFile(String runName,
String outputFile)
Set the Baclava file where the output of the run will be written.
|
void |
setRunPermission(String runName,
String userName,
Permission permission)
Set the permission for a user to access and update a particular workflow
run.
|
String |
setRunStatus(String runName,
Status s)
Set the status of a run.
|
void |
setRunStore(RunStore runStore) |
void |
setSupport(TavernaServerSupport support) |
RunReference |
submitWorkflow(Workflow workflow)
Make a run for a particular workflow.
|
javax.ws.rs.core.Response |
submitWorkflow(Workflow workflow,
javax.ws.rs.core.UriInfo ui)
Accepts (or not) a request to create a new run executing the given
workflow.
|
RunReference |
submitWorkflowByURI(URI workflowURI)
Make a run for a particular workflow, where that workflow will be
downloaded from elsewhere.
|
javax.ws.rs.core.Response |
submitWorkflowByURL(List<URI> referenceList,
javax.ws.rs.core.UriInfo ui)
Accepts (or not) a request to create a new run executing the workflow at
the given location.
|
RunReference |
submitWorkflowMTOM(WrappedWorkflow workflow)
Make a run for a particular workflow.
|
public static final String JMX_ROOT
public org.apache.commons.logging.Log log
public void setFileUtils(FilenameUtils converter)
setFileUtils
in interface TavernaServerBean
converter
- The filename converter being installed by Spring.public void setContentsDescriptorBuilder(ContentsDescriptorBuilder cdBuilder)
setContentsDescriptorBuilder
in interface TavernaServerBean
cdBuilder
- The contents descriptor builder being installed by Spring.public void setNotificationEngine(NotificationEngine notificationEngine)
setNotificationEngine
in interface TavernaServerBean
notificationEngine
- The notification engine being installed by Spring.public void setSupport(TavernaServerSupport support)
setSupport
in interface TavernaServerBean
support
- the support to setpublic void setRunStore(RunStore runStore)
setRunStore
in interface TavernaServerBean
runStore
- The run store being installed by Spring.public void setPolicy(Policy policy)
setPolicy
in interface TavernaServerBean
policy
- The policy being installed by Spring.public void setEventSource(EventDAO eventSource)
setEventSource
in interface TavernaServerBean
eventSource
- The event source bean being installed by Spring.public void setInteractionFeed(String interactionFeed)
interactionFeed
- The URL, which will be resolved relative to the location of
the webapp, or the string "none" (which corresponds
to a null).@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged public TavernaServerREST.ServerDescription describeService(javax.ws.rs.core.UriInfo ui)
TavernaServerREST
describeService
in interface TavernaServerREST
ui
- About the URI being accessed.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public TavernaServerREST.RunList listUsersRuns(javax.ws.rs.core.UriInfo ui)
TavernaServerREST
listUsersRuns
in interface TavernaServerREST
ui
- About the URI being accessed.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public javax.ws.rs.core.Response submitWorkflow(Workflow workflow, javax.ws.rs.core.UriInfo ui) throws NoUpdateException
TavernaServerREST
submitWorkflow
in interface TavernaServerREST
workflow
- The workflow document to execute.ui
- About the URI being accessed.NoUpdateException
- If the POST failed.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public javax.ws.rs.core.Response submitWorkflowByURL(List<URI> referenceList, javax.ws.rs.core.UriInfo ui) throws NoCreateException
TavernaServerREST
submitWorkflowByURL
in interface TavernaServerREST
ui
- About the URI being POSTed to.NoCreateException
@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged public int getServerMaxRuns()
TavernaServerSOAP
getServerMaxRuns
in interface TavernaServerSOAP
@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value={"ROLE_tavernauser","ROLE_tavernaworkflow"}) public TavernaServerRunREST getRunResource(String runName, javax.ws.rs.core.UriInfo ui) throws UnknownRunException
TavernaServerREST
getRunResource
in interface TavernaServerREST
runName
- The name of the run.ui
- About the URI used to access this run.UnknownRunException
- If the run handle is unknown to the current user.@InvocationCounter.CallCounted public abstract TavernaServerREST.PolicyView getPolicyDescription()
getPolicyDescription
in interface TavernaServerREST
@InvocationCounter.CallCounted public javax.ws.rs.core.Response serviceOptions()
TavernaServerREST
serviceOptions
in interface TavernaServerREST
@InvocationCounter.CallCounted public javax.ws.rs.core.Response runsOptions()
TavernaServerREST
runsOptions
in interface TavernaServerREST
protected abstract org.apache.taverna.server.master.RunREST makeRunInterface()
@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public RunReference[] listRuns()
TavernaServerSOAP
listRuns
in interface TavernaServerSOAP
@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public RunReference submitWorkflow(Workflow workflow) throws NoUpdateException
TavernaServerSOAP
submitWorkflow
in interface TavernaServerSOAP
workflow
- The workflow to instantiate.NoUpdateException
NoCreateException
@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public RunReference submitWorkflowMTOM(WrappedWorkflow workflow) throws NoUpdateException
TavernaServerSOAP
submitWorkflowMTOM
in interface TavernaServerSOAP
workflow
- The workflow to instantiate.NoUpdateException
NoCreateException
@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public RunReference submitWorkflowByURI(URI workflowURI) throws NoCreateException
TavernaServerSOAP
submitWorkflowByURI
in interface TavernaServerSOAP
workflowURI
- The URI to the workflow to instantiate.NoCreateException
@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged public URI[] getServerWorkflows()
TavernaServerSOAP
getServerWorkflows
in interface TavernaServerSOAP
@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged public String[] getServerListeners()
TavernaServerSOAP
getServerListeners
in interface TavernaServerSOAP
@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged public String[] getServerNotifiers()
TavernaServerSOAP
getServerNotifiers
in interface TavernaServerSOAP
@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged public List<Capability> getServerCapabilities()
getServerCapabilities
in interface TavernaServerSOAP
@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void destroyRun(String runName) throws UnknownRunException, NoUpdateException
TavernaServerSOAP
destroyRun
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user isn't allowed to manipulate the lifetime of the
run.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String getRunDescriptiveName(String runName) throws UnknownRunException
TavernaServerSOAP
getRunDescriptiveName
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunDescriptiveName(String runName, String descriptiveName) throws UnknownRunException, NoUpdateException
TavernaServerSOAP
setRunDescriptiveName
in interface TavernaServerSOAP
runName
- The handle of the run.descriptiveName
- The new descriptive name to set. Note that the implementation
is allowed to arbitrarily truncate this value.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user is not permitted to update this run.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public Workflow getRunWorkflow(String runName) throws UnknownRunException
TavernaServerSOAP
getRunWorkflow
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public WrappedWorkflow getRunWorkflowMTOM(String runName) throws UnknownRunException
TavernaServerSOAP
getRunWorkflowMTOM
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public ProfileList getRunWorkflowProfiles(String runName) throws UnknownRunException
TavernaServerSOAP
getRunWorkflowProfiles
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public Date getRunExpiry(String runName) throws UnknownRunException
TavernaServerSOAP
getRunExpiry
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunExpiry(String runName, Date d) throws UnknownRunException, NoUpdateException
TavernaServerSOAP
setRunExpiry
in interface TavernaServerSOAP
runName
- The handle of the run.d
- A date at which the expiry will be scheduled. The actual
deletion will happen an arbitrary amount of time later
(depending on system policy).UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user isn't allowed to manipulate the lifetime of the
run.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public Date getRunCreationTime(String runName) throws UnknownRunException
TavernaServerSOAP
getRunCreationTime
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public Date getRunFinishTime(String runName) throws UnknownRunException
TavernaServerSOAP
getRunFinishTime
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public Date getRunStartTime(String runName) throws UnknownRunException
TavernaServerSOAP
getRunStartTime
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public Status getRunStatus(String runName) throws UnknownRunException
TavernaServerSOAP
getRunStatus
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String setRunStatus(String runName, Status s) throws UnknownRunException, NoUpdateException
TavernaServerSOAP
setRunStatus
in interface TavernaServerSOAP
runName
- The handle of the run.s
- The status to change to. Changing to the current status will
always have no effect.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user isn't allowed to manipulate the run.BadStateChangeException
- If the state change requested is impossible.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String getRunStdout(String runName) throws UnknownRunException
TavernaServerSOAP
The equivalent thing can also be fetched from the relevant listener property (i.e., io/stdout).
getRunStdout
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String getRunStderr(String runName) throws UnknownRunException
TavernaServerSOAP
The equivalent thing can also be fetched from the relevant listener property (i.e., io/stderr).
getRunStderr
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public JobUsageRecord getRunUsageRecord(String runName) throws UnknownRunException
TavernaServerSOAP
The equivalent thing can also be fetched from the relevant listener property (i.e., io/usage).
getRunUsageRecord
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String getRunLog(String runName) throws UnknownRunException
TavernaServerSOAP
This can also be fetched from the appropriate file (i.e., logs/detail.log).
getRunLog
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public FileContents getRunBundle(String runName) throws UnknownRunException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
getRunBundle
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.FilesystemAccessException
- If there was a problem reading the bundle.NoDirectoryEntryException
- If the bundle doesn't exist currently.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public boolean getRunGenerateProvenance(String runName) throws UnknownRunException
TavernaServerSOAP
getRunGenerateProvenance
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunGenerateProvenance(String runName, boolean generate) throws UnknownRunException, NoUpdateException
TavernaServerSOAP
setRunGenerateProvenance
in interface TavernaServerSOAP
runName
- The handle of the run.generate
- Whether to generate provenance.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user is not allowed to manipulate the run.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String getRunOwner(String runName) throws UnknownRunException
TavernaServerSOAP
getRunOwner
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public Credential[] getRunCredentials(String runName) throws UnknownRunException, NotOwnerException
TavernaServerSOAP
getRunCredentials
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NotOwnerException
- If the user is permitted to see the run, but isn't the owner;
only the owner may see the credentials.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String setRunCredential(String runName, String credentialID, Credential credential) throws UnknownRunException, NotOwnerException, InvalidCredentialException, NoCredentialException, BadStateChangeException
TavernaServerSOAP
setRunCredential
in interface TavernaServerSOAP
runName
- The handle of the run.credentialID
- The handle of the credential to set. If empty, a new
credential will be created.credential
- The credential to set.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NotOwnerException
- If the user is permitted to see the run, but isn't the owner;
only the owner may manipulate the credentials.InvalidCredentialException
- If the credential fails its checks.NoCredentialException
- If the credentialID is not empty but does not
correspond to an existing credential.BadStateChangeException
- If an attempt to manipulate the credentials is done after the
workflow has started running.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void deleteRunCredential(String runName, String credentialID) throws UnknownRunException, NotOwnerException, NoCredentialException, BadStateChangeException
TavernaServerSOAP
deleteRunCredential
in interface TavernaServerSOAP
runName
- The handle of the run.credentialID
- The handle of the credential to delete. If empty, a new
credential will be created.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NotOwnerException
- If the user is permitted to see the run, but isn't the owner;
only the owner may manipulate the credentials.NoCredentialException
- If the given credentialID does not exist.BadStateChangeException
- If an attempt to manipulate the credentials is done after the
workflow has started running.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public Trust[] getRunCertificates(String runName) throws UnknownRunException, NotOwnerException
TavernaServerSOAP
getRunCertificates
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NotOwnerException
- If the user is permitted to see the run, but isn't the owner;
only the owner may see the credentials.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String setRunCertificates(String runName, String certificateID, Trust certificate) throws UnknownRunException, NotOwnerException, InvalidCredentialException, NoCredentialException, BadStateChangeException
TavernaServerSOAP
setRunCertificates
in interface TavernaServerSOAP
runName
- The handle of the run.certificateID
- The handle of the certificate collection to set. If empty, a
new certificate collection will be created.certificate
- The certificate collection to set.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NotOwnerException
- If the user is permitted to see the run, but isn't the owner;
only the owner may manipulate the certificates.InvalidCredentialException
- If the certificate fails its checks.NoCredentialException
- If the credentialID is not empty but does not
correspond to an existing certificate collection.BadStateChangeException
- If an attempt to manipulate the credentials is done after the
workflow has started running.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void deleteRunCertificates(String runName, String certificateID) throws UnknownRunException, NotOwnerException, NoCredentialException, BadStateChangeException
TavernaServerSOAP
deleteRunCertificates
in interface TavernaServerSOAP
runName
- The handle of the run.certificateID
- The handle of the credential to delete.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NotOwnerException
- If the user is permitted to see the run, but isn't the owner;
only the owner may manipulate the certificates.NoCredentialException
- If the given certificateID does not exist.BadStateChangeException
- If an attempt to manipulate the credentials is done after the
workflow has started running.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public PermissionList listRunPermissions(String runName) throws UnknownRunException, NotOwnerException
TavernaServerSOAP
listRunPermissions
in interface TavernaServerSOAP
runName
- The name of the run whose permissions are to be obtained.UnknownRunException
- If the server doesn't know about the run or if the current
user is not permitted to see it.NotOwnerException
- If asked to provide this information about a run that the
current user may see but where they are not the owner of it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunPermission(String runName, String userName, Permission permission) throws UnknownRunException, NotOwnerException
TavernaServerSOAP
setRunPermission
in interface TavernaServerSOAP
runName
- The name of the run whose permissions are to be updated.userName
- The name of the user about whom this call is talking.permission
- The permission level to set.UnknownRunException
- If the server doesn't know about the run or if the current
user is not permitted to see it.NotOwnerException
- If asked to provide this information about a run that the
current user may see but where they are not the owner of it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public OutputDescription getRunOutputDescription(String runName) throws UnknownRunException, BadStateChangeException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
getRunOutputDescription
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.BadStateChangeException
- If the run is in the Initialized
stateFilesystemAccessException
- If there is an exception when accessing the filesystem.NoDirectoryEntryException
- If things are odd in the filesystem.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public DirEntry[] getRunDirectoryContents(String runName, DirEntry d) throws UnknownRunException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
getRunDirectoryContents
in interface TavernaServerSOAP
runName
- The handle of the run.d
- The name of the directory to fetch; the main working directory
is / and .. is always disallowed.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.FilesystemAccessException
- If some assumption is violated (e.g., reading the contents of
a file).NoDirectoryEntryException
- If the name of the directory can't be looked up.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public byte[] getRunDirectoryAsZip(String runName, DirEntry d) throws UnknownRunException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
getRunDirectoryAsZip
in interface TavernaServerSOAP
runName
- The handle of the run.d
- The name of the directory to fetch; the main working directory
is / and .. is always disallowed.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.FilesystemAccessException
- If some assumption is violated (e.g., reading the contents of
a file).NoDirectoryEntryException
- If the name of the directory can't be looked up.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public ZippedDirectory getRunDirectoryAsZipMTOM(String runName, DirEntry d) throws UnknownRunException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
getRunDirectoryAsZipMTOM
in interface TavernaServerSOAP
runName
- The handle of the run.d
- The name of the directory to fetch; the main working directory
is / and .. is always disallowed.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.FilesystemAccessException
- If some assumption is violated (e.g., reading the contents of
a file).NoDirectoryEntryException
- If the name of the directory can't be looked up.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public DirEntry makeRunDirectory(String runName, DirEntry parent, String name) throws UnknownRunException, NoUpdateException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
makeRunDirectory
in interface TavernaServerSOAP
runName
- The handle of the run.parent
- The parent directory that will have the new directory added
beneath it.name
- The name of the directory to create. Must not be the same as
any other file or directory in the parent directory.
The name must not consist of .. or have a
/ in it.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user is not allowed to make modifications to the run.FilesystemAccessException
- If some assumption is violated (e.g., making something with
the same name as something that already exists).NoDirectoryEntryException
- If the name of the containing directory can't be looked up.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public DirEntry makeRunFile(String runName, DirEntry parent, String name) throws UnknownRunException, NoUpdateException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
makeRunFile
in interface TavernaServerSOAP
runName
- The handle of the run.parent
- The parent directory that will have the new file added to it.name
- The name of the file to create. Must not be the same as any
other file or directory in the parent directory. The
name must not consist of .. or have a
/ in it.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user is not allowed to make modifications to the run.FilesystemAccessException
- If some assumption is violated (e.g., making something with
the same name as something that already exists).NoDirectoryEntryException
- If the name of the containing directory can't be looked up.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void destroyRunDirectoryEntry(String runName, DirEntry d) throws UnknownRunException, NoUpdateException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
destroyRunDirectoryEntry
in interface TavernaServerSOAP
runName
- The handle of the run.d
- Reference to an existing item in a directory that will be
destroyed. May be a reference to either a file or a directory.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user is not allowed to make modifications to the run.FilesystemAccessException
- If some assumption is violated (e.g., deleting something
which doesn't exist or attempting to delete the main working
directory).NoDirectoryEntryException
- If the name of the file or directory can't be looked up.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public byte[] getRunFileContents(String runName, DirEntry d) throws UnknownRunException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
getRunFileContents
in interface TavernaServerSOAP
runName
- The handle of the run.d
- The name of the file to fetch; the main working directory is
/ and .. is always disallowed.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.FilesystemAccessException
- If some assumption is violated (e.g., reading the contents of
a directory).NoDirectoryEntryException
- If the file doesn't exist.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunFileContents(String runName, DirEntry d, byte[] newContents) throws UnknownRunException, NoUpdateException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
setRunFileContents
in interface TavernaServerSOAP
runName
- The handle of the run.d
- The name of the file to update; the main working directory is
/ and .. is always disallowed.newContents
- The literal bytes to set the file contents to.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user is not allowed to make modifications to the run.FilesystemAccessException
- If some assumption is violated (e.g., writing the contents of
a directory).NoDirectoryEntryException
- If the file doesn't exist.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public FileContents getRunFileContentsMTOM(String runName, DirEntry d) throws UnknownRunException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
getRunFileContentsMTOM
in interface TavernaServerSOAP
runName
- The handle of the run.d
- The name of the file to fetch; the main working directory is
/ and .. is always disallowed.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.FilesystemAccessException
- If some assumption is violated (e.g., reading the contents of
a directory).NoDirectoryEntryException
- If the file doesn't exist.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunFileContentsFromURI(String runName, DirEntryReference file, URI reference) throws UnknownRunException, NoUpdateException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
setRunFileContentsFromURI
in interface TavernaServerSOAP
runName
- The handle of the run.file
- The name of the file to update; the main working directory is
/ and .. is always disallowed.reference
- The publicly readable URI whose contents are to become the
literal bytes of the file's contents.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user is not allowed to make modifications to the run.FilesystemAccessException
- If some assumption is violated (e.g., writing the contents of
a directory).NoDirectoryEntryException
- If the file doesn't exist.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunFileContentsMTOM(String runName, FileContents newContents) throws UnknownRunException, NoUpdateException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
setRunFileContentsMTOM
in interface TavernaServerSOAP
runName
- The handle of the run.newContents
- The description of what file to set, and what to the file
contents should be set to.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user is not allowed to make modifications to the run.FilesystemAccessException
- If some assumption is violated (e.g., writing the contents of
a directory).NoDirectoryEntryException
- If the file doesn't exist.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String getRunFileType(String runName, DirEntry d) throws UnknownRunException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
getRunFileType
in interface TavernaServerSOAP
runName
- The handle of the run.d
- The name of the file to get the length of; the main working
directory is / and .. is always disallowed.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.FilesystemAccessException
- If some assumption is violated (e.g., reading the length of a
directory).NoDirectoryEntryException
- If the file doesn't exist.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public long getRunFileLength(String runName, DirEntry d) throws UnknownRunException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
getRunFileLength
in interface TavernaServerSOAP
runName
- The handle of the run.d
- The name of the file to get the length of; the main working
directory is / and .. is always disallowed.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.FilesystemAccessException
- If some assumption is violated (e.g., reading the length of a
directory).NoDirectoryEntryException
- If the file doesn't exist.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public Date getRunFileModified(String runName, DirEntry d) throws UnknownRunException, FilesystemAccessException, NoDirectoryEntryException
TavernaServerSOAP
getRunFileModified
in interface TavernaServerSOAP
runName
- The handle of the run.d
- The name of the file to get the modification date of; the main
working directory is / and .. is always
disallowed.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.FilesystemAccessException
- If some assumption is violated.NoDirectoryEntryException
- If the file or directory doesn't exist.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String[] getRunListeners(String runName) throws UnknownRunException
TavernaServerSOAP
getRunListeners
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String addRunListener(String runName, String listenerType, String configuration) throws UnknownRunException, NoUpdateException, NoListenerException
TavernaServerSOAP
addRunListener
in interface TavernaServerSOAP
runName
- The handle of the run.listenerType
- The type of event listener to add. Must be one of the names
returned by the TavernaServerSOAP.getServerListeners()
operation.configuration
- The configuration document for the event listener; the
interpretation of the configuration is up to the listener.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user isn't allowed to manipulate the run.NoListenerException
- If the listener construction fails (e.g., due to an
unsupported listenerType or a problem with the
configuration).@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String getRunListenerConfiguration(String runName, String listenerName) throws UnknownRunException, NoListenerException
TavernaServerSOAP
getRunListenerConfiguration
in interface TavernaServerSOAP
runName
- The handle of the run.listenerName
- The name of the listener attached.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoListenerException
- If no such listener exists.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String[] getRunListenerProperties(String runName, String listenerName) throws UnknownRunException, NoListenerException
TavernaServerSOAP
getRunListenerProperties
in interface TavernaServerSOAP
runName
- The handle of the run.listenerName
- The name of the listener attached.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoListenerException
- If no such listener exists.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String getRunListenerProperty(String runName, String listenerName, String propName) throws UnknownRunException, NoListenerException
TavernaServerSOAP
getRunListenerProperty
in interface TavernaServerSOAP
runName
- The handle of the run.listenerName
- The name of the listener attached.propName
- The name of the property to read.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoListenerException
- If no such listener exists or if the listener has no such
property.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunListenerProperty(String runName, String listenerName, String propName, String value) throws UnknownRunException, NoUpdateException, NoListenerException
TavernaServerSOAP
setRunListenerProperty
in interface TavernaServerSOAP
runName
- The handle of the run.listenerName
- The name of the listener attached.propName
- The name of the property to write.value
- The value to set the property to.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user is not allowed to make modifications to the run.NoListenerException
- If no such listener exists, the listener has no such
property, or the value is considered "unacceptable" in some
way.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public InputDescription getRunInputs(String runName) throws UnknownRunException
TavernaServerSOAP
getRunInputs
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String getRunOutputBaclavaFile(String runName) throws UnknownRunException
TavernaServerSOAP
getRunOutputBaclavaFile
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunInputBaclavaFile(String runName, String fileName) throws UnknownRunException, NoUpdateException, FilesystemAccessException, BadStateChangeException
TavernaServerSOAP
setRunInputBaclavaFile
in interface TavernaServerSOAP
runName
- The handle of the run.fileName
- The name of the file to use. Must not start with a /
or contain a .. element.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user isn't allowed to manipulate the run.BadStateChangeException
- If the run is not in the Initialized
stateFilesystemAccessException
- If the filename is illegal.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunInputPortFile(String runName, String portName, String portFilename) throws UnknownRunException, NoUpdateException, FilesystemAccessException, BadStateChangeException
TavernaServerSOAP
setRunInputPortFile
in interface TavernaServerSOAP
runName
- The handle of the run.portName
- The port to use the file for.portFilename
- The file to use on the port. Must not start with a /
or contain a .. element.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user isn't allowed to manipulate the run.BadStateChangeException
- If the run is not in the Initialized
state.FilesystemAccessException
- If the filename is illegal.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunInputPortValue(String runName, String portName, String portValue) throws UnknownRunException, NoUpdateException, BadStateChangeException
TavernaServerSOAP
setRunInputPortValue
in interface TavernaServerSOAP
runName
- The handle of the run.portName
- The port to use the file for.portValue
- The literal value to use on the port.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user isn't allowed to manipulate the run.BadStateChangeException
- If the run is not in the Initialized
state.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunInputPortListDelimiter(String runName, String portName, String delimiter) throws UnknownRunException, NoUpdateException, BadStateChangeException, BadPropertyValueException
TavernaServerSOAP
setRunInputPortListDelimiter
in interface TavernaServerSOAP
runName
- The handle of the run.portName
- The port to set the list delimiter for.delimiter
- The single-character value (in range U+00001..U+0007F) to use
as the delimiter, or null for no delimiter at all.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user isn't allowed to manipulate the run.BadStateChangeException
- If the run is not in the Initialized
state.BadPropertyValueException
- If the delimiter may not be changed to the given literal
value.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public void setRunOutputBaclavaFile(String runName, String outputFile) throws UnknownRunException, NoUpdateException, FilesystemAccessException, BadStateChangeException
TavernaServerSOAP
setRunOutputBaclavaFile
in interface TavernaServerSOAP
runName
- The handle of the run.outputFile
- The filename for the Baclava file, or null or the
empty string to indicate that the results are to be written to
the subdirectory out of the run's working directory.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.NoUpdateException
- If the user isn't allowed to manipulate the run.BadStateChangeException
- If the run is not in the Initialized
stateFilesystemAccessException
- If the filename is illegal (starts with a / or
contains a .. element.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public InputDescription getRunInputDescriptor(String runName) throws UnknownRunException
TavernaServerSOAP
getRunInputDescriptor
in interface TavernaServerSOAP
runName
- The handle of the run.UnknownRunException
- If the server doesn't know about the run or if the user is
not permitted to see it.@InvocationCounter.CallCounted @CallTimeLogger.PerfLogged @RolesAllowed(value="ROLE_tavernauser") public String getServerStatus()
TavernaServerSOAP
getServerStatus
in interface TavernaServerSOAP
public boolean initObsoleteSOAPSecurity(TavernaSecurityContext c)
TavernaServerBean
initObsoleteSOAPSecurity
in interface TavernaServerBean
c
- The context to configure.public boolean initObsoleteRESTSecurity(TavernaSecurityContext c)
TavernaServerBean
initObsoleteRESTSecurity
in interface TavernaServerBean
c
- The context to configure.public javax.ws.rs.core.UriBuilder getRunUriBuilder(TavernaRun run)
UriBuilderFactory
getRunUriBuilder
in interface UriBuilderFactory
run
- The run in question.URI
factory.public javax.ws.rs.core.UriBuilder getBaseUriBuilder()
getBaseUriBuilder
in interface UriBuilderFactory
@Nullable public String resolve(@Nullable String uri)
UriBuilderFactory
resolve
in interface UriBuilderFactory
uri
- The URI to resolve, or null.Copyright © 2015–2018 The Apache Software Foundation. All rights reserved.