DPML Notify

[mcconnell AT dpml.net]

Author: mcconnell AT dpml.net
Date: Fri Jun 17 20:42:03 2005
New Revision: 2889

Added:
   development/main/metro/logging/   (props changed)
   development/main/metro/logging/build.xml
   development/main/metro/logging/src/
   development/main/metro/logging/src/main/
   development/main/metro/logging/src/main/net/
   development/main/metro/logging/src/main/net/dpml/
   development/main/metro/logging/src/main/net/dpml/logging/
   development/main/metro/logging/src/main/net/dpml/logging/Logger.java
Modified:
   development/main/metro/index.xml
Log:
Add logging api package.

Modified: development/main/metro/index.xml
==============================================================================
--- development/main/metro/index.xml    (original)
+++ development/main/metro/index.xml    Fri Jun 17 20:42:03 2005
@@ -35,6 +35,18 @@
     </info>
   </project>
 
+  <!-- Logging -->
+
+  <project basedir="logging">
+    <info>
+      <group>dpml/metro</group>
+      <name>dpml-logging-api</name>
+      <types>
+        <type>jar</type>
+      </types>
+    </info>
+  </project>
+
   <!-- Activity -->
 
   <project basedir="activity">

Added: development/main/metro/logging/build.xml
==============================================================================
--- (empty file)
+++ development/main/metro/logging/build.xml    Fri Jun 17 20:42:03 2005
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<project name="dpml-logging-api" default="install" basedir="." 
+    xmlns:transit="antlib:net.dpml.transit" >
+
+  <transit:import uri="artifact:template:dpml/magic/standard"/>
+
+</project>

Added: development/main/metro/logging/src/main/net/dpml/logging/Logger.java
==============================================================================
--- (empty file)
+++ development/main/metro/logging/src/main/net/dpml/logging/Logger.java      
  Fri Jun 17 20:42:03 2005
@@ -0,0 +1,95 @@
+/*
+ * Copyright 2004 Stephen J. McConnell.
+ *
+ * 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.
+ */
+
+package net.dpml.logging;
+
+/**
+ * Logger is a interface through which different logging solutions
+ * can be provided.  Typical examples of logging implementations include 
+ * java.util.logging.Logger or Ant's Project.log() function.  
+ *
+ * @author <a href="http://www.dpml.net";>The Digital Product Meta Library</a>
+ * @version $Id: Adapter.java 2445 2005-04-28 23:44:22Z niclas AT hedhman.org $
+ */
+public interface Logger
+{
+   /**
+    * Return TRUE is debug level logging is enabled.
+    * @return the enabled state of debug logging
+    */
+    boolean isDebugEnabled();
+
+   /**
+    * Return TRUE is info level logging is enabled.
+    * @return the enabled state of info logging
+    */
+    boolean isInfoEnabled();
+
+   /**
+    * Return TRUE is error level logging is enabled.
+    * @return the enabled state of error logging
+    */
+    boolean isErrorEnabled();
+
+   /**
+    * Record a debug level message.
+    * @param message the debug message to record
+    */
+    void debug( String message );
+
+   /**
+    * Record a informative message.
+    * @param message the info message to record
+    */
+    void info( String message );
+
+   /**
+    * Record a warning message.
+    * @param message the warning message to record
+    */
+    void warn( String message );
+
+   /**
+    * Record a warning message.
+    * @param message the warning message to record
+    * @param cause the causal exception
+    */
+    void warn( String message, Throwable cause );
+
+   /**
+    * Record a error level message.
+    * @param message the error message to record
+    */
+    void error( String message );
+
+   /**
+    * Record a error level message.
+    * @param message the error message to record
+    * @param cause the causal exception
+    */
+    void error( String message, Throwable cause );
+
+   /**
+    * Return a child logger relative to the current logger.
+    * @param category the relative category name
+    * @return the child logging channel
+    */
+    Logger getChildLogger( String category );
+}
+
+