commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From skitch...@apache.org
Subject svn commit: r177951 - /jakarta/commons/proper/logging/branches/simon-1.1/README.txt
Date Mon, 23 May 2005 11:01:16 GMT
Author: skitching
Date: Mon May 23 04:01:16 2005
New Revision: 177951

URL: http://svn.apache.org/viewcvs?rev=177951&view=rev
Log:
general info.

Added:
    jakarta/commons/proper/logging/branches/simon-1.1/README.txt   (with props)

Added: jakarta/commons/proper/logging/branches/simon-1.1/README.txt
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/logging/branches/simon-1.1/README.txt?rev=177951&view=auto
==============================================================================
--- jakarta/commons/proper/logging/branches/simon-1.1/README.txt (added)
+++ jakarta/commons/proper/logging/branches/simon-1.1/README.txt Mon May 23 04:01:16 2005
@@ -0,0 +1,51 @@
+The code here is an experiment based very heavily upon ideas from SLF4J/UGLI but 
+including the best of JCL too.
+
+The code is currently fairly rough around the edges. Complaints about minor 
+issues are not likely to be received with enthusiasm!
+
+The LogFactory and Log classes should be compatible with 99.99% of existing
+code that uses JCL. Code that *implements* adapters for libraries are simply
+not compatible - but that's not likely to be a major issue.
+
+Run "ant jcl-app" to generate the following jars in target:
+  * jcl-spi.jar
+  * jcl-NoOp.jar
+  * jcl-Simple.jar
+  * jcl-Jdk14.jar
+  * jcl-Log4J12.jar
+
+Ordinary applications just deploy jcl-spi.jar AND the appropriate
+jar for whatever library they want to bind to.
+
+In webserver environments:
+ * deploy jcl-spi *only once*, via a classloader that is not lower
+   than a jcl-XXXX adapter jar is deployed. 
+ * deploy jcl-XXXX adapter jars as often as desired.
+ * if you want code in non-leaf classloaders which use JCL to try
+   to log via loglibs in context classloaders, then set system
+   property "org.apache.commons.logging.context=true". Without
+   this, you get a true "static binding" where code always logs
+   to logging libs in their own classloader.
+
+
+I've got a basic test-harness that demonstrates things, but would
+prefer to turn it into unit tests before committing it. That should
+be coming soon..
+
+Benefits:
+ * no auto-detection of logging libs; you deploy jcl-xxx.jar, you
+   get logging via xxx. Well, unless you've enabled the "context"
+   feature in which case it might go to whatever jcl-yyy.jar is
+   deployed in the context classloader.
+ * very simple
+ * very fast
+ * very small code
+ * JDK1.1 compatible unless you enable the "context" feature. And
+   people shouldn't be running container environments on JDK1.1
+   anyway!
+ * compatible with almost all existing JCL users
+
+Regards,
+
+Simon

Propchange: jakarta/commons/proper/logging/branches/simon-1.1/README.txt
------------------------------------------------------------------------------
    svn:eol-style = native



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message