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
|
