net.sf.asterisk.fastagi.impl
Class AGIChannelImpl

java.lang.Object
  extended by net.sf.asterisk.fastagi.impl.AGIChannelImpl
All Implemented Interfaces:
AGIChannel

public class AGIChannelImpl
extends java.lang.Object
implements AGIChannel

Default implementation of the AGIChannel interface.

Version:
$Id: AGIChannelImpl.java,v 1.8 2005/11/27 17:31:05 srt Exp $
Author:
srt

Constructor Summary
AGIChannelImpl(AGIWriter agiWriter, AGIReader agiReader)
           
AGIChannelImpl(SocketConnectionFacade socket)
           
 
Method Summary
 void answer()
          Answers the channel.
 int exec(java.lang.String application)
          Executes the given command.
 int exec(java.lang.String application, java.lang.String options)
          Executes the given command.
 int getChannelStatus()
          Returns the status of the channel.
Return values: 0 Channel is down and available 1 Channel is down, but reserved 2 Channel is off hook 3 Digits (or equivalent) have been dialed 4 Line is ringing 5 Remote end is ringing 6 Line is up 7 Line is busy
 java.lang.String getData(java.lang.String file)
          Plays the given file and waits for the user to enter DTMF digits until he presses '#'.
 java.lang.String getData(java.lang.String file, long timeout)
          Plays the given file and waits for the user to enter DTMF digits until he presses '#' or the timeout occurs.
 java.lang.String getData(java.lang.String file, long timeout, int maxDigits)
          Plays the given file and waits for the user to enter DTMF digits until he presses '#' or the timeout occurs or the maximum number of digits has been entered.
 java.lang.String getFullVariable(java.lang.String name)
          Returns the value of the current channel variable, unlike getVariable() this method understands complex variable names and builtin variables.
Available since Asterisk 1.2.
 java.lang.String getFullVariable(java.lang.String name, java.lang.String channel)
          Returns the value of the given channel variable.
Available since Asterisk 1.2.
 char getOption(java.lang.String file, java.lang.String escapeDigits)
          Plays the given file, and waits for the user to press one of the given digits.
 char getOption(java.lang.String file, java.lang.String escapeDigits, int timeout)
          Plays the given file, and waits for the user to press one of the given digits.
 java.lang.String getVariable(java.lang.String name)
          Returns the value of the current channel variable.
 void hangup()
          Hangs the channel up.
 void playMusicOnHold()
          Plays music on hold from the default music on hold class.
 void playMusicOnHold(java.lang.String musicOnHoldClass)
          Plays music on hold from the given music on hold class.
 void sayAlpha(java.lang.String text)
          Says the given character string.
 char sayAlpha(java.lang.String text, java.lang.String escapeDigits)
          Says the given character string, returning early if any of the given DTMF number are received on the channel.
 void sayDateTime(long time)
          Says the given time.
Available since Asterisk 1.2.
 char sayDateTime(long time, java.lang.String escapeDigits)
          Says the given time and allows interruption by one of the given escape digits.
Available since Asterisk 1.2.
 char sayDateTime(long time, java.lang.String escapeDigits, java.lang.String format)
          Says the given time in the given format and allows interruption by one of the given escape digits.
Available since Asterisk 1.2.
 char sayDateTime(long time, java.lang.String escapeDigits, java.lang.String format, java.lang.String timezone)
          Says the given time in the given format and timezone and allows interruption by one of the given escape digits.
Available since Asterisk 1.2.
 void sayDigits(java.lang.String digits)
          Says the given digit string.
 char sayDigits(java.lang.String digits, java.lang.String escapeDigits)
          Says the given number, returning early if any of the given DTMF number are received on the channel.
 void sayNumber(java.lang.String number)
          Says the given number.
 char sayNumber(java.lang.String number, java.lang.String escapeDigits)
          Says the given number, returning early if any of the given DTMF number are received on the channel.
 void sayPhonetic(java.lang.String text)
          Says the given character string with phonetics.
 char sayPhonetic(java.lang.String text, java.lang.String escapeDigits)
          Says the given character string with phonetics, returning early if any of the given DTMF number are received on the channel.
 void sayTime(long time)
          Says the given time.
 char sayTime(long time, java.lang.String escapeDigits)
          Says the given time, returning early if any of the given DTMF number are received on the channel.
 AGIReply sendCommand(AGICommand command)
          Sends a command to asterisk and returns the corresponding reply.
 void setAutoHangup(int time)
          Cause the channel to automatically hangup at the given number of seconds in the future.
 void setCallerId(java.lang.String callerId)
          Sets the caller id on the current channel.
 void setContext(java.lang.String context)
          Sets the context for continuation upon exiting the application.
 void setExtension(java.lang.String extension)
          Sets the extension for continuation upon exiting the application.
 void setPriority(java.lang.String priority)
          Sets the priority or label for continuation upon exiting the application.
 void setVariable(java.lang.String name, java.lang.String value)
          Sets the value of the current channel variable to a new value.
 void stopMusicOnHold()
          Stops playing music on hold.
 void streamFile(java.lang.String file)
          Plays the given file.
 char streamFile(java.lang.String file, java.lang.String escapeDigits)
          Plays the given file and allows the user to escape by pressing one of the given digit.
 char waitForDigit(int timeout)
          Waits up to 'timeout' milliseconds to receive a DTMF digit.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AGIChannelImpl

