RuntimeUtil (hutool 5.8.36 API)

java.lang.Object
- cn.hutool.core.util.RuntimeUtil

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

Since:

3.1.1

Author:

Looly

Constructor Summary

Constructors
Constructor and Description

RuntimeUtil()

Constructors
Constructor and Description
`RuntimeUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addShutdownHook(Runnable hook)` 增加一个JVM关闭后的钩子，用于在JVM关闭时执行某些操作
`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)` 执行系统命令，使用传入的 `charset` 编码
`static List<String>`	`execForLines(String... cmds)` 执行系统命令，使用系统默认编码
`static String`	`execForStr(Charset charset, String... cmds)` 执行系统命令，使用传入的 `charset` 编码
`static String`	`execForStr(String... cmds)` 执行系统命令，使用系统默认编码
`static String`	`getErrorResult(Process process)` 获取命令执行异常结果，使用系统默认编码，获取后销毁进程
`static String`	`getErrorResult(Process process, Charset charset)` 获取命令执行异常结果，获取后销毁进程
`static long`	`getFreeMemory()` 获得JVM中剩余的内存数，单位byte
`static long`	`getMaxMemory()` 获得JVM中可以从系统中获取的最大的内存数，单位byte，以-Xmx参数为准
`static int`	`getPid()` 获取当前进程ID，首先获取进程名称，读取@前的ID值，如果不存在，则读取进程名的hash值
`static int`	`getProcessorCount()` 获得JVM可用的处理器数量（一般为CPU核心数）这里做一个特殊的处理,在特殊的CPU上面，会有获取不到CPU数量的情况，所以这里做一个保护; 默认给一个7，真实的CPU基本都是偶数，方便区分。
`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)` 获取命令执行结果，使用传入的 `charset` 编码，获取后销毁进程
`static long`	`getTotalMemory()` 获得JVM已经从系统中获取到的总共的内存数，单位byte
`static long`	`getUsableMemory()` 获得JVM最大可用内存，计算方法为：最大内存-总内存+剩余内存

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

- Constructor Detail
  - RuntimeUtil
```
public RuntimeUtil()
```
- Method Detail
  - execForStr
```
public static String execForStr(String... cmds)
                         throws IORuntimeException
```
    执行系统命令，使用系统默认编码
    
    Parameters:
    
    cmds - 命令列表，每个元素代表一条命令
    
    Returns:
    
    执行结果
    
    Throws:
    
    IORuntimeException - IO异常
  - execForStr
```
public static String execForStr(Charset charset,
                                String... cmds)
                         throws IORuntimeException
```
    执行系统命令，使用传入的 charset 编码
    
    Parameters:
    
    charset - 编码
    
    cmds - 命令列表，每个元素代表一条命令
    
    Returns:
    
    执行结果
    
    Throws:
    
    IORuntimeException - IO异常
    
    Since:
    
    3.1.2
  - execForLines
```
public static List<String> execForLines(String... cmds)
                                 throws IORuntimeException
```
    执行系统命令，使用系统默认编码
    
    Parameters:
    
    cmds - 命令列表，每个元素代表一条命令
    
    Returns:
    
    执行结果，按行区分
    
    Throws:
    
    IORuntimeException - IO异常
  - execForLines
```
public static List<String> execForLines(Charset charset,
                                        String... cmds)
                                 throws IORuntimeException
```
    执行系统命令，使用传入的 charset 编码
    
    Parameters:
    
    charset - 编码
    
    cmds - 命令列表，每个元素代表一条命令
    
    Returns:
    
    执行结果，按行区分
    
    Throws:
    
    IORuntimeException - IO异常
    
    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
    
    Since:
    
    4.1.6
  - exec
```
public static Process exec(String[] envp,
                           File dir,
                           String... cmds)
```
    执行命令
    命令带参数时参数可作为其中一个参数，也可以将命令和参数组合为一个字符串传入
    
    Parameters:
    
    envp - 环境变量参数，传入形式为key=value，null表示继承系统环境变量
    
    dir - 执行命令所在目录（用于相对路径命令执行），null表示使用当前进程执行的目录
    
    cmds - 命令
    
    Returns:
    
    Process
    
    Since:
    
    4.1.6
  - getResultLines
```
public static List<String> getResultLines(Process process)
```
    获取命令执行结果，使用系统默认编码，获取后销毁进程
    
    Parameters:
    
    process - Process 进程
    
    Returns:
    
    命令执行结果列表
  - getResultLines
```
public static List<String> getResultLines(Process process,
                                          Charset 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:
    
    命令执行结果列表
    
    Since:
    
    4.1.21
  - getErrorResult
```
public static String getErrorResult(Process process,
                                    Charset charset)
```
    获取命令执行异常结果，获取后销毁进程
    
    Parameters:
    
    process - Process 进程
    
    charset - 编码
    
    Returns:
    
    命令执行结果列表
    
    Since:
    
    4.1.21
  - destroy
```
public static void destroy(Process process)
```
    销毁进程
    
    Parameters:
    
    process - 进程
    
    Since:
    
    3.1.2
  - addShutdownHook
```
public static void addShutdownHook(Runnable hook)
```
    增加一个JVM关闭后的钩子，用于在JVM关闭时执行某些操作
    
    Parameters:
    
    hook - 钩子
    
    Since:
    
    4.0.5
  - getProcessorCount
```
public static int getProcessorCount()
```
    获得JVM可用的处理器数量（一般为CPU核心数）
    这里做一个特殊的处理,在特殊的CPU上面，会有获取不到CPU数量的情况，所以这里做一个保护; 默认给一个7，真实的CPU基本都是偶数，方便区分。如果不做处理，会出现创建线程池时ThreadPoolExecutor，抛出异常：IllegalArgumentException
    
    Returns:
    
    可用的处理器数量
    
    Since:
    
    5.3.0
  - getFreeMemory
```
public static long getFreeMemory()
```
    获得JVM中剩余的内存数，单位byte
    
    Returns:
    
    JVM中剩余的内存数，单位byte
    
    Since:
    
    5.3.0
  - getTotalMemory
```
public static long getTotalMemory()
```
    获得JVM已经从系统中获取到的总共的内存数，单位byte
    
    Returns:
    
    JVM中剩余的内存数，单位byte
    
    Since:
    
    5.3.0
  - getMaxMemory
```
public static long getMaxMemory()
```
    获得JVM中可以从系统中获取的最大的内存数，单位byte，以-Xmx参数为准
    
    Returns:
    
    JVM中剩余的内存数，单位byte
    
    Since:
    
    5.3.0
  - getUsableMemory
```
public static long getUsableMemory()
```
    获得JVM最大可用内存，计算方法为：
    最大内存-总内存+剩余内存
    
    Returns:
    
    最大可用内存
  - getPid
```
public static int getPid()
                  throws UtilException
```
    获取当前进程ID，首先获取进程名称，读取@前的ID值，如果不存在，则读取进程名的hash值
    
    Returns:
    
    进程ID
    
    Throws:
    
    UtilException - 进程名称为空
    
    Since:
    
    5.7.3

Class RuntimeUtil

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

RuntimeUtil

Method Detail

execForStr

execForStr

execForLines

execForLines

exec

exec

exec

getResultLines

getResultLines

getResult

getResult

getErrorResult

getErrorResult

destroy

addShutdownHook

getProcessorCount

getFreeMemory

getTotalMemory

getMaxMemory

getUsableMemory

getPid