X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=yang%2Fyang-parser-rfc7950%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fyangtools%2Fyang%2Fparser%2Frfc7950%2Fstmt%2FAbstractDeclaredEffectiveStatement.java;h=dcf3d843fdcf6c842b643f346e2aa08bf32052af;hb=31a2ecb84221b3396a6249610173d7d71817a72d;hp=5b9edf3206bed452f54fd7d973e189692008ad0d;hpb=312068b3e5eca1b3c336fa029a5a81c7b6a031c0;p=yangtools.git diff --git a/yang/yang-parser-rfc7950/src/main/java/org/opendaylight/yangtools/yang/parser/rfc7950/stmt/AbstractDeclaredEffectiveStatement.java b/yang/yang-parser-rfc7950/src/main/java/org/opendaylight/yangtools/yang/parser/rfc7950/stmt/AbstractDeclaredEffectiveStatement.java index 5b9edf3206..dcf3d843fd 100644 --- a/yang/yang-parser-rfc7950/src/main/java/org/opendaylight/yangtools/yang/parser/rfc7950/stmt/AbstractDeclaredEffectiveStatement.java +++ b/yang/yang-parser-rfc7950/src/main/java/org/opendaylight/yangtools/yang/parser/rfc7950/stmt/AbstractDeclaredEffectiveStatement.java @@ -7,14 +7,29 @@ */ package org.opendaylight.yangtools.yang.parser.rfc7950.stmt; +import static com.google.common.base.Verify.verify; import static java.util.Objects.requireNonNull; import com.google.common.annotations.Beta; +import com.google.common.collect.ImmutableList; +import com.google.common.collect.ImmutableMap; +import java.util.HashMap; +import java.util.Map; +import java.util.Optional; import org.eclipse.jdt.annotation.NonNull; import org.eclipse.jdt.annotation.Nullable; +import org.opendaylight.yangtools.yang.common.QName; +import org.opendaylight.yangtools.yang.model.api.DataNodeContainer; +import org.opendaylight.yangtools.yang.model.api.DataSchemaNode; import org.opendaylight.yangtools.yang.model.api.meta.DeclaredStatement; -import org.opendaylight.yangtools.yang.model.api.meta.StatementDefinition; +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.meta.StatementSource; +import org.opendaylight.yangtools.yang.model.api.stmt.DataTreeAwareEffectiveStatement; +import org.opendaylight.yangtools.yang.model.api.stmt.DataTreeEffectiveStatement; +import org.opendaylight.yangtools.yang.model.api.stmt.SchemaTreeAwareEffectiveStatement; +import org.opendaylight.yangtools.yang.model.api.stmt.SchemaTreeEffectiveStatement; +import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.EffectiveStatementMixins.DataNodeContainerMixin; /** * Base stateless superclass for statements which (logically) always have an associated {@link DeclaredStatement}. This @@ -37,12 +52,63 @@ public abstract class AbstractDeclaredEffectiveStatement Argument type ({@link Void} if statement does not have argument.) + * @param Class representing declared version of this statement. + * @param Class representing effective version of this statement. + */ + public abstract static class WithSchemaTree, + E extends SchemaTreeAwareEffectiveStatement> extends AbstractDeclaredEffectiveStatement { + @Override + @SuppressWarnings("unchecked") + protected > Optional> getNamespaceContents( + final Class namespace) { + if (SchemaTreeAwareEffectiveStatement.Namespace.class.equals(namespace)) { + return Optional.of((Map) schemaTreeNamespace()); + } + return super.getNamespaceContents(namespace); + } + + /** + * Indexing support for {@link DataNodeContainer#dataChildByName(QName)}. + */ + protected final @Nullable DataSchemaNode dataSchemaNode(final QName name) { + // Only DataNodeContainer subclasses should be calling this method + verify(this instanceof DataNodeContainer); + final SchemaTreeEffectiveStatement child = schemaTreeNamespace().get(requireNonNull(name)); + return child instanceof DataSchemaNode ? (DataSchemaNode) child : null; + } + + protected abstract Map> schemaTreeNamespace(); } - @Override - public abstract @NonNull D getDeclared(); + /** + * Base stateless superclass form {@link DataTreeAwareEffectiveStatement}s. It maintains the contents of data tree + * namespace based of effective substatements. + * + * @param Argument type ({@link Void} if statement does not have argument.) + * @param Class representing declared version of this statement. + * @param Class representing effective version of this statement. + */ + public abstract static class WithDataTree, + E extends DataTreeAwareEffectiveStatement> extends WithSchemaTree { + @Override + @SuppressWarnings("unchecked") + protected > Optional> getNamespaceContents( + final Class namespace) { + if (DataTreeAwareEffectiveStatement.Namespace.class.equals(namespace)) { + return Optional.of((Map) dataTreeNamespace()); + } + return super.getNamespaceContents(namespace); + } + + protected abstract Map> dataTreeNamespace(); + } /** * A stateful version of {@link AbstractDeclaredEffectiveStatement}, which holds (and requires) a declared @@ -59,12 +125,58 @@ public abstract class AbstractDeclaredEffectiveStatement original) { + this.declared = original.declared; + } + @Override public final D getDeclared() { return declared; } } + /** + * Utility class for implementing DataNodeContainer-type statements. + */ + public abstract static class DefaultDataNodeContainer> extends Default + implements DataNodeContainerMixin { + private final @NonNull ImmutableMap dataChildren; + private final @NonNull Object substatements; + + protected DefaultDataNodeContainer(final D declared, + final ImmutableList> substatements) { + super(declared); + this.substatements = maskList(substatements); + + // Note: we do not leak this map, so iteration order does not matter + final Map tmp = new HashMap<>(); + + for (EffectiveStatement stmt : effectiveSubstatements()) { + if (stmt instanceof DataSchemaNode) { + final DataSchemaNode node = (DataSchemaNode) stmt; + final QName id = node.getQName(); + final DataSchemaNode prev = tmp.put(id, node); + if (prev != null) { + throw new SubstatementIndexingException( + "Cannot add child with name " + id + ", a conflicting child already exists"); + } + } + } + + dataChildren = ImmutableMap.copyOf(tmp); + } + + @Override + public final ImmutableList> effectiveSubstatements() { + return unmaskList(substatements); + } + + @Override + public final DataSchemaNode dataChildByName(final QName name) { + return dataChildren.get(requireNonNull(name)); + } + } + /** * An extra building block on top of {@link Default}, which is wiring {@link #argument()} to the declared statement. * This is mostly useful for arguments that are not subject to inference transformation -- for example Strings in @@ -75,13 +187,195 @@ public abstract class AbstractDeclaredEffectiveStatement Class representing declared version of this statement. */ public abstract static class DefaultArgument> extends Default { + public abstract static class WithSubstatements> + extends DefaultArgument { + private final @NonNull Object substatements; + + protected WithSubstatements(final D declared, + final ImmutableList> substatements) { + super(declared); + this.substatements = maskList(substatements); + } + + protected WithSubstatements(final WithSubstatements original) { + super(original); + this.substatements = original.substatements; + } + + @Override + public final ImmutableList> effectiveSubstatements() { + return unmaskList(substatements); + } + } + protected DefaultArgument(final D declared) { super(declared); } + protected DefaultArgument(final DefaultArgument original) { + super(original); + } + @Override - public final @Nullable A argument() { + public final A argument() { return getDeclared().argument(); } } + + /** + * A building block on top of {@link Default}, which adds an explicit argument value, which is not related to the + * context. This is mostly useful when the effective argument value reflects additional statements and similar. + * + * @param Argument type ({@link Void} if statement does not have argument.) + * @param Class representing declared version of this statement. + */ + public abstract static class DefaultWithArgument> extends Default { + public abstract static class WithSubstatements> + extends DefaultWithArgument { + private final @NonNull Object substatements; + + protected WithSubstatements(final D declared, final A argument, + final ImmutableList> substatements) { + super(declared, argument); + this.substatements = maskList(substatements); + } + + @Override + public final ImmutableList> effectiveSubstatements() { + return unmaskList(substatements); + } + } + + private final A argument; + + protected DefaultWithArgument(final D declared, final A argument) { + super(declared); + this.argument = argument; + } + + @Override + public final A argument() { + return argument; + } + } + + /** + * Stateful version of {@link WithSchemaTree}. Schema tree namespace is eagerly instantiated (and checked). + * + * @param Argument type ({@link Void} if statement does not have argument.) + * @param Class representing declared version of this statement. + * @param Class representing effective version of this statement. + */ + public abstract static class DefaultWithSchemaTree, + E extends SchemaTreeAwareEffectiveStatement> extends WithSchemaTree { + public abstract static class WithSubstatements, + E extends SchemaTreeAwareEffectiveStatement> extends DefaultWithSchemaTree { + private final @NonNull Object substatements; + + protected WithSubstatements(final D declared, + final ImmutableList> substatements) { + super(declared, substatements); + this.substatements = maskList(substatements); + } + + protected WithSubstatements(final WithSubstatements original) { + super(original); + this.substatements = original.substatements; + } + + @Override + public final ImmutableList> effectiveSubstatements() { + return unmaskList(substatements); + } + } + + private final @NonNull ImmutableMap> schemaTree; + private final @NonNull D declared; + + protected DefaultWithSchemaTree(final D declared, + final ImmutableList> substatements) { + this.declared = requireNonNull(declared); + this.schemaTree = ImmutableMap.copyOf(createSchemaTreeNamespace(substatements)); + } + + protected DefaultWithSchemaTree(final DefaultWithSchemaTree original) { + this.declared = original.declared; + this.schemaTree = original.schemaTree; + } + + @Override + public final D getDeclared() { + return declared; + } + + @Override + protected final Map> schemaTreeNamespace() { + return schemaTree; + } + } + + /** + * Stateful version of {@link WithDataTree}. Schema tree and data tree namespaces are eagerly instantiated + * (and checked). + * + * @param Argument type ({@link Void} if statement does not have argument.) + * @param Class representing declared version of this statement. + * @param Class representing effective version of this statement. + */ + public abstract static class DefaultWithDataTree, + E extends DataTreeAwareEffectiveStatement> extends WithDataTree { + public abstract static class WithSubstatements, + E extends DataTreeAwareEffectiveStatement> extends DefaultWithDataTree { + private final @NonNull Object substatements; + + protected WithSubstatements(final D declared, + final ImmutableList> substatements) { + super(declared, substatements); + this.substatements = maskList(substatements); + } + + protected WithSubstatements(final WithSubstatements original) { + super(original); + this.substatements = original.substatements; + } + + @Override + public final ImmutableList> effectiveSubstatements() { + return unmaskList(substatements); + } + } + + private final @NonNull ImmutableMap> schemaTree; + private final @NonNull ImmutableMap> dataTree; + private final @NonNull D declared; + + protected DefaultWithDataTree(final D declared, + final ImmutableList> substatements) { + this.declared = requireNonNull(declared); + final Map> schema = createSchemaTreeNamespace(substatements); + this.schemaTree = ImmutableMap.copyOf(schema); + this.dataTree = createDataTreeNamespace(schema.values(), schemaTree); + } + + protected DefaultWithDataTree(final DefaultWithDataTree original) { + this.declared = original.declared; + this.schemaTree = original.schemaTree; + this.dataTree = original.dataTree; + } + + @Override + public final D getDeclared() { + return declared; + } + + @Override + protected final Map> schemaTreeNamespace() { + return schemaTree; + } + + @Override + protected final Map> dataTreeNamespace() { + return dataTree; + } + } }