Code Review
/
controller.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
review
|
tree
raw
|
inline
| side by side
Add default implementation for AsyncWriteTransaction#commit
[controller.git]
/
opendaylight
/
md-sal
/
sal-common-api
/
src
/
main
/
java
/
org
/
opendaylight
/
controller
/
md
/
sal
/
common
/
api
/
clustering
/
EntityOwnershipService.java
diff --git
a/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/clustering/EntityOwnershipService.java
b/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/clustering/EntityOwnershipService.java
index 311d1b8595565eb2390b9aef15db10644d041514..8e34d80f4720554ddc51bef653651d4045a9f2ed 100644
(file)
--- a/
opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/clustering/EntityOwnershipService.java
+++ b/
opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/clustering/EntityOwnershipService.java
@@
-21,20
+21,25
@@
import javax.annotation.Nonnull;
* A component/application may also register interest in the ownership status of an Entity. The listener would be
* notified whenever the ownership status changes.
* </p>
* A component/application may also register interest in the ownership status of an Entity. The listener would be
* notified whenever the ownership status changes.
* </p>
+ *
+ * @deprecated Use org.opendaylight.mdsal.binding.api.clustering.EntityOwnershipService or
+ * org.opendaylight.mdsal.dom.api.clustering.DOMEntityOwnershipService instead
*/
*/
+@Deprecated
public interface EntityOwnershipService {
/**
* 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.
public interface EntityOwnershipService {
/**
* 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.
+ *
* <p>
* The registration is performed asynchronously and any registered {@link EntityOwnershipListener} is
* notified of ownership status changes for the entity.
*
* @param entity the entity which the Candidate wants to own
* @return a registration object that can be used to unregister the Candidate
* <p>
* The registration is performed asynchronously and any registered {@link EntityOwnershipListener} is
* notified of ownership status changes for the entity.
*
* @param entity the entity which the Candidate wants to own
* @return a registration object that can be used to unregister the Candidate
- * @throws
org.opendaylight.controller.md.sal.common.api.clustering.CandidateAlreadyRegisteredException
+ * @throws
CandidateAlreadyRegisteredException if the candidate is already registered
*/
EntityOwnershipCandidateRegistration registerCandidate(@Nonnull Entity entity)
throws CandidateAlreadyRegisteredException;
*/
EntityOwnershipCandidateRegistration registerCandidate(@Nonnull Entity entity)
throws CandidateAlreadyRegisteredException;
@@
-49,7
+54,8
@@
public interface EntityOwnershipService {
* @param listener the listener that is interested in the entities
* @return a registration object that can be used to unregister the Listener
*/
* @param listener the listener that is interested in the entities
* @return a registration object that can be used to unregister the Listener
*/
- EntityOwnershipListenerRegistration registerListener(@Nonnull String entityType, @Nonnull EntityOwnershipListener listener);
+ EntityOwnershipListenerRegistration registerListener(@Nonnull String entityType,
+ @Nonnull EntityOwnershipListener listener);
/**
* Gets the current ownership state information for an entity.
/**
* Gets the current ownership state information for an entity.
@@
-58,4
+64,12
@@
public interface EntityOwnershipService {
* @return an Optional EntityOwnershipState whose instance is present if the entity is found
*/
Optional<EntityOwnershipState> getOwnershipState(@Nonnull Entity forEntity);
* @return an Optional EntityOwnershipState whose instance is present if the entity is found
*/
Optional<EntityOwnershipState> getOwnershipState(@Nonnull Entity forEntity);
+
+ /**
+ * Check if a local candidate is registered for the given entity.
+ *
+ * @param entity the entity
+ * @return true if a candidate was registered locally, false otherwise
+ */
+ boolean isCandidateRegistered(@Nonnull Entity entity);
}
}