MultiAppLoggerSpaceManager (sofa-common-tools 1.0.17 API)

java.lang.Object
- com.alipay.sofa.common.log.MultiAppLoggerSpaceManager

```
public class MultiAppLoggerSpaceManager
extends Object
```
Created by kevin.luy@alipay.com on 2016/12/7. Updated by guanchao.ygc@alibaba-inc.com on 14/04/28.

构造器概要

构造器
构造器和说明

MultiAppLoggerSpaceManager()

构造器
构造器和说明
`MultiAppLoggerSpaceManager()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static org.slf4j.Logger`	`getLoggerBySpace(String name, SpaceId spaceId)` 从 spaceName 的空间里寻找logger对象（而且这些 logger 是从该 spaceName 下的日志实现配置中解析而来)
`static org.slf4j.Logger`	`getLoggerBySpace(String name, SpaceId spaceId, ClassLoader spaceClassloader)` 从 spaceName 的空间里寻找logger对象（而且这些 logger 是从该 spaceName 下的日志实现配置中解析而来)
`static org.slf4j.Logger`	`getLoggerBySpace(String name, String spaceName)` 从 spaceName 的空间里寻找logger对象（而且这些 logger 是从该 spaceName 下的日志实现配置中解析而来)
`static org.slf4j.Logger`	`getLoggerBySpace(String name, String spaceName, ClassLoader spaceClassloader)` 从 spaceName 的空间里寻找logger对象（而且这些 logger 是从该 spaceName 下的日志实现配置中解析而来)
`static Map<SpaceId,SpaceInfo>`	`getSpacesMap()`
`static void`	`init(SpaceId spaceId, Map<String,String> props)` 非必要初始化操作。
`static void`	`init(String spaceName, Map<String,String> props)` 非必要初始化操作。
`static boolean`	`isSpaceInitialized(SpaceId spaceId)` 用于并发场景非严格判断space是否init用；该场景中不和初始化场景锁同步，也就是不保证并发时严格判断正确；
`static boolean`	`isSpaceInitialized(String spaceName)` 用于并发场景非严格判断space是否init用；该场景中不和初始化场景锁同步，也就是不保证并发时严格判断正确；
`static org.slf4j.ILoggerFactory`	`removeILoggerFactoryBySpaceId(SpaceId spaceId)` 根据 spaceId 在日志空间里移除指定 spaceName 的 ILoggerFactory
`static org.slf4j.ILoggerFactory`	`removeILoggerFactoryBySpaceName(String spaceName)` 根据 spaceName 在日志空间里移除指定 spaceName 的 ILoggerFactory
`static org.slf4j.Logger`	`setLoggerLevel(String loggerName, SpaceId spaceId, AdapterLevel adapterLevel)` 更新日志级别,屏蔽底层差异
`static org.slf4j.Logger`	`setLoggerLevel(String loggerName, String spaceName, AdapterLevel adapterLevel)` 更新日志级别,屏蔽底层差异

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

- 构造器详细资料
  - MultiAppLoggerSpaceManager
```
public MultiAppLoggerSpaceManager()
```
- 方法详细资料
  - init
```
public static void init(String spaceName,
                        Map<String,String> props)
```
    非必要初始化操作。（如果需要为某些space定义特殊的变量，则必须先初始化该方法）。
    "非必要"，是因为：getLoggerBySpace默认也会执行init操作；
    使用 MultiAppLoggerSpaceManager API 建议一定要执行初始化操作即调用这个方法
    
    参数:
    
    props - 替换log xml中占位符，如果与 System.props 重复定义，优先以 System.props 配置为准；
  - init
```
public static void init(SpaceId spaceId,
                        Map<String,String> props)
```
    非必要初始化操作。（如果需要为某些space定义特殊的变量，则必须先初始化该方法）。
    "非必要"，是因为：getLoggerBySpace默认也会执行init操作；
    使用 MultiAppLoggerSpaceManager API 建议一定要执行初始化操作即调用这个方法
  - getLoggerBySpace
```
public static org.slf4j.Logger getLoggerBySpace(String name,
                                                String spaceName)
```
    从 spaceName 的空间里寻找logger对象（而且这些 logger 是从该 spaceName 下的日志实现配置中解析而来)
    
    参数:
    
    name - loggerName
    
    spaceName - 独立的loggers空间,比如"com.alipay.sofa.rpc"；
    
    返回:
    
    org.slf4j.Logger;
  - getLoggerBySpace
