org.jacorb.util

Class SelectorRequest

java.lang.Object

org.jacorb.util.SelectorRequest

Direct Known Subclasses:

TimerQueueAction

public class SelectorRequest
extends Object

defines a single request to be registered with the selector. this can be a timed event, I/O event, or I/O event with an expiration.

Author:

Ciju John <johnc@ociweb.com>}

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SelectorRequest.Status the current status of the request.
static class	SelectorRequest.Type the types of events to be waited for.

Field Summary

Fields

Modifier and Type	Field and Description
SelectorRequestCallback	callback
SocketChannel	channel
SelectionKey	key
long	nanoDeadline
int	op
SelectorRequest.Status	status
SelectorRequest.Type	type

Constructor Summary

Constructors

Constructor and Description
SelectorRequest(SelectorRequest.Type type, SocketChannel channel, SelectorRequestCallback callback, long nanoDeadline) Constructs a new SelectorRequest for an I/O event
SelectorRequest(SelectorRequestCallback callback, long nanoDeadline) Constructs a new SelectorRequest for an timer event

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isFinalized() determines if the current status is one of the final statuses
void	setStatus(SelectorRequest.Status status) Called by the SelectorManager to notify a change of status.
SelectorRequest.Status	waitOnCompletion(long nanoDeadline) a blocking call to wait for a status change or a timeout.

Methods inherited from class java.lang.Object

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

Field Detail

type

public final SelectorRequest.Type type

status

public SelectorRequest.Status status

channel

public final SocketChannel channel

key

public SelectionKey key

op

public final int op

callback

public SelectorRequestCallback callback

nanoDeadline

public final long nanoDeadline

Constructor Detail

SelectorRequest

public SelectorRequest(SelectorRequest.Type type,
               SocketChannel channel,
               SelectorRequestCallback callback,
               long nanoDeadline)

Constructs a new SelectorRequest for an I/O event

Parameters:

type - is the kind of event to wait for

channel - is the I/O on which the event is expected

callback - is the object to be notified when the event occurs

nanoDeadline - is an expiration time. It is an absolute time based upon System.nanoTime(). A deadline of '0' is used for no deadline.

SelectorRequest

public SelectorRequest(SelectorRequestCallback callback,
               long nanoDeadline)

Constructs a new SelectorRequest for an timer event

Parameters:

callback - is the object to be notified when the event occurs

nanoDeadline - is an expiration time. It is an absolute time based upon System.nanoTime(). A deadline of '0' is used for no deadline.

Method Detail

setStatus

public void setStatus(SelectorRequest.Status status)

Called by the SelectorManager to notify a change of status. Will wake up a thread blocked in waitOnCOmpletion

isFinalized

public boolean isFinalized()

determines if the current status is one of the final statuses

Returns:

false if the status is PENDING, ASSIGNED, or READY, true for all others

waitOnCompletion

public SelectorRequest.Status waitOnCompletion(long nanoDeadline)

a blocking call to wait for a status change or a timeout.

Parameters:

nanoDeadline - is an explicit timeout for waiting on a change

Returns:

this requester's status after a notification or a timeout.