com.attachmate.sc.ssa
Class VTController

java.lang.Object
  |
  +--com.attachmate.sc.ssa.VTController

All Implemented Interfaces:

IController

public class VTController

extends java.lang.Object

implements IController

VT controller for IQAScreen.sendKeys.

The following actions are supported.

KeyCommand
@0	IVTDirectAccessConstants.CMD_NONE
@1	IVTDirectAccessConstants.CMD_F1
@2	IVTDirectAccessConstants.CMD_F2
@3	IVTDirectAccessConstants.CMD_F3
@4	IVTDirectAccessConstants.CMD_F4
@5	IVTDirectAccessConstants.CMD_F5
@6	IVTDirectAccessConstants.CMD_F6
@7	IVTDirectAccessConstants.CMD_F7
@8	IVTDirectAccessConstants.CMD_F8
@9	IVTDirectAccessConstants.CMD_F9
@a	IVTDirectAccessConstants.CMD_F10
@b	IVTDirectAccessConstants.CMD_F11
@c	IVTDirectAccessConstants.CMD_F12
@d	IVTDirectAccessConstants.CMD_F13
@e	IVTDirectAccessConstants.CMD_F14
@f	IVTDirectAccessConstants.CMD_F15
@g	IVTDirectAccessConstants.CMD_F16
@h	IVTDirectAccessConstants.CMD_F17
@i	IVTDirectAccessConstants.CMD_F18
@j	IVTDirectAccessConstants.CMD_F19
@k	IVTDirectAccessConstants.CMD_F20
@E	IVTDirectAccessConstants.CMD_TRANSMIT
@u	IVTDirectAccessConstants.CMD_PREVIOUS
@v	IVTDirectAccessConstants.CMD_NEXT
@D	IVTDirectAccessConstants.CMD_REMOVE
@U	IVTDirectAccessConstants.CMD_UP
@V	IVTDirectAccessConstants.CMD_DOWN
@L	IVTDirectAccessConstants.CMD_LEFT
@Z	IVTDirectAccessConstants.CMD_RIGHT
@w	IVTDirectAccessConstants.CMD_PF1
@x	IVTDirectAccessConstants.CMD_PF2
@y	IVTDirectAccessConstants.CMD_PF3
@z	IVTDirectAccessConstants.CMD_PF4
@T	IVTDirectAccessConstants.CMD_TAB
@<	IVTDirectAccessConstants.CMD_BACKSPACE
@H	IVTDirectAccessConstants.CMD_HOLD
@P	IVTDirectAccessConstants.CMD_PRINT
@X	IVTDirectAccessConstants.CMD_COMPOSE
@N	IVTDirectAccessConstants.CMD_RETURN
@A@f	IVTDirectAccessConstants.CMD_FIND
@A@I	IVTDirectAccessConstants.CMD_INSERT
@A@s	IVTDirectAccessConstants.CMD_SELECT
@A@Q	IVTDirectAccessConstants.CMD_BREAK
@A@0	IVTDirectAccessConstants.CMD_KEYPAD_0
@A@1	IVTDirectAccessConstants.CMD_KEYPAD_1
@A@2	IVTDirectAccessConstants.CMD_KEYPAD_2
@A@3	IVTDirectAccessConstants.CMD_KEYPAD_3
@A@4	IVTDirectAccessConstants.CMD_KEYPAD_4
@A@5	IVTDirectAccessConstants.CMD_KEYPAD_5
@A@6	IVTDirectAccessConstants.CMD_KEYPAD_6
@A@7	IVTDirectAccessConstants.CMD_KEYPAD_7
@A@8	IVTDirectAccessConstants.CMD_KEYPAD_8
@A@9	IVTDirectAccessConstants.CMD_KEYPAD_9
@A@-	IVTDirectAccessConstants.CMD_KEYPAD_MINUS
@A@,	IVTDirectAccessConstants.CMD_KEYPAD_COMMA
@A@E	IVTDirectAccessConstants.CMD_KEYPAD_ENTER
@A@.	IVTDirectAccessConstants.CMD_KEYPAD_DECIMAL
@A@*	IVTDirectAccessConstants.CMD_KEYPAD_MULTIPLY
@A@/	IVTDirectAccessConstants.CMD_KEYPAD_DIVIDE
@A@+	IVTDirectAccessConstants.CMD_KEYPAD_PLUS
@A@R	IVTDirectAccessConstants.CMD_KEYPAD_ESCAPE
@S@1	IVTDirectAccessConstants.CMD_SHIFT_F1
@S@2	IVTDirectAccessConstants.CMD_SHIFT_F2
@S@3	IVTDirectAccessConstants.CMD_SHIFT_F3
@S@4	IVTDirectAccessConstants.CMD_SHIFT_F4
@S@5	IVTDirectAccessConstants.CMD_SHIFT_F5
@S@6	IVTDirectAccessConstants.CMD_SHIFT_F6
@S@7	IVTDirectAccessConstants.CMD_SHIFT_F7
@S@8	IVTDirectAccessConstants.CMD_SHIFT_F8
@S@9	IVTDirectAccessConstants.CMD_SHIFT_F9
@S@a	IVTDirectAccessConstants.CMD_SHIFT_F10
@S@b	IVTDirectAccessConstants.CMD_SHIFT_F11
@S@c	IVTDirectAccessConstants.CMD_SHIFT_F12
@S@d	IVTDirectAccessConstants.CMD_SHIFT_F13
@S@e	IVTDirectAccessConstants.CMD_SHIFT_F14
@S@f	IVTDirectAccessConstants.CMD_SHIFT_F15
@S@g	IVTDirectAccessConstants.CMD_SHIFT_F16
@S@h	IVTDirectAccessConstants.CMD_SHIFT_F17
@S@i	IVTDirectAccessConstants.CMD_SHIFT_F18
@S@j	IVTDirectAccessConstants.CMD_SHIFT_F19
@S@k	IVTDirectAccessConstants.CMD_SHIFT_F20
@^@0	IVTDirectAccessConstants.CMD_CONTROL_AT
@^@A	IVTDirectAccessConstants.CMD_CONTROL_A
@^@B	IVTDirectAccessConstants.CMD_CONTROL_B
@^@C	IVTDirectAccessConstants.CMD_CONTROL_C
@^@D	IVTDirectAccessConstants.CMD_CONTROL_D
@^@E	IVTDirectAccessConstants.CMD_CONTROL_E
@^@F	IVTDirectAccessConstants.CMD_CONTROL_F
@^@G	IVTDirectAccessConstants.CMD_CONTROL_G
@^@H	IVTDirectAccessConstants.CMD_CONTROL_H
@^@I	IVTDirectAccessConstants.CMD_CONTROL_I
@^@J	IVTDirectAccessConstants.CMD_CONTROL_J
@^@K	IVTDirectAccessConstants.CMD_CONTROL_K
@^@L	IVTDirectAccessConstants.CMD_CONTROL_L
@^@M	IVTDirectAccessConstants.CMD_CONTROL_M
@^@N	IVTDirectAccessConstants.CMD_CONTROL_N
@^@O	IVTDirectAccessConstants.CMD_CONTROL_O
@^@P	IVTDirectAccessConstants.CMD_CONTROL_P
@^@Q	IVTDirectAccessConstants.CMD_CONTROL_Q
@^@R	IVTDirectAccessConstants.CMD_CONTROL_R
@^@S	IVTDirectAccessConstants.CMD_CONTROL_S
@^@T	IVTDirectAccessConstants.CMD_CONTROL_T
@^@U	IVTDirectAccessConstants.CMD_CONTROL_U
@^@V	IVTDirectAccessConstants.CMD_CONTROL_V
@^@W	IVTDirectAccessConstants.CMD_CONTROL_W
@^@X	IVTDirectAccessConstants.CMD_CONTROL_X
@^@Y	IVTDirectAccessConstants.CMD_CONTROL_Y
@^@Z	IVTDirectAccessConstants.CMD_CONTROL_Z
@^@[	IVTDirectAccessConstants.CMD_CONTROL_LBRACKET
@^@\	IVTDirectAccessConstants.CMD_CONTROL_BACKSLASH
@^@]	IVTDirectAccessConstants.CMD_CONTROL_RBRACKET
@^@^	IVTDirectAccessConstants.CMD_CONTROL_CARET
@^@_	IVTDirectAccessConstants.CMD_CONTROL_UNDERSCORE

