接口 JobRepository
- 所有已知实现类:
SimpleJobRepository
public interface JobRepository
Repository responsible for persistence of batch meta-data entities.
- 作者:
- Lucas Ward, Dave Syer, Robert Kasanicky, David Turanski, Michael Minella, Mahmoud Ben Hassine
- 另请参阅:
JobInstance
,JobExecution
,StepExecution
方法概要
所有方法 实例方法 抽象方法 修饰符和类型 方法 说明 void
add(StepExecution stepExecution)
Save theStepExecution
and itsExecutionContext
.void
addAll(java.util.Collection<StepExecution> stepExecutions)
Save a collection ofStepExecution
s and eachExecutionContext
.JobExecution
createJobExecution(java.lang.String jobName, JobParameters jobParameters)
JobExecution
createJobExecution(JobInstance jobInstance, JobParameters jobParameters, java.lang.String jobConfigurationLocation)
Create a newJobExecution
based upon theJobInstance
it's associated with, theJobParameters
used to execute it with and the location of the configuration file that defines the job.JobInstance
createJobInstance(java.lang.String jobName, JobParameters jobParameters)
Create a newJobInstance
with the name and job parameters provided.JobExecution
getLastJobExecution(java.lang.String jobName, JobParameters jobParameters)
StepExecution
getLastStepExecution(JobInstance jobInstance, java.lang.String stepName)
int
getStepExecutionCount(JobInstance jobInstance, java.lang.String stepName)
boolean
isJobInstanceExists(java.lang.String jobName, JobParameters jobParameters)
Check if an instance of this job already exists with the parameters provided.void
update(JobExecution jobExecution)
Update theJobExecution
(but not itsExecutionContext
).void
update(StepExecution stepExecution)
Update theStepExecution
(but not itsExecutionContext
).void
updateExecutionContext(JobExecution jobExecution)
Persist the updatedExecutionContext
of the givenJobExecution
.void
updateExecutionContext(StepExecution stepExecution)
Persist the updatedExecutionContext
s of the givenStepExecution
.
方法详细资料
isJobInstanceExists
boolean isJobInstanceExists(java.lang.String jobName, JobParameters jobParameters)
Check if an instance of this job already exists with the parameters provided.- 参数:
jobName
- the name of the jobjobParameters
- the parameters to match- 返回:
- true if a
JobInstance
already exists for this job name and job parameters
createJobInstance
JobInstance createJobInstance(java.lang.String jobName, JobParameters jobParameters)
Create a newJobInstance
with the name and job parameters provided.- 参数:
jobName
- logical name of the jobjobParameters
- parameters used to execute the job- 返回:
- the new
JobInstance
createJobExecution
JobExecution createJobExecution(JobInstance jobInstance, JobParameters jobParameters, java.lang.String jobConfigurationLocation)
Create a newJobExecution
based upon theJobInstance
it's associated with, theJobParameters
used to execute it with and the location of the configuration file that defines the job.- 参数:
jobInstance
-JobInstance
instance to initialize the new JobExecution.jobParameters
-JobParameters
instance to initialize the new JobExecution.jobConfigurationLocation
-String
instance to initialize the new JobExecution.- 返回:
- the new
JobExecution
.
createJobExecution
JobExecution createJobExecution(java.lang.String jobName, JobParameters jobParameters) throws JobExecutionAlreadyRunningException, JobRestartException, JobInstanceAlreadyCompleteException
Create a
JobExecution
for a givenJob
andJobParameters
. If matchingJobInstance
already exists, the job must be restartable and it's last JobExecution must *not* be completed. If matchingJobInstance
does not exist yet it will be created.If this method is run in a transaction (as it normally would be) with isolation level at
Isolation.REPEATABLE_READ
or better, then this method should block if another transaction is already executing it (for the sameJobParameters
and job name). The first transaction to complete in this scenario obtains a validJobExecution
, and others throwJobExecutionAlreadyRunningException
(or timeout). There are no such guarantees if theJobInstanceDao
andJobExecutionDao
do not respect the transaction isolation levels (e.g. if using a non-relational data-store, or if the platform does not support the higher isolation levels).- 参数:
jobName
- the name of the job that is to be executedjobParameters
- the runtime parameters for the job- 返回:
- a valid
JobExecution
for the arguments provided - 抛出:
JobExecutionAlreadyRunningException
- if there is aJobExecution
already running for the job instance with the provided job and parameters.JobRestartException
- if one or more existingJobInstance
s is found with the same parameters andJob.isRestartable()
is false.JobInstanceAlreadyCompleteException
- if aJobInstance
is found and was already completed successfully.
update
void update(JobExecution jobExecution)
Update theJobExecution
(but not itsExecutionContext
). Preconditions:JobExecution
must contain a validJobInstance
and be saved (have an id assigned).- 参数:
jobExecution
-JobExecution
instance to be updated in the repo.
add
void add(StepExecution stepExecution)
Save theStepExecution
and itsExecutionContext
. ID will be assigned - it is not permitted that an ID be assigned before calling this method. Instead, it should be left blank, to be assigned by aJobRepository
. Preconditions:StepExecution
must have a validStep
.- 参数:
stepExecution
-StepExecution
instance to be added to the repo.
addAll
void addAll(java.util.Collection<StepExecution> stepExecutions)
Save a collection ofStepExecution
s and eachExecutionContext
. The StepExecution ID will be assigned - it is not permitted that an ID be assigned before calling this method. Instead, it should be left blank, to be assigned byJobRepository
. Preconditions:StepExecution
must have a validStep
.- 参数:
stepExecutions
- collection ofStepExecution
instances to be added to the repo.
update
void update(StepExecution stepExecution)
Update theStepExecution
(but not itsExecutionContext
). Preconditions:StepExecution
must be saved (have an id assigned).- 参数:
stepExecution
-StepExecution
instance to be updated in the repo.
updateExecutionContext
void updateExecutionContext(StepExecution stepExecution)
Persist the updatedExecutionContext
s of the givenStepExecution
.- 参数:
stepExecution
-StepExecution
instance to be used to update the context.
updateExecutionContext
void updateExecutionContext(JobExecution jobExecution)
Persist the updatedExecutionContext
of the givenJobExecution
.- 参数:
jobExecution
-JobExecution
instance to be used to update the context.
getLastStepExecution
@Nullable StepExecution getLastStepExecution(JobInstance jobInstance, java.lang.String stepName)
- 参数:
jobInstance
-JobInstance
instance containing the step executions.stepName
- the name of the step execution that might have run.- 返回:
- the last execution of step for the given job instance.
getStepExecutionCount
int getStepExecutionCount(JobInstance jobInstance, java.lang.String stepName)
- 参数:
jobInstance
-JobInstance
instance containing the step executions.stepName
- the name of the step execution that might have run.- 返回:
- the execution count of the step within the given job instance.
getLastJobExecution
@Nullable JobExecution getLastJobExecution(java.lang.String jobName, JobParameters jobParameters)
- 参数:
jobName
- the name of the job that might have runjobParameters
- parameters identifying theJobInstance
- 返回:
- the last execution of job if exists, null otherwise