public class SynchronousChannel extends Object implements BoundedChannel
If you only need threads to synch up without exchanging information, consider using a Barrier. If you need bidirectional exchanges, consider using a Rendezvous.
Read the introduction to this package for more details.
Modifier and Type | Class and Description |
---|---|
protected static class |
SynchronousChannel.Queue
Simple FIFO queue class to hold waiting puts/takes.
|
Modifier and Type | Field and Description |
---|---|
protected static Object |
CANCELLED
Special marker used in queue nodes to indicate that
the thread waiting for a change in the node has timed out
or been interrupted.
|
protected SynchronousChannel.Queue |
waitingPuts |
protected SynchronousChannel.Queue |
waitingTakes |
Constructor and Description |
---|
SynchronousChannel() |
Modifier and Type | Method and Description |
---|---|
int |
capacity()
Return the maximum number of elements that can be held.
|
boolean |
offer(Object x,
long msecs)
Place item in channel only if it can be accepted within
msecs milliseconds.
|
Object |
peek()
Return, but do not remove object at head of Channel,
or null if it is empty.
|
Object |
poll(long msecs)
Return and remove an item from channel only if one is available within
msecs milliseconds.
|
void |
put(Object x)
Place item in the channel, possibly waiting indefinitely until
it can be accepted.
|
Object |
take()
Return and remove an item from channel,
possibly waiting indefinitely until
such an item exists.
|
protected static final Object CANCELLED
protected final SynchronousChannel.Queue waitingPuts
protected final SynchronousChannel.Queue waitingTakes
public int capacity()
BoundedChannel
capacity
in interface BoundedChannel
public Object peek()
Channel
public void put(Object x) throws InterruptedException
Channel
put
in interface Channel
put
in interface Puttable
x
- the element to be inserted. Should be non-null.InterruptedException
- if the current thread has
been interrupted at a point at which interruption
is detected, in which case the element is guaranteed not
to be inserted. Otherwise, on normal return, the element is guaranteed
to have been inserted.public Object take() throws InterruptedException
Channel
take
in interface Channel
take
in interface Takable
InterruptedException
- if the current thread has
been interrupted at a point at which interruption
is detected, in which case state of the channel is unchanged.public boolean offer(Object x, long msecs) throws InterruptedException
Channel
offer
in interface Channel
offer
in interface Puttable
x
- the element to be inserted. Should be non-null.msecs
- the number of milliseconds to wait. If less than
or equal to zero, the method does not perform any timed waits,
but might still require
access to a synchronization lock, which can impose unbounded
delay if there is a lot of contention for the channel.InterruptedException
- if the current thread has
been interrupted at a point at which interruption
is detected, in which case the element is guaranteed not
to be inserted (i.e., is equivalent to a false return).public Object poll(long msecs) throws InterruptedException
Channel
poll
in interface Channel
poll
in interface Takable
msecs
- the number of milliseconds to wait. If less than
or equal to zero, the operation does not perform any timed waits,
but might still require
access to a synchronization lock, which can impose unbounded
delay if there is a lot of contention for the channel.InterruptedException
- if the current thread has
been interrupted at a point at which interruption
is detected, in which case state of the channel is unchanged
(i.e., equivalent to a null return).Copyright © 2002–2018. All rights reserved.