Package org.apache.tomcat.websocket

Enum WsFrameBase.ReadState

  • All Implemented Interfaces:
    java.io.Serializable, java.lang.Comparable<WsFrameBase.ReadState>
    Enclosing class:
    WsFrameBase
    protected static enum WsFrameBase.ReadState
extends java.lang.Enum<WsFrameBase.ReadState>
    WAITING - not suspended Server case: waiting for a notification that data is ready to be read from the socket, the socket is registered to the poller Client case: data has been read from the socket and is waiting for data to be processed PROCESSING - not suspended Server case: reading from the socket and processing the data Client case: processing the data if such has already been read and more data will be read from the socket SUSPENDING_WAIT - suspended, a call to suspend() was made while in WAITING state. A call to resume() will do nothing and will transition to WAITING state SUSPENDING_PROCESS - suspended, a call to suspend() was made while in PROCESSING state. A call to resume() will do nothing and will transition to PROCESSING state SUSPENDED - suspended Server case: processing data finished (SUSPENDING_PROCESS) / a notification was received that data is ready to be read from the socket (SUSPENDING_WAIT), socket is not registered to the poller Client case: processing data finished (SUSPENDING_PROCESS) / data has been read from the socket and is available for processing (SUSPENDING_WAIT) A call to resume() will: Server case: register the socket to the poller Client case: resume data processing CLOSING - not suspended, a close will be send 
         resume           data to be        resume
     no action        processed         no action
  |---------------| |---------------| |----------|
  |               v |               v v          |
  |  |----------WAITING«--------PROCESSING----|  |
  |  |             ^   processing             |  |
  |  |             |   finished               |  |
  |  |             |                          |  |
  | suspend        |                     suspend |
  |  |             |                          |  |
  |  |          resume                        |  |
  |  |    register socket to poller (server)  |  |
  |  |    resume data processing (client)     |  |
  |  |             |                          |  |
  |  v             |                          v  |
 SUSPENDING_WAIT   |                  SUSPENDING_PROCESS
  |                |                             |
  | data available |        processing finished  |
  |-------------»SUSPENDED«----------------------|

    • Method Detail

      • values

        public static WsFrameBase.ReadState[] values()
        Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows: 
        for (WsFrameBase.ReadState c : WsFrameBase.ReadState.values())
    System.out.println(c);
        Returns:
        an array containing the constants of this enum type, in the order they are declared

      • valueOf

        public static WsFrameBase.ReadState valueOf​(java.lang.String name)
        Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
        Parameters:
        name - the name of the enum constant to be returned.
        Returns:
        the enum constant with the specified name
        Throws:
        java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
        java.lang.NullPointerException - if the argument is null

      • isSuspended

        public boolean isSuspended()