com.partnersoft.v3x.apps.Staker.server
Class JobLibrary

java.lang.Object
  com.partnersoft.v3x.apps.Staker.server.JobLibrary

public class JobLibrary
extends java.lang.Object

The job library proper. Includes all the client and administrative methods for job management.

Constructor Summary

JobLibrary()

Method Summary

void	addJob(Job newJob) Add a new job to the library.
void	addJobLibraryListener(JobLibraryListener nosey)
void	addNote(java.lang.String jobNumber, Note comment) Adds a note to a job.
java.util.ArrayList	allHeaders() Get a list of all the job headers in the library.
java.util.ArrayList	allJobNumbers() Get a list of all the job numbers in the library.
java.util.ArrayList	allJobsAssignedTo(java.lang.String stakerName) Get a list of the job numbers assigned to the given staker.
void	changeHeader(ChangeJobHeader changer) Makes changes to a job header.
void	checkinAndRemember(java.lang.String holder, CheckedOutJobHeader header) A slightly different protocol.
void	checkinHeader(CheckedOutJobHeader header) Check in a job header; merges it with any other versions in the library.
void	checkinJob(CheckedOutJob job) Check in job with modifications.
CheckedOutJobHeader	checkoutAndRemember(java.lang.String holder, java.lang.String jobNumber) A slightly different protocol.
CheckedOutJobHeader	checkoutHeader(java.lang.String jobNumber) Check out a job header for modifications.
CheckedOutJobHeader	checkoutHeader(java.lang.String jobNumber, java.lang.String name)
CheckedOutJob	checkoutJob(java.lang.String jobNumber) Check out a job for modifications.
CheckedOutJob	checkoutJob(java.lang.String jobNumber, java.lang.String customer)
CheckedOutJobHeader	checkoutLatestAndRemember(java.lang.String holder, java.lang.String jobNumber)
void	close() Closes the job library.
void	createJob(java.lang.String jobNumber) Add a new, blank job to the library.
void	fireJobChanged(JobHeader header)
void	fireJobChanged(java.lang.String jobNumber)
void	forceReleaseJob(java.lang.String jobNumber) Release job; this will eject the checkout for that job - use with caution.
int	getCacheSize()
long	getSharedChecksum()
boolean	isVerbose()
boolean	jobExists(java.lang.String jobNumber)
java.lang.String	jobStatus(java.lang.String jobNumber)
java.lang.Object	processCustomRequest(CustomLibraryRequest request)
void	releaseHeader(LibraryVersionReceipt receipt) Release a job header from checkout; doesn't modify.
void	releaseJob(CheckedOutJob job) Release job - checks in without modifications.
void	reloadJob(java.lang.String jobNumber)
void	removeJob(java.lang.String jobNumber) Removes and archives a job.
void	removeJobLibraryListener(JobLibraryListener nosey)
void	renumberJob(java.lang.String oldJobNumber, java.lang.String newJobNumber) Renumber job; this will fail if there is already a job of the new number or if the job doesn't exist.
LibraryVersionReceipt	retrieveReceipt(java.lang.String holder, java.lang.String jobNumber)
void	sendToInterface(java.lang.String jobNumber) This method sends the job information to the interface.
void	setCacheSize(int newSize)
void	setVerbose(boolean tizit)
void	storeReceipt(java.lang.String holder, LibraryVersionReceipt receipt)
void	updateJobCheckedOutFlag(java.lang.String jobNumber, boolean tizit)
JobHeader	viewHeader(java.lang.String jobNumber) See the job header corresponding to the job number.
Job	viewJob(java.lang.String jobNumber) See the job corresponding to the job number.

Methods inherited from class java.lang.Object

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

Constructor Detail

JobLibrary

public JobLibrary()

Method Detail

close

public void close()

Closes the job library.

allHeaders

public java.util.ArrayList allHeaders()
                               throws JobLibraryException

Get a list of all the job headers in the library. Expensive!

Throws:

JobLibraryException

allJobNumbers

public java.util.ArrayList allJobNumbers()

Get a list of all the job numbers in the library.

allJobsAssignedTo

public java.util.ArrayList allJobsAssignedTo(java.lang.String stakerName)
                                      throws JobLibraryException

Get a list of the job numbers assigned to the given staker.

Throws:

JobLibraryException

createJob

public void createJob(java.lang.String jobNumber)
               throws JobLibraryException

Add a new, blank job to the library.

Throws:

JobLibraryException

addJob

public void addJob(Job newJob)
            throws JobLibraryException

Add a new job to the library.

Throws:

JobLibraryException

viewHeader

public JobHeader viewHeader(java.lang.String jobNumber)
                     throws JobLibraryException

See the job header corresponding to the job number.

Throws:

JobLibraryException

checkoutHeader

public CheckedOutJobHeader checkoutHeader(java.lang.String jobNumber)
                                   throws JobLibraryException

Check out a job header for modifications.

Throws:

JobLibraryException

