Home of: [Atelier "FUJIGURUMA"] >> [PTLog hosted by SourceForge.net]

MAP	PTLog Documents > What PTLog is

SEE "For Readers of English Version",
or Japanese version of this page

What PTLog is

This document explains what PTLog is.

Watn PTLog brings

This section explains what PTLog brings to its user.

Underlying framework pluggability

PTLog allows you to plug(= choose) underlying logging framework whenever you want to do so.

This feature makes your implementation as logging framework neutral.

Please see tutorial "Plug into logging framework" and so on for detail about this feature.

Custom logging categories

You can define your custom logging categories. "Logging category" is almost as same as "logging level" in ordinary logging framework.

Please see tutorial "Customize log type" and so on for detail about this feature.

Type-based categorization

In PTLog, logging categories are mapped in Java class hierarchy. It is called "type-based" categorization as opposite of "scalar-value-based" categorization in ordinary logging frameworks.

This allows you to:

define new categories of which priorities are not strictly ordered
treat "derived" categories as same as "base" one

Please see tutorial "Customize log type" and so on for detail about this feature.

Value formatting

PTLog provides the way to format specified "values" in various style ("value" is not a part of logging record but a one of logging message).

For example, you can format int value in unsigned hex-decimal style.

Please see tutorial "Format values" and so on for detail about this feature.

Packing into one record

PTLog provides the way to pack plural values into one record without concatenation by "+" operator.

For example, you can pack all pairs of method parameter name and value into one loggin record.

Please see tutorial "Write client code" and so on for detail about this feature.

What PTLog does not bring

This section explains what PTLog does not bring to its user.

NOTE: PTLog, as products, also includes underlying logging framework, which is sample implementation with java.io.Writer.

But such implementation is not mainly focused one, so this section does not recognizes it as "What PTLog brings".

Output filterring

Decision and configuration to filter logging output are not responsibility of PTLog but one of underlying logging framework.

For example, Filter(of JDK Logging API and Apache Log4j) is used for this purpose.

But you will have to read tutorial "Customize log type" for delicate filterring.

Record formatting

Formatting of final logging record (e.g.: layout of date time, thead ID and message) is not responsibility of PTLog but one of underlying logging framework.

For example, SimpleFormatter(of JDK Logging API) and PatternLayout(of Apache Log4j) are used for this purpose.

Record writing out

Writing final logging record out is not responsibility of PTLog but one of underlying logging framework.

For example, ConsoleHandler(of JDK Logging API) and ConsoleAppender(of Apache Log4j) are used for this purpose.

MAP	PTLog Documents > What PTLog is