JSRs: Java Specification Requests
JSR 47: Logging API Specification
JCP version in use: 2.1
Java Specification Participation Agreement version in use: 1.0
Define standard logging APIs for the error and trace logging.
Please direct comments on this JSR to the Spec Lead(s)
The following information has been updated from the original proposal.
Maintenance Lead: Oracle America, Inc.
Contact: Danny Coward
E-mail address: danny.coward
Telephone: +1 408 276 7049
Section 1: Identification
Submitting Participant: Sun Microsystems Name of Contact Person: Graham Hamilton E-Mail Address: firstname.lastname@example.org Telephone Number: +1 408 343 1426 Fax Number: +1 408 863 3195 Submitting Participant: International Business Machines Name of Contact Person: Flavio Bergamaschi E-Mail Address: email@example.com
Section 2: Request
2.1 Please describe the proposed Specification:
A specification for logging APIs within the JavaTM platform. These APIs will be suitable for logging events from within the Java platform and from within Java applications.
It is envisaged that:
2.2 What is the target Java platform? (i.e., J2EE, J2SE, J2ME)
Java 2 Standard Edition.
2.3 What need of the Java community will be addressed by the proposed specification?
This specification is intended to allow field service engineers to obtain information to help diagnose application problems in the field. This includes configuration issues and performance problems as well as application failures. The APIs are intended to be used from both within the Java platform implementation and from within Java applications to provide logging and tracing information.
2.4 Why isn't this need met by existing specifications?
There are currently no general purpose logging or tracing APIs in the Java platform.
2.5 Please give a short description of the underlying technology or technologies:
Many operating systems provide some form of logging so that application programs can record key events, particularly on error conditions. It is desirable that the Java logging APIs should be able to interact with operating system logging services. In addition the logging APIs should enable logging to files or to network management services.
2.6 Is there a proposed package name for the API Specification?
2.7 Does the proposed specification have any dependencies on specific operating systems, CPUs, or I/O devices that you know of?
2.8 Are there any security issues that cannot be addressed by the current security model?
2.9 Are there any internationalization or localization issues?
Yes. The APIs should permit internationalization of the log messages.
2.10 Are there any existing specifications that might be rendered obsolete, deprecated, or in need of revision as a result of this work?
No. However it is anticipated that the implementations of various J2SE APIs will be updated to use the new logging APIs.
Section 3: Contributions