public AGIChannelImpl(SocketConnectionFacade socket)

AGIChannelImpl

public AGIChannelImpl(AGIWriter agiWriter,
                      AGIReader agiReader)
Method Detail

sendCommand

public AGIReply sendCommand(AGICommand command)
                     throws AGIException
Description copied from interface: AGIChannel
Sends a command to asterisk and returns the corresponding reply.

Specified by:
sendCommand in interface AGIChannel
Parameters:
command - the command to send.
Returns:
the reply of the asterisk server containing the return value.
Throws:
AGIException - if the command can't be sent to Asterisk (for example because the channel has been hung up)

answer

public void answer()
            throws AGIException
Description copied from interface: AGIChannel
Answers the channel.

Specified by:
answer in interface AGIChannel
Throws:
AGIException

hangup

public void hangup()
            throws AGIException
Description copied from interface: AGIChannel
Hangs the channel up.

Specified by:
hangup in interface AGIChannel
Throws:
AGIException

setAutoHangup

public void setAutoHangup(int time)
                   throws AGIException
Description copied from interface: AGIChannel
Cause the channel to automatically hangup at the given number of seconds in the future.

Specified by:
setAutoHangup in interface AGIChannel
Parameters:
time - the number of seconds before this channel is automatically hung up.
0 disables the autohangup feature.
Throws:
AGIException

setCallerId

public void setCallerId(java.lang.String callerId)
                 throws AGIException
Description copied from interface: AGIChannel
Sets the caller id on the current channel.

Specified by:
setCallerId in interface AGIChannel
Parameters:
callerId - the raw caller id to set, for example "John Doe<1234>".
Throws:
AGIException

playMusicOnHold

public void playMusicOnHold()
                     throws AGIException
Description copied from interface: AGIChannel
Plays music on hold from the default music on hold class.

Specified by:
playMusicOnHold in interface AGIChannel
Throws:
AGIException

playMusicOnHold

public void playMusicOnHold(java.lang.String musicOnHoldClass)
                     throws AGIException
Description copied from interface: AGIChannel
Plays music on hold from the given music on hold class.

Specified by:
playMusicOnHold in interface AGIChannel
Parameters:
musicOnHoldClass - the music on hold class to play music from as configures in Asterisk's .
Throws:
AGIException

stopMusicOnHold

public void stopMusicOnHold()
                     throws AGIException
Description copied from interface: AGIChannel
Stops playing music on hold.

Specified by:
stopMusicOnHold in interface AGIChannel
Throws:
AGIException

getChannelStatus

public int getChannelStatus()
                     throws AGIException
Description copied from interface: AGIChannel
Returns the status of the channel.
Return values:
  • 0 Channel is down and available
  • 1 Channel is down, but reserved
  • 2 Channel is off hook
  • 3 Digits (or equivalent) have been dialed
  • 4 Line is ringing
  • 5 Remote end is ringing
  • 6 Line is up
  • 7 Line is busy

Specified by:
getChannelStatus in interface AGIChannel
Returns:
the status of the channel.
Throws:
AGIException

getData

public java.lang.String getData(java.lang.String file)
                         throws AGIException
Description copied from interface: AGIChannel
Plays the given file and waits for the user to enter DTMF digits until he presses '#'. The user may interrupt the streaming by starting to enter digits.

Specified by:
getData in interface AGIChannel
Parameters:
file - the name of the file to play
Returns:
a String containing the DTMF the user entered
Throws:
AGIException

