org.opendaylight.lispflowmapping.interfaces.mappingservice

Interface IMappingService

public interface IMappingService

Mapping Service Java API.

Author:

Florin Coras

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	IMappingService.LookupPolicy

Method Summary

Modifier and Type	Method and Description
void	addAuthenticationKey(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key, org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.mapping.authkey.container.MappingAuthkey authKey) Add authentication key.
void	addData(MappingOrigin origin, org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key, String subKey, Object data) Generic addition of data.
void	addMapping(MappingOrigin origin, org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key, org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.SiteId siteId, org.opendaylight.lispflowmapping.lisp.type.MappingData mapping) Add mapping.
org.opendaylight.lispflowmapping.lisp.type.MappingData	addNegativeMapping(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key) Generate and add a negative mapping entry originated from the southbound, and return the generated mapping.
void	cleanCachedMappings() Cleans all cached mappings.Used for testing.
org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.mapping.authkey.container.MappingAuthkey	getAuthenticationKey(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key) Retrieve authentication key.
Object	getData(MappingOrigin origin, org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key, String subKey) Generic retrieval of data.
org.opendaylight.lispflowmapping.lisp.type.MappingData	getMapping(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key) Retrieves mapping for given key.The lookup policy for the key is defined in the Mapping System.
org.opendaylight.lispflowmapping.lisp.type.MappingData	getMapping(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid srcKey, org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid dstKey) Retrieves mapping with a Source/Dest policy.
org.opendaylight.lispflowmapping.lisp.type.MappingData	getMapping(MappingOrigin origin, org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key) Retrieves mapping with given origin for the provided key.
org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid	getParentPrefix(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key) Returns the parent prefix for given key.
org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid	getWidestNegativePrefix(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key) Retrieves widest negative prefix found in the Mapping System for given key.
boolean	isMaster() Get cluster master status.
String	printKeys() Print all authentication keys.
String	printMappings() Print all mappings.
void	refreshMappingRegistration(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key, org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.XtrId xtrId, Long timestamp) Refresh southbound mapping registration timestamp.
void	removeAuthenticationKey(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key) Remove authentication key.
void	removeData(MappingOrigin origin, org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key, String subKey) Generic removal of data.
void	removeMapping(MappingOrigin origin, org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key) Remove mapping.
void	setIsMaster(boolean isMaster) Set cluster master status.
void	setLookupPolicy(IMappingService.LookupPolicy policy) Configures Mapping Service mapping lookup policy option.
void	setMappingMerge(boolean mappingMerge) Configures Mapping Service mapping merge option.

Method Detail

addMapping

void addMapping(MappingOrigin origin,
                org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key,
                org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.SiteId siteId,
                org.opendaylight.lispflowmapping.lisp.type.MappingData mapping)

Add mapping.

Parameters:

origin - Table where mapping should be added

key - Key of the mapping

siteId - Site that stores the mapping

mapping - Mapping to be stored

addNegativeMapping

org.opendaylight.lispflowmapping.lisp.type.MappingData addNegativeMapping(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key)

Generate and add a negative mapping entry originated from the southbound, and return the generated mapping.

Parameters:

key - Key of the mapping

Returns:

Returns the generated negative mapping (which is never null).

getMapping

org.opendaylight.lispflowmapping.lisp.type.MappingData getMapping(MappingOrigin origin,
                                                                  org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key)

Retrieves mapping with given origin for the provided key. The lookup policy for the key is defined in the Mapping System.

Parameters:

origin - Table where the mapping should be looked up.

key - Key to be looked up

Returns:

Returns the mapping found in the Mapping System or null if nothing is found.

getMapping

org.opendaylight.lispflowmapping.lisp.type.MappingData getMapping(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key)

Retrieves mapping for given key.The lookup policy for the key is defined in the Mapping System.

Parameters:

key - Key to be looked up

Returns:

Returns the mapping found in the Mapping System or null if nothing is found.

