FastAGI Protocol-优快云博客

本文介绍如何使用FastAGI协议结合Java构建高效的AGI脚本。通过实现简单的语音欢迎功能，展示了AGI脚本的设计与部署过程。

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个