```
public static org.slf4j.Logger getLoggerBySpace(String name,
                                                SpaceId spaceId)
```
    从 spaceName 的空间里寻找logger对象（而且这些 logger 是从该 spaceName 下的日志实现配置中解析而来)
    
    参数:
    
    name - loggerName
    
    spaceId - 独立的loggers空间
    
    返回:
    
    org.slf4j.Logger;
  - setLoggerLevel
```
public static org.slf4j.Logger setLoggerLevel(String loggerName,
                                              String spaceName,
                                              AdapterLevel adapterLevel)
```
    更新日志级别,屏蔽底层差异
    
    参数:
    
    loggerName - 要更新的日志名字
    
    spaceName - 日志对应的空间名称
    
    adapterLevel - 要更新的日志级别
    
    返回:
    
    更新级别后的日志, 与com.alipay.sofa.common.log.MultiAppLoggerSpaceManager#getLoggerBySpace(java.lang.String, java.lang.String) 返回的同一个日志
  - setLoggerLevel
```
public static org.slf4j.Logger setLoggerLevel(String loggerName,
                                              SpaceId spaceId,
                                              AdapterLevel adapterLevel)
```
    更新日志级别,屏蔽底层差异
    
    参数:
    
    loggerName - 要更新的日志名字
    
    spaceId - 日志对应的空间名称
    
    adapterLevel - 要更新的日志级别
    
    返回:
    
    更新级别后的日志, 与com.alipay.sofa.common.log.MultiAppLoggerSpaceManager#getLoggerBySpace(java.lang.String, java.lang.String) 返回的同一个日志
  - getLoggerBySpace
```
public static org.slf4j.Logger getLoggerBySpace(String name,
                                                String spaceName,
                                                ClassLoader spaceClassloader)
```
    从 spaceName 的空间里寻找logger对象（而且这些 logger 是从该 spaceName 下的日志实现配置中解析而来)
    
    参数:
    
    name - loggerName
    
    spaceName - 独立的loggers空间,比如"com.alipay.sofa.rpc"；
    
    spaceClassloader - 该空间下独立的类加载器；（建议就是 APPClassloader 即可）
    
    返回:
    
    org.slf4j.Logger;
  - getLoggerBySpace
```
public static org.slf4j.Logger getLoggerBySpace(String name,
                                                SpaceId spaceId,
                                                ClassLoader spaceClassloader)
```
    从 spaceName 的空间里寻找logger对象（而且这些 logger 是从该 spaceName 下的日志实现配置中解析而来)
    
    参数:
    
    name - loggerName
    
    spaceId - 独立的loggers空间
    
    spaceClassloader - 该空间下独立的类加载器；（建议就是 APPClassloader 即可）
    
    返回:
    
    org.slf4j.Logger;
  - removeILoggerFactoryBySpaceName
```
public static org.slf4j.ILoggerFactory removeILoggerFactoryBySpaceName(String spaceName)
```
    根据 spaceName 在日志空间里移除指定 spaceName 的 ILoggerFactory
    
    参数:
    
    spaceName - 指定的日志空间名称
    
    返回:
    
    被移除的 ILoggerFactory;不存在指定的 spaceName,则返回 null
  - removeILoggerFactoryBySpaceId
```
public static org.slf4j.ILoggerFactory removeILoggerFactoryBySpaceId(SpaceId spaceId)
```
    根据 spaceId 在日志空间里移除指定 spaceName 的 ILoggerFactory
    
    参数:
    
    spaceId - 指定的日志空间名称
    
    返回:
    
    被移除的 ILoggerFactory;不存在指定的 spaceName,则返回 null
  - isSpaceInitialized
```
public static boolean isSpaceInitialized(String spaceName)
```
    用于并发场景非严格判断space是否init用；该场景中不和初始化场景锁同步，也就是不保证并发时严格判断正确；
    
    参数:
    
    spaceName -
    
    返回:
  - isSpaceInitialized
```
public static boolean isSpaceInitialized(SpaceId spaceId)
```
    用于并发场景非严格判断space是否init用；该场景中不和初始化场景锁同步，也就是不保证并发时严格判断正确；
    
    参数:
    
    spaceId -
    
    返回:
  - getSpacesMap
```
public static Map<SpaceId,SpaceInfo> getSpacesMap()
```

类 MultiAppLoggerSpaceManager

构造器概要

方法概要

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

构造器详细资料

MultiAppLoggerSpaceManager

方法详细资料

init

init

getLoggerBySpace

getLoggerBySpace

setLoggerLevel

setLoggerLevel

getLoggerBySpace

getLoggerBySpace

removeILoggerFactoryBySpaceName

removeILoggerFactoryBySpaceId

isSpaceInitialized

isSpaceInitialized

getSpacesMap