getMapping

org.opendaylight.lispflowmapping.lisp.type.MappingData getMapping(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid srcKey,
                                                                  org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid dstKey)

Retrieves mapping with a Source/Dest policy. This method is meant to avoid the overhead of building LcafSourceDest addresses.

Parameters:

srcKey - Source key being looked up

dstKey - Destination key being looked up

Returns:

Returns the mapping found in the Mapping System or null if nothing is found.

getWidestNegativePrefix

org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid getWidestNegativePrefix(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key)

Retrieves widest negative prefix found in the Mapping System for given key.

Parameters:

key - Key being looked up

Returns:

Returns the widest negative prefix or null if nothing is found.

refreshMappingRegistration

void refreshMappingRegistration(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key,
                                org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.XtrId xtrId,
                                Long timestamp)

Refresh southbound mapping registration timestamp.

Parameters:

key - The EID whose registration must be refreshed

xtrId - xTR-ID of the mapping to be refreshed

timestamp - New timestamp for the mapping

removeMapping

void removeMapping(MappingOrigin origin,
                   org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key)

Remove mapping.

Parameters:

origin - Table from where the mapping should be removed

key - Key to be removed

addAuthenticationKey

void addAuthenticationKey(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key,
                          org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.mapping.authkey.container.MappingAuthkey authKey)

Add authentication key.

Parameters:

key - The key for which the authentication key is added

authKey - The authentication key

getAuthenticationKey

org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.mapping.authkey.container.MappingAuthkey getAuthenticationKey(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key)

Retrieve authentication key.

Parameters:

key - The key for which the authentication key is being looked up.

Returns:

The authentication key.

removeAuthenticationKey

void removeAuthenticationKey(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key)

Remove authentication key.

Parameters:

key - Key for which the authentication key should be removed.

addData

void addData(MappingOrigin origin,
             org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key,
             String subKey,
             Object data)

Generic addition of data. Not stored in MD-SAL datastore!

Parameters:

origin - Table where data should be inserted

key - The key where data should be inserted

subKey - The subKey where data should be inserted

data - The data to be stored

getData

Object getData(MappingOrigin origin,
               org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key,
               String subKey)

Generic retrieval of data.

Parameters:

origin - Table from where the data should be read

key - The key where the data is stored

subKey - The subKey where data is stored

Returns:

The data

removeData

void removeData(MappingOrigin origin,
                org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key,
                String subKey)

Generic removal of data.

Parameters:

origin - The table from where the data should be removed

key - The key of the data to be removed

subKey - The subKey of the data to be removed

getParentPrefix

org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid getParentPrefix(org.opendaylight.yang.gen.v1.urn.opendaylight.lfm.lisp.proto.rev151105.eid.container.Eid key)

Returns the parent prefix for given key.

Parameters:

key - The key which parent is to be returned.

Returns:

The parent perfix of a specific key.

setMappingMerge

void setMappingMerge(boolean mappingMerge)

Configures Mapping Service mapping merge option. If set to false, mappings with the same key are overwritten, otherwise, mappings with the same key but from different xTR-IDs are all stored.

Parameters:

mappingMerge - enables or disables mapping merge

setLookupPolicy

void setLookupPolicy(IMappingService.LookupPolicy policy)

Configures Mapping Service mapping lookup policy option.

Parameters:

policy - the policy to be activated

printMappings

String printMappings()

Print all mappings. Used for testing, debugging and the karaf shell.

Returns:

String consisting of all mappings

printKeys

String printKeys()

Print all authentication keys. Used for testing, debugging and the karaf shell.

Returns:

String consisting of all mappings

cleanCachedMappings

void cleanCachedMappings()

Cleans all cached mappings.Used for testing.

setIsMaster

void setIsMaster(boolean isMaster)

Set cluster master status.

Parameters:

isMaster - is|isn't master

isMaster

boolean isMaster()

Get cluster master status.

Returns:

isMaster is|isn't master