common/concepts/src/main/java/org/opendaylight/yangtools/concepts/Identifier.java

   1 /*
   2  * Copyright (c) 2013 Cisco 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.yangtools.concepts;
   9
  10 import java.io.Serializable;
  11 import javax.annotation.concurrent.ThreadSafe;
  12
  13 /**
  14  * General identifier interface. It is primarily a marker for all things that identify concepts -- such as names,
  15  * addresses, classes, etc. We do not require too much, just that the identifiers are serializable (and this
  16  * transferable).
  17  *
  18  * Implementations are expected to implement {@link #hashCode()} and {@link #equals(Object)} methods in a way, which
  19  * ensures that objects before and after serialization are considered equal.
  20  *
  21  * Implementations are advised to use the {@link java.io.Externalizable} Proxy pattern to allow future evolution
  22  * of their serialization format. For further efficiency, implementation should implement {@link WritableObject},
  23  * so they can be efficiently embedded in other {@link Serializable} objects.
  24  *
  25  * Note that this class is annotated as {@link ThreadSafe}, hence all implementations are expected to be thread-safe.
  26  */
  27 @ThreadSafe
  28 public interface Identifier extends Serializable, Immutable {
  29     @Override
  30     boolean equals(Object o);
  31
  32     @Override
  33     int hashCode();
  34
  35     @Override
  36     String toString();
  37 }
  38