Class NetAltingConnectionClient

java.lang.Object
org.jcsp.lang.Guard
org.jcsp.lang.AltingConnectionClient
org.jcsp.net2.NetAltingConnectionClient
All Implemented Interfaces:
ConnectionClient, NetConnectionClient, Networked
public final class NetAltingConnectionClient extends AltingConnectionClient implements NetConnectionClient

  • Method Details

    • isOpen

      public boolean isOpen() throws IllegalStateException, JCSPNetworkException
      Description copied from interface: ConnectionClient

      Returns whether the server has kept its end of the Connection open. This should only be called after a call to reply() and before any other Connection method is called.

      Specified by:
      isOpen in interface ConnectionClient
      Returns:
      true iff the server has kept the connection open.
      Throws:
      IllegalStateException
      JCSPNetworkException

    • reply

      public Object reply() throws IllegalStateException, JCSPNetworkException
      Description copied from interface: ConnectionClient

      Receives some data back from the server after request(Object) has been called.

      After calling this method, isOpen() may be called to establish whether the server dropped the connection after replying.

      Implementations may make this operation ALTable.

      Specified by:
      reply in interface ConnectionClient
      Returns:
      the Object sent from the server.
      Throws:
      IllegalStateException - if the method is called when it is not meant to be.
      JCSPNetworkException

    • request

      public void request(Object obj) throws IllegalStateException, JCSPNetworkException
      Description copied from interface: ConnectionClient

      This method is used to send data to a ConnectionServer in a client/server conversation. If a connection has not yet been established, then this method will open the connection as necessary.

      Once this method has returned, the client may do some computation but must then guarantee to call reply(). This will obtain a server's response to the request. In between calling this method and reply(), doing pure computation is safe. Performing synchronization with other process is potentially hazardous.

      Once a server replies, if the connection has been kept open, then this method should be called again to make a further request.

      Programs using Connections need to adopt a protocol so that the server knows when a conversation with a client has finished and will then drop the connection.

      Specified by:
      request in interface ConnectionClient
      Parameters:
      obj - the Object to send to the server.
      Throws:
      IllegalStateException - if the method is called when it is not meant to be.
      JCSPNetworkException

    • destroy

      public void destroy()
      Description copied from interface: Networked
      Destroys the Networked construct
      Specified by:
      destroy in interface Networked

    • getLocation

      public NetLocation getLocation()
      Description copied from interface: Networked
      Gets the networked location of the Networked construct
      Specified by:
      getLocation in interface Networked
      Returns:
      The location of the construct