Module org.eclipse.jetty.io
Package org.eclipse.jetty.io

Class AbstractEndPoint

    • Constructor Detail

      • AbstractEndPoint

        protected AbstractEndPoint​(org.eclipse.jetty.util.thread.Scheduler scheduler)

    • Method Detail

      • shutdownInput

        protected final void shutdownInput()

      • shutdownOutput

        public final void shutdownOutput()
        Description copied from interface: EndPoint
        Shutdown the output.

        This call indicates that no more data will be sent on this endpoint that that the remote end should read an EOF once all previously sent data has been consumed. Shutdown may be done either at the TCP/IP level, as a protocol exchange (Eg TLS close handshake) or both.

        If the endpoint has EndPoint.isInputShutdown() true, then this call has the same effect as EndPoint.close().

        Specified by:
        shutdownOutput in interface EndPoint

      • close

        public final void close()
        Description copied from interface: EndPoint
        Close any backing stream associated with the endpoint
        Specified by:
        close in interface java.lang.AutoCloseable
        Specified by:
        close in interface java.io.Closeable
        Specified by:
        close in interface EndPoint

      • close

        public final void close​(java.lang.Throwable failure)
        Description copied from interface: EndPoint
        Close any backing stream associated with the endpoint, passing a cause
        Specified by:
        close in interface EndPoint
        Parameters:
        failure - the reason for the close or null

      • doShutdownInput

        protected void doShutdownInput()

      • doShutdownOutput

        protected void doShutdownOutput()

      • doClose

        protected void doClose()

      • isInputShutdown

        public boolean isInputShutdown()
        Description copied from interface: EndPoint
        Test if the input is shutdown. The input is shutdown if an EOF has been read while doing a EndPoint.fill(ByteBuffer). Once the input is shutdown, all calls to EndPoint.fill(ByteBuffer) will return -1, until such time as the end point is close, when they will return EofException.
        Specified by:
        isInputShutdown in interface EndPoint
        Returns:
        True if the input is shutdown or the endpoint is closed.

      • isOpen

        public boolean isOpen()
        Description copied from class: IdleTimeout
        This abstract method should be called to check if idle timeouts should still be checked.
        Specified by:
        isOpen in interface EndPoint
        Specified by:
        isOpen in class IdleTimeout
        Returns:
        True if the entity monitored should still be checked for idle timeouts

      • checkFlush

        public void checkFlush()
                throws java.io.IOException
        Throws:
        java.io.IOException

      • checkFill

        public void checkFill()
               throws java.io.IOException
        Throws:
        java.io.IOException

      • reset

        protected void reset()

      • onClose

        public void onClose​(java.lang.Throwable failure)
        Description copied from interface: EndPoint

        Callback method invoked when this EndPoint is close.

        Specified by:
        onClose in interface EndPoint
        Parameters:
        failure - The reason for the close, or null if a normal close.
        See Also:
        EndPoint.onOpen()

      • fillInterested

        public void fillInterested​(org.eclipse.jetty.util.Callback callback)
        Description copied from interface: EndPoint

        Requests callback methods to be invoked when a call to EndPoint.fill(ByteBuffer) would return data or EOF.

        Specified by:
        fillInterested in interface EndPoint
        Parameters:
        callback - the callback to call when an error occurs or we are readable. The callback may implement the Invocable interface to self declare its blocking status. Non-blocking callbacks may be called more efficiently without dispatch delays.

      • tryFillInterested

        public boolean tryFillInterested​(org.eclipse.jetty.util.Callback callback)
        Description copied from interface: EndPoint

        Requests callback methods to be invoked when a call to EndPoint.fill(ByteBuffer) would return data or EOF.

        Specified by:
        tryFillInterested in interface EndPoint
        Parameters:
        callback - the callback to call when an error occurs or we are readable. The callback may implement the Invocable interface to self declare its blocking status. Non-blocking callbacks may be called more efficiently without dispatch delays.
        Returns:
        true if set

      • write

        public void write​(org.eclipse.jetty.util.Callback callback,
                  java.nio.ByteBuffer... buffers)
           throws java.lang.IllegalStateException
        Description copied from interface: EndPoint

        Writes the given buffers via EndPoint.flush(ByteBuffer...) and invokes callback methods when either all the data has been flushed or an error occurs.

        Specified by:
        write in interface EndPoint
        Parameters:
        callback - the callback to call when an error occurs or the write completed. The callback may implement the Invocable interface to self declare its blocking status. Non-blocking callbacks may be called more efficiently without dispatch delays.
        buffers - one or more ByteBuffers that will be flushed.
        Throws:
        java.nio.channels.WritePendingException - if another write operation is concurrent.
        java.lang.IllegalStateException

      • onIncompleteFlush

        protected abstract void onIncompleteFlush()

      • needsFillInterest

        protected abstract void needsFillInterest()
                                   throws java.io.IOException
        Throws:
        java.io.IOException

      • onIdleExpired

        protected void onIdleExpired​(java.util.concurrent.TimeoutException timeout)
        Description copied from class: IdleTimeout
        This abstract method is called when the idle timeout has expired.
        Specified by:
        onIdleExpired in class IdleTimeout
        Parameters:
        timeout - a TimeoutException

      • upgrade

        public void upgrade​(Connection newConnection)
        Description copied from interface: EndPoint
        Upgrade connections. Close the old connection, update the endpoint and open the new connection. If the oldConnection is an instance of Connection.UpgradeFrom then a prefilled buffer is requested and passed to the newConnection if it is an instance of Connection.UpgradeTo
        Specified by:
        upgrade in interface EndPoint
        Parameters:
        newConnection - The connection to upgrade to

      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object

      • toEndPointString

        public java.lang.String toEndPointString()

      • toConnectionString

        public java.lang.String toConnectionString()