Package com.helger.base.codec

Interface IByteArrayDecoder

All Superinterfaces:
IDecoder<byte[],byte[]>
All Known Subinterfaces:
IByteArrayCodec, IByteArrayStreamDecoder
All Known Implementing Classes:
ASCII85Codec, ASCIIHexCodec, Base16Codec, Base32Codec, Base64Codec, DCTCodec, FlateCodec, GZIPCodec, IdentityByteArrayCodec, LZWCodec, QuotedPrintableCodec, RFC3986Codec, RunLengthCodec
Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
@FunctionalInterface public interface IByteArrayDecoder extends IDecoder<byte[],byte[]>
Interface for a single decoder of bytes.
Author:
Philip Helger

  • Method Summary

    Modifier and Type
    Method
    Description
    default byte @Nullable []
    getDecoded(byte @Nullable [] aEncodedBuffer)
    Decode a byte array.
    byte @Nullable []
    getDecoded(byte @Nullable [] aEncodedBuffer, int nOfs, int nLen)
    Decode a byte array.
    default byte @Nullable []
    getDecoded(@Nullable String sEncoded, @NonNull Charset aCharset)
    Decode the passed string.
    default int
    getMaximumDecodedLength(int nEncodedLen)
    Get the maximum decoded length based on the provided encoded length.

  • Method Details

    • getMaximumDecodedLength

      @Nonnegative default int getMaximumDecodedLength(@Nonnegative int nEncodedLen)
      Get the maximum decoded length based on the provided encoded length. This is purely for performance reasons.
      Parameters:
      nEncodedLen - The encoded length. Always ≥ 0.
      Returns:
      The maximum decoded length. Always ≥ 0.
      Since:
      9.3.6

    • getDecoded

      @ReturnsMutableCopy default byte @Nullable [] getDecoded(byte @Nullable [] aEncodedBuffer)
      Decode a byte array.
      Specified by:
      getDecoded in interface IDecoder<byte[],byte[]>
      Parameters:
      aEncodedBuffer - The byte array to be decoded. May be null.
      Returns:
      The decoded byte array or null if the parameter was null.
      Throws:
      DecodeException - in case something goes wrong

    • getDecoded

      @ReturnsMutableCopy byte @Nullable [] getDecoded(byte @Nullable [] aEncodedBuffer, @Nonnegative int nOfs, @Nonnegative int nLen)
      Decode a byte array.
      Parameters:
      aEncodedBuffer - The byte array to be decoded. May be null.
      nOfs - Offset into the byte array to start from.
      nLen - Number of bytes starting from offset to consider.
      Returns:
      The decoded byte array or null if the parameter was null.
      Throws:
      DecodeException - in case something goes wrong

    • getDecoded

      @ReturnsMutableCopy default byte @Nullable [] getDecoded(@Nullable String sEncoded, @NonNull Charset aCharset)
      Decode the passed string.
      Parameters:
      sEncoded - The string to be decoded. May be null.
      aCharset - The charset to be used. May not be null.
      Returns:
      null if the input string is null.
      Throws:
      DecodeException - in case something goes wrong