Logging interface

Supporting Java SE version 7 and up
dmccue128
Phidgetsian
Posts: 5
Joined: Sun Sep 03, 2017 5:47 am
Contact:

Logging interface

Postby dmccue128 » Sun Sep 03, 2017 6:09 am

Documentation page entitled, "Logging, Exceptions, and Errors", in the section labeled, "Logging", states:

"There are five different logging levels, ranging from "Give me Everything!" to "Tell me only about critical problems".
CRITICAL...ERROR...WARNING...INFO...VERBOSE"

But the text just above shows, "Log.enable(LogLevel.DEBUG, null);"
This seems to use a LogLevel.DEBUG which is not one of these five logging levels.

The documentation goes on to say, "These are available in the Enumerations section of Logging API in the Phidget22 API documentation". They are not.

Please explain the available logging levels.

User avatar
Patrick
Lead Developer
Posts: 3064
Joined: Mon Jun 20, 2005 8:46 am
Location: Canada
Contact:

Re: Logging interface

Postby Patrick » Wed Sep 06, 2017 1:41 pm

Debug log level is only active for debug library builds, so it's not useful to users - I'll update the document to reflect that.

For normal use, you'll want to use error, warning, or info levels. Critical is almost never used, and verbose produces too much output for anything other then library debugging.

The LogLevel enum is part of the logging API, and you will see it listed on the Logging API page - not sure what you mean by saying they are not there?

-Patrick

dmccue128
Phidgetsian
Posts: 5
Joined: Sun Sep 03, 2017 5:47 am
Contact:

Re: Logging interface

Postby dmccue128 » Thu Sep 07, 2017 5:32 am

Patrick, Thank you, the explanation is very clear.
You are correct the enumeration is present under the documentation for the logging API. I appreciate the help.


Return to “Java”

Who is online

Users browsing this forum: No registered users and 1 guest