|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
org.quartz.impl Class JobDetailImpl
java.lang.Object org.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
.
Job
s have a name and group associated with them, which
should uniquely identify them within a single Scheduler
.
Trigger
s are the 'mechanism' by which Job
s
are scheduled. Many Trigger
s 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
Trigger s 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
Trigger s 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
JobDetail
with 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
JobDetail
with 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
JobDetail
with 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
JobDetail
with 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
JobDetail
in 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
Job
instance by its creator (if any).- Specified by:
getDescription
in interfaceJobDetail
- Returns:
- null if no description was set.
setDescription
public 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.
getJobClass
public Class<? extends Job> getJobClass()
- Description copied from interface:
JobDetail
Get the instance of
Job
that will be executed.- Specified by:
getJobClass
in interfaceJobDetail
setJobClass
public void setJobClass(Class<? extends Job> jobClass)
Set the instance of
Job
that 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
JobDataMap
that is associated with theJob
.- Specified by:
getJobDataMap
in interfaceJobDetail
setJobDataMap
public void setJobDataMap(JobDataMap jobDataMap)
Set the
JobDataMap
to be associated with theJob
.
setDurability
public void setDurability(boolean durability)
Set whether or not the
Job
should remain stored after it is orphaned (noTrigger
s point to it).If not explicitly set, the default value is
false
.
setRequestsRecovery
public void setRequestsRecovery(boolean shouldRecover)
Set whether or not the the
Scheduler
should re-execute theJob
if 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
Job
should remain stored after it is orphaned (noTrigger
s point to it).If not explicitly set, the default value is
false
.- Returns:
true
if the Job should remain persisted after being orphaned.
isPersistJobDataAfterExecution
public boolean isPersistJobDataAfterExecution()
- Specified by:
isPersistJobDataAfterExecution
in interfaceJobDetail
- Returns:
- whether the associated Job class carries the
PersistJobDataAfterExecution
annotation. - See Also:
PersistJobDataAfterExecution
isConcurrentExectionDisallowed
public boolean isConcurrentExectionDisallowed()
- Specified by:
isConcurrentExectionDisallowed
in interfaceJobDetail
- Returns:
- whether the associated Job class carries the
DisallowConcurrentExecution
annotation. - See Also:
DisallowConcurrentExecution
requestsRecovery
public boolean requestsRecovery()
- Description copied from interface:
JobDetail
Instructs the
Scheduler
whether or not theJob
should be re-executed if a 'recovery' or 'fail-over' situation is encountered.If not explicitly set, the default value is
false
.- Specified by:
requestsRecovery
in 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
JobBuilder
that is configured to produce aJobDetail
identical to this one. - Specified by:
getJobBuilder
in interfaceJobDetail
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright 2001-2011, Terracotta, Inc.