/* * Copyright (c) 2015 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.model.util; import static java.util.Objects.requireNonNull; import com.google.common.collect.ImmutableMap; import com.google.common.collect.ImmutableSet; import java.util.Collection; import java.util.HashMap; import java.util.HashSet; import java.util.Map; import java.util.Optional; import java.util.Set; import org.opendaylight.yangtools.yang.common.QName; import org.opendaylight.yangtools.yang.model.api.ActionDefinition; import org.opendaylight.yangtools.yang.model.api.AugmentationSchemaNode; import org.opendaylight.yangtools.yang.model.api.DataNodeContainer; import org.opendaylight.yangtools.yang.model.api.DataSchemaNode; import org.opendaylight.yangtools.yang.model.api.GroupingDefinition; import org.opendaylight.yangtools.yang.model.api.NotificationDefinition; import org.opendaylight.yangtools.yang.model.api.Status; import org.opendaylight.yangtools.yang.model.api.TypeDefinition; import org.opendaylight.yangtools.yang.model.api.UnknownSchemaNode; import org.opendaylight.yangtools.yang.model.api.UsesNode; import org.opendaylight.yangtools.yang.model.api.stmt.AugmentEffectiveStatement; import org.opendaylight.yangtools.yang.xpath.api.YangXPathExpression.QualifiedBound; /** * Proxy for AugmentationSchema. Child node schemas are replaced with actual schemas from parent. This is needed to * correctly interpret constructs like this: *
 *   
 *     container foo;
 *
 *     augment /foo {
 *       container bar;
 *     }
 *
 *     augment /foo/bar {
 *       container baz;
 *     }
 *   
 * 
* The {@link AugmentationSchemaNode} returned for {@code augment /foo} contains bare {@code container bar}, e.g. it * does not show {@code augment /foo/bar} as an available augmentation -- this is only visible in {@code foo}'s schema * nodes. * *

* Note this class only handles {@link DataSchemaNode}s, not all {@code schema tree} statements, as it strictly should. */ // FIXME: YANGTOOLS-1403: this functionality should be integrated into EffectiveAugmentStatement/AugmentationSchemaNode public final class EffectiveAugmentationSchema implements AugmentationSchemaNode { private final AugmentationSchemaNode delegate; private final ImmutableSet realChildSchemas; private final ImmutableMap mappedChildSchemas; public EffectiveAugmentationSchema(final AugmentationSchemaNode augmentSchema, final Collection realChildSchemas) { delegate = requireNonNull(augmentSchema); this.realChildSchemas = ImmutableSet.copyOf(realChildSchemas); final Map m = new HashMap<>(realChildSchemas.size()); for (DataSchemaNode realChildSchema : realChildSchemas) { m.put(realChildSchema.getQName(), realChildSchema); } mappedChildSchemas = ImmutableMap.copyOf(m); } /** * Returns an AugmentationSchemaNode as effective in a parent node. * * @param schema Augmentation schema * @param parent Parent schema * @return Adjusted Augmentation schema * @throws NullPointerException if any of the arguments is null */ // FIXME: 8.0.0: integrate this method into the constructor public static AugmentationSchemaNode create(final AugmentationSchemaNode schema, final DataNodeContainer parent) { final Set children = new HashSet<>(); for (DataSchemaNode augNode : schema.getChildNodes()) { // parent may have the corresponding child removed via 'deviate unsupported', i.e. the child is effectively // not present at the target site final DataSchemaNode child = parent.dataChildByName(augNode.getQName()); if (child != null) { children.add(child); } } return new EffectiveAugmentationSchema(schema, children); } @Override public Optional getWhenCondition() { return delegate.getWhenCondition(); } @Override public Optional getDescription() { return delegate.getDescription(); } @Override public Optional getReference() { return delegate.getReference(); } @Override public Status getStatus() { return delegate.getStatus(); } @Override public Collection getUnknownSchemaNodes() { return delegate.getUnknownSchemaNodes(); } @Override public Collection> getTypeDefinitions() { return delegate.getTypeDefinitions(); } @Override public Collection getChildNodes() { return realChildSchemas; } @Override public Collection getGroupings() { return delegate.getGroupings(); } @Override public DataSchemaNode dataChildByName(final QName name) { return mappedChildSchemas.get(requireNonNull(name)); } @Override public Collection getUses() { return delegate.getUses(); } @Override public Optional getOriginalDefinition() { return delegate.getOriginalDefinition(); } @Override public Collection getActions() { return delegate.getActions(); } @Override public Optional findAction(final QName qname) { return delegate.findAction(qname); } @Override public Collection getNotifications() { return delegate.getNotifications(); } @Override public Optional findNotification(final QName qname) { return delegate.findNotification(qname); } @Override public AugmentEffectiveStatement asEffectiveStatement() { return delegate.asEffectiveStatement(); } }