Package com.iizix.term.server
Class TerminalHost
java.lang.Object
com.iizix.term.server.TerminalHost
- All Implemented Interfaces:
HostSessionListener,HostSessionOwner
The terminal host implementation running a terminal of 3270, 5020 or EE type.
- Author:
- Christopher Mindus
Constructor Summary
ConstructorsConstructorDescriptionTerminalHost(TerminalProps terminalProps, AppSessionGyro appGyro) The constructor.Method Summary
Modifier and TypeMethodDescriptionbooleanaddListener(ITerminalStateListener listener) Adds a new listeners.Creates a HostSession if not already created.voiddispose()Dispose.Gets the host session instance.Gets the matching screens.Gets the SessionInfo.Gets the worker of the session.booleanChecks if session is connectable.booleanChecks if session is disconnectable.booleanChecks if session can be resumed.booleanChecks if session can be suspended.voidonConnectChange(HostSessionPeer peer, boolean connected) Notifies the session of a connect state change.voidonCursorPositionChange(HostSessionPeer peer, int x, int y) Notifies the session that the cursor position has changed.voidonFieldChange(HostSessionPeer peer) Notifies the session that fields have changed.intonHostDataStreamProcessing(HostSessionPeer peer, boolean isEntering) Called when the datastream enters or exits processing.voidonHostDataStreamProcessing(HostSessionPeer peer, boolean isEntering, int updates) Data stream processing notification method.voidCalled when a host printer needs printing of a new page.voidonScreenChange(HostSessionPeer peer, int beginPos, int endPos) Notifies the session of a screen change.voidonScreenChanged(ScreenProp screen, boolean isRemoved) Method to refresh the matching screens when one has been changed.voidonScreenSizeChange(HostSessionPeer peer, int cx, int cy) Notifies the session that the screen size has changed.voidonSessionFailure(HostSessionPeer peer, Throwable exception) Called when a session has had a failure.voidonStateChange(HostSessionPeer peer) Notifies the session of a state change (such as insert mode, lock state, error state).booleanprintSession(HostSessionPeer peer) Called when the host (mainframe) has issued a Print Session (Print Local Copy).booleanremoveListener(ITerminalStateListener listener) Removes a listener.voidsoundAlarm(HostSessionPeer peer) Sound alarm on the client.
Constructor Details
TerminalHost
The constructor.- Parameters:
terminalProps- The terminal properties.appGyro- The application session gyro.
Method Details
dispose
public void dispose()Dispose.addListener
Adds a new listeners. Calling this method multiple times with the same listener will have no effect (but to return false).- Parameters:
listener- The listener to add.- Returns:
- true if the listener was added, false otherwise.
- Throws:
NullPointerException- If the listener isnull.
removeListener
Removes a listener.- Parameters:
listener- The listener to remove.- Returns:
- true if listener is successfully removed, false otherwise.
createHostSession
Creates a HostSession if not already created.- Returns:
- Thew new or existing host session, never null.
- Throws:
IOException- For failures when creating SSL engine.
getHostSession
Gets the host session instance.- Returns:
- The host session, null if none is created.
getMatchingScreens
Gets the matching screens.- Returns:
- Matching screens array, never null.
onScreenChanged
Method to refresh the matching screens when one has been changed.- Parameters:
screen- The changed screen or null for all.isRemoved- Flag for removed.
onHostDataStreamProcessing
Called when the datastream enters or exits processing. This enables the owner to "group" multiple notification events together.- Specified by:
onHostDataStreamProcessingin interfaceHostSessionOwner- Parameters:
peer- The peer.isEntering- Flag for entering or exiting.- Returns:
- Bit flags 0x01 = characters changed, 0x02=fields changed.
onHostPrintPage
Called when a host printer needs printing of a new page.- Specified by:
onHostPrintPagein interfaceHostSessionOwner- Parameters:
peer- The peer.
printSession
Called when the host (mainframe) has issued a Print Session (Print Local Copy).- Specified by:
printSessionin interfaceHostSessionOwner- Parameters:
peer- The peer.- Returns:
- true for success, false for cancel.
getWorker
Gets the worker of the session.- Specified by:
getWorkerin interfaceHostSessionOwner- Returns:
- The worker.
- Throws:
IOException- For error when getting the worker.
getSessionInfo
Gets the SessionInfo.- Specified by:
getSessionInfoin interfaceHostSessionOwner- Returns:
- The session info, never null.
onScreenChange
Notifies the session of a screen change.- Specified by:
onScreenChangein interfaceHostSessionListener
onFieldChange
Notifies the session that fields have changed.- Specified by:
onFieldChangein interfaceHostSessionListener
onScreenSizeChange
Notifies the session that the screen size has changed.- Specified by:
onScreenSizeChangein interfaceHostSessionListener
onCursorPositionChange
Notifies the session that the cursor position has changed.- Specified by:
onCursorPositionChangein interfaceHostSessionListener
onConnectChange
Notifies the session of a connect state change.- Specified by:
onConnectChangein interfaceHostSessionListener
onStateChange
Notifies the session of a state change (such as insert mode, lock state, error state).- Specified by:
onStateChangein interfaceHostSessionListener
onSessionFailure
Called when a session has had a failure.- Specified by:
onSessionFailurein interfaceHostSessionListener
onHostDataStreamProcessing
Data stream processing notification method.- Specified by:
onHostDataStreamProcessingin interfaceHostSessionListener- Parameters:
peer- The peer.isEntering- The state of processing (true=before, false=after).updates- What has been updated on screen (bit flag: 0x01=characters, 0x02=fields).
soundAlarm
Sound alarm on the client.- Specified by:
soundAlarmin interfaceHostSessionListener
isConnectEnabled
public boolean isConnectEnabled()Checks if session is connectable.- Returns:
- true if connectable.
isSuspendEnabled
public boolean isSuspendEnabled()Checks if session can be suspended.- Returns:
- true if suspendable.
isResumeEnabled
public boolean isResumeEnabled()Checks if session can be resumed.- Returns:
- true if resumeable.
isDisconnectEnabled
public boolean isDisconnectEnabled()Checks if session is disconnectable.- Returns:
- true if disconnectable.