org.opendaylight.mdsal.eos.common.api

Class GenericEntity<T extends org.opendaylight.yangtools.concepts.Path<T>>

java.lang.Object

org.opendaylight.mdsal.eos.common.api.GenericEntity<T>

Type Parameters:

T - the entity identifier type

All Implemented Interfaces:

Serializable, org.opendaylight.yangtools.concepts.Identifiable<T>

Direct Known Subclasses:

DOMEntity, Entity

public class GenericEntity<T extends org.opendaylight.yangtools.concepts.Path<T>>
extends Object
implements Serializable, org.opendaylight.yangtools.concepts.Identifiable<T>

A clustered Entity is something which is shared by multiple applications across a cluster. An Entity has a type and an identifier.

The type describes the type of the Entity where examples of a type maybe "openflow" or "netconf" etc. An Entity type could be tied to how exactly an application shares and "owns" an entity. For example we may want an application which deals with the openflow entity to be assigned ownership of that entity based on a first come first served basis. On the other hand for netconf entity types we may want applications to gain ownership based on a load balancing approach. While this mechanism of assigning a ownership acquisition strategy is not finalized the intention is that the entity type will play a role in determining the strategy and thus should be put in place.

The identifier is an instance identifier path. The reason for the choice of instance identifier path is because it can easily be used to represent a data node. For example an inventory node represents a shared entity and it is best referenced by its instance identifier path if the inventory node is stored in the data store.

Note that an entity identifier must conform to a valid yang schema. If there is no existing yang schema to represent an entity, the general-entity yang model can be used.

Author:

Thomas Pantelis

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	GenericEntity(@NonNull String type, T id)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
T	getIdentifier() Gets the id of the entity.
@NonNull String	getType() Gets the type of the entity.
int	hashCode()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

GenericEntity

protected GenericEntity(@NonNull String type,
                        T id)

Method Detail

getIdentifier

public final T getIdentifier()

Gets the id of the entity.

Specified by:

getIdentifier in interface org.opendaylight.yangtools.concepts.Identifiable<T extends org.opendaylight.yangtools.concepts.Path<T>>

Returns:

the id.

getType

public final @NonNull String getType()

Gets the type of the entity.

Returns:

the type.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object