FastAGI Protocol

FastAGI Protocol

 

      FastAGI基于AGI通过TCP/IP Socket连接替代标准输入和标准输出做为沟通的媒介。你可以使用FastAGI运行Java应用程序(可以在不同的机器上运行Asterisk) ，它仅启动一次AGI 脚本直到它被关闭。使用此协议结合Java的多线程支持可以构建非常快的脚本。

      一个简单的实现如下，通过拨打1300分机调用AGI脚本，能听到welcome的语音。该实现共分4部分：

 

• AGI脚本实现代码：继承BaseAgiScript基类，并在service方法中实现具体的功能调用；
• 拨号计划：在拨号计划中定义AGI的调用；
• AGI脚本映射：定义AGI脚本名称与具体Java实现间的映射关系；
• AgiServer：AGI服务端，通过启动该服务，将创建一个Socket服务端开放AGI服务，同时载入fastagi-mapping中的定义，以提供给AGI应用进行调用；

 

HelloWorld

 

import org.asteriskjava.fastagi.AgiChannel;
import org.asteriskjava.fastagi.AgiException;
import org.asteriskjava.fastagi.AgiRequest;
import org.asteriskjava.fastagi.BaseAgiScript;
public class HelloAgiScript extends BaseAgiScript
{
    public void service(AgiRequest request, AgiChannel channel)
            throws AgiException
    {
        // Answer the channel...
        answer();
               
        // ...say hello...
        streamFile("welcome");
               
        // ...and hangup.
        hangup();
    }
}

 

 

extensions.conf

 

 

[default]
...
exten => 1300,1,Agi(agi://192.168.0.100/hello.agi)

 

 

fastagi-mapping.properties

 

hello.agi = HelloAgiScript

 

 

最终的目录结构

 

 

$ ls -l
-rw-r--r-- 1 srt srt 163689 2005-03-11 22:07 asterisk-java.jar
-rw-r--r-- 1 srt srt     26 2005-03-11 20:50 fastagi-mapping.properties
-rw-r--r-- 1 srt srt    624 2005-03-11 22:07 HelloAgiScript.class
-rw-r--r-- 1 srt srt    438 2005-03-11 20:50 HelloAgiScript.java

 

 

启动服务

 

$ java -jar asterisk-java.jar

 

服务配置

通过修改fastagi.properties可更改DefaultAgiServer的默认值

 

 

bindPort = 1234   #Socket端口
poolSize = 20      #并发数（线程数）

 

注意事项

1. 您编写的AgiScript必须是线程安全的
2. 线程池最大线程数为100，即时你配置超过100也只能并发100个