RuntimeUtils (bus-all 5.6.5 API)

java.lang.Object
- org.aoju.bus.core.utils.RuntimeUtils

```
public class RuntimeUtils
extends Object
```
系统运行时工具类用于执行系统命令的工具

Since:

JDK 1.8+

Version:

5.6.5

Author:

Kimi Liu

Constructor Summary

Constructors
Constructor and Description

RuntimeUtils()

Constructors
Constructor and Description
`RuntimeUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addShutdownHook(Runnable hook)` 增加一个JVM关闭后的钩子,用于在JVM关闭时执行某些操作
`static <T extends Throwable> T`	`convertFromOrSuppressedThrowable(Throwable throwable, Class<T> exceptionClass)` 转化指定异常为来自或者包含指定异常
`static <T extends Throwable> T`	`convertFromOrSuppressedThrowable(Throwable throwable, Class<T> exceptionClass, boolean checkCause)` 转化指定异常为来自或者包含指定异常
`static void`	`destroy(Process process)` 销毁进程
`static Process`	`exec(String... cmds)` 执行命令命令带参数时参数可作为其中一个参数,也可以将命令和参数组合为一个字符串传入
`static Process`	`exec(String[] envp, File dir, String... cmds)` 执行命令命令带参数时参数可作为其中一个参数,也可以将命令和参数组合为一个字符串传入
`static Process`	`exec(String[] envp, String... cmds)` 执行命令命令带参数时参数可作为其中一个参数,也可以将命令和参数组合为一个字符串传入
`static List<String>`	`execForLines(Charset charset, String... cmds)` 执行系统命令,使用系统默认编码
`static List<String>`	`execForLines(String... cmds)` 执行系统命令,使用系统默认编码
`static String`	`execForStr(Charset charset, String... cmds)` 执行系统命令,使用系统默认编码
`static String`	`execForStr(String... cmds)` 执行系统命令,使用系统默认编码
`static Throwable`	`getCausedBy(Throwable throwable, Class<? extends Exception>... causeClasses)` 获取由指定异常类引起的异常
`static String`	`getErrorResult(Process process)` 获取命令执行异常结果,使用系统默认编码,,获取后销毁进程
`static String`	`getErrorResult(Process process, Charset charset)` 获取命令执行异常结果,获取后销毁进程
`static String`	`getMessage(Throwable e)` 获得完整消息,包括异常名,消息格式为：{SimpleClassName}: {ThrowableMessage}
`static String`	`getResult(Process process)` 获取命令执行结果,使用系统默认编码,,获取后销毁进程
`static String`	`getResult(Process process, Charset charset)` 获取命令执行结果,获取后销毁进程
`static List<String>`	`getResultLines(Process process)` 获取命令执行结果,使用系统默认编码,获取后销毁进程
`static List<String>`	`getResultLines(Process process, Charset charset)` 获取命令执行结果,使用系统默认编码,获取后销毁进程
`static Throwable`	`getRootCause(Throwable throwable)` 获取异常链中最尾端的异常,即异常最早发生的异常对象此方法通过调用`Throwable.getCause()` 直到没有cause为止,如果异常本身没有cause,返回异常本身传入null返回也为null
`static String`	`getRootCauseMessage(Throwable th)` 获取异常链中最尾端的异常的消息, 消息格式为：{SimpleClassName}: {ThrowableMessage}
`static StackTraceElement`	`getRootStackElement()` 获取入口堆栈信息
`static String`	`getSimpleMessage(Throwable e)` 获得消息,调用异常类的getMessage方法
`static StackTraceElement`	`getStackElement(int layers)` 获取指定层的堆栈信息
`static StackTraceElement[]`	`getStackElements()` 获取当前栈信息
`static String`	`getStackTrace(Throwable throwable)` 堆栈转为完整字符串
`static String`	`getStackTrace(Throwable throwable, int limit)` 堆栈转为完整字符串
`static String`	`getStackTrace(Throwable throwable, int limit, Map<Character,String> replaceCharToStrMap)` 堆栈转为完整字符串
`static String`	`getStackTraceOneLine(Throwable throwable)` 堆栈转为单行完整字符串
`static String`	`getStackTraceOneLine(Throwable throwable, int limit)` 堆栈转为单行完整字符串
`static List<Throwable>`	`getThrowableList(Throwable throwable)` 获取异常链上所有异常的集合,如果`Throwable` 对象没有cause,返回只有一个节点的List 如果传入null,返回空集合
`static boolean`	`isCausedBy(Throwable throwable, Class<? extends Exception>... causeClasses)` 判断是否由指定异常类引起
`static boolean`	`isFromOrSuppressedThrowable(Throwable throwable, Class<? extends Throwable> exceptionClass)` 判断指定异常是否来自或者包含指定异常
`static boolean`	`isFromOrSuppressedThrowable(Throwable throwable, Class<? extends Throwable> exceptionClass, boolean checkCause)` 判断指定异常是否来自或者包含指定异常
`static Throwable`	`unwrap(Throwable wrapped)` 剥离反射引发的InvocationTargetException、 UndeclaredThrowableException中间异常,返回业务本身的异常
`static <T extends Throwable> T`	`wrap(Throwable throwable, Class<T> wrapThrowable)` 包装一个异常
`static void`	`wrapAndThrow(Throwable throwable)` 包装异常并重新抛出此异常 `RuntimeException` 和`Error` 直接抛出,其它检查异常包装为`UndeclaredThrowableException` 后抛出
`static RuntimeException`	`wrapRuntime(Throwable throwable)` 使用运行时异常包装编译异常

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - RuntimeUtils
```
public RuntimeUtils()
```
- Method Detail
  - execForStr
