|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES All Classes | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnet.sf.asterisk.fastagi.impl.AGIChannelImpl
public class AGIChannelImpl
Default implementation of the AGIChannel interface.
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 |
---|
public AGIChannelImpl(SocketConnectionFacade socket)
public AGIChannelImpl(AGIWriter agiWriter, AGIReader agiReader)
Method Detail |
---|
public AGIReply sendCommand(AGICommand command) throws AGIException
AGIChannel
sendCommand
in interface AGIChannel
command
- the command to send.
AGIException
- if the command can't be sent to Asterisk (for
example because the channel has been hung up)public void answer() throws AGIException
AGIChannel
answer
in interface AGIChannel
AGIException
public void hangup() throws AGIException
AGIChannel
hangup
in interface AGIChannel
AGIException
public void setAutoHangup(int time) throws AGIException
AGIChannel
setAutoHangup
in interface AGIChannel
time
- the number of seconds before this channel is automatically
hung up.AGIException
public void setCallerId(java.lang.String callerId) throws AGIException
AGIChannel
setCallerId
in interface AGIChannel
callerId
- the raw caller id to set, for example "John Doe<1234>".
AGIException
public void playMusicOnHold() throws AGIException
AGIChannel
playMusicOnHold
in interface AGIChannel
AGIException
public void playMusicOnHold(java.lang.String musicOnHoldClass) throws AGIException
AGIChannel
playMusicOnHold
in interface AGIChannel
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 playtimeout
- 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 playtimeout
- 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 intimezone
- 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
Overview
Package
Class
Use
Tree
Deprecated
Index
Help
PREV CLASS
NEXT CLASS
FRAMES
NO FRAMES
All Classes
SUMMARY: NESTED | FIELD | CONSTR | METHOD
DETAIL: FIELD | CONSTR | METHOD
Copyright © 2004-2005 Stefan Reuter. All Rights Reserved.