Field Summary

protected static java.lang.String	ACTION_KEYS a list of single character commands used by sendkeys.
protected static int[]	ACTION_LIST a list of commands and actions from IDirectActionConstants that match up with the sendkeys commands in ACTION_KEYS
protected static java.lang.String	MULTI_COMMAND a list of sendkey commands that are the prefix to combination commands.
protected static java.lang.String[]	SUB_COMMANDS a list of command suffixes for each character in MULTI_COMMAND.
protected static int[][]	SUBKEYS a list for character in the SUB_COMMANDS list.

Constructor Summary

VTController(com.attachmate.sc.ssa.IDirectAccess da)

Method Summary

protected void	execute(int command) Execute a command.
Point	getCursorTrigger() Sets the cursor trigger.
IPerformanceTool	getPerformanceTool() Gets the current performance tool from the current controller.
long	getSettleTime() Gets the amount of time a read should wait for a settled read.
long	getTimeout() Gets the maximum amount of time a read should take.
void	performAction(java.lang.String commands) Convert the supplied array of commands into actions.
protected void	read() Read data from the host.
void	setCursorTrigger(Point p) Sets the cursor trigger.
void	setFieldText(java.lang.String text) Write the supplied text to where the cursor is sitting.
void	setPerformanceTool(IPerformanceTool tool) Sets the performance tools on the current controller.
void	setSettleTime(long milliseconds) Sets the amount of time a read should wait for a settled read.
void	setTimeout(long milliseconds) Sets the amount of time to perform a read
protected void	write(int command) Send a command to the host.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ACTION_KEYS

