From fc6750da00f0d2b924423aeb63104ffc6da37ec4 Mon Sep 17 00:00:00 2001
From: Michael Jumper <zhangmaike@users.sourceforge.net>
Date: Fri, 23 Mar 2012 12:09:24 -0700
Subject: [PATCH] Tunnel attach and detach listeners.

---
 .../event/listener/TunnelAttachListener.java  | 26 +++++++++++++++++++
 .../event/listener/TunnelDetachListener.java  | 26 +++++++++++++++++++
 2 files changed, 52 insertions(+)
 create mode 100644 guacamole-ext/src/main/java/net/sourceforge/guacamole/net/event/listener/TunnelAttachListener.java
 create mode 100644 guacamole-ext/src/main/java/net/sourceforge/guacamole/net/event/listener/TunnelDetachListener.java

diff --git a/guacamole-ext/src/main/java/net/sourceforge/guacamole/net/event/listener/TunnelAttachListener.java b/guacamole-ext/src/main/java/net/sourceforge/guacamole/net/event/listener/TunnelAttachListener.java
new file mode 100644
index 000000000..7936faef3
--- /dev/null
+++ b/guacamole-ext/src/main/java/net/sourceforge/guacamole/net/event/listener/TunnelAttachListener.java
@@ -0,0 +1,26 @@
+package net.sourceforge.guacamole.net.event.listener;
+
+import net.sourceforge.guacamole.net.event.TunnelAttachEvent;
+
+/**
+ * A listener whose tunnelAttached() hook will fire immediately after a new
+ * tunnel is attached to a session.
+ * 
+ * @author Michael Jumper
+ */
+public interface TunnelAttachListener {
+
+   /**
+     * Event hook which fires immediately after a new tunnel is attached to a
+     * session. The return value of this hook dictates whether the tunnel is
+     * allowed to be attached.
+     * 
+     * @param e The TunnelAttachEvent describing the tunnel being attached and
+     *          any associated credentials.
+     * @return true if the tunnel should be allowed to be attached, or false
+     *         if the attempt should be denied, causing the attempt to
+     *         effectively fail.
+     */
+    public boolean tunnelAttached(TunnelAttachEvent e);
+
+}
diff --git a/guacamole-ext/src/main/java/net/sourceforge/guacamole/net/event/listener/TunnelDetachListener.java b/guacamole-ext/src/main/java/net/sourceforge/guacamole/net/event/listener/TunnelDetachListener.java
new file mode 100644
index 000000000..9eea91f50
--- /dev/null
+++ b/guacamole-ext/src/main/java/net/sourceforge/guacamole/net/event/listener/TunnelDetachListener.java
@@ -0,0 +1,26 @@
+package net.sourceforge.guacamole.net.event.listener;
+
+import net.sourceforge.guacamole.net.event.TunnelDetachEvent;
+
+/**
+ * A listener whose tunnelDetached() hook will fire immediately after an
+ * existing tunnel is detached from a session.
+ * 
+ * @author Michael Jumper
+ */
+public interface TunnelDetachListener {
+   
+    /**
+     * Event hook which fires immediately after an existing tunnel is detached
+     * from a session. The return value of this hook dictates whether the
+     * tunnel is allowed to be detached.
+     * 
+     * @param e The TunnelDetachEvent describing the tunnel being detached and
+     *          any associated credentials.
+     * @return true if the tunnel should be allowed to be detached, or false
+     *         if the attempt should be denied, causing the attempt to
+     *         effectively fail.
+     */
+    public boolean tunnelDetached(TunnelDetachEvent e);
+
+}