[Asterisk-java-cvs] CVS: asterisk-java/xdocs tutorial.xml,1.6,1.7

[Stefan R. <sr...@us...>]

Update of /cvsroot/asterisk-java/asterisk-java/xdocs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28214/xdocs

Modified Files:
	tutorial.xml 
Log Message:
Added short subscection on how to receive Events via the Manager API

Index: tutorial.xml
===================================================================
RCS file: /cvsroot/asterisk-java/asterisk-java/xdocs/tutorial.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -p -r1.6 -r1.7
--- tutorial.xml	14 Mar 2005 19:42:46 -0000	1.6
+++ tutorial.xml	16 Mar 2005 09:54:05 -0000	1.7
@@ -277,6 +277,73 @@ public class HelloManager
 					povided by the Manager API is available in the
 					<a href="apidocs/index.html">javadocs</a>.</p>
 			</subsection>
+			<subsection name="Hello Events!">
+				<p>To receive events from Asterisk you have to implement the 
+					<a href="apidocs/net/sf/asterisk/manager/ManagerEventHandler.html">ManagerEventHandler</a>
+					interface and add it to the 
+					<a href="apidocs/net/sf/asterisk/manager/ManagerConnection.html">ManagerConnection</a></p>
+				<p>The following code shows a simple example of how to do this:</p>
+<source><![CDATA[
+import java.io.IOException;
+
+import net.sf.asterisk.manager.AuthenticationFailedException;
+import net.sf.asterisk.manager.ManagerConnection;
+import net.sf.asterisk.manager.ManagerConnectionFactory;
+import net.sf.asterisk.manager.ManagerEventHandler;
+import net.sf.asterisk.manager.TimeoutException;
+import net.sf.asterisk.manager.action.StatusAction;
+import net.sf.asterisk.manager.event.ManagerEvent;
+
+public class HelloEvents implements ManagerEventHandler
+{
+    private ManagerConnection managerConnection;
+
+    public HelloEvents() throws IOException
+    {
+        ManagerConnectionFactory factory = new ManagerConnectionFactory();
+
+        this.managerConnection = factory.getManagerConnection("localhost",
+                "manager", "pa55w0rd");
+    }
+
+    public void run() throws IOException, AuthenticationFailedException,
+            TimeoutException, InterruptedException
+    {
+        // register for events
+        managerConnection.addEventHandler(this);
+        
+        // connect to Asterisk and log in
+        managerConnection.login();
+
+        // request channel state
+        managerConnection.sendAction(new StatusAction());
+        
+        // wait 10 seconds for events to come in
+        Thread.sleep(10000);
+
+        // and finally log off and disconnect
+        managerConnection.logoff();
+    }
+
+    public void handleEvent(ManagerEvent event)
+    {
+        // just print received events
+        System.out.println(event);
+    }
+
+    public static void main(String[] args) throws Exception
+    {
+        HelloEvents helloManager;
+
+        helloManager = new HelloEvents();
+        helloManager.run();
+    }
+}
+]]></source>				
+				<p>A list of the other <a href="apidocs/net/sf/asterisk/manager/event/package-summary.html">Events</a>
+					povided by the Manager API is available in the
+					<a href="apidocs/index.html">javadocs</a>.</p>
+			</subsection>
 		</section>
 	</body>
 </document>
\ No newline at end of file