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 #并发数(线程数)
注意事项
- 您编写的AgiScript必须是线程安全的
- 线程池最大线程数为100,即时你配置超过100也只能并发100个