com.sap.tc.logging
Class Location

java.lang.Object
  |
  +--com.sap.tc.logging.ExceptionHandling
        |
        +--com.sap.tc.logging.LogController
              |
              +--com.sap.tc.logging.Location

All Implemented Interfaces:

IObjectInfo

public class Location

extends LogController

Describes messages that originate from delimited source code areas and is above all used to emit trace messages. Typical source code areas are components, packages, classes and methods. Messages related to source code areas are classical trace messages, so if you are above all interested in writing traces, please read this introduction thoroughly.

The class Location is a subclass of LogController, so you can, with the corresponding calls, emit trace messages and have the output of those messages to attachable logs controlled via the severities of the locations and optional filters assigned to them. We recommend to use the constants provided in the class Severity to specify message severities.

Locations are named according to the hierarchical structure known from Java packages. This name structure is mirrored in the hierarchical order of the locations named. For example, if you would like to write all the messages from monitoring classes into a single log, you would call the location named com.sap.tc.monitoring. You could then command to collect all the messages from technology components in a common log by simply assigning that log to the parent location com.sap.tc. The log is then passed on to all child locations, in particular to com.sap.tc.monitoring. In addition, it is possible to include method signatures in location names. For example, com.sap.tc.monitoring.Node.announce(java.lang.Object) is a location for a method named announce with an argument of the class Object. In this way, you can distinguish overloaded methods and, by adding yet another suffix to such a name, even classes local to them. The hierarchical components of the name have to be compliant with Java identifier syntax, but you can use illegal characters bracketing a component with single quotes. For example, to use a component with a dot, the separator character of location names, write com.sap.'great.technology'.

Locations are accessed via the static method Location.getLocation. Although the lookup done in this method is quite efficient, it should not be called each time a message is to be generated. Instead, each class should define static fields to hold all the needed locations, and use these fields to call logging methods. This might get tedious when a class implements a large number of methods while at the same time there is no need for separate controlling of output. Therefore, as described below in more detail, for each logging method there is a version which takes in an additional parameter called subloc a string that serves as suffix to the name of the used location, thus providing you with the option to give a complete location name whilst avoiding clutter.

Before we take a closer look at an example, a few remarks on output methods and a short word of warning: do not let the sheer number of methods overwhelm you. There are two families of methods and the large number stems above all from the different parameters of these families, and the resulting combinations. There are methods for emitting clear text messages and methods for emitting language-independent messages via a message code, called logT and log, respectively. The message code is a name looked up in a resource bundle at the time of viewing the log. Both methods come in flavors that take an array of object arguments. When using these flavors, the message is expected to take parameters specified as placeholders of the form "{<number>}" which are then replaced with the argument having the same number, or rather with the result of its method toString. This format is known from the class java.text.MessageFormat. If the result of toString is unsuitable for an argument, an arbitrary string can be passed instead. Note that to output "{" or "}" you have to put them into single quotes, that is write "'{'" or "'}'". To print single quotes, double them in your message.

All the above methods take a first argument that specifies the severities of the messages. It is recommended to use one of the constants defined in the class Severity here, for example Severity.INFO or Severity.ERROR. However, there are also dedicated methods without that additional argument for all of the severities, with names of the form <severity>T and <severity>, which are provided in the same flavors as logT and log. In addition, there are special methods for tracing method entries, exits and throwing exceptions, called entering, exiting and throwing, respectively, which emit prefabricated Severity.PATH messages. There is also a method for checking assertions, assertion, which in case of failure emits a Severity.ERROR message.

To sum up the above, including optional arguments an output call has the following general form:

<severity>T(	[<categories>,]
	[<sublocation>,]
	<message>
	[,<arguments>])

or

<severity>(	<categories>,
	[<sublocation>,]
	<message code>
	[,<arguments>]
	[,<clear message>]).

The (optional) argument <categories> is for a parameter called category or categories in the actual methods, depending on whether you pass over a single category or an array of categories. It is intended to make possible the individual control of messages falling into the specified categories. You can then set a severity for this location with respect to each of the categories and thus enable or disable output of specifically those messages from the location that have been assigned to one or several of the categories. As a category is itself a log controller, the same method call can write a message simultaneously to the trace responsible for the location as well as to a log attached to the category, save for the necessary severity settings. Both messages get the same identification in order to facilitate cross-referencing among location and category logs. Please observe that the argument is not optional for the second method version emitting language-independent messages. The reason is that for tracing alone, these messages do not make sense when you take into account the effort for translation, as opposed to when one of the category has a log attached. However, in practice most categories used like this do not have logs.

The optional argument <sublocation> is for a parameter called subloc in the actual methods. This argument is appended to the name of the location itself. It is intended for completing the location name if a method is not represented via its own location because the corresponding fine control of output is not needed, as described above. The optional argument <clear message> of the second method version is for a parameter called msgClear in the actual methods. This argument is a fallback that is used to show the message if the code could not be found in the specified resource bundle. Of course, where applicable these optional arguments are also possible for the two basic calls logT and log as well as entering, throwing and assertion.

Let us take a closer look at an example. Due to the suffix option described above, both messages use the location name com.sap.tc.monitoring.Node.announce(java.lang.Object).

package com.sap.tc.monitoring;

import com.sap.tc.logging.*;

public class Node {

  private static final Location loc     = Location.getLocation(Node.class);
  private static final Category objMgmt = Category.getCategory("/Objects/Management");

  public void announce(Object o) {
    final String method = "announce(java.lang.Object)";

    loc.entering(method,
                 new Object[] {o});
    try {
      // Preparation
      ...
      loc.errorT(objMgmt,
                 method,
                 "Registering object {0}.",
                 new Object[] {o});
      // Register object
      ...
    }
    finally {
      loc.exiting();
    }
  }
}

Note that the call to exiting is placed inside a finally clause. This is because a call to entering must always be balanced with one to exiting, even in the face of exceptions. Note also that for the messages to be written to a log attached to the location, its severtiy must have been set at least with

loc.setEffectiveSevertiy(Severity.PATH);

for the calls of entering and exiting, and with

loc.setEffectiveSevertiy(objMgmt,
                         Severity.ERROR);

for the call to errorT, for example during component initialization. For the example at hand, it would have been alright to format the messages prior to the call using string concatenation, but in case of several arguments it is more efficient to use separate arguments.

You can establish custom links among messages. Output methods return the corresponding log record if a message was written to at least one log. The identification can be obtained from the log record via the method LogRecord.getId() and then written as an argument to another message. In the same way, groups can be linked to messages using the identification of the log record group from LogRecord.getGroupId(). Depending on the case at hand, other information in the log record and its groups is also useful.

Often, it is useful to put several related messages together into one context. A typical example are all trace messages stemming from one method call. In case of a database log, another example would be the messages representing the different database operations together forming one logical transaction. A formatter or log viewer can utilize this context information to visualize relations using indentation or tree controls. Groups are the means to express such context information.

You begin a group with a call to openGroup. This call is based on the same conditions as output calls, that is the group is opened depending on a severity and optional categories. After generating some output you end the group calling closeGroup. Even if an openGroup call did not open the group, closeGroup is matched with the call to openGroup. In case of success, in between the two calls all output calls are assigned to the group. You can even generate messages with the same condition as the group via the groupT and group output calls. These calls are also used to emit the opening and closing messages of a group, which are the first such messages emitted after the openGroup and closeGroup calls, respectively. If you forget to write opening and closing messages implicit messages are generated.

The methods entering and exiting are utilizing openGroup and closeGroup together with opening and closing messages to bracket method calls, so you can use groupT and group to generate path trace messages inside the method. In this case, the "%g" indentation place holder of TraceFormatter is helpful. It generates a configurable indentation according to the method call stack with vertical lines to match entries and exits of the same method call.

In the method above, for example, you could write the following piece of code to generate additional path messages to outline the path of execution. Note that the groupT calls do not need a severity or a method name, as these are fetched from the active group opened via the call to entering.

if (...)
  loc.groupT("Condition ... true -> if-branch taken.");
  ...
} else {
  loc.groupT("Condition ... false -> else-branch taken.");
  ...
}
cat.closeGroup();
cat.groupT("Finished storing tree.");

Please find fundamental information about the principles of error handling in the package description. For this class, there are three cases where the methods ExceptionHandling.getException() and ExceptionHandling.throwException() are served. First, methods dealing with severities pass over a java.lang.IllegalArgumentException if a value is out of range. Second, the same exception with a different message is handed over if you forget to provide categories when needed, which is the case for the calls setting relative severities as well as for some methods emitting messages. However, all defective calls of the latter, for example when not providing a resource bundle or a clear text version in case of a language-independent message, still write the message in order to facilitate discovering the site of the call. Third, java.util.NoSuchElementException is returned if a call to closeGroup does not match an openGroup call.

See Also:

Category, Severity

Field Summary

static java.lang.String	ROOT_NAME
static char	SEPARATOR

Method Summary

