Package org.jcsp.lang
Class BlackHoleChannel
java.lang.Object
org.jcsp.lang.BlackHoleChannel
- All Implemented Interfaces:
ChannelOutput
,Poisonable
This implements
ChannelOutput
with black hole semantics.
Description
BlackHoleChannel is an implementation ofChannelOutput
that yields
black hole semantics for the channel. Writers may always write but there can be
no readers. Any number of writers may share the same black hole.
Note: BlackHoleChannels are used for masking off unwanted outputs from processes. They are useful when we want to reuse an existing process component intact, but don't need some of its output channels (i.e. we don't want to redesign and reimplement the component to remove the redundant channels). Normal channels cannot be plugged in and left dangling as this may deadlock (parts of) the component being reused.
- See Also:
-
Constructor Summary
Constructors -
Method Summary
-
Constructor Details
-
BlackHoleChannel
public BlackHoleChannel()
-
-
Method Details
-
write
Write an Object to the channel and lose it.- Specified by:
write
in interfaceChannelOutput
- Parameters:
object
- the object to write to the channel.
-
poison
public void poison(int strength) Description copied from interface:Poisonable
This injects poison into the channel. If the channel was not explicitly constructed to be poisonable or if the strength of poison is not greater than the channel immunity level, the poison will have no effect.- Specified by:
poison
in interfacePoisonable
- Parameters:
strength
- the strength of the poison (must be >= 0).
-