Interface ByteBufferDestination

    • Method Detail

      • getByteBuffer

        ByteBuffer getByteBuffer()
        Returns the buffer to write to.
        Returns:
        the buffer to write to
      • drain

        ByteBuffer drain​(ByteBuffer buf)
        Consumes the buffer content and returns a buffer with more available space (which may or may not be the same instance).

        Called by the producer when buffer becomes too full to write to.

        Parameters:
        buf - the buffer to drain
        Returns:
        a buffer with more available space (which may or may not be the same instance)
      • writeBytes

        void writeBytes​(ByteBuffer data)
        Writes the given data to this ByteBufferDestination entirely. Call of this method should *not* be protected with synchronized on this ByteBufferDestination instance. ByteBufferDestination implementations should synchronize themselves inside this method, if needed.
        Since:
        2.9 (see LOG4J2-1874)
      • writeBytes

        void writeBytes​(byte[] data,
                        int offset,
                        int length)
        Writes the given data to this ByteBufferDestination. Call of this method should *not* be protected with synchronized on this ByteBufferDestination instance. ByteBufferDestination implementations should synchronize themselves inside this method, if needed.

        This method should behave identically to writeBytes(ByteBuffer.wrap(data, offset, length). It is provided to allow callers not to generate extra garbage.

        This method is called writeBytes() to avoid clashing with OutputStreamManager.write(byte[], int, int), which might be overridden in user-defined subclasses as protected, hence adding it to interface and requiring the method to be public breaks source compatibility.

        Since:
        2.9 (see LOG4J2-1874)