checkoutHeader

public CheckedOutJobHeader checkoutHeader(java.lang.String jobNumber,
                                          java.lang.String name)
                                   throws JobLibraryException

Throws:

JobLibraryException

checkoutAndRemember

public CheckedOutJobHeader checkoutAndRemember(java.lang.String holder,
                                               java.lang.String jobNumber)
                                        throws JobLibraryException

A slightly different protocol. Remembers the checkout based on a String holder parameter. Retrieves the old checkout for you if it exists; otherwise fetches a new one. Used for external interfaces.

Throws:

JobLibraryException

checkoutLatestAndRemember

public CheckedOutJobHeader checkoutLatestAndRemember(java.lang.String holder,
                                                     java.lang.String jobNumber)
                                              throws JobLibraryException

Throws:

JobLibraryException

checkinAndRemember

public void checkinAndRemember(java.lang.String holder,
                               CheckedOutJobHeader header)
                        throws JobLibraryException

A slightly different protocol. Remembers the checkout based on a String holder parameter. Retrieves the old checkout for you if it exists; otherwise fetches a new one. Used for external interfaces.

Throws:

JobLibraryException

releaseHeader

public void releaseHeader(LibraryVersionReceipt receipt)
                   throws JobLibraryException

Release a job header from checkout; doesn't modify.

Throws:

JobLibraryException

checkinHeader

public void checkinHeader(CheckedOutJobHeader header)
                   throws JobLibraryException

Check in a job header; merges it with any other versions in the library.

Throws:

JobLibraryException

addNote

public void addNote(java.lang.String jobNumber,
                    Note comment)
             throws JobLibraryException

Adds a note to a job.

Throws:

JobLibraryException

changeHeader

public void changeHeader(ChangeJobHeader changer)
                  throws JobLibraryException

Makes changes to a job header.

Throws:

JobLibraryException

removeJob

public void removeJob(java.lang.String jobNumber)
               throws JobLibraryException

Removes and archives a job.

Throws:

JobLibraryException

viewJob

public Job viewJob(java.lang.String jobNumber)
            throws JobLibraryException

See the job corresponding to the job number.

Throws:

JobLibraryException

checkoutJob

public CheckedOutJob checkoutJob(java.lang.String jobNumber)
                          throws JobLibraryException

Check out a job for modifications. This grants an exclusive lock.

Throws:

JobLibraryException

checkoutJob

public CheckedOutJob checkoutJob(java.lang.String jobNumber,
                                 java.lang.String customer)
                          throws JobLibraryException

Throws:

JobLibraryException

releaseJob

public void releaseJob(CheckedOutJob job)
                throws JobLibraryException

Release job - checks in without modifications.

Throws:

JobLibraryException

forceReleaseJob

public void forceReleaseJob(java.lang.String jobNumber)
                     throws JobLibraryException

Release job; this will eject the checkout for that job - use with caution.

Throws:

JobLibraryException

renumberJob

public void renumberJob(java.lang.String oldJobNumber,
                        java.lang.String newJobNumber)
                 throws JobLibraryException

Renumber job; this will fail if there is already a job of the new number or if the job doesn't exist.

Throws:

JobLibraryException

reloadJob

public void reloadJob(java.lang.String jobNumber)
               throws JobLibraryException

Throws:

JobLibraryException

sendToInterface

public void sendToInterface(java.lang.String jobNumber)
                     throws JobLibraryException

This method sends the job information to the interface.

Parameters:

jobNumber -

Throws:

JobLibraryException

checkinJob

public void checkinJob(CheckedOutJob job)
                throws JobLibraryException

Check in job with modifications. Merges header with current version in library; replaces other job information with new copy.

Throws:

JobLibraryException

processCustomRequest

public java.lang.Object processCustomRequest(CustomLibraryRequest request)
                                      throws JobLibraryException

Throws:

JobLibraryException

jobExists

public boolean jobExists(java.lang.String jobNumber)

storeReceipt

public void storeReceipt(java.lang.String holder,
                         LibraryVersionReceipt receipt)

retrieveReceipt

public LibraryVersionReceipt retrieveReceipt(java.lang.String holder,
                                             java.lang.String jobNumber)

jobStatus

public java.lang.String jobStatus(java.lang.String jobNumber)

updateJobCheckedOutFlag

public void updateJobCheckedOutFlag(java.lang.String jobNumber,
                                    boolean tizit)

getSharedChecksum

public long getSharedChecksum()

getCacheSize

public int getCacheSize()

setCacheSize

public void setCacheSize(int newSize)

isVerbose

public boolean isVerbose()

setVerbose

public void setVerbose(boolean tizit)

addJobLibraryListener

public void addJobLibraryListener(JobLibraryListener nosey)

removeJobLibraryListener

public void removeJobLibraryListener(JobLibraryListener nosey)

fireJobChanged

public void fireJobChanged(JobHeader header)

fireJobChanged

public void fireJobChanged(java.lang.String jobNumber)