net.sf.asterisk.fastagi.command
Class GetOptionCommand

java.lang.Object
  extended by net.sf.asterisk.fastagi.command.AGICommand
      extended by net.sf.asterisk.fastagi.command.GetOptionCommand
All Implemented Interfaces:
java.io.Serializable

public class GetOptionCommand
extends AGICommand

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 this command waits for the specified timeout still waiting for the user to press a digit. Streaming always begins at the beginning.
Returns 0 if no digit being pressed, or the ASCII numerical value of the digit if one was pressed, or -1 on error or if the channel was disconnected.
Remember, the file extension must not be included in the filename.

Version:
$Id: GetOptionCommand.java,v 1.1 2005/08/01 18:38:43 srt Exp $
Author:
srt
See Also:
StreamFileCommand, Serialized Form

Constructor Summary
GetOptionCommand(java.lang.String file, java.lang.String escapeDigits)
          Creates a new GetOptionCommand with a default timeout of 5 seconds.
GetOptionCommand(java.lang.String file, java.lang.String escapeDigits, int timeout)
          Creates a new GetOptionCommand with the given timeout.
 
Method Summary
 java.lang.String buildCommand()
          Returns a string suitable to be sent to asterisk.
 java.lang.String getEscapeDigits()
          Returns the digits that the user is expected to press.
 java.lang.String getFile()
          Returns the name of the file to stream.
 int getTimeout()
          Returns the timeout to wait if none of the defined esacpe digits was presses while streaming.
 void setEscapeDigits(java.lang.String escapeDigits)
          Sets the digits that the user is expected to press.
 void setFile(java.lang.String file)
          Sets the name of the file to stream.
 void setTimeout(int timeout)
          Sets the timeout to wait if none of the defined esacpe digits was presses while streaming.
 
Methods inherited from class net.sf.asterisk.fastagi.command.AGICommand
escapeAndQuote, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

GetOptionCommand

public GetOptionCommand(java.lang.String file,
                        java.lang.String escapeDigits)
Creates a new GetOptionCommand with a default timeout of 5 seconds.

Parameters:
file - the name of the file to stream, must not include extension.
escapeDigits - contains the digits that the user is expected to press.

GetOptionCommand

public GetOptionCommand(java.lang.String file,
                        java.lang.String escapeDigits,
                        int timeout)
Creates a new GetOptionCommand with the given timeout.

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.
Method Detail

getFile

public java.lang.String getFile()
Returns the name of the file to stream.

Returns:
the name of the file to stream.

setFile

public void setFile(java.lang.String file)
Sets the name of the file to stream.

Parameters:
file - the name of the file to stream, must not include extension.

getEscapeDigits

public java.lang.String getEscapeDigits()
Returns the digits that the user is expected to press.

Returns:
the digits that the user is expected to press.

setEscapeDigits

public void setEscapeDigits(java.lang.String escapeDigits)
Sets the digits that the user is expected to press.

Parameters:
escapeDigits - the digits that the user is expected to press.

getTimeout

public int getTimeout()
Returns the timeout to wait if none of the defined esacpe digits was presses while streaming.

Returns:
the timeout in seconds.

setTimeout

public void setTimeout(int timeout)
Sets the timeout to wait if none of the defined esacpe digits was presses while streaming.

Parameters:
timeout - the timeout in seconds.

buildCommand

public java.lang.String buildCommand()
Description copied from class: AGICommand
Returns a string suitable to be sent to asterisk.

Specified by:
buildCommand in class AGICommand
Returns:
a string suitable to be sent to asterisk.


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