com.helger.commons.codec

Interface IByteArrayStreamDecoder

All Superinterfaces:

IByteArrayDecoder, IDecoder<byte[],byte[]>

All Known Subinterfaces:

IByteArrayCodec

All Known Implementing Classes:

ASCII85Codec, ASCIIHexCodec, Base16Codec, Base32Codec, Base64Codec, FlateCodec, GZIPCodec, IdentityByteArrayCodec, LZWCodec, QuotedPrintableCodec, RunLengthCodec, URLCodec

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 IByteArrayStreamDecoder
extends IByteArrayDecoder

Interface for a single decoder of bytes, based on streams.

Author:

Philip Helger

Method Summary

Modifier and Type	Method and Description
void	decode(byte[] aEncodedBuffer, int nOfs, int nLen, OutputStream aOS) Decode (part of) a byte array.
default void	decode(byte[] aEncodedBuffer, OutputStream aOS) Decode a byte array.
default byte[]	getDecoded(byte[] aEncodedBuffer, int nOfs, int nLen) Decode a byte array.
default String	getDecodedAsString(byte[] aEncodedBuffer, Charset aCharset)
default String	getDecodedAsString(byte[] aEncodedBuffer, int nOfs, int nLen, Charset aCharset)
default String	getDecodedAsString(String sEncoded, Charset aCharset) Decode the passed string.
default String	getDecodedAsString(String sEncoded, Charset aEncodedCharset, Charset aDecodedCharset) Decode the passed string.

Methods inherited from interface com.helger.commons.codec.IByteArrayDecoder

getDecoded, getDecoded, getMaximumDecodedLength

Method Detail

decode

default void decode(@Nullable
                    byte[] aEncodedBuffer,
                    @Nonnull @WillNotClose
                    OutputStream aOS)

Decode a byte array.

Parameters:

aEncodedBuffer - The byte array to be decoded. May be null.

aOS - The output stream to write to. May not be null and is NOT closed afterwards!

Throws:

DecodeException - in case something goes wrong

Since:

9.0.0

decode

void decode(@Nullable
            byte[] aEncodedBuffer,
            @Nonnegative
            int nOfs,
            @Nonnegative
            int nLen,
            @Nonnull @WillNotClose
            OutputStream aOS)

Decode (part of) 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.

aOS - The output stream to write to. May not be null and is NOT closed afterwards!

Throws:

DecodeException - in case something goes wrong

getDecoded

@Nullable
 @ReturnsMutableCopy
default byte[] getDecoded(@Nullable
                                                           byte[] aEncodedBuffer,
                                                           @Nonnegative
                                                           int nOfs,
                                                           @Nonnegative
                                                           int nLen)

Decode a byte array.

Specified by:

getDecoded in interface IByteArrayDecoder

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

getDecodedAsString

@Nullable
default String getDecodedAsString(@Nullable
                                             byte[] aEncodedBuffer,
                                             @Nonnull
                                             Charset aCharset)

getDecodedAsString

@Nullable
default String getDecodedAsString(@Nullable
                                             byte[] aEncodedBuffer,
                                             @Nonnegative
                                             int nOfs,
                                             @Nonnegative
                                             int nLen,
                                             @Nonnull
                                             Charset aCharset)

getDecodedAsString

@Nullable
default String getDecodedAsString(@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 for encoding AND decoding. May not be null.

Returns:

null if the input string is null.

Throws:

DecodeException - in case something goes wrong

getDecodedAsString

@Nullable
default String getDecodedAsString(@Nullable
                                             String sEncoded,
                                             @Nonnull
                                             Charset aEncodedCharset,
                                             @Nonnull
                                             Charset aDecodedCharset)

Decode the passed string.

Parameters:

sEncoded - The string to be decoded. May be null.

aEncodedCharset - The charset to be used for the encoded string. May not be null.

aDecodedCharset - The charset to be used for the decoded result string. May not be null.

Returns:

null if the input string is null.

Throws:

DecodeException - in case something goes wrong

Since:

9.3.6