| org.logicalcobwebs.concurrent.Puttable
| Puttable | | public interface Puttable (Code) | | This interface exists to enable stricter type checking
for channels. A method argument or instance variable
in a producer object can be declared as only a Puttable
rather than a Channel, in which case a Java compiler
will disallow take operations.
Full method descriptions appear in the Channel interface.
[ Introduction to this package. ]
See Also: Channel
See Also: Takable |
| Method Summary | |
| public boolean | offer(Object item, long msecs)
Place item in channel only if it can be accepted within
msecs milliseconds. | | public void | put(Object item)
Place item in the channel, possibly waiting indefinitely until
it can be accepted. |
| offer | | public boolean offer(Object item, long msecs) throws InterruptedException(Code) | | Place item in channel only if it can be accepted within
msecs milliseconds. The time bound is interpreted in
a coarse-grained, best-effort fashion.
Parameters:
item - the element to be inserted. Should be non-null.
Parameters:
msecs - the number of milliseconds to wait. If less thanor equal to zero, the method does not perform any timed waits,but might still requireaccess to a synchronization lock, which can impose unboundeddelay if there is a lot of contention for the channel. true if accepted, else false
exception:
InterruptedException - if the current thread hasbeen interrupted at a point at which interruptionis detected, in which case the element is guaranteed notto be inserted (i.e., is equivalent to a false return). |
| put | | public void put(Object item) throws InterruptedException(Code) | | Place item in the channel, possibly waiting indefinitely until
it can be accepted. Channels implementing the BoundedChannel
subinterface are generally guaranteed to block on puts upon
reaching capacity, but other implementations may or may not block.
Parameters:
item - the element to be inserted. Should be non-null.
exception:
InterruptedException - if the current thread hasbeen interrupted at a point at which interruptionis detected, in which case the element is guaranteed notto be inserted. Otherwise, on normal return, the element is guaranteedto have been inserted. |
|
|