LogRecord	assertion(boolean assertion, java.lang.String desc) Logs message of severity Severity.ERROR which indicates that an assertion has failed.
LogRecord	assertion(Category[] categories, boolean assertion, java.lang.String desc) Logs message of the specified categories and severity Severity.ERROR which indicates that an assertion has failed.
LogRecord	assertion(Category[] categories, java.lang.String subloc, boolean assertion, java.lang.String desc) Same as assertion(Category[], boolean, java.lang.String) but appends a string denoting a sublocation to the name of this location.
LogRecord	assertion(Category category, boolean assertion, java.lang.String desc) Logs message of the specified category and severity Severity.ERROR which indicates that an assertion has failed.
LogRecord	assertion(Category category, java.lang.String subloc, boolean assertion, java.lang.String desc) Same as assertion(Category, boolean, java.lang.String) but appends a string denoting a sublocation to the name of this location.
LogRecord	assertion(java.lang.String subloc, boolean assertion, java.lang.String desc) Same as assertion(boolean, java.lang.String) but appends a string denoting a sublocation to the name of this location.
LogRecord	catching(Category[] categories, java.lang.String subloc, java.lang.Throwable exc) Same as catching(Category[], java.lang.Throwable) but appends a string denoting a sublocation to the name of this location.
LogRecord	catching(Category[] categories, java.lang.Throwable exc) Logs message of the specified categories and severity Severity.PATH which indicates that this method location has caught an exception.
LogRecord	catching(Category category, java.lang.String subloc, java.lang.Throwable exc) Same as catching(Category, java.lang.Throwable) but appends a string denoting a sublocation to the name of this location.
LogRecord	catching(Category category, java.lang.Throwable exc) Logs message of the specified category and severity Severity.PATH which indicates that this method location has caught an exception.
LogRecord	catching(java.lang.String subloc, java.lang.Throwable exc) Same as catching(java.lang.Throwable) but appends a string denoting a sublocation to the name of this location.
LogRecord	catching(java.lang.Throwable exc) Logs message of severity Severity.PATH which indicates that this method location has caught an exception.
LogRecord	debug(Category[] categories, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	debug(Category[] categories, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category[] categories, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category[] categories, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category[] categories, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category[], java.lang.String, java.lang.Object) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category category, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	debug(Category category, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.Object, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category category, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category category, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category category, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category, java.lang.String, java.lang.Object) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debug(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debugT(Category[] categories, java.lang.String msg) Same as logT(int, Category[], java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debugT(Category[] categories, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debugT(Category[] categories, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category[], java.lang.String, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debugT(Category[] categories, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.String, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debugT(Category category, java.lang.String msg) Same as logT(int, Category, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debugT(Category category, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debugT(Category category, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category, java.lang.String, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debugT(Category category, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debugT(java.lang.String msg) Same as logT(int, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debugT(java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debugT(java.lang.String subloc, java.lang.String msg) Same as logT(int, java.lang.String, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	debugT(java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.
LogRecord	entering() Logs message of severity Severity.PATH which indicates that execution had entered this method location.
LogRecord	entering(Category category) Logs message of the specified category and severity Severity.PATH which indicates that execution had entered this method location.
LogRecord	entering(Category[] categories) Logs message of the specified categories and severity Severity.PATH which indicates that execution had entered this method location.
LogRecord	entering(Category[] categories, java.lang.Object[] args) Logs message of the specified categories and severity Severity.PATH which indicates that execution had entered this method location.
LogRecord	entering(Category[] categories, java.lang.String subloc) Same as entering(Category[]) but appends a string denoting a sublocation to the name of this location.
LogRecord	entering(Category[] categories, java.lang.String subloc, java.lang.Object[] args) Same as entering(Category[], java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.
LogRecord	entering(Category category, java.lang.Object[] args) Logs message of the specified category and severity Severity.PATH which indicates that execution had entered this method location.
LogRecord	entering(Category category, java.lang.String subloc) Same as entering(Category) but appends a string denoting a sublocation to the name of this location.
LogRecord	entering(Category category, java.lang.String subloc, java.lang.Object[] args) Same as entering(Category, java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.
LogRecord	entering(java.lang.Object[] args) Logs message of severity Severity.PATH which indicates that execution had entered this method location.
LogRecord	entering(java.lang.String subloc) Same as entering() but appends a string denoting a sublocation to the name of this location.
LogRecord	entering(java.lang.String subloc, java.lang.Object[] args) Same as entering(java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.
LogRecord	error(Category[] categories, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	error(Category[] categories, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category[] categories, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category[] categories, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category[] categories, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category[], java.lang.String, java.lang.Object) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category category, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	error(Category category, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.Object, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category category, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category category, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category category, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category, java.lang.String, java.lang.Object) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	error(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	errorT(Category[] categories, java.lang.String msg) Same as logT(int, Category[], java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	errorT(Category[] categories, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	errorT(Category[] categories, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category[], java.lang.String, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	errorT(Category[] categories, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.String, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	errorT(Category category, java.lang.String msg) Same as logT(int, Category, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	errorT(Category category, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	errorT(Category category, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category, java.lang.String, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	errorT(Category category, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.String, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	errorT(java.lang.String msg) Same as logT(int, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	errorT(java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	errorT(java.lang.String subloc, java.lang.String msg) Same as logT(int, java.lang.String, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	errorT(java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.String, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.
LogRecord	exiting() Logs message of group severity which indicates that execution is about to leave this method location.
LogRecord	exiting(java.lang.Object res) Logs message of group severity which indicates that execution is about to leave this method location.
void	exiting(java.lang.String subloc) Same as exiting() but appends a string denoting a sublocation to the name of this location.
void	exiting(java.lang.String subloc, java.lang.Object res) Same as exiting(java.lang.Object) but appends a string denoting a sublocation to the name of this location.
LogRecord	fatal(Category[] categories, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	fatal(Category[] categories, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category[] categories, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category[] categories, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category[] categories, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category[], java.lang.String, java.lang.Object) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category category, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	fatal(Category category, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.Object, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category category, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category category, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category category, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category, java.lang.String, java.lang.Object) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatal(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatalT(Category[] categories, java.lang.String msg) Same as logT(int, Category[], java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatalT(Category[] categories, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatalT(Category[] categories, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category[], java.lang.String, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatalT(Category[] categories, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.String, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatalT(Category category, java.lang.String msg) Same as logT(int, Category, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatalT(Category category, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatalT(Category category, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category, java.lang.String, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatalT(Category category, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatalT(java.lang.String msg) Same as logT(int, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatalT(java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatalT(java.lang.String subloc, java.lang.String msg) Same as logT(int, java.lang.String, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.
LogRecord	fatalT(java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.
static Location	getLocation(java.lang.Class forClass) Gets the location for the specified class.
static Location	getLocation(Location loc, java.lang.String name) Gets the location with the specified name relative to another location.
static Location	getLocation(java.lang.Object instance) Gets the location for the class of the specified instance.
static Location	getLocation(java.lang.String name) Gets the location with the specified name.
Location	getParent() Gets the parent location of this location.
static Location	getRoot() Gets the root location.
LogRecord	info(Category[] categories, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	info(Category[] categories, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category[] categories, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category[] categories, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category[] categories, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category[], java.lang.String, java.lang.Object) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category category, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	info(Category category, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.Object, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category category, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category category, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category category, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category, java.lang.String, java.lang.Object) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	info(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	infoT(Category[] categories, java.lang.String msg) Same as logT(int, Category[], java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	infoT(Category[] categories, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	infoT(Category[] categories, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category[], java.lang.String, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	infoT(Category[] categories, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.String, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	infoT(Category category, java.lang.String msg) Same as logT(int, Category, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	infoT(Category category, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	infoT(Category category, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category, java.lang.String, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	infoT(Category category, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.String, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	infoT(java.lang.String msg) Same as logT(int, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	infoT(java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	infoT(java.lang.String subloc, java.lang.String msg) Same as logT(int, java.lang.String, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	infoT(java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.String, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.
LogRecord	log(int severity, Category[] categories, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	log(int severity, Category[] categories, java.lang.Object msgCode, java.lang.Object[] args) Logs message, specified as resource name, of the specified categories with parameters from this location.
LogRecord	log(int severity, Category[] categories, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Logs message, specified as a resource name, of the specified categories with parameters from this location.
LogRecord	log(int severity, Category[] categories, java.lang.Object msgCode, java.lang.String msgClear) Logs message, specified as a resource name, of the specified categories from this location.
LogRecord	log(int severity, Category[] categories, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category[], java.lang.Object) but appends a string denoting a sublocation to the name of this location.
LogRecord	log(int severity, Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.
LogRecord	log(int severity, Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but appends a string denoting a sublocation to the name of this location.
LogRecord	log(int severity, Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.String) but appends a string denoting a sublocation to the name of this location.
LogRecord	log(int severity, Category category, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	log(int severity, Category category, java.lang.Object msgCode, java.lang.Object[] args) Logs message, specified as resource name, of the specified category with parameters from this location.
LogRecord	log(int severity, Category category, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Logs message, specified as a resource name, of the specified category with parameters from this location.
LogRecord	log(int severity, Category category, java.lang.Object msgCode, java.lang.String msgClear) Logs message, specified as a resource name, of the specified category from this location.
LogRecord	log(int severity, Category category, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category, java.lang.Object) but appends a string denoting a sublocation to the name of this location.
LogRecord	log(int severity, Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.Object, java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.
LogRecord	log(int severity, Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but appends a string denoting a sublocation to the name of this location.
LogRecord	log(int severity, Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.String) but appends a string denoting a sublocation to the name of this location.
LogRecord	logT(int severity, Category[] categories, java.lang.String msg) Logs simple message of the specified categories from this location.
LogRecord	logT(int severity, Category[] categories, java.lang.String msg, java.lang.Object[] args) Logs message of the specified categories with parameters from this location.
LogRecord	logT(int severity, Category[] categories, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category[], java.lang.String) but appends a string denoting a sublocation to the name of this location.
LogRecord	logT(int severity, Category[] categories, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.
LogRecord	logT(int severity, Category category, java.lang.String msg) Logs simple message of the specified category from this location.
LogRecord	logT(int severity, Category category, java.lang.String msg, java.lang.Object[] args) Logs message of the specified category with parameters from this location.
LogRecord	logT(int severity, Category category, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category, java.lang.String) but appends a string denoting a sublocation to the name of this location.
LogRecord	logT(int severity, Category category, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.
LogRecord	logT(int severity, java.lang.String msg) Logs simple message from this location.
LogRecord	logT(int severity, java.lang.String msg, java.lang.Object[] args) Logs message with parameters from this location.
LogRecord	logT(int severity, java.lang.String subloc, java.lang.String msg) Same as logT(int, java.lang.String) but appends a string denoting a sublocation to the name of this location.
LogRecord	logT(int severity, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.
void	openGroup(int severity) Opens a message group from this location.
void	openGroup(int severity, Category category) Deprecated. This method is not supported anymore
void	openGroup(int severity, Category[] categories) Deprecated. This method is not supported anymore
void	openGroup(int severity, Category[] categories, java.lang.String subloc) Deprecated. This method is not supported anymore
void	openGroup(int severity, Category category, java.lang.String subloc) Deprecated. This method is not supported anymore
void	openGroup(int severity, java.lang.String subloc) Same as openGroup(int) but appends a string denoting a sublocation to the name of this location.
LogRecord	path(Category[] categories, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	path(Category[] categories, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category[] categories, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category[] categories, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category[] categories, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category[], java.lang.String, java.lang.Object) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category category, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	path(Category category, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.Object, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category category, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category category, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category category, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category, java.lang.String, java.lang.Object) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	path(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	pathT(Category[] categories, java.lang.String msg) Same as logT(int, Category[], java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	pathT(Category[] categories, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	pathT(Category[] categories, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category[], java.lang.String, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	pathT(Category[] categories, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.String, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	pathT(Category category, java.lang.String msg) Same as logT(int, Category, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	pathT(Category category, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	pathT(Category category, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category, java.lang.String, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	pathT(Category category, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	pathT(java.lang.String msg) Same as logT(int, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	pathT(java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	pathT(java.lang.String subloc, java.lang.String msg) Same as logT(int, java.lang.String, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.
LogRecord	pathT(java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.
void	setEffectiveSeverity(Category relative) Resets the effective severity of this location with respect to a category.
void	setEffectiveSeverity(Category relative, int severity) Sets the effective severity of this location with respect to a category.
void	setMaximumSeverity(Category relative) Resets the maximum severity of this location with respect to a category.
void	setMaximumSeverity(Category relative, int severity) Sets the maximum severity of this location with respect to a category.
void	setMinimumSeverity(Category relative) Resets the minimum severity of this location with respect to a category.
void	setMinimumSeverity(Category relative, int severity) Sets the minimum severity of this location with respect to a category.
LogRecord	throwing(Category[] categories, java.lang.String subloc, java.lang.Throwable exc) Same as throwing(Category[], java.lang.Throwable) but appends a string denoting a sublocation to the name of this location.
LogRecord	throwing(Category[] categories, java.lang.Throwable exc) Logs message of the specified categories and severity Severity.PATH which indicates that this method location is about to throw an exception.
LogRecord	throwing(Category category, java.lang.String subloc, java.lang.Throwable exc) Same as throwing(Category, java.lang.Throwable) but appends a string denoting a sublocation to the name of this location.
LogRecord	throwing(Category category, java.lang.Throwable exc) Logs message of the specified category and severity Severity.PATH which indicates that this method location is about to throw an exception.
LogRecord	throwing(java.lang.String subloc, java.lang.Throwable exc) Same as throwing(java.lang.Throwable) but appends a string denoting a sublocation to the name of this location.
LogRecord	throwing(java.lang.Throwable exc) Logs message of severity Severity.PATH which indicates that this method location is about to throw an exception.
LogRecord	traceThrowableT(int severity, Category cat, java.lang.String msg, java.lang.Object[] args, java.lang.Throwable exc) Deprecated. Not supported.
LogRecord	traceThrowableT(int severity, Category cat, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args, java.lang.Throwable exc) Deprecated. Not supported.
LogRecord	traceThrowableT(int severity, Category cat, java.lang.String subloc, java.lang.String msg, java.lang.Throwable exc) Deprecated. Not supported.
LogRecord	traceThrowableT(int severity, Category cat, java.lang.String msg, java.lang.Throwable exc) Deprecated. Not supported.
LogRecord	traceThrowableT(int severity, java.lang.String msg, java.lang.Object[] args, java.lang.Throwable exc) Trace message with stack trace of given exception, into this loaction.
LogRecord	traceThrowableT(int severity, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args, java.lang.Throwable exc) Trace message with stack trace of given exception, into this location.
LogRecord	traceThrowableT(int severity, java.lang.String subloc, java.lang.String msg, java.lang.Throwable exc) Trace message with stack trace of given exception, into this location.
LogRecord	traceThrowableT(int severity, java.lang.String msg, java.lang.Throwable exc) Trace message with stack trace of given exception, into this location.
LogRecord	warning(Category[] categories, java.lang.Object msgCode) Same as log(int, Category[], java.lang.Object) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category[] categories, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category[] categories, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category[] categories, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.Object, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category[] categories, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category[], java.lang.String, java.lang.Object) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category[] categories, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category category, java.lang.Object msgCode) Deprecated. Message Code must be used together with Message Text.
LogRecord	warning(Category category, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.Object, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category category, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category category, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.Object, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category category, java.lang.String subloc, java.lang.Object msgCode) Same as log(int, Category, java.lang.String, java.lang.Object) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.Object[] args, java.lang.String msgClear) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warning(Category category, java.lang.String subloc, java.lang.Object msgCode, java.lang.String msgClear) Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warningT(Category[] categories, java.lang.String msg) Same as logT(int, Category[], java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warningT(Category[] categories, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warningT(Category[] categories, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category[], java.lang.String, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warningT(Category[] categories, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category[], java.lang.String, java.lang.String, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warningT(Category category, java.lang.String msg) Same as logT(int, Category, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warningT(Category category, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warningT(Category category, java.lang.String subloc, java.lang.String msg) Same as logT(int, Category, java.lang.String, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warningT(Category category, java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, Category, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warningT(java.lang.String msg) Same as logT(int, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warningT(java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warningT(java.lang.String subloc, java.lang.String msg) Same as logT(int, java.lang.String, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.
LogRecord	warningT(java.lang.String subloc, java.lang.String msg, java.lang.Object[] args) Same as logT(int, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.

Methods inherited from class com.sap.tc.logging.LogController

addFilter, addLocalLog, addLog, addPrivateLog, beDebug, beDebug, beDebug, beError, beError, beError, beFatal, beFatal, beFatal, beGroup, beInfo, beInfo, beInfo, beLogged, beLogged, beLogged, bePath, bePath, bePath, beWarning, beWarning, beWarning, closeGroup, getAllLogs, getChildren, getClassLoader, getDescription, getEffectiveSeverity, getEffectiveSeverity, getEffectiveSeverity, getFilters, getGroupSize, getLocalLogs, getLoggedCnt, getLoggedCount, getLogs, getMaximumSeverity, getMaximumSeverity, getMaximumSeverity, getMinimumSeverity, getMinimumSeverity, getMinimumSeverity, getName, getPrivateLogs, getRecord, getRelatives, getResourceBundleName, getVerInUse, group, group, group, group, group, group, group, group, groupT, groupT, groupT, groupT, isActivityTracking, isFiltersAgreeing, release, removeFilter, removeFilters, removeLog, removeLogs, reset, resetAll, resetLoggedCount, setActivityTracking, setClassLoader, setClassLoader, setDescription, setEffectiveSeverity, setEffectiveSeverity, setGroupSize, setMaximumSeverity, setMaximumSeverity, setMinimumSeverity, setMinimumSeverity, setName, setResourceBundleName, setResourceBundleName

Methods inherited from class com.sap.tc.logging.ExceptionHandling

getException, getExceptions, handleException, handleException, resetException, throwException

Methods inherited from class java.lang.Object

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

Field Detail

ROOT_NAME

public static final java.lang.String ROOT_NAME

SEPARATOR

public static final char SEPARATOR

Method Detail

getRoot

public static Location getRoot()

Gets the root location.

Returns:

Root location

getParent

public Location getParent()

Gets the parent location of this location.

Returns:

Parent location

getLocation

public static Location getLocation(java.lang.String name)

Gets the location with the specified name. If the location does not exist it is instantiated. Inheritance refers to the formal hierarchy given via the name structure and therefore even works when parent objects had not been instantiated up to now, either. There are also versions of this method which take an object and a class, respectively, and return the location describing the class (of the object).

Parameters:

name - Name of location

Returns:

Location identified by name

Throws:

java.lang.IllegalArgumentException - Wrong location name syntax

See Also:

getLocation(java.lang.Object), getLocation(java.lang.Class)

getLocation

public static Location getLocation(java.lang.Object instance)

Gets the location for the class of the specified instance. If the location does not exist it is instantiated. Inheritance refers to the formal hierarchy given via the name structure and therefore even works when parent objects had not been instantiated up to now, either. The version of this method taking a string should be used for inner classes which bear generated names for use in the virtual machine.

Parameters:

instance - Instance of class

Returns:

Location that describes instance class

See Also:

getLocation(java.lang.String), getLocation(java.lang.Class)

getLocation

public static Location getLocation(java.lang.Class forClass)

Gets the location for the specified class. If the location does not exist it is instantiated. Inheritance refers to the formal hierarchy given via the name structure and therefore even works when parent objects had not been instantiated up to now, either. The version of this method taking a string should be used for inner classes which bear generated names for use in the virtual machine.

Parameters:

forClass - Class

Returns:

Location that describes class

See Also:

getLocation(java.lang.String), getLocation(java.lang.Object)

getLocation

public static Location getLocation(Location loc,
                                   java.lang.String name)

Gets the location with the specified name relative to another location. Save for the root location, this method is a shorthand for the call Location.getLocation(loc.getName() + "." + name).

Parameters:

loc - Parent location

name - Name of location

Returns:

Location identified by relative name

Throws:

java.lang.IllegalArgumentException - Wrong location name syntax

logT

public LogRecord logT(int severity,
                      java.lang.String msg)

Logs simple message from this location.

Parameters:

severity - Severity of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

logT

public LogRecord logT(int severity,
                      Category category,
                      java.lang.String msg)

Logs simple message of the specified category from this location.

Parameters:

severity - Severity of message

category - Category of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

logT

public LogRecord logT(int severity,
                      Category[] categories,
                      java.lang.String msg)

Logs simple message of the specified categories from this location.

Parameters:

severity - Severity of message

categories - Categories of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

logT

public LogRecord logT(int severity,
                      java.lang.String subloc,
                      java.lang.String msg)

Same as logT(int, java.lang.String) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

logT

public LogRecord logT(int severity,
                      Category category,
                      java.lang.String subloc,
                      java.lang.String msg)

Same as logT(int, Category, java.lang.String) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

category - Category of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

logT

public LogRecord logT(int severity,
                      Category[] categories,
                      java.lang.String subloc,
                      java.lang.String msg)

Same as logT(int, Category[], java.lang.String) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

categories - Categories of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

logT

public LogRecord logT(int severity,
                      java.lang.String msg,
                      java.lang.Object[] args)

Logs message with parameters from this location. The objects handed over as arguments are written using the method toString.

Parameters:

severity - Severity of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

logT

public LogRecord logT(int severity,
                      Category category,
                      java.lang.String msg,
                      java.lang.Object[] args)

Logs message of the specified category with parameters from this location. The objects handed over as arguments are written using the method toString.

Parameters:

severity - Severity of message

category - Category of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

logT

public LogRecord logT(int severity,
                      Category[] categories,
                      java.lang.String msg,
                      java.lang.Object[] args)

Logs message of the specified categories with parameters from this location. The objects handed over as arguments are written using the method toString.

Parameters:

severity - Severity of message

Categories - Categories of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

logT

public LogRecord logT(int severity,
                      java.lang.String subloc,
                      java.lang.String msg,
                      java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

subloc - Name of sublocation

msg - Message text

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

logT

public LogRecord logT(int severity,
                      Category category,
                      java.lang.String subloc,
                      java.lang.String msg,
                      java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

category - Category of message

subloc - Name of sublocation

msg - Message text

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

logT

public LogRecord logT(int severity,
                      Category[] categories,
                      java.lang.String subloc,
                      java.lang.String msg,
                      java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

categories - Categories of message

subloc - Name of sublocation

msg - Message text

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

log

public LogRecord log(int severity,
                     Category category,
                     java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Logs message, specified as a resource name, of the specified category from this location. This method also stores a clear text version of the message, taken from the resource bundle for language code en and country code US, which is displayed whenever a log viewer cannot resolve a message code.

Parameters:

severity - Severity of message

category - Category of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category[] categories,
                     java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Logs message, specified as a resource name, of the specified categories from this location. This method also stores a clear text version of the message, taken from the resource bundle for language code en and country code US, which is displayed whenever a log viewer cannot resolve a message code.

Parameters:

severity - Severity of message

categories - Categories of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category category,
                     java.lang.String subloc,
                     java.lang.Object msgCode)

Same as log(int, Category, java.lang.Object) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category[] categories,
                     java.lang.String subloc,
                     java.lang.Object msgCode)

Same as log(int, Category[], java.lang.Object) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category category,
                     java.lang.Object msgCode,
                     java.lang.Object[] args)

Logs message, specified as resource name, of the specified category with parameters from this location. The objects handed over as arguments are written using the method toString. This method also stores a clear text version of the message, taken from the resource bundle for language code en and country code US, which is displayed whenever a log viewer cannot resolve a message code.

Parameters:

severity - Severity of message

category - Category of message

msgCode - Resource name of message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category[] categories,
                     java.lang.Object msgCode,
                     java.lang.Object[] args)

Logs message, specified as resource name, of the specified categories with parameters from this location. The objects handed over as arguments are written using the method toString. This method also stores a clear text version of the message, taken from the resource bundle for language code en and country code US, which is displayed whenever a log viewer cannot resolve a message code.

Parameters:

severity - Severity of message

categories - Categories of message

msgCode - Resource name of message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category category,
                     java.lang.String subloc,
                     java.lang.Object msgCode,
                     java.lang.Object[] args)

Same as log(int, Category, java.lang.Object, java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category[] categories,
                     java.lang.String subloc,
                     java.lang.Object msgCode,
                     java.lang.Object[] args)

Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category category,
                     java.lang.Object msgCode,
                     java.lang.String msgClear)

Logs message, specified as a resource name, of the specified category from this location. This method also stores a clear text version of the message which is displayed whenever a log viewer cannot resolve a message code.

Parameters:

severity - Severity of message

category - Category of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category[] categories,
                     java.lang.Object msgCode,
                     java.lang.String msgClear)

Logs message, specified as a resource name, of the specified categories from this location. This method also stores a clear text version of the message which is displayed whenever a log viewer cannot resolve a message code.

Parameters:

severity - Severity of message

categories - Categories of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category category,
                     java.lang.String subloc,
                     java.lang.Object msgCode,
                     java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.String) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category[] categories,
                     java.lang.String subloc,
                     java.lang.Object msgCode,
                     java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.String) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category category,
                     java.lang.Object msgCode,
                     java.lang.Object[] args,
                     java.lang.String msgClear)

Logs message, specified as a resource name, of the specified category with parameters from this location. The objects handed over as arguments are written using the method toString. This method also stores a clear text version of the message which is displayed whenever a log viewer cannot resolve a message code.

Parameters:

severity - Severity of message

category - Category of message

msgCode - Resource name of message template

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category[] categories,
                     java.lang.Object msgCode,
                     java.lang.Object[] args,
                     java.lang.String msgClear)

Logs message, specified as a resource name, of the specified categories with parameters from this location. The objects handed over as arguments are written using the method toString. This method also stores a clear text version of the message which is displayed whenever a log viewer cannot resolve a message code.

Parameters:

severity - Severity of message

categories - Categories of message

msgCode - Resource name of message template

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category category,
                     java.lang.String subloc,
                     java.lang.Object msgCode,
                     java.lang.Object[] args,
                     java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message template

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

log

public LogRecord log(int severity,
                     Category[] categories,
                     java.lang.String subloc,
                     java.lang.Object msgCode,
                     java.lang.Object[] args,
                     java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message template

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debugT

public LogRecord debugT(java.lang.String msg)

Same as logT(int, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

msg - Message text

Returns:

Log record if written via a log of this log controller or null

debugT

public LogRecord debugT(Category category,
                        java.lang.String msg)

Same as logT(int, Category, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

category - Category of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

debugT

public LogRecord debugT(Category[] categories,
                        java.lang.String msg)

Same as logT(int, Category[], java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

categories - Categories of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

debugT

public LogRecord debugT(java.lang.String subloc,
                        java.lang.String msg)

Same as logT(int, java.lang.String, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

debugT

public LogRecord debugT(Category category,
                        java.lang.String subloc,
                        java.lang.String msg)

Same as logT(int, Category, java.lang.String, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

category - Category of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

debugT

public LogRecord debugT(Category[] categories,
                        java.lang.String subloc,
                        java.lang.String msg)

Same as logT(int, Category[], java.lang.String, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

debugT

public LogRecord debugT(java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

debugT

public LogRecord debugT(Category category,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

category - Category of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

debugT

public LogRecord debugT(Category[] categories,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

categories - Categories of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

debugT

public LogRecord debugT(java.lang.String subloc,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

debugT

public LogRecord debugT(Category category,
                        java.lang.String subloc,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

category - Category of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

debugT

public LogRecord debugT(Category[] categories,
                        java.lang.String subloc,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.String, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

debug

public LogRecord debug(Category category,
                       java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Same as log(int, Category, java.lang.Object) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

category - Category of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category[] categories,
                       java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Same as log(int, Category[], java.lang.Object) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

categories - Categories of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category category,
                       java.lang.String subloc,
                       java.lang.Object msgCode)

Same as log(int, Category, java.lang.String, java.lang.Object) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category[] categories,
                       java.lang.String subloc,
                       java.lang.Object msgCode)

Same as log(int, Category[], java.lang.String, java.lang.Object) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category category,
                       java.lang.Object msgCode,
                       java.lang.Object[] args)

Same as log(int, Category, java.lang.Object, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

category - Category of message

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category[] categories,
                       java.lang.Object msgCode,
                       java.lang.Object[] args)

Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

categories - Categories of message

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category category,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.Object[] args)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category[] categories,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.Object[] args)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category category,
                       java.lang.Object msgCode,
                       java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

category - Category of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category[] categories,
                       java.lang.Object msgCode,
                       java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

categories - Categories of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category category,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.String msgClear)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category[] categories,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.String msgClear)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category category,
                       java.lang.Object msgCode,
                       java.lang.Object[] args,
                       java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

category - Category of message

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category[] categories,
                       java.lang.Object msgCode,
                       java.lang.Object[] args,
                       java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

categories - Categories of message

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category category,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.Object[] args,
                       java.lang.String msgClear)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

debug

public LogRecord debug(Category[] categories,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.Object[] args,
                       java.lang.String msgClear)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a debug message, that is a message of severity Severity.DEBUG.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

pathT

public LogRecord pathT(java.lang.String msg)

Same as logT(int, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

msg - Message text

Returns:

Log record if written via a log of this log controller or null

pathT

public LogRecord pathT(Category category,
                       java.lang.String msg)

Same as logT(int, Category, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

category - Category of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

pathT

public LogRecord pathT(Category[] categories,
                       java.lang.String msg)

Same as logT(int, Category[], java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

categories - Categories of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

pathT

public LogRecord pathT(java.lang.String subloc,
                       java.lang.String msg)

Same as logT(int, java.lang.String, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

pathT

public LogRecord pathT(Category category,
                       java.lang.String subloc,
                       java.lang.String msg)

Same as logT(int, Category, java.lang.String, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

category - Category of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

pathT

public LogRecord pathT(Category[] categories,
                       java.lang.String subloc,
                       java.lang.String msg)

Same as logT(int, Category[], java.lang.String, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

pathT

public LogRecord pathT(java.lang.String msg,
                       java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

pathT

public LogRecord pathT(Category category,
                       java.lang.String msg,
                       java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

category - Category of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

pathT

public LogRecord pathT(Category[] categories,
                       java.lang.String msg,
                       java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

categories - Categories of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

pathT

public LogRecord pathT(java.lang.String subloc,
                       java.lang.String msg,
                       java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

pathT

public LogRecord pathT(Category category,
                       java.lang.String subloc,
                       java.lang.String msg,
                       java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

category - Category of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

pathT

public LogRecord pathT(Category[] categories,
                       java.lang.String subloc,
                       java.lang.String msg,
                       java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.String, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

path

public LogRecord path(Category category,
                      java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Same as log(int, Category, java.lang.Object) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

category - Category of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category[] categories,
                      java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Same as log(int, Category[], java.lang.Object) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

categories - Categories of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category category,
                      java.lang.String subloc,
                      java.lang.Object msgCode)

Same as log(int, Category, java.lang.String, java.lang.Object) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category[] categories,
                      java.lang.String subloc,
                      java.lang.Object msgCode)

Same as log(int, Category[], java.lang.String, java.lang.Object) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category category,
                      java.lang.Object msgCode,
                      java.lang.Object[] args)

Same as log(int, Category, java.lang.Object, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

category - Category of message

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category[] categories,
                      java.lang.Object msgCode,
                      java.lang.Object[] args)

Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

categories - Categories of message

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category category,
                      java.lang.String subloc,
                      java.lang.Object msgCode,
                      java.lang.Object[] args)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category[] categories,
                      java.lang.String subloc,
                      java.lang.Object msgCode,
                      java.lang.Object[] args)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category category,
                      java.lang.Object msgCode,
                      java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

category - Category of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category[] categories,
                      java.lang.Object msgCode,
                      java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

categories - Categories of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category category,
                      java.lang.String subloc,
                      java.lang.Object msgCode,
                      java.lang.String msgClear)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category[] categories,
                      java.lang.String subloc,
                      java.lang.Object msgCode,
                      java.lang.String msgClear)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category category,
                      java.lang.Object msgCode,
                      java.lang.Object[] args,
                      java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

category - Category of message

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category[] categories,
                      java.lang.Object msgCode,
                      java.lang.Object[] args,
                      java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

categories - Categories of message

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category category,
                      java.lang.String subloc,
                      java.lang.Object msgCode,
                      java.lang.Object[] args,
                      java.lang.String msgClear)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

path

public LogRecord path(Category[] categories,
                      java.lang.String subloc,
                      java.lang.Object msgCode,
                      java.lang.Object[] args,
                      java.lang.String msgClear)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a path message, that is a message of severity Severity.PATH.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

infoT

public LogRecord infoT(java.lang.String msg)

Same as logT(int, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

msg - Message text

Returns:

Log record if written via a log of this log controller or null

infoT

public LogRecord infoT(Category category,
                       java.lang.String msg)

Same as logT(int, Category, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

category - Category of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

infoT

public LogRecord infoT(Category[] categories,
                       java.lang.String msg)

Same as logT(int, Category[], java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

categories - Categories of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

infoT

public LogRecord infoT(java.lang.String subloc,
                       java.lang.String msg)

Same as logT(int, java.lang.String, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

subloc - Name of sublocation

msg - Message text

infoT

public LogRecord infoT(Category category,
                       java.lang.String subloc,
                       java.lang.String msg)

Same as logT(int, Category, java.lang.String, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

category - Category of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

infoT

public LogRecord infoT(Category[] categories,
                       java.lang.String subloc,
                       java.lang.String msg)

Same as logT(int, Category[], java.lang.String, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

infoT

public LogRecord infoT(java.lang.String msg,
                       java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

infoT

public LogRecord infoT(Category category,
                       java.lang.String msg,
                       java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

category - Category of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

infoT

public LogRecord infoT(Category[] categories,
                       java.lang.String msg,
                       java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

categories - Categories of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

infoT

public LogRecord infoT(java.lang.String subloc,
                       java.lang.String msg,
                       java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.String, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

infoT

public LogRecord infoT(Category category,
                       java.lang.String subloc,
                       java.lang.String msg,
                       java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.String, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

category - Category of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

infoT

public LogRecord infoT(Category[] categories,
                       java.lang.String subloc,
                       java.lang.String msg,
                       java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.String, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

info

public LogRecord info(Category category,
                      java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Same as log(int, Category, java.lang.Object) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

category - Category of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category[] categories,
                      java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Same as log(int, Category[], java.lang.Object) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

categories - Categories of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category category,
                      java.lang.String subloc,
                      java.lang.Object msgCode)

Same as log(int, Category, java.lang.String, java.lang.Object) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category[] categories,
                      java.lang.String subloc,
                      java.lang.Object msgCode)

Same as log(int, Category[], java.lang.String, java.lang.Object) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category category,
                      java.lang.Object msgCode,
                      java.lang.Object[] args)

Same as log(int, Category, java.lang.Object, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

category - Category of message

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category[] categories,
                      java.lang.Object msgCode,
                      java.lang.Object[] args)

Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

categories - Categories of message

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category category,
                      java.lang.String subloc,
                      java.lang.Object msgCode,
                      java.lang.Object[] args)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category[] categories,
                      java.lang.String subloc,
                      java.lang.Object msgCode,
                      java.lang.Object[] args)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[]) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category category,
                      java.lang.Object msgCode,
                      java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

category - Category of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category[] categories,
                      java.lang.Object msgCode,
                      java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

categories - Categories of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category category,
                      java.lang.String subloc,
                      java.lang.Object msgCode,
                      java.lang.String msgClear)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category[] categories,
                      java.lang.String subloc,
                      java.lang.Object msgCode,
                      java.lang.String msgClear)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category category,
                      java.lang.Object msgCode,
                      java.lang.Object[] args,
                      java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

category - Category of message

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category[] categories,
                      java.lang.Object msgCode,
                      java.lang.Object[] args,
                      java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

categories - Categories of message

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category category,
                      java.lang.String subloc,
                      java.lang.Object msgCode,
                      java.lang.Object[] args,
                      java.lang.String msgClear)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

info

public LogRecord info(Category[] categories,
                      java.lang.String subloc,
                      java.lang.Object msgCode,
                      java.lang.Object[] args,
                      java.lang.String msgClear)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits an informational message, that is a message of severity Severity.INFO.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warningT

public LogRecord warningT(java.lang.String msg)

Same as logT(int, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

msg - Message text

Returns:

Log record if written via a log of this log controller or null

warningT

public LogRecord warningT(Category category,
                          java.lang.String msg)

Same as logT(int, Category, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

category - Category of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

warningT

public LogRecord warningT(Category[] categories,
                          java.lang.String msg)

Same as logT(int, Category[], java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

categories - Categories of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

warningT

public LogRecord warningT(java.lang.String subloc,
                          java.lang.String msg)

Same as logT(int, java.lang.String, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

warningT

public LogRecord warningT(Category category,
                          java.lang.String subloc,
                          java.lang.String msg)

Same as logT(int, Category, java.lang.String, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

category - Category of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

warningT

public LogRecord warningT(Category[] categories,
                          java.lang.String subloc,
                          java.lang.String msg)

Same as logT(int, Category[], java.lang.String, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

warningT

public LogRecord warningT(java.lang.String msg,
                          java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

warningT

public LogRecord warningT(Category category,
                          java.lang.String msg,
                          java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

category - Category of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

warningT

public LogRecord warningT(Category[] categories,
                          java.lang.String msg,
                          java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

categories - Categories of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

warningT

public LogRecord warningT(java.lang.String subloc,
                          java.lang.String msg,
                          java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

warningT

public LogRecord warningT(Category category,
                          java.lang.String subloc,
                          java.lang.String msg,
                          java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

category - Category of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

warningT

public LogRecord warningT(Category[] categories,
                          java.lang.String subloc,
                          java.lang.String msg,
                          java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.String, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

warning

public LogRecord warning(Category category,
                         java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Same as log(int, Category, java.lang.Object) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

category - Category of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category[] categories,
                         java.lang.Object msgCode)

Same as log(int, Category[], java.lang.Object) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

categories - Categories of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category category,
                         java.lang.String subloc,
                         java.lang.Object msgCode)

Same as log(int, Category, java.lang.String, java.lang.Object) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category[] categories,
                         java.lang.String subloc,
                         java.lang.Object msgCode)

Same as log(int, Category[], java.lang.String, java.lang.Object) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category category,
                         java.lang.Object msgCode,
                         java.lang.Object[] args)

Same as log(int, Category, java.lang.Object, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

category - Category of message

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category[] categories,
                         java.lang.Object msgCode,
                         java.lang.Object[] args)

Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

categories - Categories of message

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category category,
                         java.lang.String subloc,
                         java.lang.Object msgCode,
                         java.lang.Object[] args)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category[] categories,
                         java.lang.String subloc,
                         java.lang.Object msgCode,
                         java.lang.Object[] args)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category category,
                         java.lang.Object msgCode,
                         java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

category - Category of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category[] categories,
                         java.lang.Object msgCode,
                         java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

categories - Categories of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category category,
                         java.lang.String subloc,
                         java.lang.Object msgCode,
                         java.lang.String msgClear)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category[] categories,
                         java.lang.String subloc,
                         java.lang.Object msgCode,
                         java.lang.String msgClear)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category category,
                         java.lang.Object msgCode,
                         java.lang.Object[] args,
                         java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

category - Category of message

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category[] categories,
                         java.lang.Object msgCode,
                         java.lang.Object[] args,
                         java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

categories - Categories of message

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category category,
                         java.lang.String subloc,
                         java.lang.Object msgCode,
                         java.lang.Object[] args,
                         java.lang.String msgClear)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

warning

public LogRecord warning(Category[] categories,
                         java.lang.String subloc,
                         java.lang.Object msgCode,
                         java.lang.Object[] args,
                         java.lang.String msgClear)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a warning message, that is a message of severity Severity.WARNING.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

errorT

public LogRecord errorT(java.lang.String msg)

Same as logT(int, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

msg - Message text

Returns:

Log record if written via a log of this log controller or null

errorT

public LogRecord errorT(Category category,
                        java.lang.String msg)

Same as logT(int, Category, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

category - Category of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

errorT

public LogRecord errorT(Category[] categories,
                        java.lang.String msg)

Same as logT(int, Category[], java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

categories - Categories of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

errorT

public LogRecord errorT(java.lang.String subloc,
                        java.lang.String msg)

Same as logT(int, java.lang.String, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

errorT

public LogRecord errorT(Category category,
                        java.lang.String subloc,
                        java.lang.String msg)

Same as logT(int, Category, java.lang.String, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

category - Category of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

errorT

public LogRecord errorT(Category[] categories,
                        java.lang.String subloc,
                        java.lang.String msg)

Same as logT(int, Category[], java.lang.String, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

errorT

public LogRecord errorT(java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

errorT

public LogRecord errorT(Category category,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

category - Category of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

errorT

public LogRecord errorT(Category[] categories,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

categories - Categories of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

errorT

public LogRecord errorT(java.lang.String subloc,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.String, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

errorT

public LogRecord errorT(Category category,
                        java.lang.String subloc,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.String, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

category - Category of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

errorT

public LogRecord errorT(Category[] categories,
                        java.lang.String subloc,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.String, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

error

public LogRecord error(Category category,
                       java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Same as log(int, Category, java.lang.Object) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

category - Category of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category[] categories,
                       java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Same as log(int, Category[], java.lang.Object) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

categories - Categories of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category category,
                       java.lang.String subloc,
                       java.lang.Object msgCode)

Same as log(int, Category, java.lang.String, java.lang.Object) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category[] categories,
                       java.lang.String subloc,
                       java.lang.Object msgCode)

Same as log(int, Category[], java.lang.String, java.lang.Object) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category category,
                       java.lang.Object msgCode,
                       java.lang.Object[] args)

Same as log(int, Category, java.lang.Object, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

category - Category of message

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category[] categories,
                       java.lang.Object msgCode,
                       java.lang.Object[] args)

Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

categories - Categories of message

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category category,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.Object[] args)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category[] categories,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.Object[] args)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[]) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category category,
                       java.lang.Object msgCode,
                       java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

category - Category of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category[] categories,
                       java.lang.Object msgCode,
                       java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

categories - Categories of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category category,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.String msgClear)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category[] categories,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.String msgClear)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category category,
                       java.lang.Object msgCode,
                       java.lang.Object[] args,
                       java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

category - Category of message

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category[] categories,
                       java.lang.Object msgCode,
                       java.lang.Object[] args,
                       java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

categories - Categories of message

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category category,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.Object[] args,
                       java.lang.String msgClear)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

error

public LogRecord error(Category[] categories,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.Object[] args,
                       java.lang.String msgClear)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits an error message, that is a message of severity Severity.ERROR.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatalT

public LogRecord fatalT(java.lang.String msg)

Same as logT(int, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

msg - Message text

Returns:

Log record if written via a log of this log controller or null

fatalT

public LogRecord fatalT(Category category,
                        java.lang.String msg)

Same as logT(int, Category, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

category - Category of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

fatalT

public LogRecord fatalT(Category[] categories,
                        java.lang.String msg)

Same as logT(int, Category[], java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

categories - Categories of message

msg - Message text

Returns:

Log record if written via a log of this log controller or null

fatalT

public LogRecord fatalT(java.lang.String subloc,
                        java.lang.String msg)

Same as logT(int, java.lang.String, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

fatalT

public LogRecord fatalT(Category category,
                        java.lang.String subloc,
                        java.lang.String msg)

Same as logT(int, Category, java.lang.String, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

category - Category of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

fatalT

public LogRecord fatalT(Category[] categories,
                        java.lang.String subloc,
                        java.lang.String msg)

Same as logT(int, Category[], java.lang.String, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msg - Message text

Returns:

Log record if written via a log of this log controller or null

fatalT

public LogRecord fatalT(java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

fatalT

public LogRecord fatalT(Category category,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

category - Category of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

fatalT

public LogRecord fatalT(Category[] categories,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

categories - Categories of message

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

fatalT

public LogRecord fatalT(java.lang.String subloc,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

fatalT

public LogRecord fatalT(Category category,
                        java.lang.String subloc,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, Category, java.lang.String, java.lang.String, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

category - Category of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

fatalT

public LogRecord fatalT(Category[] categories,
                        java.lang.String subloc,
                        java.lang.String msg,
                        java.lang.Object[] args)

Same as logT(int, Category[], java.lang.String, java.lang.String, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

fatal

public LogRecord fatal(Category category,
                       java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Same as log(int, Category, java.lang.Object) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

category - Category of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category[] categories,
                       java.lang.Object msgCode)

Deprecated. Message Code must be used together with Message Text.

Same as log(int, Category[], java.lang.Object) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

categories - Categories of message

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category category,
                       java.lang.String subloc,
                       java.lang.Object msgCode)

Same as log(int, Category, java.lang.String, java.lang.Object) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category[] categories,
                       java.lang.String subloc,
                       java.lang.Object msgCode)

Same as log(int, Category[], java.lang.String, java.lang.Object) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category category,
                       java.lang.Object msgCode,
                       java.lang.Object[] args)

Same as log(int, Category, java.lang.Object, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

category - Category of message

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category[] categories,
                       java.lang.Object msgCode,
                       java.lang.Object[] args)

Same as log(int, Category[], java.lang.Object, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

categories - Categories of message

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category category,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.Object[] args)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category[] categories,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.Object[] args)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[]) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category category,
                       java.lang.Object msgCode,
                       java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

category - Category of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category[] categories,
                       java.lang.Object msgCode,
                       java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

categories - Categories of message

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category category,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.String msgClear)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category[] categories,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.String msgClear)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category category,
                       java.lang.Object msgCode,
                       java.lang.Object[] args,
                       java.lang.String msgClear)

Same as log(int, Category, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

category - Category of message

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category[] categories,
                       java.lang.Object msgCode,
                       java.lang.Object[] args,
                       java.lang.String msgClear)

Same as log(int, Category[], java.lang.Object, java.lang.Object[], java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

categories - Categories of message

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category category,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.Object[] args,
                       java.lang.String msgClear)

Same as log(int, Category, java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

category - Category of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

fatal

public LogRecord fatal(Category[] categories,
                       java.lang.String subloc,
                       java.lang.Object msgCode,
                       java.lang.Object[] args,
                       java.lang.String msgClear)

Same as log(int, Category[], java.lang.String, java.lang.Object, java.lang.Object[], java.lang.String) but always emits a fatal error message, that is a message of severity Severity.FATAL.

Parameters:

categories - Categories of message

subloc - Name of sublocation

msgCode - Resource name of message

args - Arguments as object references

msgClear - Clear text version of message

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

entering

public LogRecord entering()

Logs message of severity Severity.PATH which indicates that execution had entered this method location. This method is restricted to locations standing for methods and must be balanced with a call to the method exiting when leaving, for example exiting(java.lang.Object).

Returns:

Log record if written via a log of this log controller or null

entering

public LogRecord entering(Category category)

Logs message of the specified category and severity Severity.PATH which indicates that execution had entered this method location. This method is restricted to locations standing for methods and must be balanced with a call to the method exiting when leaving, for example exiting(java.lang.Object).

Parameters:

category - Category of message

Returns:

Log record if written via a log of this log controller or null

entering

public LogRecord entering(Category[] categories)

Logs message of the specified categories and severity Severity.PATH which indicates that execution had entered this method location. This method is restricted to locations standing for methods and must be balanced with a call to the method exiting when leaving, for example exiting(java.lang.Object).

Parameters:

categories - Categories of message

Returns:

Log record if written via a log of this log controller or null

entering

public LogRecord entering(java.lang.String subloc)

Same as entering() but appends a string denoting a sublocation to the name of this location. This method must be balanced with a call to exiting when leaving the traced method, for example exiting(java.lang.Object).

Parameters:

subloc - Name of sublocation

Returns:

Log record if written via a log of this log controller or null

entering

public LogRecord entering(Category category,
                          java.lang.String subloc)

Same as entering(Category) but appends a string denoting a sublocation to the name of this location. This method must be balanced with a call to exiting when leaving the traced method, for example exiting(java.lang.Object).

Parameters:

category - Category of message

subloc - Name of sublocation

Returns:

Log record if written via a log of this log controller or null

entering

public LogRecord entering(Category[] categories,
                          java.lang.String subloc)

Same as entering(Category[]) but appends a string denoting a sublocation to the name of this location. This method must be balanced with a call to exiting when leaving the traced method, for example exiting(java.lang.Object).

Parameters:

categories - Categories of message

subloc - Name of sublocation

Returns:

Log record if written via a log of this log controller or null

entering

public LogRecord entering(java.lang.Object[] args)

Logs message of severity Severity.PATH which indicates that execution had entered this method location. This method is restricted to locations standing for methods and must be balanced with a call to the method exiting when leaving, for example exiting(java.lang.Object). The objects handed over are the (possibly wrapped) arguments to the method and are written using the method toString.

Parameters:

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

entering

public LogRecord entering(Category category,
                          java.lang.Object[] args)

Logs message of the specified category and severity Severity.PATH which indicates that execution had entered this method location. This method is restricted to locations standing for methods and must be balanced with a call to the method exiting when leaving, for example exiting(java.lang.Object). The objects handed over are the (possibly wrapped) arguments to the method and are written using the method toString.

Parameters:

category - Category of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

entering

public LogRecord entering(Category[] categories,
                          java.lang.Object[] args)

Logs message of the specified categories and severity Severity.PATH which indicates that execution had entered this method location. This method is restricted to locations standing for methods and must be balanced with a call to the method exiting when leaving, for example exiting(java.lang.Object). The objects handed over are the (possibly wrapped) arguments to the method and are written using the method toString.

Parameters:

categories - Categories of message

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

entering

public LogRecord entering(java.lang.String subloc,
                          java.lang.Object[] args)

Same as entering(java.lang.Object[]) but appends a string denoting a sublocation to the name of this location. This method must be balanced with a call to exiting when leaving the traced method, for example exiting(java.lang.Object).

Parameters:

subloc - Name of sublocation

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

entering

public LogRecord entering(Category category,
                          java.lang.String subloc,
                          java.lang.Object[] args)

Same as entering(Category, java.lang.Object[]) but appends a string denoting a sublocation to the name of this location. This method must be balanced with a call to exiting when leaving the traced method, for example exiting(java.lang.Object).

Parameters:

category - Category of message

subloc - Name of sublocation

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

entering

public LogRecord entering(Category[] categories,
                          java.lang.String subloc,
                          java.lang.Object[] args)

Same as entering(Category[], java.lang.Object[]) but appends a string denoting a sublocation to the name of this location. This method must be balanced with a call to exiting when leaving the traced method, for example exiting(java.lang.Object).

Parameters:

categories - Categories of message

subloc - Name of sublocation

args - Arguments as object references

Returns:

Log record if written via a log of this log controller or null

exiting

public LogRecord exiting()

Logs message of group severity which indicates that execution is about to leave this method location. This method is to be balanced with a call to the method entering, for example entering(java.lang.String, java.lang.Object[]).

Returns:

Log record if written via a log of this log controller or null

exiting

public void exiting(java.lang.String subloc)

Same as exiting() but appends a string denoting a sublocation to the name of this location.

Parameters:

subloc - Name of sublocation

exiting

public LogRecord exiting(java.lang.Object res)

Logs message of group severity which indicates that execution is about to leave this method location. This method is to be balanced with a call to the method entering, for example entering(java.lang.String, java.lang.Object[]). The object handed over is the (possibly wrapped) result of the method and is written using its method toString.

Parameters:

res - Result as object reference

Returns:

Log record if written via a log of this log controller or null

exiting

public void exiting(java.lang.String subloc,
                    java.lang.Object res)

Same as exiting(java.lang.Object) but appends a string denoting a sublocation to the name of this location.

Parameters:

subloc - Name of sublocation

res - Result as object reference

assertion

public LogRecord assertion(boolean assertion,
                           java.lang.String desc)

Logs message of severity Severity.ERROR which indicates that an assertion has failed. This method is restricted to locations standing for methods.

Parameters:

assertion - Condition that is asserted

desc - Text describing the assertion, often the text of the boolean expression specified as first argument

Returns:

Log record if written via a log of this log controller or null

assertion

public LogRecord assertion(Category category,
                           boolean assertion,
                           java.lang.String desc)

Logs message of the specified category and severity Severity.ERROR which indicates that an assertion has failed. This method is restricted to locations standing for methods.

Parameters:

category - Category of message

assertion - Condition that is asserted

desc - Text describing the assertion, often the text of the boolean expression specified as first argument

Returns:

Log record if written via a log of this log controller or null

assertion

public LogRecord assertion(Category[] categories,
                           boolean assertion,
                           java.lang.String desc)

Logs message of the specified categories and severity Severity.ERROR which indicates that an assertion has failed. This method is restricted to locations standing for methods.

Parameters:

categories - Categories of message

assertion - Condition that is asserted

desc - Text describing the assertion, often the text of the boolean expression specified as first argument

Returns:

Log record if written via a log of this log controller or null

assertion

public LogRecord assertion(java.lang.String subloc,
                           boolean assertion,
                           java.lang.String desc)

Same as assertion(boolean, java.lang.String) but appends a string denoting a sublocation to the name of this location.

Parameters:

subloc - Name of sublocation

assertion - Condition that is asserted

desc - Text describing the assertion, often the text of the boolean expression specified as second argument

Returns:

Log record if written via a log of this log controller or null

assertion

public LogRecord assertion(Category category,
                           java.lang.String subloc,
                           boolean assertion,
                           java.lang.String desc)

Same as assertion(Category, boolean, java.lang.String) but appends a string denoting a sublocation to the name of this location.

Parameters:

category - Category of message

subloc - Name of sublocation

assertion - Condition that is asserted

desc - Text describing the assertion, often the text of the boolean expression specified as second argument

Returns:

Log record if written via a log of this log controller or null

assertion

public LogRecord assertion(Category[] categories,
                           java.lang.String subloc,
                           boolean assertion,
                           java.lang.String desc)

Same as assertion(Category[], boolean, java.lang.String) but appends a string denoting a sublocation to the name of this location.

Parameters:

categories - Categories of message

subloc - Name of sublocation

assertion - Condition that is asserted

desc - Text describing the assertion, often the text of the boolean expression specified as second argument

Returns:

Log record if written via a log of this log controller or null

throwing

public LogRecord throwing(java.lang.Throwable exc)

Logs message of severity Severity.PATH which indicates that this method location is about to throw an exception. This method is restricted to locations standing for methods. The exception is written using its method toString.

Parameters:

exc - Exception about to be thrown

Returns:

Log record if written via a log of this log controller or null

throwing

public LogRecord throwing(Category category,
                          java.lang.Throwable exc)

Logs message of the specified category and severity Severity.PATH which indicates that this method location is about to throw an exception. This method is restricted to locations standing for methods. The exception is written using its method toString.

Parameters:

category - Category of message

exc - Exception about to be thrown

Returns:

Log record if written via a log of this log controller or null

throwing

public LogRecord throwing(Category[] categories,
                          java.lang.Throwable exc)

Logs message of the specified categories and severity Severity.PATH which indicates that this method location is about to throw an exception. This method is restricted to locations standing for methods. The exception is written using its method toString.

Parameters:

categories - Categories of message

exc - Exception about to be thrown

Returns:

Log record if written via a log of this log controller or null

throwing

public LogRecord throwing(java.lang.String subloc,
                          java.lang.Throwable exc)

Same as throwing(java.lang.Throwable) but appends a string denoting a sublocation to the name of this location.

Parameters:

subloc - Name of sublocation

exc - Exception about to be thrown

Returns:

Log record if written via a log of this log controller or null

throwing

public LogRecord throwing(Category category,
                          java.lang.String subloc,
                          java.lang.Throwable exc)

Same as throwing(Category, java.lang.Throwable) but appends a string denoting a sublocation to the name of this location.

Parameters:

category - Category of message

subloc - Name of sublocation

exc - Exception about to be thrown

Returns:

Log record if written via a log of this log controller or null

throwing

public LogRecord throwing(Category[] categories,
                          java.lang.String subloc,
                          java.lang.Throwable exc)

Same as throwing(Category[], java.lang.Throwable) but appends a string denoting a sublocation to the name of this location.

Parameters:

categories - Categories of message

subloc - Name of sublocation

exc - Exception about to be thrown

Returns:

Log record if written via a log of this log controller or null

catching

public LogRecord catching(java.lang.Throwable exc)

Logs message of severity Severity.PATH which indicates that this method location has caught an exception. This method is restricted to locations standing for methods. The exception is written using its method printStackTrace.

Parameters:

exc - Exception caught

Returns:

Log record if written via a log of this log controller or null

catching

public LogRecord catching(Category category,
                          java.lang.Throwable exc)

Logs message of the specified category and severity Severity.PATH which indicates that this method location has caught an exception. This method is restricted to locations standing for methods. The exception is written using its method printStackTrace.

Parameters:

category - Category of message

exc - Exception caught

Returns:

Log record if written via a log of this log controller or null

catching

public LogRecord catching(Category[] categories,
                          java.lang.Throwable exc)

Logs message of the specified categories and severity Severity.PATH which indicates that this method location has caught an exception. This method is restricted to locations standing for methods. The exception is written using its method printStackTrace.

Parameters:

categories - Categories of message

exc - Exception caught

Returns:

Log record if written via a log of this log controller or null

catching

public LogRecord catching(java.lang.String subloc,
                          java.lang.Throwable exc)

Same as catching(java.lang.Throwable) but appends a string denoting a sublocation to the name of this location.

Parameters:

subloc - Name of sublocation

exc - Exception caught

Returns:

Log record if written via a log of this log controller or null

catching

public LogRecord catching(Category category,
                          java.lang.String subloc,
                          java.lang.Throwable exc)

Same as catching(Category, java.lang.Throwable) but appends a string denoting a sublocation to the name of this location.

Parameters:

category - Category of message

subloc - Name of sublocation

exc - Exception caught

Returns:

Log record if written via a log of this log controller or null

catching

public LogRecord catching(Category[] categories,
                          java.lang.String subloc,
                          java.lang.Throwable exc)

Same as catching(Category[], java.lang.Throwable) but appends a string denoting a sublocation to the name of this location.

Parameters:

categories - Categories of message

subloc - Name of sublocation

exc - Exception caught

Returns:

Log record if written via a log of this log controller or null

traceThrowableT

public LogRecord traceThrowableT(int severity,
                                 java.lang.String msg,
                                 java.lang.Throwable exc)

Trace message with stack trace of given exception, into this location.

Parameters:

severity - Severity of message

msg - Message template

exc - Throwable, the superclass of all errors and exceptions

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

traceThrowableT

public LogRecord traceThrowableT(int severity,
                                 java.lang.String subloc,
                                 java.lang.String msg,
                                 java.lang.Throwable exc)

Trace message with stack trace of given exception, into this location.

Parameters:

severity - Severity of message

subloc - Name of sublocation

msg - Message template

exc - Throwable, the superclass of all errors and exceptions

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

traceThrowableT

public LogRecord traceThrowableT(int severity,
                                 java.lang.String msg,
                                 java.lang.Object[] args,
                                 java.lang.Throwable exc)

Trace message with stack trace of given exception, into this loaction.

Parameters:

severity - Severity of message

msg - Message template

args - Arguments as object references

exc - Throwable, the superclass of all errors and exceptions

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

traceThrowableT

public LogRecord traceThrowableT(int severity,
                                 java.lang.String subloc,
                                 java.lang.String msg,
                                 java.lang.Object[] args,
                                 java.lang.Throwable exc)

Trace message with stack trace of given exception, into this location.

Parameters:

severity - Severity of message

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

exc - Throwable, the superclass of all errors and exceptions

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

traceThrowableT

public LogRecord traceThrowableT(int severity,
                                 Category cat,
                                 java.lang.String msg,
                                 java.lang.Throwable exc)

Deprecated. Not supported.

Trace message with stack trace of given exception, from the given category into this location.

Parameters:

severity - Severity of message

cat - Category message stems from

msg - Message template

exc - Throwable, the superclass of all errors and exceptions

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

traceThrowableT

public LogRecord traceThrowableT(int severity,
                                 Category cat,
                                 java.lang.String subloc,
                                 java.lang.String msg,
                                 java.lang.Throwable exc)

Deprecated. Not supported.

Trace message with stack trace of given exception, from the given category into this location.

Parameters:

severity - Severity of message

cat - Category message stems from

subloc - Name of sublocation

msg - Message template

exc - Throwable, the superclass of all errors and exceptions

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

traceThrowableT

public LogRecord traceThrowableT(int severity,
                                 Category cat,
                                 java.lang.String msg,
                                 java.lang.Object[] args,
                                 java.lang.Throwable exc)

Deprecated. Not supported.

Trace message with stack trace of given exception, from the given category into this loaction.

Parameters:

severity - Severity of message

cat - Category message stems from

msg - Message template

args - Arguments as object references

exc - Throwable, the superclass of all errors and exceptions

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

traceThrowableT

public LogRecord traceThrowableT(int severity,
                                 Category cat,
                                 java.lang.String subloc,
                                 java.lang.String msg,
                                 java.lang.Object[] args,
                                 java.lang.Throwable exc)

Deprecated. Not supported.

Trace message with stack trace of given exception, from the given category into this location.

Parameters:

severity - Severity of message

cat - Category message stems from

subloc - Name of sublocation

msg - Message template

args - Arguments as object references

exc - Throwable, the superclass of all errors and exceptions

Returns:

Log record if written via a log of this log controller or null

See Also:

LogController.setResourceBundleName(java.lang.String)

openGroup

public void openGroup(int severity)

Opens a message group from this location. After a call to this method a group message should be emitted, which becomes the opening message of this group.

Parameters:

severity - Severity of message group

See Also:

LogController.closeGroup()

openGroup

public void openGroup(int severity,
                      java.lang.String subloc)

Same as openGroup(int) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message group

subloc - Name of sublocation

See Also:

LogController.closeGroup()

openGroup

public void openGroup(int severity,
                      Category category)

Deprecated. This method is not supported anymore

Opens a message group of the specified category from this location. After a call to this method a group message should be emitted, which becomes the opening message of this group.

Parameters:

severity - Severity of message group

category - Category of message group

See Also:

LogController.closeGroup()

openGroup

public void openGroup(int severity,
                      Category category,
                      java.lang.String subloc)

Deprecated. This method is not supported anymore

Same as openGroup(int, Category) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message group

category - Category of message group

subloc - Name of sublocation

See Also:

LogController.closeGroup()

openGroup

public void openGroup(int severity,
                      Category[] categories)

Deprecated. This method is not supported anymore

Opens a message group of the specified categories from this location. After a call to this method a group message should be emitted, which becomes the opening message of this group.

Parameters:

severity - Severity of message group

categories - Categories of message group

See Also:

LogController.closeGroup()

openGroup

public void openGroup(int severity,
                      Category[] categories,
                      java.lang.String subloc)

Deprecated. This method is not supported anymore

Same as openGroup(int, Category[]) but appends a string denoting a sublocation to the name of this location.

Parameters:

severity - Severity of message group

categories - Categories of message group

subloc - Name of sublocation

See Also:

LogController.closeGroup()

setMinimumSeverity

public void setMinimumSeverity(Category relative,
                               int severity)

Sets the minimum severity of this location with respect to a category. If its current maximum severity is lower than the argument, the former is set to the argument. If it is the root location, this method has the same effect as a call to setEffectiveSeverity(Category, int).

Parameters:

severity - New minimum severity

setMinimumSeverity

public void setMinimumSeverity(Category relative)

Resets the minimum severity of this location with respect to a category. If it is the root location this method has no effect, otherwise it has the same effect as a call to setMinimumSeverity(Category, int) with Severity.ALL.

setEffectiveSeverity

public void setEffectiveSeverity(Category relative,
                                 int severity)

Sets the effective severity of this location with respect to a category. If it is the root location, this method sets the effective severity to its argument, otherwise it has the same effect as calls with its argument to both setMinimumSeverity(Category, int) and setMaximumSeverity(Category, int).

Parameters:

severity - New effective severity

setEffectiveSeverity

public void setEffectiveSeverity(Category relative)

Resets the effective severity of this location with respect to a category. If it is the root location this method has no effect, otherwise it has the same effect as two calls to setMinimumSeverity(Category) and setMaximumSeverity(Category).

setMaximumSeverity

public void setMaximumSeverity(Category relative,
                               int severity)

Sets the maximum severity of this location with respect to a category. If its current minimum severity is higher than the argument, the former is set to the argument. If it is the root location, this method has the same effect as a call to setEffectiveSeverity(Category, int).

Parameters:

severity - New maximum severity

setMaximumSeverity

public void setMaximumSeverity(Category relative)

Resets the maximum severity of this location with respect to a category. If it is the root location this method has no effect, otherwise it has the same effect as a call to setMaximumSeverity(Category, int) with Severity.ALL.