org.jretty.util

类 NestedIOException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.io.IOException

org.jretty.util.NestedIOException

所有已实现的接口:

Serializable, NestedException, ExceptionDelegateSupport

public class NestedIOException
extends IOException
implements NestedException, ExceptionDelegateSupport

NestedIOException的作用： 如下例：

 public URI getURI() throws IOException {
    URL url = getURL();
    try {
        return UrlUtils.toURI(url);
    }
    catch (URISyntaxException ex) {
        throw new NestedIOException(ex);
    }
  }
 

如果外层只捕获 IOException，则内部抛出的其他异常无法捕获，所以必须要将内部其它异常 转换成IOException。 如果直接new IOException(ex)则堆栈重复了，所以使用嵌套异常 new NestedIOException(ex); 另外，也可以在方法内部将IO异常处理了，然后再抛出一个无堆栈信息的IO异常。例如：

 public void doPost() throws IOException {
    OutputStream in = getInput();
    try {
        do something with IOException...
    }
    catch (IOException ex) {
        close(in);
        logger.error(ex);
        throw new NestedIOException("post error, please retry...");
    }
  }
 

但是，对于上面这种情况，‘一般’不推荐这么做。建议 使用return false/true 来返回，或者， 如果有返回值，则可以用 return Result对象。

从以下版本开始:

2014-12-13

作者:

zollty

另请参阅:

NestedExceptionDelegate, 序列化表格

字段概要

字段

限定符和类型	字段和说明
static String	EXCEPTION_PRIFIX

构造器概要

构造器

构造器和说明
NestedIOException(Object message, Object... args)
NestedIOException(Throwable e)
NestedIOException(Throwable e, Object message, Object... args)

方法概要

限定符和类型	方法和说明
Throwable	getCause() 获取最原始的那个异常对象
NestedExceptionDelegate	getDelegate() 获取 Exception Delegate
String	getMessage()
IOException	getOrigException() 重造一个原始的、包含堆栈信息的IOException
StackTraceElement[]	getStackTrace()
String	getStackTraceStr()
void	printStackTrace()
void	printStackTrace(PrintStream err)
void	printStackTrace(PrintWriter err)
String	toString()

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

addSuppressed, fillInStackTrace, getLocalizedMessage, getSuppressed, initCause, setStackTrace

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

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

字段详细资料

EXCEPTION_PRIFIX

public static final String EXCEPTION_PRIFIX

另请参阅:

常量字段值

构造器详细资料

NestedIOException

public NestedIOException(Object message,
                         Object... args)

参数:

message - 自定义错误信息

args - 占位符参数--[ 变长参数，用于替换message字符串里面的占位符"{}" ]

NestedIOException

public NestedIOException(Throwable e)

参数:

e -

NestedIOException

public NestedIOException(Throwable e,
                         Object message,
                         Object... args)

参数:

e -

message - 自定义错误信息

args - 占位符参数--[ 变长参数，用于替换message字符串里面的占位符"{}" ]

方法详细资料

getStackTraceStr

public String getStackTraceStr()

指定者:

getStackTraceStr 在接口中 NestedException

返回:

异常堆栈字符串

getMessage

public String getMessage()

覆盖:

getMessage 在类中 Throwable

printStackTrace

public void printStackTrace()

覆盖:

printStackTrace 在类中 Throwable

printStackTrace

public void printStackTrace(PrintWriter err)

覆盖:

printStackTrace 在类中 Throwable

printStackTrace

public void printStackTrace(PrintStream err)

覆盖:

printStackTrace 在类中 Throwable

getStackTrace

public StackTraceElement[] getStackTrace()

覆盖:

getStackTrace 在类中 Throwable

getOrigException

public IOException getOrigException()

重造一个原始的、包含堆栈信息的IOException

toString

public String toString()

覆盖:

toString 在类中 Throwable

getCause

public Throwable getCause()

获取最原始的那个异常对象

覆盖:

getCause 在类中 Throwable

getDelegate

public NestedExceptionDelegate getDelegate()

从接口复制的说明: ExceptionDelegateSupport

获取 Exception Delegate

指定者:

getDelegate 在接口中 ExceptionDelegateSupport