org.apache.river.mahalo

Class PrepareJob

java.lang.Object

org.apache.river.mahalo.Job

org.apache.river.mahalo.PrepareJob

All Implemented Interfaces:

TransactionConstants

class PrepareJob
extends Job
implements TransactionConstants

An implementation of a org.apache.river.mahalo.Job which interacts with a set of net.jini.core.transaction.server.TransactionParticipants to inform them to vote.

Author:

Sun Microsystems, Inc.

See Also:

Job, ParticipantTask, Transaction, TransactionParticipant

Field Summary

Fields

Modifier and Type	Field and Description
(package private) ParticipantHandle[]	handles
(package private) ClientLog	log
(package private) int	maxtries
private static Logger	operationsLogger Logger for operations related messages
private static Logger	persistenceLogger Logger for persistence related messages
(package private) ServerTransaction	tr

Fields inherited from class org.apache.river.mahalo.Job

attempts, logger, results

Fields inherited from interface net.jini.core.transaction.server.TransactionConstants

ABORTED, ACTIVE, COMMITTED, NOTCHANGED, PREPARED, VOTING

Constructor Summary

Constructors

Constructor and Description
PrepareJob(Transaction tr, java.util.concurrent.ExecutorService pool, WakeupManager wm, ClientLog log, ParticipantHandle[] handles) Constructs an PrepareJob

Method Summary

Modifier and Type	Method and Description
(package private) Object	computeResult() Gathers partial results submitted by tasks and produces a single outcome.
(package private) Runnable[]	createTasks() Creates the TaskManager.Tasks necessary to inform participants to vote.
(package private) Object	doWork(Runnable who, Object param) The work to be performed by each TaskManager.Task is provided by the Job that creates it.

Methods inherited from class org.apache.river.mahalo.Job

attempt, getMgr, getPool, isCompleted, performWork, scheduleTasks, stop

Methods inherited from class java.lang.Object

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

Field Detail

tr

final ServerTransaction tr

log

final ClientLog log

handles

final ParticipantHandle[] handles

maxtries

final int maxtries

See Also:

Constant Field Values

operationsLogger

private static final Logger operationsLogger

Logger for operations related messages

persistenceLogger

private static final Logger persistenceLogger

Logger for persistence related messages

Constructor Detail

PrepareJob

public PrepareJob(Transaction tr,
                  java.util.concurrent.ExecutorService pool,
                  WakeupManager wm,
                  ClientLog log,
                  ParticipantHandle[] handles)

Constructs an PrepareJob

Parameters:

tr - The Transaction whose participants will be instructed to vote

pool - The TaskManager which provides the threads used for interacting with participants.

log - The ClientLog used for recording recovery data.

handles - The array of participants which will be contacted and informed to vote

See Also:

TaskManager, ClientLog, TransactionParticipant

Method Detail

doWork

Object doWork(Runnable who,
              Object param)

The work to be performed by each TaskManager.Task is provided by the Job that creates it. The work performed by a task belonging to the AbortJob contacts a participant, instructs it to vote and log appropriately.

Specified by:

doWork in class Job

Parameters:

who - The task performing the work

param - A parameter, of the task's choosing, useful in performing work.

See Also:

Job, TaskManager.Task

createTasks

Runnable[] createTasks()

Creates the TaskManager.Tasks necessary to inform participants to vote.

Specified by:

createTasks in class Job

computeResult

Object computeResult()
              throws JobException

Gathers partial results submitted by tasks and produces a single outcome.

Specified by:

computeResult in class Job

Throws:

JobException

See Also:

Job