Force BindingNormalizedNodeSerializers to deal with event instant

[mdsal.git] / binding / mdsal-binding-dom-codec / src / main / java / org / opendaylight / mdsal / binding / dom / codec / api / BindingNormalizedNodeSerializer.java

diff --git a/binding/mdsal-binding-dom-codec/src/main/java/org/opendaylight/mdsal/binding/dom/codec/api/BindingNormalizedNodeSerializer.java b/binding/mdsal-binding-dom-codec/src/main/java/org/opendaylight/mdsal/binding/dom/codec/api/BindingNormalizedNodeSerializer.java
index 335f57bae75281f136713de4ef30762679573f50..962a24f8b348bcceceb2b88a659e328f11ed31de 100644 (file)
--- a/binding/mdsal-binding-dom-codec/src/main/java/org/opendaylight/mdsal/binding/dom/codec/api/BindingNormalizedNodeSerializer.java
+++ b/binding/mdsal-binding-dom-codec/src/main/java/org/opendaylight/mdsal/binding/dom/codec/api/BindingNormalizedNodeSerializer.java
@@ -80,12 +80,18 @@ public interface BindingNormalizedNodeSerializer {
      */
     @Nullable Notification fromNormalizedNodeNotification(@NonNull SchemaPath path, @NonNull ContainerNode data);
 
-    // FIXME: 5.0.0: make this method non-default
+    /**
+     * Translates supplied NormalizedNode Notification into Binding data, optionally taking an instant
+     * when the notification was generated.
+     *
+     * @param path Schema Path of Notification, schema path is absolute, and consists of Notification QName.
+     * @param data NormalizedNode representing data
+     * @param eventInstant optional instant when the event was generated
+     * @return Binding representation of Notification
+     */
     @Beta
-    default Notification fromNormalizedNodeNotification(final @NonNull SchemaPath path,
-            final @NonNull ContainerNode data, final @Nullable Instant eventInstant) {
-        return fromNormalizedNodeNotification(path, data);
-    }
+    @Nullable Notification fromNormalizedNodeNotification(@NonNull SchemaPath path, @NonNull ContainerNode data,
+            @Nullable Instant eventInstant);
 
     /**
      * Translates supplied NormalizedNode RPC input or output into Binding data.