LogFactory (onecode-common-client 1.1 API)

java.lang.Object
- com.ds.common.logging.LogFactory

直接已知子类:

LogFactoryImpl
```
public abstract class LogFactory
extends Object
```
Title: 常用代码打包

Description: Factory for creating Log instances.

Copyright: Copyright (c) 2006

Company: www.justdos.net

版本:

1.0

作者:

wenzhang li

字段概要

字段
限定符和类型	字段和说明
`protected String`	`configKey`
`protected static Map`	`factories` The previously constructed `LogFactory` instances, keyed by the `configKey` with which it was configed.
`static String`	`FACTORY_DEFAULT` The fully qualified class name of the fallback `LogFactory` implementation class to use, if no other can be found.

构造器概要

构造器
限定符构造器和说明

protected LogFactory()
Protected constructor that is not available for public use.

构造器
限定符	构造器和说明
`protected`	`LogFactory()` Protected constructor that is not available for public use.

方法概要

所有方法静态方法实例方法抽象方法具体方法
限定符和类型	方法和说明
`protected static ClassLoader`	`getContextClassLoader()` Return the thread context class loader if available.
`static LogFactory`	`getFactory(String configKey)` Construct (if necessary) and return a `LogFactory` instance.
`abstract Log`	`getInstance(Class clazz)` Convenience method to derive a name from the specified class and call `getInstance(String)` with it.
`abstract Log`	`getInstance(String name)` Construct (if necessary) and return a `Log` instance, using the factory's current set of configuration attributes.
`static Log`	`getLog(String configKey, Class clazz)` Convenience method to return a named logger, without the application having to care about factories.
`static Log`	`getLog(String configKey, String name)` Convenience method to return a named logger, without the application having to care about factories.
`protected static LogFactory`	`newFactory(String factoryClass, ClassLoader classLoader)` Return a new instance of the specified `LogFactory` implementation class, loaded by the specified class loader.
`abstract void`	`release()` Release any internal references to previously created `Log` instances returned by this factory.
`static void`	`release(String configKey)` Release any internal references to previously created `LogFactory` instances that have been associated with the specified class loader (if any), after calling the instance method `release()` on each of them.
`static void`	`releaseAll()` Release any internal references to previously created `LogFactory` instances, after calling the instance method `release()` on each of them.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - FACTORY_DEFAULT
```
public static final String FACTORY_DEFAULT
```
    The fully qualified class name of the fallback LogFactory implementation class to use, if no other can be found.
    
    另请参阅:
    
    常量字段值
  - configKey
```
protected String configKey
```
  - factories
```
protected static Map factories
```
    The previously constructed LogFactory instances, keyed by the configKey with which it was configed.
- 构造器详细资料
  - LogFactory
```
protected LogFactory()
```
    Protected constructor that is not available for public use.
- 方法详细资料
  - getInstance
```
public abstract Log getInstance(Class clazz)
                         throws LogConfigurationException
```
    Convenience method to derive a name from the specified class and call getInstance(String) with it.
    
    参数:
    
    clazz - Class for which a suitable Log name will be derived
    
    抛出:
    
    LogConfigurationException - if a suitable Log instance cannot be returned
  - getInstance
```
public abstract Log getInstance(String name)
                         throws LogConfigurationException
```
    Construct (if necessary) and return a Log instance, using the factory's current set of configuration attributes.
    
    NOTE - Depending upon the implementation of the LogFactory you are using, the Log 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.
    
    参数:
    
    name - Logical name of the Log instance to be returned (the meaning of this name is only known to the underlying logging implementation that is being wrapped)
    
    抛出:
    
    LogConfigurationException - if a suitable Log instance cannot be returned
  - release
```
public abstract void release()
```
    Release any internal references to previously created Log instances returned by this factory. This is useful environments like servlet containers, which implement application reloading by throwing away a ClassLoader. Dangling references to objects in that class loader would prevent garbage collection.
  - getFactory
```
public static LogFactory getFactory(String configKey)
                             throws LogConfigurationException
```
    Construct (if necessary) and return a LogFactory instance.
    
    抛出:
    
    LogConfigurationException - if the implementation class is not available or cannot be instantiated.
  - getLog
```
public static Log getLog(String configKey,
                         Class clazz)
                  throws LogConfigurationException
```
    Convenience method to return a named logger, without the application having to care about factories.
    
    参数:
    
    clazz - Class for which a log name will be derived
    
    抛出:
    
    LogConfigurationException - if a suitable Log instance cannot be returned
  - getLog
```
public static Log getLog(String configKey,
                         String name)
                  throws LogConfigurationException
```
    Convenience method to return a named logger, without the application having to care about factories.
    
    参数:
    
    name - Logical name of the Log instance to be returned (the meaning of this name is only known to the underlying logging implementation that is being wrapped)
    
    抛出:
    
    LogConfigurationException - if a suitable Log instance cannot be returned
  - release
```
public static void release(String configKey)
```
    Release any internal references to previously created LogFactory instances that have been associated with the specified class loader (if any), after calling the instance method release() on each of them.
    
    参数:
    
    classLoader - ClassLoader for which to release the LogFactory
  - releaseAll
```
public static void releaseAll()
```
    Release any internal references to previously created LogFactory instances, after calling the instance method release() on each of them. This is useful environments like servlet containers, which implement application reloading by throwing away a ClassLoader. Dangling references to objects in that class loader would prevent garbage collection.
  - getContextClassLoader
```
protected static ClassLoader getContextClassLoader()
                                            throws LogConfigurationException
```
    Return the thread context class loader if available. Otherwise return null. The thread context class loader is available for JDK 1.2 or later, if certain security conditions are met.
    
    抛出:
    
    LogConfigurationException - if a suitable class loader cannot be identified.
  - newFactory
```
protected static LogFactory newFactory(String factoryClass,
                                       ClassLoader classLoader)
                                throws LogConfigurationException
```
    Return a new instance of the specified LogFactory implementation class, loaded by the specified class loader. If that fails, try the class loader used to load this (abstract) LogFactory.
    
    参数:
    
    factoryClass - Fully qualified name of the LogFactory implementation class
    
    classLoader - ClassLoader from which to load this class
    
    抛出:
    
    LogConfigurationException - if a suitable instance cannot be created

类 LogFactory

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

FACTORY_DEFAULT

configKey

factories

构造器详细资料

LogFactory

方法详细资料

getInstance

getInstance

release

getFactory

getLog

getLog

release

releaseAll

getContextClassLoader

newFactory