Deprecate CheckedValue.orElseThrow(Supplier)
[yangtools.git] / common / concepts / src / main / java / org / opendaylight / yangtools / concepts / Identifier.java
index b673486196fbe34bfd453d24d42a1a5acdb402b4..694710505fb6ff4a8e2eb9e69384a53d1b418053 100644 (file)
@@ -8,26 +8,23 @@
 package org.opendaylight.yangtools.concepts;
 
 import java.io.Serializable;
-import javax.annotation.concurrent.ThreadSafe;
 
 /**
  * General identifier interface. It is primarily a marker for all things that identify concepts -- such as names,
- * addresses, classes, etc. We do not require too much, just that the identifiers are serializable (and this
+ * addresses, classes, etc. We do not require too much, just that the identifiers are serializable (and thus
  * transferable).
  *
- * Implementations are expected to implement {@link #hashCode()} and {@link #equals(Object)} methods in a way, which
- * ensures that objects before and after serialization are considered equal.
+ * <p>Implementations are expected to implement {@link #hashCode()} and {@link #equals(Object)} methods in a way,
+ * which ensures that objects before and after serialization are considered equal.
  *
- * Implementations are advised to use the {@link java.io.Externalizable} Proxy pattern to allow future evolution
- * of their serialization format. For further efficiency, implementation should implement {@link WritableObject},
- * so they can be efficiently embedded in other {@link Serializable} objects.
- *
- * Note that this class is annotated as {@link ThreadSafe}, hence all implementations are expected to be thread-safe.
+ * <p>Implementations are advised to use the {@link java.io.Externalizable} Proxy pattern to allow future evolution
+ * of their serialization format. For further efficiency, implementations should consider implementing
+ * {@link WritableObject}, so they can be efficiently embedded in other {@link Serializable} and {@code WritableObject}s
+ * objects.
  */
-@ThreadSafe
 public interface Identifier extends Serializable, Immutable {
     @Override
-    boolean equals(Object o);
+    boolean equals(Object obj);
 
     @Override
     int hashCode();