```
public static String execForStr(String... cmds)
                         throws InstrumentException
```
    执行系统命令,使用系统默认编码
    
    Parameters:
    
    cmds - 命令列表,每个元素代表一条命令
    
    Returns:
    
    执行结果
    
    Throws:
    
    InstrumentException - IO异常
  - execForStr
```
public static String execForStr(Charset charset,
                                String... cmds)
                         throws InstrumentException
```
    执行系统命令,使用系统默认编码
    
    Parameters:
    
    charset - 编码
    
    cmds - 命令列表,每个元素代表一条命令
    
    Returns:
    
    执行结果
    
    Throws:
    
    InstrumentException - 内部处理异常
    
    Since:
    
    3.1.2
  - execForLines
```
public static List<String> execForLines(String... cmds)
                                 throws InstrumentException
```
    执行系统命令,使用系统默认编码
    
    Parameters:
    
    cmds - 命令列表,每个元素代表一条命令
    
    Returns:
    
    执行结果, 按行区分
    
    Throws:
    
    InstrumentException - 内部处理异常
  - execForLines
```
public static List<String> execForLines(Charset charset,
                                        String... cmds)
                                 throws InstrumentException
```
    执行系统命令,使用系统默认编码
    
    Parameters:
    
    charset - 编码
    
    cmds - 命令列表,每个元素代表一条命令
    
    Returns:
    
    执行结果, 按行区分
    
    Throws:
    
    InstrumentException - 内部处理异常
    
    Since:
    
    3.1.2
  - exec
```
public static Process exec(String... cmds)
```
    执行命令命令带参数时参数可作为其中一个参数,也可以将命令和参数组合为一个字符串传入
    
    Parameters:
    
    cmds - 命令
    
    Returns:
    
    Process
  - exec
```
public static Process exec(String[] envp,
                           String... cmds)
```
    执行命令命令带参数时参数可作为其中一个参数,也可以将命令和参数组合为一个字符串传入
    
    Parameters:
    
    envp - 环境变量参数,传入形式为key=value,null表示继承系统环境变量
    
    cmds - 命令
    
    Returns:
    
    Process
  - exec
```
public static Process exec(String[] envp,
                           File dir,
                           String... cmds)
```
    执行命令命令带参数时参数可作为其中一个参数,也可以将命令和参数组合为一个字符串传入
    
    Parameters:
    
    envp - 环境变量参数,传入形式为key=value,null表示继承系统环境变量
    
    dir - 执行命令所在目录（用于相对路径命令执行）,null表示使用当前进程执行的目录
    
    cmds - 命令
    
    Returns:
    
    Process
  - getResultLines
```
public static List<String> getResultLines(Process process)
```
    获取命令执行结果,使用系统默认编码,获取后销毁进程
    
    Parameters:
    
    process - Process 进程
    
    Returns:
    
    命令执行结果列表
  - getResultLines
```
public static List<String> getResultLines(Process process,
                                          Charset charset)
```
    获取命令执行结果,使用系统默认编码,获取后销毁进程
    
    Parameters:
    
    process - Process 进程
    
    charset - 编码
    
    Returns:
    
    命令执行结果列表
    
    Since:
    
    3.1.2
  - getResult
```
public static String getResult(Process process)
```
    获取命令执行结果,使用系统默认编码,,获取后销毁进程
    
    Parameters:
    
    process - Process 进程
    
    Returns:
    
    命令执行结果列表
    
    Since:
    
    3.1.2
  - getResult