getData

public java.lang.String getData(java.lang.String file,
                                long timeout)
                         throws AGIException
Description copied from interface: AGIChannel
Plays the given file and waits for the user to enter DTMF digits until he presses '#' or the timeout occurs. The user may interrupt the streaming by starting to enter digits.

Specified by:
getData in interface AGIChannel
Parameters:
file - the name of the file to play
timeout - the timeout in milliseconds to wait for user input.
0 means standard timeout value, -1 means "ludicrous time" (essentially never times out).
Returns:
a String containing the DTMF the user entered
Throws:
AGIException

getData

public java.lang.String getData(java.lang.String file,
                                long timeout,
                                int maxDigits)
                         throws AGIException
Description copied from interface: AGIChannel
Plays the given file and waits for the user to enter DTMF digits until he presses '#' or the timeout occurs or the maximum number of digits has been entered. The user may interrupt the streaming by starting to enter digits.

Specified by:
getData in interface AGIChannel
Parameters:
file - the name of the file to play
timeout - the timeout in milliseconds to wait for user input.
0 means standard timeout value, -1 means "ludicrous time" (essentially never times out).
maxDigits - the maximum number of digits the user is allowed to enter
Returns:
a String containing the DTMF the user entered
Throws:
AGIException

getOption

public char getOption(java.lang.String file,
                      java.lang.String escapeDigits)
               throws AGIException
Description copied from interface: AGIChannel
Plays the given file, and waits for the user to press one of the given digits. If none of the esacpe digits is pressed while streaming the file it waits for the default timeout of 5 seconds still waiting for the user to press a digit.

Specified by:
getOption in interface AGIChannel
Parameters:
file - the name of the file to stream, must not include extension.
escapeDigits - contains the digits that the user is expected to press.
Returns:
the DTMF digit pressed or 0x0 if none was pressed.
Throws:
AGIException

getOption

public char getOption(java.lang.String file,
                      java.lang.String escapeDigits,
                      int timeout)
               throws AGIException
Description copied from interface: AGIChannel
Plays the given file, and waits for the user to press one of the given digits. If none of the esacpe digits is pressed while streaming the file it waits for the specified timeout still waiting for the user to press a digit.

Specified by:
getOption in interface AGIChannel
Parameters:
file - the name of the file to stream, must not include extension.
escapeDigits - contains the digits that the user is expected to press.
timeout - the timeout in seconds to wait if none of the defined esacpe digits was presses while streaming.
Returns:
the DTMF digit pressed or 0x0 if none was pressed.
Throws:
AGIException

exec

public int exec(java.lang.String application)
         throws AGIException
Description copied from interface: AGIChannel
Executes the given command.

Specified by:
exec in interface AGIChannel
Parameters:
application - the name of the application to execute, for example "Dial".
Returns:
the return code of the application of -2 if the application was not found.
Throws:
AGIException

exec

public int exec(java.lang.String application,
                java.lang.String options)
         throws AGIException
Description copied from interface: AGIChannel
Executes the given command.

Specified by:
exec in interface AGIChannel
Parameters:
application - the name of the application to execute, for example "Dial".
options - the parameters to pass to the application, for example "SIP/123".
Returns:
the return code of the application of -2 if the application was not found.
Throws:
AGIException

setContext

public void setContext(java.lang.String context)
                throws AGIException
Description copied from interface: AGIChannel
Sets the context for continuation upon exiting the application.

Specified by:
setContext in interface AGIChannel
Parameters:
context - the context for continuation upon exiting the application.
Throws:
AGIException

setExtension

public void setExtension(java.lang.String extension)
                  throws AGIException
Description copied from interface: AGIChannel
Sets the extension for continuation upon exiting the application.

Specified by:
setExtension in interface AGIChannel
Parameters:
extension - the extension for continuation upon exiting the application.
Throws:
AGIException

setPriority

public void setPriority(java.lang.String priority)
                 throws AGIException
Description copied from interface: AGIChannel
Sets the priority or label for continuation upon exiting the application.

Specified by:
setPriority in interface AGIChannel
Parameters:
priority - the priority or label for continuation upon exiting the application.
Throws:
AGIException

streamFile

public void streamFile(java.lang.String file)
                throws AGIException
Description copied from interface: AGIChannel
Plays the given file.

Specified by:
streamFile in interface AGIChannel
Parameters:
file - name of the file to play.
Throws:
AGIException

