TraceRmiAcceptor

public interface TraceRmiAcceptor

An acceptor to receive a single Trace RMI connection from a back-end

Method Summary

Modifier and Type

Method

Description

TraceRmiConnection

accept()

Accept a single connection

void

cancel()

Cancel the connection

SocketAddress

getAddress()

Get the address (and port) where the acceptor is listening

boolean

isClosed()

Check if the acceptor is actually still accepting.

void

setTimeout(int millis)

Set the timeout

Method Details
- accept
  
  TraceRmiConnection accept() throws IOException, CancelledException
  
  Accept a single connection
  This acceptor is no longer valid after the connection is accepted. If accepting the connection fails, e.g., because of a timeout, this acceptor is no longer valid.
  
  Returns:
  
  the connection, if successful
  
  Throws:
  
  IOException - if there was an error
  
  CancelledException - if cancel() is called, usually from the user canceling
- isClosed
  
  boolean isClosed()
  
  Check if the acceptor is actually still accepting.
  
  Returns:
  
  true if not accepting anymore
- getAddress
  
  SocketAddress getAddress()
  
  Get the address (and port) where the acceptor is listening
  
  Returns:
  
  the socket address
- setTimeout
  
  void setTimeout(int millis) throws SocketException
  
  Set the timeout
  
  Parameters:
  
  millis - the number of milliseconds after which an accept() will time out.
  
  Throws:
  
  SocketException - if there's a protocol error
- cancel
  
  void cancel()
  
  Cancel the connection
  If a different thread has called accept(), it will fail. In this case, both TraceRmiServiceListener.acceptCancelled(TraceRmiAcceptor) and TraceRmiServiceListener.acceptFailed(TraceRmiAcceptor, Exception) may be invoked.