Class TerminalHost

    • Constructor Detail

      • TerminalHost

        public TerminalHost​(TerminalProps terminalProps,
                            AppSessionGyro appGyro)
        The constructor.
        Parameters:
        terminalProps - The terminal properties.
        appGyro - The application session gyro.
    • Method Detail

      • dispose

        public void dispose()
        Dispose.
      • addListener

        public boolean addListener​(ITerminalStateListener listener)
        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:
        java.lang.NullPointerException - If the listener is null.
      • removeListener

        public boolean removeListener​(ITerminalStateListener listener)
        Removes a listener.
        Parameters:
        listener - The listener to remove.
        Returns:
        true if listener is successfully removed, false otherwise.
      • createHostSession

        public HostSession createHostSession()
                                      throws java.io.IOException
        Creates a HostSession if not already created.
        Returns:
        Thew new or existing host session, never null.
        Throws:
        java.io.IOException - For failures when creating SSL engine.
      • getHostSession

        public HostSession getHostSession()
        Gets the host session instance.
        Returns:
        The host session, null if none is created.
      • getMatchingScreens

        public ScreenProp[] getMatchingScreens()
        Gets the matching screens.
        Returns:
        Matching screens array, never null.
      • onScreenChanged

        public void onScreenChanged​(ScreenProp screen,
                                    boolean isRemoved)
        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

        public int onHostDataStreamProcessing​(HostSessionPeer peer,
                                              boolean isEntering)
        Called when the datastream enters or exits processing. This enables the owner to "group" multiple notification events together.
        Specified by:
        onHostDataStreamProcessing in interface HostSessionOwner
        Parameters:
        peer - The peer.
        isEntering - Flag for entering or exiting.
        Returns:
        Bit flags 0x01 = characters changed, 0x02=fields changed.
      • printSession

        public boolean printSession​(HostSessionPeer peer)
        Called when the host (mainframe) has issued a Print Session (Print Local Copy).
        Specified by:
        printSession in interface HostSessionOwner
        Parameters:
        peer - The peer.
        Returns:
        true for success, false for cancel.
      • getWorker

        public Worker getWorker()
                         throws java.io.IOException
        Gets the worker of the session.
        Specified by:
        getWorker in interface HostSessionOwner
        Returns:
        The worker.
        Throws:
        java.io.IOException - For error when getting the worker.
      • onHostDataStreamProcessing

        public void onHostDataStreamProcessing​(HostSessionPeer peer,
                                               boolean isEntering,
                                               int updates)
        Data stream processing notification method.
        Specified by:
        onHostDataStreamProcessing in interface HostSessionListener
        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).
      • 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.