Package software.amazon.awssdk.utils.io

Class LengthAwareInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

software.amazon.awssdk.utils.io.LengthAwareInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

@SdkProtectedApi
public class LengthAwareInputStream
extends FilterInputStream

An InputStream that is aware of its length. This class enforces that we sent exactly the number of bytes equal to the input length. If the wrapped stream has more bytes than the expected length, it will be truncated to length. If the stream has less bytes (i.e. reaches EOF) before the expected length is reached, it will throw IOException.

Field Summary

Fields inherited from class java.io.FilterInputStream

in

Constructor Summary

Constructors

Constructor	Description
LengthAwareInputStream(InputStream in, long length)

Method Summary

Modifier and Type	Method	Description
int	available()
void	mark(int readlimit)
int	read()
int	read(byte[] b, int off, int len)
long	remaining()
void	reset()
long	skip(long requestedBytesToSkip)

Methods inherited from class java.io.FilterInputStream

close, markSupported, read

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LengthAwareInputStream

public LengthAwareInputStream(InputStream in,
                              long length)

Method Detail

read

public final int read()
               throws IOException

Overrides:

read in class FilterInputStream

Throws:

IOException

read

public final int read(byte[] b,
                      int off,
                      int len)
               throws IOException

Overrides:

read in class FilterInputStream

Throws:

IOException

skip

public final long skip(long requestedBytesToSkip)
                throws IOException

Overrides:

skip in class FilterInputStream

Throws:

IOException

available

public final int available()
                    throws IOException

Overrides:

available in class FilterInputStream

Throws:

IOException

mark

public final void mark(int readlimit)

Overrides:

mark in class FilterInputStream

reset

public final void reset()
                 throws IOException

Overrides:

reset in class FilterInputStream

Throws:

IOException

remaining

public final long remaining()