org.apache.dubbo.common.extension

类 ExtensionLoader<T>

java.lang.Object

org.apache.dubbo.common.extension.ExtensionLoader<T>

public class ExtensionLoader<T>
extends Object

ApplicationModel, DubboBootstrap and this class are at present designed to be singleton or static (by itself totally static or uses some static fields). So the instances returned from them are of process or classloader scope. If you want to support multiple dubbo servers in a single process, you may need to refactor these three classes.

Load dubbo extensions

• auto inject dependency extension
• auto wrap extension in wrapper
• default extension is an adaptive instance

另请参阅:

Service Provider in Java 5, SPI, Adaptive, Activate

方法概要

限定符和类型	方法和说明
void	addExtension(String name, Class<?> clazz) Register new extension via API
static void	destroyAll() 已过时。
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() Return default extension, return null if it's not configured.
String	getDefaultExtensionName() Return default extension name, return null if not configured.
T	getExtension(String name) Find the extension with the given name.
T	getExtension(String name, boolean wrap)
static <T> ExtensionLoader<T>	getExtensionLoader(Class<T> type)
String	getExtensionName(Class<?> extensionClass)
String	getExtensionName(T extensionInstance)
Object	getLoadedAdaptiveExtensionInstances()
T	getLoadedExtension(String name) Get extension's instance.
List<T>	getLoadedExtensionInstances()
Set<String>	getLoadedExtensions() Return the list of extensions which are already loaded.
static List<LoadingStrategy>	getLoadingStrategies() Get all Loading Strategies
T	getOrDefaultExtension(String name) Get the extension by specified name if found, or returns the default one
T	getOriginalInstance(String name) get the original type.
Set<T>	getSupportedExtensionInstances()
Set<String>	getSupportedExtensions()
boolean	hasExtension(String name)
void	replaceExtension(String name, Class<?> clazz) 已过时。 not recommended any longer, and use only when test
static void	resetExtensionLoader(Class type) 已过时。
static void	setLoadingStrategies(LoadingStrategy... strategies)
String	toString()

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

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

方法详细资料

setLoadingStrategies

public static void setLoadingStrategies(LoadingStrategy... strategies)

getLoadingStrategies

public static List<LoadingStrategy> getLoadingStrategies()

Get all Loading Strategies

返回:

non-null

从以下版本开始:

2.7.7

另请参阅:

LoadingStrategy, Prioritized

getExtensionLoader

public static <T> ExtensionLoader<T> getExtensionLoader(Class<T> type)

resetExtensionLoader

@Deprecated
public static void resetExtensionLoader(Class type)

已过时。

destroyAll

@Deprecated
public static void destroyAll()

已过时。

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(org.apache.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(org.apache.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(org.apache.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)

Get extension's instance. Return null if extension is not found or is not initialized. Pls. note that this method will not trigger extension load.

In order to trigger extension load, call getExtension(String) instead.

另请参阅:

getExtension(String)

getLoadedExtensions

public Set<String> getLoadedExtensions()

Return the list of extensions which are already loaded.

Usually getSupportedExtensions() should be called in order to get all extensions.

另请参阅:

getSupportedExtensions()

getLoadedExtensionInstances

public List<T> getLoadedExtensionInstances()

getLoadedAdaptiveExtensionInstances

public Object getLoadedAdaptiveExtensionInstances()

getExtension

public T getExtension(String name)

Find the extension with the given name. If the specified name is not found, then IllegalStateException will be thrown.

getExtension

public T getExtension(String name,
                      boolean wrap)

getOriginalInstance

public T getOriginalInstance(String name)

get the original type.

参数:

name -

返回:

getOrDefaultExtension

public T getOrDefaultExtension(String name)

Get the extension by specified name if found, or returns the default one

参数:

name - the name of extension

返回:

non-null

getDefaultExtension

public T getDefaultExtension()

Return default extension, return null if it's not configured.

hasExtension

public boolean hasExtension(String name)

getSupportedExtensions

public Set<String> getSupportedExtensions()

getSupportedExtensionInstances

public Set<T> getSupportedExtensionInstances()

getDefaultExtensionName

public String getDefaultExtensionName()

Return default extension name, return null if not configured.

addExtension

public void addExtension(String name,
                         Class<?> clazz)

Register new extension via API

参数:

name - extension name

clazz - extension class

抛出:

IllegalStateException - when extension with the same name has already been registered.

replaceExtension

@Deprecated
public void replaceExtension(String name,
                                         Class<?> clazz)

已过时。 not recommended any longer, and use only when test

Replace the existing extension via API

参数:

name - extension name

clazz - extension class

抛出:

IllegalStateException - when extension to be placed doesn't exist

getAdaptiveExtension

public T getAdaptiveExtension()

toString

public String toString()

覆盖:

toString 在类中 Object