public class Logger extends Object
Logger对象可能是由一对getlogger工厂方法调用了。这将创建一个新的记录或返回一个适当的现有记录。需要注意的是,其中的getLogger
工厂方法返回的记录重要的可能是垃圾随时收集如果记录器强引用是不。
日志记录将被转发到注册的处理程序对象,它可以将消息转发到各种目的地,包括控制台、文件、操作系统日志等。
每个记录器记录的“父母”是其现有的记录器,最近的祖先在记录器的命名空间。
每个记录有一个“水平”与它相关联的。这反映了一个最低水平,该记录器的关心。如果一个日志的级别设置为null,那么它的有效程度是从父母继承,从而获得它递归地从其母,等上了树。
日志级别可配置的属性的基础上从日志配置文件,如在LogManager类的描述。然而,它也可以通过对logger.setlevel方法调用的动态变化。如果一个日志的水平改变的改变也会影响孩子的伐木工人,因为已经null水平的任何孩子记录器将从它的父类继承它的有效程度。
在每个记录通话记录器最初执行要求便宜的检查(如严重或罚款)对记录仪的有效日志级别。如果请求级别低于日志级别,则立即调用日志记录调用。
通过这一初始后(便宜)的测试,对分配的日志描述测井信息。然后它会调用一个过滤器(如果存在的话)做一个更详细的检查记录是否应该公布。如果通过它将发布日志的输出处理程序。默认情况下,伐木者还发布到其父母的处理程序,递归地爬到树上。
每个记录器都可能有一个与它相关的ResourceBundle
。的ResourceBundle
可以指定名称,使用getLogger(java.lang.String, java.lang.String)
工厂方法,或通过价值使用setResourceBundle
方法。此捆绑将用于本地化日志消息。如果一个日志没有自己的ResourceBundle
或资源包名称,然后将它从父母那里继承的ResourceBundle
或资源包的名字,递上树。
大部分的日志输出方法采取“味精”的说法。此消息参数可以是原始值或定位键。格式化过程中,如果记录仪(或继承)定位ResourceBundle
如果ResourceBundle
有味精的字符串映射,然后味精字符串由本地化值代替。否则,使用原始的消息字符串。通常,程序使用java.text.messageformat样式格式化格式化参数,例如格式字符串“{ 0 } { 1 }”两个参数为字符串格式。
一套方法或者采取“msgsupplier”而不是“味精”的说法。这些方法需要一个Supplier
<String>
函数被调用的构造所需的日志消息只有当消息实际上是被记录的基础上有效的日志级别从而消除不必要的信息建设。例如,如果开发人员希望登录系统健康状态进行诊断,用字符串接受版本,代码将看起来像:
class DiagnosisMessages {
static String systemHealthStatus() {
// collect system health information
...
}
}
...
logger.log(Level.FINER, DiagnosisMessages.systemHealthStatus());
上述代码,健康状况收集不必要的甚至当日志级别更是禁用的。随着供应商接受版本如下,只有当日志级别的启用时才会收集状态。
logger.log(Level.FINER, DiagnosisMessages::systemHealthStatus);
当寻找一个ResourceBundle
,记录器将首先看是否指定了setResourceBundle
捆绑使用,然后才是资源包的名字是通过getLogger
工厂法规定。如果没有ResourceBundle
或未发现的资源束的名字,然后它会使用最近的ResourceBundle
或从其母tree.
遗传资源束的名字时,一个ResourceBundle
继承或通过setResourceBundle
方法指定,那么将使用ResourceBundle
。否则如果记录器只有或遗传资源束的名字,那么资源束的名字将被映射到一个ResourceBundle
对象,在记录时使用默认的区域设置。
when映射资源束的名字ResourceBundle
对象,记录器将首先尝试使用线程的context class loader映射给定的资源包名称到ResourceBundle
。如果线程上下文类加载器是null
,它将尝试system class loader相反。如果ResourceBundle
还是没有找到,它会使用的getLogger
工厂方法第一个调用类加载器。
格式(包括定位)是输出处理的责任,这将调用一个格式化程序。
请注意,格式不需要同步发生。它可能会推迟到一个日志其实是写给一个外部接收器。
测井方法分为五大类:
有一组“日志”方法,该方法需要一个日志级别、一个消息字符串和可选的一些参数到消息字符串中。
有一套“水”的方法(“日志精确”),如“日志”的方法,但还需要一个明确的源类名称和方法名称。
有一套“logrb”法(“日志资源束”),就像是“水”的方法,但还需要一个明确的资源对象用于本地化的日志信息。
有方便的方法来跟踪方法条目(“输入”方法),方法返回(“退出”方法)和抛出异常(“投掷”方法)。
最后,在一个非常简单的情况下,有一组方便的方法,当一个开发人员只想在一个给定的日志级别上登录一个简单的字符串。这些方法是以标准级名称(“严重”、“警告”、“信息”等)命名的,并采取一个单一的参数,一个消息字符串。
对于不需要显式源名称和方法名称的方法,日志记录框架将作出“尽力而为”,以确定哪些类和方法调用了日志记录方法。然而,重要的是要认识到,这个自动推断的信息可能只是近似(或可能甚至是完全错误的!)。虚拟机可以做广泛的优化时,JITing可能完全删除堆栈帧,使它不能可靠地定位调用的类和方法。
在记录所有的方法都是线程安全的。
子类化信息:注意LogManager类可提供指定命名空间中的任何一点记录自己的实施。因此,任何子记录器(除非他们是在一个新的班级一起实施LogManager)应该从LogManager类获取logger实例应委托操作如“isLoggable”和“日志(日志)”,例如。注意,为了拦截所有的日志输出,子类只需要重写日志(日志)的方法。所有其他的测井方法是调用这个日志(日志)的实现方法。
Modifier and Type | Field and Description |
---|---|
static Logger |
global
过时的。
本字段初始化是容易出现死锁。现场必须由Logger类的初始化可能引起死锁LogManager类初始化初始化。在这种情况下,两类初始化等待对方完成。为了得到全局日志对象的首选方式是通过电话
Logger.getGlobal() 。与老版本的JDK,Logger.getGlobal() 不可使用电话Logger.getLogger(Logger.GLOBAL_LOGGER_NAME) 或Logger.getLogger("global") 兼容性。
|
static String |
GLOBAL_LOGGER_NAME
global_logger_name是全球记录名字。
|
Modifier | Constructor and Description |
---|---|
protected |
Logger(String name, String resourceBundleName)
受保护的方法构造一个命名系统记录器。
|
Modifier and Type | Method and Description |
---|---|
void |
addHandler(Handler handler)
添加日志汉德勒接收日志消息。
|
void |
config(String msg)
登录配置消息。
|
void |
config(Supplier<String> msgSupplier)
记录一个配置消息,如果日志记录级别是这样的,则该消息将被记录下来。
|
void |
entering(String sourceClass, String sourceMethod)
记录方法条目。
|
void |
entering(String sourceClass, String sourceMethod, Object param1)
记录一个方法条目,用一个参数。
|
void |
entering(String sourceClass, String sourceMethod, Object[] params)
记录一个方法项,用一个参数数组。
|
void |
exiting(String sourceClass, String sourceMethod)
记录方法返回。
|
void |
exiting(String sourceClass, String sourceMethod, Object result)
日志一个方法返回,结果对象。
|
void |
fine(String msg)
记录一个好消息。
|
void |
fine(Supplier<String> msgSupplier)
记录一个好消息,如果日志级别是这样的话,该消息将被记录下来。
|
void |
finer(String msg)
日志一个更细的消息。
|
void |
finer(Supplier<String> msgSupplier)
日志一个更细的消息,这是只有被构造,如果日志记录级别是这样的消息将实际上被记录。
|
void |
finest(String msg)
记录最好的消息。
|
void |
finest(Supplier<String> msgSupplier)
如果日志记录级别是这样的消息将被记录的话,将被构造为最好的消息,这是唯一的构造。
|
static Logger |
getAnonymousLogger()
创建一个匿名记录器。
|
static Logger |
getAnonymousLogger(String resourceBundleName)
创建一个匿名记录器。
|
Filter |
getFilter()
获取当前的这个日志过滤器。
|
static Logger |
getGlobal()
返回的名称logger.global_logger_name全球Logger对象。
|
Handler[] |
getHandlers()
得到这个记录器的相关处理程序。
|
Level |
getLevel()
把日志级别被指定这个记录器。
|
static Logger |
getLogger(String name)
找到或创建一个命名系统记录器。
|
static Logger |
getLogger(String name, String resourceBundleName)
找到或创建一个命名系统记录器。
|
String |
getName()
该记录器的名称。
|
Logger |
getParent()
返回该记录的父。
|
ResourceBundle |
getResourceBundle()
检索该记录器的本地化资源束。
|
String |
getResourceBundleName()
检索该记录器的本地化资源束的名字。
|
boolean |
getUseParentHandlers()
是否这个记录器发送其输出其母记录器。
|
void |
info(String msg)
登录信息消息。
|
void |
info(Supplier<String> msgSupplier)
记录一个信息消息,如果日志记录级别是这样的,则该消息将被记录下来。
|
boolean |
isLoggable(Level level)
检查一个给定的水平的消息实际上是这个记录器记录。
|
void |
log(Level level, String msg)
记录一个消息,没有参数。
|
void |
log(Level level, String msg, Object param1)
登录消息,用一个对象参数。
|
void |
log(Level level, String msg, Object[] params)
用一个对象参数数组记录一个消息。
|
void |
log(Level level, String msg, Throwable thrown)
日志信息,与相关的错误信息。
|
void |
log(Level level, Supplier<String> msgSupplier)
记录一个消息,如果日志记录级别是这样的,则该消息将被记录下来。
|
void |
log(Level level, Throwable thrown, Supplier<String> msgSupplier)
日志一懒洋洋地构造的消息相关的错误信息。
|
void |
log(LogRecord record)
日志日志。
|
void |
logp(Level level, String sourceClass, String sourceMethod, String msg)
记录一个消息,指定源类和方法,没有参数。
|
void |
logp(Level level, String sourceClass, String sourceMethod, String msg, Object param1)
记录一个消息,指定源类和方法,用一个单一的对象参数到日志消息中。
|
void |
logp(Level level, String sourceClass, String sourceMethod, String msg, Object[] params)
记录一个消息,指定源类和方法,用一个对象参数数组。
|
void |
logp(Level level, String sourceClass, String sourceMethod, String msg, Throwable thrown)
记录消息,并指定源的类和方法,与相关的错误信息。
|
void |
logp(Level level, String sourceClass, String sourceMethod, Supplier<String> msgSupplier)
懒洋洋地构建日志消息,指定源的类和方法,不带参数。
|
void |
logp(Level level, String sourceClass, String sourceMethod, Throwable thrown, Supplier<String> msgSupplier)
懒洋洋地构建日志消息,指定源的类和方法,与相关的错误信息。
|
void |
logrb(Level level, String sourceClass, String sourceMethod, ResourceBundle bundle, String msg, Object... params)
记录一个消息,指定源类、方法和资源包,用一个可选的消息参数列表。
|
void |
logrb(Level level, String sourceClass, String sourceMethod, ResourceBundle bundle, String msg, Throwable thrown)
记录消息,并指定源类、方法和资源束,与相关的错误信息。
|
void |
logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg)
|
void |
logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object param1)
|
void |
logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object[] params)
|
void |
logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Throwable thrown)
|
void |
removeHandler(Handler handler)
删除日志汉德勒。
|
void |
setFilter(Filter newFilter)
设置一个过滤器来控制这个记录器输出。
|
void |
setLevel(Level newLevel)
设置日志级别指定消息级别将由这个记录器记录。
|
void |
setParent(Logger parent)
该记录仪设置父。
|
void |
setResourceBundle(ResourceBundle bundle)
设置这个记录仪资源束。
|
void |
setUseParentHandlers(boolean useParentHandlers)
指定是否应该记录其输出发送到其母记录器。
|
void |
severe(String msg)
记录一个严重的消息。
|
void |
severe(Supplier<String> msgSupplier)
记录一个严重的消息,如果日志记录级别是这样的,则该消息将被记录下来。
|
void |
throwing(String sourceClass, String sourceMethod, Throwable thrown)
日志抛出异常。
|
void |
warning(String msg)
记录警告消息。
|
void |
warning(Supplier<String> msgSupplier)
记录一个警告消息,如果日志级别是这样的,则该消息将被记录下来。
|
public static final String GLOBAL_LOGGER_NAME
@Deprecated public static final Logger global
Logger.getGlobal()
。与老版本的JDK,Logger.getGlobal()
不可使用电话Logger.getLogger(Logger.GLOBAL_LOGGER_NAME)
或Logger.getLogger("global")
兼容性。
protected Logger(String name, String resourceBundleName)
记录器将初步配置了一个空的水平与useparenthandlers设置为true。
name
-日志名称。这应该是一个圆点分隔的名称,通常应基于包的名称或子类的名称,例如java.net或javax.swing。它可能是空的匿名记录器。
resourceBundleName
名称可以用来定位该记录器的信息。可能是无效的,如果没有一个消息需要本地化。
MissingResourceException
-如果resourcebundlename是非空的,没有相应的资源可以发现。
public static final Logger getGlobal()
public static Logger getLogger(String name)
如果一个新的记录所创建的日志级别将配置基于LogManager配置并将配置为发送日志输出,其母的处理程序。这将是LogManager全局命名空间注册。
注:LogManager只能保留到新创建的记录一个弱引用。这是明白先前创建的记录仪和给定的名称可以被收集在任何时候如果没有强有力的参考日志垃圾重要。特别是,这意味着两个背靠背的要求一样,getLogger("MyLogger").log(...)
可能使用不同的日志对象命名为“mylogger”如果没有强有力的参考日志命名为“mylogger”在程序的其他地方。
name
-日志名称。这应该是一个圆点分隔的名称,通常应基于包的名称或子类的名称,例如java.net或javax.swing
NullPointerException
-如果名称是空的。
public static Logger getLogger(String name, String resourceBundleName)
如果一个新的记录所创建的日志级别将配置基于LogManager将配置为发送日志输出,其母的处理程序。这将是LogManager全局命名空间注册。
注:LogManager只能保留到新创建的记录一个弱引用。这是明白先前创建的记录仪和给定的名称可以被收集在任何时候如果没有强有力的参考日志垃圾重要。特别是,这意味着两个背靠背的要求一样,getLogger("MyLogger", ...).log(...)
可能使用不同的日志对象命名为“mylogger”如果没有强有力的参考日志命名为“mylogger”在程序的其他地方。
如果指定的记录已经存在,还不那么有本地化资源束给定的资源包名称的使用。如果指定的记录已经存在,并且有不同的资源束的名字然后IllegalArgumentException是抛出。
name
-日志名称。这应该是一个圆点分隔的名称,通常应基于包的名称或子类的名称,例如java.net或javax.swing
resourceBundleName
名称可以用来定位该记录器的信息。如果可以
null
的邮件都需要定位。
MissingResourceException
-如果resourcebundlename是非空的,没有相应的资源可以发现。
IllegalArgumentException
-如果记录器已经存在和使用不同的资源包名称;或者如果
resourceBundleName
是
null
而命名的记录器有资源束集。
NullPointerException
-如果名称是空的。
public static Logger getAnonymousLogger()
这个工厂方法主要用于从应用程序。由于这个记录是匿名可以通过创建类保密。这就消除了正常的安全检查的需要,从而允许不受信任的程序代码更新日志的控制状态。例如,一个程序可以做setlevel或匿名Logger的AddHandler。
尽管新的记录仪是匿名的,它配置有根记录器(“”)为其母。这意味着它默认继承了其有效程度和处理从根记录器。通过setParent
方法改变其母仍需要用这种方法指定的安全权限。
public static Logger getAnonymousLogger(String resourceBundleName)
这个工厂方法主要用于从应用程序。由于这个记录是匿名可以通过创建类保密。这就消除了正常的安全检查的需要,从而允许不受信任的程序代码更新日志的控制状态。例如,一个程序可以做setlevel或匿名Logger的AddHandler。
尽管新的记录仪是匿名的,它配置有根记录器(“”)为其母。这意味着它默认继承了其有效程度和处理从根记录器。通过setParent
方法改变其母仍需要用这种方法指定的安全权限。
resourceBundleName
名称可以用来定位该记录器的信息。可能是无效的,如果没有一个消息需要本地化。
MissingResourceException
-如果resourcebundlename是非空的,没有相应的资源可以发现。
public ResourceBundle getResourceBundle()
ResourceBundle
是由
setResourceBundle
方法或
mapped from the the resource bundle name通过设置为当前默认设置
getLogger
工厂方法。
null
,然后对使用资源包或者资源束的名字从父母继承。
null
)
public String getResourceBundleName()
getLogger
工厂方法指定,或通过设置
setResourceBundle
法概念的
base name。
null
,然后对使用资源包或者资源束的名字从父母继承。
null
)
public void setFilter(Filter newFilter) throws SecurityException
经过初步的“水平”检查后,记录器将调用此过滤器检查日志记录是否应该公布。
newFilter
-过滤器对象(可能为空)
SecurityException
-如果存在一个安全管理,这个记录是不是匿名的,和对方没有loggingpermission(“控制”)。
public Filter getFilter()
public void log(LogRecord record)
在这个类中的所有其他的日志记录方法都通过这种方法来执行任何日志记录。子类可以重写这个单一的方法来捕获所有日志活动。
record
-日志将发表
public void log(Level level, String msg)
如果记录器是目前给出的消息然后给定的消息转发给所有注册的输出处理程序对象启用。
level
-一个消息标识符,例如,严重
msg
的字符串消息(或在信息目录的关键)
public void log(Level level, Supplier<String> msgSupplier)
如果记录器是目前给出的消息,消息是通过调用提供供应商的功能和转发给所有注册的输出处理程序对象启用。
level
-一个消息标识符,例如,严重
msgSupplier
-一个功能,它被调用时,产生所需的日志信息
public void log(Level level, String msg, Object param1)
如果记录器是目前给出的消息则相应的日志创建并转发给所有注册的输出处理程序对象启用。
level
-一个消息标识符,例如,严重
msg
的字符串消息(或在信息目录的关键)
param1
-参数信息
public void log(Level level, String msg, Object[] params)
如果记录器是目前给出的消息则相应的日志创建并转发给所有注册的输出处理程序对象启用。
level
-一个消息标识符,例如,严重
msg
的字符串消息(或在信息目录的关键)
params
-消息参数数组
public void log(Level level, String msg, Throwable thrown)
如果记录器是目前给出的消息然后给定的参数存储在LogRecord,转发给所有注册的输出处理功能。
请注意,抛出的说法是存储在日志丢的财产,而不是日志参数属性。因此,它是由经过特殊处理的输出格式化不被视为一个格式参数的日志消息属性。
level
-一个消息标识符,例如,严重
msg
的字符串消息(或在信息目录的关键)
thrown
- Throwable日志消息相关。
public void log(Level level, Throwable thrown, Supplier<String> msgSupplier)
如果记录器是目前给出的消息,消息是通过调用函数构建提供供应商启用。消息和给定的Throwable
然后存储在一个LogRecord
是转发给所有注册的输出处理。
请注意,抛出的说法是存储在日志丢的财产,而不是日志参数属性。因此,它是由经过特殊处理的输出格式化不被视为一个格式参数的日志消息属性。
level
-一个消息标识符,例如,严重
thrown
- Throwable日志消息相关。
msgSupplier
-一个功能,它被调用时,产生所需的日志信息
public void logp(Level level, String sourceClass, String sourceMethod, String msg)
如果记录器是目前给出的消息然后给定的消息转发给所有注册的输出处理程序对象启用。
level
-一个消息标识符,例如,严重
sourceClass
-发出登录请求的类名称
sourceMethod
-发出登录请求的方法名
msg
的字符串消息(或在信息目录的关键)
public void logp(Level level, String sourceClass, String sourceMethod, Supplier<String> msgSupplier)
如果记录器是目前给出的消息,消息是通过调用提供供应商的功能和转发给所有注册的输出处理程序对象启用。
level
-一个消息标识符,例如,严重
sourceClass
-发出登录请求的类名称
sourceMethod
-发出登录请求的方法名
msgSupplier
-一个功能,它被调用时,产生所需的日志信息
public void logp(Level level, String sourceClass, String sourceMethod, String msg, Object param1)
如果记录器是目前给出的消息则相应的日志创建并转发给所有注册的输出处理程序对象启用。
level
-一个消息标识符,例如,严重
sourceClass
-发出登录请求的类名称
sourceMethod
-发出登录请求的方法名
msg
的字符串消息(或在信息目录的关键)
param1
参数的日志信息。
public void logp(Level level, String sourceClass, String sourceMethod, String msg, Object[] params)
如果记录器是目前给出的消息则相应的日志创建并转发给所有注册的输出处理程序对象启用。
level
-一个消息标识符,例如,严重
sourceClass
-发出登录请求的类名称
sourceMethod
-发出登录请求的方法名
msg
的字符串消息(或在信息目录的关键)
params
-消息参数数组
public void logp(Level level, String sourceClass, String sourceMethod, String msg, Throwable thrown)
如果记录器是目前给出的消息然后给定的参数存储在LogRecord,转发给所有注册的输出处理功能。
请注意,抛出的说法是存储在日志丢的财产,而不是日志参数属性。因此,它是由经过特殊处理的输出格式化不被视为一个格式参数的日志消息属性。
level
-一个消息标识符,例如,严重
sourceClass
-发出登录请求的类名称
sourceMethod
-发出登录请求的方法名
msg
的字符串消息(或在信息目录的关键)
thrown
- Throwable日志消息相关。
public void logp(Level level, String sourceClass, String sourceMethod, Throwable thrown, Supplier<String> msgSupplier)
如果记录器是目前给出的消息,消息是通过调用函数构建提供供应商启用。消息和给定的Throwable
然后存储在一个LogRecord
是转发给所有注册的输出处理。
请注意,抛出的说法是存储在日志丢的财产,而不是日志参数属性。因此,它是由经过特殊处理的输出格式化不被视为一个格式参数的日志消息属性。
level
-一个消息标识符,例如,严重
sourceClass
-发出登录请求的类名称
sourceMethod
-发出登录请求的方法名
thrown
- Throwable日志消息相关。
msgSupplier
-一个功能,它被调用时,产生所需的日志信息
@Deprecated public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg)
如果记录器是目前给出的消息然后给定的消息转发给所有注册的输出处理程序对象启用。
使用所命名的资源束本地化消息字符串。如果资源包名称为空,或空字符串或无效,则消息字符串不本地化。
level
-一个消息标识符,例如,严重
sourceClass
-发出登录请求的类名称
sourceMethod
-发出登录请求的方法名
bundleName
名称资源束定位味精,可以为空
msg
的字符串消息(或在信息目录的关键)
@Deprecated public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object param1)
如果记录器是目前给出的消息则相应的日志创建并转发给所有注册的输出处理程序对象启用。
使用所命名的资源束本地化消息字符串。如果资源包名称为空,或空字符串或无效,则消息字符串不本地化。
level
-一个消息标识符,例如,严重
sourceClass
-发出登录请求的类名称
sourceMethod
-发出登录请求的方法名
bundleName
名称资源束定位味精,可以为空
msg
的字符串消息(或在信息目录的关键)
param1
参数的日志信息。
@Deprecated public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object[] params)
如果记录器是目前给出的消息则相应的日志创建并转发给所有注册的输出处理程序对象启用。
使用所命名的资源束本地化消息字符串。如果资源包名称为空,或空字符串或无效,则消息字符串不本地化。
level
-一个消息标识符,例如,严重
sourceClass
-发出登录请求的类名称
sourceMethod
-发出登录请求的方法名
bundleName
名称资源束定位味精,可以为空。
msg
的字符串消息(或在信息目录的关键)
params
-消息参数数组
public void logrb(Level level, String sourceClass, String sourceMethod, ResourceBundle bundle, String msg, Object... params)
如果记录器是目前给出的消息则相应的日志创建并转发给所有注册的输出处理程序对象启用。
msg
字符串的本地化使用给定的资源包。如果资源束null
,然后msg
字符串不局限。
level
-一个消息标识符,例如,严重
sourceClass
-发出登录请求的类的名称
sourceMethod
-发出登录请求的方法的名称
bundle
资源束定位
msg
,可以
null
。
msg
的字符串消息(或在信息目录的关键)
params
-参数信息(可选,可没有)。
@Deprecated public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Throwable thrown)
如果记录器是目前给出的消息然后给定的参数存储在LogRecord,转发给所有注册的输出处理功能。
使用所命名的资源束本地化消息字符串。如果资源包名称为空,或空字符串或无效,则消息字符串不本地化。
请注意,抛出的说法是存储在日志丢的财产,而不是日志参数属性。因此,它是由经过特殊处理的输出格式化不被视为一个格式参数的日志消息属性。
level
-一个消息标识符,例如,严重
sourceClass
-发出登录请求的类名称
sourceMethod
-发出登录请求的方法名
bundleName
名称资源束定位味精,可以为空
msg
的字符串消息(或在信息目录的关键)
thrown
- Throwable日志消息相关。
public void logrb(Level level, String sourceClass, String sourceMethod, ResourceBundle bundle, String msg, Throwable thrown)
如果记录器是目前给出的消息然后给定的参数存储在LogRecord,转发给所有注册的输出处理功能。
msg
字符串的本地化使用给定的资源包。如果资源束null
,然后msg
字符串不局限。
请注意,抛出的说法是存储在日志丢的财产,而不是日志参数属性。因此,它是由经过特殊处理的输出格式化不被视为一个格式参数的日志消息属性。
level
-一个消息标识符,例如,严重
sourceClass
-发出登录请求的类的名称
sourceMethod
-发出登录请求的方法的名称
bundle
资源束定位
msg
,可以
null
msg
的字符串消息(或在信息目录的关键)
thrown
- Throwable的日志消息相关。
public void entering(String sourceClass, String sourceMethod)
这是一个方便的方法,可以用来登录到一个方法。一个信息“进入”的日志,日志级别细化,和给定的方法和sourceclass登录。
sourceClass
-发出登录请求的类名称
sourceMethod
名字的方法是进入
public void entering(String sourceClass, String sourceMethod, Object param1)
这是一个方便的方法,可以用来登录到一个方法。一个日志消息”进入{ 0 }”,日志级别细化,和给定的方法,sourceclass,和参数记录。
sourceClass
-发出登录请求的类名称
sourceMethod
名字的方法是进入
param1
参数被输入的方法
public void entering(String sourceClass, String sourceMethod, Object[] params)
这是一个方便的方法,可以用来登录到一个方法。一个日志消息“进入”(后跟一个格式{N}指标参数数组中的每个条目),日志级别细化,和给定的方法,sourceclass,和参数记录。
sourceClass
-发出登录请求的类名称
sourceMethod
名字的方法是进入
params
-进入该方法的参数数组
public void exiting(String sourceClass, String sourceMethod)
这是一个方便的方法,可以用来从一个方法返回日志。一个消息“回归”的日志,日志级别细化,和给定的方法和sourceclass登录。
sourceClass
-发出登录请求的类名称
sourceMethod
-名字的方法
public void exiting(String sourceClass, String sourceMethod, Object result)
这是一个方便的方法,可以用来从一个方法返回日志。一个日志消息”返回{ 0 }”,日志级别细化,并给出了方法,sourceclass,和结果记录。
sourceClass
-发出登录请求的类名称
sourceMethod
-名字的方法
result
对象被返回
public void throwing(String sourceClass, String sourceMethod, Throwable thrown)
这是一个方便的方法来记录一个方法是通过抛出一个异常终止的。日志记录是使用更精细的级别完成的。
如果记录器是目前给出的消息然后给定的参数存储在LogRecord,转发给所有注册的输出处理功能。该日志的信息设置为“扔”。
请注意,抛出的说法是存储在日志丢的财产,而不是日志参数属性。因此,它是由经过特殊处理的输出格式化不被视为一个格式参数的日志消息属性。
sourceClass
-发出登录请求的类名称
sourceMethod
-名字的方法。
thrown
-错误被抛出。
public void severe(String msg)
如果记录器是目前严峻的消息然后给定的消息转发给所有注册的输出处理程序对象启用。
msg
的字符串消息(或在信息目录的关键)
public void warning(String msg)
如果记录器是目前短信预警水平然后给定的消息转发给所有注册的输出处理程序对象启用。
msg
的字符串消息(或在信息目录的关键)
public void info(String msg)
如果记录器是目前的信息水平,然后给定的消息转发给所有注册的输出处理程序对象启用。
msg
的字符串消息(或在信息目录的关键)
public void config(String msg)
如果记录器是目前配置消息然后给定的消息转发给所有注册的输出处理程序对象启用。
msg
的字符串消息(或在信息目录的关键)
public void fine(String msg)
如果记录器是目前的好消息级然后给定的消息转发给所有注册的输出处理程序对象启用。
msg
的字符串消息(或在信息目录的关键)
public void finer(String msg)
如果记录器是目前更好的消息然后给定的消息转发给所有注册的输出处理程序对象启用。
msg
的字符串消息(或在信息目录的关键)
public void finest(String msg)
如果记录器是目前最好的消息然后给定的消息转发给所有注册的输出处理程序对象启用。
msg
的字符串消息(或在信息目录的关键)
public void severe(Supplier<String> msgSupplier)
如果记录器是目前严峻的消息级别的消息就由调用提供供应商的功能和转发给所有注册的输出处理程序对象启用。
msgSupplier
-一个功能,它被调用时,产生所需的日志信息
public void warning(Supplier<String> msgSupplier)
如果记录器是目前短信预警水平那么消息是由调用函数提供供应商和转发给所有注册的输出处理程序对象启用。
msgSupplier
-一个功能,它被调用时,产生所需的日志信息
public void info(Supplier<String> msgSupplier)
如果记录器是目前的信息水平,那么消息是通过调用提供供应商的功能和转发给所有注册的输出处理程序对象启用。
msgSupplier
-一个功能,它被调用时,产生所需的日志信息
public void config(Supplier<String> msgSupplier)
如果记录器是目前配置消息级别的消息就是通过调用提供供应商的功能和转发给所有注册的输出处理程序对象启用。
msgSupplier
-一个功能,它被调用时,产生所需的日志信息
public void fine(Supplier<String> msgSupplier)
如果记录器是目前的好消息,消息是通过调用提供供应商的功能和转发给所有注册的输出处理程序对象启用。
msgSupplier
-一个功能,它被调用时,产生所需的日志信息
public void finer(Supplier<String> msgSupplier)
如果记录器是目前更好的消息,消息是通过调用提供供应商的功能和转发给所有注册的输出处理程序对象启用。
msgSupplier
-一个功能,它被调用时,产生所需的日志信息
public void finest(Supplier<String> msgSupplier)
如果记录器是目前最好的消息,消息是通过调用提供供应商的功能和转发给所有注册的输出处理程序对象启用。
msgSupplier
-一个功能,它被调用时,产生所需的日志信息
public void setLevel(Level newLevel) throws SecurityException
如果新的级别为空,则意味着这个节点应该从它的最近的祖先继承它的级别,它具有一个特定的(非空)级值。
newLevel
-日志级别的新值(可能为空)
SecurityException
-如果存在一个安全管理,这个记录是不是匿名的,和对方没有loggingpermission(“控制”)。
public Level getLevel()
public boolean isLoggable(Level level)
level
-消息日志记录级别
public String getName()
public void addHandler(Handler handler) throws SecurityException
默认情况下,伐木者还把结果输出到父记录器。通常根记录器配置一套处理程序,主要是作为所有记录器默认处理程序。
handler
-日志处理程序
SecurityException
-如果存在一个安全管理,这个记录是不是匿名的,和对方没有loggingpermission(“控制”)。
public void removeHandler(Handler handler) throws SecurityException
如果给定的汉德勒没有找到或是空的话,则返回
handler
-日志处理程序
SecurityException
-如果存在一个安全管理,这个记录是不是匿名的,和对方没有loggingpermission(“控制”)。
public Handler[] getHandlers()
public void setUseParentHandlers(boolean useParentHandlers)
useParentHandlers
-如果输出将被送到记录器的母。
SecurityException
-如果存在一个安全管理,这个记录是不是匿名的,和对方没有loggingpermission(“控制”)。
public boolean getUseParentHandlers()
public void setResourceBundle(ResourceBundle bundle)
bundle
-资源包,这个记录应使用。
NullPointerException
如果给定束
null
。
IllegalArgumentException
如果给定束没有
base name,或者如果该记录器已经资源束集而给定束具有不同的基名称。
SecurityException
-如果存在一个安全管理,这个记录是不是匿名的,和对方没有loggingpermission(“控制”)。
public Logger getParent()
此方法返回命名空间中的最近的现存父。因此,如果一个记录被称为“ABCD”,和一个记录称为“A.B”已经建立,但不“ABC”的存在,然后调用getParent在记录器“ABCD”将返回的记录“A.B”。
结果将是null,如果是呼吁在命名空间根记录器。
public void setParent(Logger parent)
它不应该被调用从应用程序代码。
parent
-新的父记录器
SecurityException
-如果存在一个安全管理,如果对方没有loggingpermission(“控制”)。
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.