mogwee-logging

Mogwee Logging, a simple wrapper around Log4J

License	Apache License 2.0
Categories	Logging Application Layer Libs
GroupId	com.mogwee
ArtifactId	mogwee-logging
Last Version	1.0.0
Release Date	Jun 27, 2011
Type	jar
Description	mogwee-logging Mogwee Logging, a simple wrapper around Log4J
Project URL	https://github.com/twilliamson/mogwee-logging
Source Code Management	http://github.com/twilliamson/mogwee-logging/tree/master

Download mogwee-logging

Filename	Size
mogwee-logging-1.0.0.pom
mogwee-logging-1.0.0.jar	6 KB
mogwee-logging-1.0.0-sources.jar	3 KB
mogwee-logging-1.0.0-javadoc.jar	31 KB
mogwee-logging-1.0.0-jar-with-dependencies.jar	360 KB
mogwee-logging-1.0.0-jar-with-dependencies-sources.jar	412 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.mogwee/mogwee-logging/ -->
<dependency>
    <groupId>com.mogwee</groupId>
    <artifactId>mogwee-logging</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.mogwee/mogwee-logging/
implementation 'com.mogwee:mogwee-logging:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.mogwee/mogwee-logging/
implementation ("com.mogwee:mogwee-logging:1.0.0")

Apache Buildr

'com.mogwee:mogwee-logging:jar:1.0.0'

Apache Ivy

<dependency org="com.mogwee" name="mogwee-logging" rev="1.0.0">
  <artifact name="mogwee-logging" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.mogwee', module='mogwee-logging', version='1.0.0')
)

Scala SBT

libraryDependencies += "com.mogwee" % "mogwee-logging" % "1.0.0"

Leiningen

[com.mogwee/mogwee-logging "1.0.0"]

Dependencies

compile (1)

Group / Artifact	Type	Version
log4j : log4j	jar	1.2.13

test (1)

Group / Artifact	Type	Version
org.testng : testng	jar	5.8

Project Modules

There are no modules declared in this project.

Mogwee Logging, a simple wrapper around Log4J

Mogwee Logging is just a bunch of methods to make using Log4J nicer.

Maven Info

<dependency>
	<groupId>com.mogwee</groupId>
	<artifactId>mogwee-logging</artifactId>
	<version>1.0.0</version>
</dependency>

Usage

To construct a logger, add a static member variable to your class:

private static final Logger LOG = Logger.getLogger();

Logger.getLogger() does some magic to determine the calling class. (Specifically, it throws and catches an exception, then walks the stack trace.) As this is not the sort of thing you want (or need) to be doing hundreds of times a second, it will log a warning if it looks like it's not being called from a static constructor.

Once you have a logger, there are four logging levels: debug, info, warn, and error. For each level, there are four ways to log:

1. constant message

    LOG.debug("My message");
    LOG.warn("My message");
    LOG.info("My message");
    LOG.error("My message");
   

2. constant message with cause stack trace

    LOG.debug(e, "My message");
    LOG.warn(e, "My message");
    LOG.info(e, "My message");
    LOG.error(e, "My message");
   

3. formatted message:

    LOG.debugf("My message: %s", message);
    LOG.warnf("My message: %s", message);
    LOG.infof("My message: %s", message);
    LOG.errorf("My message: %s", message);
   

4. formatted message with cause stack trace

    LOG.debugf(e, "My message: %s", message);
    LOG.warnf(e, "My message: %s", message);
    LOG.infof(e, "My message: %s", message);
    LOG.errorf(e, "My message: %s", message);
   

For formatting, String.format() is used under the covers (but with enough smarts to not call it if the logging level isn't enabled).

There are also a couple more variants for the info, warn, and error levels:

1. constant message with cause stack trace logged only if debug is enabled

    LOG.warnDebug(e, "My message");
    LOG.infoDebug(e, "My message");
    LOG.errorDebug(e, "My message");
   

2. formatted message with cause stack trace logged only if debug is enabled

    LOG.warnDebugf(e, "My message: %s", message);
    LOG.infoDebugf(e, "My message: %s", message);
    LOG.errorDebugf(e, "My message: %s", message);
   

Dependencies

Mogwee Logging depends on Log4J, which is available in pretty much every Maven repository.

Build

mvn install

License (see COPYING file for full license)

Copyright 2011 Ning, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Versions

Version
1.0.0 Jun 27, 2011