streamFile

public char streamFile(java.lang.String file,
                       java.lang.String escapeDigits)
                throws AGIException
Description copied from interface: AGIChannel
Plays the given file and allows the user to escape by pressing one of the given digit.

Specified by:
streamFile in interface AGIChannel
Parameters:
file - name of the file to play.
escapeDigits - a String containing the DTMF digits that allow the user to escape.
Returns:
the DTMF digit pressed or 0x0 if none was pressed.
Throws:
AGIException

sayDigits

public void sayDigits(java.lang.String digits)
               throws AGIException
Description copied from interface: AGIChannel
Says the given digit string.

Specified by:
sayDigits in interface AGIChannel
Parameters:
digits - the digit string to say.
Throws:
AGIException

sayDigits

public char sayDigits(java.lang.String digits,
                      java.lang.String escapeDigits)
               throws AGIException
Description copied from interface: AGIChannel
Says the given number, returning early if any of the given DTMF number are received on the channel.

Specified by:
sayDigits in interface AGIChannel
Parameters:
digits - the digit string to say.
escapeDigits - a String containing the DTMF digits that allow the user to escape.
Returns:
the DTMF digit pressed or 0x0 if none was pressed.
Throws:
AGIException

sayNumber

public void sayNumber(java.lang.String number)
               throws AGIException
Description copied from interface: AGIChannel
Says the given number.

Specified by:
sayNumber in interface AGIChannel
Parameters:
number - the number to say.
Throws:
AGIException

sayNumber

public char sayNumber(java.lang.String number,
                      java.lang.String escapeDigits)
               throws AGIException
Description copied from interface: AGIChannel
Says the given number, returning early if any of the given DTMF number are received on the channel.

Specified by:
sayNumber in interface AGIChannel
Parameters:
number - the number to say.
escapeDigits - a String containing the DTMF digits that allow the user to escape.
Returns:
the DTMF digit pressed or 0x0 if none was pressed.
Throws:
AGIException

sayPhonetic

public void sayPhonetic(java.lang.String text)
                 throws AGIException
Description copied from interface: AGIChannel
Says the given character string with phonetics.

Specified by:
sayPhonetic in interface AGIChannel
Parameters:
text - the text to say.
Throws:
AGIException

sayPhonetic

public char sayPhonetic(java.lang.String text,
                        java.lang.String escapeDigits)
                 throws AGIException
Description copied from interface: AGIChannel
Says the given character string with phonetics, returning early if any of the given DTMF number are received on the channel.

Specified by:
sayPhonetic in interface AGIChannel
Parameters:
text - the text to say.
escapeDigits - a String containing the DTMF digits that allow the user to escape.
Returns:
the DTMF digit pressed or 0x0 if none was pressed.
Throws:
AGIException

sayAlpha

public void sayAlpha(java.lang.String text)
              throws AGIException
Description copied from interface: AGIChannel
Says the given character string.

Specified by:
sayAlpha in interface AGIChannel
Parameters:
text - the text to say.
Throws:
AGIException

sayAlpha

public char sayAlpha(java.lang.String text,
                     java.lang.String escapeDigits)
              throws AGIException
Description copied from interface: AGIChannel
Says the given character string, returning early if any of the given DTMF number are received on the channel.

Specified by:
sayAlpha in interface AGIChannel
Parameters:
text - the text to say.
escapeDigits - a String containing the DTMF digits that allow the user to escape.
Returns:
the DTMF digit pressed or 0x0 if none was pressed.
Throws:
AGIException

sayTime

public void sayTime(long time)
             throws AGIException
Description copied from interface: AGIChannel
Says the given time.

Specified by:
sayTime in interface AGIChannel
Parameters:
time - the time to say in seconds since 00:00:00 on January 1, 1970.
Throws:
AGIException

sayTime

public char sayTime(long time,
                    java.lang.String escapeDigits)
             throws AGIException
Description copied from interface: AGIChannel
Says the given time, returning early if any of the given DTMF number are received on the channel.

Specified by:
sayTime in interface AGIChannel
Parameters:
time - the time to say in seconds since 00:00:00 on January 1, 1970.
escapeDigits - a String containing the DTMF digits that allow the user to escape.
Returns:
the DTMF digit pressed or 0x0 if none was pressed.
Throws:
AGIException

getVariable

public java.lang.String getVariable(java.lang.String name)
                             throws AGIException
Description copied from interface: AGIChannel
Returns the value of the current channel variable.

