net.ymate.platform.commons.util

Class RuntimeUtils

java.lang.Object

net.ymate.platform.commons.util.RuntimeUtils

public class RuntimeUtils
extends Object

运行时工具类，获取运行时相关信息

Author:

刘镇 (suninformation@163.com) on 2010-8-2 上午10:10:16

Field Summary

Fields

Modifier and Type	Field and Description
static String	ROOT
static String	USER_DIR
static String	USER_HOME
static String	VAR_ROOT
static String	VAR_USER_DIR
static String	VAR_USER_HOME

Constructor Summary

Constructors

Constructor and Description
RuntimeUtils()

Method Summary

Modifier and Type	Method and Description
static long	gc() 垃圾回收，返回回收的字节数
static String	getProcessId()
static String	getRootPath()
static String	getRootPath(boolean safe)
static String	getSystemEnv(String envName) Deprecated.
static Map<String,String>	getSystemEnvs() Deprecated.
static boolean	isUnixOrLinux()
static boolean	isWindows()
static RuntimeException	makeRuntimeThrow(String format, Object... args) 根据格式化字符串，生成运行时异常
static boolean	registerManagedBean(ObjectName objectName, Object managedBean) 注册JMXBean
static boolean	registerManagedBean(String objectName, Object managedBean) 注册JMXBean
static String	replaceEnvVariable(String origin)
static void	unregisterManagedBean(ObjectName objectName) 解注册JMXBean
static void	unregisterManagedBean(String objectName) 解注册JMXBean
static Throwable	unwrapThrow(Throwable e)
static RuntimeException	wrapRuntimeThrow(Throwable e) 用运行时异常包裹抛出对象，如果抛出对象本身就是运行时异常，则直接返回
static RuntimeException	wrapRuntimeThrow(Throwable e, String fmt, Object... args) 将抛出对象包裹成运行时异常，并增加描述

Methods inherited from class java.lang.Object

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

Field Detail

ROOT

public static final String ROOT

See Also:

Constant Field Values

USER_HOME

public static final String USER_HOME

See Also:

Constant Field Values

USER_DIR

public static final String USER_DIR

See Also:

Constant Field Values

VAR_ROOT

public static final String VAR_ROOT

See Also:

Constant Field Values

VAR_USER_HOME

public static final String VAR_USER_HOME

See Also:

Constant Field Values

VAR_USER_DIR

public static final String VAR_USER_DIR

See Also:

Constant Field Values

Constructor Detail

RuntimeUtils

public RuntimeUtils()

Method Detail

getSystemEnvs

@Deprecated
public static Map<String,String> getSystemEnvs()

Deprecated.

获取系统运行时，可以进行缓存

Returns:

环境变量对应表

See Also:

System.getenv()

getSystemEnv

@Deprecated
public static String getSystemEnv(String envName)

Deprecated.

获取指定名称的环境值

Parameters:

envName - 环境名，如果为空，返回null

Returns:

当指定名称为空或者对应名称环境变量不存在时返回空

See Also:

System.getenv(String)

isUnixOrLinux

public static boolean isUnixOrLinux()

Returns:

当前操作系统是否为类Unix系统

isWindows

public static boolean isWindows()

Returns:

当前操作系统是否为Windows系统

getProcessId

public static String getProcessId()

Returns:

返回当前程序执行进程编号

getRootPath

public static String getRootPath()

Returns:

获取应用根路径（若WEB工程则基于.../WEB-INF返回，若普通工程则返回类所在路径）

getRootPath

public static String getRootPath(boolean safe)

Parameters:

safe - 若WEB工程是否保留WEB-INF

Returns:

返回应用根路径

Since:

2.1.0 若获取的路径为空则默认使用user.dir路径(结尾的斜杠字符将被移除)

replaceEnvVariable

public static String replaceEnvVariable(String origin)

Parameters:

origin - 原始字符串

Returns:

替换${root}、${user.dir}和${user.home}环境变量

Since:

2.1.0 调整当获取应用根路径为空则默认使用user.dir路径

registerManagedBean

public static boolean registerManagedBean(ObjectName objectName,
                                          Object managedBean)

注册JMXBean

Parameters:

objectName - 对象名称

managedBean - JMXBean实例

Returns:

返回true表示注册成功, 若注册失败或重复注册则返回false

Since:

2.1.0

registerManagedBean

public static boolean registerManagedBean(String objectName,
                                          Object managedBean)
                                   throws MalformedObjectNameException

注册JMXBean

Parameters:

objectName - 对象名称字符串

managedBean - JMXBean实例

Returns:

返回true表示注册成功, 若注册失败或重复注册则返回false

Throws:

MalformedObjectNameException - ObjectName格式无效异常

Since:

2.1.0

unregisterManagedBean

public static void unregisterManagedBean(ObjectName objectName)

解注册JMXBean

Parameters:

objectName - 对象名称

Since:

2.1.0

unregisterManagedBean

public static void unregisterManagedBean(String objectName)
                                  throws MalformedObjectNameException

解注册JMXBean

Parameters:

objectName - 对象名称字符串

Throws:

MalformedObjectNameException - ObjectName格式无效异常

Since:

2.1.0

makeRuntimeThrow

public static RuntimeException makeRuntimeThrow(String format,
                                                Object... args)

根据格式化字符串，生成运行时异常

Parameters:

format - 格式

args - 参数

Returns:

运行时异常

wrapRuntimeThrow

public static RuntimeException wrapRuntimeThrow(Throwable e,
                                                String fmt,
                                                Object... args)

将抛出对象包裹成运行时异常，并增加描述

Parameters:

e - 抛出对象

fmt - 格式

args - 参数

Returns:

运行时异常

wrapRuntimeThrow

public static RuntimeException wrapRuntimeThrow(Throwable e)

用运行时异常包裹抛出对象，如果抛出对象本身就是运行时异常，则直接返回

若 e 对象是 InvocationTargetException，则将其剥离，仅包裹其 TargetException 对象

Parameters:

e - 抛出对象

Returns:

运行时异常

unwrapThrow

public static Throwable unwrapThrow(Throwable e)

gc

public static long gc()

垃圾回收，返回回收的字节数

Returns:

回收的字节数，如果为负数则表示当前内存使用情况很差，基本属于没有内存可用了