net.sf.asterisk.fastagi.command
Class GetOptionCommand

java.lang.Object
  net.sf.asterisk.fastagi.command.AGICommand
      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.