*/
package org.opendaylight.yangtools.yang.data.impl.codec;
+import static com.google.common.base.Preconditions.checkArgument;
+import static java.util.Objects.requireNonNull;
+
import com.google.common.annotations.Beta;
-import com.google.common.base.Preconditions;
import com.google.common.collect.Iterables;
import java.io.IOException;
import java.util.ArrayDeque;
-import java.util.Collection;
import java.util.Deque;
-import java.util.HashSet;
import java.util.Optional;
+import org.eclipse.jdt.annotation.NonNull;
import org.opendaylight.yangtools.yang.common.QName;
import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.AugmentationIdentifier;
import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifier;
+import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeWithValue;
import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.PathArgument;
import org.opendaylight.yangtools.yang.data.api.schema.stream.NormalizedNodeStreamWriter;
import org.opendaylight.yangtools.yang.data.impl.schema.SchemaUtils;
-import org.opendaylight.yangtools.yang.model.api.AnyXmlSchemaNode;
-import org.opendaylight.yangtools.yang.model.api.AugmentationSchema;
+import org.opendaylight.yangtools.yang.model.api.AnydataSchemaNode;
+import org.opendaylight.yangtools.yang.model.api.AnyxmlSchemaNode;
+import org.opendaylight.yangtools.yang.model.api.AugmentationSchemaNode;
import org.opendaylight.yangtools.yang.model.api.AugmentationTarget;
-import org.opendaylight.yangtools.yang.model.api.ChoiceCaseNode;
+import org.opendaylight.yangtools.yang.model.api.CaseSchemaNode;
import org.opendaylight.yangtools.yang.model.api.ChoiceSchemaNode;
-import org.opendaylight.yangtools.yang.model.api.ContainerSchemaNode;
+import org.opendaylight.yangtools.yang.model.api.ContainerLike;
import org.opendaylight.yangtools.yang.model.api.DataNodeContainer;
import org.opendaylight.yangtools.yang.model.api.DataSchemaNode;
+import org.opendaylight.yangtools.yang.model.api.DocumentedNode.WithStatus;
+import org.opendaylight.yangtools.yang.model.api.EffectiveModelContext;
import org.opendaylight.yangtools.yang.model.api.GroupingDefinition;
import org.opendaylight.yangtools.yang.model.api.LeafListSchemaNode;
import org.opendaylight.yangtools.yang.model.api.LeafSchemaNode;
import org.opendaylight.yangtools.yang.model.api.ListSchemaNode;
import org.opendaylight.yangtools.yang.model.api.NotificationDefinition;
-import org.opendaylight.yangtools.yang.model.api.SchemaContext;
import org.opendaylight.yangtools.yang.model.api.SchemaNode;
import org.opendaylight.yangtools.yang.model.api.SchemaPath;
-import org.opendaylight.yangtools.yang.model.api.YangModeledAnyXmlSchemaNode;
+import org.opendaylight.yangtools.yang.model.api.meta.EffectiveStatement;
+import org.opendaylight.yangtools.yang.model.api.stmt.ActionEffectiveStatement;
+import org.opendaylight.yangtools.yang.model.api.stmt.RpcEffectiveStatement;
+import org.opendaylight.yangtools.yang.model.api.stmt.SchemaNodeIdentifier.Absolute;
import org.opendaylight.yangtools.yang.model.util.EffectiveAugmentationSchema;
+import org.opendaylight.yangtools.yang.model.util.SchemaInferenceStack;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
- * Utility class for tracking the underlying state of the underlying
- * schema node.
+ * Utility class for tracking the underlying state of the underlying schema node.
*/
@Beta
public final class SchemaTracker {
private static final Logger LOG = LoggerFactory.getLogger(SchemaTracker.class);
- private final Deque<Object> schemaStack = new ArrayDeque<>();
+
+ private final Deque<WithStatus> schemaStack = new ArrayDeque<>();
private final DataNodeContainer root;
- private SchemaTracker(final SchemaContext context, final SchemaPath path) {
- final Collection<SchemaNode> schemaNodes = SchemaUtils.findParentSchemaNodesOnPath(context, path);
- Preconditions.checkArgument(!schemaNodes.isEmpty(), "Unable to find schema node for supplied schema path: %s",
- path);
- if (schemaNodes.size() > 1) {
- LOG.warn("More possible schema nodes {} for supplied schema path {}", schemaNodes, path);
+ private SchemaTracker(final DataNodeContainer root) {
+ this.root = requireNonNull(root);
+ }
+
+ private static @NonNull SchemaTracker create(final SchemaInferenceStack root) {
+ if (root.isEmpty()) {
+ return new SchemaTracker(root.getEffectiveModelContext());
}
- final Optional<SchemaNode> current = schemaNodes.stream().filter(node -> node instanceof DataNodeContainer)
- .findFirst();
- Preconditions.checkArgument(current.isPresent(),
- "Schema path must point to container or list or an rpc input/output. Supplied path %s pointed to: %s",
- path, current);
- root = (DataNodeContainer) current.get();
+
+ final EffectiveStatement<?, ?> current = root.currentStatement();
+ checkArgument(current instanceof DataNodeContainer, "Cannot instantiate on %s", current);
+ return new SchemaTracker((DataNodeContainer) current);
}
/**
- * Create a new writer with the specified context as its root.
+ * Create a new writer with the specified node as its root.
*
- * @param context Associated {@link SchemaContext}.
+ * @param root Root node
* @return A new {@link NormalizedNodeStreamWriter}
+ * @throws NullPointerException if {@code root} is null
+ */
+ public static @NonNull SchemaTracker create(final DataNodeContainer root) {
+ return new SchemaTracker(root);
+ }
+
+ /**
+ * Create a new writer with the specified context and rooted in the specified schema path.
+ *
+ * @param context Associated {@link EffectiveModelContext}
+ * @param path schema path
+ * @return A new {@link SchemaTracker}
+ * @throws NullPointerException if any argument is null
+ * @throws IllegalArgumentException if {@code path} does not point to a valid root
*/
- public static SchemaTracker create(final SchemaContext context) {
- return create(context, SchemaPath.ROOT);
+ public static @NonNull SchemaTracker create(final EffectiveModelContext context, final Absolute path) {
+ return create(SchemaInferenceStack.of(context, path));
}
/**
* Create a new writer with the specified context and rooted in the specified schema path.
*
- * @param context Associated {@link SchemaContext}
+ * @param context Associated {@link EffectiveModelContext}
* @param path schema path
+ * @return A new {@link SchemaTracker}
+ * @throws NullPointerException if any argument is null
+ * @throws IllegalArgumentException if {@code path} does not point to a valid root
+ */
+ public static @NonNull SchemaTracker create(final EffectiveModelContext context, final SchemaPath path) {
+ return create(SchemaInferenceStack.ofInstantiatedPath(context, path));
+ }
+
+ /**
+ * Create a new writer with the specified context and rooted in the specified schema path.
+ *
+ * @param context Associated {@link EffectiveModelContext}
+ * @param operation Operation schema path
+ * @param qname Input/Output container QName
* @return A new {@link NormalizedNodeStreamWriter}
+ * @throws NullPointerException if any argument is null
+ * @throws IllegalArgumentException if {@code operation} does not point to an actual operation or if {@code qname}
+ * does not identify a valid root underneath it.
*/
- public static SchemaTracker create(final SchemaContext context, final SchemaPath path) {
- return new SchemaTracker(context, path);
+ public static @NonNull SchemaTracker forOperation(final EffectiveModelContext context, final Absolute operation,
+ final QName qname) {
+ final SchemaInferenceStack stack = SchemaInferenceStack.of(context, operation);
+ final EffectiveStatement<?, ?> current = stack.currentStatement();
+ checkArgument(current instanceof RpcEffectiveStatement || current instanceof ActionEffectiveStatement,
+ "Path %s resolved into non-operation %s", operation, current);
+ stack.enterSchemaTree(qname);
+ return create(stack);
}
public Object getParent() {
SchemaNode schema = null;
final QName qname = name.getNodeType();
if (parent instanceof DataNodeContainer) {
- schema = ((DataNodeContainer)parent).getDataChildByName(qname);
+ schema = ((DataNodeContainer)parent).dataChildByName(qname);
if (schema == null) {
if (parent instanceof GroupingDefinition) {
schema = (GroupingDefinition) parent;
throw new IllegalStateException("Unsupported schema type " + parent.getClass() + " on stack.");
}
- Preconditions.checkArgument(schema != null, "Could not find schema for node %s in %s", qname, parent);
+ checkArgument(schema != null, "Could not find schema for node %s in %s", qname, parent);
return schema;
}
private static SchemaNode findChildInCases(final ChoiceSchemaNode parent, final QName qname) {
- DataSchemaNode schema = null;
- for (final ChoiceCaseNode caze : parent.getCases()) {
- final DataSchemaNode potential = caze.getDataChildByName(qname);
- if (potential != null) {
- schema = potential;
- break;
+ for (final CaseSchemaNode caze : parent.getCases()) {
+ final Optional<DataSchemaNode> potential = caze.findDataChildByName(qname);
+ if (potential.isPresent()) {
+ return potential.get();
}
}
- return schema;
+ return null;
}
private static SchemaNode findCaseByChild(final ChoiceSchemaNode parent, final QName qname) {
- DataSchemaNode schema = null;
- for (final ChoiceCaseNode caze : parent.getCases()) {
- final DataSchemaNode potential = caze.getDataChildByName(qname);
- if (potential != null) {
- schema = caze;
- break;
+ for (final CaseSchemaNode caze : parent.getCases()) {
+ final Optional<DataSchemaNode> potential = caze.findDataChildByName(qname);
+ if (potential.isPresent()) {
+ return caze;
}
}
- return schema;
+ return null;
}
public void startList(final PathArgument name) {
final SchemaNode schema = getSchema(name);
- Preconditions.checkArgument(schema instanceof ListSchemaNode, "Node %s is not a list", schema.getPath());
+ checkArgument(schema instanceof ListSchemaNode, "Node %s is not a list", schema);
schemaStack.push(schema);
}
public void startListItem(final PathArgument name) throws IOException {
final Object schema = getParent();
- Preconditions.checkArgument(schema instanceof ListSchemaNode, "List item is not appropriate");
- schemaStack.push(schema);
+ checkArgument(schema instanceof ListSchemaNode, "List item is not appropriate");
+ schemaStack.push((ListSchemaNode) schema);
}
public LeafSchemaNode leafNode(final NodeIdentifier name) throws IOException {
final SchemaNode schema = getSchema(name);
-
- Preconditions.checkArgument(schema instanceof LeafSchemaNode, "Node %s is not a leaf", schema.getPath());
+ checkArgument(schema instanceof LeafSchemaNode, "Node %s is not a leaf", schema);
return (LeafSchemaNode) schema;
}
+ public void startLeafNode(final NodeIdentifier name) throws IOException {
+ schemaStack.push(leafNode(name));
+ }
+
public LeafListSchemaNode startLeafSet(final NodeIdentifier name) {
final SchemaNode schema = getSchema(name);
-
- Preconditions.checkArgument(schema instanceof LeafListSchemaNode, "Node %s is not a leaf-list",
- schema.getPath());
+ checkArgument(schema instanceof LeafListSchemaNode, "Node %s is not a leaf-list", schema);
schemaStack.push(schema);
- return (LeafListSchemaNode)schema;
- }
-
- @Deprecated
- public LeafListSchemaNode leafSetEntryNode() {
- final Object parent = getParent();
-
- Preconditions.checkArgument(parent instanceof LeafListSchemaNode, "Not currently in a leaf-list");
- return (LeafListSchemaNode) parent;
+ return (LeafListSchemaNode) schema;
}
public LeafListSchemaNode leafSetEntryNode(final QName qname) {
}
final SchemaNode child = SchemaUtils.findDataChildSchemaByQName((SchemaNode) parent, qname);
- Preconditions.checkArgument(child instanceof LeafListSchemaNode,
- "Node %s is neither a leaf-list nor currently in a leaf-list", child.getPath());
+ checkArgument(child instanceof LeafListSchemaNode,
+ "Node %s is neither a leaf-list nor currently in a leaf-list", child);
return (LeafListSchemaNode) child;
}
+ public void startLeafSetEntryNode(final NodeWithValue<?> name) {
+ schemaStack.push(leafSetEntryNode(name.getNodeType()));
+ }
+
public ChoiceSchemaNode startChoiceNode(final NodeIdentifier name) {
LOG.debug("Enter choice {}", name);
final SchemaNode schema = getSchema(name);
- Preconditions.checkArgument(schema instanceof ChoiceSchemaNode, "Node %s is not a choice", schema.getPath());
+ checkArgument(schema instanceof ChoiceSchemaNode, "Node %s is not a choice", schema);
schemaStack.push(schema);
return (ChoiceSchemaNode)schema;
}
public SchemaNode startContainerNode(final NodeIdentifier name) {
LOG.debug("Enter container {}", name);
final SchemaNode schema = getSchema(name);
+ final boolean isAllowed = schema instanceof ContainerLike || schema instanceof NotificationDefinition;
- boolean isAllowed = schema instanceof ContainerSchemaNode;
- isAllowed |= schema instanceof NotificationDefinition;
-
- Preconditions.checkArgument(isAllowed, "Node %s is not a container nor a notification", schema.getPath());
+ checkArgument(isAllowed, "Node %s is not a container nor a notification", schema);
schemaStack.push(schema);
-
return schema;
}
- public SchemaNode startYangModeledAnyXmlNode(final NodeIdentifier name) {
- LOG.debug("Enter yang modeled anyXml {}", name);
- final SchemaNode schema = getSchema(name);
-
- Preconditions.checkArgument(schema instanceof YangModeledAnyXmlSchemaNode,
- "Node %s is not an yang modeled anyXml.", schema.getPath());
-
- schemaStack.push(((YangModeledAnyXmlSchemaNode) schema).getSchemaOfAnyXmlData());
-
- return schema;
- }
-
- public AugmentationSchema startAugmentationNode(final AugmentationIdentifier identifier) {
+ public AugmentationSchemaNode startAugmentationNode(final AugmentationIdentifier identifier) {
LOG.debug("Enter augmentation {}", identifier);
Object parent = getParent();
- Preconditions.checkArgument(parent instanceof AugmentationTarget, "Augmentation not allowed under %s", parent);
+ checkArgument(parent instanceof AugmentationTarget, "Augmentation not allowed under %s", parent);
if (parent instanceof ChoiceSchemaNode) {
final QName name = Iterables.get(identifier.getPossibleChildNames(), 0);
parent = findCaseByChild((ChoiceSchemaNode) parent, name);
}
- Preconditions.checkArgument(parent instanceof DataNodeContainer,
- "Augmentation allowed only in DataNodeContainer", parent);
- final AugmentationSchema schema = SchemaUtils.findSchemaForAugment((AugmentationTarget) parent,
+ checkArgument(parent instanceof DataNodeContainer, "Augmentation allowed only in DataNodeContainer", parent);
+ final AugmentationSchemaNode schema = SchemaUtils.findSchemaForAugment((AugmentationTarget) parent,
identifier.getPossibleChildNames());
- final HashSet<DataSchemaNode> realChildSchemas = new HashSet<>();
- for (final DataSchemaNode child : schema.getChildNodes()) {
- realChildSchemas.add(((DataNodeContainer) parent).getDataChildByName(child.getQName()));
- }
- final AugmentationSchema resolvedSchema = new EffectiveAugmentationSchema(schema, realChildSchemas);
+ final AugmentationSchemaNode resolvedSchema = EffectiveAugmentationSchema.create(schema,
+ (DataNodeContainer) parent);
schemaStack.push(resolvedSchema);
return resolvedSchema;
}
- public AnyXmlSchemaNode anyxmlNode(final NodeIdentifier name) {
+ public AnyxmlSchemaNode anyxmlNode(final NodeIdentifier name) {
final SchemaNode schema = getSchema(name);
+ checkArgument(schema instanceof AnyxmlSchemaNode, "Node %s is not anyxml", schema);
+ return (AnyxmlSchemaNode)schema;
+ }
+
+ public void startAnyxmlNode(final NodeIdentifier name) {
+ schemaStack.push(anyxmlNode(name));
+ }
+
+ public AnydataSchemaNode anydataNode(final NodeIdentifier name) {
+ final SchemaNode schema = getSchema(name);
+ checkArgument(schema instanceof AnydataSchemaNode, "Node %s is not anydata", schema);
+ return (AnydataSchemaNode)schema;
+ }
- Preconditions.checkArgument(schema instanceof AnyXmlSchemaNode, "Node %s is not anyxml", schema.getPath());
- return (AnyXmlSchemaNode)schema;
+ public void startAnydataNode(final NodeIdentifier name) {
+ schemaStack.push(anydataNode(name));
}
public Object endNode() {