Creates or reinitializes a {@link BinaryDecoder} with the input streamprovided as the source of data. If
reuse is provided, it will be reinitialized to the given input stream.
{@link BinaryDecoder} instances returned by this method buffer their input,reading up to {@link #getConfiguredBufferSize()} bytes past the minimumrequired to satisfy read requests in order to achieve better performance. If the buffering is not desired, use {@link #directBinaryDecoder(InputStream,BinaryDecoder)}.
{@link BinaryDecoder#inputStream()} provides a view on the data that isbuffer-aware, for users that need to interleave access to data with the Decoder API.
@param in The InputStream to initialize to
@param reuse The BinaryDecoder to
attempt to reuse given the factory configuration. A BinaryDecoder implementation may not be compatible with reuse, causing a new instance to be returned. If null, a new instance is returned.
@return A BinaryDecoder that uses
in as its source of data. If
reuse is null, this will be a new instance. If
reuse is not null, then it may be reinitialized if compatible, otherwise a new instance will be returned.
@see BinaryDecoder
@see Decoder