binding/mdsal-binding-runtime-api/src/main/java/org/opendaylight/mdsal/binding/runtime/api/DataRuntimeType.java

   1 /*
   2  * Copyright (c) 2022 PANTHEON.tech, s.r.o. 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.mdsal.binding.runtime.api;
   9
  10 import org.opendaylight.mdsal.binding.model.api.JavaTypeName;
  11
  12 /**
  13  * Marker interface for concrete {@link RuntimeType}s relevant when dealing data hierarchy. This interface does not have
  14  * a direct relationship with the {@code data tree} YANG construct, nor with {@code YangInstanceIdentifier} addressing.
  15  * Its primary role is differentiating between various types when considered in the context of
  16  * {@link RuntimeTypeContainer}'s child methods and related inferences. In particular, {@link DataRuntimeType}s are
  17  * relevant when considering whether or not a particular RuntimeType child is part of the data encoding (according to
  18  * the Binding Specification) to the {@code schema tree} layout.
  19  *
  20  * <p>
  21  * DataRuntimeTypes are considered part of the {@code data tree} information encoded by the Binding Specification and
  22  * thus need to be considered as child nodes when considering other data-bearing construct, such as
  23  * {@code NormalizedNode}. That relationship may not be straightforward, but notably it excludes constructs like
  24  * {@link NotificationRuntimeType}, {@link IdentityRuntimeType}, {@link ActionRuntimeType}, {@link GroupingRuntimeType},
  25  * and similar, as those exist in outside of {@code data tree} contract, but are still part of what
  26  * {@link RuntimeTypeContainer#bindingChild(JavaTypeName)} considers as child constructs.
  27  */
  28 public interface DataRuntimeType extends RuntimeType {
  29     // Marker interface, no further contract is specified
  30 }