UWSJob

java.lang.Object
- uws.job.SerializableUWSObject
- - uws.job.UWSJob

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

TAPJob
```
public class UWSJob
extends SerializableUWSObject
```
Brief description

Default implementation of a job of the UWS pattern.

Some attributes comments
- The job attributes creationTime, startTime and endTime are automatically managed by UWSJob. You don't have to do anything! The date/time format is managed automatically by the library and can not be customized since it is imposed by the UWS protocol definition: ISO-8601.
- Once set, the destruction and the executionDuration attributes are automatically managed. That is to say:
  - if the destruction time is reached: the job stops and it is destroyed by its job list
  - if the execution duration is elapsed: the job stops and the phase is put to ABORTED.
- The owner attribute is set at the job creation and can not be changed after ! If no owner is given at the job creation, its default value is null.
- If your job is executable, do not forget to set the quote parameter ONLY by using the setQuote(long) method (a negative value or QUOTE_NOT_KNOWN value indicates the quote is not known ; QUOTE_NOT_KNOWN is the default value). This duration in seconds will be added to the startTime and then automatically formatted into an ISO-8601 date by the used serializer.
More details
- generateJobId(): This function is called at the construction of any UWSJob. It allows to generate a unique job ID. By default: time (in milliseconds) + a upper-case letter (A, B, C, ....). If you want customizing the job ID of your jobs, you need to override this function or to use the new function UWSJob(JobOwner, UWSParameters, String).
- clearResources(): This method is called only at the destruction of the job. By default, the job is stopped (if running), thread resources are freed, the job is removed from its jobs list and result/error files are deleted.
- setPhaseManager(JobPhase): Lets customizing the default behaviors of all the execution phases for any job instance. For more details see JobPhase.
- addObserver(JobObserver): An instance of any kind of AbstractJob can be observed by objects which implements JobObserver (i.e. UWSService). Observers are notified at any change of the execution phase.
Version:

4.4 (09/2018)

Author:

Grégory Mantelet (CDS;ARI)

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

protected class UWSJob.JobTimeOut
Stop/Cancel this job when its maximum execution duration has been reached.

Nested Classes
Modifier and Type	Class and Description
`protected class`	`UWSJob.JobTimeOut` Stop/Cancel this job when its maximum execution duration has been reached.

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`ACTION_DELETE` Name of the DELETE action.
`static java.lang.String`	`ANONYMOUS_OWNER` Default value of `owner` if no ID are given at the job creation.
`protected java.util.Date`	`creationTime` Date of the initial creation of this job.
`static java.text.DateFormat`	`dateFormat` Deprecated. Replaced by `ISO8601Format`.
`static java.lang.String`	`DEFAULT_DATE_FORMAT` Deprecated. Replaced by `ISO8601Format`.
`protected ErrorSummary`	`errorSummary` This error summary gives a human-readable error message for the underlying job.
`protected UWSParameters`	`inputParams` List of all input parameters (UWS standard and non-standard parameters).
`protected java.lang.String`	`jobId` The identifier of the job (it MUST be different from any other job).
`protected JobInfo`	`jobInfo` Additional description of this job.
`protected static java.lang.String`	`lastId` The last generated job ID.
`protected JobOwner`	`owner` The identifier of the creator of this job.
`static java.lang.String`	`PARAM_ACTION` Name of the parameter ACTION.
`static java.lang.String`	`PARAM_CREATION_TIME` Name of the parameter creationTime.
`static java.lang.String`	`PARAM_DESTRUCTION_TIME` Name of the parameter destructionTime.
`static java.lang.String`	`PARAM_END_TIME` Name of the parameter endTime.
`static java.lang.String`	`PARAM_ERROR_SUMMARY` Name of the parameter errorSummary.
`static java.lang.String`	`PARAM_EXECUTION_DURATION` Name of the parameter executionDuration.
`static java.lang.String`	`PARAM_JOB_ID` Name of the parameter jobId.
`static java.lang.String`	`PARAM_JOB_INFO` Name of the parameter jobInfo.
`static java.lang.String`	`PARAM_OWNER` Name of the parameter owner.
`static java.lang.String`	`PARAM_PARAMETERS` Name of the parameter otherParameters.
`static java.lang.String`	`PARAM_PHASE` Name of the parameter phase.
`static java.lang.String`	`PARAM_QUOTE` Name of the parameter quote.
`static java.lang.String`	`PARAM_RESULTS` Name of the parameter results.
`static java.lang.String`	`PARAM_RUN_ID` Name of the parameter runId.
`static java.lang.String`	`PARAM_START_TIME` Name of the parameter startTime.
`static java.lang.String`	`PHASE_ABORT` Value of the parameter phase which aborts the job.
`static java.lang.String`	`PHASE_RUN` Value of the parameter phase which starts the job.
`static long`	`QUOTE_NOT_KNOWN` The quote value that indicates the quote of this job is not known.
`protected java.util.Map<java.lang.String,Result>`	`results` This is a list of all results of this job.
`protected boolean`	`stopping` Used by the thread to known whether the `stop()` method has already been called, and so, that the job is stopping.
`protected JobThread`	`thread` The thread to start for executing the job.
`static long`	`UNLIMITED_DURATION` The duration that implies an unlimited execution duration.
`protected long`	`waitForStop` The time (in ms) to wait the end of the thread after an interruption.

Constructor Summary

