2 * Copyright (c) 2015 Cisco Systems, Inc. and others. All rights reserved.
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
9 package org.opendaylight.controller.md.sal.common.api.clustering;
11 import com.google.common.base.Preconditions;
12 import java.io.Serializable;
13 import javax.annotation.Nonnull;
14 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
18 * A clustered Entity is something which is shared by multiple applications across a cluster. An Entity has a type
22 * The type describes the type of the Entity where examples of a type maybe "openflow" or "netconf"
23 * etc. An Entity type could be tied to how exactly an application shares and "owns" an entity. For example we may want
24 * an application which deals with the openflow entity to be assigned ownership of that entity based on a first come
25 * first served basis. On the other hand for netconf entity types we may want applications to gain ownership based on
26 * a load balancing approach. While this mechanism of assigning a ownership acquisition strategy is not finalized the
27 * intention is that the entity type will play a role in determining the strategy and thus should be put in place.
30 * The identifier is a YangInstanceIdentifier. The reason for the choice of YangInstanceIdentifier is because it
31 * can easily be used to represent a data node. For example an inventory node represents a shared entity and it is best
32 * referenced by the YangInstanceIdentifier if the inventory node stored in the data store.
35 public final class Entity implements Serializable {
36 private static final long serialVersionUID = 1L;
38 private final String type;
39 private final YangInstanceIdentifier id;
42 * Construct a new Entity
44 * @param type the type of the entity
45 * @param id the identifier of the entity
47 public Entity(@Nonnull String type, @Nonnull YangInstanceIdentifier id) {
48 this.type = Preconditions.checkNotNull(type, "type should not be null");
49 this.id = Preconditions.checkNotNull(id, "id should not be null");
54 * @return id of entity
57 public YangInstanceIdentifier getId(){
63 * @return type of entity
66 public String getType(){
71 public boolean equals(Object o) {
76 if (o == null || getClass() != o.getClass()) {
80 Entity entity = (Entity) o;
82 if (!id.equals(entity.id)) {
86 if (!type.equals(entity.type)) {
94 public int hashCode() {
95 return 31 * type.hashCode() + id.hashCode();
99 public String toString() {
100 final StringBuilder sb = new StringBuilder("Entity{");
101 sb.append("type='").append(type).append('\'');
102 sb.append(", id=").append(id);
104 return sb.toString();