Show TOC

Background documentationTips and Tricks Locate this document in the navigation structure

 

What if the content of the properties file is invalid?

Normally, if the syntax or semantics is incorrect, or if there is spelling mistake, the configuration fails and prompts an error message. The tool continues to evaluate the subsequent configuration and outputs messages accordingly, based on whatever successful configuration that has been made.

The behavior results from the SAP Logging API error handling mechanism.

More information: Administrative Issues.

Automatic lookup of default properties file?

There is no system property to define this, nor there is a default physical file location specified for this. It is necessary to make one call in the program to load the properties.

Is there a possibility to define a Location and/or Category object in the file?

It is not necessary to create and maintain a category or a location object. These objects are always accessible by making calls, such as Category.getCategory() and Location.getLocation(). The rest is done by the logging framework.

It is a good practice to use a static variable to store the handle for better performance, in case the source objects to be frequently accessed.

Does the order of configuration matter?

In general, no. Not for class variable definition. Consider the following:

Syntax Syntax

  1. com.sapmarkets.foo.logs = + log[Console], log[File]
log[Console] = ConsoleLog
log[Console].formatter = ListFormatter
log[File] = FileLog
log[File].pattern = %t/trace.log
log[File].formatter = formatter[Trace]
formatter[Trace] = TraceFormatter
formatter[Trace].pattern = %s: %24d: %m
End of the code.
What will be the format of the output shown in the Console?

The use of '+' sign does not apply to log assignments specified in the current file configuration content. Therefore, the sequence is important and the FileLog has priority.

Note Note

Assuming that no previous configuration is available.

End of the note.

More information: Syntax and Semantics of the Properties File.

Syntax Syntax

  1. com.sapmarkets.foo.logs = + ConsoleLog
com.sapmarkets.foo.logs = + FileLog
End of the code.

If you want to assign multiple logs, use a comma as a delimiter:

Syntax Syntax

  1. com.sapmarkets.foo.logs = + ConsoleLog, FileLog
End of the code.