Constructors
Constructor and Description
`UWSJob(JobOwner owner, UWSParameters params)` Builds a job of the given owner and from a map of all parameters (UWS and additional parameters).
`UWSJob(JobOwner owner, UWSParameters params, java.lang.String requestID)` Builds a job of the given owner and from a map of all parameters (UWS and additional parameters).
`UWSJob(java.lang.String jobID, long creationTime, JobOwner owner, UWSParameters params, long quote, long startTime, long endTime, java.util.List<Result> results, ErrorSummary error)` CONSTRUCTOR TO USE TO RESTORE A JOB whatever is its phase.
`UWSJob(UWSParameters params)` Builds a job with no owner from a map of all parameters (UWS and additional parameters).

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`abort()` Stops immediately the job, sets its phase to `ABORTED` and sets its end time.
`boolean`	`addObserver(JobObserver observer)` Lets adding an observer of this job.
`boolean`	`addOrUpdateParameter(java.lang.String paramName, java.lang.Object paramValue)` Adds or updates the specified parameter with the given value ONLY IF the job can be updated (considering its current execution phase, see `JobPhase.isJobUpdatable()`).
`boolean`	`addOrUpdateParameter(java.lang.String paramName, java.lang.Object paramValue, JobOwner user)` Adds or updates the specified parameter with the given value ONLY IF the job can be updated (considering its current execution phase, see `JobPhase.isJobUpdatable()`).
`boolean`	`addOrUpdateParameters(UWSParameters params)` Adds or updates the given parameters ONLY IF the job can be updated (considering its current execution phase, see `JobPhase.isJobUpdatable()`).
`boolean`	`addOrUpdateParameters(UWSParameters params, JobOwner user)` Adds or updates the given parameters ONLY IF the job can be updated (considering its current execution phase, see `JobPhase.isJobUpdatable()`).
`boolean`	`addResult(Result res)` Adds the given result in the results list of this job.
`void`	`applyPhaseParam(JobOwner user)` Looks for an additional parameters which corresponds to the Execution Phase.
`boolean`	`archive()` Archive this job.
`void`	`clearResources()` Stops the job if running, removes the job from the execution manager, stops the timer for the execution duration.
`void`	`clearResources(boolean fullClean)` Stops the job if running, removes the job from the execution manager, stops the timer for the execution duration.
`boolean`	`equals(java.lang.Object anotherJob)` 2 instances of AbstractJob are equals ONLY IF their ID are equals.
`void`	`error(ErrorSummary error)` Stops immediately the job, sets its error summary, sets its phase to `ExecutionPhase.ERROR` and sets its end time.
`protected java.lang.String`	`generateJobId()` This function lets generating a unique ID.
`java.util.Set<java.lang.String>`	`getAdditionalParameters()` Gets the list of parameters' name.
`java.lang.Object`	`getAdditionalParameterValue(java.lang.String paramName)` Gets the value of the specified additional parameter.
`java.util.Date`	`getCreationTime()` Gets the creation date/time of this job.
`java.util.Date`	`getDestructionTime()` Gets the instant when the job shall be destroyed.
`java.util.Date`	`getEndTime()` Gets the time at which the job execution has finished.
`ErrorSummary`	`getErrorSummary()` Gets the error that occurs during the execution of this job.
`long`	`getExecutionDuration()` Gets the duration (in seconds) for which this job shall run.
`ExecutionManager`	`getExecutionManager()` Gets the execution manager of this job, if any.
`UWSFactory`	`getFactory()` Gets the factory to use to create the thread to execute when this job starts.
`UWSFileManager`	`getFileManager()` Gets the file manager used in this job.
`java.lang.String`	`getJobId()` Gets the ID of this job (this ID MUST be unique).
`JobInfo`	`getJobInfo()` Get the additional information about this job.
`JobList`	`getJobList()` Gets its jobs list, if known.
`UWSLog`	`getLogger()` Gets the logger of its UWS or a default one if the job list or the UWS is unknown.
`int`	`getNbAdditionalParameters()` Gets the number of additional parameters.
`int`	`getNbObservers()` Gets the total number of observers this job has.
`int`	`getNbResults()` Gets the total number of results.
`java.util.Iterator<JobObserver>`	`getObservers()` Gets the observers of this job.
`JobOwner`	`getOwner()` Gets the owner of this job.
`java.lang.Object`	`getParameter(java.lang.String name)` Gets the value of the specified parameter.
`ExecutionPhase`	`getPhase()` Gets the phase in which this job is now.
`JobPhase`	`getPhaseManager()` Gets the phase manager of this job.
`long`	`getQuote()` Get the quote attribute of this job.
`java.util.Date`	`getRestorationDate()` Gets the date of the restoration of this job.
`Result`	`getResult(java.lang.String resultId)` Gets the specified result.
`java.util.Iterator<Result>`	`getResults()` Gets the results list of this job.
`java.lang.String`	`getRunId()` Gets the RunID of this job given by the UWS user (presumed to be the owner of this job).
`java.util.Date`	`getStartTime()` Gets the time at which the job execution has started.
`long`	`getTimeToWaitForEnd()` Gets the time to wait for the end of the thread after an interruption.
`UWSUrl`	`getUrl()` Gets the UWS URL of this job in function of its jobs list.
`UWSException`	`getWorkError()` Gets the error (if any) which has occurred during the job execution.
`int`	`hashCode()`
`boolean`	`isFinished()` Tells whether the job is already finished (completed, aborted, error, archived, ...).
`boolean`	`isRunning()` Tells whether the job is still running.
`protected boolean`	`isStopped()` Tells whether the thread is different from null, is not alive or is finished (see `JobThread.isFinished()`).
`void`	`notifyObservers(ExecutionPhase oldPhase)` Notifies all the observer of this job that its phase has changed.
`boolean`	`removeAdditionalParameter(java.lang.String paramName)` Removes the specified additional parameter ONLY IF the job can be updated (considering its current execution phase, see `JobPhase.isJobUpdatable()`).
`void`	`removeAllObservers()` Lets removing all observers of this job.
`boolean`	`removeObserver(JobObserver observer)` Lets removing the given object from the list of observers of this job.
`void`	`serialize(javax.servlet.ServletOutputStream output, java.lang.String[] attributes, UWSSerializer serializer)` Serializes the specified attribute of this job in the given output stream by using the given serializer.
`java.lang.String`	`serialize(java.lang.String[] attributes, UWSSerializer serializer)` Serializes the specified attribute of this job by using the given serializer.
`java.lang.String`	`serialize(UWSSerializer serializer, JobOwner user)` Serializes the whole object considering the given owner (supposed to be the current user) and thanks to the given serializer.
`void`	`setDestructionTime(java.util.Date destructionTime)` Sets the instant when the job shall be destroyed ONLY IF the job can updated (considering its current execution phase, see `JobPhase.isJobUpdatable()`).
`protected void`	`setEndTime(java.util.Date newDateTime)` Sets the time at which the job execution has finished.
`void`	`setErrorSummary(ErrorSummary errorSummary)` Sets the error that occurs during the execution of this job.
`void`	`setExecutionDuration(long executionDuration)` Sets the duration (in seconds) for which this job shall run ONLY IF the job can updated (considering its current execution phase, see `JobPhase.isJobUpdatable()`).
`void`	`setJobInfo(JobInfo newJobInfo)` Set the additional information about this job.
`protected void`	`setJobList(JobList jobList)` Sets its jobs list.
`void`	`setPhase(ExecutionPhase p)` Sets the current phase of this job.
`void`	`setPhase(ExecutionPhase p, boolean force)` Sets the current phase of this job, respecting or not the imposed order.
`void`	`setPhaseManager(JobPhase jobPhase)` Sets the phase manager of this job.
`void`	`setQuote(long nbSeconds)` Sets the quote attribute of this job ONLY IF the job is not yet finished according to its current status (i.e.
`void`	`setRunId(java.lang.String name)` Sets the RunID of this job ONLY IF the job can updated (considering its current execution phase, see `JobPhase.isJobUpdatable()`).
`protected void`	`setStartTime(java.util.Date newDateTime)` Sets the time at which the job execution has started.
`void`	`setTimeToWaitForEnd(long timeToWait)` Sets the time to wait for the end of the thread after an interruption.
`void`	`start()` Starts the job by using the execution manager if any.
`void`	`start(boolean useManager)` Starts the job.
`protected void`	`stop()` Stops the thread that executes the work of this job.
`java.lang.String`	`toString()`

Methods inherited from class uws.job.SerializableUWSObject
serialize, serialize, serialize

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - PARAM_ACTION
```
public static final java.lang.String PARAM_ACTION
```
    Name of the parameter ACTION.
    
    See Also:
    
    Constant Field Values
  - ACTION_DELETE
```
public static final java.lang.String ACTION_DELETE
```
    Name of the DELETE action.
    
    See Also:
    
    Constant Field Values
  - PARAM_JOB_ID
```
public static final java.lang.String PARAM_JOB_ID
```
    Name of the parameter jobId.
    
    See Also:
    
    Constant Field Values
  - PARAM_CREATION_TIME
```
public static final java.lang.String PARAM_CREATION_TIME
```
    Name of the parameter creationTime.
    
    Since:
    
    4.3
    
    See Also:
    
    Constant Field Values
  - PARAM_RUN_ID
```
public static final java.lang.String PARAM_RUN_ID
```
    Name of the parameter runId.
    
    See Also:
    
    Constant Field Values
  - PARAM_OWNER
```
public static final java.lang.String PARAM_OWNER
```
    Name of the parameter owner.
    
    See Also:
    
    Constant Field Values
  - PARAM_PHASE
```
public static final java.lang.String PARAM_PHASE
```
    Name of the parameter phase.
    
    See Also:
    
    Constant Field Values
  - PHASE_RUN
```
public static final java.lang.String PHASE_RUN
```
    Value of the parameter phase which starts the job.
    
    See Also:
    
    Constant Field Values
  - PHASE_ABORT
```
public static final java.lang.String PHASE_ABORT
```
    Value of the parameter phase which aborts the job.
    
    See Also:
    
    Constant Field Values
  - PARAM_QUOTE
```
public static final java.lang.String PARAM_QUOTE
```
    Name of the parameter quote.
    
    See Also:
    
    Constant Field Values
  - PARAM_START_TIME
```
public static final java.lang.String PARAM_START_TIME
```
    Name of the parameter startTime.
    
    See Also:
    
    Constant Field Values
  - PARAM_END_TIME
```
public static final java.lang.String PARAM_END_TIME
```
    Name of the parameter endTime.
    
    See Also:
    
    Constant Field Values
  - PARAM_EXECUTION_DURATION
```
public static final java.lang.String PARAM_EXECUTION_DURATION
```
    Name of the parameter executionDuration.
    
    See Also:
    
    Constant Field Values
  - PARAM_DESTRUCTION_TIME
```
public static final java.lang.String PARAM_DESTRUCTION_TIME
```
    Name of the parameter destructionTime.
    
    See Also:
    
    Constant Field Values
  - PARAM_ERROR_SUMMARY
```
public static final java.lang.String PARAM_ERROR_SUMMARY
```
    Name of the parameter errorSummary.
    
    See Also:
    
    Constant Field Values
  - PARAM_PARAMETERS
```
public static final java.lang.String PARAM_PARAMETERS
```
    Name of the parameter otherParameters.
    
    See Also:
    
    Constant Field Values
  - PARAM_RESULTS
```
public static final java.lang.String PARAM_RESULTS
```
    Name of the parameter results.
    
    See Also:
    
    Constant Field Values
  - PARAM_JOB_INFO
```
public static final java.lang.String PARAM_JOB_INFO
```
    Name of the parameter jobInfo.
    
    Since:
    
    4.2
    
    See Also:
    
    Constant Field Values
  - ANONYMOUS_OWNER
```
public static final java.lang.String ANONYMOUS_OWNER
```
    Default value of owner if no ID are given at the job creation.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_DATE_FORMAT
```
@Deprecated
public static final java.lang.String DEFAULT_DATE_FORMAT
```
    Deprecated. Replaced by ISO8601Format.
    
    Default date format pattern.
    
    See Also:
    
    Constant Field Values
  - QUOTE_NOT_KNOWN
```
public static final long QUOTE_NOT_KNOWN
```
    The quote value that indicates the quote of this job is not known.
    
    See Also:
    
    Constant Field Values
  - UNLIMITED_DURATION
```
public static final long UNLIMITED_DURATION
```
    The duration that implies an unlimited execution duration.
    
    See Also:
    
    Constant Field Values
  - lastId
```
protected static java.lang.String lastId
```
    The last generated job ID. It SHOULD be used ONLY by the function generateJobId() !
  - jobId
```
protected final java.lang.String jobId
```
    The identifier of the job (it MUST be different from any other job).
    Note: It is assigned automatically at the job creation in any job constructor by the function generateJobId(). To change the way this ID is generated or its format you must override this function.
  - creationTime
```
protected final java.util.Date creationTime
```
    Date of the initial creation of this job.
    Note: This attribute can be set only automatically at creation by the UWS service and can not be set or changed by a user (even its owner).
    
    Since:
    
    4.3
  - owner
```
protected final JobOwner owner
```
    The identifier of the creator of this job.
    Note: This object will not exist for all invocations of the UWS conformant protocol, but only in cases where the access to the service is authenticated.
  - dateFormat
```
@Deprecated
public static final java.text.DateFormat dateFormat
```
    Deprecated. Replaced by ISO8601Format.
    
    The used date formatter.
  - errorSummary
```
protected ErrorSummary errorSummary
```
    This error summary gives a human-readable error message for the underlying job.
    Note: This object is intended to be a detailed error message, and consequently, might be a large piece of text such as a stack trace.
  - results
```
protected java.util.Map<java.lang.String,Result> results
```
    This is a list of all results of this job.
  - inputParams
```
protected final UWSParameters inputParams
```
    List of all input parameters (UWS standard and non-standard parameters).
  - jobInfo
```
protected JobInfo jobInfo
```
    Additional description of this job.
    
    Since:
    
    4.2
  - thread
```
protected transient JobThread thread
```
    The thread to start for executing the job.
  - waitForStop
```
protected long waitForStop
```
    The time (in ms) to wait the end of the thread after an interruption.
  - stopping
```
protected boolean stopping
```
    Used by the thread to known whether the stop() method has already been called, and so, that the job is stopping.
- Constructor Detail
  - UWSJob
```
public UWSJob(UWSParameters params)
```
    Builds a job with no owner from a map of all parameters (UWS and additional parameters).
    Note: If the parameter PARAM_PHASE (phase) is given with the value PHASE_RUN the job execution starts immediately after the job has been added to a job list or after applyPhaseParam(JobOwner) is called.
    
    Parameters:
    
    params - UWS standard and non-standard parameters.
    
    See Also:
    
    UWSJob(JobOwner, UWSParameters)
  - UWSJob
```
public UWSJob(JobOwner owner,
              UWSParameters params)
```
    Builds a job of the given owner and from a map of all parameters (UWS and additional parameters).
    Note: if the parameter PARAM_PHASE (phase) is given with the value PHASE_RUN the job execution starts immediately after the job has been added to a job list or after applyPhaseParam(JobOwner) is called.
    
    Parameters:
    
    owner - Job.owner (PARAM_OWNER).
    
    params - UWS standard and non-standard parameters.
    
    See Also:
    
    UWSParameters.init()
  - UWSJob
```
public UWSJob(JobOwner owner,
              UWSParameters params,
              java.lang.String requestID)
```
    Builds a job of the given owner and from a map of all parameters (UWS and additional parameters). The given HTTP request ID will be used as Job ID if not already used by another job.
    Note: If the parameter PARAM_PHASE (phase) is given with the value PHASE_RUN the job execution starts immediately after the job has been added to a job list or after applyPhaseParam(JobOwner) is called.
    
    Parameters:
    
    owner - Job.owner (PARAM_OWNER).
    
    params - UWS standard and non-standard parameters.
    
    requestID - ID of the HTTP request which has initiated the creation of this job. Note: if NULL, empty or already used, a job ID will be generated thanks to generateJobId().
    
    Since:
    
    4.2
    
    See Also:
    
    UWSParameters.init()
  - UWSJob
```
public UWSJob(java.lang.String jobID,
              long creationTime,
              JobOwner owner,
              UWSParameters params,
              long quote,
              long startTime,
              long endTime,
              java.util.List<Result> results,
              ErrorSummary error)
       throws java.lang.NullPointerException
```
    CONSTRUCTOR TO USE TO RESTORE A JOB whatever is its phase.
    
    Builds a job of the given owner with all the given parameter.
    
    Note: The job phase is automatically set in function of the last parameters (startTime, endTime, results and error). Only the following execution phase are possible: PENDING, ABORTED, ERROR and COMPLETED.
    
    Parameters:
    
    jobID - The ID of this job (NOT NULL).
    
    creationTime - Its creation date/time (SHOULD NOT BE NEGATIVE OR NULL).
    
    owner - Its owner.
    
    params - UWS standard and non-standard parameters.
    
    quote - Its quote (in seconds).
    
    startTime - Its start time if it has already been started.
    
    endTime - Its end time if it is already finished.
    
    results - Its results (if phase=COMPLETED).
    
    error - Its error (if phase=ERROR).
    
    Throws:
    
    java.lang.NullPointerException - If the given ID is NULL.
    
    Since:
    
    4.3
- Method Detail
  - generateJobId
```
protected java.lang.String generateJobId()
```
    This function lets generating a unique ID.
    By default: System.currentTimeMillis()+UpperCharacter (UpperCharacter: one upper-case character chosen in order to guarantee the unicity of the ID: A, B, C, ....)
    
    Note: DO NOT USE in this function any of the following functions: getLogger(), getFileManager() and getFactory(). All of them will return NULL, because this job does not yet know its jobs list (which is needed to know the UWS and so, all of the objects returned by these functions).
    
    Returns:
    
    A unique job identifier.
  - getParameter
```
public java.lang.Object getParameter(java.lang.String name)
```
    Gets the value of the specified parameter.
    
    Note: No case sensitivity for the UWS parameters ON THE CONTRARY TO the names of the additional parameters (which are case sensitive).
    
    Parameters:
    
    name - Name of the parameter to get.
    
    Returns:
    
    Its value or null if there is no parameter with the given name or if the value is null.
    
    See Also:
    
    UWSParameters.get(String)
  - applyPhaseParam
```
public void applyPhaseParam(JobOwner user)
                     throws UWSException
```
    Looks for an additional parameters which corresponds to the Execution Phase. If it exists and:
    - is equals to RUN => remove it from the attribute inputParams and start the job.
    - is equals to ABORT => remove it from the attribute inputParams and abort the job.
    - is another value => the attribute is though removed from the attribute inputParams but nothing is done.
    Parameters:
    
    user - The user who asks to apply the phase parameter (start/abort). May be NULL.
    
    Throws:
    
    UWSException - If it is impossible the state of this job (into EXECUTING or ABORTED) or if the given user is not allowed to execute this job.
    
    See Also:
    
    UWSParameters.hasInputPhase(), UWSParameters.getInputPhase(), start(), abort()
  - getFileManager
```
public final UWSFileManager getFileManager()
```
    Gets the file manager used in this job.
    
    Returns:
    
    Its file manager or null if this job is not into a JobList or if this jobs list is not into a UWS.
    
    See Also:
    
    JobList.getUWS(), UWS.getFileManager()
  - getLogger
```
public UWSLog getLogger()
```
    Gets the logger of its UWS or a default one if the job list or the UWS is unknown.
    
    Returns:
    
    A logger.
    
    See Also:
    
    JobList.getUWS(), UWS.getLogger(), UWSToolBox.getDefaultLogger()
  - getFactory
```
public final UWSFactory getFactory()
```
    Gets the factory to use to create the thread to execute when this job starts.
    
    Returns:
    
    The factory to use to create a JobThread.
  - getRestorationDate
```
public final java.util.Date getRestorationDate()
```
    Gets the date of the restoration of this job.
    
    Returns:
    
    Date of its restoration.
  - getPhase
```
public final ExecutionPhase getPhase()
```
    Gets the phase in which this job is now.
    
    Returns:
    
    The current phase of this job.
    
    See Also:
    
    JobPhase.getPhase()
  - setPhase
```
public final void setPhase(ExecutionPhase p)
                    throws UWSException
```
    Sets the current phase of this job.
    IMPORTANT:
    - The order of all phases must be respected. By default: PENDING ---> QUEUED ---> EXECUTING ---> COMPLETED.
    - The only way to go to the EXECUTING phase is by sending a POST query with the value RUN for the parameter PHASE.
    - The only way to go to the ABORTED phase is by sending a POST query with the value ABORT for the parameter PHASE.
    - The start time and the end time are set automatically when the phase is set to EXECUTING and COMPLETED, ABORTED or ERROR
    Parameters:
    
    p - The phase to set for this job.
    
    Throws:
    
    UWSException - If the given phase does not respect the job's phases order.
    
    See Also:
    
    setPhase(ExecutionPhase, boolean)
  - setPhase
```
public final void setPhase(ExecutionPhase p,
                           boolean force)
                    throws UWSException
```
    Sets the current phase of this job, respecting or not the imposed order.
    IMPORTANT:
    - If the parameter force is false, the order of all phases must be respected: PENDING ---> QUEUED ---> EXECUTING ---> COMPLETED.
    - The only way to go to the EXECUTING phase is by sending a POST query with the value RUN for the parameter PARAM_PHASE.
    - The only way to go to the ABORTED phase is by sending a POST query with the value ABORT for the parameter PARAM_PHASE.
    - The start time and the end time are set automatically when the phase is set to EXECUTING and COMPLETED, ABORTED or ERROR
    Parameters:
    
    p - The phase to set for this job.
    
    force - true to impose the given execution phase, false to take into account the order of all phases.
    
    Throws:
    
    UWSException - If the given phase does not respect the job's phases order.
    
    See Also:
    
    JobPhase.setPhase(ExecutionPhase, boolean), JobPhase.isFinished(), ExecutionManager.remove(UWSJob), notifyObservers(ExecutionPhase)
  - getPhaseManager
```
public final JobPhase getPhaseManager()
```
    Gets the phase manager of this job.
    Note: The phase manager manages all the transitions between all the execution phases.
    
    Returns:
    
    Its phase manager.
  - setPhaseManager
```
public final void setPhaseManager(JobPhase jobPhase)
```
    Sets the phase manager of this job.
    Note: The phase manager manages all the transitions between all the execution phases.
    
    Parameters:
    
    jobPhase - Its new phase manager (if null this function does nothing).
  - getStartTime
```
public final java.util.Date getStartTime()
```
    Gets the time at which the job execution has started.
    
    Returns:
    
    The start time of the execution of this job.
  - setStartTime
```
protected final void setStartTime(java.util.Date newDateTime)
```
    Sets the time at which the job execution has started.
    
    Parameters:
    
    newDateTime - The start time of the execution of this job.
  - getEndTime
```
public final java.util.Date getEndTime()
```
    Gets the time at which the job execution has finished.
    
    Returns:
    
    The end time of the execution of this job.
  - setEndTime
```
protected final void setEndTime(java.util.Date newDateTime)
```
    Sets the time at which the job execution has finished.
    
    Parameters:
    
    newDateTime - The end time of the execution of this job.
  - getExecutionDuration
```
public final long getExecutionDuration()
```
    Gets the duration (in seconds) for which this job shall run.
    
    Returns:
    
    The execution duration of this job.
    
    See Also:
    
    UWSParameters.getExecutionDuration()
  - setExecutionDuration
```
public final void setExecutionDuration(long executionDuration)
```
    Sets the duration (in seconds) for which this job shall run ONLY IF the job can updated (considering its current execution phase, see JobPhase.isJobUpdatable()).
    Note: A duration of 0 (or less) implies unlimited execution duration.
    
    Parameters:
    
    executionDuration - The execution duration of this job.
    
    See Also:
    
    UWSParameters.set(String, Object)
  - getDestructionTime
```
public final java.util.Date getDestructionTime()
```
    Gets the instant when the job shall be destroyed.
    
    Returns:
    
    The destruction time of this job.
    
    See Also:
    
    UWSParameters.getDestructionTime()
  - setDestructionTime
```
public final void setDestructionTime(java.util.Date destructionTime)
```
    Sets the instant when the job shall be destroyed ONLY IF the job can updated (considering its current execution phase, see JobPhase.isJobUpdatable()). If known the jobs list is notify of this destruction time update.
    
    Parameters:
    
    destructionTime - The destruction time of this job. MUST NOT be NULL
    
    See Also:
    
    JobList.updateDestruction(UWSJob), UWSParameters.set(String, Object)
  - getErrorSummary
```
public final ErrorSummary getErrorSummary()
```
    Gets the error that occurs during the execution of this job.
    
    Returns:
    
    A summary of the error.
  - setErrorSummary
```
public final void setErrorSummary(ErrorSummary errorSummary)
                           throws UWSException
```
    Sets the error that occurs during the execution of this job.
    IMPORTANT: This function will have no effect if the job is finished, that is to say if the current phase is ABORTED, ERROR, COMPLETED or ARCHIVED.
    
    Parameters:
    
    errorSummary - A summary of the error. MUST NOT be NULL
    
    Throws:
    
    UWSException - If the job execution is finished that is to say if the phase is ABORTED, ERROR, COMPLETED or ARCHIVED.
    
    See Also:
    
    isFinished()
  - getJobId
```
public final java.lang.String getJobId()
```
    Gets the ID of this job (this ID MUST be unique).
    
    Returns:
    
    The job ID (unique).
  - getRunId
```
public final java.lang.String getRunId()
```
    Gets the RunID of this job given by the UWS user (presumed to be the owner of this job). This ID isn't the one used to access to this job thanks to the jobs list: it is more likely a label/name than an ID => it is not unique.
    WARNING: This ID may be used by other jobs BUT their job id (cf getJobId()) must be different.
    
    Returns:
    
    The Run ID (a kind of job name/label).
    
    See Also:
    
    UWSParameters.getRunId()
  - setRunId
```
public final void setRunId(java.lang.String name)
```
    Sets the RunID of this job ONLY IF the job can updated (considering its current execution phase, see JobPhase.isJobUpdatable()).
    
    Parameters:
    
    name - Its name/label.
    
    See Also:
    
    JobPhase.isJobUpdatable(), UWSParameters.set(String, Object)
  - getOwner
```
public final JobOwner getOwner()
```
    Gets the owner of this job.
    
    Returns:
    
    The owner.
  - getQuote
```
public final long getQuote()
```
    Get the quote attribute of this job.
    
    Returns:
    
    The estimated duration of the job execution (in seconds).
  - setQuote
```
public final void setQuote(long nbSeconds)
```
    Sets the quote attribute of this job ONLY IF the job is not yet finished according to its current status (i.e. JobPhase.isFinished()).
    Note: A negative or NULL value will be considered as 'no quote for this job'. One could use the constant QUOTE_NOT_KNOWN (= -1L) for this exact purpose.
    
    Parameters:
    
    nbSeconds - The estimated duration of the job execution (in seconds).
  - getAdditionalParameters
```
public final java.util.Set<java.lang.String> getAdditionalParameters()
```
    Gets the list of parameters' name.
    
    Returns:
    
    The additional parameters of this job.
    
    See Also:
    
    UWSParameters.getNames()
  - getNbAdditionalParameters
```
public final int getNbAdditionalParameters()
```
    Gets the number of additional parameters.
    
    Returns:
    
    Number of additional parameters.
  - getAdditionalParameterValue
```
public final java.lang.Object getAdditionalParameterValue(java.lang.String paramName)
```
    Gets the value of the specified additional parameter.
    
    Parameters:
    
    paramName - The name of the parameter whose the value is wanted.
    
    Returns:
    
    The value of the specified parameter or null if it doesn't exist.
  - addOrUpdateParameter
```
public final boolean addOrUpdateParameter(java.lang.String paramName,
                                          java.lang.Object paramValue)
                                   throws UWSException
```
    Adds or updates the specified parameter with the given value ONLY IF the job can be updated (considering its current execution phase, see JobPhase.isJobUpdatable()).
    Important note: If the given parameter value is an UploadFile and that it is impossible to move it close to the job, this parameter will be removed. No error is thrown, but a warning message is logged.
    
    Parameters:
    
    paramName - The name of the parameter to add or to update.
    
    paramValue - The (new) value of the specified parameter.
    
    Returns:
    
    true if the parameter has been successfully added/updated, false otherwise (particularly if paramName=null or paramName="" or paramValue=null).
    
    Throws:
    
    UWSException - If a parameter value is incorrect.
    
    See Also:
    
    JobPhase.isJobUpdatable()
  - addOrUpdateParameter
```
public final boolean addOrUpdateParameter(java.lang.String paramName,
                                          java.lang.Object paramValue,
                                          JobOwner user)
                                   throws UWSException
```
    Adds or updates the specified parameter with the given value ONLY IF the job can be updated (considering its current execution phase, see JobPhase.isJobUpdatable()).
    Important note: If the given parameter value is an UploadFile and that it is impossible to move it close to the job, this parameter will be removed. No error is thrown, but a warning message is logged.
    
    Parameters:
    
    paramName - The name of the parameter to add or to update.
    
    paramValue - The (new) value of the specified parameter.
    
    user - The user who asks for this update.
    
    Returns:
    
    true if the parameter has been successfully added/updated, false otherwise (particularly if paramName=null or paramName="" or paramValue=null).
    
    Throws:
    
    UWSException - If a parameter value is incorrect.
    
    Since:
    
    4.1
    
    See Also:
    
    JobPhase.isJobUpdatable()
  - addOrUpdateParameters
```
public boolean addOrUpdateParameters(UWSParameters params)
                              throws UWSException
```
    Adds or updates the given parameters ONLY IF the job can be updated (considering its current execution phase, see JobPhase.isJobUpdatable()).
    At the end of this function, the method applyPhaseParam(JobOwner) is called so that if there is an additional parameter PARAM_PHASE with the value:
    - RUN then the job is starting and the phase goes to EXECUTING.
    - ABORT then the job is aborting.
    - otherwise the parameter PARAM_PHASE is removed from inputParams and nothing is done.
    Important note: If a given parameter value is an UploadFile and that it is impossible to move it close to the job, this parameter will be removed. No error is thrown, but a warning message is logged.
    Parameters:
    
    params - A list of parameters to add/update.
    
    Returns:
    
    true if all the given parameters have been successfully added/updated, false if some parameters have not been managed.
    
    Throws:
    
    UWSException - If a parameter value is incorrect.
    
    See Also:
    
    addOrUpdateParameters(UWSParameters, JobOwner)
  - getCreationTime
```
public final java.util.Date getCreationTime()
```
    Gets the creation date/time of this job.
    
    Returns:
    
    The job creation date/time.
    
    Since:
    
    4.3
  - addOrUpdateParameters
```
public boolean addOrUpdateParameters(UWSParameters params,
                                     JobOwner user)
                              throws UWSException
```
    Adds or updates the given parameters ONLY IF the job can be updated (considering its current execution phase, see JobPhase.isJobUpdatable()).
    At the end of this function, the method applyPhaseParam(JobOwner) is called so that if there is an additional parameter PARAM_PHASE with the value:
    - RUN then the job is starting and the phase goes to EXECUTING.
    - ABORT then the job is aborting.
    - otherwise the parameter PARAM_PHASE is removed from inputParams and nothing is done.
    Important note: If a given parameter value is an UploadFile and that it is impossible to move it close to the job, this parameter will be removed. No error is thrown, but a warning message is logged.
    Parameters:
    
    params - The UWS parameters to update.
    
    user - The user who asks for this update.
    
    Returns:
    
    true if all the given parameters have been successfully added/updated, false if some parameters have not been managed.
    
    Throws:
    
    UWSException - If a parameter value is incorrect or if the given user can not update or execute this job.
    
    See Also:
    
    JobPhase.isJobUpdatable(), applyPhaseParam(JobOwner)
  - removeAdditionalParameter
```
public final boolean removeAdditionalParameter(java.lang.String paramName)
```
    Removes the specified additional parameter ONLY IF the job can be updated (considering its current execution phase, see JobPhase.isJobUpdatable()).
    
    Parameters:
    
    paramName - The name of the parameter to remove.
    
    Returns:
    
    true if the parameter has been successfully removed, false otherwise.
    
    See Also:
    
    JobPhase.isJobUpdatable(), UWSParameters.remove(String)
  - getResults
```
public final java.util.Iterator<Result> getResults()
```
    Gets the results list of this job.
    
    Returns:
    
    An iterator on the results list.
  - getResult
```
public final Result getResult(java.lang.String resultId)
```
    Gets the specified result.
    
    Parameters:
    
    resultId - ID of the result to return.
    
    Returns:
    
    The corresponding result.
  - getNbResults
```
public final int getNbResults()
```
    Gets the total number of results.
    
    Returns:
    
    The number of results.
  - addResult
```
public boolean addResult(Result res)
                  throws UWSException
```
    Adds the given result in the results list of this job.
    IMPORTANT: This function will throw an error if the job is finished.
    
    Parameters:
    
    res - The result to add (not null).
    
    Returns:
    
    true if the result has been successfully added, false otherwise (for instance, if a result has the same ID).
    
    Throws:
    
    UWSException - If the job execution is finished that is to say if the phase is ABORTED, ERROR, COMPLETED or ARCHIVED.
    
    See Also:
    
    isFinished()
  - getJobInfo
```
public final JobInfo getJobInfo()
```
    Get the additional information about this job.
    
    Returns:
    
    Additional info. about this job, or NULL if there is none.
    
    Since:
    
    4.2
  - setJobInfo
```
public void setJobInfo(JobInfo newJobInfo)
```
    Set the additional information about this job.
    Note: By default, this function replaces the current JobInfo of this job by the given one (even if NULL). This behavior can be changed by overwriting this function and by returning the extended UWSJob in the used UWSFactory.
    
    Important note: When attributing a JobInfo to a UWSJob, you may have to call JobInfo.setJob(UWSJob) on the former and the new jobInfo (see the default implementation for an example) for some implementations of JobInfo.
    
    Parameters:
    
    newJobInfo - The new additional info. about this job. NULL is allowed and should be used to remove a JobInfo from a job.
    
    Since:
    
    4.2
  - getExecutionManager
```
public final ExecutionManager getExecutionManager()
```
    Gets the execution manager of this job, if any.
    
    Returns:
    
    Its execution manager (may be null).
  - getJobList
```
public final JobList getJobList()
```
    Gets its jobs list, if known.
    
    Returns:
    
    Its jobs list (may be null).
  - setJobList
```
protected final void setJobList(JobList jobList)
                         throws java.lang.IllegalStateException
```
    Sets its jobs list.
    Note 1: A job can change its jobs list ONLY WHILE PENDING!
    
    Note 2: This job is removed from its previous job list, if there is one.
    
    Note 3: This job is NOT automatically added into the new jobs list. Indeed, this function should be called by JobList.addNewJob(UWSJob).
    
    Parameters:
    
    jobList - Its new jobs list. Note: if NULL, nothing is done!
    
    Throws:
    
    java.lang.IllegalStateException - If this job is not PENDING.
    
    See Also:
    
    JobList.removeJob(String), JobList.getJob(String)
  - getUrl
```
public final UWSUrl getUrl()
```
    Gets the UWS URL of this job in function of its jobs list.
    
    Returns:
    
    Its corresponding UWSUrl.
    
    See Also:
    
    JobList.getUrl(), UWSUrl.jobSummary(String, String)
  - getTimeToWaitForEnd
```
public final long getTimeToWaitForEnd()
```
    Gets the time to wait for the end of the thread after an interruption.
    
    Returns:
    
    The time to wait for the end of the thread (a negative or null value means no wait for the end of the thread).
  - setTimeToWaitForEnd
```
public final void setTimeToWaitForEnd(long timeToWait)
```
    Sets the time to wait for the end of the thread after an interruption.
    
    Parameters:
    
    timeToWait - The new time to wait for the end of the thread (a negative or null value means no wait for the end of the thread).
  - start
```
public final void start()
                 throws UWSException
```
    Starts the job by using the execution manager if any.
    
    Throws:
    
    UWSException
  - start
```
public void start(boolean useManager)
           throws UWSException
```
    Starts the job.
    Note: This function does nothing if the job is already running!
    
    Parameters:
    
    useManager - true to let the execution manager deciding whether the job starts immediately or whether it must be put in a queue until enough resources are available, false to start the execution immediately.
    
    Throws:
    
    java.lang.NullPointerException - If this job is not associated with a job list or the associated job list is not part of a UWS service or if no thread is created.
    
    UWSException - If there is an error while changing the execution phase or when starting the corresponding thread.
    
    See Also:
    
    isRunning(), UWSFactory.createJobThread(UWSJob), ExecutionManager.execute(UWSJob), setPhase(ExecutionPhase), isFinished(), startTime
  - isRunning
```
public final boolean isRunning()
```
    Tells whether the job is still running.
    Note: This function tests the execution phase (see JobPhase.isExecuting()) AND the status of the thread (see isStopped()).
    
    Returns:
    
    true if the job is still running, false otherwise.
    
    See Also:
    
    JobPhase.isExecuting(), isStopped()
  - isFinished
```
public final boolean isFinished()
```
    Tells whether the job is already finished (completed, aborted, error, archived, ...).
    Note: This function test the execution phase (see JobPhase.isFinished()) AND the status of the thread (see isStopped()).
    
    Returns:
    
    true if the job is finished, false otherwise.
    
    See Also:
    
    JobPhase.isFinished(), isStopped()
  - abort
```
public void abort()
           throws UWSException
```
    Stops immediately the job, sets its phase to ABORTED and sets its end time.
    IMPORTANT: If the thread does not stop immediately the phase and the end time are not modified. However it can be done by calling one more time abort(). Besides you should check that you test regularly the interrupted flag of the thread in JobThread.jobWork()!
    
    Throws:
    
    UWSException - If there is an error while changing the execution phase.
    
    See Also:
    
    stop(), isStopped(), setPhase(ExecutionPhase), setEndTime(Date)
  - error
```
public void error(ErrorSummary error)
           throws UWSException
```
    Stops immediately the job, sets its error summary, sets its phase to ExecutionPhase.ERROR and sets its end time.
    IMPORTANT: If the thread does not stop immediately the phase, the error summary and the end time are not modified. However it can be done by calling one more time error(ErrorSummary). Besides you should check that you test regularly the interrupted flag of the thread in JobThread.jobWork()!
    
    Parameters:
    
    error - The error that has interrupted this job.
    
    Throws:
    
    UWSException - If there is an error while setting the error summary or while changing the phase.
    
    See Also:
    
    stop(), isStopped(), JobPhase.isFinished(), setErrorSummary(ErrorSummary), setPhase(ExecutionPhase), setEndTime(Date)
  - stop
```
protected void stop()
```
    Stops the thread that executes the work of this job.
  - isStopped
```
protected final boolean isStopped()
```
    Tells whether the thread is different from null, is not alive or is finished (see JobThread.isFinished()).
    Important note: Having the interrupted flag set to true is not enough to consider the job as stopped. So, if the job has been interrupted but is still running, it should mean that the JobThread.jobWork() does not check the interrupted flag of the thread often enough or not at the right moments. In such case, the job can not be considered as stopped/aborted - so the phase stays EXECUTING - until the thread is "unblocked" and the interruption is detected.
    
    Returns:
    
    true if the thread is not still running, false otherwise.
  - archive
```
public boolean archive()
```
    Archive this job.
    An archive job can not be executed any more. Threads, results and input files are destroyed but the description and the error summary of the job stay unchanged (except the execution phase which will then be ARCHIVED).
    
    Note: The current phase is stored as job information (only if no JobInfo is already set) in order to satisfy the user curiosity (i.e. "in what phase was this job before being archived?").
    
    Returns:
    
    true if this job has been successfully archived, false otherwise.
    
    Throws:
    
    UWSException - If any error occurs while clearing resources or changing the phase of this job.
    
    Since:
    
    4.3
  - clearResources
```
public void clearResources()
```
    Stops the job if running, removes the job from the execution manager, stops the timer for the execution duration.
    Besides, ALL files AND ANY other resources (e.g. thread) associated with this job are destroyed.
    
    See Also:
    
    clearResources(boolean)
  - clearResources
```
public void clearResources(boolean fullClean)
```
    Stops the job if running, removes the job from the execution manager, stops the timer for the execution duration.
    Besides, resources (e.g. thread) associated with this job are freed. Depending on the given parameter, all (true) or just input and result files (false) are destroyed.
    
    Parameters:
    
    fullClean - Indicate whether all resources or just some input and result files must be freed. true to stop the job and delete everything (input files, results, jobInfos and error summary), or false to stop the job and delete only all input files and results but not the jobInfos, the error summary and the other parameters.
    
    Since:
    
    4.3
  - addObserver
```
public final boolean addObserver(JobObserver observer)
```
    Lets adding an observer of this job. The observer will be notified each time the execution phase changes.
    
    Parameters:
    
    observer - A new observer of this job.
    
    Returns:
    
    true if the given object has been successfully added as observer of this job, false otherwise.
  - getNbObservers
```
public final int getNbObservers()
```
    Gets the total number of observers this job has.
    
    Returns:
    
    Number of its observers.
  - getObservers
```
public final java.util.Iterator<JobObserver> getObservers()
```
    Gets the observers of this job.
    
    Returns:
    
    An iterator on the list of its observers.
  - removeObserver
```
public final boolean removeObserver(JobObserver observer)
```
    Lets removing the given object from the list of observers of this job.
    
    Parameters:
    
    observer - The object which must not be considered as observer of this job.
    
    Returns:
    
    true if the given object is not any more an observer of this job, false otherwise.
  - removeAllObservers
```
public final void removeAllObservers()
```
    Lets removing all observers of this job.
  - notifyObservers
```
public final void notifyObservers(ExecutionPhase oldPhase)
```
    Notifies all the observer of this job that its phase has changed.
    
    Parameters:
    
    oldPhase - The former phase of this job.
    
    Throws:
    
    UWSException - If at least one observer can not have been updated.
  - getWorkError
```
public final UWSException getWorkError()
```
    Gets the error (if any) which has occurred during the job execution.
    Note: In the case an error summary can not have been published, the job has no error summary. However the last UWSException caught during the execution of a JobThread is saved and is available thanks to JobThread.getError(). In that case, the getWorkError() method can be used to get back the occurred error.
    
    Returns:
    
    The error which interrupts the thread or null if there was no error or if the job is still running.
  - serialize
```
public java.lang.String serialize(UWSSerializer serializer,
                                  JobOwner user)
                           throws UWSException,
                                  java.lang.Exception
```
    Description copied from class: SerializableUWSObject
    
    Serializes the whole object considering the given owner (supposed to be the current user) and thanks to the given serializer.
    
    Specified by:
    
    serialize in class SerializableUWSObject
    
    Parameters:
    
    serializer - The serializer to use.
    
    user - The current user.
    
    Returns:
    
    The serialized representation of this object.
    
    Throws:
    
    UWSException - If the owner is not allowed to see the content of the serializable object.
    
    java.lang.Exception - If there is any other error during the serialization.
  - serialize
```
public java.lang.String serialize(java.lang.String[] attributes,
                                  UWSSerializer serializer)
                           throws java.lang.Exception
```
    Serializes the specified attribute of this job by using the given serializer.
    
    Parameters:
    
    attributes - All the given attributes. May be null or empty.
    
    serializer - The serializer to use.
    
    Returns:
    
    The serialized job attribute (or the whole job if attributes is an empty array or is null).
    
    Throws:
    
    java.lang.Exception - If there is an unexpected error during the serialization.
    
    See Also:
    
    UWSSerializer.getJob(UWSJob, String[], boolean)
  - serialize
```
public void serialize(javax.servlet.ServletOutputStream output,
                      java.lang.String[] attributes,
                      UWSSerializer serializer)
               throws UWSException,
                      java.io.IOException,
                      java.lang.Exception
```
    Serializes the specified attribute of this job in the given output stream by using the given serializer.
    
    Parameters:
    
    output - The output stream in which the job attribute must be serialized.
    
    attributes - The name of the attribute to serialize (if null, the whole job will be serialized).
    
    serializer - The serializer to use.
    
    Throws:
    
    java.lang.Exception - If there is an unexpected error during the serialization.
    
    UWSException
    
    java.io.IOException
    
    See Also:
    
    serialize(String[], UWSSerializer)
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object anotherJob)
```
    2 instances of AbstractJob are equals ONLY IF their ID are equals.
    Note: If the given object is not an AbstractJob, FALSE is returned.
    
    Overrides:
    
    equals in class java.lang.Object
    
    See Also:
    
    Object.equals(java.lang.Object)

Class UWSJob

Brief description

Some attributes comments

More details

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class uws.job.SerializableUWSObject

Methods inherited from class java.lang.Object

Field Detail

PARAM_ACTION

ACTION_DELETE

PARAM_JOB_ID

PARAM_CREATION_TIME

PARAM_RUN_ID

PARAM_OWNER

PARAM_PHASE

PHASE_RUN

PHASE_ABORT

PARAM_QUOTE

PARAM_START_TIME

PARAM_END_TIME

PARAM_EXECUTION_DURATION

PARAM_DESTRUCTION_TIME

PARAM_ERROR_SUMMARY

PARAM_PARAMETERS

PARAM_RESULTS

PARAM_JOB_INFO

ANONYMOUS_OWNER

DEFAULT_DATE_FORMAT

QUOTE_NOT_KNOWN

UNLIMITED_DURATION

lastId

jobId

creationTime

owner

dateFormat

errorSummary

results

inputParams

jobInfo

thread

waitForStop

stopping

Constructor Detail

UWSJob

UWSJob

UWSJob

UWSJob

Method Detail

generateJobId

getParameter

applyPhaseParam

getFileManager

getLogger

getFactory

getRestorationDate

getPhase

setPhase

setPhase

getPhaseManager

setPhaseManager

getStartTime

setStartTime

getEndTime

setEndTime

getExecutionDuration

setExecutionDuration

getDestructionTime

setDestructionTime

getErrorSummary

setErrorSummary

getJobId

getRunId

setRunId

getOwner

getQuote

setQuote

getAdditionalParameters