/* * Copyright (c) 2014 Cisco Systems, Inc. and others. All rights reserved. * * This program and the accompanying materials are made available under the * terms of the Eclipse Public License v1.0 which accompanies this distribution, * and is available at http://www.eclipse.org/legal/epl-v10.html */ package org.opendaylight.yangtools.yang.data.impl.schema; import com.google.common.base.Preconditions; import java.util.ArrayDeque; import java.util.Collection; import java.util.Deque; import javax.annotation.Nonnull; import javax.xml.transform.dom.DOMSource; import org.opendaylight.yangtools.odlext.model.api.YangModeledAnyXmlSchemaNode; 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.NodeIdentifierWithPredicates; import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.PathArgument; import org.opendaylight.yangtools.yang.data.api.schema.AnyXmlNode; import org.opendaylight.yangtools.yang.data.api.schema.ChoiceNode; import org.opendaylight.yangtools.yang.data.api.schema.ContainerNode; import org.opendaylight.yangtools.yang.data.api.schema.LeafNode; import org.opendaylight.yangtools.yang.data.api.schema.LeafSetEntryNode; import org.opendaylight.yangtools.yang.data.api.schema.MapEntryNode; import org.opendaylight.yangtools.yang.data.api.schema.MapNode; import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode; import org.opendaylight.yangtools.yang.data.api.schema.OrderedMapNode; import org.opendaylight.yangtools.yang.data.api.schema.UnkeyedListEntryNode; import org.opendaylight.yangtools.yang.data.api.schema.UnkeyedListNode; import org.opendaylight.yangtools.yang.data.api.schema.YangModeledAnyXmlNode; import org.opendaylight.yangtools.yang.data.api.schema.stream.NormalizedNodeStreamWriter; import org.opendaylight.yangtools.yang.data.impl.schema.builder.api.CollectionNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.api.DataContainerNodeAttrBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.api.DataContainerNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.api.ListNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.api.NormalizedNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.api.NormalizedNodeContainerBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableAnyXmlNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableAugmentationNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableChoiceNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableContainerNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableLeafSetNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableMapEntryNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableMapNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableOrderedLeafSetNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableOrderedMapNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableUnkeyedListEntryNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableUnkeyedListNodeBuilder; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableYangModeledAnyXmlNodeBuilder; import org.opendaylight.yangtools.yang.data.util.LeafInterner; import org.opendaylight.yangtools.yang.model.api.DataSchemaNode; import org.opendaylight.yangtools.yang.model.api.LeafSchemaNode; /** * Implementation of {@link NormalizedNodeStreamWriter}, which constructs immutable instances of * {@link NormalizedNode}s. * *

* This writer supports two modes of behaviour one is using {@link #from(NormalizedNodeResult)} where resulting * NormalizedNode will be stored in supplied result object. * *

* Other mode of operation is using {@link #from(NormalizedNodeContainerBuilder)}, where all created nodes will be * written to this builder. */ public class ImmutableNormalizedNodeStreamWriter implements NormalizedNodeStreamWriter { @SuppressWarnings("rawtypes") private final Deque builders = new ArrayDeque<>(); private DataSchemaNode nextSchema; @SuppressWarnings("rawtypes") protected ImmutableNormalizedNodeStreamWriter(final NormalizedNodeContainerBuilder topLevelBuilder) { builders.push(topLevelBuilder); } protected ImmutableNormalizedNodeStreamWriter(final NormalizedNodeResult result) { this(new NormalizedNodeResultBuilder(result)); } /** * Creates a {@link NormalizedNodeStreamWriter} which creates instances of supplied {@link NormalizedNode}s * and writes them to supplied builder as child nodes. * *

* Type of supplied {@link NormalizedNodeContainerBuilder} affects, which events could be emitted in order * to ensure proper construction of data. * * @param builder Builder to which data will be written. * @return {@link NormalizedNodeStreamWriter} which writes data */ public static NormalizedNodeStreamWriter from(final NormalizedNodeContainerBuilder builder) { return new ImmutableNormalizedNodeStreamWriter(builder); } /** * Creates a {@link NormalizedNodeStreamWriter} which creates one instance of top-level {@link NormalizedNode} * (type of NormalizedNode) is determined by first start event. * *

* Result is built when {@link #endNode()} associated with that start event is emitted. * *

* Writer properly creates also nested {@link NormalizedNode} instances, if their are supported inside the scope * of the first event. * *

* This method is useful for clients, which knows there will be one top-level node written, but does not know which * type of {@link NormalizedNode} will be written. * * @param result {@link NormalizedNodeResult} object which will hold result value. * @return {@link NormalizedNodeStreamWriter} which will write item to supplied result holder. */ public static NormalizedNodeStreamWriter from(final NormalizedNodeResult result) { return new ImmutableNormalizedNodeStreamWriter(result); } protected Deque getBuilders() { return builders; } @SuppressWarnings("rawtypes") protected NormalizedNodeContainerBuilder getCurrent() { return builders.peek(); } @SuppressWarnings("rawtypes") private void enter(final NormalizedNodeContainerBuilder next) { builders.push(next); nextSchema = null; } @SuppressWarnings("unchecked") protected void writeChild(final NormalizedNode child) { getCurrent().addChild(child); } @Override @SuppressWarnings({"rawtypes","unchecked"}) public void endNode() { final NormalizedNodeContainerBuilder finishedBuilder = builders.poll(); Preconditions.checkState(finishedBuilder != null, "Node which should be closed does not exists."); final NormalizedNodeContainerBuilder current = getCurrent(); Preconditions.checkState(current != null, "Reached top level node, which could not be closed in this writer."); final NormalizedNode product = finishedBuilder.build(); current.addChild(product); nextSchema = null; } @Override public void leafNode(final NodeIdentifier name, final Object value) { checkDataNodeContainer(); final LeafNode sample = ImmutableNodes.leafNode(name, value); final LeafNode node; if (nextSchema instanceof LeafSchemaNode) { node = LeafInterner.forSchema((LeafSchemaNode)nextSchema).intern(sample); } else { node = sample; } writeChild(node); nextSchema = null; } @Override public void startLeafSet(final NodeIdentifier name, final int childSizeHint) { checkDataNodeContainer(); final ListNodeBuilder> builder = UNKNOWN_SIZE == childSizeHint ? InterningLeafSetNodeBuilder.create(nextSchema) : InterningLeafSetNodeBuilder.create(nextSchema, childSizeHint); builder.withNodeIdentifier(name); enter(builder); } @Override public void leafSetEntryNode(final QName name, final Object value) { if (getCurrent() instanceof ImmutableOrderedLeafSetNodeBuilder) { @SuppressWarnings("unchecked") ListNodeBuilder> builder = (ImmutableOrderedLeafSetNodeBuilder) getCurrent(); builder.withChildValue(value); } else if (getCurrent() instanceof ImmutableLeafSetNodeBuilder) { @SuppressWarnings("unchecked") ListNodeBuilder> builder = (ImmutableLeafSetNodeBuilder) getCurrent(); builder.withChildValue(value); } else { throw new IllegalArgumentException("LeafSetEntryNode is not valid for parent " + getCurrent()); } nextSchema = null; } @Override public void startOrderedLeafSet(final NodeIdentifier name, final int childSizeHint) { checkDataNodeContainer(); final ListNodeBuilder> builder = Builders.orderedLeafSetBuilder(); builder.withNodeIdentifier(name); enter(builder); } @Override public void anyxmlNode(final NodeIdentifier name, final Object value) { checkDataNodeContainer(); final AnyXmlNode node = ImmutableAnyXmlNodeBuilder.create().withNodeIdentifier(name) .withValue((DOMSource) value).build(); writeChild(node); nextSchema = null; } @Override public void startContainerNode(final NodeIdentifier name, final int childSizeHint) { checkDataNodeContainer(); final DataContainerNodeAttrBuilder builder = UNKNOWN_SIZE == childSizeHint ? ImmutableContainerNodeBuilder.create() : ImmutableContainerNodeBuilder.create(childSizeHint); enter(builder.withNodeIdentifier(name)); } @Override public void startYangModeledAnyXmlNode(final NodeIdentifier name, final int childSizeHint) { checkDataNodeContainer(); Preconditions.checkArgument(nextSchema instanceof YangModeledAnyXmlSchemaNode, "Schema of this node should be instance of YangModeledAnyXmlSchemaNode"); final DataContainerNodeAttrBuilder builder = UNKNOWN_SIZE == childSizeHint ? ImmutableYangModeledAnyXmlNodeBuilder.create((YangModeledAnyXmlSchemaNode) nextSchema) : ImmutableYangModeledAnyXmlNodeBuilder.create( (YangModeledAnyXmlSchemaNode) nextSchema, childSizeHint); enter(builder.withNodeIdentifier(name)); } @Override public void startUnkeyedList(final NodeIdentifier name, final int childSizeHint) { checkDataNodeContainer(); final CollectionNodeBuilder builder = UNKNOWN_SIZE == childSizeHint ? ImmutableUnkeyedListNodeBuilder.create() : ImmutableUnkeyedListNodeBuilder.create(childSizeHint); enter(builder.withNodeIdentifier(name)); } @Override public void startUnkeyedListItem(final NodeIdentifier name, final int childSizeHint) { Preconditions.checkArgument(getCurrent() instanceof NormalizedNodeResultBuilder || getCurrent() instanceof ImmutableUnkeyedListNodeBuilder); final DataContainerNodeAttrBuilder builder = UNKNOWN_SIZE == childSizeHint ? ImmutableUnkeyedListEntryNodeBuilder.create() : ImmutableUnkeyedListEntryNodeBuilder.create(childSizeHint); enter(builder.withNodeIdentifier(name)); } @Override public void startMapNode(final NodeIdentifier name, final int childSizeHint) { checkDataNodeContainer(); final CollectionNodeBuilder builder = UNKNOWN_SIZE == childSizeHint ? ImmutableMapNodeBuilder.create() : ImmutableMapNodeBuilder.create(childSizeHint); enter(builder.withNodeIdentifier(name)); } @Override public void startMapEntryNode(final NodeIdentifierWithPredicates identifier, final int childSizeHint) { if (!(getCurrent() instanceof NormalizedNodeResultBuilder)) { Preconditions.checkArgument(getCurrent() instanceof ImmutableMapNodeBuilder || getCurrent() instanceof ImmutableOrderedMapNodeBuilder); } final DataContainerNodeAttrBuilder builder = UNKNOWN_SIZE == childSizeHint ? ImmutableMapEntryNodeBuilder.create() : ImmutableMapEntryNodeBuilder.create(childSizeHint); enter(builder.withNodeIdentifier(identifier)); } @Override public void startOrderedMapNode(final NodeIdentifier name, final int childSizeHint) { checkDataNodeContainer(); final CollectionNodeBuilder builder = UNKNOWN_SIZE == childSizeHint ? ImmutableOrderedMapNodeBuilder.create() : ImmutableOrderedMapNodeBuilder.create(childSizeHint); enter(builder.withNodeIdentifier(name)); } @Override public void startChoiceNode(final NodeIdentifier name, final int childSizeHint) { checkDataNodeContainer(); final DataContainerNodeBuilder builder = UNKNOWN_SIZE == childSizeHint ? ImmutableChoiceNodeBuilder.create() : ImmutableChoiceNodeBuilder.create(childSizeHint); enter(builder.withNodeIdentifier(name)); } @Override public void startAugmentationNode(final AugmentationIdentifier identifier) { checkDataNodeContainer(); Preconditions.checkArgument(!(getCurrent() instanceof ImmutableAugmentationNodeBuilder)); enter(Builders.augmentationBuilder().withNodeIdentifier(identifier)); } private void checkDataNodeContainer() { @SuppressWarnings("rawtypes") final NormalizedNodeContainerBuilder current = getCurrent(); if (!(current instanceof NormalizedNodeResultBuilder)) { Preconditions.checkArgument(current instanceof DataContainerNodeBuilder, "Invalid nesting of data."); } } @SuppressWarnings("rawtypes") protected static final class NormalizedNodeResultBuilder implements NormalizedNodeContainerBuilder { private final NormalizedNodeResult result; public NormalizedNodeResultBuilder(final NormalizedNodeResult result) { this.result = result; } @Override public NormalizedNodeBuilder withValue(final Object value) { throw new UnsupportedOperationException(); } @Override public NormalizedNodeContainerBuilder withValue(final Collection value) { throw new UnsupportedOperationException(); } @Override public NormalizedNode build() { throw new IllegalStateException("Can not close NormalizedNodeResult"); } @Override public NormalizedNodeContainerBuilder withNodeIdentifier(final PathArgument nodeIdentifier) { throw new UnsupportedOperationException(); } @Override public NormalizedNodeContainerBuilder addChild(final NormalizedNode child) { result.setResult(child); return this; } @Override public NormalizedNodeContainerBuilder removeChild(final PathArgument key) { throw new UnsupportedOperationException(); } } @Override public void flush() { // no-op } @Override public void close() { // no-op } @Override public void nextDataSchemaNode(@Nonnull final DataSchemaNode schema) { nextSchema = Preconditions.checkNotNull(schema); } }