Allow SnapshotBackedReadTransaction customization
[controller.git] / opendaylight / md-sal / sal-dom-spi / src / main / java / org / opendaylight / controller / sal / core / spi / data / AbstractDOMStoreTransaction.java
index 106abca3ec44fd674c54dfe282a8eb8c73ba7ff0..20166a46ad97f1fff356a62844833c6b3ddc0607 100644 (file)
@@ -7,34 +7,37 @@
  */
 package org.opendaylight.controller.sal.core.spi.data;
 
+import static java.util.Objects.requireNonNull;
+
 import com.google.common.annotations.Beta;
 import com.google.common.base.MoreObjects;
 import com.google.common.base.MoreObjects.ToStringHelper;
-import com.google.common.base.Preconditions;
-import javax.annotation.Nonnull;
-import javax.annotation.Nullable;
+import org.eclipse.jdt.annotation.NonNull;
+import org.eclipse.jdt.annotation.Nullable;
 
 /**
  * Abstract DOM Store Transaction.
  *
+ * <p>
  * Convenience super implementation of DOM Store transaction which provides
  * common implementation of {@link #toString()} and {@link #getIdentifier()}.
  *
+ * <p>
  * It can optionally capture the context where it was allocated.
  *
- * <T> identifier type
+ * @param <T> identifier type
  */
 @Beta
 public abstract class AbstractDOMStoreTransaction<T> implements DOMStoreTransaction {
     private final Throwable debugContext;
-    private final T identifier;
+    private final @NonNull T identifier;
 
-    protected AbstractDOMStoreTransaction(@Nonnull final T identifier) {
+    protected AbstractDOMStoreTransaction(final @NonNull T identifier) {
         this(identifier, false);
     }
 
-    protected AbstractDOMStoreTransaction(@Nonnull final T identifier, final boolean debug) {
-        this.identifier = Preconditions.checkNotNull(identifier, "Identifier must not be null.");
+    protected AbstractDOMStoreTransaction(final @NonNull T identifier, final boolean debug) {
+        this.identifier = requireNonNull(identifier, "Identifier must not be null.");
         this.debugContext = debug ? new Throwable().fillInStackTrace() : null;
     }
 
@@ -46,11 +49,9 @@ public abstract class AbstractDOMStoreTransaction<T> implements DOMStoreTransact
     /**
      * Return the context in which this transaction was allocated.
      *
-     * @return The context in which this transaction was allocated, or null
-     *         if the context was not recorded.
+     * @return The context in which this transaction was allocated, or null if the context was not recorded.
      */
-    @Nullable
-    public final Throwable getDebugContext() {
+    public final @Nullable Throwable getDebugContext() {
         return debugContext;
     }
 
@@ -66,7 +67,7 @@ public abstract class AbstractDOMStoreTransaction<T> implements DOMStoreTransact
      *            ToStringHelper instance
      * @return ToStringHelper instance which was passed in
      */
-    protected ToStringHelper addToStringAttributes(@Nonnull final ToStringHelper toStringHelper) {
+    protected ToStringHelper addToStringAttributes(final @NonNull ToStringHelper toStringHelper) {
         return toStringHelper.add("id", identifier);
     }
 }