aboutsummaryrefslogtreecommitdiffstats
path: root/sshlib/src/main/java/com/trilead/ssh2/ConnectionMonitor.java
blob: 2f96d256fac0e71ef3f3c216ae9f19a7d1be317e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
package com.trilead.ssh2;

/**
 * A <code>ConnectionMonitor</code> is used to get notified when the
 * underlying socket of a connection is closed. 
 * 
 * @author Christian Plattner, plattner@trilead.com
 * @version $Id: ConnectionMonitor.java,v 1.1 2007/10/15 12:49:56 cplattne Exp $
 */

public interface ConnectionMonitor
{
	/**
	 * This method is called after the connection's underlying
	 * socket has been closed. E.g., due to the {@link Connection#close()} request of the
	 * user, if the peer closed the connection, due to a fatal error during connect()
	 * (also if the socket cannot be established) or if a fatal error occured on
	 * an established connection.
	 * <p>
	 * This is an experimental feature.
	 * <p>
	 * You MUST NOT make any assumption about the thread that invokes this method.
	 * <p>
	 * <b>Please note: if the connection is not connected (e.g., there was no successful
	 * connect() call), then the invocation of {@link Connection#close()} will NOT trigger
	 * this method.</b>
	 * 
	 * @see Connection#addConnectionMonitor(ConnectionMonitor)
	 * 
	 * @param reason Includes an indication why the socket was closed.
	 */
	public void connectionLost(Throwable reason);
}