com.qcloud.cos.utils

枚举 IOUtils

java.lang.Object

java.lang.Enum<IOUtils>

com.qcloud.cos.utils.IOUtils

所有已实现的接口:

Serializable, Comparable<IOUtils>

public enum IOUtils
extends Enum<IOUtils>

Utilities for IO operations.

方法概要

方法

限定符和类型	方法和说明
static void	closeQuietly(Closeable is, org.slf4j.Logger log) Closes the given Closeable quietly.
static long	copy(InputStream in, OutputStream out) Copies all bytes from the given input stream to the given output stream.
static void	release(Closeable is, org.slf4j.Logger log) Releases the given Closeable especially if it was an instance of Releasable.
static byte[]	toByteArray(InputStream is) Reads and returns the rest of the given input stream as a byte array.
static String	toString(InputStream is) Reads and returns the rest of the given input stream as a string.
static IOUtils	valueOf(String name) 返回带有指定名称的该类型的枚举常量。
static IOUtils[]	values() 按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。

从类继承的方法 java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

从类继承的方法 java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

方法详细资料

values

public static IOUtils[] values()

按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。该方法可用于迭代 常量, 如下所示:

for (IOUtils c : IOUtils.values())
    System.out.println(c);

返回:

按照声明该枚举类型的常量的顺序返回的包含这些常量的数组

valueOf

public static IOUtils valueOf(String name)

返回带有指定名称的该类型的枚举常量。 字符串必须与用于声明该类型的枚举常量的 标识符完全匹配。(不允许有多余 的空格字符。)

参数:

name - 要返回的枚举常量的名称。

返回:

返回带有指定名称的枚举常量

抛出:

IllegalArgumentException - 如果该枚举类型没有带有指定名称的常量

NullPointerException - 如果参数为空值

toByteArray

public static byte[] toByteArray(InputStream is)
                          throws IOException

Reads and returns the rest of the given input stream as a byte array. Caller is responsible for closing the given input stream.

抛出:

IOException

toString

public static String toString(InputStream is)
                       throws IOException

Reads and returns the rest of the given input stream as a string. Caller is responsible for closing the given input stream.

抛出:

IOException

closeQuietly

public static void closeQuietly(Closeable is,
                org.slf4j.Logger log)

Closes the given Closeable quietly.

参数:

is - the given closeable

log - logger used to log any failure should the close fail

release

public static void release(Closeable is,
           org.slf4j.Logger log)

Releases the given Closeable especially if it was an instance of Releasable.

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.

copy

public static long copy(InputStream in,
        OutputStream out)
                 throws IOException

Copies all bytes from the given input stream to the given output stream. Caller is responsible for closing the streams.

抛出:

IOException - if there is any IO exception during read or write.