CSP for Java
(JCSP) 1.1-rc4

Class BlackHoleChannelInt

  extended by org.jcsp.lang.BlackHoleChannelInt
All Implemented Interfaces:
ChannelOutputInt, Poisonable

public class BlackHoleChannelInt
extends Object
implements ChannelOutputInt

This implements ChannelOutputInt with black hole semantics.


BlackHoleChannelInt is an implementation of ChannelOutputInt that yields black hole semantics for a channel. Writers may always write but there can be no readers. Any number of writers may share the same black hole.

Note: BlackHoleChannelInts 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.

P.H. Welch
See Also:
ChannelOutputInt, One2OneChannelInt, Any2OneChannelInt, One2AnyChannelInt, Any2AnyChannelInt

Constructor Summary
Method Summary
 void poison(int strength)
          This injects poison into the channel.
 void write(int n)
          Write an integer to the channel and loose it.
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail


public BlackHoleChannelInt()
Method Detail


public void write(int n)
Write an integer to the channel and loose it.

Specified by:
write in interface ChannelOutputInt
n - the integer to write to the channel.


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 interface Poisonable
strength - the strength of the poison (must be >= 0).

CSP for Java
(JCSP) 1.1-rc4

Submit a bug or feature to jcsp-team@kent.ac.uk
Version 1.1-rc4 of the JCSP API Specification (Copyright 1997-2008 P.D.Austin and P.H.Welch - All Rights Reserved)
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.