org.opendaylight.mdsal.eos.dom.simple

Class SimpleDOMEntityOwnershipService

java.lang.Object

org.opendaylight.mdsal.eos.dom.simple.SimpleDOMEntityOwnershipService

All Implemented Interfaces:

GenericEntityOwnershipService<org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier,DOMEntity,DOMEntityOwnershipListener>, DOMEntityOwnershipService

@MetaInfServices
public final class SimpleDOMEntityOwnershipService
extends Object
implements DOMEntityOwnershipService

Simple DOMEntityOwnershipService operating as an isolated island. It has no awareness of the world outside of itself.

Author:

Robert Varga

Constructor Summary

Constructors

Constructor and Description
SimpleDOMEntityOwnershipService()

Method Summary

Modifier and Type	Method and Description
Optional<EntityOwnershipState>	getOwnershipState(DOMEntity forEntity) Gets the current ownership state information for an entity.
boolean	isCandidateRegistered(DOMEntity forEntity) Checks if a local candidate is registered for the given entity.
DOMEntityOwnershipCandidateRegistration	registerCandidate(DOMEntity entity) Registers a candidate for ownership of the given entity.
DOMEntityOwnershipListenerRegistration	registerListener(String entityType, DOMEntityOwnershipListener listener) Registers a listener that is interested in ownership changes for entities of the given entity type.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SimpleDOMEntityOwnershipService

public SimpleDOMEntityOwnershipService()

Method Detail

registerCandidate

public DOMEntityOwnershipCandidateRegistration registerCandidate(DOMEntity entity)
                                                          throws CandidateAlreadyRegisteredException

Description copied from interface: GenericEntityOwnershipService

Registers a candidate for ownership of the given entity. Only one such request can be made per entity per process. If multiple requests for registering a candidate for a given entity are received in the current process a CandidateAlreadyRegisteredException will be thrown.

The registration is performed asynchronously and any registered entity ownership listener is notified of ownership status changes for the entity.

Specified by:

registerCandidate in interface GenericEntityOwnershipService<org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier,DOMEntity,DOMEntityOwnershipListener>

Specified by:

registerCandidate in interface DOMEntityOwnershipService

Parameters:

entity - the entity which the Candidate wants to own

Returns:

a registration object that can be used to unregister the Candidate

Throws:

CandidateAlreadyRegisteredException - if the candidate was already registered

registerListener

public DOMEntityOwnershipListenerRegistration registerListener(String entityType,
                                                               DOMEntityOwnershipListener listener)

Description copied from interface: GenericEntityOwnershipService

Registers a listener that is interested in ownership changes for entities of the given entity type. The listener is notified whenever its process instance is granted ownership of the entity and also whenever it loses ownership. On registration the listener will be notified of all entities its process instance currently owns at the time of registration.

Specified by:

registerListener in interface GenericEntityOwnershipService<org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier,DOMEntity,DOMEntityOwnershipListener>

Specified by:

registerListener in interface DOMEntityOwnershipService

Parameters:

entityType - the type of entities whose ownership status the Listener is interested in

listener - the listener that is interested in the entities

Returns:

a registration object that can be used to unregister the Listener

getOwnershipState

public Optional<EntityOwnershipState> getOwnershipState(DOMEntity forEntity)

Description copied from interface: GenericEntityOwnershipService

Gets the current ownership state information for an entity.

Specified by:

getOwnershipState in interface GenericEntityOwnershipService<org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier,DOMEntity,DOMEntityOwnershipListener>

Specified by:

getOwnershipState in interface DOMEntityOwnershipService

Parameters:

forEntity - the entity to query.

Returns:

an Optional EntityOwnershipState whose instance is present if the entity is found

isCandidateRegistered

public boolean isCandidateRegistered(DOMEntity forEntity)

Description copied from interface: GenericEntityOwnershipService

Checks if a local candidate is registered for the given entity.

Specified by:

isCandidateRegistered in interface GenericEntityOwnershipService<org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier,DOMEntity,DOMEntityOwnershipListener>

Specified by:

isCandidateRegistered in interface DOMEntityOwnershipService

Parameters:

forEntity - the entity to query.

Returns:

true if a candidate is registered locally, false otherwise

toString

public String toString()

Overrides:

toString in class Object