JarCastingDescription
This very simple module enhances the Play! Framework logs to bring some missing information such as the class name, the method name where the log has been called, its signature, the file name and the line.
How to use it
- Clone this module in somedirectory/betterlogs
- Add this module to your application.conf
- Customize the log pattern if you want
Example:
module.betterlogs=somedirectory/betterlogs
# Custom prefix (this is the default one)
betterlogs.prefix=[%relativeFile:%line] %method() ::
# Append 2 spaces at the end of the pattern
betterlogs.prefix.trailingSpaces=2
In your code, the following call
Logger.info("got %s messages from %s", 2, "[email protected]");
will give you
12:47:05,499 INFO ~ [/app/controllers/Application.java:10] index() :: got 2 messages from [email protected]
Pattern elements
You can add the following elements to the prefix pattern :
- %file : the file where the log has been called (the file path relative to the play application, ex:
/app/controllers/Application.java) - %relativeFile : the file where the log has been declared (just the file name; ex:
Application.java) - %line : the line of the file where the log has been called
- %class : the class in which the log has been called (canonical name, ex:
controllers.Application) - %simpleClass : the class in which the log has been called (simple name, ex:
Application) - %package : the package of the class where the log has been called
- %method : the name of the method in which the log has been called
- %signature : the signature of the method in which the log has been called (ex:
(Ljava/lang/String;Lplay/Logger;I)V)
Options
You can disable BetterLogs with the @betterlogs.disabled@ option :
betterlogs.disabled=true
If you enable or disable BetterLogs, do not forget to clean your app before restarting Play, to force the framework to enhance all the classes again.
Use with log4j
This module just prepends a string matching the prefix pattern to log string. So it does not conflict with the log4j config file even if you redefine it.
Future features
- print some action information (like http params, action name, cookies, etc.)