Interface BinaryHeaderSetter<C>

  • All Superinterfaces:
    HeaderSetter<byte[],​C>

    public interface BinaryHeaderSetter<C>
    extends HeaderSetter<byte[],​C>
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      byte[] getFixedLengthByteArray​(java.lang.String headerName, int length)
      Since the implementation itself knows the intrinsics of the headers and carrier lifecycle and handling, it should be responsible for providing a byte array.
    • Method Detail

      • getFixedLengthByteArray

        @Nullable
        byte[] getFixedLengthByteArray​(java.lang.String headerName,
                                       int length)
        Since the implementation itself knows the intrinsics of the headers and carrier lifecycle and handling, it should be responsible for providing a byte array. This enables the implementation to cache byte arrays wherever required and possible.

        NOTE: if this method returns null, the tracer will allocate a buffer for each header.

        Parameters:
        headerName - the header name for which the byte array is required
        length - the length of the required byte array
        Returns:
        a byte array with the requested length, or null if header-value-buffer is not supported.