ExtensionLoader (Dubbo 2.5.4 API)

java.lang.Object
- com.alibaba.dubbo.common.extension.ExtensionLoader<T>

```
public class ExtensionLoader<T>
extends Object
```
Dubbo使用的扩展点获取。
- 自动注入关联扩展点。
- 自动Wrap上扩展点的Wrap类。
- 缺省获得的的扩展点是一个Adaptive Instance。
作者:

william.liangf, ding.lid

另请参阅:

JDK5.0的自动发现机制实现, SPI, Adaptive, Activate

方法概要

所有方法静态方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`void`	`addExtension(String name, Class<?> clazz)` 编程方式添加新扩展点。
`List<T>`	`getActivateExtension(URL url, String key)` This is equivalent to getActivateExtension(url, key, null);
`List<T>`	`getActivateExtension(URL url, String[] values)` This is equivalent to getActivateExtension(url, values, null);
`List<T>`	`getActivateExtension(URL url, String[] values, String group)` Get activate extensions.
`List<T>`	`getActivateExtension(URL url, String key, String group)` This is equivalent to getActivateExtension(url, url.getParameter(key).split(","), null);
`T`	`getAdaptiveExtension()`
`T`	`getDefaultExtension()` 返回缺省的扩展，如果没有设置则返回`null`。
`String`	`getDefaultExtensionName()` 返回缺省的扩展点名，如果没有设置缺省则返回`null`。
`T`	`getExtension(String name)` 返回指定名字的扩展。
`static <T> ExtensionLoader<T>`	`getExtensionLoader(Class<T> type)`
`String`	`getExtensionName(Class<?> extensionClass)`
`String`	`getExtensionName(T extensionInstance)`
`T`	`getLoadedExtension(String name)` 返回扩展点实例，如果没有指定的扩展点或是还没加载（即实例化）则返回`null`。
`Set<String>`	`getLoadedExtensions()` 返回已经加载的扩展点的名字。
`Set<String>`	`getSupportedExtensions()`
`boolean`	`hasExtension(String name)`
`void`	`replaceExtension(String name, Class<?> clazz)` 已过时。不推荐应用使用，一般只在测试时可以使用
`String`	`toString()`

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

- 方法详细资料
  - getExtensionLoader
```
public static <T> ExtensionLoader<T> getExtensionLoader(Class<T> type)
```
  - getExtensionName
```
public String getExtensionName(T extensionInstance)
```
  - getExtensionName
```
public String getExtensionName(Class<?> extensionClass)
```
  - getActivateExtension
```
public List<T> getActivateExtension(URL url,
                                    String key)
```
    This is equivalent to
```
     getActivateExtension(url, key, null);
 
```
    参数:
    
    url - url
    
    key - url parameter key which used to get extension point names
    
    返回:
    
    extension list which are activated.
    
    另请参阅:
    
    getActivateExtension(com.alibaba.dubbo.common.URL, String, String)
  - getActivateExtension
```
public List<T> getActivateExtension(URL url,
                                    String[] values)
```
    This is equivalent to
```
     getActivateExtension(url, values, null);
 
```
    参数:
    
    url - url
    
    values - extension point names
    
    返回:
    
    extension list which are activated
    
    另请参阅:
    
    getActivateExtension(com.alibaba.dubbo.common.URL, String[], String)
  - getActivateExtension
```
public List<T> getActivateExtension(URL url,
                                    String key,
                                    String group)
```
    This is equivalent to
```
     getActivateExtension(url, url.getParameter(key).split(","), null);
 
```
    参数:
    
    url - url
    
    key - url parameter key which used to get extension point names
    
    group - group
    
    返回:
    
    extension list which are activated.
    
    另请参阅:
    
    getActivateExtension(com.alibaba.dubbo.common.URL, String[], String)
  - getActivateExtension
```
public List<T> getActivateExtension(URL url,
                                    String[] values,
                                    String group)
```
    Get activate extensions.
    
    参数:
    
    url - url
    
    values - extension point names
    
    group - group
    
    返回:
    
    extension list which are activated
    
    另请参阅:
    
    Activate
  - getLoadedExtension
```
public T getLoadedExtension(String name)
```
    返回扩展点实例，如果没有指定的扩展点或是还没加载（即实例化）则返回null。注意：此方法不会触发扩展点的加载。
    一般应该调用getExtension(String)方法获得扩展，这个方法会触发扩展点加载。
    
    另请参阅:
    
    getExtension(String)
  - getLoadedExtensions
```
public Set<String> getLoadedExtensions()
```
    返回已经加载的扩展点的名字。
    一般应该调用getSupportedExtensions()方法获得扩展，这个方法会返回所有的扩展点。
    
    另请参阅:
    
    getSupportedExtensions()
  - getExtension
```
public T getExtension(String name)
```
    返回指定名字的扩展。如果指定名字的扩展不存在，则抛异常 IllegalStateException.
    
    参数:
    
    name -
    
    返回:
  - getDefaultExtension
```
public T getDefaultExtension()
```
    返回缺省的扩展，如果没有设置则返回null。
  - hasExtension
```
public boolean hasExtension(String name)
```
  - getSupportedExtensions
```
public Set<String> getSupportedExtensions()
```
  - getDefaultExtensionName
```
public String getDefaultExtensionName()
```
    返回缺省的扩展点名，如果没有设置缺省则返回null。
  - addExtension
```
public void addExtension(String name,
                         Class<?> clazz)
```
    编程方式添加新扩展点。
    
    参数:
    
    name - 扩展点名
    
    clazz - 扩展点类
    
    抛出:
    
    IllegalStateException - 要添加扩展点名已经存在。
  - replaceExtension
```
@Deprecated
public void replaceExtension(String name,
                                         Class<?> clazz)
```
    已过时。不推荐应用使用，一般只在测试时可以使用
    
    编程方式添加替换已有扩展点。
    
    参数:
    
    name - 扩展点名
    
    clazz - 扩展点类
    
    抛出:
    
    IllegalStateException - 要添加扩展点名已经存在。
  - getAdaptiveExtension
```
public T getAdaptiveExtension()
```
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object

类 ExtensionLoader<T>

方法概要

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

方法详细资料

getExtensionLoader

getExtensionName

getExtensionName

getActivateExtension

getActivateExtension

getActivateExtension

getActivateExtension

getLoadedExtension

getLoadedExtensions

getExtension

getDefaultExtension

hasExtension

getSupportedExtensions

getDefaultExtensionName

addExtension

replaceExtension

getAdaptiveExtension

toString