org.apache.dubbo.metadata

Interface ServiceNameMapping

All Superinterfaces:

org.apache.dubbo.rpc.service.Destroyable

All Known Implementing Classes:

AbstractServiceNameMapping

@SPI(value="metadata",
     scope=APPLICATION)
public interface ServiceNameMapping
extends org.apache.dubbo.rpc.service.Destroyable

This will interact with remote metadata center to find the interface-app mapping and will cache the data locally. Call variants of getCachedMapping() methods whenever need to use the mapping data.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_MAPPING_GROUP

Method Summary

Modifier and Type	Method and Description
static String	buildGroup(String serviceInterface)
static String	buildMappingKey(org.apache.dubbo.common.URL url)
Set<String>	getAndListen(org.apache.dubbo.common.URL registryURL, org.apache.dubbo.common.URL subscribedURL, MappingListener listener) Get the latest mapping result from remote center and register listener at the same time to get notified once mapping changes.
static Set<String>	getAppNames(String content)
Map<String,Set<String>>	getCachedMapping()
Set<String>	getCachedMapping(String mappingKey)
Set<String>	getCachedMapping(org.apache.dubbo.common.URL consumerURL)
static ServiceNameMapping	getDefaultExtension(org.apache.dubbo.rpc.model.ScopeModel scopeModel) Get the default extension of ServiceNameMapping
void	initInterfaceAppMapping(org.apache.dubbo.common.URL subscribedURL) Init the mapping data from local storage and url parameter.
boolean	map(org.apache.dubbo.common.URL url) Map the specified Dubbo service interface, group, version and protocol to current Dubbo service name
void	putCachedMapping(String serviceKey, Set<String> apps)
Set<String>	removeCachedMapping(String serviceKey)
MappingListener	stopListen(org.apache.dubbo.common.URL subscribeURL, MappingListener listener)
static String	toStringKeys(Set<String> serviceNames)

Methods inherited from interface org.apache.dubbo.rpc.service.Destroyable

$destroy

Field Detail

DEFAULT_MAPPING_GROUP

static final String DEFAULT_MAPPING_GROUP

See Also:

Constant Field Values

Method Detail

map

boolean map(org.apache.dubbo.common.URL url)

Map the specified Dubbo service interface, group, version and protocol to current Dubbo service name

getDefaultExtension

static ServiceNameMapping getDefaultExtension(org.apache.dubbo.rpc.model.ScopeModel scopeModel)

Get the default extension of ServiceNameMapping

Returns:

non-null ServiceNameMapping

buildMappingKey

static String buildMappingKey(org.apache.dubbo.common.URL url)

buildGroup

static String buildGroup(String serviceInterface)

toStringKeys

static String toStringKeys(Set<String> serviceNames)

getAppNames

static Set<String> getAppNames(String content)

initInterfaceAppMapping

void initInterfaceAppMapping(org.apache.dubbo.common.URL subscribedURL)

Init the mapping data from local storage and url parameter.

getAndListen

Set<String> getAndListen(org.apache.dubbo.common.URL registryURL,
                         org.apache.dubbo.common.URL subscribedURL,
                         MappingListener listener)

Get the latest mapping result from remote center and register listener at the same time to get notified once mapping changes.

Parameters:

listener - listener that will be notified on mapping change

Returns:

the latest mapping result from remote center

stopListen

MappingListener stopListen(org.apache.dubbo.common.URL subscribeURL,
                           MappingListener listener)

putCachedMapping

void putCachedMapping(String serviceKey,
                      Set<String> apps)

getCachedMapping

Set<String> getCachedMapping(String mappingKey)

getCachedMapping

Set<String> getCachedMapping(org.apache.dubbo.common.URL consumerURL)

getCachedMapping

Map<String,Set<String>> getCachedMapping()

removeCachedMapping

Set<String> removeCachedMapping(String serviceKey)