|
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
org.quartz.impl Class JobDetailImpl
java.lang.Objectorg.quartz.impl.JobDetailImpl
- All Implemented Interfaces:
- Serializable, Cloneable, JobDetail
public class JobDetailImpl
- extends Object
- implements Cloneable, Serializable, JobDetail
Conveys the detail properties of a given Job instance.
Quartz does not store an actual instance of a Job class, but
instead allows you to define an instance of one, through the use of a JobDetail.
Jobs have a name and group associated with them, which
should uniquely identify them within a single Scheduler.
Triggers are the 'mechanism' by which Jobs
are scheduled. Many Triggers can point to the same Job,
but a single Trigger can only point to one Job.
- Author:
- James House, Sharada Jambula
- See Also:
Job,StatefulJob,JobDataMap,Trigger, Serialized Form
| Constructor Summary | |
|---|---|
JobDetailImpl()
Create a JobDetail with no specified name or group, and
the default settings of all the other properties. |
|
JobDetailImpl(String name,
Class<? extends Job> jobClass)
Deprecated. use JobBuilder |
|
JobDetailImpl(String name,
String group,
Class<? extends Job> jobClass)
Deprecated. use JobBuilder |
|
JobDetailImpl(String name,
String group,
Class<? extends Job> jobClass,
boolean durability,
boolean recover)
Deprecated. use JobBuilder |
|
| Method Summary | |
|---|---|
Object |
clone()
|
boolean |
equals(Object obj)
|
String |
getDescription()
Return the description given to the Job instance by its
creator (if any). |
String |
getFullName()
Returns the 'full name' of the JobDetail in the format
"group.name". |
String |
getGroup()
Get the group of this Job. |
JobBuilder |
getJobBuilder()
Get a JobBuilder that is configured to produce a
JobDetail identical to this one. |
Class<? extends Job> |
getJobClass()
Get the instance of Job that will be executed. |
JobDataMap |
getJobDataMap()
Get the JobDataMap that is associated with the Job. |
JobKey |
getKey()
|
String |
getName()
Get the name of this Job. |
int |
hashCode()
|
boolean |
isConcurrentExectionDisallowed()
|
boolean |
isDurable()
Whether or not the Job should remain stored after it is
orphaned (no Triggers point to it). |
boolean |
isPersistJobDataAfterExecution()
|
boolean |
requestsRecovery()
Instructs the Scheduler whether or not the Job
should be re-executed if a 'recovery' or 'fail-over' situation is
encountered. |
void |
setDescription(String description)
Set a description for the Job instance - may be useful
for remembering/displaying the purpose of the job, though the
description has no meaning to Quartz. |
void |
setDurability(boolean durability)
Set whether or not the Job should remain stored after it
is orphaned (no Triggers point to it). |
void |
setGroup(String group)
Set the group of this Job. |
void |
setJobClass(Class<? extends Job> jobClass)
Set the instance of Job that will be executed. |
void |
setJobDataMap(JobDataMap jobDataMap)
Set the JobDataMap to be associated with the Job. |
void |
setKey(JobKey key)
|
void |
setName(String name)
Set the name of this Job. |
void |
setRequestsRecovery(boolean shouldRecover)
Set whether or not the the Scheduler should re-execute
the Job if a 'recovery' or 'fail-over' situation is
encountered. |
String |
toString()
Return a simple string representation of this object. |
| Methods inherited from class java.lang.Object |
|---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
| Constructor Detail |
|---|
JobDetailImpl
public JobDetailImpl()
Create a
JobDetailwith no specified name or group, and the default settings of all the other properties.Note that the
setName(String),setGroup(String)andsetJobClass(Class)methods must be called before the job can be placed into aScheduler
JobDetailImpl
public JobDetailImpl(String name, Class<? extends Job> jobClass)
- Deprecated. use
JobBuilder Create a
JobDetailwith the given name, given class, default group, and the default settings of all the other properties.- Parameters:
group- ifnull, Scheduler.DEFAULT_GROUP will be used.- Throws:
IllegalArgumentException- if name is null or empty, or the group is an empty string.
JobDetailImpl
public JobDetailImpl(String name, String group, Class<? extends Job> jobClass)
- Deprecated. use
JobBuilder Create a
JobDetailwith the given name, group and class, and the default settings of all the other properties.- Parameters:
group- ifnull, Scheduler.DEFAULT_GROUP will be used.- Throws:
IllegalArgumentException- if name is null or empty, or the group is an empty string.
JobDetailImpl
public JobDetailImpl(String name, String group, Class<? extends Job> jobClass, boolean durability, boolean recover)
- Deprecated. use
JobBuilder Create a
JobDetailwith the given name, and group, and the given settings of all the other properties.- Parameters:
group- ifnull, Scheduler.DEFAULT_GROUP will be used.- Throws:
IllegalArgumentException- if name is null or empty, or the group is an empty string.
| Method Detail |
|---|
getName
public String getName()
Get the name of this
Job.
setName
public void setName(String name)
Set the name of this
Job.- Throws:
IllegalArgumentException- if name is null or empty.
getGroup
public String getGroup()
Get the group of this
Job.
setGroup
public void setGroup(String group)
Set the group of this
Job.- Parameters:
group- ifnull, Scheduler.DEFAULT_GROUP will be used.- Throws:
IllegalArgumentException- if the group is an empty string.
getFullName
public String getFullName()
Returns the 'full name' of the
JobDetailin the format "group.name".
getKey
public JobKey getKey()
setKey
public void setKey(JobKey key)
getDescription
public String getDescription()
- Description copied from interface:
JobDetail Return the description given to the
Jobinstance by its creator (if any).- Specified by:
getDescriptionin interfaceJobDetail
- Returns:
- null if no description was set.
setDescription
public void setDescription(String description)
Set a description for the
Jobinstance - may be useful for remembering/displaying the purpose of the job, though the description has no meaning to Quartz.
getJobClass
public Class<? extends Job> getJobClass()
- Description copied from interface:
JobDetail Get the instance of
Jobthat will be executed.- Specified by:
getJobClassin interfaceJobDetail
setJobClass
public void setJobClass(Class<? extends Job> jobClass)
Set the instance of
Jobthat will be executed.- Throws:
IllegalArgumentException- if jobClass is null or the class is not aJob.
getJobDataMap
public JobDataMap getJobDataMap()
- Description copied from interface:
JobDetail Get the
JobDataMapthat is associated with theJob.- Specified by:
getJobDataMapin interfaceJobDetail
setJobDataMap
public void setJobDataMap(JobDataMap jobDataMap)
Set the
JobDataMapto be associated with theJob.
setDurability
public void setDurability(boolean durability)
Set whether or not the
Jobshould remain stored after it is orphaned (noTriggers point to it).If not explicitly set, the default value is
false.
setRequestsRecovery
public void setRequestsRecovery(boolean shouldRecover)
Set whether or not the the
Schedulershould re-execute theJobif a 'recovery' or 'fail-over' situation is encountered.If not explicitly set, the default value is
false.- See Also:
JobExecutionContext.isRecovering()
isDurable
public boolean isDurable()
- Description copied from interface:
JobDetail Whether or not the
Jobshould remain stored after it is orphaned (noTriggers point to it).If not explicitly set, the default value is
false.- Returns:
trueif the Job should remain persisted after being orphaned.
isPersistJobDataAfterExecution
public boolean isPersistJobDataAfterExecution()
- Specified by:
isPersistJobDataAfterExecutionin interfaceJobDetail
- Returns:
- whether the associated Job class carries the
PersistJobDataAfterExecutionannotation. - See Also:
PersistJobDataAfterExecution
isConcurrentExectionDisallowed
public boolean isConcurrentExectionDisallowed()
- Specified by:
isConcurrentExectionDisallowedin interfaceJobDetail
- Returns:
- whether the associated Job class carries the
DisallowConcurrentExecutionannotation. - See Also:
DisallowConcurrentExecution
requestsRecovery
public boolean requestsRecovery()
- Description copied from interface:
JobDetail Instructs the
Schedulerwhether or not theJobshould be re-executed if a 'recovery' or 'fail-over' situation is encountered.If not explicitly set, the default value is
false.- Specified by:
requestsRecoveryin interfaceJobDetail
- See Also:
JobExecutionContext.isRecovering()
toString
public String toString()
equals
public boolean equals(Object obj)
hashCode
public int hashCode()
clone
public Object clone()
getJobBuilder
public JobBuilder getJobBuilder()
- Description copied from interface:
JobDetail - Get a
JobBuilderthat is configured to produce aJobDetailidentical to this one. - Specified by:
getJobBuilderin interfaceJobDetail
|
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2001-2011, Terracotta, Inc.
org.quartz.impl.JobDetailImpl