```
public static String getResult(Process process,
                               Charset charset)
```
    获取命令执行结果,获取后销毁进程
    
    Parameters:
    
    process - Process 进程
    
    charset - 编码
    
    Returns:
    
    命令执行结果列表
    
    Since:
    
    3.1.2
  - getErrorResult
```
public static String getErrorResult(Process process)
```
    获取命令执行异常结果,使用系统默认编码,,获取后销毁进程
    
    Parameters:
    
    process - Process 进程
    
    Returns:
    
    命令执行结果列表
  - getErrorResult
```
public static String getErrorResult(Process process,
                                    Charset charset)
```
    获取命令执行异常结果,获取后销毁进程
    
    Parameters:
    
    process - Process 进程
    
    charset - 编码
    
    Returns:
    
    命令执行结果列表
  - destroy
```
public static void destroy(Process process)
```
    销毁进程
    
    Parameters:
    
    process - 进程
    
    Since:
    
    3.1.2
  - addShutdownHook
```
public static void addShutdownHook(Runnable hook)
```
    增加一个JVM关闭后的钩子,用于在JVM关闭时执行某些操作
    
    Parameters:
    
    hook - 钩子
  - getMessage
```
public static String getMessage(Throwable e)
```
    获得完整消息,包括异常名,消息格式为：{SimpleClassName}: {ThrowableMessage}
    
    Parameters:
    
    e - 异常
    
    Returns:
    
    完整消息
  - getSimpleMessage
```
public static String getSimpleMessage(Throwable e)
```
    获得消息,调用异常类的getMessage方法
    
    Parameters:
    
    e - 异常
    
    Returns:
    
    消息
  - wrapRuntime
```
public static RuntimeException wrapRuntime(Throwable throwable)
```
    使用运行时异常包装编译异常
    如果
    
    Parameters:
    
    throwable - 异常
    
    Returns:
    
    运行时异常
  - wrap
```
public static <T extends Throwable> T wrap(Throwable throwable,
                                           Class<T> wrapThrowable)
```
    包装一个异常
    
    Type Parameters:
    
    T - 对象
    
    Parameters:
    
    throwable - 异常
    
    wrapThrowable - 包装后的异常类
    
    Returns:
    
    包装后的异常
    
    Since:
    
    3.3.0
  - wrapAndThrow
```
public static void wrapAndThrow(Throwable throwable)
```
    包装异常并重新抛出此异常 RuntimeException 和Error 直接抛出,其它检查异常包装为UndeclaredThrowableException 后抛出
    
    Parameters:
    
    throwable - 异常
  - unwrap
```
public static Throwable unwrap(Throwable wrapped)
```
    剥离反射引发的InvocationTargetException、 UndeclaredThrowableException中间异常,返回业务本身的异常
    
    Parameters:
    
    wrapped - 包装的异常
    
    Returns:
    
    剥离后的异常
  - getStackElements
```
public static StackTraceElement[] getStackElements()
```
    获取当前栈信息
    
    Returns:
    
    当前栈信息
  - getStackElement
```
public static StackTraceElement getStackElement(int layers)
```
    获取指定层的堆栈信息
    
    Parameters:
    
    layers - 堆栈层级
    
    Returns:
    
    指定层的堆栈信息
  - getRootStackElement
```
public static StackTraceElement getRootStackElement()
```
    获取入口堆栈信息
    
    Returns:
    
    入口堆栈信息
  - getStackTraceOneLine
```
public static String getStackTraceOneLine(Throwable throwable)
```
    堆栈转为单行完整字符串
    
    Parameters:
    
    throwable - 异常对象
    
    Returns:
    
    堆栈转为的字符串
  - getStackTraceOneLine
```
public static String getStackTraceOneLine(Throwable throwable,
                                          int limit)
```
    堆栈转为单行完整字符串
    
    Parameters:
    
    throwable - 异常对象
    
    limit - 限制最大长度
    
    Returns:
    
    堆栈转为的字符串
  - getStackTrace
```
public static String getStackTrace(Throwable throwable)
```
    堆栈转为完整字符串
    
    Parameters:
    
    throwable - 异常对象
    
    Returns:
    
    堆栈转为的字符串
  - getStackTrace
```
public static String getStackTrace(Throwable throwable,
                                   int limit)
```
    堆栈转为完整字符串
    
    Parameters:
    
    throwable - 异常对象
    
    limit - 限制最大长度
    
    Returns:
    
    堆栈转为的字符串
  - getStackTrace
