Better (IMO) to open an "enhancement" bugzilla ticket and attach the classes
to that - also you could layout your proposal there and it won't get "lost"
in the list.
Niall
----- Original Message -----
From: "Richard Sitze" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Thursday, December 09, 2004 8:28 PM
Subject: [logging] Common Logging 2.0? EnterpriseLogFactory.java
> [Looks like the attachments got lost... Let's try them separately]
>
>
> package org.apache.commons.logging;
>
>
> /**
> * <p>Factory for creating [EMAIL PROTECTED] Log} and [EMAIL PROTECTED]
> EnterpriseLog}
> instances,
> * with discovery and configuration features similar to that employed by
> * standard Java APIs such as JAXP.</p>
> *
> * <p>Please note that a specific implementation of Commons Logging can
> choose
> * to support either the simple logging interface defined by [EMAIL
> PROTECTED] Log})
> or
> * the advanced logging interface defined by [EMAIL PROTECTED]
> EnterpriseLog}. A
> user
> * of a Common Logging implementation that supports only the simple
> logging
> * interface will not be able to instantiate a <code>EnterpriseLog</code>.
>
> * Conversely, a user of a Common Logging implementation that supports the
>
> * advanced logging interface will be able to instantiate either a
> <code>Log</code>
> * or <code>EnterpriseLog</code>.
> *
> */
> public abstract class EnterpriseLogFactory extends LogFactory{
>
>
> // ----------------------------------------------------- Manifest
> Constants
>
> // -----------------------------------------------------------
> Constructors
>
>
> /**
> * Protected constructor that is not available for public use.
> */
> protected EnterpriseLogFactory()
> {
> // TBD
> }
>
>
> // --------------------------------------------------------- Public
> Methods
>
> /**
> * <p>Construct (if necessary) and return a <code>EnterpriseLog</code>
> instance,
> * using the factory's current set of configuration attributes.</p>
> *
> * <p><strong>NOTE</strong> - Depending upon the implementation of
> * the <code>EnterpriseLogFactory</code> you are using, the
> * <code>EnterpriseLog</code> instance you are returned may or may
> * not be local to the current application, and may or may not be
> *returned again on a subsequent call with the same name argument.</p>
> *
> * @param name Logical name of the <code>EnterpriseLog</code> instance
> to be
> * returned (the meaning of this name is only known to the underlying
> * logging implementation that is being wrapped)
> *
> * @param resourceBundleName Logical name of the repository to use
> when
> * retrieving internationalized message text (the meaning of this
> name is
> * only known to the underlying logging implementation that is being
> wrapped,
> * but a common usage would be the name of a Java resources bundle)
> *
> * @exception LogConfigurationException if a suitable <code>Log</code>
> * instance cannot be returned
> */
> public abstract EnterpriseLog getEnterpriseInstance(String name,
> String resourceBundleName) throws LogConfigurationException;
>
>
> // --------------------------------------------------------- Static
> Methods
>
>
> /**
> * <p>Construct (if necessary) and return a
> <code>EnterpriseLogFactory</code>
> * instance, using the following ordered lookup procedure to determine
> * the name of the implementation class to be loaded.</p>
> * <ul>
> * <li>The <code>org.apache.commons.logging.LogFactory</code> system
> * property.</li>
> * <li>The JDK 1.3 Service Discovery mechanism</li>
> * <li>Use the properties file <code>commons-logging.properties</code>
> * file, if found in the class path of this class. The
> configuration
> * file is in standard <code>java.util.Properties</code> format
> and
> * contains the fully qualified name of the implementation class
> * with the key being the system property defined above.</li>
> * <li>Fall back to a default implementation class
> *
>
(<code>org.apache.commons.logging.impl.EnterpriseLogFactoryImpl</code>).</li
>
> * </ul>
> *
> * <p><em>NOTE</em> - If the properties file method of identifying the
> * <code>EnterpriseLogFactory</code> implementation class is utilized,
> all of the
> * properties defined in this file will be set as configuration
> attributes
> * on the corresponding <code>EnterpriseLogFactory</code>
> instance.</p>
> *
> * @exception LogConfigurationException if the implementation class is
> not
> * available or cannot be instantiated.
> */
> public static EnterpriseLogFactory getEnterpriseFactory()
> throws LogConfigurationException
> {
> // TBD
> }
>
>
> /**
> * Convenience method to return a named enterprise logger, without the
>
> * application having to care about factories.
> *
> * @param name Logical name of the <code>EnterpriseLog</code> instance
> to be
> * returned (the meaning of this name is only known to the underlying
> * logging implementation that is being wrapped)
> *
> *
> * @param resourceBundleName Logical name of the repository to use
> when
> * retrieving internationalized message text (the meaning of this
> name is
> * only known to the underlying logging implementation that is being
> wrapped,
> * but a common usage would be the name of a Java resources bundle)
> *
> * @exception LogConfigurationException if a suitable <code>Log</code>
> * instance cannot be returned
> */
> public static EnterpriseLog getEnterpriseLog(String name, String
> resourceBundleName)
> throws LogConfigurationException
> {
>
> return (getEnterpriseFactory().getEnterpriseInstance(name,
> resourceBundleName));
> }
>
>
> // ------------------------------------------------------ Protected
> Methods
>
> // TBD
> }
>
>
> *******************************************
> Richard A. Sitze
> IBM WebSphere WebServices Development
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
