/* * 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.parser.rfc7950.stmt; import static com.google.common.base.Verify.verifyNotNull; import static java.util.Objects.requireNonNull; import com.google.common.annotations.Beta; import com.google.common.base.MoreObjects; import com.google.common.collect.ImmutableList; import com.google.common.collect.ImmutableMap; import com.google.common.collect.ImmutableMap.Builder; import com.google.common.collect.ImmutableSet; import java.net.URI; import java.util.ArrayList; import java.util.Collection; import java.util.LinkedHashSet; import java.util.List; import java.util.Map; import java.util.Optional; import java.util.Set; import org.eclipse.jdt.annotation.NonNull; import org.opendaylight.yangtools.concepts.SemVer; import org.opendaylight.yangtools.openconfig.model.api.OpenConfigVersionEffectiveStatement; import org.opendaylight.yangtools.yang.common.QName; import org.opendaylight.yangtools.yang.common.Revision; import org.opendaylight.yangtools.yang.common.YangVersion; import org.opendaylight.yangtools.yang.model.api.AugmentationSchemaNode; import org.opendaylight.yangtools.yang.model.api.DataSchemaNode; import org.opendaylight.yangtools.yang.model.api.Deviation; import org.opendaylight.yangtools.yang.model.api.ExtensionDefinition; import org.opendaylight.yangtools.yang.model.api.FeatureDefinition; import org.opendaylight.yangtools.yang.model.api.GroupingDefinition; import org.opendaylight.yangtools.yang.model.api.IdentitySchemaNode; import org.opendaylight.yangtools.yang.model.api.Module; import org.opendaylight.yangtools.yang.model.api.ModuleImport; import org.opendaylight.yangtools.yang.model.api.NotificationDefinition; import org.opendaylight.yangtools.yang.model.api.RpcDefinition; import org.opendaylight.yangtools.yang.model.api.TypeDefinition; import org.opendaylight.yangtools.yang.model.api.UsesNode; import org.opendaylight.yangtools.yang.model.api.meta.DeclaredStatement; import org.opendaylight.yangtools.yang.model.api.meta.EffectiveStatement; import org.opendaylight.yangtools.yang.model.api.meta.IdentifierNamespace; import org.opendaylight.yangtools.yang.model.api.stmt.ContactEffectiveStatement; import org.opendaylight.yangtools.yang.model.api.stmt.ImportEffectiveStatement; import org.opendaylight.yangtools.yang.model.api.stmt.ModuleEffectiveStatement; import org.opendaylight.yangtools.yang.model.api.stmt.OrganizationEffectiveStatement; import org.opendaylight.yangtools.yang.model.api.stmt.PrefixEffectiveStatement; import org.opendaylight.yangtools.yang.model.api.stmt.PrefixStatement; import org.opendaylight.yangtools.yang.model.api.stmt.SchemaTreeAwareEffectiveStatement; import org.opendaylight.yangtools.yang.model.api.stmt.SchemaTreeEffectiveStatement; import org.opendaylight.yangtools.yang.model.api.stmt.TypedefEffectiveStatement; import org.opendaylight.yangtools.yang.model.api.stmt.YangVersionEffectiveStatement; import org.opendaylight.yangtools.yang.model.api.stmt.compat.NotificationNodeContainerCompat; import org.opendaylight.yangtools.yang.parser.spi.meta.StmtContext; import org.opendaylight.yangtools.yang.parser.spi.meta.StmtContextUtils; import org.opendaylight.yangtools.yang.parser.spi.source.ImportPrefixToModuleCtx; import org.opendaylight.yangtools.yang.parser.spi.source.SourceException; @Beta public abstract class AbstractEffectiveModule> extends AbstractSchemaEffectiveDocumentedNode implements Module, NotificationNodeContainerCompat { private final String name; private final String prefix; private final YangVersion yangVersion; private final String organization; private final String contact; private final ImmutableSet imports; private final ImmutableSet features; private final @NonNull ImmutableSet notifications; private final ImmutableSet augmentations; private final ImmutableSet rpcs; private final ImmutableSet deviations; private final ImmutableList extensionNodes; private final ImmutableSet identities; private final ImmutableSet groupings; private final ImmutableSet uses; private final ImmutableSet> typeDefinitions; private final ImmutableSet publicChildNodes; private final SemVer semanticVersion; private final ImmutableMap> schemaTreeNamespace; protected AbstractEffectiveModule( final @NonNull StmtContext> ctx, final @NonNull String prefix) { super(ctx); // This check is rather weird, but comes from our desire to lower memory footprint while providing both // EffectiveStatements and SchemaNode interfaces -- which do not overlap completely where child lookups are // concerned. This ensures that we have SchemaTree index available for use with child lookups. final Map> schemaTree = createSchemaTreeNamespace(ctx.getStatementSourceReference(), effectiveSubstatements()); schemaTreeNamespace = ImmutableMap.copyOf(schemaTree); // Data tree check, not currently used createDataTreeNamespace(ctx.getStatementSourceReference(), schemaTree.values(), schemaTreeNamespace); this.name = argument(); this.prefix = requireNonNull(prefix); this.yangVersion = findFirstEffectiveSubstatementArgument(YangVersionEffectiveStatement.class) .orElse(YangVersion.VERSION_1); this.semanticVersion = findFirstEffectiveSubstatementArgument(OpenConfigVersionEffectiveStatement.class) .orElse(null); this.organization = findFirstEffectiveSubstatementArgument(OrganizationEffectiveStatement.class) .orElse(null); this.contact = findFirstEffectiveSubstatementArgument(ContactEffectiveStatement.class) .orElse(null); final Set augmentationsInit = new LinkedHashSet<>(); final Set importsInit = new LinkedHashSet<>(); final Set notificationsInit = new LinkedHashSet<>(); final Set rpcsInit = new LinkedHashSet<>(); final Set deviationsInit = new LinkedHashSet<>(); final Set identitiesInit = new LinkedHashSet<>(); final Set featuresInit = new LinkedHashSet<>(); final List extensionNodesInit = new ArrayList<>(); final Set mutableGroupings = new LinkedHashSet<>(); final Set mutableUses = new LinkedHashSet<>(); final Set> mutableTypeDefinitions = new LinkedHashSet<>(); final Set mutablePublicChildNodes = new LinkedHashSet<>(); for (final EffectiveStatement effectiveStatement : effectiveSubstatements()) { if (effectiveStatement instanceof AugmentationSchemaNode) { augmentationsInit.add((AugmentationSchemaNode) effectiveStatement); } if (effectiveStatement instanceof ModuleImport) { importsInit.add((ModuleImport) effectiveStatement); } if (effectiveStatement instanceof NotificationDefinition) { notificationsInit.add((NotificationDefinition) effectiveStatement); } if (effectiveStatement instanceof RpcDefinition) { rpcsInit.add((RpcDefinition) effectiveStatement); } if (effectiveStatement instanceof Deviation) { deviationsInit.add((Deviation) effectiveStatement); } if (effectiveStatement instanceof IdentitySchemaNode) { identitiesInit.add((IdentitySchemaNode) effectiveStatement); } if (effectiveStatement instanceof FeatureDefinition) { featuresInit.add((FeatureDefinition) effectiveStatement); } if (effectiveStatement instanceof ExtensionDefinition) { extensionNodesInit.add((ExtensionDefinition) effectiveStatement); } if (effectiveStatement instanceof DataSchemaNode) { mutablePublicChildNodes.add((DataSchemaNode) effectiveStatement); } if (effectiveStatement instanceof UsesNode && !mutableUses.add((UsesNode) effectiveStatement)) { throw EffectiveStmtUtils.createNameCollisionSourceException(ctx, effectiveStatement); } if (effectiveStatement instanceof TypedefEffectiveStatement) { final TypeDefinition type = ((TypedefEffectiveStatement) effectiveStatement).getTypeDefinition(); if (!mutableTypeDefinitions.add(type)) { throw EffectiveStmtUtils.createNameCollisionSourceException(ctx, effectiveStatement); } } if (effectiveStatement instanceof GroupingDefinition && !mutableGroupings.add((GroupingDefinition) effectiveStatement)) { throw EffectiveStmtUtils.createNameCollisionSourceException(ctx, effectiveStatement); } } this.augmentations = ImmutableSet.copyOf(augmentationsInit); this.imports = ImmutableSet.copyOf(importsInit); this.notifications = ImmutableSet.copyOf(notificationsInit); this.rpcs = ImmutableSet.copyOf(rpcsInit); this.deviations = ImmutableSet.copyOf(deviationsInit); this.identities = ImmutableSet.copyOf(identitiesInit); this.features = ImmutableSet.copyOf(featuresInit); this.extensionNodes = ImmutableList.copyOf(extensionNodesInit); this.groupings = ImmutableSet.copyOf(mutableGroupings); this.publicChildNodes = ImmutableSet.copyOf(mutablePublicChildNodes); this.typeDefinitions = ImmutableSet.copyOf(mutableTypeDefinitions); this.uses = ImmutableSet.copyOf(mutableUses); } @Override public URI getNamespace() { return getQNameModule().getNamespace(); } @Override public String getName() { return name; } @Override public Optional getRevision() { return getQNameModule().getRevision(); } @Override public String getPrefix() { return prefix; } @Override public YangVersion getYangVersion() { return yangVersion; } @Override public Optional getOrganization() { return Optional.ofNullable(organization); } @Override public Optional getContact() { return Optional.ofNullable(contact); } @Override public Collection getImports() { return imports; } @Override public Collection getFeatures() { return features; } @Override public Collection getNotifications() { return notifications; } @Override public Collection getAugmentations() { return augmentations; } @Override public Collection getRpcs() { return rpcs; } @Override public Collection getDeviations() { return deviations; } @Override public Collection getExtensionSchemaNodes() { return extensionNodes; } @Override public Collection getIdentities() { return identities; } @Override public final Collection> getTypeDefinitions() { return typeDefinitions; } @Override public final Collection getChildNodes() { return publicChildNodes; } @Override public final Collection getGroupings() { return groupings; } @Override @SuppressWarnings("checkstyle:hiddenField") public final Optional findDataChildByName(final QName name) { final SchemaTreeEffectiveStatement child = schemaTreeNamespace.get(requireNonNull(name)); return child instanceof DataSchemaNode ? Optional.of((DataSchemaNode) child) : Optional.empty(); } @Override public Collection getUses() { return uses; } @Override public Optional getSemanticVersion() { return Optional.ofNullable(semanticVersion); } @Override @SuppressWarnings("unchecked") protected > Optional> getNamespaceContents( final Class namespace) { if (SchemaTreeAwareEffectiveStatement.Namespace.class.equals(namespace)) { return Optional.of((Map) schemaTreeNamespace); } return super.getNamespaceContents(namespace); } @Override public String toString() { return MoreObjects.toStringHelper(this).omitNullValues() .add("name", name) .add("namespace", getNamespace()) .add("revision", getRevision().orElse(null)) .add("prefix", prefix) .add("yangVersion", yangVersion) .toString(); } protected static final @NonNull String findPrefix(final @NonNull StmtContext ctx, final String type, final String name) { return SourceException.throwIfNull( StmtContextUtils.firstAttributeOf(ctx.declaredSubstatements(), PrefixStatement.class), ctx.getStatementSourceReference(), "Unable to resolve prefix for %s %s.", type, name); } // Alright. this is quite ugly protected final void appendPrefixes(final StmtContext ctx, final Builder builder) { streamEffectiveSubstatements(ImportEffectiveStatement.class) .map(imp -> imp.findFirstEffectiveSubstatementArgument(PrefixEffectiveStatement.class).get()) .forEach(pfx -> { final StmtContext importedCtx = verifyNotNull(ctx.getFromNamespace(ImportPrefixToModuleCtx.class, pfx), "Failed to resolve prefix %s", pfx); builder.put(pfx, (ModuleEffectiveStatement) importedCtx.buildEffective()); }); } }