```
public static String getStackTrace(Throwable throwable,
                                   int limit,
                                   Map<Character,String> replaceCharToStrMap)
```
    堆栈转为完整字符串
    
    Parameters:
    
    throwable - 异常对象
    
    limit - 限制最大长度
    
    replaceCharToStrMap - 替换字符为指定字符串
    
    Returns:
    
    堆栈转为的字符串
  - isCausedBy
```
public static boolean isCausedBy(Throwable throwable,
                                 Class<? extends Exception>... causeClasses)
```
    判断是否由指定异常类引起
    
    Parameters:
    
    throwable - 异常
    
    causeClasses - 定义的引起异常的类
    
    Returns:
    
    是否由指定异常类引起
  - getCausedBy
```
public static Throwable getCausedBy(Throwable throwable,
                                    Class<? extends Exception>... causeClasses)
```
    获取由指定异常类引起的异常
    
    Parameters:
    
    throwable - 异常
    
    causeClasses - 定义的引起异常的类
    
    Returns:
    
    是否由指定异常类引起
  - isFromOrSuppressedThrowable
```
public static boolean isFromOrSuppressedThrowable(Throwable throwable,
                                                  Class<? extends Throwable> exceptionClass)
```
    判断指定异常是否来自或者包含指定异常
    
    Parameters:
    
    throwable - 异常
    
    exceptionClass - 定义的引起异常的类
    
    Returns:
    
    true 来自或者包含
  - isFromOrSuppressedThrowable
```
public static boolean isFromOrSuppressedThrowable(Throwable throwable,
                                                  Class<? extends Throwable> exceptionClass,
                                                  boolean checkCause)
```
    判断指定异常是否来自或者包含指定异常
    
    Parameters:
    
    throwable - 异常
    
    exceptionClass - 定义的引起异常的类
    
    checkCause - 判断cause
    
    Returns:
    
    true 来自或者包含
  - convertFromOrSuppressedThrowable
```
public static <T extends Throwable> T convertFromOrSuppressedThrowable(Throwable throwable,
                                                                       Class<T> exceptionClass)
```
    转化指定异常为来自或者包含指定异常
    
    Type Parameters:
    
    T - 异常类型
    
    Parameters:
    
    throwable - 异常
    
    exceptionClass - 定义的引起异常的类
    
    Returns:
    
    结果为null 不是来自或者包含
  - convertFromOrSuppressedThrowable
```
public static <T extends Throwable> T convertFromOrSuppressedThrowable(Throwable throwable,
                                                                       Class<T> exceptionClass,
                                                                       boolean checkCause)
```
    转化指定异常为来自或者包含指定异常
    
    Type Parameters:
    
    T - 异常类型
    
    Parameters:
    
    throwable - 异常
    
    exceptionClass - 定义的引起异常的类
    
    checkCause - 判断cause
    
    Returns:
    
    结果为null 不是来自或者包含
  - getThrowableList
```
public static List<Throwable> getThrowableList(Throwable throwable)
```
    获取异常链上所有异常的集合,如果Throwable 对象没有cause,返回只有一个节点的List 如果传入null,返回空集合
    
    Parameters:
    
    throwable - 异常对象,可以为null
    
    Returns:
    
    异常链中所有异常集合
  - getRootCause
```
public static Throwable getRootCause(Throwable throwable)
```
    获取异常链中最尾端的异常,即异常最早发生的异常对象此方法通过调用Throwable.getCause() 直到没有cause为止,如果异常本身没有cause,返回异常本身传入null返回也为null
    
    Parameters:
    
    throwable - 异常对象,可能为null
    
    Returns:
    
    最尾端异常, 传入null参数返回也为null
  - getRootCauseMessage
```
public static String getRootCauseMessage(Throwable th)
```
    获取异常链中最尾端的异常的消息, 消息格式为：{SimpleClassName}: {ThrowableMessage}
    
    Parameters:
    
    th - 异常
    
    Returns:
    
    消息

Class RuntimeUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

RuntimeUtils

Method Detail

execForStr

execForStr

execForLines

execForLines

exec

exec

exec

getResultLines

getResultLines

getResult

getResult

getErrorResult

getErrorResult

destroy

addShutdownHook

getMessage

getSimpleMessage

wrapRuntime

wrap

wrapAndThrow

unwrap

getStackElements

getStackElement

getRootStackElement

getStackTraceOneLine

getStackTraceOneLine

getStackTrace

getStackTrace

getStackTrace

isCausedBy

getCausedBy

isFromOrSuppressedThrowable

isFromOrSuppressedThrowable

convertFromOrSuppressedThrowable

convertFromOrSuppressedThrowable

getThrowableList

getRootCause

getRootCauseMessage