org.oddjob.jobs.structural
Class JobFolder

java.lang.Object
  org.oddjob.jobs.structural.JobFolder

All Implemented Interfaces:

Iconic, Structural

public class JobFolder
extends Object
implements Structural, Iconic

Description

Holds a collection of jobs but does not execute them. Used to collect and organise jobs. The jobs can either be scheduled by a scheduler or run manually.

A folder has no state, it can't be run and it can't be stopped.

Example

A folder of jobs.

<folder name="My Jobs">
    <jobs>
        <exec name="Morning Job">echo "Good Morning"</exec>
        <exec name="Afternoon Job">echo "Good Afternoon"</exec>
        <exec name="Evening Job">echo "Good Evening"</exec>
    </jobs>
</folder>

Author:

Rob Gordon

Field Summary

protected ChildHelper<Object>	childHelper Child helper.
protected boolean	destroyed This flag is set once the object is destroyed Methods in subclass should check this flag.

Constructor Summary

JobFolder()

Method Summary

void	addIconListener(IconListener listener) Add an icon listener.
void	addStructuralListener(StructuralListener listener) Add a listener.
void	configured()
void	destroy() Destroy this component.
String	getName() Get the job name.
IconTip	iconForId(String iconId) Return an icon tip for a given id.
void	initialised()
void	removeIconListener(IconListener listener) Remove an icon listener.
void	removeStructuralListener(StructuralListener listener) Remove a listener.
void	setJobs(int index, Object child) Add a child.
void	setName(String name) Set the job name.
String	toString() Override toString.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

childHelper

protected ChildHelper<Object> childHelper

Child helper.

destroyed

protected transient volatile boolean destroyed

This flag is set once the object is destroyed Methods in subclass should check this flag.

Constructor Detail

JobFolder

public JobFolder()

Method Detail

setName

public void setName(String name)

Set the job name. Used by subclasses to set the job name.

Parameters:

name - The name of the job.

getName

public String getName()

Get the job name.

Returns:

The job name.

setJobs

public void setJobs(int index,
                    Object child)

Add a child.

Property: jobs

Description: The jobs.

Required: No.

Parameters:

child - A child

addStructuralListener

public void addStructuralListener(StructuralListener listener)

Add a listener. The listener will immediately recieve add notifications for all existing children.

Specified by:

addStructuralListener in interface Structural

Parameters:

listener - The listener.

removeStructuralListener

public void removeStructuralListener(StructuralListener listener)

Remove a listener.

Specified by:

removeStructuralListener in interface Structural

Parameters:

listener - The listner.

toString

public String toString()

Override toString.

Overrides:

toString in class Object

iconForId

public IconTip iconForId(String iconId)

Return an icon tip for a given id. Part of the Iconic interface.

Specified by:

iconForId in interface Iconic

Parameters:

iconId - The icon id.

Returns:

The IconTip or null if it doesn't exist.

addIconListener

public void addIconListener(IconListener listener)

Add an icon listener. Part of the Iconic interface.

Specified by:

addIconListener in interface Iconic

Parameters:

listener - The listener.

removeIconListener

public void removeIconListener(IconListener listener)

Remove an icon listener. Part of the Iconic interface.

Specified by:

removeIconListener in interface Iconic

Parameters:

listener - The listener.

initialised

public void initialised()

configured

public void configured()

destroy

public void destroy()

Destroy this component.