com.qcloud.cos.internal

Class SdkDigestInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

java.security.DigestInputStream

com.qcloud.cos.internal.SdkDigestInputStream

All Implemented Interfaces:

Releasable, Closeable, AutoCloseable

Direct Known Subclasses:

DigestValidationInputStream

public class SdkDigestInputStream
extends DigestInputStream
implements Releasable

Field Summary

Fields inherited from class java.security.DigestInputStream

digest

Fields inherited from class java.io.FilterInputStream

in

Constructor Summary

Constructors

Constructor and Description
SdkDigestInputStream(InputStream stream, MessageDigest digest)

Method Summary

Modifier and Type	Method and Description
void	release() Releases the allocated resource.

Methods inherited from class java.security.DigestInputStream

getMessageDigest, on, read, read, setMessageDigest, toString

Methods inherited from class java.io.FilterInputStream

available, close, mark, markSupported, read, reset, skip

Methods inherited from class java.lang.Object

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

Constructor Detail

SdkDigestInputStream

public SdkDigestInputStream(InputStream stream,
                            MessageDigest digest)

Method Detail

release

public final void release()

Description copied from interface: Releasable

Releases the allocated resource. This method should not be called except by the caller who allocated the resource at the very top of the call stack. This allows, typically, a Closeable resource to be not unintentionally released owing to the calling of the Closeable.close() methods by implementation deep down in the call stack.

For example, the creation of a ResettableInputStream would entail physically opening a file. If the opened file is meant to be closed only (in a finally block) by the very same code block that created it, then it is necessary that the release method must not be called while the execution is made in other stack frames. In such case, as other stack frames may inadvertently or indirectly call the close method of the stream, the creator of the stream would need to explicitly disable the accidental closing via ResettableInputStream#disableClose(), so that the release method becomes the only way to truly close the opened file.

Specified by:

release in interface Releasable