Specified by:
getVariable in interface AGIChannel
Parameters:
name - the name of the variable to retrieve.
Returns:
the value of the given variable or null if not set.
Throws:
AGIException

setVariable

public void setVariable(java.lang.String name,
                        java.lang.String value)
                 throws AGIException
Description copied from interface: AGIChannel
Sets the value of the current channel variable to a new value.

Specified by:
setVariable in interface AGIChannel
Parameters:
name - the name of the variable to retrieve.
value - the new value to set.
Throws:
AGIException

waitForDigit

public char waitForDigit(int timeout)
                  throws AGIException
Description copied from interface: AGIChannel
Waits up to 'timeout' milliseconds to receive a DTMF digit.

Specified by:
waitForDigit in interface AGIChannel
Parameters:
timeout - timeout the milliseconds to wait for the channel to receive a DTMF digit, -1 will wait forever.
Returns:
the DTMF digit pressed or 0x0 if none was pressed.
Throws:
AGIException

getFullVariable

public java.lang.String getFullVariable(java.lang.String name)
                                 throws AGIException
Description copied from interface: AGIChannel
Returns the value of the current channel variable, unlike getVariable() this method understands complex variable names and builtin variables.
Available since Asterisk 1.2.

Specified by:
getFullVariable in interface AGIChannel
Parameters:
name - the name of the variable to retrieve.
Returns:
the value of the given variable or null if not set.
Throws:
AGIException

getFullVariable

public java.lang.String getFullVariable(java.lang.String name,
                                        java.lang.String channel)
                                 throws AGIException
Description copied from interface: AGIChannel
Returns the value of the given channel variable.
Available since Asterisk 1.2.

Specified by:
getFullVariable in interface AGIChannel
Parameters:
name - the name of the variable to retrieve.
channel - the name of the channel.
Returns:
the value of the given variable or null if not set.
Throws:
AGIException

sayDateTime

public char sayDateTime(long time,
                        java.lang.String escapeDigits,
                        java.lang.String format,
                        java.lang.String timezone)
                 throws AGIException
Description copied from interface: AGIChannel
Says the given time in the given format and timezone and allows interruption by one of the given escape digits.
Available since Asterisk 1.2.

Specified by:
sayDateTime in interface AGIChannel
Parameters:
time - the time to say in seconds elapsed since 00:00:00 on January 1, 1970, Coordinated Universal Time (UTC)
escapeDigits - the digits that allow the user to interrupt this command or null for none.
format - the format the time should be said in
timezone - the timezone to use when saying the time, for example "UTC" or "Europe/Berlin".
Returns:
the DTMF digit pressed or 0x0 if none was pressed.
Throws:
AGIException

sayDateTime

public char sayDateTime(long time,
                        java.lang.String escapeDigits,
                        java.lang.String format)
                 throws AGIException
Description copied from interface: AGIChannel
Says the given time in the given format and allows interruption by one of the given escape digits.
Available since Asterisk 1.2.

Specified by:
sayDateTime in interface AGIChannel
Parameters:
time - the time to say in seconds elapsed since 00:00:00 on January 1, 1970, Coordinated Universal Time (UTC)
escapeDigits - the digits that allow the user to interrupt this command or null for none.
format - the format the time should be said in
Returns:
the DTMF digit pressed or 0x0 if none was pressed.
Throws:
AGIException

sayDateTime

public char sayDateTime(long time,
                        java.lang.String escapeDigits)
                 throws AGIException
Description copied from interface: AGIChannel
Says the given time and allows interruption by one of the given escape digits.
Available since Asterisk 1.2.

Specified by:
sayDateTime in interface AGIChannel
Parameters:
time - the time to say in seconds elapsed since 00:00:00 on January 1, 1970, Coordinated Universal Time (UTC)
escapeDigits - the digits that allow the user to interrupt this command or null for none.
Returns:
the DTMF digit pressed or 0x0 if none was pressed.
Throws:
AGIException

sayDateTime

public void sayDateTime(long time)
                 throws AGIException
Description copied from interface: AGIChannel
Says the given time.
Available since Asterisk 1.2.

Specified by:
sayDateTime in interface AGIChannel
Parameters:
time - the time to say in seconds elapsed since 00:00:00 on January 1, 1970, Coordinated Universal Time (UTC)
Throws:
AGIException


Copyright © 2004-2005 Stefan Reuter. All Rights Reserved.