Fold RootCodecContext into BindingCodecContext

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

diff --git a/binding/mdsal-binding-dom-codec-api/src/main/java/org/opendaylight/mdsal/binding/dom/codec/api/BindingCodecTree.java b/binding/mdsal-binding-dom-codec-api/src/main/java/org/opendaylight/mdsal/binding/dom/codec/api/BindingCodecTree.java
index 8bb6c0c74f54156e3bcdc9cd372db065f3001f78..e74097a6f1e7daccf2a56bd398602cf0a6516873 100644 (file)
--- a/binding/mdsal-binding-dom-codec-api/src/main/java/org/opendaylight/mdsal/binding/dom/codec/api/BindingCodecTree.java
+++ b/binding/mdsal-binding-dom-codec-api/src/main/java/org/opendaylight/mdsal/binding/dom/codec/api/BindingCodecTree.java
@@ -88,7 +88,14 @@ public interface BindingCodecTree extends BindingDataObjectCodecTreeParent<Empty
      */
     <T extends DataObject> @NonNull CommonDataObjectCodecTreeNode<T> getSubtreeCodec(InstanceIdentifier<T> path);
 
-    // FIXME: NonNull and throwing exception
+    /**
+     * Look up a codec by its {@link YangInstanceIdentifier} path.
+     *
+     * @param path A non-empty {@link YangInstanceIdentifier}
+     * @return A {@link BindingCodecTreeNode}
+     * @throws NullPointerException if {@code path} is {@code null}
+     * @throws IllegalArgumentException if {@code path} is empty
+     */
     @Nullable BindingCodecTreeNode getSubtreeCodec(YangInstanceIdentifier path);
 
     // FIXME: NonNull and throwing exception