Class PluginResponse

java.lang.Object
net.sf.basedb.core.PluginResponse

public final class PluginResponse extends Object
Get the response from a configuration step or execution of a plugin. Use getStatus() to find out the status of the last invokation. See PluginRequest for more information.
Version:
2.0
Author:
Nicklas
Last modified
$Date$
  • Field Details

    • request

      private final PluginConfigurationRequest request
    • response

      private final Response response
    • allowImmediateExecution

      private final boolean allowImmediateExecution
    • allowImmediateDownload

      private final boolean allowImmediateDownload
    • status

      private Response.Status status
    • estimatedExecutionTime

      private Job.ExecutionTime estimatedExecutionTime
    • message

      private String message
    • dryRun

      private boolean dryRun
    • suggestedJobName

      private String suggestedJobName
    • errorList

      private List<? extends Throwable> errorList
    • clearState

      private boolean clearState
    • nextCommand

      private String nextCommand
    • state

      private Serializable state
  • Constructor Details

    • PluginResponse

      PluginResponse(PluginConfigurationRequest request, boolean allowImmediateExection, boolean allowImmediateDownload, boolean dryRun)
  • Method Details

    • getStatus

      public Response.Status getStatus()
      Get the status of the response.
    • isDryRun

      public boolean isDryRun()
      Check if the job should be executed or was executed in dry-run mode.
      Since:
      2.8
    • getSuggestedJobName

      public String getSuggestedJobName()
      Get the job name that was suggested by the job.
      Returns:
      A job name or null if no name has been suggested
      Since:
      2.17
    • getMessage

      public String getMessage()
      Get the return message from the plugin.
    • getEstimatedExecutionTime

      public Job.ExecutionTime getEstimatedExecutionTime()
      Get the estimated execution time of the job. This value is only meaningful after a successful configuration sequence for a job.
    • getErrorList

      public List<? extends Throwable> getErrorList()
      Get a list containing detailed error messages if the status is Response.Status.ERROR.
      See Also:
    • getNextCommand

      public String getNextCommand()
      Get the next command sent via Response.Status.CONTINUE.
      Returns:
      The next command or null
      Since:
      2.16
    • getState

      public Serializable getState()
      Get the state information that the plug-in wants to save until it is restarted again.
      Since:
      3.11
    • getClearState

      public boolean getClearState()
      If set after a job configuration sequence, the saved state should be cleared before starting the job.
      Since:
      3.11
    • getNextRequest

      public PluginConfigurationRequest getNextRequest()
      Get a PluginRequest object that handles the next request, if status is Response.Status.CONTINUE.
    • getExecutionRequest

      public PluginExecutionRequest getExecutionRequest(ProgressReporter progress) throws PermissionDeniedException
      Throws:
      PermissionDeniedException
    • saveParameters

      public void saveParameters(DbControl dc)
      Save all parameters that has been configured during the configuration sequence to the database.
      Parameters:
      dc - An open DbControl to use when accessing the database.
    • downloadImmediately

      public void downloadImmediately(ExportOutputStream out, ProgressReporter progress) throws IOException
      Throws:
      IOException
    • getResponseImpl

      Response getResponseImpl()
      Get a new reponse object. Used by the PluginRequest.invoke() method.
    • setError

      void setError(String message, Throwable t)
      Set a singe error message.
    • reset

      private void reset(Response.Status status)