protected static final java.lang.String ACTION_KEYS

a list of single character commands used by sendkeys. This must be kept up to date with ACTION_LIST

See Also:

Constant Field Values

ACTION_LIST

protected static final int[] ACTION_LIST

a list of commands and actions from IDirectActionConstants that match up with the sendkeys commands in ACTION_KEYS

MULTI_COMMAND

protected static final java.lang.String MULTI_COMMAND

a list of sendkey commands that are the prefix to combination commands.

See Also:

Constant Field Values

SUB_COMMANDS

protected static final java.lang.String[] SUB_COMMANDS

a list of command suffixes for each character in MULTI_COMMAND.

SUBKEYS

protected static final int[][] SUBKEYS

a list for character in the SUB_COMMANDS list. Use the actions and commands in IVTDirectAccessConstants.

Constructor Detail

VTController

public VTController(com.attachmate.sc.ssa.IDirectAccess da)

Method Detail

setFieldText

public void setFieldText(java.lang.String text)
                  throws ProtectedFieldException

Write the supplied text to where the cursor is sitting. The text will be trimmed to fit the field length.

Specified by:

setFieldText in interface IController

Parameters:

text - the String to write to the field

Throws:

ProtectedFieldException

performAction

public void performAction(java.lang.String commands)
                   throws com.attachmate.nav.engine.NavException,
                          java.io.IOException

Convert the supplied array of commands into actions. Any "AID" keys will be sent to the host. Actions will manipulate fields.

Specified by:

performAction in interface IController

Parameters:

commands - a String containing a list of commands.

Throws:

com.attachmate.nav.engine.CustomStepException

java.io.IOException

com.attachmate.nav.engine.NavException

setTimeout

public void setTimeout(long milliseconds)

Sets the amount of time to perform a read

Specified by:

setTimeout in interface IController

Parameters:

milliseconds - the maximum number of milliseconds the read should take.

getTimeout

public long getTimeout()

Gets the maximum amount of time a read should take.

Specified by:

getTimeout in interface IController

Returns:

the maximum amount of time in milliseconds.

setSettleTime

public void setSettleTime(long milliseconds)

Sets the amount of time a read should wait for a settled read. If the read returns with data before the time set, the timer is reset and another read is performed.

Specified by:

setSettleTime in interface IController

Parameters:

milliseconds - the amount of time to wait per read.

getSettleTime

public long getSettleTime()

Gets the amount of time a read should wait for a settled read. If the read returns with data before tthe time set, the timer is reset and another read is performed.

Specified by:

getSettleTime in interface IController

Returns:

the number of milliseconds to wait per read.

setCursorTrigger

public void setCursorTrigger(Point p)

Sets the cursor trigger. A settled read will exit when the host sets the cursor to this coordinate.

Specified by:

setCursorTrigger in interface IController

Parameters:

p - a Point containing the cursor coordinate to wait for. If it is set to (0,0), the read will rely on the timeout and settleTime for exiting the settled read.

getCursorTrigger

public Point getCursorTrigger()

Sets the cursor trigger. A settled read will exit when the host sets the cursor to this coordinate.

Specified by:

getCursorTrigger in interface IController

Returns:

a Point containing the cursor coordinate to wait for. If it is set to (0,0), the read will rely on the timeout and settleTime for exiting the settled read.

setPerformanceTool

public void setPerformanceTool(IPerformanceTool tool)

Sets the performance tools on the current controller.

Specified by:

setPerformanceTool in interface IController

Parameters:

tool - a reference to an object that has implemented IPerformanceTool.

getPerformanceTool

public IPerformanceTool getPerformanceTool()

Gets the current performance tool from the current controller.

Specified by:

getPerformanceTool in interface IController

Returns:

a reference to the object that has been assigned to this controller.

execute

protected void execute(int command)
                throws java.io.IOException,
                       com.attachmate.nav.engine.NavException

Execute a command. Performs a write and a settled read.

Parameters:

command - the command to execute on the write. This needs to be a IVTDirectAccessConstants CMD command.

Throws:

java.io.IOException

com.attachmate.nav.engine.NavException

write

protected void write(int command)
              throws java.io.IOException

Send a command to the host. Performs a write to the host using the commands (CMD_*) from IVTDirectAccessConstants

Parameters:

command - the command to send to the host.

Throws:

java.io.IOException

read

protected void read()
             throws java.io.IOException,
                    com.attachmate.nav.engine.NavException

Read data from the host. Performs a settled read. It uses the following pattern:

    try {
      read(timeout);
      while (onReadExit(status, bTimedOut)) { read(settleTime);}
    } catch (Timeout) { bTimedOut=true }
 

It uses the onReadExit() from IPerformanceTool to decide if another read is necessary.

Throws:

java.io.IOException

com.attachmate.nav.engine.NavException