Migrate entity ownership to JDT annotations
[mdsal.git] / entityownership / mdsal-eos-dom-api / src / main / java / org / opendaylight / mdsal / eos / dom / api / DOMEntityOwnershipService.java
1 /*
2  * Copyright (c) 2015 Brocade Communications Systems, Inc. and others.  All rights reserved.
3  *
4  * This program and the accompanying materials are made available under the
5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6  * and is available at http://www.eclipse.org/legal/epl-v10.html
7  */
8 package org.opendaylight.mdsal.eos.dom.api;
9
10 import com.google.common.annotations.Beta;
11 import java.util.Optional;
12 import org.opendaylight.mdsal.eos.common.api.CandidateAlreadyRegisteredException;
13 import org.opendaylight.mdsal.eos.common.api.EntityOwnershipState;
14 import org.opendaylight.mdsal.eos.common.api.GenericEntityOwnershipService;
15 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
16
17 /**
18  * DOM version of {@link GenericEntityOwnershipService}.
19  *
20  * @author Thomas Pantelis
21  */
22 @Beta
23 public interface DOMEntityOwnershipService extends
24         GenericEntityOwnershipService<YangInstanceIdentifier, DOMEntity, DOMEntityOwnershipListener> {
25     @Override
26     DOMEntityOwnershipCandidateRegistration registerCandidate(DOMEntity entity)
27             throws CandidateAlreadyRegisteredException;
28
29     @Override
30     DOMEntityOwnershipListenerRegistration registerListener(String entityType,
31             DOMEntityOwnershipListener listener);
32
33     @Override
34     Optional<EntityOwnershipState> getOwnershipState(DOMEntity forEntity);
35
36     @Override
37     boolean isCandidateRegistered(DOMEntity forEntity);
38 }